# mlmvpn/mlmvpn_windows architecture

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

- Interactive diagram: https://gitdiagram.com/mlmvpn/mlmvpn_windows
- Repository: https://github.com/mlmvpn/mlmvpn_windows

## Overview

MLMVPN is a Windows anti-censorship desktop environment combining connection engines, clean-IP discovery, Cloudflare infrastructure tools, and network/game diagnostics. The principal user journey is choosing a route or engine, measuring whether it works, and connecting through the selected tunnel; scanning can also find and validate clean CDN addresses for configurations. The graph includes documented capabilities whose source was not sampled, but leaves their internal links out. Dashed edges mark product-level relationships not visible in the excerpts or source index.

Main entry points: [`quick-connect.js`](https://github.com/mlmvpn/mlmvpn_windows/blob/main/quick-connect.js) (Engine selection), [`xray-manager.js`](https://github.com/mlmvpn/mlmvpn_windows/blob/main/xray-manager.js) (Xray engine), [`netdiag/routes.js`](https://github.com/mlmvpn/mlmvpn_windows/blob/main/netdiag/routes.js) (Network diagnosis API), [`core-paths.js`](https://github.com/mlmvpn/mlmvpn_windows/blob/main/core-paths.js) (Verified engine cores)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop and control"]
  node_desktop_ui["Desktop interface<br/>[app.js]"]
  node_http_server["Application server<br/>[server.js]"]
end

subgraph group_connectivity["Connections and routing"]
  node_quick_connect["Engine selection<br/>[quick-connect.js]"]
  node_xray["Xray engine<br/>[xray-manager.js]"]
  node_tun["Full-system tunnel<br/>[tun-manager.js]"]
  node_aether["Aether engine<br/>[aether-manager.js]"]
  node_gateway["Gateway relays<br/>[gateway-manager.js]"]
  node_app_routing["Per-app routing<br/>[app-routing.js]"]
  node_network_settings["Windows network settings"]
end

subgraph group_infrastructure["Cloud and configuration"]
  node_scanner["Clean-IP scanner<br/>[scanner.js]"]
  node_free_configs["Public config import<br/>[free-configs.js]"]
  node_cloud_manager["Cloudflare manager<br/>[cloud-manager.js]"]
  node_gst["Google Script tunnel<br/>[gst-core.js]"]
  node_github_tunnel["GitHub tunnel<br/>[gt-engine.js]"]
  node_core_paths["Verified engine cores<br/>[core-paths.js]"]
  node_store[("Engine store<br/>[catalog.js]")]
end

subgraph group_diagnostics["Measurement and repair"]
  node_engine_sweep["Engine assessment<br/>[engine-sweep.js]"]
  node_game_routes["Game workflow API<br/>[routes.js]"]
  node_game_engines["Game engine lifecycle<br/>[engines.js]"]
  node_game_catalog["Game catalog<br/>[catalog.js]"]
  node_netdiag_routes["Network diagnosis API<br/>[routes.js]"]
  node_netdiag_engine["Diagnosis runner<br/>[engine.js]"]
  node_netdiag_collectors["Network collectors<br/>[index.js]"]
  node_netdiag_facts["Diagnosis facts<br/>[facts.js]"]
  node_netdiag_session["Diagnosis session<br/>[session.js]"]
  node_netdiag_repairs["Repair registry<br/>[index.js]"]
end

node_user(("Windows user"))

node_user -->|"uses"| node_desktop_ui
node_desktop_ui -.->|"requests services"| node_http_server
node_http_server -.->|"dispatches connection"| node_quick_connect
node_quick_connect -.->|"starts engine"| node_xray
node_quick_connect -.->|"starts tunnel"| node_tun
node_quick_connect -.->|"starts engine"| node_aether
node_quick_connect -.->|"selects relay"| node_gateway
node_tun -->|"applies routing"| node_app_routing
node_tun -->|"configures system"| node_network_settings
node_xray -->|"uses settings"| node_network_settings
node_user -->|"requests scan"| node_scanner
node_scanner -->|"returns tested IPs"| node_user
node_free_configs -.->|"provides configs"| node_xray
node_user -->|"manages account"| node_cloud_manager
node_user -.->|"controls tunnel"| node_gst
node_user -.->|"provisions session"| node_github_tunnel
node_github_tunnel -.->|"resolves core"| node_core_paths
node_xray -->|"resolves core"| node_core_paths
node_gateway -->|"resolves core"| node_core_paths
node_user -->|"requests game tuning"| node_game_routes
node_game_routes -->|"drives engines"| node_game_engines
node_game_routes -->|"reads catalog"| node_game_catalog
node_game_engines -->|"can drive Xray"| node_xray
node_game_engines -->|"can drive tunnel"| node_github_tunnel
node_user -.->|"requests diagnosis"| node_netdiag_routes
node_netdiag_routes -->|"runs diagnosis"| node_netdiag_engine
node_netdiag_routes -->|"runs collectors"| node_netdiag_collectors
node_netdiag_routes -->|"requests repairs"| node_netdiag_repairs
node_netdiag_engine -->|"runs waves"| node_netdiag_collectors
node_netdiag_engine -->|"records session"| node_netdiag_session
node_netdiag_session -->|"stores facts"| node_netdiag_facts
node_netdiag_repairs -->|"gates on facts"| node_netdiag_facts
node_netdiag_repairs -->|"checks session"| node_netdiag_session
node_store -->|"supplies versions"| node_core_paths

click node_desktop_ui "https://github.com/mlmvpn/mlmvpn_windows/blob/main/public/app.js"
click node_http_server "https://github.com/mlmvpn/mlmvpn_windows/blob/main/server.js"
click node_quick_connect "https://github.com/mlmvpn/mlmvpn_windows/blob/main/quick-connect.js"
click node_engine_sweep "https://github.com/mlmvpn/mlmvpn_windows/blob/main/engine-sweep.js"
click node_xray "https://github.com/mlmvpn/mlmvpn_windows/blob/main/xray-manager.js"
click node_tun "https://github.com/mlmvpn/mlmvpn_windows/blob/main/tun-manager.js"
click node_aether "https://github.com/mlmvpn/mlmvpn_windows/blob/main/aether-manager.js"
click node_gateway "https://github.com/mlmvpn/mlmvpn_windows/blob/main/gateway-manager.js"
click node_app_routing "https://github.com/mlmvpn/mlmvpn_windows/blob/main/app-routing.js"
click node_network_settings "https://github.com/mlmvpn/mlmvpn_windows/blob/main/network-settings.js"
click node_scanner "https://github.com/mlmvpn/mlmvpn_windows/blob/main/scanner.js"
click node_free_configs "https://github.com/mlmvpn/mlmvpn_windows/blob/main/free-configs.js"
click node_cloud_manager "https://github.com/mlmvpn/mlmvpn_windows/blob/main/cloud-manager.js"
click node_gst "https://github.com/mlmvpn/mlmvpn_windows/blob/main/gst/gst-core.js"
click node_github_tunnel "https://github.com/mlmvpn/mlmvpn_windows/blob/main/github-tunnel/gt-engine.js"
click node_core_paths "https://github.com/mlmvpn/mlmvpn_windows/blob/main/core-paths.js"
click node_game_routes "https://github.com/mlmvpn/mlmvpn_windows/blob/main/game/routes.js"
click node_game_engines "https://github.com/mlmvpn/mlmvpn_windows/blob/main/game/engines.js"
click node_game_catalog "https://github.com/mlmvpn/mlmvpn_windows/blob/main/game/catalog.js"
click node_netdiag_routes "https://github.com/mlmvpn/mlmvpn_windows/blob/main/netdiag/routes.js"
click node_netdiag_engine "https://github.com/mlmvpn/mlmvpn_windows/blob/main/netdiag/engine.js"
click node_netdiag_collectors "https://github.com/mlmvpn/mlmvpn_windows/blob/main/netdiag/collectors/index.js"
click node_netdiag_facts "https://github.com/mlmvpn/mlmvpn_windows/blob/main/netdiag/facts.js"
click node_netdiag_session "https://github.com/mlmvpn/mlmvpn_windows/blob/main/netdiag/session.js"
click node_netdiag_repairs "https://github.com/mlmvpn/mlmvpn_windows/blob/main/netdiag/repairs/index.js"
click node_store "https://github.com/mlmvpn/mlmvpn_windows/blob/main/store/catalog.js"

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_desktop_ui,node_http_server,node_user toneBlue
class node_quick_connect,node_xray,node_tun,node_aether,node_gateway,node_app_routing,node_network_settings toneAmber
class node_scanner,node_free_configs,node_cloud_manager,node_gst,node_github_tunnel,node_core_paths,node_store toneMint
class node_engine_sweep,node_game_routes,node_game_engines,node_game_catalog,node_netdiag_routes,node_netdiag_engine,node_netdiag_collectors,node_netdiag_facts,node_netdiag_session,node_netdiag_repairs toneRose
```

## Components

### Desktop and control

- [Desktop interface](https://github.com/mlmvpn/mlmvpn_windows/blob/main/public/app.js): `public/app.js`
- [Application server](https://github.com/mlmvpn/mlmvpn_windows/blob/main/server.js): `server.js`

### Connections and routing

- [Engine selection](https://github.com/mlmvpn/mlmvpn_windows/blob/main/quick-connect.js): `quick-connect.js`
- [Xray engine](https://github.com/mlmvpn/mlmvpn_windows/blob/main/xray-manager.js): `xray-manager.js`
- [Full-system tunnel](https://github.com/mlmvpn/mlmvpn_windows/blob/main/tun-manager.js): `tun-manager.js`
- [Aether engine](https://github.com/mlmvpn/mlmvpn_windows/blob/main/aether-manager.js): `aether-manager.js`
- [Gateway relays](https://github.com/mlmvpn/mlmvpn_windows/blob/main/gateway-manager.js): `gateway-manager.js`
- [Per-app routing](https://github.com/mlmvpn/mlmvpn_windows/blob/main/app-routing.js): `app-routing.js`
- [Windows network settings](https://github.com/mlmvpn/mlmvpn_windows/blob/main/network-settings.js): `network-settings.js`

### Cloud and configuration

- [Clean-IP scanner](https://github.com/mlmvpn/mlmvpn_windows/blob/main/scanner.js): `scanner.js`
- [Public config import](https://github.com/mlmvpn/mlmvpn_windows/blob/main/free-configs.js): `free-configs.js`
- [Cloudflare manager](https://github.com/mlmvpn/mlmvpn_windows/blob/main/cloud-manager.js): `cloud-manager.js`
- [Google Script tunnel](https://github.com/mlmvpn/mlmvpn_windows/blob/main/gst/gst-core.js): `gst/gst-core.js`
- [GitHub tunnel](https://github.com/mlmvpn/mlmvpn_windows/blob/main/github-tunnel/gt-engine.js): `github-tunnel/gt-engine.js`
- [Verified engine cores](https://github.com/mlmvpn/mlmvpn_windows/blob/main/core-paths.js): `core-paths.js`
- [Engine store](https://github.com/mlmvpn/mlmvpn_windows/blob/main/store/catalog.js): `store/catalog.js`

### Measurement and repair

- [Engine assessment](https://github.com/mlmvpn/mlmvpn_windows/blob/main/engine-sweep.js): `engine-sweep.js`
- [Game workflow API](https://github.com/mlmvpn/mlmvpn_windows/blob/main/game/routes.js): `game/routes.js`
- [Game engine lifecycle](https://github.com/mlmvpn/mlmvpn_windows/blob/main/game/engines.js): `game/engines.js`
- [Game catalog](https://github.com/mlmvpn/mlmvpn_windows/blob/main/game/catalog.js): `game/catalog.js`
- [Network diagnosis API](https://github.com/mlmvpn/mlmvpn_windows/blob/main/netdiag/routes.js): `netdiag/routes.js`
- [Diagnosis runner](https://github.com/mlmvpn/mlmvpn_windows/blob/main/netdiag/engine.js): `netdiag/engine.js`
- [Network collectors](https://github.com/mlmvpn/mlmvpn_windows/blob/main/netdiag/collectors/index.js): `netdiag/collectors/index.js`
- [Diagnosis facts](https://github.com/mlmvpn/mlmvpn_windows/blob/main/netdiag/facts.js): `netdiag/facts.js`
- [Diagnosis session](https://github.com/mlmvpn/mlmvpn_windows/blob/main/netdiag/session.js): `netdiag/session.js`
- [Repair registry](https://github.com/mlmvpn/mlmvpn_windows/blob/main/netdiag/repairs/index.js): `netdiag/repairs/index.js`

### Other components

- **Windows user**

## Connections

- Windows user → Desktop interface: uses (evidence: `README.md`)
- Desktop interface → Application server: requests services
- Application server → Engine selection: dispatches connection
- Engine selection → Xray engine: starts engine
- Engine selection → Full-system tunnel: starts tunnel
- Engine selection → Aether engine: starts engine
- Engine selection → Gateway relays: selects relay
- Full-system tunnel → Per-app routing: applies routing (evidence: `tun-manager.js`)
- Full-system tunnel → Windows network settings: configures system (evidence: `tun-manager.js`)
- Xray engine → Windows network settings: uses settings (evidence: `xray-manager.js`)
- Windows user → Clean-IP scanner: requests scan (evidence: `README.md`)
- Clean-IP scanner → Windows user: returns tested IPs (evidence: `README.md`)
- Public config import → Xray engine: provides configs
- Windows user → Cloudflare manager: manages account (evidence: `README.md`)
- Windows user → Google Script tunnel: controls tunnel
- Windows user → GitHub tunnel: provisions session
- GitHub tunnel → Verified engine cores: resolves core (evidence: `github-tunnel/gt-engine.js`)
- Xray engine → Verified engine cores: resolves core (evidence: `xray-manager.js`)
- Gateway relays → Verified engine cores: resolves core (evidence: `gateway-manager.js`)
- Windows user → Game workflow API: requests game tuning (evidence: `game/routes.js`)
- Game workflow API → Game engine lifecycle: drives engines (evidence: `game/routes.js`)
- Game workflow API → Game catalog: reads catalog (evidence: `game/routes.js`)
- Game engine lifecycle → Xray engine: can drive Xray (evidence: `game/engines.js`)
- Game engine lifecycle → GitHub tunnel: can drive tunnel (evidence: `game/engines.js`)
- Windows user → Network diagnosis API: requests diagnosis
- Network diagnosis API → Diagnosis runner: runs diagnosis (evidence: `netdiag/routes.js`)
- Network diagnosis API → Network collectors: runs collectors (evidence: `netdiag/routes.js`)
- Network diagnosis API → Repair registry: requests repairs (evidence: `netdiag/routes.js`)
- Diagnosis runner → Network collectors: runs waves (evidence: `netdiag/engine.js`)
- Diagnosis runner → Diagnosis session: records session (evidence: `netdiag/engine.js`)
- Diagnosis session → Diagnosis facts: stores facts (evidence: `netdiag/session.js`)
- Repair registry → Diagnosis facts: gates on facts (evidence: `netdiag/repairs/index.js`)
- Repair registry → Diagnosis session: checks session (evidence: `netdiag/repairs/index.js`)
- Engine store → Verified engine cores: supplies versions (evidence: `core-paths.js`)
