Nginx Proxy Manager 和 Traefik 的终结者来了，玩折腾自建服务（Self-hosted）的这波真被爽到了。

GitHub 最近爆火的开源项目 GoDoxy，直接把反向代理、容器编排、自动化证书给整明白了。项目用 Go 语言编写，性能极高，采用 GPL-3.0 协议开源。

核心杀手锏： • 自动化服务发现：给 Docker 打个标签，域名和路由自动配置完成。 • 零门槛可视化 WebUI：告别手写复杂配置文件，容器日志、状态、路由一目了然。 • 爆赞的“休眠唤醒”：无人访问时自动挂起容器（甚至支持 Proxmox LXC），有流量立马秒级唤醒，省电省内存神器。 • 强悍的安全控制：免费自动签发 Let’s Encrypt 证书，内置 OIDC 单点登录和国家/IP 粒度的访问控制。

项目地址：https://github.com/yusing/godoxy

yusing/godoxy

Source: https://github.com/yusing/godoxy

A lightweight, simple, and performant reverse proxy with WebUI.

Website | Wiki | Discord

EN | 中文

Have questions? Ask ChatGPT! (Thanks to @ismesid)

Running demo

https://demo.godoxy.dev

Quick start

Configure Wildcard DNS Record(s) to point to machine running GoDoxy, e.g.

• A Record: *.domain.com -> 10.0.10.1
• AAAA Record (if you use IPv6): *.domain.com -> ::ffff:a00:a01

GoDoxy is designed to be running in host network mode, do not change it.

To change listening ports, modify .env.

1. Prepare a new directory for Docker Compose and config files.

2. Run setup script inside the directory, or set up manually

   /bin/sh -c "$(curl -fsSL https://raw.githubusercontent.com/yusing/godoxy/main/scripts/setup.sh)"
   

3. Start the docker compose service from generated compose.yml:

   docker compose up -d
   

4. You may now do some extra configuration on WebUI https://godoxy.yourdomain.com

Key features

• Simple setup
  • Configure routes with Docker labels or route files
  • Manage routes, config, containers, logs, metrics, and uptime from the WebUI
  • Use multi-node Docker setups
• Automatic routing
  • Discover Docker and Podman containers
  • Hot-reload config and container state changes
  • Manage Let’s Encrypt certificates with DNS-01 providers
• Traffic management
  • HTTP reverse proxy
  • TCP/UDP port forwarding
  • OpenID Connect SSO
  • ForwardAuth integration, e.g. TinyAuth
  • HTTP middlewares
  • Custom error pages
• Access control
  • IP/CIDR rules
  • Country and timezone rules with a MaxMind account
  • Access logging
  • Periodic access summaries
• Idle sleep
  • Stop and wake Docker containers based on traffic
  • Stop and wake Proxmox LXC containers based on traffic
• Proxmox integration
  • Bind routes automatically to nodes or LXC containers
  • Start, stop, and restart LXC containers from the WebUI
  • Stream node and LXC logs through WebSocket
• Platform support
  • Linux amd64
  • Linux arm64

How GoDoxy works

1. List all the containers
2. Read container name, labels, and port configurations for each of them
3. Create a route if applicable (a route is like a “Virtual Host” in NPM)
4. Watch for container / config changes and update automatically

GoDoxy uses the label proxy.aliases as the subdomain(s), if unset it defaults to the container_name field in docker compose.

For example, with the label proxy.aliases: qbt you can access your app via qbt.domain.com.

Screenshots

idlesleeper

Metrics and Logs

Routes	Servers

Proxmox Integration

GoDoxy can automatically discover and manage Proxmox nodes and LXC containers through configured providers.

Automatic Route Binding

Routes are automatically linked to Proxmox resources through reverse lookup:

1. Node-level routes (VMID = 0): When hostname, IP, or alias matches a Proxmox node name or IP
2. Container-level routes (VMID > 0): When hostname, IP, or alias matches an LXC container

This enables seamless proxy configuration without manual binding:

routes:
  pve-node-01:
    host: pve-node-01.internal
    port: 8006
    # Automatically links to Proxmox node pve-node-01

WebUI Management

From the WebUI, you can:

• LXC Lifecycle Control: Start, stop, restart containers
• Node Logs: Stream real-time journalctl or log files output from nodes
• LXC Logs: Stream real-time journalctl or log files output from containers

Update / uninstall system agent

Installer supports both systemd and Alpine/OpenRC (rc-service) hosts.

Update:

sh -c "$(curl -fsSL https://github.com/yusing/godoxy/raw/refs/heads/main/scripts/install-agent.sh)" -- update

Uninstall:

sh -c "$(curl -fsSL https://github.com/yusing/godoxy/raw/refs/heads/main/scripts/install-agent.sh)" -- uninstall

Manual Setup

1. Make config directory then grab config.example.yml into config/config.yml

   mkdir -p config && wget https://raw.githubusercontent.com/yusing/godoxy/main/config.example.yml -O config/config.yml

2. Grab .env.example into .env

   wget https://raw.githubusercontent.com/yusing/godoxy/main/.env.example -O .env

3. Grab compose.example.yml into compose.yml

   wget https://raw.githubusercontent.com/yusing/godoxy/main/compose.example.yml -O compose.yml

Folder structure

├── certs
│   ├── cert.crt
│   └── priv.key
├── compose.yml
├── config
│   ├── config.yml
│   ├── middlewares
│   │   ├── middleware1.yml
│   │   ├── middleware2.yml
│   ├── provider1.yml
│   └── provider2.yml
├── data
│   ├── metrics # metrics data
│   │   ├── uptime.json
│   │   └── system_info.json
└── .env

Build from source

1. Clone the repository git clone https://github.com/yusing/godoxy --depth=1

2. Install / Upgrade go (>=1.22) and shadowtree if not already

3. Clear cache if you have built this before (go < 1.22) with go clean -cache

4. Get dependencies with shadowtree mod-tidy

5. Build binary with shadowtree build

Star History