Modules / netproxy

NetProxy

基于 sing-box 内核的 Android 透明代理模块。 / sing-box based transparent proxy module for Android.

README

NetProxy Logo

NetProxy

Android System-Level Xray Transparent Proxy Module
Supports TPROXY, UDP, IPv6, Per-App Proxy, Subscription Management

Latest Release Downloads Xray Core

中文 | English


Features

Feature Description
WebUI Management Material Design 3 modern interface with Monet theming support
Transparent Proxy Supports TPROXY / REDIRECT modes, full TCP + UDP interception
Per-App Proxy Blacklist / Whitelist mode for precise proxy control
Routing Rules Custom domain, IP, port and other routing rules
DNS Settings Custom DNS servers and static Hosts mapping
Subscription Add and update subscriptions online, auto-parse nodes
Hotspot Sharing Proxy WiFi hotspot and USB tethering traffic
Hot Switch Switch nodes without restarting the service

Screenshots

Status Page Node Management App Control Settings

Installation

  1. Download the latest ZIP from Releases
  2. Flash the module in Magisk / KernelSU / APatch
  3. Reboot your device
  4. Open the WebUI from your module manager to configure

Directory Structure

/data/adb/modules/netproxy/
├── bin/                      # Xray binary
├── config/
│   ├── xray/
│   │   ├── confdir/          # Xray core configuration
│   │   │   ├── routing/      # Routing & Shunting configuration
│   │   │   │   ├── internal/ # Internal system configuration
│   │   │   │   ├── direct.json
│   │   │   │   ├── global.json
│   │   │   │   ├── rule.json
│   │   │   │   └── routing_rules.json
│   │   │   ├── 00_log.json
│   │   │   ├── 01_api.json
│   │   │   ├── 02_dns.json
│   │   │   ├── 03_inbounds.json
│   │   │   ├── 04_outbounds.json
│   │   │   └── 05_policy.json
│   │   └── outbounds/        # Outbound node group directories
│   │       ├── default/      # Default node group
│   │       └── sub_xxx/      # Subscription group directories
│   ├── tproxy/
│   │   └── tproxy.conf       # Transparent proxy configuration
│   └── module.conf           # Module settings (autostart, etc.)
├── logs/                     # Runtime logs
├── scripts/                  # Start, stop, subscription scripts
├── webroot/                  # WebUI static resources
└── service.sh                # Module entry point

Quick Start

Method 1: Import Node Link (Recommended)

In the WebUI Config page, click Add → Add Node and paste your node link:

vless://... or vmess://... or trojan://... etc.

Method 2: Import Subscription

Click Add → Add Subscription, enter the subscription name and URL to auto-parse all nodes.

Method 3: Manual Configuration

Create a JSON config file in the outbounds/default directory:

{
  "outbounds": [
    {
      "tag": "proxy",
      "protocol": "vless",
      "settings": { ... }
    }
  ]
}

Community

Telegram Group


Contributing

Contributions are welcome!

  • Submit Issues to report bugs
  • Suggest new features
  • Submit Pull Requests
  • Star the project to show support!

Acknowledgments

This project is built upon the following excellent open-source projects:

Project Description
Xray-core Core proxy engine with VLESS, XTLS, REALITY protocols
v2rayNG Node link parsing logic reference
AndroidTProxyShell Android TProxy implementation reference
KsuWebUIStandalone WebUI standalone solution reference
Proxylink Proxy link parser for subscription parsing and config generation

License

GPL-3.0 License

Star

Star History Chart

Stone Badge

Release History

v6.0.1

Published on April 11, 2026
Download

版本 6.0.1(2026-04-11)

核心更新

修复了一些已知问题


v6.0.0

Published on February 27, 2026
Download

版本 6.0.0(2026-02-27)

核心更新

  • 全新原生管理界面: 采用 Miuix 设计语言重构,带来更精致的视觉体验、更流畅的操作反馈以及显著的性能提升。详见 Telegram 公告

主要变更

Important

