liandu2024/Open-Box

▲ 39 stars today★ 2,644⑂ 491

Open-Box 一体化透明代理:OpenWrt / Debian / Ubuntu / Docker;自有程序闭源,第三方组件遵守原许可。

About liandu2024/Open-Box

liandu2024/Open-Box is an open-source project on GitHub, mainly written in Shell. Open-Box 一体化透明代理:OpenWrt / Debian / Ubuntu / Docker;自有程序闭源,第三方组件遵守原许可。 It currently holds 2,644 stars and 491 forks with 249 open issues, and was last pushed on 2026-11-08 (repository created 2026-08-16).

Project Overview

Git Homed tracks it on the Today's Trending board, currently at rank #88 with 39 new stars today.

GitHub Repository Details

Repository liandu2024/Open-Box · default branch main · size 2916 KB · watchers 9 · source: GitHub REST API and repository README

README

https://github.com/liandu2024/Open-Box/blob/HEAD/Open-Box

Open-Box 分两部分:路由器端装在路由器 / 主机上,是一体化透明代理——安装包内置 Open-Box、sing-box 内核、Node 运行时以及完整 GeoSite / GeoIP 数据,安装后通过浏览器完成订阅、节点、分流、DNS 和防火墙设置,不需要手写配置文件;客户端是手机、电脑上的 Open-Box App,和家里的路由器端配对,在外面也按同一套规则分流。

Open-Box 自有程序为闭源专有软件,并非开源项目。未经许可禁止复制传播自有代码、再分发、反编译及绕过授权。 正常安装、离线使用、升级、备份和恢复允许;第三方开源组件保留原许可。详见 LICENSE 和 版权范围。

支持的平台

路由器端(同一份安装包、同一条安装命令,脚本自己识别系统),见路由器端:

客户端(Open-Box App,四个平台同一套界面和功能),见客户端:

使用说明视频

来自安格视界 YouTube 频道的操作演示,按发布先后。点链接会在当前页面打开,建议右键「在新标签页中打开」(或按住 Ctrl / ⌘ 再点):

1. 最新软路由代理 Open-Box 发布!全图形极简配置,超越 OpenClash/Nikki/Passwall + SubStore + Zashboard? 2. 集成 ADGuard Home + 故障转移 + 解决 Google Play 无法下载,Open-Box 更新了啥? 3. 魔改 Sing-Box 1.14 内核,直连提速 200%!等同 Dae 性能,绝无 DNS 泄露 + 链式代理,Open-Box 完整体来了! 4. Open-Box 客户端 Android 来啦!真一键配置 + 完美分流,绝无DNS泄露,是时候卸载 Karing/ClashMi 等其他代理 App 了 5. Windows/macOS 来了,Open-Box 客户端,真一键配置 + 完美分流,绝无DNS泄露,生产力平台哪能缺席? 6. Open-Box 客户端 Liunx 版上线,支持 Ubuntu/Debian,真一键配置,Android 端解决Google Play 下载问题/Geimini无网络问题,iOS 更新预告! 7. 网速提升10倍! 提前杀死比赛?Open-Box 重构 负载均衡 + 带宽择优,Youtube 双 8K60帧无压

推荐服务

路由器端

装在路由器 / 主机上的 Open-Box:浏览器里的面板加 sing-box 内核,给局域网里的设备分流。

界面

概览:四个测试站点的延时和最近几次的走势、连接 / 内存 / 流量的实时曲线、域名过滤统计和按月的流量洞察都在一页上。

面板概览

代理 · 策略:每个站点集一张卡片,直接看到当前线路和节点健康状态。展开的成员列表接近可见区域时再加载,减少进入代理页时的卡顿,并保留展开状态。

代理页策略页签

域名穿透:展开策略后,可以看到站点集、节点组和具体节点的完整链路。

域名穿透

规则 · 真实路由:输入域名后可预览规则匹配结果,并实际发起请求查看线路、DNS 和命中规则。 「模拟终端」会在 LAN 网桥上临时挂一个带独立 MAC 的虚拟网口,像一台真实设备那样从入口进入路由器。ESXi 等虚拟化平台要把端口组安全策略的「混杂模式」设为接受,否则虚拟终端建不起来(面板会提示,不会悄悄退回内核诊断)。

规则调试

订阅管理:支持 Clash YAML、base64 分享链接和常见 sing-box 分享链接;订阅分享区域可展开或收起,分享链接支持二维码、复制和启停。

订阅管理

出站节点:自动择优组和手动选择组可以混排,动态组会按关键词自动收编新节点,多个关键词用逗号分隔,可选 OR(命中任一)或 AND(全部命中)。

