# wectazz/v2raymd architecture

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

- Interactive diagram: https://gitdiagram.com/wectazz/v2raymd
- Repository: https://github.com/wectazz/v2raymd

## Overview

v2rayMD is an Android V2Ray client supporting Xray and v2fly cores. The main workflow is selecting or importing a proxy profile, configuring routing and VPN behavior, then starting a foreground service that establishes Android’s VPN interface and runs the core; users can monitor traffic and test connections. The tree also shows subscription, backup, root-mode, per-app proxy, and asset-management features. Edges are limited to relationships visible in excerpts or documented in the README; unsampled UI and orchestration links are omitted.

Main entry points: [`V2rayMD/app/src/main/java/com/v2ray/md/handler/MmkvManager.kt`](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/handler/MmkvManager.kt) (Profile storage), [`V2rayMD/app/src/main/java/com/v2ray/md/handler/SettingsManager.kt`](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/handler/SettingsManager.kt) (Connection settings), [`V2rayMD/app/src/main/java/com/v2ray/md/service/CoreVpnService.kt`](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/service/CoreVpnService.kt) (VPN service), [`V2rayMD/app/src/main/java/com/v2ray/md/core/CoreServiceManager.kt`](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/core/CoreServiceManager.kt) (Core service manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_profiles["Profiles and subscriptions"]
  node_profile_store[("Profile storage<br/>[MmkvManager.kt]")]
  node_profile_model["Proxy profiles<br/>[ProfileItem.kt]"]
  node_profile_formats["Profile formats"]
  node_subscription_update["Subscription updates"]
  node_subscription_manager["Subscription manager"]
end

subgraph group_configuration["Proxy configuration"]
  node_settings["Connection settings<br/>[SettingsManager.kt]"]
  node_routing_ui["Routing editor"]
  node_routing_rules["Routing rulesets<br/>[RulesetItem.kt]"]
  node_config_manager["Core configuration"]
end

subgraph group_runtime["Connection runtime"]
  node_vpn_service["VPN service<br/>[CoreVpnService.kt]"]
  node_service_manager["Core service manager"]
  node_native_core["Native core"]
  node_root_mode["Root proxy mode"]
  node_notification["Traffic notification"]
end

subgraph group_management["Settings and tools"]
  node_speedtest["Connection testing"]
  node_backup["Backup and restore<br/>[BackupViewModel.kt]"]
  node_assets["Geo data assets<br/>[SettingsManager.kt]"]
end

subgraph group_presentation["Android interface"]
  node_main_ui["Main screen<br/>[MainScreen.kt]"]
end

node_user(("Android user"))
node_external_core{{"Xray / v2fly core"}}
node_android_vpn{{"Android VPN platform"}}

node_user -.->|"uses"| node_main_ui
node_main_ui -.->|"manages profiles"| node_profile_store
node_profile_formats -.->|"parses profiles"| node_profile_model
node_subscription_update -.->|"updates subscriptions"| node_profile_store
node_subscription_manager -.->|"stores subscriptions"| node_profile_store
node_routing_ui -->|"edits rules"| node_settings
node_settings -->|"persists settings"| node_profile_store
node_settings -.->|"loads rulesets"| node_routing_rules
node_profile_store -.->|"stores profiles"| node_profile_model
node_main_ui -.->|"starts connection"| node_vpn_service
node_vpn_service -->|"starts core loop"| node_service_manager
node_service_manager -->|"controls service"| node_vpn_service
node_vpn_service -->|"establishes tunnel"| node_android_vpn
node_service_manager -.->|"runs core"| node_native_core
node_native_core -->|"controls core"| node_external_core
node_root_mode -->|"reads settings"| node_profile_store
node_notification -->|"queries traffic"| node_service_manager
node_speedtest -.->|"tests outbound"| node_native_core
node_backup -.->|"backs up data"| node_profile_store
node_settings -->|"initializes assets"| node_assets

click node_main_ui "https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/ui/main/MainScreen.kt"
click node_profile_store "https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/handler/MmkvManager.kt"
click node_profile_model "https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/dto/entities/ProfileItem.kt"
click node_profile_formats "https://github.com/wectazz/v2raymd/tree/master/V2rayMD/app/src/main/java/com/v2ray/md/fmt"
click node_subscription_update "https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/service/SubscriptionUpdateService.kt"
click node_subscription_manager "https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/handler/SubscriptionUpdater.kt"
click node_settings "https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/handler/SettingsManager.kt"
click node_routing_ui "https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/ui/routing/RoutingEditActivity.kt"
click node_routing_rules "https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/dto/entities/RulesetItem.kt"
click node_config_manager "https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/core/CoreConfigManager.kt"
click node_vpn_service "https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/service/CoreVpnService.kt"
click node_service_manager "https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/core/CoreServiceManager.kt"
click node_native_core "https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/core/CoreNativeManager.kt"
click node_root_mode "https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/root/RootProxyManager.kt"
click node_notification "https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/handler/NotificationManager.kt"
click node_speedtest "https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/handler/SpeedtestManager.kt"
click node_backup "https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/ui/backup/BackupViewModel.kt"
click node_assets "https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/handler/SettingsManager.kt"

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_profile_store,node_profile_model,node_profile_formats,node_subscription_update,node_subscription_manager,node_user toneBlue
class node_settings,node_routing_ui,node_routing_rules,node_config_manager toneAmber
class node_vpn_service,node_service_manager,node_native_core,node_root_mode,node_notification toneMint
class node_speedtest,node_backup,node_assets toneRose
class node_main_ui,node_external_core,node_android_vpn toneIndigo
```

## Components

### Profiles and subscriptions

- [Profile storage](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/handler/MmkvManager.kt): `V2rayMD/app/src/main/java/com/v2ray/md/handler/MmkvManager.kt`
- [Proxy profiles](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/dto/entities/ProfileItem.kt): `V2rayMD/app/src/main/java/com/v2ray/md/dto/entities/ProfileItem.kt`
- [Profile formats](https://github.com/wectazz/v2raymd/tree/master/V2rayMD/app/src/main/java/com/v2ray/md/fmt): `V2rayMD/app/src/main/java/com/v2ray/md/fmt`
- [Subscription updates](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/service/SubscriptionUpdateService.kt): `V2rayMD/app/src/main/java/com/v2ray/md/service/SubscriptionUpdateService.kt`
- [Subscription manager](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/handler/SubscriptionUpdater.kt): `V2rayMD/app/src/main/java/com/v2ray/md/handler/SubscriptionUpdater.kt`

### Proxy configuration

- [Connection settings](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/handler/SettingsManager.kt): `V2rayMD/app/src/main/java/com/v2ray/md/handler/SettingsManager.kt`
- [Routing editor](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/ui/routing/RoutingEditActivity.kt): `V2rayMD/app/src/main/java/com/v2ray/md/ui/routing/RoutingEditActivity.kt`
- [Routing rulesets](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/dto/entities/RulesetItem.kt): `V2rayMD/app/src/main/java/com/v2ray/md/dto/entities/RulesetItem.kt`
- [Core configuration](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/core/CoreConfigManager.kt): `V2rayMD/app/src/main/java/com/v2ray/md/core/CoreConfigManager.kt`

### Connection runtime

- [VPN service](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/service/CoreVpnService.kt): `V2rayMD/app/src/main/java/com/v2ray/md/service/CoreVpnService.kt`
- [Core service manager](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/core/CoreServiceManager.kt): `V2rayMD/app/src/main/java/com/v2ray/md/core/CoreServiceManager.kt`
- [Native core](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/core/CoreNativeManager.kt): `V2rayMD/app/src/main/java/com/v2ray/md/core/CoreNativeManager.kt`
- [Root proxy mode](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/root/RootProxyManager.kt): `V2rayMD/app/src/main/java/com/v2ray/md/root/RootProxyManager.kt`
- [Traffic notification](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/handler/NotificationManager.kt): `V2rayMD/app/src/main/java/com/v2ray/md/handler/NotificationManager.kt`

### Settings and tools

- [Connection testing](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/handler/SpeedtestManager.kt): `V2rayMD/app/src/main/java/com/v2ray/md/handler/SpeedtestManager.kt`
- [Backup and restore](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/ui/backup/BackupViewModel.kt): `V2rayMD/app/src/main/java/com/v2ray/md/ui/backup/BackupViewModel.kt`
- [Geo data assets](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/handler/SettingsManager.kt): `V2rayMD/app/src/main/java/com/v2ray/md/handler/SettingsManager.kt`

### Android interface

- [Main screen](https://github.com/wectazz/v2raymd/blob/master/V2rayMD/app/src/main/java/com/v2ray/md/ui/main/MainScreen.kt): `V2rayMD/app/src/main/java/com/v2ray/md/ui/main/MainScreen.kt`

### Other components

- **Android user**
- **Xray / v2fly core**
- **Android VPN platform**

## Connections

- Android user → Main screen: uses
- Main screen → Profile storage: manages profiles
- Profile formats → Proxy profiles: parses profiles
- Subscription updates → Profile storage: updates subscriptions (evidence: `V2rayMD/app/src/main/java/com/v2ray/md/service/SubscriptionUpdateService.kt`)
- Subscription manager → Profile storage: stores subscriptions
- Routing editor → Connection settings: edits rules (evidence: `V2rayMD/app/src/main/java/com/v2ray/md/ui/routing/RoutingEditActivity.kt`)
- Connection settings → Profile storage: persists settings (evidence: `V2rayMD/app/src/main/java/com/v2ray/md/handler/SettingsManager.kt`)
- Connection settings → Routing rulesets: loads rulesets (evidence: `V2rayMD/app/src/main/java/com/v2ray/md/handler/SettingsManager.kt`)
- Profile storage → Proxy profiles: stores profiles (evidence: `V2rayMD/app/src/main/java/com/v2ray/md/handler/MmkvManager.kt`)
- Main screen → VPN service: starts connection
- VPN service → Core service manager: starts core loop (evidence: `V2rayMD/app/src/main/java/com/v2ray/md/service/CoreVpnService.kt`)
- Core service manager → VPN service: controls service (evidence: `V2rayMD/app/src/main/java/com/v2ray/md/core/CoreServiceManager.kt`)
- VPN service → Android VPN platform: establishes tunnel (evidence: `V2rayMD/app/src/main/java/com/v2ray/md/service/CoreVpnService.kt`)
- Core service manager → Native core: runs core (evidence: `V2rayMD/app/src/main/java/com/v2ray/md/core/CoreServiceManager.kt`)
- Native core → Xray / v2fly core: controls core (evidence: `V2rayMD/app/src/main/java/com/v2ray/md/core/CoreNativeManager.kt`)
- Root proxy mode → Profile storage: reads settings (evidence: `V2rayMD/app/src/main/java/com/v2ray/md/root/RootProxyManager.kt`)
- Traffic notification → Core service manager: queries traffic (evidence: `V2rayMD/app/src/main/java/com/v2ray/md/handler/NotificationManager.kt`)
- Connection testing → Native core: tests outbound
- Backup and restore → Profile storage: backs up data
- Connection settings → Geo data assets: initializes assets (evidence: `V2rayMD/app/src/main/java/com/v2ray/md/handler/SettingsManager.kt`)
