本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

该应用允许您使用唯一的随机生成URL测试和调试webhook及HTTP请求。您可以自定义响应码、Content-Type HTTP头、响应内容,甚至设置响应延迟。
它是webhook.site、requestinspector.com等服务的免费自托管替代方案。
!screencast
[!TIP] 演示版本可在wh.tarampamp.am访问。请注意,该演示功能有限,不持久化数据,且可能偶尔不可用,但您可以免费试用。
该应用使用Go构建以实现高性能,包含轻量级UI(基于ReactJS),已编译到二进制文件中,无需额外资源。WebSocket支持提供UI中的实时webhook通知,无需pusher.com等第三方服务!
/healthz)应用支持3种存储驱动:memory(内存)、Redis和fs(文件系统),通过--storage-driver标志配置。
WebSocket通知的发布/订阅系统支持两种驱动:memory(内存)和Redis,通过--pubsub-driver标志配置。
运行多个应用实例时,需使用Redis驱动。
使用***隧道驱动捕获来自公网的webhook请求。通过设置--tunnel-driver=***标志并提供***认证令牌(--***-auth-token)启用。启用后,应用会自动创建隧道,无需手动安装或运行***(即使在Docker中)。
通过此公网URL,您可以测试来自GitHub、GitLab、Bitbucket等外部服务的webhook,不会错过任何请求!
是否可以使用预定义(静态)webhook URL(会话),确保即使没有数据持久化也能捕获发送的请求?
可以,只需使用--auto-create-sessions标志或设置环境变量AUTO_CREATE_SESSIONS=true。在v1版本中,需在应用启动时定义会话以启用此功能;但从v2开始,只需启用此功能即可。其工作原理很简单:如果传入请求包含UUID格式的前缀(例如[***]),将自动为此请求创建会话。您只需在UI中打开该会话([***])即可。
| 镜像仓库 | 镜像地址 |
|---|---|
| GitHub Container Registry | ghcr.io/tarampampam/webhook-tester |
| Docker Hub(镜像) | tarampampam/webhook-tester |
[!NOTE] 建议避免使用
latest标签,因为主要版本升级可能包含破坏性变更。应使用X.Y.Z格式的特定标签以确保版本一致性。
从发布页面下载适用于您架构的最新二进制文件。例如,在amd64系统(如Debian、Ubuntu)上安装:
curl -SsL -o ./webhook-tester [***] chmod +x ./webhook-tester ./webhook-tester start
[!TIP] 每个发布版本包含适用于Linux、Darwin(macOS)和Windows的二进制文件(支持amd64和arm64架构)。您可以从发布页面的"Assets"部分下载适合您系统的二进制文件。只需下载并运行单个二进制文件即可。
通过ArtifactHUB的Helm chart安装。
最简单的运行方式是使用Docker镜像:
docker run --rm -t -p "8080:8080/tcp" ghcr.io/tarampampam/webhook-tester:2
[!NOTE] 此命令使用默认配置在8080端口启动应用(
-p参数中的第一个端口是主机端口,第二个是容器内的应用端口)。
然后,在浏览器中打开localhost:8080开始测试webhook。要停止应用,在运行它的终端中按Ctrl+C。
如需自定义配置,可参考以下CLI帮助或执行应用的--help标志。
webhook测试工具。
用法:
$ app [全局标志] [命令] [命令标志] [参数...]
| 名称 | 描述 | 默认值 | 环境变量 |
|---|---|---|---|
--log-level="…" | 日志级别(debug/info/warn/error/fatal) | info | LOG_LEVEL |
--log-format="…" | 日志格式(console/json) | console | LOG_FORMAT |
start命令(别名:s、server、serve、http-server)启动HTTP/HTTPs服务器。
用法:
$ app [全局标志] start [命令标志] [参数...]
支持的标志:
| 名称 | 描述 | 默认值 | 环境变量 |
|---|---|---|---|
--addr="…" | 监听的IP(v4或v6)地址(0.0.0.0表示绑定所有接口) | 0.0.0.0 | SERVER_ADDR、LISTEN_ADDR |
--port="…" | HTTP服务器端口 | 8080 | HTTP_PORT |
--read-timeout="…" | 读取整个请求(包括正文)的最大持续时间(0表示无超时) | 1m0s | HTTP_READ_TIMEOUT |
--write-timeout="…" | 响应写入超时前的最大持续时间(0表示无超时) | 1m0s | HTTP_WRITE_TIMEOUT |
--idle-timeout="…" | 等待下一个请求的最大时间(保活,0表示无超时) | 1m0s | HTTP_IDLE_TIMEOUT |
--storage-driver="…" | 存储驱动(memory/redis/fs) | memory | STORAGE_DRIVER |
--session-ttl="…" | 会话生存时间(TTL) | 168h0m0s | SESSION_TTL |
--max-requests="…" | 存储的最大请求数(0表示无限制) | 128 | MAX_REQUESTS |
--fs-storage-dir="…" | 本地文件系统存储目录路径(目录必须存在) | - | FS_STORAGE_DIR |
--max-request-body-size="…" | 最大webhook请求正文大小(字节,0表示无限制) | 0 | MAX_REQUEST_BODY_SIZE |
--auto-create-sessions | 为传入请求自动创建会话 | false | AUTO_CREATE_SESSIONS |
--pubsub-driver="…" | 发布/订阅驱动(memory/redis) | memory | PUBSUB_DRIVER |
--tunnel-driver="…" | 用于将本地应用暴露到公网的隧道驱动(***,空表示禁用) | - | TUNNEL_DRIVER |
--***-auth-token="…" | ***认证令牌(隧道必需;在[] | - | ***_AUTHTOKEN |
--redis-dsn="…" | Redis类(Redis、KeyDB)服务器DSN(例如redis://user:pwd@127.0.0.1:6379/0或unix://user:pwd@/path/to/redis.sock?db=0) | redis://127.0.0.1:6379/0 | REDIS_DSN |
--shutdown-timeout="…" | 优雅关闭的最大持续时间 | 15s | SHUTDOWN_TIMEOUT |
--use-live-frontend | 使用本地目录的前端而非嵌入式前端(开发时有用) | false | - |
start healthcheck子命令(别名:hc、health、check)HTTP(S)服务器的健康检查器。用途:Docker健康检查。
用法:
$ app [全局标志] start healthcheck [命令标志] [参数...]
支持的标志:
| 名称 | 描述 | 默认值 | 环境变量 |
|---|---|---|---|
--port="…" | HTTP服务器端口 | 8080 | HTTP_PORT |
这是开源软件,根据MIT许可证授权。
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录方式配置轩辕镜像加速服务,包含7个详细步骤
在 Linux 系统上配置轩辕镜像源,支持主流发行版
在 Docker Desktop 中配置轩辕镜像加速,适用于桌面系统
在 Docker Compose 中使用轩辕镜像加速,支持容器编排
在 k8s 中配置 containerd 使用轩辕镜像加速
在宝塔面板中配置轩辕镜像加速,提升服务器管理效率
在 Synology 群晖NAS系统中配置轩辕镜像加速
在飞牛fnOS系统中配置轩辕镜像加速
在极空间NAS中配置轩辕镜像加速
在爱快ikuai系统中配置轩辕镜像加速
在绿联NAS系统中配置轩辕镜像加速
在威联通NAS系统中配置轩辕镜像加速
在 Podman 中配置轩辕镜像加速,支持多系统
配置轩辕镜像加速9大主流镜像仓库,包含详细配置步骤
无需登录即可使用轩辕镜像加速服务,更加便捷高效
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429