tobychui /zoraxy
A general purpose HTTP reverse proxy and forwarding tool. Now written in Go!
★ 5,579⑂ 337👁 33⑃ 355● 768▤ 73
+1
Daily
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
#895[HELP] Forward Auth with Authentik80 comments · 2025-11-16#33[ENHANCEMENTS] Include forward authentication support46 comments · 2023-07-24#386[HELP] Not possible to create an SSL certificate37 comments · 2024-11-09#22[ENHANCEMENTS] Fail2ban features31 comments · 2023-06-15#922[BUG] ACME Tool not working for DNS challenge with INWX28 comments · 2025-12-06#1087[BUG] 3.3.2 Denies access19 comments · 2026-03-23#971[BUG] Uptime monitor fails with self-signed certificate15 comments · 2026-01-04#238[ENHANCEMENTS] - block / restict access to a sub path/location15 comments · 2024-07-13
Discussions
#1357creating passkey in backend for zoraxy auth user2 comments · 2026-11-03#1350WAF plugin: what the sniffer is missing, and a small-steps plan2 comments · 2026-10-30#1347Sablier plugin for Zoraxy: guidance on per-rule config and dynamic capture1 comments · 2026-10-28#1307Question: Log retention when Log Rotation is disabled1 comments · 2026-09-19#1299Shouldn't "Real network output" not include admin traffic ?1 comments · 2026-09-17#1285Images not showing when using http2 for iis in windows server 20252 comments · 2026-09-04#1281Unable to get Nextcloud work via Zoraxy.1 comments · 2026-08-31#1270Forward specific port of an existing HTTP Proxy to a different host2 comments · 2026-08-19
Latest release
v3.3.5 v3.3.5 2026-11-13v3.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