由于涉及大量文件结构变更,建议先完全卸载旧版本模块后再进行重新安装。

  1. 模式切换逻辑重构:
    • 废弃 WebUI 实时生成路由的逻辑,改为使用预设的静态配置文件(rule.json, global.json, direct.json)。
    • 彻底解决重启后无法自动恢复“全局/直连”模式的历史遗留问题。
  2. 直连模式配置保护:
    • 将直连模式依赖的 freedom 出站配置从 outbounds/ 移至内部受保护路径 confdir/routing/internal/proxy_freedom.json
    • 优化 switch-mode.sh,确保即使出站节点被清空,直连模式依然稳固可用。
  3. 配置目录结构优化:
    • 路由规则统一化: 新增 confdir/routing/ 文件夹,集中管理所有路由 JSON 及 routing_rules.json 规则库。
    • TProxy 配置独立: tproxy.conf 移入 config/tproxy/ 文件夹,结构更清晰。
    • 文件排序优化: 重新排列 confdir 下的文件前缀,提升系统加载逻辑的可读性。
  4. 默认分组重构:
    • 将原 outbounds/ 根目录下的节点配置迁移至 outbounds/default/ 子目录。
    • 自动同步更新 module.conf 中的 CURRENT_CONFIG 路径。

v5.0.1

Published on February 20, 2026
Download

版本 5.0.1(2026-02-20)

新功能与优化

  • 兼容模式:新增 兼容模式(兼容旧版设备环境),修复在部分设备上的代理转发异常
  • 环境兼容增强
    • 透明代理 (tproxy.sh) 移除对 curl 的硬依赖,新增基于 busybox wget 的自动下载回退机制
    • 模块内置 ipset 二进制文件,移除系统环境依赖,原生适配 Magisk/KernelSU 安装运行环境
  • 模块控制面板:Action.sh新增详细的界面状态输出与日志回显
  • ProxyLink 升级:更新 ProxyLink 的编译环境依赖至最新的 Go 1.26.0

问题修复与精简

  • 修复部分场景下启动 WebUI 代理服务异常的问题
  • 移除遗留的“延迟刷新”等无用冗余代码

v5.0.0

Published on February 19, 2026
Download

版本 5.0.0(2026-02-19)

