Open-Box：一体化透明代理

项目简介

Open-Box 是一套一体化透明代理方案，分两部分：

• 路由器端：装在路由器 / 主机上，给局域网设备分流。安装包内置 Open-Box、sing-box 内核、Node 运行时以及完整的 GeoSite / GeoIP 数据，装好后在浏览器里完成订阅、节点、分流、DNS 和防火墙设置，不需要手写配置文件。
• 客户端：手机、电脑上的 Open-Box App，与家里的路由器端配对，在外面也按同一套规则分流。

支持的平台：

• 路由器端：OpenWrt（含 iStoreOS、ImmortalWrt 等衍生固件，带 LuCI 页面）、Debian / Ubuntu（需要 systemd）、Docker 旁路由，均为 x86_64 / aarch64。
• 客户端：Android 12 及以上（64 位 ARM）、macOS 14 及以上（Apple 芯片）、Windows 10 / 11 64 位、Ubuntu 22.04 / 24.04 与 Debian 12（64 位 x86）。

主要功能

• 面板式配置：概览页汇总测试站点延时走势、连接 / 内存 / 流量曲线和域名过滤统计；窄屏自动切换为单列或两列布局，手机上也能打开面板操作。
• 订阅与节点：支持 Clash YAML、base64 分享链接和常见 sing-box 分享链接，协议包括 shadowsocks、vmess、vless（含 REALITY）、trojan、hysteria2（含端口跳跃）、tuic、anytls、wireguard 等；也可在登录页填写支持 Xboard / V2Board 标准接口的站点地址获取节点信息。
• 节点组：自动择优（url-test）、手动选择（select）和故障转移组；动态组可按关键词自动收编新节点，多个关键词用逗号分隔，可选 OR 或 AND。
• 带宽择优：自动择优、故障转移和负载均衡可按组开启，始终先排除故障及尚未确认恢复的节点；带宽测试周期和单次下载上限在后端统一设置。
• 目标分流：站点集支持域名、域名后缀、关键词、IP 段、规则集和规则集链接等匹配方式，从上往下匹配，先命中的算数；规则集链接每 24 小时随内核启动更新，也可手动立即更新。
• 切换不重启内核：站点集在直连和代理之间切换时只改写一份很小的开关规则集，已建立的连接不断，新连接和 DNS 在 1 秒内按新线路走。
• 链式代理：给住宅 / 静态 IP 这类出口（socks5 / http / https）指定前置节点或节点组，建好后作为普通节点使用。
• DNS 接管：支持接管 dnsmasq 转发、防火墙劫持和禁用三种模式，国内域名与代理域名可以分别解析，并可用 DNS 重写把某个域名固定到指定 IP 或另一个域名。
• 入口旁路：后端设置里的「直连不进内核」开关（默认开），让走直连的流量在系统入口直接放行；另有直连应答放行、直连终端等机制减少无谓的内核转发。
• 终端分流与 IPv6：可给单个终端指定出站，能把内核入站开放给局域网其它设备作为代理使用。
• 其它：订阅分享（生成链接与二维码）、规则集导入预览、TUN 参数调整、屏蔽 QUIC 开关、配置导出 / 导入、按设备 / 节点 / 目标的每日流量统计，以及面板打不开时用的 LuCI 兜底页。

安装与使用

SSH 以 root 登录 OpenWrt 路由器后执行（同一份安装包与命令也适用于 Debian / Ubuntu，脚本会自行识别系统）：

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

GitHub 访问不畅时可让脚本使用镜像下载发布包：

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

安装过程中会询问面板端口（默认 3036，可用 --port 直接指定），结束后用浏览器打开脚本提示的 http://<路由器局域网 IP>:<面板端口>，首次访问时设置管理密码。完整安装包从 GitHub Releases 下载，按架构区分 x64 与 arm64，每个资产旁附有 SHA256 校验文件；客户端安装包同样在 Releases 中获取。

安装要求：OpenWrt 需 iStoreOS 24 / OpenWrt 24 以上，x86_64 或 aarch64，至少 512MB 存储空间和 512MB 内存；脚本会尝试用 opkg 或 apk 补齐系统依赖，软件源不通时只提示不中断。

作为旁路由使用时，旁路由的 LAN 区域要打开「IP 动态伪装」（MASQUERADE），否则直连站点回包不经旁路由，表现为只能上国外、打不开大陆网站。

Docker 旁路由的部署方式见仓库 docker/README.md；Debian / Ubuntu 上没有 LuCI 页面和 dnsmasq 分流模式，防火墙规则需要自己管理，排障可看 journalctl -u openbox -u openbox-panel。

注意事项

• Open-Box 自有程序为闭源专有软件，并非开源项目，未经许可禁止复制传播自有代码、再分发、反编译及绕过授权；第三方开源组件保留原许可。
• Debian / Ubuntu 上面板以 root 运行并使用 HTTP，密码保存在本机数据库，不要把面板端口暴露到公网；需要远程访问请走 VPN、SSH 隧道或带 TLS 的反向代理并限制来源地址。
• 规则集链接、订阅内容等由第三方提供，使用时请遵守所在地法律法规与服务条款。

本作品整理自 GitHub 开源项目 liandu2024/Open-Box，原作者 @liandu2024。中文介绍由 AI 根据项目 README 整理，以原仓库为准。