simple container to debug network issues
Find a file
2026-02-21 17:55:25 +01:00
Containerfile Init 2026-02-21 17:47:04 +01:00
entrypoint.sh Init 2026-02-21 17:47:04 +01:00
go.mod Init 2026-02-21 17:47:04 +01:00
README.md update 2026-02-21 17:55:25 +01:00
server.go Init 2026-02-21 17:47:04 +01:00

netdebug

Minimal network debug container. Runs an HTTP/HTTPS server that tells you who it is, who you are, and what headers it received. Comes with curl, dig, ping, traceroute, tcpdump, and friends.

Build

podman build -t netdebug .

Run

podman run --rm -p 8080:8080 netdebug

Run with hostname so your curl request don't see the container id

podman run --rm -p 8080:8080 --hostname netdebug netdebug

Env vars

Variable Default Description
HTTP_PORT 8080 HTTP listen port
HTTPS_PORT 8443 HTTPS listen port
TLS_CERT /certs/server.crt Path to TLS cert
TLS_KEY /certs/server.key Path to TLS key

Auto-generates a self-signed cert on startup if none is mounted.

Shell in for tools

podman exec -it <container> sh

Available: curl, dig, nslookup, ping, traceroute, ip, ss, nc, tcpdump