简体中文 | English
从发行页按系统和架构选择 duorelay-mihomo-* 或 duorelay-singbox-*。两个版本使用同一面板和数据格式,各自仅携带对应内核。
| 版本 | 适用场景 |
|---|---|
| mihomo 版 | Clash 生态,支持 Mieru、VLESS XHTTP、负载均衡和手动分组 |
| sing-box 版 | 使用 Naive、ShadowTLS、Tor、OpenConnect 等协议,或需要 sing-box 的路由和链式代理 |
Linux 支持 amd64 和 arm64,Windows 支持 amd64。旧 duorelay-lite 用户可以升级到 mihomo 版。双核用户可继续使用过渡版,切换到单内核版时,面板会尝试用保存的节点重新生成运行配置。不兼容的节点和订阅仍保存在数据库中。关于无法自动迁移的情况,见 单内核发行与升级。
make build-mihomo
make build-singbox
make package-linux-all VERSION=0.3.2基于 sing-box 与 mihomo 的双内核代理管理面板,使用 Web 界面管理节点、订阅、路由和内核运行状态。
lite 压缩包 31.83 MB 起,保留完整面板。 同版本 0.3.0 本地构建实测如下(十进制 MB,包含面板、对应内核及随包文档,不含 Geo):
| 平台 | full 压缩包 | lite 压缩包 |
|---|---|---|
| Linux amd64 | 62.34 MB | 34.66 MB |
| Linux arm64 | 56.91 MB | 31.83 MB |
| Windows amd64 | 66.56 MB | 34.34 MB |
仪表盘:开始使用后的运行概览
开始使用后的仪表盘效果:集中查看节点概览、当前代理节点、内核运行状态与流量采样。图中使用临时演示数据,流量按实际运行状态显示。
节点管理:多协议节点与 lite 能力提示
集中管理节点、筛选协议并查看运行状态。示例域名和未测速状态保留原样,不作为公网节点可用性或延迟证明。
链式代理:逐跳组织与配置预览
展示链路顺序和内核能力检查;截图中的示例链路仅作配置预览,未启动。
路由编辑:文本规则与分流策略
路由支持列表与文本双模式编辑,图中展示文本模式;规则仍通过结构化校验后应用。
以上四张截图来自 orca-linux 中的临时演示实例。解压后的文件大小、首次 Geo 缓存与更多功能介绍见 图文介绍。这些是本地构建记录,不代表另行发版;真实系统的未验证项目见 验收报告。
| 功能 | 说明 |
|---|---|
| 双内核 | 生成 sing-box、mihomo 配置并管理内核进程;实际能力受内核和协议限制 |
| Web 管理 | 首次访问创建管理员;管理节点、订阅、内核、连接和日志 |
| 节点与订阅 | 导入常见分享链接和订阅格式,支持测速、勾选后批量删除、负载均衡及链式代理 |
| 软件更新 | 在“设置 → 关于”检查匹配当前发行版与平台的 GitHub 正式版;可写安装目录支持一键更新,受保护的 Linux systemd 安装按部署文档升级 |
| 路由规则 | 通过列表或文本编辑结构化规则,支持导入、导出和逐行校验 |
| 配置安全 | 应用前调用对应内核校验;失败时保留或恢复先前运行状态 |
| 运行观测 | 展示内核日志、连接信息和流量采样历史 |
| 系统接入 | 提供 Linux 透明代理和 Windows 系统代理相关选项;实际验收范围见下文 |
项目覆盖 28 项代理协议、端点或组网能力的统一模型、解析或配置生成。覆盖不等于全部协议均已通过真实节点连通测试;可用性取决于内核版本、配置与远端服务。
| 范围 | 协议或能力 |
|---|---|
| 两核共有 | Shadowsocks、VMess、VLESS、Trojan、Hysteria、Hysteria2、TUIC、AnyTLS、Snell、SOCKS5、HTTP、SSH、WireGuard、OpenVPN、MASQUE、Tailscale |
| sing-box | ShadowTLS、Naive、Tor、OpenConnect |
| mihomo | ShadowsocksR、Mieru、Sudoku、ShadowQUIC、TrustTunnel、Rematch、EasyTier、ZeroTier |
订阅格式及限制见 订阅格式,链式代理限制见 多节点代理。流量历史是 Clash API 速率采样,并非按用户或节点计费的累计账单。
克隆仓库后,在项目根目录选择一种版本启动。默认 full 支持 Linux amd64;lite 支持 Linux amd64/arm64,构建时自动选择目标架构:
# full:sing-box + mihomo
docker compose up -d --build
# lite:仅 mihomo,保留完整面板
docker compose -f compose.yaml -f compose.lite.yaml up -d --build两条命令二选一,面板默认只在宿主机 127.0.0.1:8080 开放。两种版本使用同一服务和数据卷;切换前停止原服务并备份数据。lite 首次启动需要下载 Geo 缓存。安装、代理端口、切换和更新步骤见 Docker 部署。
在使用 systemd 的 Linux amd64/arm64 系统上,执行:
# full:默认双核
curl -fsSL https://raw.githubusercontent.com/HlONGlin/DuoRelay/master/scripts/bootstrap-linux.sh | sudo bash -s -- --full
# lite:仅 mihomo,保留完整面板
curl -fsSL https://raw.githubusercontent.com/HlONGlin/DuoRelay/master/scripts/bootstrap-linux.sh | sudo bash -s -- --lite脚本从源码构建前端与后端、下载对应内核并安装 systemd 服务,支持用 apt-get、dnf/yum、pacman、zypper 补装基础依赖,覆盖 Debian/Ubuntu、Fedora、Rocky/AlmaLinux/RHEL、Arch、openSUSE 等发行版。需要运行中的 systemd、glibc 2.28+、amd64/arm64 和 root 权限。Go 或 Node.js/npm 缺失、过旧时,会从官方渠道下载并校验临时工具链,不替换系统版本。已用 root 登录时去掉命令中的 sudo;缺少 curl 时可用文档中的 wget 入口。Alpine、OpenWrt、CentOS 7 等旧 glibc 系统、普通容器及 32 位系统不适用此入口。各发行版真实主机安装仍为 UNVERIFIED,完整条件及故障处理见 Linux 部署。
脚本仅处理首次安装,检测到已有系统安装会退出;数据目录为 /var/lib/duorelay。私有仓库需要配置访问凭据。已有安装升级或切换 full/lite 请按部署文档操作。
以下示例在 Linux 构建运行,需要满足 go.mod 声明的 Go 版本、Node.js/npm、make 和 Git;运行代理功能还需要对应内核。内核下载脚本会校验 kernels.lock 中锁定的散列值,详见 Linux 部署。
git clone https://github.com/HlONGlin/DuoRelay.git
cd DuoRelay
# 准备内核,构建嵌入前端的面板
./scripts/download-kernels.sh --variant mihomo
make build
# 默认监听本机 127.0.0.1:8080
./build/duorelay-mihomo -kernels ./kernels浏览器访问 http://127.0.0.1:8080/,首次访问时按页面提示创建管理员。内核配置应用失败时,请在面板查看具体错误和内核日志。
| 场景 | 入口 |
|---|---|
| Linux systemd 安装、用户服务、卸载 | Linux 部署 |
| Windows 打包、运行和数据迁移 | Windows 部署 |
| 源码开发、测试与目录结构 | 开发指南 |
| 透明代理权限、日志清理、备份、重置密码与 HTTPS | 运维指南 |
程序常用参数如下,完整参数可通过 ./build/duorelay-mihomo -h 查看。
| 参数 | 默认值 | 用途 |
|---|---|---|
-listen |
127.0.0.1:8080 |
面板监听地址 |
-db |
data/duorelay.db |
SQLite 数据库路径 |
-kernels |
kernels |
内核可执行文件目录 |
-config-dir |
data/configs |
生成配置的目录 |
-cookie-secure |
false |
HTTPS 反向代理下设置 Secure 会话 Cookie |
-backup |
空 | 在线备份数据库与配套密钥到新目录,然后退出 |
-reset-password |
false |
从 stdin 重置指定管理员密码并撤销其会话 |
-username |
admin |
密码重置的账号 |
迁移时请备份整个数据目录,尤其是数据库和对应的 .key 文件;丢失密钥会导致已加密的订阅地址无法恢复。
内部路由、绕过规则、用户规则依次匹配;独立 SOCKS5 端口默认是 10808。在“设置 → 通用”可添加最多 32 个额外 SOCKS5 端口并分别绑定节点;每个端口独立于当前主代理与路由规则。端口沿用入站监听地址,full 按 sing-box 或 mihomo 的能力运行,lite 使用 mihomo;目标节点须兼容当前内核。保存后重新应用配置生效。开放局域网访问时,这些端口也会对局域网开放。节点批量删除及更新限制见节点管理与多节点代理和应用更新;路由验证记录及文本格式见 路由验收。
| 目标系统 | 当前边界 |
|---|---|
| Linux | 提供 redirect、tproxy、tun 选项;权限、DNS 和真实流量的验证状态因模式而异 |
| Windows | 系统代理仅操作当前用户;系统代理恢复和 TUN 仍需真实 Windows 环境验收 |
| macOS | TUN 尚未完成真实系统验证,不作为已验证支持声明 |
透明代理不能等同于完整接管或 DNS 防泄漏保证。Linux redirect 不接管 UDP DNS;各模式的前提和结果见 透明代理验收。容器结果与真实主机结果分开记录在 容器验收。
go test ./...
go vet ./...
cd web
npm ci
npm run type-check
npm test
npm run build上述测试及配置检查不等于真实网络接管验收。透明代理验证还需要隔离网络环境、临时节点、可观察的代理出口,以及启停前后的规则和路由快照;详细限制见验收文档。
使用、开发、架构和验收文档入口见 docs/README.md。本次 CSV 的 23 项处理及验证范围见问题修复记录;历史总结与计划见归档索引。当前能力以代码与最近的验收记录为准。
DuoRelay 的许可证尚未确定。sing-box 和 mihomo 各自使用 GPLv3;使用和分发内核时请查阅其各自的许可条款。
项目仅供学习研究,使用者需遵守所在地法律法规。项目由 Claude Code 辅助开发。



