accounts/docs/architecture/system.md

4.7 KiB
Raw Blame History

System Architecture

Describe the overall architecture with user, controller, agents.

🌐 User Panel ──► XControl API ◄───────┐ ▲ │ │ │ REST API ▼ │ [浏览器] ┌─────────────┐ gRPC/HTTP │ PostgreSQL │ ┌────────────────────┐ └─────────────┘ │ Xray 节点 Agent #1 │ │ Xray + stats/api │ └────────────────────┘ ... ┌────────────────────┐ │ DeepFlow Agent #N │ │ 采集节点流量与指标 │ └────────────────────┘

🧭 多租户 VLESS 管理系统架构图 (用户面 + 控制面 + 多节点)

                   🌐 用户面User Panel

┌─────────────────────────────────────────────────────────────┐ │ [User Browser] │ │ ├─📄 查看配置导出vless:// + QR 码) │ │ ├─📊 当前使用量(上/下行流量、图表) │ │ └─🌍 可用节点列表(选择订阅) │ └──────────────┬──────────────────────────────────────────────┘ │ HTTPS API 请求 ▼

                   🧠 控制面vless-admin Controller

┌─────────────────────────────────────────────────────────────┐ │ REST API (Gin) │ │ ├─ /api/users → 用户注册/添加/流量查询 │ │ ├─ /api/subscription → vless:// 订阅链接生成 │ │ ├─ /api/nodes → 多节点信息展示 │ │ └─ /api/stats → 后台流量采集、流控策略 │ │ │ │ PostgreSQL │ │ ├─ 用户表 (email + UUID) │ │ ├─ 节点表 │ │ └─ 流量表(每日/每小时) │ │ │ │ 可选管理界面(如需) │ └──────────────┬──────────────────────────────────────────────┘ │ HTTP/gRPC 控制与拉取配置 ▼

                 🛰️ 多节点Xray-core + Agent

┌────────────────────┐ ┌────────────────────┐ ┌────────────────────┐ │ Agent: Node #1 │ │ Agent: Node #2 │ │ Agent: Node #N │ │ ┌────────────────┐ │ │ ┌────────────────┐ │ │ ┌────────────────┐ │ │ │ Xray-core │ │ │ │ Xray-core │ │ │ │ Xray-core │ │ │ │ + stats + api │ │ │ │ + stats + api │ │ │ │ + stats + api │ │ │ └────────────────┘ │ │ └────────────────┘ │ │ └────────────────┘ │ │ ⬆ 上报用户流量 │ │ ⬆ 上报用户流量 │ │ ⬆ 上报用户流量 │ │ ⬇ 拉取用户配置 │ │ ⬇ 拉取用户配置 │ │ ⬇ 拉取用户配置 │ └────────────────────┘ └────────────────────┘ └────────────────────┘