Zoraxy：通用反向代理与转发工具

项目简介

Zoraxy 是一个用 Go 编写的通用 HTTP 反向代理与转发工具，提供界面简洁、内置操作说明的网页管理面板。它面向自建服务与家庭实验室（homelab）用户，可以把多个后端 Web 服务统一路由到一台服务器上，并集中管理域名、证书与访问控制。

主要功能

• 反向代理（HTTP/2）：支持虚拟目录、自动 WebSocket 代理（无需配置）、Basic Auth、别名主机名、自定义请求头、负载均衡
• 重定向规则
• TLS / SSL 证书申请与部署：ACME 自动续期、SNI 与 SAN 证书、Let's Encrypt DNS Challenge（支持多个 DNS 服务商）
• 按国家或 IP 的黑白名单（支持单个 IP、CIDR、通配符）
• 流代理（TCP & UDP）
• 内置在线状态监控（Up-time Monitor）
• Web-SSH 终端
• 插件系统
• 实用工具：CIDR IP 转换、mDNS 扫描、Wake-On-Lan、调试用正向代理、IP 扫描、端口扫描
• 社区贡献功能：Forward-Auth（如 Authelia、Authentik）、Oauth2、reCAPTCHA
• 其他：单管理员管理模式、外部权限管理系统对接、用于重置密码的 SMTP 配置、深色主题

安装与使用

官方提供 Windows 与 Linux 的预编译版本：

• Windows
• Linux (amd64)
• Linux (arm64)

其他系统或架构请见 Releases。Docker 部署方式见仓库的 /docker 目录。

从源码编译（需要 Go 1.23 或更高版本）：

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

sudo ./zoraxy -port=:8000

Standalone 模式（默认模式，单账号管理，类似家用路由器的管理方式）：

• Linux：sudo ./zoraxy -port=:8000
• Windows：下载可执行文件后双击启动
• 树莓派：安装方式与 Linux 相同，树莓派 4 及更新型号选 arm64，旧型号选 arm（armv6）版本
• 其他 ARM 单板电脑或 Termux 上的 Android 手机：按设备 CPU 架构选择对应版本

启动参数较多，例如 -port（管理界面端口，默认 :8000）、-default_inbound_port（Web 服务监听端口，默认 443）、-noauth（关闭管理界面认证）等，可用 -version 查看版本。

如果上游已有带权限管理的反向代理，可用 noauth 模式启动：

./zoraxy -noauth=true

如需从 Nginx / NPM 迁移，可使用官方的（实验性）配置转换工具：Nginx 转 Zoraxy 配置转换器。

注意事项

• -noauth 会关闭管理界面认证，仅在可信环境或前方已有认证代理时使用。
• 出于安全原因，Web-SSH 默认禁止连接 127.0.0.1、localhost 等回环地址；测试或开发时可用 ./zoraxy -sshlb=true 强制开启，该选项有风险。
• Web SSH 目前仅支持 Linux 系统（linux/amd64、linux/arm64，linux/armv6 与 linux/386 为实验性支持）。
• 本项目以 AGPL 协议开源，软件本身免费；若从第三方卖家处获取，仓库作者不承担技术支持责任。

---

本作品整理自 GitHub 开源项目 tobychui/zoraxy，原作者 @tobychui，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。