atomic77/reqsink

reqsink

概述

reqsink是一款轻量级HTTP请求接收器，灵感来源于原始的https://github.com/Runscope/requestbin%E3%80%82%E5%AE%83%E9%87%87%E7%94%A8Rust%E8%AF%AD%E8%A8%80%E5%AE%9E%E7%8E%B0%EF%BC%8C%E6%89%93%E5%8C%85%E4%B8%BA%E7%B4%A7%E5%87%91%E7%9A%84%E5%8D%95%E6%96%87%E4%BB%B6%E4%BA%8C%E8%BF%9B%E5%88%B6%EF%BC%8C%E4%BE%BF%E4%BA%8E%E9%83%A8%E7%BD%B2%E5%92%8C%E4%BD%BF%E7%94%A8%E3%80%82

核心功能和特性

• 轻量级设计：单文件二进制，资源占用低
• HTTP请求捕获：接收并记录各类HTTP请求
• 管理界面：通过/admin路由提供简单GUI，展示已跟踪的请求
• 自定义响应模板：支持使用https://github.com/Keats/tera%EF%BC%88jinja%E9%A3%8E%E6%A0%BC%EF%BC%89%E6%A8%A1%E6%9D%BF%E8%87%AA%E5%AE%9A%E4%B9%89%E7%89%B9%E5%AE%9A%E8%B7%AF%E7%94%B1%E7%9A%84%E5%93%8D%E5%BA%94
• 配置灵活：可通过命令行参数调整绑定地址、端口、请求限制等

使用场景和适用范围

• API测试与调试：捕获并查看客户端发送的HTTP请求详情
• Webhook测试：模拟接收第三方服务发送的webhook请求
• 前端开发：为前端提供临时的API端点，返回自定义响应
• 教学演示：展示HTTP请求处理流程

使用方法和配置说明

快速开始

通过Docker运行reqsink：

bash
docker run -p 8000:8000 atomic77/reqsink:latest

运行后会显示类似以下信息：

Total 1 templates loaded:
"admin.html"
Binding to interface "0.0.0.0:8000"

发送测试请求：

bash
curl -X POST -H "Content-Type: application/json" \
  -d '{"hello": "world", "foo": "bar"}' \
  localhost:8000/post/some/json

访问管理界面：在浏览器中打开 http://localhost:8000/admin，可查看所有已捕获的请求。

用户自定义模板

默认情况下，所有请求的响应均为简洁的"OK"。若需为特定路由自定义响应，可使用Tera模板。

模板可访问StoredRequest结构体的数据（详见main.rs中的结构体定义）。例如，自定义robots.txt响应的模板：

jinja
# Hello, IP {{ request.ip_addr }}. We've been expecting you.

# Group 1
User-agent: Googlebot
Disallow: /nogooglebot/

使用自定义模板运行：

bash
reqsink --user-templates-dir examples --extra-routes ./examples/example-routes.json

注：templates-dir目录及其子目录中的所有.html文件都会被视为模板文件。

命令行选项

OPTIONS:
    -e, --extra-routes <extra-routes>
            映射路由到模板的JSON文件路径
    
    -i, --ip-address <ip-address>
            绑定的IP地址 [默认值: 0.0.0.0]
    
    -p, --port <port>
            绑定的端口 [默认值: 8000]
    
    -r, --req-limit <req-limit>
            内存中保留的最大请求数 [默认值: 1000]
    
    -s, --sqlite <sqlite>
            用于持久化的SQLite数据库文件名（实验性功能）
    
    -u, --user-templates-dir <user-templates-dir>
            用户定义模板目录。若要为特定端点提供自定义响应，还需提供映射模板到路由的JSON文件

限制与待办事项

• 管理界面暂无法访问请求存储
• 缺少请求导出功能
• 同一路由无法为不同HTTP方法（如GET和POST）设置不同的自定义模板响应