# GoDoxy [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=yusing_go-proxy&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=yusing_go-proxy) ![GitHub last commit](https://img.shields.io/github/last-commit/yusing/go-proxy) [![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=yusing_go-proxy&metric=ncloc)](https://sonarcloud.io/summary/new_code?id=yusing_go-proxy) [![](https://dcbadge.limes.pink/api/server/umReR62nRd?style=flat)](https://discord.gg/umReR62nRd) A lightweight, simple, and [performant](https://github.com/yusing/go-proxy/wiki/Benchmarks) reverse proxy with WebUI. For full documentation, check out **[Wiki](https://github.com/yusing/go-proxy/wiki)** **EN** | δΈ­ζ–‡
## Table of content - [GoDoxy](#godoxy) - [Table of content](#table-of-content) - [Key Features](#key-features) - [Prerequisites](#prerequisites) - [Setup](#setup) - [Manual Setup](#manual-setup) - [Folder structrue](#folder-structrue) - [Screenshots](#screenshots) - [idlesleeper](#idlesleeper) - [Build it yourself](#build-it-yourself) ## Key Features - Easy to use - Effortless configuration - Simple multi-node setup - Error messages is clear and detailed, easy troubleshooting - Auto SSL cert management (See [Supported DNS-01 Challenge Providers](https://github.com/yusing/go-proxy/wiki/Supported-DNS%E2%80%9001-Providers)) - Auto configuration for docker containers - Auto hot-reload on container state / config file changes - **idlesleeper**: stop containers on idle, wake it up on traffic _(optional, see [screenshots](#idlesleeper))_ - HTTP(s) reserve proxy - OpenID Connect support - [HTTP middleware support](https://github.com/yusing/go-proxy/wiki/Middlewares) - [Custom error pages support](https://github.com/yusing/go-proxy/wiki/Middlewares#custom-error-pages) - TCP and UDP port forwarding - **Web UI with App dashboard and config editor** - Supports linux/amd64, linux/arm64 - Written in **[Go](https://go.dev)** [πŸ”ΌBack to top](#table-of-content) ## Prerequisites Setup DNS Records point to machine which runs `GoDoxy`, e.g. - A Record: `*.y.z` -> `10.0.10.1` - AAAA Record: `*.y.z` -> `::ffff:a00:a01` ## Setup **NOTE:** GoDoxy is designed to be (and only works when) 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](#manual-setup) ```shell /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/yusing/go-proxy/v0.9/scripts/setup.sh)" ``` 3. Start the container `docker compose up -d` and wait for it to be ready 4. You may now do some extra configuration on WebUI `https://godoxy.yourdomain.com` [πŸ”ΌBack to top](#table-of-content) ### Manual Setup 1. Make `config` directory then grab `config.example.yml` into `config/config.yml` `mkdir -p config && wget https://raw.githubusercontent.com/yusing/go-proxy/v0.9/config.example.yml -O config/config.yml` 2. Grab `.env.example` into `.env` `wget https://raw.githubusercontent.com/yusing/go-proxy/v0.9/.env.example -O .env` 3. Grab `compose.example.yml` into `compose.yml` `wget https://raw.githubusercontent.com/yusing/go-proxy/v0.9/compose.example.yml -O compose.yml` ### Folder structrue ```shell β”œβ”€β”€ 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 ``` ## Screenshots ### idlesleeper ![idlesleeper](screenshots/idlesleeper.webp) ### Uptime Monitor ![uptime monitor](screenshots/uptime.png) ### System Monitor ![system monitor](screenshots/system-monitor.png) [πŸ”ΌBack to top](#table-of-content) ## Build it yourself 1. Clone the repository `git clone https://github.com/yusing/go-proxy --depth=1` 2. Install / Upgrade [go (>=1.22)](https://go.dev/doc/install) and `make` if not already 3. Clear cache if you have built this before (go < 1.22) with `go clean -cache` 4. get dependencies with `make get` 5. build binary with `make build` [πŸ”ΌBack to top](#table-of-content)