Modules / netproxy

NetProxy

基于 Xray 内核的透明代理模块

README

NetProxy Logo

NetProxy

Android 系统级 Xray 透明代理模块
支持 TPROXY、UDP、IPv6、分应用代理、订阅管理

Latest Release Downloads Xray Core

中文 | English


✨ 功能特性

功能 描述
WebUI 管理 Material Design 3 现代化界面,支持莫奈取色
透明代理 支持 TPROXY / REDIRECT 两种模式,TCP + UDP 全接管
分应用代理 黑名单 / 白名单模式,精准控制代理范围
路由设置 自定义域名、IP、端口等路由规则
DNS 设置 自定义 DNS 服务器和静态 Hosts 映射
订阅管理 在线添加、更新订阅,自动解析节点
热点共享 支持代理 WiFi 热点和 USB 共享的流量
热切换配置 无需重启即可切换节点

🖼️ 界面预览

状态页面 节点管理 应用控制 设置页面

📥 安装

  1. Releases 下载最新版 ZIP
  2. Magisk / KernelSU / APatch 中刷入模块
  3. 重启设备
  4. 打开模块管理器的 WebUI 进行配置

📁 目录结构

/data/adb/modules/netproxy/
├── bin/                      # Xray 二进制文件
├── config/
│   ├── xray/
│   │   ├── confdir/          # Xray 核心配置
│   │   │   ├── 00_log.json
│   │   │   ├── 01_inbounds.json
│   │   │   ├── 02_dns.json
│   │   │   ├── 03_routing.json
│   │   │   └── ...
│   │   └── outbounds/        # 出站节点配置(含订阅分组)
│   ├── module.conf           # 模块设置(开机自启等)
│   ├── tproxy.conf           # 代理模式配置
│   └── routing_rules.json    # 自定义路由规则
├── logs/                     # 运行日志
├── scripts/                  # 启动、停止、订阅等脚本
├── webroot/                  # WebUI 静态资源
└── service.sh                # 模块启动入口

🚀 快速开始

方式一:节点链接导入(推荐)

在 WebUI 配置页面点击 添加 → 添加节点,直接粘贴节点链接:

vless://... 或 vmess://... 或 trojan://... 等

方式二:订阅导入

点击 添加 → 添加订阅,输入订阅名称和地址,自动解析全部节点。

方式三:手动配置

outbounds 目录创建 JSON 配置文件,格式示例:

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

📢 交流群组

Telegram Group


🤝 贡献

欢迎参与项目!

  • 提交 Issue 反馈 BUG
  • 提出功能建议
  • 提交 Pull Request
  • Star 支持项目!

🙏 鸣谢

本项目的开发离不开以下优秀的开源项目:

项目 说明
Xray-core 核心代理引擎,支持 VLESS、XTLS、REALITY 等先进协议
v2rayNG 节点链接解析逻辑参考
AndroidTProxyShell Android TProxy 透明代理实现参考
KsuWebUIStandalone WebUI 独立运行方案参考
Proxylink 代理链接解析器,用于订阅解析和配置生成

📜 许可证

GPL-3.0 License

Release History

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
293
Stars
8
Releases

Latest Version

v4.0.6
Released 1/11/2026
Download Now