{"id":13482039,"url":"https://github.com/tobychui/zoraxy","last_synced_at":"2026-01-16T11:12:29.565Z","repository":{"id":134126150,"uuid":"560236194","full_name":"tobychui/zoraxy","owner":"tobychui","description":"A general purpose HTTP reverse proxy and forwarding tool. Now written in Go!","archived":false,"fork":false,"pushed_at":"2026-01-11T04:31:19.000Z","size":124626,"stargazers_count":4821,"open_issues_count":134,"forks_count":270,"subscribers_count":33,"default_branch":"main","last_synced_at":"2026-01-11T12:03:16.588Z","etag":null,"topics":["arozos","bridge","cluster-gateway","golang","homelab","http-proxy","port-forward","proxy","redirect","reverse-proxy","server","subdomain","tcp-proxy","virtual-directory","websocket-proxy","zoraxy"],"latest_commit_sha":null,"homepage":"https://zoraxy.aroz.org","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tobychui.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-11-01T02:52:21.000Z","updated_at":"2026-01-11T11:58:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"4b324e0a-5f98-43db-ad6e-0b2bc79545bd","html_url":"https://github.com/tobychui/zoraxy","commit_stats":null,"previous_names":[],"tags_count":52,"template":false,"template_full_name":null,"purl":"pkg:github/tobychui/zoraxy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tobychui%2Fzoraxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tobychui%2Fzoraxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tobychui%2Fzoraxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tobychui%2Fzoraxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tobychui","download_url":"https://codeload.github.com/tobychui/zoraxy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tobychui%2Fzoraxy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28478137,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T06:30:42.265Z","status":"ssl_error","status_checked_at":"2026-01-16T06:30:16.248Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arozos","bridge","cluster-gateway","golang","homelab","http-proxy","port-forward","proxy","redirect","reverse-proxy","server","subdomain","tcp-proxy","virtual-directory","websocket-proxy","zoraxy"],"created_at":"2024-07-31T17:00:58.417Z","updated_at":"2026-01-16T11:12:24.554Z","avatar_url":"https://github.com/tobychui.png","language":"HTML","readme":"![](./img/title.png)\n\n# Zoraxy\n\nA general purpose HTTP reverse proxy and forwarding tool. Now written in Go!\n\n### Features\n\n- Simple to use interface with detail in-system instructions\n- Reverse Proxy (HTTP/2)\n  - Virtual Directory\n  - WebSocket Proxy (automatic, no set-up needed) \n  - Basic Auth\n  - Alias Hostnames\n  - Custom Headers\n- Redirection Rules\n- TLS / SSL setup and deploy\n  - ACME features like auto-renew to serve your sites in http**s**\n  - SNI support (and SAN certs)\n  - DNS Challenge for Let's Encrypt and [these DNS providers](https://go-acme.github.io/lego/dns/)\n- Blacklist / Whitelist by country or IP address (single IP, CIDR or wildcard for beginners)\n- Global Area Network Controller Web UI (ZeroTier not included)\n- Stream Proxy (TCP \u0026 UDP)\n- Integrated Up-time Monitor\n- Web-SSH Terminal\n- Utilities\n  - CIDR IP converters\n  - mDNS Scanner\n  - Wake-On-Lan\n  - Debug Forward Proxy\n  - IP Scanner\n- Others\n  - Basic single-admin management mode\n  - External permission management system for easy system integration\n  - SMTP config for password reset\n  - Dark Theme Mode\n\n## Downloads\n\n[Windows](https://github.com/tobychui/zoraxy/releases/latest/download/zoraxy_windows_amd64.exe)\n/ [Linux (amd64)](https://github.com/tobychui/zoraxy/releases/latest/download/zoraxy_linux_amd64)\n/ [Linux (arm64)](https://github.com/tobychui/zoraxy/releases/latest/download/zoraxy_linux_arm64)\n\nFor other systems or architectures, please see [Releases](https://github.com/tobychui/zoraxy/releases/latest/) \n\n## Getting Started\n\n[Installing Zoraxy Reverse Proxy: Your Gateway to Efficient Web Routing](https://geekscircuit.com/installing-zoraxy-reverse-proxy-your-gateway-to-efficient-web-routing/)\n\nThank you for the well written and easy to follow tutorial by Reddit user [itsvmn](https://www.reddit.com/user/itsvmn/)! \nIf you have no background in setting up reverse proxy or web routing, you should check this out before you start setting up your Zoraxy. \n\n## Build from Source\n\nRequires Go 1.23 or higher\n\n```bash\ngit clone https://github.com/tobychui/zoraxy\ncd ./zoraxy/src/\ngo mod tidy\ngo build\n\nsudo ./zoraxy -port=:8000\n```\n\n## Usage\n\nZoraxy provides basic authentication system for standalone mode. To use it in standalone mode, follow the instructions below for your desired deployment platform.\n\n### Standalone Mode\n\nStandalone 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](https://github.com/tobychui/zoraxy/wiki/Getting-Started).\n\n#### Linux\n\n```bash\nsudo ./zoraxy -port=:8000\n```\n\n#### Windows\n\nDownload the binary executable and double click the binary file to start it.\n\n#### Raspberry Pi\n\nThe 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.\n\n#### Other ARM SBCs or Android phone with Termux\n\nThe 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. \n\n#### Docker\n\nSee the [/docker](https://github.com/tobychui/zoraxy/tree/main/docker) folder for more details.\n\n### Start Parameters\n\n```\nUsage of zoraxy:\n  -autorenew int\n        ACME auto TLS/SSL certificate renew check interval (seconds) (default 86400)\n  -cfgupgrade\n        Enable auto config upgrade if breaking change is detected (default true)\n  -db string\n        Database backend to use (leveldb, boltdb, auto) Note that fsdb will be used on unsupported platforms like RISCV (default \"auto\")\n  -default_inbound_enabled\n        If web server is enabled by default (default true)\n  -default_inbound_port int\n        Default web server listening port (default 443)\n  -docker\n        Run Zoraxy in docker compatibility mode\n  -earlyrenew int\n        Number of days to early renew a soon expiring certificate (days) (default 30)\n  -fastgeoip\n        Enable high speed geoip lookup, require 1GB extra memory (Not recommend for low end devices)\n  -log string\n        Log folder path (default \"./log\")\n  -mdns\n        Enable mDNS scanner and transponder (default true)\n  -mdnsname string\n        mDNS name, leave empty to use default (zoraxy_{node-uuid}.local)\n  -noauth\n        Disable authentication for management interface\n  -plugin string\n        Plugin folder path (default \"./plugins\")\n  -port string\n        Management web interface listening port (default \":8000\")\n  -sshlb\n        Allow loopback web ssh connection (DANGER)\n  -update_geoip\n        Download the latest GeoIP data and exit\n  -uuid string\n        sys.uuid file path (default \"./sys.uuid\")\n  -version\n        Show version of this server\n  -webfm\n        Enable web file manager for static web server root folder (default true)\n  -webroot string\n        Static web server root folder. Only allow change in start paramters (default \"./www\")\n```\n\n### External Permission Management Mode\n\nIf you already have an upstream reverse proxy server in place with permission management, you can use Zoraxy in noauth mode. To enable noauth mode, start Zoraxy with the following flag:\n\n```bash\n./zoraxy -noauth=true\n```\n\n\u003e [!WARNING]\n\u003e For security reasons, you should only enable no-auth if you are running Zoraxy in a trusted environment or with another authentication management proxy in front.*\n\n## Screenshots\n\n![](img/screenshots/1.png)\n\n![](img/screenshots/2.png)\n\nMore screenshots on the wikipage [Screenshots](https://github.com/tobychui/zoraxy/wiki/Screenshots)!\n\n## FAQ\n\nThere is a wikipage with [Frequently-Asked-Questions](https://github.com/tobychui/zoraxy/wiki/FAQ---Frequently-Asked-Questions)!\n\n## Global Area Network Controller\n\nThis project also compatible with [ZeroTier](https://www.zerotier.com/). However, due to licensing issues, ZeroTier is not included in the binary. \n\nTo use Zoraxy with ZeroTier, assuming you already have a valid license, install ZeroTier on your host and then run Zoraxy in sudo mode (or Run As Administrator if you are on Windows). The program will automatically grab the authtoken in the correct location on your host.\n\nIf you prefer not to run Zoraxy in sudo mode or you have some weird installation profile, you can also pass in the ZeroTier auth token using the following flags:\n\n```bash\n./zoraxy -ztauth=\"your_zerotier_authtoken\" -ztport=9993\n```\n\nThe ZeroTier auth token can usually be found at ```/var/lib/zerotier-one/authtoken.secret``` or ```C:\\ProgramData\\ZeroTier\\One\\authtoken.secret```. \n\nThis allows you to have an infinite number of network members in your Global Area Network controller. For more technical details, see [here](https://docs.zerotier.com/self-hosting/network-controllers/).\n\n## Web SSH\n\nWeb SSH currently only supports Linux based OSes. The following platforms are supported:\n\n- linux/amd64\n- linux/arm64\n- linux/armv6 (experimental)\n- linux/386 (experimental)\n\n### Loopback Connection\n\nLoopback web SSH connections, by default, are disabled. This means that if you are trying to connect to an address like 127.0.0.1 or localhost, the system will reject your connection for security reasons. To enable loopback for testing or development purpose, use the following flags to override the loopback checking:\n\n```bash\n./zoraxy -sshlb=true\n```\n\n## Sponsor This Project\n\nIf you like the project and want to support us, please consider a donation. You can use the links below\n\n- [tobychui (Primary author)](https://paypal.me/tobychui)\n- PassiveLemon (Docker compatibility maintainer)\n\n## License\n\nThis project is open-sourced under AGPL. I open-sourced this project so everyone can check for security issues and benefit all users. **This software is intended to be free of charge. If you have acquired this software from a third-party seller, the authors of this repository bears no responsibility for any technical difficulties assistance or support.**\n\n","funding_links":["https://paypal.me/tobychui"],"categories":["HTML","网络信息服务","server"],"sub_categories":["网络协议"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftobychui%2Fzoraxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftobychui%2Fzoraxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftobychui%2Fzoraxy/lists"}