accounts/docs/overview.md

2.1 KiB
Raw Blame History

XControl Overview

XControl is a multi-tenant VLESS management system...

项目名称XControl 多租户 VLESS 节点与用户流量管理系统,支持配置控制、节点分流、使用统计与用户可视化界面。

📁 项目结构Go csharp 复制 编辑 xcontrol/ ├── cmd/ │ ├── api/ # 启动 HTTP 服务 │ └── cli/ # 可选 CLI 工具 ├── internal/ │ ├── model/ # GORM 模型 │ ├── api/ # Gin 路由控制器 │ ├── service/ # 核心业务逻辑 │ ├── xray/ # 与 Xray 交互逻辑 │ └── stats/ # 流量采集整合模块 ├── webui/ # Vue 前端 ├── deploy/ │ ├── helm/ # Helm Chart │ └── docker-compose.yml └── README.md

🧩 如何工作? css 复制 编辑 [Client (vless://)] ↓ [Xray-core (node)] ↓ ← DeepFlow eBPF + WASM 插件监听所有 TCP/UDP [deepflow-agent] ↓ [解析 SNI / UUID / Email / IP / TLS fingerprint] ↓ [上报到 Controller → PostgreSQL / Prometheus]

🔧 关键功能实现规划Go

  1. 配置生成与重载 渲染 xray-config.json

写入节点工作目录

调用 systemd restart 或 xray api reload

  1. 流量采集 定时调 stats.QueryStats() 获取流量

解析 email → 用户绑定

存入 PostgreSQL 中的 usage 表

  1. 配置导出(订阅) 组合 vless:// URL 参数

支持 Reality 公钥/ShortID 解析

渲染二维码SVG 或 Base64

核心功能对照 x-ui

核心功能对照 x-ui 功能 x-ui 实现 XControl 实现 多用户 UUID 管理 本地 DB PostgreSQL + REST API 订阅配置导出 面板中手动复制 自动生成 + QR + 一键导入 节点多出口策略 ⚠️ 手动维护节点配置 每节点注册 + 出站策略可视控制 流量统计 基于 Xray stats 支持 stats + DeepFlow 双通道 WebUI + 后端整合 前后端集成 Go embed Vue可做 SaaS 化 可观测性 + 控制分离 不支持 支持 Agent 拉取或观察方式