带宽择优(路由器端):自动择优、故障转移和负载均衡可按组开启带宽择优,始终先排除故障及尚未确认恢复的节点。带宽测试周期和单次下载上限在后端统一设置,默认 2 小时、64 MB,同一实际节点跨组共用测试记录,并显示预计每日流量。点击开关旁的问号查看当前模式的选择规则和例子。客户端不启用带宽择优或下载测速;节点分流仍由路由器执行自身策略。

出站节点

目标分流:站点集支持域名、域名后缀、关键词、IP 段、规则集和规则集链接等匹配方式。站点集从上往下匹配,先命中的算数。IP 只管 IP,域名只管域名,前置自定义分流和站点集都一样:有域名的访问只看域名条件,一个都没命中就走兜底「其他」,按「其他」的出口走,不会再拿解析出来的 IP 去对任何 IP 段、geoip;IP 条件只管直接按 IP 发起、内核也认不出域名的连接。这样 DNS 和连接永远走同一边:兜底直连的域名问直连 DNS、连接也直连;想让某个站点走节点,把它的域名加进对应站点集或前置自定义分流。内置的私网直连、订阅和节点站点直连不算分流,对所有连接生效。

目标分流

链式代理:住宅 / 静态 IP 这类出口指定一个前置节点或节点组,编辑时就能测速、看出口 IP 和归属。

链式代理

后端设置:IPv6、测速地址、内核服务和统一组件升级都在这里管理。自动测速会遵守每个策略配置的检测间隔;同一节点在间隔内复用已有结果,超时按策略立即重试或切换。

后端设置

手机上打开面板:同一个面板,窄屏自动改成单列 / 两列布局,底部导航(手机上的 App 见客户端)。

https://github.com/liandu2024/Open-Box/blob/HEAD/手机端概览 https://github.com/liandu2024/Open-Box/blob/HEAD/手机端代理

主要功能

下载

请从 GitHub Releases 下载对应架构的完整安装包:

客户端的安装包见客户端。

同一份安装包既能装在 OpenWrt 上,也能装在 Debian / Ubuntu(systemd)上,安装脚本会自行识别(见安装末尾)。

完整安装包包含 Open-Box、sing-box、Node 运行时和全部 GeoSite / GeoIP 数据。每个资产旁边都有 SHA256 校验文件。

作为旁路由使用(把终端的网关 / DNS 指向 Open-Box 所在设备)时,旁路由的 LAN 区域要打开「IP 动态伪装」(MASQUERADE),否则直连站点的回包不经旁路由、连接对不上,表现为只能上国外、打不开大陆网站。

安装

SSH 以 root 登录 OpenWrt 路由器后执行:

curl -fsSL https://raw.githubusercontent.com/liandu2024/Open-Box/main/scripts/install.sh | sh

GitHub 访问不畅时,需要先通过可访问的 raw 镜像获取安装脚本,再让脚本使用镜像下载发布包:

curl -fsSL https://gh-proxy.com/raw.githubusercontent.com/liandu2024/Open-Box/main/scripts/install.sh | sh -s -- --mirror

--mirror 只控制安装包下载;如果最外层的 raw.githubusercontent.com 本身无法访问,直接在原地址后追加 --mirror 仍然无法取得脚本。

安装过程中会问一次面板端口(默认 3036,直接回车即可)。端口会先检查是否可用——被别的程序占用、或与 Open-Box 自己和系统的端口冲突时,会说明原因并让你重填。也可以用 --port 直接指定,例如在上面的命令末尾加 --port 3080。装完之后还能改,见修改面板端口。

安装要求:OpenWrt(iStoreOS 22.03、OpenWrt 22.03 及更早的固件太老装不了,请先升级到 iStoreOS 24 / OpenWrt 24 以上)、x86_64 或 aarch64、至少 512MB 存储空间和 512MB 内存。安装 / 升级脚本会检查并尝试用 opkg 或 apk 补齐系统依赖(kmod-tun、kmod-nft-queue、kmod-nft-nat、kmod-veth、ip-full、ca-bundle);软件源不通时只提示、不中断,可稍后按提示手动安装,设 OPENBOX_SKIP_DEPS=1 可跳过这一步。安装完成后,用浏览器打开脚本提示的 http://<路由器局域网 IP>:<面板端口> 地址,首次访问设置管理密码。

安装完成后,用浏览器打开 http://<路由器 LAN 地址>:<面板端口>(安装脚本结束时会打印这个地址),首次打开时设置面板密码。以后忘了密码不用重装,见下面的忘记面板密码。

Debian / Ubuntu

