Webhook.site 开源版 Docker 镜像

镜像概述

Webhook.site 开源版 Docker 镜像是 Webhook.site 的自托管解决方案，提供与官方服务类似的核心功能，允许用户在本地或私有环境中部署用于测试和调试 webhook、HTTP 回调及 API 请求的工具。该镜像适用于需要数据隐私保护或自定义部署的场景，所有请求数据存储在用户自有基础设施中。

主要用途

• 开发和调试过程中捕获、查看和分析 HTTP 请求
• 测试第三方服务发送的 webhook（如支付通知、消息推送、API 回调等）
• 验证 HTTP 请求的完整性（包括头信息、查询参数、请求正文等）
• 生成临时唯一 URL 端点，用于接收特定来源的请求数据

核心功能和特性

• 多协议支持：接收并处理所有 HTTP 方法请求（GET、POST、PUT、DELETE 等）
• 请求详情展示：查看完整请求元数据，包括头信息、查询参数、表单数据、JSON 正文、客户端 IP 等
• 唯一端点生成：自动生成随机唯一 URL，用于标识不同测试场景
• 自托管部署：支持本地服务器、私有云或容器平台部署，数据完全自主控制
• 轻量级架构：基于现代 Web 技术栈，资源占用低，启动快速
• 数据持久化：支持通过数据库存储历史请求记录（默认 SQLite，可配置 PostgreSQL/MySQL）

使用场景和适用范围

适用场景

• 开发人员集成第三方服务时测试 webhook 接收逻辑
• 调试 API 接口的 HTTP 请求响应流程
• 验证第三方系统发送的 HTTP 请求格式和内容
• 企业内部开发环境中测试内部服务间的 HTTP 通信
• 对数据隐私敏感的场景（避免请求数据发送至第三方服务）

适用人群

• 后端开发工程师
• API 集成与调试人员
• DevOps 与 SRE 工程师
• 需要验证外部服务请求的 QA 测试人员

使用方法和配置说明

基本部署（Docker Run）

通过以下命令快速启动容器：

docker run -d -p 8080:8080 --name webhook-site webhooksite/webhook.site

参数说明：

• -d：后台运行容器
• -p 8080:8080：端口映射（主机端口:容器端口，可修改主机端口如 -p 3000:8080）
• --name webhook-site：指定容器名称
• webhooksite/webhook.site：镜像名称

启动后访问 http://localhost:8080 即可使用，系统会自动生成唯一测试端点 URL。

Docker Compose 部署

创建 docker-compose.yml 文件实现持久化部署：

version: '3'
services:
  webhook-site:
    image: webhooksite/webhook.site
    ports:
      - "8080:8080"  # 主机端口:容器端口
    volumes:
      - ./webhook-data:/app  # 挂载目录用于持久化数据（含数据库文件）
    environment:
      - PORT=8080  # 容器内服务运行端口
      - DATABASE_URL=sqlite:///app/webhook_site.db  # SQLite 数据库路径
      - SECRET_KEY=your_secure_random_key  # 用于加密的密钥（生产环境必须修改）
      - AUTH_ENABLED=true  # 启用基本认证（可选）
      - AUTH_USERNAME=admin  # 认证用户名（启用认证时必填）
      - AUTH_PASSWORD=secure_password  # 认证密码（启用认证时必填）
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

执行以下命令启动服务：

docker-compose up -d

配置参数（环境变量）

数据持久化

默认配置下，SQLite 数据库文件存储于容器内 /app/webhook_site.db。为避免容器重启后数据丢失，需通过卷挂载持久化该文件：

docker run -d -p 8080:8080 -v ./webhook-data:/app --name webhook-site webhooksite/webhook.site

上述命令将主机当前目录下的 webhook-data 文件夹挂载至容器 /app 目录，数据库文件会保存在主机 webhook-data/webhook_site.db。

注意事项

• 生产环境配置：必须修改 SECRET_KEY 为强随机字符串（建议长度 ≥32 字符），并启用 AUTH_ENABLED 限制未授权访问。
• 数据库选择：高并发场景建议使用 PostgreSQL 或 MySQL 替代 SQLite，通过 DATABASE_URL 配置对应连接字符串（如 postgresql://user:pass@db-host:5432/dbname）。
• 最新信息：镜像功能和配置可能更新，详细文档请参考官方 GitHub 仓库：[***]