httpprobe

README

HTTP Probe

Simple HTTP/HTTPS health probe tool for Docker and Kubernetes health checks.

# Download (linux amd64, see Downloads for other builds)
curl -o httpprobe -O -L https://github.com/cloudfra/httpprobe/releases/download/v0.1.0/httpprobe-amd64; chmod +x httpprobe

# Host the current directory.
./httpprobe

Features

• Zero-config required, hosts on port 80 or 8080 based on root and supports Cloud9's $PORT variable.
• HTTP and HTTPs serving
• Automatic HTTPs certificate generation
• Optional configuration by flags or YAML config file.
• Host local or HTTP served static files from:
  • Local directory (current directory is default)
  • ZIP archive
  • Tarball archive (.tar, .tar.bz2, .tar.gz, .tar.lz4, .tar.xz)
  • 7-zip
  • RAR
  • Git repository (HTTPS, SSH)
• Metrics export to Prometheus.
• Prebuild binaries for all major OSes.

Downloads

OS	Arch	Link
Linux	amd64	curl -O -L https://github.com/cloudfra/httpprobe/releases/download/v0.1.0/httpprobe-amd64
Linux	arm	curl -O -L https://github.com/cloudfra/httpprobe/releases/download/v0.1.0/httpprobe-arm
Linux	arm64	curl -O -L https://github.com/cloudfra/httpprobe/releases/download/v0.1.0/httpprobe-arm64
Windows	amd64	$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri "https://github.com/cloudfra/httpprobe/releases/download/v0.1.0/httpprobe-amd64.exe" -OutFile "httpprobe-amd64.exe" -UseBasicParsing
macOS	amd64	curl -O -L https://github.com/cloudfra/httpprobe/releases/download/v0.1.0/httpprobe-amd64-darwin
macOS	arm64	curl -O -L https://github.com/cloudfra/httpprobe/releases/download/v0.1.0/httpprobe-arm64-darwin

Docker Images

• httpprobe

docker pull docker.io/cloudfra/httpprobe

Build

Install Go 1.24 or newer.

# Clone the Codebase
git clone git@github.com:cloudfra/httpprobe.git
# Build the Code
make -j$(nproc)

Test

make test
make bench