Skip to content

README.md

Latest commit

 

History

History
46 lines (33 loc) · 2.12 KB

README.md

File metadata and controls

46 lines (33 loc) · 2.12 KB
Raw

tiny-http-probe

Docker Image Size Docker Pulls Docker Image Vulnerabilities GitHub Repo CI Docker Weekly Build

Overview

tiny-http-probe is a minimal, stateless HTTP server designed for health checks, cache testing, and network diagnostics. It provides a set of endpoints that return simple JSON payloads, allowing you to:

  • Test HTTP connectivity and response headers
  • Inspect client IP and proxy headers
  • Validate cache and CDN behaviors

Security Considerations

  • Rootless by default: The container runs as a non-root user (UID/GID 1000) for improved security.
  • Minimal attack surface: The final Docker image is built FROM scratch and contains only the statically compiled Go binary.
  • No persistent storage: The app is stateless and does not write to disk.
  • No authentication: Endpoints are public by design; do not expose to untrusted networks if sensitive.

Build Instructions

Build and Run with Docker

docker build -t tiny-http-probe .
docker run -p 8080:8080 tiny-http-probe

Build Locally (requires Go 1.22+)

go mod tidy
go build -o tiny-http-probe
./tiny-http-probe

The server will listen on port 8080 by default. You can override the port with the PORT environment variable.

Bug Reports

Please report any bugs or issues via GitHub Issues.