# mack-a/v2ray-agent architecture

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

- Interactive diagram: https://gitdiagram.com/mack-a/v2ray-agent
- Repository: https://github.com/mack-a/v2ray-agent

## Overview

v2ray-agent is a shell-script product for installing and managing Xray-core or sing-box proxy servers. The documented user journey is to run the installer, then reopen its management menu; a separate Docker Reality script has its own menu command. The README also advertises protocol, TLS, subscription, routing, domain-blocking, and P2P-management capabilities. No source excerpts were supplied, so the graph shows only README-documented relationships and does not infer internal calls or data flow.

Main entry points: [`install.sh`](https://github.com/mack-a/v2ray-agent/blob/master/install.sh) (Management menu), [`shell/docker_reality.sh`](https://github.com/mack-a/v2ray-agent/blob/master/shell/docker_reality.sh) (Docker Reality)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_installation["Installation"]
  node_installer["Script installer<br/>[install.sh]"]
  node_docker_script["Docker Reality<br/>[docker_reality.sh]"]
end

subgraph group_proxy["Proxy Service"]
  node_cores["Proxy cores<br/>[install.sh]"]
  node_protocols["Proxy protocols<br/>[install.sh]"]
  node_tls["TLS certificates<br/>[install.sh]"]
end

subgraph group_management["Management"]
  node_menu["Management menu<br/>[install.sh]"]
  node_docker_menu["Docker menu<br/>[docker_reality.sh]"]
  node_subscriptions["Subscriptions<br/>[install.sh]"]
end

subgraph group_network["Network Controls"]
  node_traffic_routing["Traffic routing<br/>[install.sh]"]
  node_domain_rules["Domain blocking<br/>[install.sh]"]
  node_p2p_rules["P2P blocking<br/>[install.sh]"]
end

node_user(("Server operator"))

node_user -->|"runs"| node_installer
node_user -->|"runs"| node_docker_script
node_user -->|"reopens with vasma"| node_menu
node_user -->|"reopens with vasmad"| node_docker_menu
node_installer -->|"installs menu"| node_menu
node_docker_script -->|"installs menu"| node_docker_menu
node_menu -->|"supports"| node_cores
node_menu -->|"supports"| node_protocols
node_menu -->|"automates TLS"| node_tls
node_menu -->|"manages"| node_subscriptions
node_menu -->|"supports"| node_traffic_routing
node_menu -->|"manages"| node_domain_rules
node_menu -->|"manages"| node_p2p_rules

click node_installer "https://github.com/mack-a/v2ray-agent/blob/master/install.sh"
click node_docker_script "https://github.com/mack-a/v2ray-agent/blob/master/shell/docker_reality.sh"
click node_menu "https://github.com/mack-a/v2ray-agent/blob/master/install.sh"
click node_docker_menu "https://github.com/mack-a/v2ray-agent/blob/master/shell/docker_reality.sh"
click node_cores "https://github.com/mack-a/v2ray-agent/blob/master/install.sh"
click node_protocols "https://github.com/mack-a/v2ray-agent/blob/master/install.sh"
click node_tls "https://github.com/mack-a/v2ray-agent/blob/master/install.sh"
click node_subscriptions "https://github.com/mack-a/v2ray-agent/blob/master/install.sh"
click node_traffic_routing "https://github.com/mack-a/v2ray-agent/blob/master/install.sh"
click node_domain_rules "https://github.com/mack-a/v2ray-agent/blob/master/install.sh"
click node_p2p_rules "https://github.com/mack-a/v2ray-agent/blob/master/install.sh"

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_installer,node_docker_script toneBlue
class node_cores,node_protocols,node_tls toneAmber
class node_menu,node_docker_menu,node_subscriptions,node_user toneMint
class node_traffic_routing,node_domain_rules,node_p2p_rules toneRose
```

## Components

### Installation

- [Script installer](https://github.com/mack-a/v2ray-agent/blob/master/install.sh): `install.sh`
- [Docker Reality](https://github.com/mack-a/v2ray-agent/blob/master/shell/docker_reality.sh): `shell/docker_reality.sh`

### Proxy Service

- [Proxy cores](https://github.com/mack-a/v2ray-agent/blob/master/install.sh): `install.sh`
- [Proxy protocols](https://github.com/mack-a/v2ray-agent/blob/master/install.sh): `install.sh`
- [TLS certificates](https://github.com/mack-a/v2ray-agent/blob/master/install.sh): `install.sh`

### Management

- [Management menu](https://github.com/mack-a/v2ray-agent/blob/master/install.sh): `install.sh`
- [Docker menu](https://github.com/mack-a/v2ray-agent/blob/master/shell/docker_reality.sh): `shell/docker_reality.sh`
- [Subscriptions](https://github.com/mack-a/v2ray-agent/blob/master/install.sh): `install.sh`

### Network Controls

- [Traffic routing](https://github.com/mack-a/v2ray-agent/blob/master/install.sh): `install.sh`
- [Domain blocking](https://github.com/mack-a/v2ray-agent/blob/master/install.sh): `install.sh`
- [P2P blocking](https://github.com/mack-a/v2ray-agent/blob/master/install.sh): `install.sh`

### Other components

- **Server operator**

## Connections

- Server operator → Script installer: runs (evidence: `README.md`)
- Server operator → Docker Reality: runs (evidence: `README.md`)
- Server operator → Management menu: reopens with vasma (evidence: `README.md`)
- Server operator → Docker menu: reopens with vasmad (evidence: `README.md`)
- Script installer → Management menu: installs menu (evidence: `README.md`)
- Docker Reality → Docker menu: installs menu (evidence: `README.md`)
- Management menu → Proxy cores: supports (evidence: `README.md`)
- Management menu → Proxy protocols: supports (evidence: `README.md`)
- Management menu → TLS certificates: automates TLS (evidence: `README.md`)
- Management menu → Subscriptions: manages (evidence: `README.md`)
- Management menu → Traffic routing: supports (evidence: `README.md`)
- Management menu → Domain blocking: manages (evidence: `README.md`)
- Management menu → P2P blocking: manages (evidence: `README.md`)
