frxyt/gohrec

GoHRec :: 基于Golang的HTTP请求记录器

GoHRec会将收到的HTTP请求以JSON文件形式记录，包含所有细节（包括头和体），并能重放这些已保存的请求。

• Docker Hub: https://hub.docker.com/r/frxyt/gohrec
• GitHub: https://github.com/frxyt/gohrec

Docker Hub镜像

frxyt/gohrec

构建

• 二进制：
  • Linux: go build -o gohrec .
  • Windows: go build -o gohrec.exe .
• Docker: docker build -t frxyt/gohrec:latest .

使用

• docker run --rm -p 8080:8080 -v $(pwd):/gohrec/log frxyt/gohrec:latest
• docker-compose up
• gohrec --listen=:8080 --only-path=^/api --except-path=/admin

选项

gohrec record：记录请求

• --date-format <format>：记录文件名中使用的日期格式（遵循Go语言time包格式），自动创建所需子文件夹（默认：2006-01-02/15-04-05_）。
• --echo：在调用时回显已记录的请求。
• --except-path <regexp>：若设置，记录不匹配指定URL路径模式的请求。
• --index：构建哈希及其明文表示的索引。
• --listen <interface:port>：监听的接口和端口（默认：:8080）。
• --max-body-size <bytes>：将记录的请求体最大字节数，-1表示无限制（默认：-1）。
• --only-path <regexp>：若设置，仅记录匹配指定URL路径模式的请求。
• --pprof：启用pprof端点 /debug/pprof/*。
• --proxy：启用代理模式。
• --redact-body <regexp>[/<replacement>]：若设置，将请求体中匹配指定模式的部分脱敏。
• --redact-headers <regexp>[/<replacement>]：若设置，将请求头中匹配指定模式的部分脱敏。
• --target-url <url>：启用代理模式时使用的目标URL。
• --verbose：记录处理的请求状态。

gohrec redo：重放已保存的请求

• --host：若设置，将请求的主机改为指定值。
• --request：要重放的请求的JSON文件。
• --timeout：重放请求的超时时间（默认：60s）。
• --url：若设置，将请求的URL改为指定值。

许可证

本项目及镜像以MIT许可证发布。

MIT License

Copyright (c) 2020 FEROX YT EIRL, [***] <***>
Copyright (c) 2020 Jérémy WALTHER <***>

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.