blackhole

blackhole 是一个响应任何请求并返回 HTTP 状态码 200 的服务器。例如，您可以使用访问日志检查 GitHub webhook 通知了哪些类型的请求。

入门

• 用法

Usage: blackhole [OPTIONS]

Options:
  -c, --no-color
          Color mode off
  -a, --address <ADDRESS>
          Listen address [default: 127.0.0.1]
  -p, --port <PORT>
          Listen port [env: PORT=] [default: 8080]
  -v, --verbose...
          More output per occurrence
  -q, --quiet...
          Less output per occurrence
  -h, --help
          Print help
  -V, --version
          Print version

• 启动服务器

# listen port is 8080
$ blackhole
Start server. addr: 127.0.0.1:8080

---

# Other terinal
$ curl -v http://127.0.0.1:8080/
$ curl -v -XPOST http://127.0.0.1:8080/
$ curl -d'param=aaa' -XPOST http://127.0.0.1:8080/xxx/yyy
$ curl -v -d '{"test": 1}' -H 'application/json' -XPOST http://127.0.0.1:8080/json

---
# access log
{"headers":{"accept":"*/*","user-agent":"curl/7.77.0"},"host":"127.0.0.1:8080","method":"GET","path":"/","query":"","req":{"size":0},"scheme":"http","timestamp":"2023-07-15T05:23:50.356541Z"}
{"headers":{"accept":"*/*","user-agent":"curl/7.77.0"},"host":"127.0.0.1:8080","method":"POST","path":"/","query":"","req":{"size":0},"scheme":"http","timestamp":"2023-07-15T05:23:53.42902Z"}
{"headers":{"accept":"*/*","content-length":"9","content-type":"application/x-www-form-urlencoded","user-agent":"curl/7.77.0"},"host":"127.0.0.1:8080","method":"POST","path":"/xxx/yyy","query":"","req":{"body":"param=aaa","size":9},"scheme":"http","timestamp":"2023-07-15T05:23:56.055892Z"}
{"headers":{"accept":"*/*","content-length":"11","content-type":"application/x-www-form-urlencoded","user-agent":"curl/7.77.0"},"host":"127.0.0.1:8080","method":"POST","path":"/json","query":"","req":{"body":{"test":1},"size":11},"scheme":"http","timestamp":"2023-07-15T05:24:00.304255Z"}

安装

• 直接安装二进制文件

❯❯ curl --tlsv1.2 -sSf https://raw.githubusercontent.com/watawuwu/blackhole/main/install.sh | sh

• 使用 cargo 安装

❯❯ cargo install blackhole-bin

贡献

请阅读 CONTRIBUTING.md 了解我们的行为准则以及向我们提交 pull 请求的过程。

版本控制

我们使用 SemVer 进行版本控制。

许可协议

此项目采用以下任一许可协议：

• Apache 许可协议第 2 版 (LICENSE-APACHE 或 http://www.apache.org/licenses/LICENSE-2.0)
• MIT 许可协议 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)

任选其一。

贡献

除非您明确声明，否则您有意提交的任何贡献，根据 Apache-2.0 许可证定义，将按照上述方式双许可，不附加任何额外条款或条件。

作者

• Wataru Matsui