# fanju6/netproxy-magisk architecture

> Architecture diagram of the GitHub repository fanju6/netproxy-magisk, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fanju6/netproxy-magisk
- Repository: https://github.com/fanju6/netproxy-magisk

## Overview

NetProxy is a rooted-Android transparent proxy built around sing-box, with an Android manager, native module service, terminal CLI and terminal-style WebUI. The main user flow is to manage nodes or subscriptions, configure proxy behavior, then start and monitor the service. The README also documents per-app rules, network policies, diagnostics and a sing-box dashboard. Edges reflect README statements and shown imports/calls; several feature implementations and runtime integrations were not sampled, so their internal links are omitted.

Main entry points: [`src/native/netproxy/internal/module/app.go`](https://github.com/fanju6/netproxy-magisk/blob/main/src/native/netproxy/internal/module/app.go) (Module operations), [`src/android/app/src/main/java/com/fanjv/netproxy/MainActivity.kt`](https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/MainActivity.kt) (Android manager), [`src/android/app/src/main/java/com/fanjv/netproxy/core/api/ModuleApiClient.kt`](https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/core/api/ModuleApiClient.kt) (Module API client), [`src/native/netproxy/cmd/netproxyctl/main.go`](https://github.com/fanju6/netproxy-magisk/blob/main/src/native/netproxy/cmd/netproxyctl/main.go) (CLI dispatcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_android["Android manager"]
  node_manager["Android manager<br/>[MainActivity.kt]"]
  node_service_ui["Service controls"]
  node_catalog["Nodes &amp; subscriptions"]
  node_inbound["Inbound settings"]
  node_routing["Routing rules"]
  node_config["Config settings"]
  node_logs["Logs &amp; diagnosis<br/>[LogRepository.kt]"]
  node_api_client["Module API client<br/>[ModuleApiClient.kt]"]
  node_transport["Local HTTP transport"]
end

subgraph group_native["Native module"]
  node_cli["CLI dispatcher<br/>[main.go]"]
  node_http_api["Management API<br/>[server.go]"]
  node_module["Module operations<br/>[app.go]"]
  node_catalog_engine["Catalog operations<br/>[catalog.go]"]
  node_subscription_worker["Subscription scheduler<br/>[worker.go]"]
  node_app_policy["App policy<br/>[applications.go]"]
  node_platform["Android platform queries<br/>[Main.java]"]
end

subgraph group_web["Terminal WebUI"]
  node_webui["Terminal WebUI<br/>[main.ts]"]
end

subgraph group_proxy["Proxy runtime"]
  node_inbound_runtime["Inbound runtime<br/>[runtime.go]"]
  node_dashboard["sing-box dashboard<br/>[sw.js]"]
end

node_user(("Device user"))
node_singbox["sing-box core"]

node_user -->|"manages"| node_manager
node_user -->|"manages"| node_webui
node_user -->|"manages"| node_cli
node_manager -->|"edits catalog"| node_catalog
node_manager -->|"controls service"| node_service_ui
node_manager -->|"configures inbound"| node_inbound
node_manager -->|"edits rules"| node_routing
node_manager -->|"edits config"| node_config
node_manager -->|"views logs"| node_logs
node_service_ui -->|"calls"| node_api_client
node_catalog -->|"uses"| node_api_client
node_inbound -->|"uses"| node_api_client
node_routing -->|"reads and writes"| node_config
node_logs -->|"uses"| node_api_client
node_api_client -->|"sends requests"| node_transport
node_webui -->|"invokes commands"| node_cli
node_cli -->|"dispatches operations"| node_module
node_http_api -->|"routes operations"| node_module
node_module -->|"uses catalog"| node_catalog_engine
node_module -.->|"schedules updates"| node_subscription_worker
node_module -->|"configures inbound"| node_inbound_runtime
node_module -->|"updates policies"| node_app_policy
node_inbound_runtime -->|"feeds traffic"| node_singbox
node_user -->|"manages via panel"| node_dashboard
node_module -->|"queries Android"| node_platform
node_module -->|"runs proxy core"| node_singbox

click node_manager "https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/MainActivity.kt"
click node_service_ui "https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/core/module/ServiceRepository.kt"
click node_catalog "https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/feature/catalog/data/SubscriptionRepository.kt"
click node_inbound "https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/feature/inbound/data/InboundRepository.kt"
click node_routing "https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/feature/routing/presentation/RoutingRulesViewModel.kt"
click node_config "https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/feature/settings/data/ConfigRepository.kt"
click node_logs "https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/feature/logs/data/LogRepository.kt"
click node_api_client "https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/core/api/ModuleApiClient.kt"
click node_transport "https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/core/api/LocalHttpTransport.kt"
click node_webui "https://github.com/fanju6/netproxy-magisk/blob/main/src/webui/src/main.ts"
click node_cli "https://github.com/fanju6/netproxy-magisk/blob/main/src/native/netproxy/cmd/netproxyctl/main.go"
click node_http_api "https://github.com/fanju6/netproxy-magisk/blob/main/src/native/netproxy/internal/httpapi/server.go"
click node_module "https://github.com/fanju6/netproxy-magisk/blob/main/src/native/netproxy/internal/module/app.go"
click node_catalog_engine "https://github.com/fanju6/netproxy-magisk/blob/main/src/native/netproxy/internal/catalog/catalog.go"
click node_subscription_worker "https://github.com/fanju6/netproxy-magisk/blob/main/src/native/netproxy/internal/worker/worker.go"
click node_app_policy "https://github.com/fanju6/netproxy-magisk/blob/main/src/native/netproxy/internal/inbound/applications.go"
click node_inbound_runtime "https://github.com/fanju6/netproxy-magisk/blob/main/src/native/netproxy/internal/inbound/runtime.go"
click node_dashboard "https://github.com/fanju6/netproxy-magisk/blob/main/src/module/webroot/sing-box-dashboard/sw.js"
click node_platform "https://github.com/fanju6/netproxy-magisk/blob/main/src/android/platform/src/main/java/com/fanjv/netproxy/platform/Main.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_manager,node_service_ui,node_catalog,node_inbound,node_routing,node_config,node_logs,node_api_client,node_transport,node_user toneBlue
class node_cli,node_http_api,node_module,node_catalog_engine,node_subscription_worker,node_app_policy,node_platform toneAmber
class node_webui toneMint
class node_inbound_runtime,node_dashboard toneRose
class node_singbox toneIndigo
```

## Components

### Android manager

- [Android manager](https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/MainActivity.kt): `src/android/app/src/main/java/com/fanjv/netproxy/MainActivity.kt`
- [Service controls](https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/core/module/ServiceRepository.kt): `src/android/app/src/main/java/com/fanjv/netproxy/core/module/ServiceRepository.kt`
- [Nodes & subscriptions](https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/feature/catalog/data/SubscriptionRepository.kt): `src/android/app/src/main/java/com/fanjv/netproxy/feature/catalog/data/SubscriptionRepository.kt`
- [Inbound settings](https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/feature/inbound/data/InboundRepository.kt): `src/android/app/src/main/java/com/fanjv/netproxy/feature/inbound/data/InboundRepository.kt`
- [Routing rules](https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/feature/routing/presentation/RoutingRulesViewModel.kt): `src/android/app/src/main/java/com/fanjv/netproxy/feature/routing/presentation/RoutingRulesViewModel.kt`
- [Config settings](https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/feature/settings/data/ConfigRepository.kt): `src/android/app/src/main/java/com/fanjv/netproxy/feature/settings/data/ConfigRepository.kt`
- [Logs & diagnosis](https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/feature/logs/data/LogRepository.kt): `src/android/app/src/main/java/com/fanjv/netproxy/feature/logs/data/LogRepository.kt`
- [Module API client](https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/core/api/ModuleApiClient.kt): `src/android/app/src/main/java/com/fanjv/netproxy/core/api/ModuleApiClient.kt`
- [Local HTTP transport](https://github.com/fanju6/netproxy-magisk/blob/main/src/android/app/src/main/java/com/fanjv/netproxy/core/api/LocalHttpTransport.kt): `src/android/app/src/main/java/com/fanjv/netproxy/core/api/LocalHttpTransport.kt`

### Native module

- [CLI dispatcher](https://github.com/fanju6/netproxy-magisk/blob/main/src/native/netproxy/cmd/netproxyctl/main.go): `src/native/netproxy/cmd/netproxyctl/main.go`
- [Management API](https://github.com/fanju6/netproxy-magisk/blob/main/src/native/netproxy/internal/httpapi/server.go): `src/native/netproxy/internal/httpapi/server.go`
- [Module operations](https://github.com/fanju6/netproxy-magisk/blob/main/src/native/netproxy/internal/module/app.go): `src/native/netproxy/internal/module/app.go`
- [Catalog operations](https://github.com/fanju6/netproxy-magisk/blob/main/src/native/netproxy/internal/catalog/catalog.go): `src/native/netproxy/internal/catalog/catalog.go`
- [Subscription scheduler](https://github.com/fanju6/netproxy-magisk/blob/main/src/native/netproxy/internal/worker/worker.go): `src/native/netproxy/internal/worker/worker.go`
- [App policy](https://github.com/fanju6/netproxy-magisk/blob/main/src/native/netproxy/internal/inbound/applications.go): `src/native/netproxy/internal/inbound/applications.go`
- [Android platform queries](https://github.com/fanju6/netproxy-magisk/blob/main/src/android/platform/src/main/java/com/fanjv/netproxy/platform/Main.java): `src/android/platform/src/main/java/com/fanjv/netproxy/platform/Main.java`

### Terminal WebUI

- [Terminal WebUI](https://github.com/fanju6/netproxy-magisk/blob/main/src/webui/src/main.ts): `src/webui/src/main.ts`

### Proxy runtime

- [Inbound runtime](https://github.com/fanju6/netproxy-magisk/blob/main/src/native/netproxy/internal/inbound/runtime.go): `src/native/netproxy/internal/inbound/runtime.go`
- [sing-box dashboard](https://github.com/fanju6/netproxy-magisk/blob/main/src/module/webroot/sing-box-dashboard/sw.js): `src/module/webroot/sing-box-dashboard/sw.js`

### Other components

- **Device user**
- **sing-box core**

## Connections

- Device user → Android manager: manages (evidence: `README.md`)
- Device user → Terminal WebUI: manages (evidence: `README.md`)
- Device user → CLI dispatcher: manages (evidence: `README.md`)
- Android manager → Nodes & subscriptions: edits catalog (evidence: `README.md`)
- Android manager → Service controls: controls service (evidence: `README.md`)
- Android manager → Inbound settings: configures inbound (evidence: `README.md`)
- Android manager → Routing rules: edits rules (evidence: `README.md`)
- Android manager → Config settings: edits config (evidence: `README.md`)
- Android manager → Logs & diagnosis: views logs (evidence: `README.md`)
- Service controls → Module API client: calls (evidence: `src/android/app/src/main/java/com/fanjv/netproxy/core/module/ServiceRepository.kt`)
- Nodes & subscriptions → Module API client: uses (evidence: `src/android/app/src/main/java/com/fanjv/netproxy/feature/catalog/data/SubscriptionRepository.kt`)
- Inbound settings → Module API client: uses (evidence: `src/android/app/src/main/java/com/fanjv/netproxy/feature/inbound/data/InboundRepository.kt`)
- Routing rules → Config settings: reads and writes (evidence: `src/android/app/src/main/java/com/fanjv/netproxy/feature/routing/presentation/RoutingRulesViewModel.kt`)
- Logs & diagnosis → Module API client: uses (evidence: `src/android/app/src/main/java/com/fanjv/netproxy/feature/logs/data/LogRepository.kt`)
- Module API client → Local HTTP transport: sends requests (evidence: `src/android/app/src/main/java/com/fanjv/netproxy/core/api/ModuleApiClient.kt`)
- Terminal WebUI → CLI dispatcher: invokes commands (evidence: `README.md`)
- CLI dispatcher → Module operations: dispatches operations (evidence: `src/native/netproxy/cmd/netproxyctl/main.go`)
- Management API → Module operations: routes operations (evidence: `src/native/netproxy/internal/httpapi/server.go`)
- Module operations → Catalog operations: uses catalog (evidence: `src/native/netproxy/internal/module/app.go`)
- Module operations → Subscription scheduler: schedules updates
- Module operations → Inbound runtime: configures inbound (evidence: `src/native/netproxy/internal/module/app.go`)
- Module operations → App policy: updates policies
- Inbound runtime → sing-box core: feeds traffic (evidence: `README.md`)
- Device user → sing-box dashboard: manages via panel (evidence: `README.md`)
- Module operations → Android platform queries: queries Android
- Module operations → sing-box core: runs proxy core (evidence: `README.md`)
