dahyphenn/webhook.site

webhook.site Docker镜像

一款便捷工具，可实时显示HTTP请求内容，轻松测试webhook。

这是https://github.com/fredsted/webhook.site%E7%9A%84Docker%E9%95%9C%E5%83%8F%EF%BC%8C%E5%9F%BA%E4%BA%8EPHP FPM 7.1 Alpine Linux构建，用于测试HTTP webhook的API和前端工具。

核心功能

• 实时显示HTTP请求的详细内容（headers、body、参数等）
• 支持Pusher集成，实现请求实时更新无需刷新
• 支持持久化数据存储（SQLite、MySQL或PostgreSQL）
• 轻量镜像，基于Alpine Linux，资源占用低

使用场景

• 开发人员测试webhook发送是否正常
• 调试API回调接口的请求参数和格式
• 验证第三方服务的webhook推送内容
• 学习HTTP请求结构和webhook工作原理

配置说明

构建镜像

执行以下命令构建镜像：

bash
docker build --tag dahyphenn/webhook.site .

若需解决卷共享权限问题，可指定主机用户的UID和GID：

bash
docker build --build-arg UID=$(id -u) --build-arg GID=$(id -g) --tag dahyphenn/webhook.site .

运行容器

基础运行示例：

bash
docker run -it --rm --init -p 80:80 --name webhook_site dahyphenn/webhook.site

添加Pusher实时功能

1. 复制.env.example为.env，填写Pusher API凭证（需从pusher.com获取）
2. 运行容器时挂载.env文件：

bash
docker run -it --rm --init -p 80:80 -v $(pwd)/.env:/opt/app/.env --name webhook_site dahyphenn/webhook.site

持久化数据

方式1：挂载SQLite数据库卷

将容器内的SQLite数据库目录挂载到主机：

bash
docker run -it --rm --init -p 80:80 -v $(pwd)/data:/opt/app/database --name webhook_site dahyphenn/webhook.site

方式2：使用MySQL/PostgreSQL

1. 在.env中配置数据库连接信息：
   • DB_CONNECTION（mysql/postgresql）
   • DB_HOST、DB_PORT、DB_DATABASE、DB_USERNAME、DB_PASSWORD
2. 运行容器并挂载.env，之后执行迁移：

bash
docker exec -it webhook_site sh
cd /opt/app
php artisan migrate

Docker Compose示例

以下是包含MySQL持久化的docker-compose配置：

yaml
version: '3'
services:
  webhook-site-app:
    image: dahyphenn/webhook.site
    links:
      - webhook-site-db
    depends_on:
      - webhook-site-db
    volumes:
      - ./.env:/opt/app/.env
    ports:
      - "80:80"
  webhook-site-db:
    image: mysql
    environment:
      - MYSQL_ROOT_PASSWORD=<设置根密码>
      - MYSQL_DATABASE=app
      - MYSQL_USER=app
      - MYSQL_PASSWORD=<设置用户密码>
    volumes:
      - webhook-site-db-data-volume:/var/lib/mysql
volumes:
  webhook-site-db-data-volume:

对应的.env文件示例：

env
APP_ENV=local
APP_DEBUG=true
APP_KEY=
APP_URL=http://localhost

# Pusher配置（可选）
PUSHER_KEY=
PUSHER_SECRET=
PUSHER_APP_ID=
PUSHER_CLUSTER=

DB_CONNECTION=mysql
DB_HOST=webhook-site-db
DB_PORT=3306
DB_DATABASE=app
DB_USERNAME=app
DB_PASSWORD=<填写数据库用户密码>

启动后访问http://localhost即可使用。

参考来源

灵感来源于github.com/chrootLogin/docker-nextcloud。