3X-UI 一键安装器（小白友好版）

一个可视化的 3X-UI 面板安装工具 —— 填表单、点按钮，程序自动通过 SSH 连上你的 VPS 完成安装，最后把面板地址、账号、密码直接交给你。全程不需要懂任何命令行。

界面风格与配色参考 村长实验室 czlab.dev：极简白底 + Web3 紫罗兰渐变。

功能特性

• 🧙 可视化向导：服务器信息 → 面板配置 → 自动安装 → 完成，四步搞定。
• 📜 官方脚本全自动：底层调用 MHSanaei/3x-ui 官方安装脚本的非交互模式（XUI_NONINTERACTIVE=1），把你填的用户名 / 密码 / 端口 / 路径 / 域名自动传参，行为与你手动跑脚本完全一致。
• 🔒 域名自动申请证书 + 自动续签：只要在「面板配置」里填了域名，安装时自动用 acme.sh 签发 Let's Encrypt 证书；续签由 acme.sh 内置的 cron 定时任务负责，续签后自动重启面板加载新证书，无需人工干预。
• 🌩️ Cloudflare 友好端口：默认面板端口从 Cloudflare 代理支持的端口（443 / 2053 / 8443 等）中随机选择，避免域名走 CF 代理时被「端口不在支持列表」直接拒绝。
• 🔐 凭据不落地：SSH 密码只存在你电脑内存里，SSH 直连你自己的服务器，不经过任何第三方；服务只监听 127.0.0.1，局域网内其他设备无法访问。
• 🖥️ 命令行模式：不想用向导？首页点「直接给我命令」，生成一条包含你全部设置的一键安装命令，粘贴到任意 SSH 客户端回车即可。
• 🚀 一键创建节点：安装完成后可在界面直接创建 VLESS + Reality 入站节点（添加客户端时 Flow 选 xtls-rprx-vision）。

它是怎么工作的

你的浏览器 (向导界面)
     │  Socket.IO（仅本机 127.0.0.1）
你的电脑 (Node.js 服务, SSH2)
     │  SSH 加密直连
你的 VPS (执行 3X-UI 官方安装脚本)

使用方法

前置条件

• 一台干净的 Linux VPS（Ubuntu 20.04+ / Debian 11+ / CentOS 8+ 等主流系统）
• VPS 的 IP 地址和 root 密码（在云服务商控制台可查）
• 本机装有 Node.js 18+

启动

Windows：双击 start.bat

macOS / Linux：

cd 3xui-installer
npm install        # 首次运行
npm start

然后浏览器打开 http://127.0.0.1:3930。

安装四步走

1. 服务器信息：填 IP、SSH 端口（默认 22）、root 密码 → 点「测试连接」确认能连上
2. 面板配置：设置登录用户名 / 密码 / 端口 / 访问路径；如需用域名访问，填域名即可自动申请证书并开启 HTTPS
3. 自动安装：实时查看服务器上的安装日志，1~3 分钟完成
4. 完成：一键复制面板地址和账号密码，跟着提示创建你的第一个节点

命令行模式

首页点「直接给我命令」，工具会生成一条包含你全部设置的安装命令，粘贴到任意 SSH 客户端（Xshell / Termius / FinalShell）里回车即可。

域名、证书与端口

• 想用域名访问：在「面板配置」填域名，工具会自动申请 Let's Encrypt 证书，完成后用 https://你的域名:端口/路径/ 访问。证书到期前由 acme.sh 自动续签。
• ⚠️ 前置条件：签发证书时，VPS 安全组需临时放行 TCP/80（Let's Encrypt 用它校验域名）；签发完成后 80 可关，但面板端口需保持开放。
• Cloudflare 代理：若域名走 Cloudflare 橙色代理，面板端口必须是 CF 支持列表中的端口（443 / 2053 / 2083 / 2087 / 2096 / 8443 / 80 / 8080 等），否则 CF 会直接拒绝。工具默认已选用 CF 友好端口。
• 裸 IP 访问：不开代理时直接 http://你的IP:端口/路径/ 即可（HTTP 明文，未申请证书时）。

支持

如果这个工具帮到了你，欢迎请村长喝杯咖啡 ☕
👉 czlab.dev/support

安全提示

• 仅供个人学习与合法用途，请遵守你所在地区的法律法规
• 安装后请尽快在面板中修改默认密码、开启二次验证
• 不要把生成的安装命令（含明文密码）分享或截图给他人

目录结构

3xui-installer/
├── server.js          # 后端：Express + Socket.IO + SSH2 安装编排
├── public/
│   └── index.html     # 前端向导（单文件，czlab.dev 风格）
├── start.bat          # Windows 一键启动
├── package.json
├── LICENSE            # MIT
└── .gitignore

致谢

• MHSanaei/3x-ui —— 面板本体与官方安装脚本
• 村长实验室 czlab.dev —— 界面配色与风格参考
• 村长博客 cunzhangblog.com —— 更多实用教程

许可证

MIT © 2026 村长实验室 (czlab.dev)