NetProxy

Android 系统级 sing-box 透明代理模块
支持 TPROXY / REDIRECT、TCP / UDP、分应用代理、节点订阅与 Clash API

下载模块 · 使用文档 · Android 管理器 · Telegram

中文 | English

---

项目简介

NetProxy 是面向已 Root Android 设备的系统级透明代理模块。模块以内置 sing-box 为代理核心，通过 TPROXY 或 REDIRECT 接管系统流量，并提供 Android 管理器、CLI 与 zashboard 三种管理入口。

支持 Magisk、KernelSU 与 APatch。节点、订阅、路由、DNS 和透明代理配置均保存在模块目录中，不依赖 VPN 模式运行。

管理入口

入口	适合场景
Android 管理器	日常使用，管理服务、节点、订阅、分应用代理、配置与日志
CLI	终端操作、自动化和故障排查
Clash API + zashboard	查看代理组、连接与延迟，进行运行时控制

Clash API 默认配置：

• Controller：http://<设备IP>:9999
• zashboard：http://<设备IP>:9999/ui/
• Secret：singbox

控制器默认监听所有网络接口，请仅在可信网络中使用，并按需修改访问密钥。

界面预览

核心能力

• TPROXY 优先，内核不支持时自动回退到 REDIRECT
• 透明代理 TCP、UDP 与 DNS 流量
• 分应用黑名单 / 白名单、热点和 USB 共享代理
• 单节点链接、节点文件、Clash YAML 与订阅导入
• 手动节点选择与 URLTest 自动测速
• Rule、Global、Direct 出站模式
• 按 WiFi SSID 在基础模式与 Direct 之间自动切换
• Clash API、zashboard、连接管理与节点测速
• 订阅定时更新、QUIC 阻断和中国 IP 绕过
• 集成 IPSET LKM，增强部分设备的内核兼容性

安装

Release 页面提供以下两个版本：

版本	文件名	包含内容	适用设备
完整版	NetProxy_<版本>_<构建号>.zip	包含 sing-box、Proxylink、zashboard、Android 管理器，以及集成的 IPSET LKM 驱动和 ipset 工具	默认推荐；适合大多数设备，尤其是不确定内核 IPSET 支持情况时
Lite 包	NetProxy_<版本>_<构建号>_lite.zip	不包含 bin/IPSET-LKM，其余核心、管理与代理功能和完整版一致	适合系统已提供可用 IPSET 内核支持与 ipset 工具，或不需要 IPSET 扩展功能的设备

如果不确定该选哪个版本，请下载完整版。Lite 包不是无核心版本，仍然内置 sing-box、Proxylink 和 zashboard；它只移除了集成的 IPSET 驱动与工具。

1. 从 Releases 下载最新模块 ZIP。
2. 在 Magisk、KernelSU 或 APatch 中刷入模块。
3. 按安装提示选择内置管理器或 Google Play 版本，然后重启设备。
4. 导入并选择节点，再通过管理器或 CLI 启动服务。

模块默认 AUTO_START=0。确认节点与配置可用后，可在管理器中启用开机启动，或将 config/module.conf 中的 AUTO_START 改为 1。

快速开始

以下命令均需要 Root 权限。

# 查看服务状态
su -c '/data/adb/modules/netproxy/scripts/cli service status'

# 导入单个节点链接
su -c '/data/adb/modules/netproxy/scripts/cli node add "vless://..."'

# 导入节点文本或 Clash YAML
su -c '/data/adb/modules/netproxy/scripts/cli node import /sdcard/clash.yaml'

# 查看并选择节点
su -c '/data/adb/modules/netproxy/scripts/cli node list'
su -c '/data/adb/modules/netproxy/scripts/cli node use 节点名称'

# 启动服务
su -c '/data/adb/modules/netproxy/scripts/cli service start'

# 查看或切换出站模式
su -c '/data/adb/modules/netproxy/scripts/cli mode'
su -c '/data/adb/modules/netproxy/scripts/cli mode rule'

# 查看 zashboard 地址
su -c '/data/adb/modules/netproxy/scripts/cli api ui'

添加订阅：

su -c '/data/adb/modules/netproxy/scripts/cli sub add 我的订阅 https://example.com/sub'
su -c '/data/adb/modules/netproxy/scripts/cli sub update 我的订阅'
su -c '/data/adb/modules/netproxy/scripts/cli sub auto on'

节点配置格式

