控制台入门
读者:已部署 Master 的管理员。
Master 控制台(frontweb)是日常运维入口:管理主机、编排逻辑节点、查看同步队列、对接租户与面板。
1. 首次登录
Section titled “1. 首次登录”安装 Master 后,在服务器执行:
sudo xctl master creds输出包含:
- 控制台 URL(通常为
https://你的域名/或带端口的管理地址) - super_admin 用户名与密码(首次随机生成,存于
/etc/xctl/admin.credentials)
浏览器打开 URL 登录。建议首次登录后修改密码,并确认 授权激活 状态正常。
2. 界面结构
Section titled “2. 界面结构”控制台按职能分区(侧栏名称可能随版本微调):
| 区域 | 用途 |
|---|---|
| 概览 / 仪表盘 | 节点在线数、同步概况、告警摘要 |
| 主机 | VPS 列表、SSH 装机、资源与在线状态 |
| 逻辑节点 | 业务线路、协议模板、准入与 DNS 域名 |
| 主机组 | 多区域 / 多运营商编组与映射 |
| 协议目录 | 入站能力矩阵与模板 |
| 证书中心 | TLS 证书申请、续签与下发 |
| 租户 | 多租户隔离、对接外部业务源 |
| 用户 | 终端用户、订阅、设备限制 |
| 配置同步 | 下发任务队列、失败重试 |
| 集成 | Adapter、面板对接参数 |
| 设置 | 日志级别、授权、系统参数 |
运维能力还包括:Web SSH 终端、Telegram 通知、节点实时预警观测(见各专题页)。
3. 推荐上手路径
Section titled “3. 推荐上手路径”按顺序完成一次端到端演练:
- 安装 Client — 至少接入 1 台 Host
- 逻辑节点 — 创建一条线路并绑定 Host
- 配置同步队列 — 确认 inbound 已同步到节点
- 在 用户 中创建测试账号,拉取订阅验证连通
- 若有业务面板,阅读 多面板接入概览
4. 实时观测
Section titled “4. 实时观测”主机与逻辑节点状态经 WebSocket 推送,无需手动刷新:
- 主机 CPU / 内存 / 磁盘、在线离线
- 逻辑节点在各 Host 上的同步状态(
pending/synced/drift/failed) - 告警与 Telegram 通知(若已配置)
5. 注意事项
Section titled “5. 注意事项”- 浏览器访问的域名即为 Master 对外 URL,装机向导与 Client 下载依赖此地址
- 超级管理员可操作全部租户;对接多业务源时建议为各租户配置独立 Adapter 凭证
- 危险操作(删除主机、解绑逻辑节点)可能触发配置同步,请在低峰期执行
6. 常见问题
Section titled “6. 常见问题”Q:登录后空白或 502?
A:检查 systemctl status xctl-master 与反代配置;数据库不可用时服务可能无法启动。
Q:看不到某菜单?
A:部分功能依赖授权档位或功能开关;试用期内一般为全功能。