tobychui /zoraxy

A general purpose HTTP reverse proxy and forwarding tool. Now written in Go!

★ 5,579⑂ 337👁 33⑃ 355● 768▤ 73
HTMLAGPL-3.0Created 2022-11-01zoraxy.aroz.org
下载:v3.3.5v3.3.5 ↓3.3.52026-11-13
+1
日增长
5,579
stars
337
forks
33
watchers
355
prs
768
issues
73
releases

README

!

 Zoraxy

A general purpose HTTP reverse proxy and forwarding tool. Now written in Go!

 Features

- Simple to use interface with detail in-system instructions
- Reverse Proxy (HTTP/2)
  - Virtual Directory
  - WebSocket Proxy (automatic, no set-up needed) 
  - Basic Auth
  - Alias Hostnames
  - Custom Headers
  - Load Balancing
- Redirection Rules
- TLS / SSL setup and deploy
  - ACME features like auto-renew to serve your sites in https
  - SNI support (and SAN certs)
  - DNS Challenge for Let's Encrypt and these DNS providers
- Blacklist / Whitelist by country or IP address (single IP, CIDR or wildcard for beginners)
- Stream Proxy (TCP & UDP)
- Integrated Up-time Monitor
- Web-SSH Terminal
- Plugin System
- Utilities
  - CIDR IP converters
  - mDNS Scanner
  - Wake-On-Lan
  - Debug Forward Proxy
  - IP Scanner
  - Port Scanner
- Community Contributed Features
  - Forward-Auth Support (e.g. Authelia, Authentik)
  - Oauth2 Support 
  - reCAPTCHA 

- Others
  - Basic single-admin management mode
  - External permission management system for easy system integration
  - SMTP config for password reset
  - Dark Theme Mode

 Downloads

Windows
/ Linux (amd64)
/ Linux (arm64)

For other systems or architectures, please see Releases 

 Getting Started

Installing Zoraxy Reverse Proxy: Your Gateway to Efficient Web Routing

Thank you for the well written and easy to follow tutorial by Reddit user itsvmn! 
If you have no background in setting up reverse proxy or web routing, you should check this out before you start setting up your Zoraxy. 

 Switching from Nginx / NPM? 
Check out our new (experimental) nginx to Zoraxy config converter!

Launch Config Converter

 Build from Source

Requires Go 1.23 or higher

bash
git clone https://github.com/tobychui/zoraxy
cd ./zoraxy/src/
go mod tidy
go build

sudo ./zoraxy -port=:8000


 Usage

Zoraxy provides basic authentication system for standalone mode. To use it in standalone mode, follow the instructions below for your desired deployment platform.

 Standalone Mode

Standalone mode is the default mode for Zoraxy. This allows a single account to manage your reverse proxy server just like a basic home router. This mode is suitable for new owners to homelabs or makers starting growing their web services into multiple servers. A full "Getting Started" guide can be found here.

 Linux

bash
sudo ./zoraxy -port=:8000


 Windows

Download the binary executable and double click the binary file to start it.

 Raspberry Pi

The installation method is same as Linux. If you are using a Raspberry Pi 4 or newer models, pick the arm64 release. For older version of Pis, use the arm (armv6) version instead.

 Other ARM SBCs or Android phone with Termux

The installation method is same as Linux. For other ARM SBCs, please refer to your SBC's CPU architecture and pick the one that is suitable for your device. 

 Docker

See the /docker folder for more details.

 Start Parameters


Usage of zoraxy:
  -acmetestmode
        Run 

Top issues

Discussions

Latest release

v3.3.5 v3.3.5 2026-11-13
v3.3.5

This version of Zoraxy fixed quite a lot of security related issues (due to recent flood of AI generated security advisories, which after manual review, some of them are true) with added features on Zoraxy Auth and HTTP/3 (QUIC) support. There are also significantly more PRs in this release due to (I think) much more improved agentic coding tools. Other than that, as usual, there are ACME / DNS providers update and some patches in fixing small bugs in Captcha and oAuth flow. Full summary below.

 What's Changed
 Fix client IP detection for IPv6 clients in forward auth by @Elandrya

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON