Android 系统级 sing-box 透明代理模块
eBPF / TUN · 节点与订阅 · 分应用代理 · 共享网络
下载模块与管理器 · 使用文档 · 管理器源码 · Telegram
中文 | English
NetProxy 是面向已 Root Android 设备的系统级透明代理模块，支持 Magisk、KernelSU 与 APatch。使用 sing-box，通过 eBPF 或 TUN + auto_redirect 接管流量。
日常操作可使用随模块提供的 Android 管理器，也可通过终端式模块 WebUI、CLI 或 sing-box Dashboard 管理。节点与订阅在服务停止时仍可浏览和编辑。
- 透明代理：eBPF 或 TUN 接管 TCP、UDP 与 DNS，支持热点和 USB 共享网络。
- 节点与订阅：导入节点链接、节点文本、Clash YAML 和 sing-box JSON；支持订阅筛选、请求头、流量信息与自动更新。
- 节点选择与测速：手动选择或自动优选，服务停止时也可测速。
- 分应用代理：黑名单 / 白名单，按 Android 用户分别配置，支持应用分身。
- 网络策略：规则、全局、直连与允许广告模式，按 Wi-Fi 名称和实际出口自动切换。
- 配置与诊断：编辑 sing-box 配置、本地规则，查看运行时配置与日志，导出脱敏诊断包。
运行环境为 arm64-v8a Android 设备与 Magisk、KernelSU 或 APatch，使用 Root 权限接管流量。
默认使用 eBPF，可在“设置 → 入站设置”中选择 TUN。设备能力要求与安装选项见安装与升级。
- 从 Releases 下载
NetProxy_<版本>_<构建号>.zip，内含模块和 Android 管理器。 - 在 Root 管理器中刷入，按提示选择数据保留方式及是否安装管理器；等待安装完成。
- 打开 Android 管理器并授予 Root 权限，在“节点”页导入节点，或在“订阅”页添加订阅。
- 在“节点”页选择分组与自动 / 手动节点，返回“仪表盘”开启服务。
服务默认手动启动，开机自启可在“设置”中开启。首次配置参阅快速开始。
| 内容 | 文档 |
|---|---|
| 安装与首次配置 | 安装与升级 · 快速开始 |
| 节点、订阅与测速 | 节点与订阅 |
| 入站、分应用与共享网络 | 入站配置 · eBPF · TUN |
| 网络自动切换 | Wi-Fi 自动策略 |
| 路由、DNS 与策略组 | 配置参考 · 策略分组 |
| 终端、面板与第三方客户端 | CLI · 控制面板与 API |
| 故障排查与问题反馈 | 常见问题与诊断 |
奶屁龙，通路工坊的开路员。爱挖洞，也爱打盹，偶尔会把出口挖到饼干柜里。
奶屁娘，通路工坊的主人。讲究、有点傲娇，嘴上问着“日志呢？”，手里已经递来一杯热饮。
src/module/ 模块安装与运行文件
src/native/netproxy/ Go 原生组件
src/webui/ 终端式模块 WebUI
src/android/ Android 管理器
docs/ 用户文档站
tests/ 契约与回归测试
开发流程与验证方法见贡献指南，架构和跨组件契约见 AGENTS.md，管理器构建见 Android 说明。
| 项目 | 用途 |
|---|---|
| reF1nd/sing-box | 当前代理核心 |
| SagerNet/sing-box | 上游 sing-box 项目 |
| Proxylink | NetProxy 内部节点转换能力的原始项目 |
| AsteriskNG | Android eBPF 实现参考 |
| v2rayNG | 节点解析实现参考 |
同时感谢曾为早期版本提供核心能力或实现参考的 CHIZI-0618/sing-box、Xray-core、AndroidTProxyShell、IPSET_LKM 与 KsuWebUIStandalone。