推荐使用 Android 管理器或 CLI 导入节点。Proxylink 会把单链接、节点文件、Clash YAML 和订阅转换为模块需要的 sing-box 配置片段。

手写节点文件

手写节点文件必须是一个完整的 sing-box 配置片段，顶层使用 outbounds 数组。不能直接把单个 outbound 对象作为文件根节点。

下面是 SOCKS5 节点示例：

{
  "outbounds": [
    {
      "type": "socks",
      "tag": "fr-socks",
      "server": "proxy.example.com",
      "server_port": 1080,
      "version": "5",
      "username": "user",
      "password": "password"
    }
  ]
}

将节点文件放在：

/data/adb/modules/netproxy/config/singbox/outbounds/default/fr-socks.json

然后执行：

su -c '/data/adb/modules/netproxy/scripts/cli node list'
su -c '/data/adb/modules/netproxy/scripts/cli node use fr-socks'

注意事项：

• sing-box 出站协议字段是 type，不是 Xray 配置中的 protocol。
• 建议每个文件只放一个普通节点，并保证 tag 在当前目录中唯一。
• 不要使用 direct、block、Proxy 或 Auto-Fastest 作为节点标签。
• 当前节点目录中的 JSON 文件会共同参与启动；格式错误的文件可能导致核心无法加载。
• 协议字段请以 sing-box Outbound 文档 为准。

CLI 命令

cli service {status|start|stop|restart|logs|logs-clear}
cli node {list|current|use|add|import|export|show|remove|delay}
cli mode [rule|global|direct]
cli sub {list|add|update|update-all|remove|auto}
cli api {groups|conns|close|close-all|ui}
cli app {list|mode|add|remove|enable|disable}
cli tproxy {status|reload|quic|cnip}
cli wifi {status|on|off|mode|add|del|list|clear|cellular}

查看完整中文帮助：

su -c '/data/adb/modules/netproxy/scripts/cli help'

配置与日志

路径	用途
config/module.conf	开机启动、出站模式、当前节点、选择模式和订阅调度
config/tproxy/tproxy.conf	监听端口、透明代理、分应用、QUIC、CN IP 与 WiFi 自动切换
config/singbox/confdir/	通用 sing-box 配置，包括 DNS、路由和 Clash API
config/singbox/outbounds/	默认节点与订阅节点目录
config/singbox/source/	本地路由规则与规则集
logs/service.log	模块服务与透明代理日志
logs/sing-box.log	sing-box 核心日志
logs/subscription.log	节点和订阅转换日志

常用默认值：

配置项	默认值	说明
AUTO_START	0	默认不随开机启动
OUTBOUND_MODE	rule	规则分流
SELECTOR_MODE	urltest	自动测速选择
CURRENT_CONFIG	空	需要先导入并选择节点
PROXY_TCP_PORT	1536	TCP 透明代理端口
PROXY_UDP_PORT	1536	UDP 透明代理端口
DNS_PORT	1536	DNS 劫持目标端口
PROXY_MODE	0	自动检测 TPROXY，失败时回退 REDIRECT
BLOCK_QUIC	1	默认阻断 QUIC
BYPASS_CN_IP	0	默认不启用中国 IP 绕过
WIFI_AUTO_SWITCH	0	默认关闭 WiFi SSID 自动切换
LOG_TIMESTAMP	0	默认关闭 tproxy 日志时间戳

排障

# 服务与核心日志
su -c '/data/adb/modules/netproxy/scripts/cli service logs service 100'
su -c '/data/adb/modules/netproxy/scripts/cli service logs core 100'

# 节点和订阅转换日志
su -c '/data/adb/modules/netproxy/scripts/cli service logs sub 100'

启动失败时优先检查 sing-box.log。手写节点无法加载时，重点检查顶层是否为 outbounds、协议字段是否为 type、JSON 语法是否正确，以及节点标签是否冲突。

更完整的安装、配置和排障说明请访问 NetProxy 文档。

鸣谢

项目	用途
reF1nd/sing-box	当前代理核心
SagerNet/sing-box	上游 sing-box 项目
Proxylink	节点、订阅与配置转换
AndroidTProxyShell	Android 透明代理实现参考
IPSET_LKM	IPSET 内核模块与兼容性支持
zashboard	Clash API 控制面板
v2rayNG	节点解析实现参考

交流与贡献

• Telegram 群组
• 提交 Issue
• 提交 Pull Request

许可证

GPL-3.0 License

Star