tarampampam/webhook-tester Docker 镜像 - 轩辕镜像
tarampampam/webhook-tester用于测试和调试webhook及HTTP请求的工具，可生成随机URL，自定义响应码、内容类型、响应内容和延迟，是自托管的webhook测试解决方案。
6 收藏0 次下载
WebHook Tester
该应用允许您使用唯一的随机生成URL测试和调试webhook及HTTP请求。您可以自定义响应码、Content-Type HTTP头、响应内容，甚至设置响应延迟。
它是webhook.site、requestinspector.com等服务的免费自托管替代方案。
!screencast
[!TIP] 演示版本可在wh.tarampamp.am访问。请注意，该演示功能有限，不持久化数据，且可能偶尔不可用，但您可以免费试用。
该应用使用Go构建以实现高性能，包含轻量级UI（基于ReactJS），已编译到二进制文件中，无需额外资源。WebSocket支持提供UI中的实时webhook通知，无需pusher.com等第三方服务！
核心功能与特性
- 独立运行，使用内存存储/发布订阅系统，无需第三方依赖
- 完全自定义webhook的响应码、头和正文
- 支持将本地运行实例暴露到公网（通过隧道功能）
- 基于ReactJS的内置快速UI
- 基于scratch的多架构Docker镜像
- Docker中以非特权用户运行
- 充分测试且文档完善的源代码
- 包含CLI健康检查子命令
- UI中支持请求的二进制视图
- 支持JSON和人类可读的日志格式
- 健康检查端点（
/healthz） - 可自定义webhook响应
- 内置WebSocket支持
- 内存和CPU使用高效
- 免费、开源且可扩展
存储
应用支持3种存储驱动：memory（内存）、Redis和fs（文件系统），通过--storage-driver标志配置。
- 内存驱动：适用于本地调试，无需持久化存储，应用关闭后记录的请求将被清除
- Redis驱动：跨应用重启保留数据，适用于需要数据持久化的环境，也用于负载均衡后的多实例部署
- 文件系统驱动：将所有数据存储在本地文件系统，适用于需要在应用重启间保留数据的场景
发布/订阅
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中打开该会话（[***]）即可。
安装
Docker镜像
| 镜像仓库 | 镜像地址 |
|---|---|
| GitHub Container Registry | ghcr.io/tarampampam/webhook-tester |
| Docker Hub（镜像） | tarampampam/webhook-tester |
[!NOTE] 建议避免使用
latest标签，因为主要版本升级可能包含破坏性变更。应使用X.Y.Z格式的特定标签以确保版本一致性。
二进制文件
从发布页面下载适用于您架构的最新二进制文件。例如，在amd64系统（如Debian、Ubuntu）上安装：
shellcurl -SsL -o ./webhook-tester [***] chmod +x ./webhook-tester ./webhook-tester start
[!TIP] 每个发布版本包含适用于Linux、Darwin（macOS）和Windows的二进制文件（支持amd64和arm64架构）。您可以从发布页面的"Assets"部分下载适合您系统的二进制文件。只需下载并运行单个二进制文件即可。
Kubernetes
通过ArtifactHUB的Helm chart安装。
使用方法
Docker快速启动
最简单的运行方式是使用Docker镜像：
shelldocker run --rm -t -p "8080:8080/tcp" ghcr.io/tarampampam/webhook-tester:2
[!NOTE] 此命令使用默认配置在8080端口启动应用（
-p参数中的第一个端口是主机端口，第二个是容器内的应用端口）。
然后，在浏览器中打开localhost:8080开始测试webhook。要停止应用，在运行它的终端中按Ctrl+C。
自定义配置
如需自定义配置，可参考以下CLI帮助或执行应用的--help标志。
CLI接口
webhook测试工具。
用法：
bash$ 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服务器。
用法：
bash$ 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健康检查。
用法：
bash$ app [全局标志] start healthcheck [命令标志] [参数...]
支持的标志：
| 名称 | 描述 | 默认值 | 环境变量 |
|---|---|---|---|
--port="…" | HTTP服务器端口 | 8080 | HTTP_PORT |
许可证
这是开源软件，根据MIT许可证授权。
rancher/rancher-webhook
暂无描述
150M+ pulls
上次更新：未知
amazon/amazon-eks-pod-identity-webhook
为需要AWS IAM访问权限的Kubernetes Pod提供的Webhook
45M+ pulls
上次更新：未知
bitnami/cert-manager-webhook
Bitnami安全镜像，适用于cert-manager-webhook组件，支持在Kubernetes环境中与外部证书颁发机构集成，实现证书自动化管理，具备安全优化特性。
1500K+ pulls
上次更新：未知
mirantis/ucp-kube-gmsa-webhook
暂无描述
50K+ pulls
上次更新：未知
docker/ucp-kube-gmsa-webhook
暂无描述
50K+ pulls
上次更新：未知
rancher/webhook-receiver
暂无描述
11M+ pulls
上次更新：未知
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
登录仓库拉取
通过 Docker 登录认证访问私有仓库
Linux
在 Linux 系统配置镜像服务
Windows/Mac
在 Docker Desktop 配置镜像
Docker Compose
Docker Compose 项目配置
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
MacOS OrbStack
MacOS OrbStack 容器配置
宝塔面板
在宝塔面板一键配置镜像
群晖
Synology 群晖 NAS 配置
飞牛
飞牛 fnOS 系统配置镜像
极空间
极空间 NAS 系统配置服务
爱快路由
爱快 iKuai 路由系统配置
绿联
绿联 NAS 系统配置镜像
威联通
QNAP 威联通 NAS 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
专属域名拉取
无需登录使用专属域名
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
轩辕镜像免费版与专业版有什么区别？
免费版仅支持 Docker Hub 访问，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。
轩辕镜像支持哪些镜像仓库？
专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等；免费版仅支持 docker.io。
流量耗尽错误提示
当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。
410 错误问题
通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。
manifest unknown 错误
先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。
镜像拉取成功后，如何去掉轩辕镜像域名前缀？
使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"
咨询镜像拉取问题请 提交工单，官方技术交流群：1072982923
轩辕镜像面向开发者与科研用户，提供开源镜像的搜索和访问支持。所有镜像均来源于原始仓库，本站不存储、不修改、不传播任何镜像内容。