jefriherditriyanto/golang-proxy repository overview

⁠Golang Proxy

A high-performance dynamic reverse proxy written in Go with a professional Vue 3 web dashboard. Route traffic with static or dynamic targets, enforce IP blocklists, validate requests through middleware, and manage Let's Encrypt SSL certificates — all from a single binary.

⁠Features

• Dual HTTP Servers — LISTEN (proxy traffic) and SERVER (admin dashboard) run concurrently on separate ports.
• Static Routing — Forward traffic from a domain/path prefix directly to a target URL.
• Dynamic Routing — Resolve target destinations at runtime by calling an external backend resolver.
• Validation Middleware — Optionally forward request context to a validation endpoint; proceed only on 2xx.
• IP Blocklist — Database-driven; blocked IPs immediately receive 403 Forbidden.
• Auto SSL — Let's Encrypt integration via autocert with per-domain toggle.
• Web Dashboard — Manage routes, blocklist, view activity logs, and monitor metrics with real-time charts.
• Live Traffic Terminal — Click any route to open an xterm.js terminal streaming proxy traffic via SSE.
• Request Inspection — Click any log entry to see full request/response headers and body.
• Dark / Light Mode — Toggle with localStorage persistence.
• Single Binary — Frontend assets embedded via embed.FS. No external web server needed.
• Multi-arch Docker — linux/amd64 + linux/arm64 via buildx.

⁠Quick Start

⁠Docker

docker run -d \
  -p 80:80 \
  -p 443:443 \
  -p 8080:8080 \
  -p 8000:8000 \
  -v golang-proxy-data:/app/database \
  -e SERVER_USERNAME=admin \
  -e SERVER_PASSWORD=admin \
  --name golang-proxy \
  jefriherditriyanto/golang-proxy:latest

Dashboard: http://localhost:8000 (login: admin / admin) Proxy listener: http://localhost:8080

⁠From Source

# Frontend
bun install
bun run build

# Backend
go build -o go-proxy .
./go-proxy

Requires Go 1.22+ and Bun (or Node 20+).

⁠Environment Variables

⁠Architecture

                     ┌─────────────────┐
                     │   Golang Proxy  │
                     │                 │
  Client ──────────► │ LISTEN :8080    │ ──► Target Server
                     │  • Route match  │
                     │  • IP blocklist │
                     │  • Validation   │
                     │  • SSL (ACME)   │
                     │                 │
  Admin  ──────────► │ SERVER :8000    │
                     │  • Dashboard UI │
                     │  • REST API     │
                     │  • SSE Streams  │
                     │  • Basic Auth   │
                     │                 │
                     │  SQLite (GORM)  │
                     └─────────────────┘

⁠Tech Stack

⁠Dashboard Pages

⁠License

MIT