gateway-homebrew-go

A homebrew L7/L4 gateway & reverse proxy in Go. Learn-by-building, docs-first.

Performance benchmarks are documented in bench/README.md.

---

Roadmap

v0.1.0 - Minimal L7

• HTTP/1.1 reverse proxy
• Host/Path-prefix routing
• Static upstreams + Smooth WRR
• Basic timeouts (read/write/upstream)
• Structured access log (JSON)

v0.2.0 - Inbound TLS & HTTP/2/gRPC

• TLS termination (SNI, multiple certs)
• ALPN: h2/http1.1
• Basic gRPC pass-through

v0.3.0 - Upstream Security & Passive Health

• Per-cluster: none / TLS / mTLS
• Passive failure stats (de-preference/skip)

v0.4.0 - L4 TCP Passthrough

• Port → cluster mapping
• Idle/overall timeout policies (L4)

v0.5.0 - Minimal Observability

• Metrics: RPS, 4xx/5xx, upstream latency, active conns, route hits
• Access log fields & sampling
• Benchmark control knobs (non-user-facing)
  • deterministic upstream connection policy (keepalive / idle timeout)
  • benchmark-friendly mode (disable hot reload, background tasks)

v0.6.0 - Config Hot Reload

• Detect changes → validate → atomic swap → rollback

v0.7.0 - Traffic Control & Resilience

• Basic rate limiting (local, token bucket)
• Circuit breaking (per-upstream / per-route)
• Request retries with backoff (idempotent only)
• Request hedging (optional, bounded)

v0.8.0 - HTTP Semantics & Correctness

• Header normalization and validation
• Configurable request / response header mutation
• Proper 1xx / 3xx handling
• Graceful handling of client disconnects

v0.9.0 - Upstream Health & Control

• Active health checks (HTTP / TCP)
• Slow-start for recovered upstreams
• Outlier detection (simple EWMA)

v0.10.0 - Graceful Lifecycle

• Graceful shutdown (drain in-flight requests)
• Listener draining
• Connection lifetime policies