新功能

  • 支持 Hysteria2 协议(hysteria2:// 链接导入与配置转换)
  • 状态页面添加国旗 emoji 显示 IP 所属地区
  • KernelSU 快捷方式

网络与代理

  • tproxy.sh 升级至 v26.02.18
  • 秋风广告规则改为使用 geo 文件
  • WebUI 支持配置更多 tproxy 参数

其他

  • 更新 Xray 内核至 v26.2.4
  • 不再默认安装 netproxy.apk
  • 删除单独的 TProxy 日志页面
  • 依赖更新:Vite 8.0.0-beta.14、KernelSU 3.0.2、Gradle 9.3.1 等

v4.0.6

Published on January 11, 2026
Download

版本 4.0.6(2026-01-11)

配置页与延迟检测

  • 新增延迟结果缓存机制,统一管理延迟数据
  • 优化延迟显示逻辑,排序与清理性能提升

网络与代理

  • 阻止本地访问 TProxy 端口,防止流量回环
  • 优化外网 IP 获取

订阅与规则

  • 订阅 User-Agent 调整为 Clash
  • 更新内置规则

其他

  • 优化并清理部分代码实现

v4.0.5

Published on January 6, 2026
Download

此版本有较多配置文件调整,建议卸载重装,或者手动处理module,routing_rules,01_inbounds,02_dns,03_routing

版本4.0.5(2026-01-06)

🧩 WebUI 与前端结构调整

  • 全新的状态页设计(参考 flclash)
  • 重构 WebUI 服务层,按领域拆分为模块化结构
  • 移除新年特效相关代码
  • 调整顶部标题显示位置,移除顶部主题切换功能
  • 原“配置页”更名为“节点”,并更换图标
  • uid-page.js 重命名为 app-page.js
  • i18n-service.js 移入 src/i18n/
  • monet.css 移入 styles/ 目录,移除 style.css
  • 删除 status-card.css

核心脚本与服务体系

  • 使用统一的 service.sh 替代旧的 start.sh / stop.sh

  • 合并启动与停止逻辑,支持:

    • start / stop / restart / status
    • status 显示 PID 与运行时间
  • ksu-service.js 统一调用新 service.sh

  • 服务日志同时输出到文件与 stderr

  • 修复 log() 输出到 stdout 导致命令替换捕获日志的问题


网络、代理与规则能力

  • 实现 出站模式切换
  • 优化 TProxy 脚本性能,减少外部进程调用
  • 内置 秋风广告规则 v1.6.9
  • 修改部分配置文件,尝试修复 DNS / 订阅相关问题

安装与设备兼容性

  • 全新的安装脚本
  • 优化 OnePlus A16 修复脚本与服务启动逻辑

v4.0.3

Published on January 3, 2026
Download

🚀 版本 4.0.3(2025-12-30)

🔧 稳定性与修复

  • 修复 WebUI 下拉菜单文字对齐与选中状态显示问题
  • 修复应用列表添加 / 删除后不刷新的问题
  • 修复节点导入、删除后列表状态不同步的问题
  • 修复运行中修改 TProxy 配置后停止服务清理不完整的问题(如 IPv6 规则残留)

⚡ WebUI 性能与交互优化

  • 服务启停改为非阻塞执行

    • 启停操作立即响应,UI 不再卡顿
    • 增加状态轮询与超时提示
  • 延迟检测改用 spawn API

    • 测速过程不阻塞 UI
    • 增加超时保护,提升稳定性
  • 优化 Toast 显示位置,不再遮挡底部导航栏


🎨 主题系统与视觉优化

  • 重构主题颜色管理逻辑
  • 新增 Material 3 风格主题支持
  • 支持浅色 / 深色模式下的手动主题色
  • 优化自动模式与莫奈取色的颜色应用逻辑
  • 调整主题切换按钮布局,统一视觉风格

🌐 节点与订阅系统升级

  • 引入 Proxylink 作为统一节点解析与订阅转换引擎
  • 节点解析与订阅处理更加稳定、规范
  • CLI、WebUI、订阅脚本统一解析逻辑
  • 移除旧版 URL2JSON 与 WebUI X 相关代码

🧹 其他优化

  • 统一应用信息获取逻辑,提升首次加载成功率
  • 优化内核更新提示行为
  • 精简冗余代码,提升整体可维护性

v4.0.2.0

Published on January 2, 2026
Download

🎉 4.0.2 元旦特别版(2025-12-30)

feat(webui):2026 元旦特效 🎊
1 月 1–3 日生效:灯笼、飘雪、烟花;点击首个灯笼可关闭,关闭后本年度不再显示。


DNS 与路由系统

  • 新增 DNS 配置能力

    • 支持自定义 DNS 服务器
    • 支持静态 Hosts 配置
  • 修复 DNS 规则不生效的问题

  • 新增 DNS 劫持路由

  • 调整路由与策略参数

    • policy.levels 默认值改为 0
    • 优化部分路由与代理相关参数
  • 出站结构调整

    • confdir 新增出站文件:Direct / Block / DNS-Out
    • 删除默认配置中的 DirectBlock 出站
    • URL2JSON 节点转换中移除 DirectBlock 相关内容

核心性能与状态检测

  • 优化 Xray 运行状态与运行时统计

    • 使用 /proc 获取 Xray 运行时间
    • 替代 ps / grep 实现,提升 Android 兼容性
    • 显著减少 fork 次数,降低 CPU 与 IO 开销
  • 内存使用统计优化

    • 改为读取 /proc/<pid>/status 中的 VmRSS
  • 网络速率统计优化

    • 移除 1 秒阻塞延迟
    • 使用服务端差值计算
    • 首页加载时间提升约 1 秒

配置页性能与结构重构

  • 配置页加载性能大幅提升

    • Shell 层一次性获取配置目录结构
    • 批量读取配置信息,减少重复调用
    • 数据缓存避免重复加载
  • 渐进式与懒加载

    • 分组展开才加载数据
    • 节点列表支持滚动懒加载(IntersectionObserver)
    • 按块加载,避免重复请求
  • 配置页布局重构

    • 改为横向标签页(mdui-tabs
    • 标签栏支持横向滚动
    • 订阅分组操作按钮移入标签页面板
    • Tabs 适配 Monet 取色方案

WebUI 交互与体验优化

  • 页面切换体验优化

    • 所有页面统一延迟 200ms 切换
    • 等待导航动画完成后再更新页面内容
  • 应用代理页面重构

    • 支持多用户
    • 支持显示系统应用
    • 支持关闭分应用代理设置
  • 节点管理能力增强

    • 新增节点批量操作工具栏
    • 支持全部测试 / 按延迟排序 / 清理无效节点
    • 支持并行延迟测试并缓存结果
  • 清理调试输出

    • 删除 62 处 console.log

应用与系统信息获取优化

  • 移除 WebUI X 相关兼容代码

    • 统一使用 KernelSU API 获取应用信息
    • 应用图标统一使用 ksu://icon/<packageName>
  • 应用信息获取稳定性增强

    • 内置重试机制(最多 10 次)
    • 修复首次加载应用信息失败的问题
  • 用户空间显示优化

    • 显示格式调整为:应用名 [用户 999]
    • 描述栏仅显示包名

订阅与节点解析修复

  • 修复订阅解析失败问题

    • 添加浏览器 User-Agent,绕过 Cloudflare 简单检测
    • 新增订阅调试日志 logs/subscription.log
  • 节点解析能力增强

    • xhttp 传输类型支持 TLS
    • 支持自定义 headers 与 xmux 参数
  • 修复订阅更新与删除参数错误的问题


样式与文案优化

  • 导航与文案调整

    • 配置 → 节点
    • 代理 → 应用
    • 更新节点页标题与空状态提示
  • 节点列表布局优化

    • 移除多余左侧 padding
    • 优化节点名称对齐方式,符合 Material Design
  • 选择器样式优化

    • 使用 Monet 终极配色方案
    • 统一主色 / 自定义色 / 表面容器色
    • 修复 CSS 注释格式问题

v4.0.0

Published on December 30, 2025
Download

版本 4.0.0(2025-12-30)


⚠️ 重要提示

本版本 config 目录结构进行了调整,在 config 目录下 新增了 4 个配置文件
由于当前安装脚本 不会自动安装这 4 个新增文件,如果你是从旧版本升级:

  • 现有配置不会被覆盖
  • 但会 缺少新增的配置文件,可能导致部分功能异常

解决方式:

  • 推荐方式:卸载旧版本后重新安装 4.0.0,以确保配置文件完整
  • 手动方式:从发布的压缩包中,将新增的配置文件复制到模块目录下的 config 目录中

NetProxy 核心功能与架构(by @Fanju6

  • 入站端口逻辑调整

    • 不再从 nbounds 配置文件获取
    • 统一使用默认端口 12345
  • NetProxy 专属 WebUI 管理器

    • 可直接打开模块 WebUI
    • 磁贴支持开启 / 关闭 / 重启,并显示运行状态
  • 全新透明代理实现

    • 提升整体性能与稳定性
  • 应用代理模式重构

    • 黑名单与白名单彻底拆分
    • 不再共用同一应用列表
  • 代理能力增强

    • 支持移动数据、WiFi 热点、USB 网络共享
    • 支持 TCP / UDP / IPv6 代理开关
  • 路由与规则能力增强

    • 新增路由规则设置功能
  • 主题与外观配置

    • 新增主题与颜色设置
    • 支持 12 种主题色
  • 配置与日志系统改进

    • 统一 config/ 目录下配置文件格式为 .conf
    • 日志页新增 tproxy.logupdate.log 显示
    • 日志页支持保存日志与配置文件
  • Xray 运行方式调整

    • 使用 root:net_admin 用户启动
  • 脚本体系重构

    scripts/
    ├── cli                      # 命令行工具(主入口)
    ├── core/                    # 核心服务脚本
    │   ├── start.sh
    │   ├── stop.sh
    │   └── switch-config.sh
    ├── network/                 # 网络 / 代理相关
    │   └── tproxy.sh
    │   
    ├── config/                  # 配置解析
    │   ├── url2json.sh
    │   └── subscription.sh
    └── utils/                   # 工具脚本
        ├── update-xray.sh
        └── clean_reject.sh
    
  • 设备与启动相关改进

    • 重命名 oneplus_a16 修复脚本
    • 将修复脚本改为开关控制
    • 支持模块开机自启动
  • 配置与节点 UI 优化

    • 节点信息左边距缩小
    • 延迟检测结果显示在节点信息内
    • 支持显示当前正在使用的节点
    • 优化配置页整体布局
  • 协议解析修复

    • 修复 Trojan 节点解析问题

WebUI(by @Seyud

  • WebUI 样式体系重构

    • mdui.css 由本地文件改为通过 npm 引入
    • 移除本地 assets/mdui.css
    • 调整 index.html 中 CSS 加载顺序并添加说明
  • 下拉菜单交互修复

    • 增加 OpenDropdown 状态管理
    • 确保同一时间仅打开一个下拉菜单
  • UI 交互与可用性优化

    • 重构确认对话框结构,宽度限制为 400px
    • 扩大配置项“更多”按钮点击区域
  • 应用列表显示优化

    • 包名支持自动换行,避免长包名溢出
    • 优化列表布局与图标间距
  • 应用选择器修复与样式优化

    • 修复复选框点击触发两次状态切换的问题
    • 列表标题与描述支持换行
    • 复选框样式适配 Monet 主题颜色

CLI 命令行工具(by @hexl

  • 新增 NetProxy CLI 管理脚本 scripts/cli

  • 支持通过 adb shell 管理 NetProxy:

    • 服务控制:status / start / stop / restart
    • 配置管理:list / switch / current / add / remove / show
    • 订阅管理:list / add / update / update-all / remove
    • 代理设置:mode / apps / add / remove / reload

v3.0.1

Published on December 28, 2025
Download

版本 3.0.1 (2025-12-28)

更新 / 修复

WebUI(by @Seyud

  • 命令执行修复:修复文件路径包含空格时命令执行失败的问题,读取和保存配置文件时为路径添加单引号处理。

  • 样式系统重构:在不改变原有功能的前提下,将样式重构为模块化架构。

    • 新增 styles/ 目录统一管理样式
    • 拆分为 base.csscomponents/*.cssutilities.css
    • 使用 style.css 作为统一入口文件
  • 样式问题修复与优化

    • 修复菜单项文字截断问题
    • 为分段按钮组添加样式覆盖,优化选中态、悬停效果和图标颜色,适配 Monet 取色体系
  • UI 交互与性能优化

    • 重构应用图标懒加载逻辑,统一 KSU API 与 WebUI X 的图标加载方式
    • 修复配置列表选中状态与交互异常,禁用不必要的 ripple 和 state-layer 效果
    • 优化骨架屏逻辑,支持无图标配置列表样式
    • 使用文档片段优化配置列表渲染性能
    • 移除配置页面骨架屏,简化加载流程

其他

  • 路由修复与优化:修复路由失效问题,并简化 Xray API 配置。

v3.0.0

Published on December 27, 2025
Download

版本 3.0.0 (2025-12-27)

新增 / 改进

WebUI 优化(by @Seyud

  • 优化导航栏动画
  • 自动模式适配莫奈取色
  • 白名单应用删除即时生效,支持系统应用白名单
  • 调整延迟分类阈值,改善状态页面显示

代理与网络

  • 使用 TPROXY,支持 UDP 与 IPv6

配置与管理

  • 分离配置文件,实现模块化管理(入站 / 出站 / DNS 等分开)
  • 新的代理模式界面,支持黑名单 / 白名单模式
  • 新配置页面:显示协议、地址、端口,支持编辑配置文件及延迟测试
  • 支持热切换配置文件

订阅功能

  • 新增订阅功能,支持节点在线更新与管理

修复

  • 修复 VLESS 配置中 users 数组缺少 flow 字段的问题

⚠️ 重要提示

本版本对配置文件结构进行了调整,模块化分离了配置文件。
模块目录下的 /config/xray/ 中新增了两个文件夹:

  • confdir:存放默认规则配置
  • outbounds:存放节点的出站配置

如果你是从旧版本升级,可能会缺少新增的文件。
建议操作方式:

  1. 推荐方式:卸载旧版后重新安装,以确保配置完整。
  2. 备用方式:手动从压缩包中将缺失文件复制到模块目录。

v2.0.2

Published on December 23, 2025
Download

版本 2.0.2 (2025-12-23)

WebUI 改进(by @Seyud

  • 资源本地化构建:样式与字体改为本地构建,优化初始化加载速度,修复部分样式异常。
  • 构建优化:关闭 source maps,减少体积并提升加载效率。
  • 主题体验:修复主题切换闪屏问题。
  • 架构重构:单体 app.js 重构为模块化架构,提升可维护性。
  • 清理冗余:移除未使用的 app-selector.html 文件。
  • 边到边布局适配:支持动态系统 insets,优化悬浮按钮位置。
  • 应用列表优化:引入 webuix,支持应用图标懒加载与缓存,优化骨架屏显示,增强列表兼容性,支持滚动懒加载。

修复

  • 修复 SS 节点导入
  • 修复 VLESS + Reality 节点导入
  • 修复节点导入中文解析问题

Module Details

Module ID
netproxy
Authors
697
Stars
12
Releases

Latest Version

v6.0.1
Released 4/11/2026
Download Now