同样的安装、升级、卸载命令也适用于 Debian / Ubuntu(需要 systemd;在 Ubuntu 24.04 上验证过),以 root 或 sudo 执行即可。脚本会识别系统:服务交给 systemd(openbox.service 内核、openbox-panel.service 面板),命令行 open-box 放在 /usr/local/bin,随包的 Node 是 OpenWrt 用的 musl 版,安装时会从 nodejs.org(不通时换 npmmirror)下载同版本的官方 glibc 版替换,所以安装机器要能访问其中之一。依赖用 apt 补齐(nftables、xz-utils、iproute2、ca-certificates),tun / nftables 内核模块随发行版内核自带。

和 OpenWrt 的差别:

修改面板端口

新装的默认端口是 3036;v0.1.216 及更早装的机器升级后端口不变(还是 2026),不会被新默认值挪走。

两种改法,效果一样:

改完记得用新地址访问面板。

忘记面板密码

面板密码保存在路由器上,能以 root 登上路由器就能查到,不需要重装,也不会丢失订阅和规则。两个地方可以看:

1. LuCI 页面:路由器管理界面 → 服务 → Open-Box,页面顶部「完整管理请到 Open-Box 面板:」那一行,面板地址后面直接显示 密码: xxxx。刚升级完看不到的话,退出 LuCI 重新登录一次。

2. SSH 命令:SSH 登上路由器后运行 open-box,选 1:

root@OpenWrt:~# open-box

Open-Box v0.1.216 1) 当前密码 2) 重新启动 3) 检查升级 4) 卸载 5) 退出 请选择 [1-5]: 1

面板地址: http://192.168.1.1:3036 当前密码: ******

只想要密码本身可以直接运行 open-box password;open-box check 检查有没有新版本,open-box update 直接升级,open-box restart 重启内核和面板,open-box uninstall 卸载。

以上两个入口从 v0.1.210 开始提供。更早的版本先通过 SSH 执行下面「升级」一节的命令升到最新版(升级会保留密码、订阅和规则),升级完成后 open-box 命令就可以用了。

查到密码后想换一个:登录面板,在「设置」页点「修改密码」。

升级

面板中可以从“设置 → 后端设置”检查更新,也可以通过 SSH 执行(OpenWrt 与 Debian / Ubuntu 同一条命令):

curl -fsSL https://raw.githubusercontent.com/liandu2024/Open-Box/main/scripts/update.sh | sh

升级会保留订阅、规则和面板密码,并校验 Open-Box、sing-box、GeoSite / GeoIP 组件。相同且完整的组件直接复用,只有变化、缺失或损坏的组件才会从本仓库 Release 下载。

回退到上一个版本

如果升级后面板或内核异常,可以用下面的命令回退:脚本会到 GitHub 查当前版本之前最近的正式 Release,重新下载那一版的完整安装包装回去。路由器本机不保留旧版备份,所以回退需要能访问 GitHub(或镜像);订阅、规则、面板密码等数据目录不会被动。

curl -fsSL https://raw.githubusercontent.com/liandu2024/Open-Box/main/scripts/update.sh | sh -s -- --rollback --direct

GitHub 访问不畅时,使用代理执行:

curl -fsSL https://gh-proxy.com/raw.githubusercontent.com/liandu2024/Open-Box/main/scripts/update.sh | sh -s -- --rollback --mirror https://gh-proxy.com

两条命令都会自动识别路由器架构,下载上一个版本的完整安装包,先校验 SHA256,再替换当前文件;校验或替换失败会保留现有安装。--mirror 只影响安装包下载,查询 Release 列表的 GitHub API 会先直连、直连不通再经镜像。

卸载

默认停止服务并保留订阅和配置数据:

curl -fsSL https://raw.githubusercontent.com/liandu2024/Open-Box/main/scripts/uninstall.sh | sh

连数据一起删除:

curl -fsSL https://raw.githubusercontent.com/liandu2024/Open-Box/main/scripts/uninstall.sh | sh -s -- --purge

客户端

Open-Box App 把家里路由器端的分流规则带到手机、电脑上:在外面也按同一套规则分流,App 里的内核和路由器端是同一个 sing-box。Android、macOS、Windows、Linux 四个平台同一套界面和功能:

安装包都在 Releases:open-box-android-<版本>.apk、open-box-macos-<版本>-arm64.dmg、open-box-windows-<版本>-x64-setup.exe、open-box-desktop-linux-<版本>-amd64.deb,也可以在面板「设置 → 客户端」最上面的「客户端下载」里直接点。客户端只在有更新时随版本发布;最新版没带的话,它的版本说明末尾「客户端下载」一节有最新安装包的链接,也可以在 Releases 列表里往前找。

