erolatex/postback-catcher

Postback Catcher 镜像文档

镜像概述

Postback Catcher是一个轻量级HTTP服务器应用，使用Go语言开发，主要功能是捕获并保存接收到的HTTP请求。该工具适用于开发、测试环境中需要检查HTTP请求内容的场景，帮助开发者验证API调用、webhook通知或前端请求的完整性。

核心功能和特性

• 轻量级设计：基于Go语言开发，运行资源占用低，启动快速
• 请求捕获：支持捕获各类HTTP请求（GET、POST、PUT、DELETE等）
• 请求保存：自动存储接收到的请求详情，包括头信息、请求体、参数等
• 简单部署：通过Docker容器化部署，配置简单，易于集成到现有开发流程

使用场景

• API接口开发调试：验证客户端发送的请求格式和参数
• Webhook接收测试：检查第三方服务发送的webhook通知内容
• 前端请求验证：确认前端应用发送的HTTP请求是否符合预期
• 教学演示：展示HTTP请求结构和数据传输过程

使用方法

基本部署

使用docker run部署

bash
docker run -d -p 8080:8080 --name postback-catcher erolatex/postback-catcher

• -p 8080:8080：将容器内8080端口映射到主机8080端口，可根据需要修改主机端口
• --name postback-catcher：指定容器名称，便于管理

使用docker-compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  postback-catcher:
    image: erolatex/postback-catcher
    ports:
      - "8080:8080"
    restart: always

启动服务：

bash
docker-compose up -d

配置参数

目前官方未提供详细配置参数说明，建议参考项目仓库获取最新配置信息：
https://github.com/erolatex/postback-catcher

查看捕获的请求

部署完成后，可通过向服务器发送HTTP请求进行测试：

bash
curl -X POST http://localhost:8080/test -d "param1=value1&param2=value2"

捕获的请求数据通常存储在容器内部（具体路径请参考项目文档），可通过以下命令查看：

bash
docker exec -it postback-catcher cat /path/to/request/logs

注意事项

• 该工具主要用于开发测试环境，不建议直接用于生产环境
• 如需持久化存储请求数据，建议通过Docker数据卷挂载存储目录
• 详细使用说明和高级配置请参考项目GitHub仓库文档