English | 简体中文

A lightweight HTTP request inspector and debugging tool written in Go. Tiny RequestBin captures and displays HTTP requests for inspection and debugging purposes.

This project was initially created with Gemini, later modified with GitHub Copilot, and is now maintained with Codex.

• 🚀 Lightweight & Fast: Simple implementation with minimal dependencies
• 🔍 Request Inspection: View detailed information about incoming HTTP requests
• 🌐 Web UI: Clean interface to browse captured requests
• 📋 CLI Mode: Option to print requests directly to the terminal
• 🔒 Local Only: All data stays on your machine, no external services needed

go install github.com/knktc/tiny-requestbin@latest

Prebuilt binaries are available for macOS, Linux, and Windows in Releases.

After downloading the archive for your platform, extract it and run the binary normally.

On macOS, Gatekeeper may block the binary the first time you open it. You can remove the quarantine attribute and make it executable with:

chmod +x tiny-requestbin
xattr -d com.apple.quarantine tiny-requestbin

Then run it normally:

./tiny-requestbin

If macOS still blocks it, you can also allow it from System Settings > Privacy & Security.

Note: I do not have a Windows machine, so I have not verified the Windows binary yet. Feedback is very welcome if you try it.

# Pull and run the latest image
docker run -p 8282:8282 knktc/tiny-requestbin

# Or run with custom options
docker run -p 8282:8282 knktc/tiny-requestbin -port 8282 -listen 0.0.0.0 -max 1000

# Using docker-compose
docker-compose up -d

# Install with default settings
helm install my-requestbin helm/tiny-requestbin/

# Install with custom options
helm install my-requestbin helm/tiny-requestbin/ \
  --set config.max=1000 \
  --set service.type=NodePort

# Enable HTTPRoute (Gateway API)
helm install my-requestbin helm/tiny-requestbin/ \
  --set httpRoute.enabled=true \
  --set 'httpRoute.parentRefs[0].name=my-gateway' \
  --set 'httpRoute.hostnames[0]=requestbin.example.com'

By default the chart deploys with image knktc/tiny-requestbin:latest, exposes port 8282 via a ClusterIP Service, and sets resource limits to 128Mi memory / 500m CPU.

git clone https://github.com/knktc/tiny-requestbin.git
cd tiny-requestbin
go build

Start the server with default options:

tiny-requestbin

• -port: Port for the server to listen on (default: 8282)
• -listen: Address to listen on (default: 127.0.0.1)
• -max: Maximum number of requests to store (default: 100)
• -cli: Enable CLI mode to print requests to terminal (default: false)
• -tls-cert: Path to the TLS certificate file (enables HTTPS when used with -tls-key)
• -tls-key: Path to the TLS private key file (enables HTTPS when used with -tls-cert)

Example with custom options:

tiny-requestbin -port 9000 -listen 0.0.0.0 -max 1000 -cli

Run with HTTPS:

tiny-requestbin -port 9443 -listen 127.0.0.1 \
  -tls-cert ./certs/localhost.pem \
  -tls-key ./certs/localhost-key.pem

1. Start the server using one of the methods above
2. Send HTTP or HTTPS requests to http[s]://[listen-address]:[port]/any/path
3. View captured requests in your browser at http[s]://[listen-address]:[port]/
4. If CLI mode is enabled, requests will also be printed to the terminal

The Docker image supports multiple architectures:

• linux/amd64 (Intel/AMD 64-bit)
• linux/arm64 (ARM 64-bit, Apple Silicon, etc.)

Multi-architecture images are automatically built and published via GitHub Actions when tags are pushed.

The web interface provides a clean and intuitive way to browse and inspect captured requests:

When running with the -cli flag, HTTP requests are beautifully formatted and displayed directly in the terminal:

Contributions are welcome! Feel free to submit a Pull Request.

This project is licensed under the MIT License - see the LICENSE file for details.