{"id":35077078,"url":"https://github.com/fanju6/netproxy-magisk","last_synced_at":"2026-06-27T06:00:58.142Z","repository":{"id":292613153,"uuid":"981411467","full_name":"Fanju6/NetProxy-Magisk","owner":"Fanju6","description":"Based on the sing-box core, this Android proxy module supports one-click start/stop of transparent proxy and is designed for Android devices.","archived":false,"fork":false,"pushed_at":"2026-06-18T21:39:22.000Z","size":367327,"stargazers_count":986,"open_issues_count":14,"forks_count":54,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-06-18T23:20:38.085Z","etag":null,"topics":["kernelsu-module","magisk-module","tproxy"],"latest_commit_sha":null,"homepage":"https://t.me/NetProxy_Magisk","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Fanju6.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-11T03:32:49.000Z","updated_at":"2026-06-18T21:39:26.000Z","dependencies_parsed_at":"2025-05-11T05:27:47.295Z","dependency_job_id":"85aef979-0368-4a48-b251-c493927ff758","html_url":"https://github.com/Fanju6/NetProxy-Magisk","commit_stats":null,"previous_names":["fanju6/netproxy-magisk"],"tags_count":27,"template":false,"template_full_name":null,"purl":"pkg:github/Fanju6/NetProxy-Magisk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fanju6%2FNetProxy-Magisk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fanju6%2FNetProxy-Magisk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fanju6%2FNetProxy-Magisk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fanju6%2FNetProxy-Magisk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Fanju6","download_url":"https://codeload.github.com/Fanju6/NetProxy-Magisk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fanju6%2FNetProxy-Magisk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34843147,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-27T02:00:06.362Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["kernelsu-module","magisk-module","tproxy"],"created_at":"2025-12-27T12:16:19.084Z","updated_at":"2026-06-27T06:00:58.135Z","avatar_url":"https://github.com/Fanju6.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/public/N.svg\" alt=\"NetProxy Logo\" width=\"120\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eNetProxy\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eAndroid System-Level sing-box Transparent Proxy Module\u003c/strong\u003e\u003cbr\u003e\n  Supports Android Manager, TPROXY / REDIRECT, TCP / UDP, Clash API, zashboard, per-app proxy, and subscription management\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/Fanju6/NetProxy-Magisk/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/release/Fanju6/NetProxy-Magisk?style=flat-square\u0026label=Release\u0026color=blue\" alt=\"Latest Release\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/Fanju6/NetProxy-Magisk/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/downloads/Fanju6/NetProxy-Magisk/total?style=flat-square\u0026color=green\" alt=\"Downloads\" /\u003e\n  \u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/sing--box-Core-blueviolet?style=flat-square\" alt=\"sing-box Core\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"README_ZH.md\"\u003e中文\u003c/a\u003e | English\n\u003c/p\u003e\n\n---\n\n## Features\n\n| Feature | Description |\n|------|------|\n| **Android Manager** | Native Android app with a modern interface for module management |\n| **Clash API / zashboard** | Clash API enabled by default with built-in zashboard |\n| **Transparent Proxy** | Supports TPROXY / REDIRECT with TCP, UDP, and DNS hijacking |\n| **Per-App Proxy** | Blacklist / whitelist modes for precise app-level control |\n| **Routing Rules** | Custom domain, IP, port, and traffic routing rules |\n| **DNS Settings** | Configurable DNS behavior and related proxy DNS options |\n| **Nodes \u0026 Subscriptions** | Import from links, files, and subscriptions, then convert to sing-box configs |\n| **Hotspot Sharing** | Proxy Wi-Fi hotspot and USB tethering traffic |\n| **Hot Switching** | Switch nodes without a full module reinstall |\n| **Kernel Compatibility** | Integrated IPSET LKM for wider kernel compatibility |\n\n---\n\n## Screenshots\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"docs/public/Screenshot.jpg\" width=\"60%\" alt=\"Interface Preview\" /\u003e\n\u003c/div\u003e\n\n---\n\n## Interface \u0026 Control Entry Points\n\nThe old built-in module WebUI has been removed. NetProxy is now managed through:\n\n1. **Android Manager**\n2. **CLI**\n3. **Clash API + zashboard**\n\nThe Android Manager is a separately maintained native Android application that provides dashboard, nodes, subscriptions, per-app proxy, logs, and module configuration management. Install it from Google Play: [`NetProxy`](https://play.google.com/store/apps/details?id=com.fanjv.netproxy)\n\nThere is no public source repository for the manager app.\n\nDefault control endpoints:\n\n- Controller: `http://\u003cdevice-ip\u003e:9999`\n- UI: `http://\u003cdevice-ip\u003e:9999/ui`\n- Secret: `singbox`\n\n---\n\n## Installation\n\n1. Download the latest ZIP from [Releases](https://github.com/Fanju6/NetProxy-Magisk/releases)\n2. Flash the module in **Magisk / KernelSU / APatch**\n3. Reboot your device\n4. Finish configuration through Android Manager, CLI, or zashboard\n\n---\n\n## Directory Structure\n\n```text\n/data/adb/modules/netproxy/\n├─ bin/\n│  ├─ sing-box                 # sing-box core\n│  ├─ proxylink                # node / subscription conversion tool\n│  ├─ ipset                    # ipset binary\n│  ├─ IPSET-LKM/               # integrated IPSET kernel modules\n│  └─ zashboard/               # built-in control panel\n├─ config/\n│  ├─ module.conf              # module configuration\n│  ├─ tproxy/\n│  │  └─ tproxy.conf           # transparent proxy configuration\n│  └─ singbox/\n│     ├─ confdir/              # common sing-box configuration\n│     ├─ outbounds/            # node directories\n│     │  ├─ default/\n│     │  └─ sub_xxx/\n│     ├─ runtime/              # runtime-generated configuration\n│     └─ source/               # routing rules and rule sets\n├─ logs/\n│  ├─ service.log\n│  ├─ sing-box.log\n│  └─ subscription.log\n├─ scripts/\n│  ├─ cli\n│  ├─ core/\n│  ├─ network/\n│  └─ utils/\n├─ post-fs-data.sh\n└─ service.sh\n```\n\n---\n\n## Quick Start\n\n### 1. Check status\n\n```sh\nsu -c /data/adb/modules/netproxy/scripts/cli service status\n```\n\n### 2. Start / stop the service\n\n```sh\nsu -c /data/adb/modules/netproxy/scripts/cli service start\nsu -c /data/adb/modules/netproxy/scripts/cli service stop\nsu -c /data/adb/modules/netproxy/scripts/cli service restart\n```\n\n### 3. Import nodes\n\nSingle link:\n\n```sh\nsu -c '/data/adb/modules/netproxy/scripts/cli node add \"vless://...\"'\n```\n\nImport from file:\n\n```sh\nsu -c '/data/adb/modules/netproxy/scripts/cli node import /sdcard/clash.yaml'\n```\n\nAdd and update subscriptions:\n\n```sh\nsu -c '/data/adb/modules/netproxy/scripts/cli sub add MySub https://example.com/sub'\nsu -c '/data/adb/modules/netproxy/scripts/cli sub update-all'\n```\n\n### 4. Switch nodes\n\n```sh\nsu -c '/data/adb/modules/netproxy/scripts/cli node list'\nsu -c '/data/adb/modules/netproxy/scripts/cli node use NodeName'\n```\n\n### 5. Switch mode\n\n```sh\nsu -c '/data/adb/modules/netproxy/scripts/cli mode'\nsu -c '/data/adb/modules/netproxy/scripts/cli mode rule'\nsu -c '/data/adb/modules/netproxy/scripts/cli mode global'\nsu -c '/data/adb/modules/netproxy/scripts/cli mode direct'\n```\n\n### 6. Show panel endpoints\n\n```sh\nsu -c /data/adb/modules/netproxy/scripts/cli api ui\n```\n\n---\n\n## CLI Overview\n\n```text\ncli service {status|start|stop|restart|logs}\ncli node {list|current|use|add|import|export|show|remove|delay}\ncli mode [rule|global|direct]\ncli sub {list|add|update|update-all|remove}\ncli api {groups|conns|close|close-all|ui}\ncli app {list|mode|add|remove|enable|disable}\ncli tproxy {status|reload|quic|cnip}\n```\n\nFull help:\n\n```sh\nsu -c /data/adb/modules/netproxy/scripts/cli help\n```\n\n---\n\n## Default Configuration Notes\n\nDefault values in `module.conf`:\n\n- `AUTO_START=1`\n- `OUTBOUND_MODE=rule`\n- `SELECTOR_MODE=urltest`\n- `GMS_FIX=0`\n- `CURRENT_CONFIG=` (empty until a node is selected)\n\nCommon defaults in `tproxy.conf`:\n\n- `PROXY_TCP_PORT=1536`\n- `PROXY_UDP_PORT=1536`\n- `DNS_PORT=1536`\n- `PROXY_MODE=0`\n- `BLOCK_QUIC=1`\n- `BYPASS_CN_IP=0`\n- `LOG_TIMESTAMP=0`\n\nNotes:\n\n- `PROXY_MODE=0` means auto-detect TPROXY and fall back to REDIRECT when unavailable\n- `LOG_TIMESTAMP=0` disables timestamp output in transparent proxy script logs by default\n\n---\n\n## Compatibility\n\n- Supports **Magisk / KernelSU / APatch**\n- Transparent proxy scripts retain automatic TPROXY detection with REDIRECT fallback\n- Integrated IPSET LKM improves compatibility across more devices and kernel versions\n- Includes compatibility handling for some OnePlus / ColorOS environments\n\n---\n\n## Community\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://t.me/NetProxy_Magisk\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Telegram-Join%20Group-blue?style=for-the-badge\u0026logo=telegram\" alt=\"Telegram Group\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Contributing\n\nContributions are welcome:\n\n- Submit Issues to report problems\n- Suggest new features\n- Submit Pull Requests\n- Star the project to support it\n\n---\n\n## Acknowledgments\n\nThis project builds on the following open-source projects:\n\n| Project | Description |\n|------|------|\n| [sing-box](https://github.com/SagerNet/sing-box) | Current core proxy engine |\n| [Proxylink](https://github.com/Fanju6/Proxylink) | Node links, subscriptions, and config conversion |\n| [AndroidTProxyShell](https://github.com/CHIZI-0618/AndroidTProxyShell) | Reference for Android transparent proxy implementation |\n| [IPSET_LKM](https://github.com/TanakaLun/IPSET_LKM) | Reference for IPSET kernel modules and compatibility support |\n| [zashboard](https://github.com/Zephyruso/zashboard) | Frontend panel for Clash API |\n| [v2rayNG](https://github.com/2dust/v2rayNG) | Reference for parts of node parsing logic |\n\n---\n\n## License\n\n[GPL-3.0 License](LICENSE)\n\n## Star\n\n[![Star History Chart](https://api.star-history.com/svg?repos=Fanju6/NetProxy-Magisk\u0026type=date\u0026legend=top-left)](https://www.star-history.com/#Fanju6/NetProxy-Magisk\u0026type=date\u0026legend=top-left)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffanju6%2Fnetproxy-magisk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffanju6%2Fnetproxy-magisk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffanju6%2Fnetproxy-magisk/lists"}