这里的 X-UI 指 alireza0/x-ui。它与 3x-ui 名称相近，但安装来源、数据库和版本维护各自独立。本篇在一台新的 Linux 主机上建立测试入站，避免与已经安装的同名 x-ui 服务互相覆盖。
资料核对：2026 年 9 月 30 日。下方配图为科学之家绘制的操作流程示意，具体菜单以所用版本为准。
01 · 准备与填写约定
准备一台具有管理员权限、能够访问项目发布源的 Linux 服务器，以及支持所选协议的客户端。记录公网地址和已占用端口；已有服务的主机先做快照。文中的 SERVER_IP、USER、示例密码和证书路径必须换成自己的值。
先确定一个测试目标：只创建一个入站或用户，导入一台客户端并验证。这能让安装、账号和连接三个阶段的问题分别定位。
02 · 安装与首次进入
在目标 Linux 服务器的 SSH 终端操作。先下载并查看官方脚本，再执行安装；安装命令不在日常使用的电脑上运行。
curl -fL https://raw.githubusercontent.com/alireza0/x-ui/master/install.sh -o alireza-x-ui-install.sh
less alireza-x-ui-install.sh
sudo bash alireza-x-ui-install.sh根据安装终端输出进入面板。再次管理时运行 sudo x-ui，先查看状态和面板设置。首次登录修改初始账号密码；端口和路径以本次安装结果为准。
03 · 建立第一条可用连接
- 在入站列表创建 Shadowsocks 入站，用明确的备注区分用途。先只开一个未占用端口，例如 24443，避免同时配置多个协议后无法判断是哪一项出错。
- 选择 aes-128-gcm 等客户端支持的加密方式，并生成随机密码。若界面提供单独的客户端列表，添加用户条目并确认其已启用；流量和有效期按自己的需求填写。
- 保存后检查 Xray 状态与日志。如日志报告 address already in use，先查占用端口的服务，再换一个空闲端口，不要反复重装。
- 为这条入站开放对应 TCP 端口；确实使用 UDP 时再开放同端口 UDP。把面板管理端口和代理端口分别记录，方便以后排查。
04 · 看图核对连接信息
| 设置或现象 | 填写方法与检查方向 |
|---|---|
| 所属项目 | 安装地址必须对应 alireza0/x-ui；已有其他分支时先做迁移评估。 |
| 备注 | 例如“笔记本测试”，便于从多个用户中找到正确的分享链接。 |
| 访问地址 | 客户端使用公网 IP / 域名；面板中的监听地址表示服务器绑定位置。 |
| 有效期 | 导出链接前确认用户未过期、未禁用，配额仍可用。 |
05 · 导入客户端并验证
从目标入站的用户条目导出链接或二维码。在客户端使用“从剪贴板导入”后选择该节点，再发起连接。若要使用订阅，在面板设置中启用并核对订阅服务地址，再复制用户自己的订阅链接；管理页面 URL 不能代替订阅。
- 确认客户端拿到了节点，而不是网页、管理地址或错误提示。
- 重新建立连接，查看一次真实请求的结果；单独显示“已连接”不能替代访问测试。
- 对照同一时段的客户端日志和服务端日志 / 用量，确认测试用的是新配置。
06 · 常见问题
| 设置或现象 | 填写方法与检查方向 |
|---|---|
| 同机已经有 3x-ui | 两者可能使用相同服务名和文件位置。请在独立主机部署本教程，迁移前保留原面板数据库及配置。 |
| 浏览器打不开面板 | 用 x-ui 菜单确认服务状态、端口和访问路径，检查防火墙；不要仅凭旧书签判断安装失败。 |
| 客户端列表看不到新节点 | 确认复制的是目标用户的链接；使用订阅时手动更新一次，并检查订阅服务地址和用户状态。 |
07 · 备份与后续维护
通过面板提供的导出功能保留数据库，另外保存证书文件和安装方式说明。Docker 安装还要保留挂载的数据目录与 compose 文件；数据库版本不明时不要跨分支直接覆盖。
每次只调整一类设置，并保留可恢复的旧配置。改端口、凭据或域名后重新生成分享信息；客户端也需要同步更新。
08 · 官方资料与下一步
文字与流程图由科学之家整理制作；安装来源和协议字段参见上述官方资料。本文未附带任何服务商套餐或推广链接。