客户端「设置 → 配置」中,检测到配对失效或配对码已更换时,配置名称右侧会显示红色「!」。点击可查看原因并同步,输入正确的新配对码、同步成功后警告自动消失;本地分流和节点分流都支持。

0.1.361 修复了订阅导入时丢失 TUIC / Hysteria2 证书指纹、WireGuard 预共享密钥及 MTU 的问题。路由器与客户端请同步更新;升级后刷新对应订阅,补回旧节点记录中已丢失的参数。使用证书指纹的节点仍会校验证书身份,指纹不匹配时拒绝连接。

Android 客户端

首页(节点分流)、代理 · 策略(本地分流)、连接 · 路由、设置:

https://github.com/liandu2024/Open-Box/blob/HEAD/App 首页 https://github.com/liandu2024/Open-Box/blob/HEAD/App 代理 · 策略

https://github.com/liandu2024/Open-Box/blob/HEAD/App 连接 · 路由 https://github.com/liandu2024/Open-Box/blob/HEAD/App 设置

macOS 客户端

App 常驻菜单栏,退出 App 就断开 VPN;设置里有开机自启开关(默认关)。

首页(节点分流)、代理 · 策略(本地分流)、连接 · 路由、设置:

https://github.com/liandu2024/Open-Box/blob/HEAD/macOS 首页 https://github.com/liandu2024/Open-Box/blob/HEAD/macOS 代理 · 策略

https://github.com/liandu2024/Open-Box/blob/HEAD/macOS 连接 · 路由 https://github.com/liandu2024/Open-Box/blob/HEAD/macOS 设置

Windows 客户端

App 常驻任务栏右下角:关掉窗口还在后台,左键点图标打开窗口,右键菜单里可以连接 / 断开、退出;退出 App 就断开 VPN。设置里有开机自启开关(默认关)。

首页(节点分流)、代理 · 策略(本地分流)、连接 · 路由、设置:

https://github.com/liandu2024/Open-Box/blob/HEAD/Windows 首页 https://github.com/liandu2024/Open-Box/blob/HEAD/Windows 代理 · 策略

https://github.com/liandu2024/Open-Box/blob/HEAD/Windows 连接 · 路由 https://github.com/liandu2024/Open-Box/blob/HEAD/Windows 设置

Linux 客户端

关掉窗口 App 还在后台,顶栏托盘图标的菜单里可以打开窗口、连接 / 断开、退出;退出 App 就断开 VPN。设置里有开机自启开关(默认关)。

首页(节点分流)、代理 · 策略(本地分流)、连接 · 路由、设置:

https://github.com/liandu2024/Open-Box/blob/HEAD/Linux 首页 https://github.com/liandu2024/Open-Box/blob/HEAD/Linux 代理 · 策略

https://github.com/liandu2024/Open-Box/blob/HEAD/Linux 连接 · 路由 https://github.com/liandu2024/Open-Box/blob/HEAD/Linux 设置

许可证

本仓库公开安装、升级、卸载及 Docker 部署所需脚本、使用文档和官方发行版。Open-Box 自有程序适用根目录 LICENSE,未经许可禁止复制传播、再分发、反编译、制作换名衍生产品及绕过授权。上游 zashboard 的 MIT 代码、sing-box 内核及其他第三方组件继续遵守各自开源许可证;许可范围及历史许可说明见 COPYRIGHT.md。

Star 增长

https://github.com/liandu2024/Open-Box/blob/HEAD/Open-Box Star 增长图

GitHub Stars & Activity

2,644Stars
491Forks
249Open issues
ShellLanguage

GitHub Popularity

GitHub stars2,644
Forks491
Open issues249
Primary languageShell
LicenseNOASSERTION
Stars gained today39
Created2026-08-16
Last pushed2026-11-08

Trending History

Daily boardrank #88 · ▲ 39 stars

Related GitHub Projects

1

obra / superpowers

Shell★ 314,802⑂ 28,005▲ 518 stars
→
2

msitarzewski / agency-agents

Shell★ 167,404⑂ 27,135▲ 192 stars
→
3

omacom / omarchy

Shell★ 46,640⑂ 5,994▲ 100 stars
→
4

anthropics / skills

Python★ 190,078⑂ 22,387▲ 792 stars
→
5

jackfrued / Python-100-Days

Jupyter Notebook★ 187,774⑂ 55,733▲ 38 stars
→
6

jaywcjlove / awesome-mac

Swift★ 118,107⑂ 10,132▲ 109 stars
→
7

sherlock-project / sherlock

Python★ 105,734⑂ 12,281▲ 2,373 stars
→
8

ruvnet / RuView

Rust★ 103,127⑂ 13,389▲ 203 stars
→

More Trending Repositories