SSH 一键装机

读者：扩容新 VPS、希望从控制台完成装机与注册的运维人员。

SSH 一键装机是 安装 Client 的推荐方式：Master 通过 SSH 在目标 VPS 上非交互安装 3x-ui（可选）与 Client，并实时推送进度到浏览器。

1. 适用场景

• 新购 VPS，从零接入 Master
• 批量扩容同一区域节点
• 避免手工 curl | bash 与复制粘贴配置

若 Master 无法 SSH 到节点（纯内网、仅 Client 出站），请改用 手工 curl 安装。

2. 前置条件

• 目标机：Linux root（或等效 sudo）、22 或自定义 SSH 端口可达
• Master 侧：出站能连目标 SSH；授权 Host 配额未满
• 可选：预先在 SSH 凭证库 保存常用密钥，装机时选择「凭证库」

3. 操作步骤

1. 控制台 → 主机 → 添加主机 / SSH 装机

2. 填写 主机名、SSH 地址、端口

3. 认证方式：

   • 一次性密码/密钥（inline_secret）— 默认，适合单次装机
   • 凭证库 — 选择已保存的 credential_id

4. 点击 测试 SSH

   • 成功示例：root @ debian/amd64
   • 仅显示 root（SSH 已连通） 也可继续（OS/架构未解析）
   • root @ undefined/undefined 表示连通正常，字段缺失可忽略

5. 勾选 安装 3x-ui（新机器）与 安装 Client

6. 提交，观察旅程条：

   准备 → SSH 连通 → 安装 XUI → 安装 Client → 完成

7. 完成后在主机列表确认 在线，再于 逻辑节点 绑定

4. 装机过程说明

Master ProvisionService 通过 SSH 逐步执行内嵌脚本（非官方 3x-ui 交互安装）：

阶段	行为
安装 XUI	下载 release tarball，x-ui setting 写入随机或指定面板路径/端口/密码
安装 Client	从 MASTER_URL/dl/xctl-client-linux-{arch} 拉二进制，写入 systemd
注册	Client 连 Master WebSocket，主机出现在控制台

面板密码与路径在主机详情中查看；勿使用弱口令默认值。

5. 注意事项

• 旅程条顺序与后端 pipeline 一致：XUI 失败时 Client 阶段不会误标完成
• 重复装机同一 IP 可能产生重复 Host 记录，请先下线旧记录
• 防火墙需允许 Master → Host SSH；Host 上 Client → Master HTTPS/WebSocket 出站
• 装机不替代安全加固：建议改 SSH 端口、禁用密码登录（密钥）、配置 fail2ban

6. 常见问题

Q：SSH 测试失败？
A：检查 IP、端口、密码/密钥、云厂商安全组；Master 服务器是否被节点防火墙拒绝。

Q：卡在安装 XUI？
A：节点出网是否可下载安装包；磁盘空间是否充足；查看装机进度日志中的报错详情。

Q：Client 装完但离线？
A：systemctl status xctl-client；Master URL 是否与客户浏览器访问的 origin 一致。

相关链接

• 安装 Client
• Web SSH 终端（装机后的日常排错）