2.7 KiB
XControl Overview
XControl is a multi-tenant, multi-service management platform. The project integrates several open source components as optional extension modules to provide a modular and visual administration experience:
- PulumiGo – Multi-cloud IaC engine built with Pulumi SDK and Go.
- KubeGuard – Kubernetes cluster application and node-level backup system.
- CraftWeave – Lightweight task execution & configuration orchestration engine.
- CodePRobot – AI-driven GitHub Issue to Pull Request generator and code patching tool.
- OpsAgent – AIOps-powered intelligent monitoring, anomaly detection and RCA.
- XStream – Cross-border developer proxy accelerator for global accessibility.
项目名称:XControl 一个面向多租户、多服务设计,具备多节点控制、用户订阅配置导出、流量统计与模块化可视化管理面板的系统。
📁 项目结构(Go) csharp 复制 编辑 xcontrol/ ├── cmd/ │ ├── api/ # 启动 HTTP 服务 │ └── cli/ # 可选 CLI 工具 ├── internal/ │ ├── model/ # GORM 模型 │ ├── api/ # Gin 路由控制器 │ ├── service/ # 核心业务逻辑 │ └── 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)
- 配置生成与重载 渲染 xray-config.json
写入节点工作目录
调用 systemd restart 或 xray api reload
- 流量采集 定时调 stats.QueryStats() 获取流量
解析 email → 用户绑定
存入 PostgreSQL 中的 usage 表
- 配置导出(订阅) 组合 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 拉取或观察方式