hmdmph/dyn-proxy-go

By hmdmph

•Updated 6 months ago

dynamic HTTP/HTTPS reverse proxy written in Golang

Image

Networking

API management

Web servers

461

Overview Tags

hmdmph/dyn-proxy-go repository overview

A dynamic HTTP/HTTPS reverse proxy written in Go that intelligently routes requests based on the incoming Host header or HTTP/2 :authority pseudo-header. Features dynamic SNI support, transparent proxying, a built-in dashboard UI, and Kubernetes-ready deployment.

⁠Features

Dynamic Routing — Automatically routes requests based on Host header (HTTP/1.1) or :authority pseudo-header (HTTP/2)
Dynamic SNI — Automatic Server Name Indication based on request domain for proper TLS handshakes

All options can be set via CLI flags or environment variables. CLI flags take precedence.

Transparent Proxying — Preserves original Host headers for backend servers
Dashboard UI — Configurable HTML dashboard listing proxy endpoints
Structured Logging — JSON-formatted logs with configurable levels and detailed request tracking
Health Checks — Built-in /health endpoint for Kubernetes liveness/readiness probes
Graceful Shutdown — Proper signal handling (SIGINT, SIGTERM) for clean shutdowns
Flexible Configuration — CLI flags and environment variables
Distroless Docker Image — Minimal, secure container image
Kubernetes Ready — Complete K8s manifests included

All options can be set via CLI flags or environment variables. CLI flags take precedence.

Flag	Env Variable	Default	Description
`-port`	`LISTEN_PORT`	`8080`	Proxy listen port
`-target-host`	`TARGET_HOST`	`example.com`	Fallback target host
`-target-port`	`TARGET_PORT`	`443`	Target port to proxy to
`-target-scheme`	`TARGET_SCHEME`	`https`	Target scheme (`http` / `https`)
`-sni`	`SNI`	(dynamic)	SNI hostname (auto-set from request)
`-log-level`	`LOG_LEVEL`	`info`	Log level (`debug`, `info`, `warn`, `error`)
`-skip-tls-verify`	`SKIP_TLS_VERIFY`	`false`	Skip TLS certificate verification
`-enable-tls`	`ENABLE_TLS`	`false`	Enable TLS for the proxy itself
`-tls-cert`	`TLS_CERT_FILE`	`/etc/certs/tls.crt`	TLS certificate file path
`-tls-key`	`TLS_KEY_FILE`	`/etc/certs/tls.key`	TLS private key file path
`-read-timeout`	`READ_TIMEOUT`	`30`	Read timeout (seconds)
`-write-timeout`	`WRITE_TIMEOUT`	`30`	Write timeout (seconds)
`-idle-timeout`	`IDLE_TIMEOUT`	`120`	Idle timeout (seconds)
`-page-title`	`PAGE_TITLE`		Dashboard page title
`-sub-title`	`SUB_TITLE`		Dashboard subtitle
`-page-gradient`	`PAGE_GRADIENT`		Dashboard CSS gradient
`-page-title-icon`	`PAGE_TITLE_ICON`		Dashboard title icon
`-proxy-list`	`PROXY_LIST`		YAML proxy list for dashboard

https://github.com/hmdmph/Dyn-Proxy-Go⁠

Tag summary

Recent tags

Content type

Image

Digest

sha256:02123d277…

Size

7.9 MB

Last updated

6 months ago

docker pull hmdmph/dyn-proxy-go:0.1.0