3X-UI 安装与首次登录:从 VPS 准备到面板安全设置
本文目录
3X-UI 是一个用于管理 Xray-core 服务的 Web 面板。本文整理从准备 Linux VPS、运行官方安装程序,到首次登录和加固管理入口的流程。安装命令、支持系统和面板行为会随版本变化,操作前请核对 3X-UI 官方安装文档 和 发布页面。
本文是自托管服务器的运维说明。请遵守服务器所在地法律法规及云服务商使用条款;不要在不了解配置来源的情况下部署或分享服务。
YouTube 视频
以下视频标题为“新手从 0 搭建 VPS 节点:3x-ui + VLESS REALITY”。视频用于辅助认识安装流程;具体命令和界面选项请以 3X-UI 官方文档及你当前安装版本为准。
如果播放器无法加载,可以直接在 YouTube 观看。
安装前准备
- 准备一台自己管理的 Linux VPS,并确认系统仍在 3X-UI 官方支持范围内。
- 使用 SSH 登录服务器,确认有
sudo权限或可使用 root 账户。 - 先更新系统并记录当前开放的端口。安装前为 VPS 做快照或备份;面板和 Xray 服务会改变服务器状态。
- 在云厂商防火墙和服务器本机防火墙中,只开放实际需要的端口。不要为了“省事”把所有入站端口都放开。
- 准备独立的管理入口。面板不应使用容易猜到的路径、用户名或弱密码,也不建议长期直接暴露在公网。
如果这台服务器已经运行网站、数据库或其他网络服务,先确认端口没有冲突,并记录现有服务和防火墙规则。
运行官方安装程序
官方文档建议使用项目维护者发布的安装脚本。先从官方仓库读取当前说明和发布版本,再执行安装;不要从论坛评论、网盘或不明短链接复制脚本。
官方文档当前列出的脚本入口如下:
bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)
以 root 身份运行,或按官方文档使用 sudo。这类安装程序会在服务器上创建服务、设置开机启动,并根据安装版本生成初始登录信息。远程脚本可能随上游更新而变化,所以执行前应确认地址仍属于官方仓库,并阅读脚本用途;对生产服务器,建议先在测试机或快照环境验证。
安装过程中按提示完成设置。安装成功后,务必将终端输出的初始用户名、密码和面板访问路径保存在安全的密码管理器中;不要把凭据贴进公开文章、聊天群或代码仓库。官方文档说明安装器会生成随机初始凭据,具体输出和提示可能随版本变化。
首次登录与服务检查
安装结束后,在 SSH 终端运行官方提供的管理命令:
x-ui
通过管理菜单查看当前面板设置和服务状态。使用安装器输出的访问地址和凭据登录;若安装器提示重置或重新查看登录信息,优先按当前版本的官方说明操作。
登录失败时按这个顺序检查:
- 安装命令是否完整结束,有没有依赖下载或服务启动错误。
- 面板服务是否处于运行状态,服务器端口是否与面板配置一致。
- 云厂商安全组和 Linux 防火墙是否放行了对应端口。
- 访问路径是否完整输入;如果设置了 Web 根路径,缺少路径也会导致页面无法打开。
- 本机时间、DNS 和浏览器连接是否正常。
不要仅为排障而关闭整个防火墙。如果需要临时测试端口,测试完成后及时恢复到最小开放范围。
安装后先做的安全设置
- 更换初始凭据:设置不可复用的长密码,并启用项目当前版本支持的额外认证措施。
- 限制管理入口:优先通过 VPN、可信 IP 白名单或其他访问控制保护面板;如果必须公网访问,至少使用 HTTPS 和独立的管理路径。
- 检查 TLS 与证书:使用域名时,确认 DNS 指向正确、证书有效,并留意自动续期状态。
- 备份数据目录:官方安装文档说明 SQLite 默认数据库位于
/etc/x-ui/x-ui.db;证书和其他数据路径可能因安装方式不同而异。先确认实际目录,再将数据库和必要证书纳入加密备份。 - 安排更新维护:查看官方 release notes,了解版本变化后再升级。更新前备份数据库、记录当前版本和配置,并准备可恢复的快照。
- 检查系统安全更新:面板更新不等于系统和内核更新。继续维护操作系统、SSH、防火墙和备份。
常见问题
安装成功但浏览器访问超时
先在服务器本机确认服务状态,再检查监听端口、云安全组和系统防火墙。若服务只监听本机地址,外网无法直连;若端口未放行也会超时。请按面板的实际监听配置逐项核对,不要直接套用其他人的端口号。
登录页面能打开但提示凭据错误
检查是否使用了安装输出中的初始凭据和完整访问路径。若忘记密码,使用 x-ui 管理菜单提供的重置选项;不要通过编辑未知数据库字段来猜测修复方法。
安装器提示系统不受支持
不要强行继续或混装其他发行版的软件包。先核对官方支持列表、CPU 架构和系统版本;必要时换用受支持的干净系统,或按官方文档选择适用的 Docker / 手动安装方式。
参考资料
- 文章标题
- 3X-UI 安装与首次登录:从 VPS 准备到面板安全设置
- 本文链接
- https://www.gowall.net/software/3x-ui/3x-ui-install/
- 版权说明
- 版权所有,保留所有权利。