3x-ui 部署入门
3x-ui 是 Xray-core 的 Web 管理面板：安装在服务器上，通过浏览器管理入站、用户与流量；手机或电脑仍需客户端来连接。
适用范围
依据官方 README 与 v3.7.0 发布资料整理，资料核对日期为 2026-09-14。以下为 Linux 官方脚本安装路径，Docker 与 Windows 请参考官方文档。本站尚未进行服务器部署实测。上游定位为个人使用，并明确不建议用于生产环境。
1. 部署准备
准备有管理权限的 Linux 服务器及 SSH 登录方式。先确认已登录目标服务器，再检查系统、CPU 架构及端口占用：
bash
cat /etc/os-release
uname -m
ss -lntup安装需要 Bash、curl 及管理员权限。面板管理端口与代理入站端口用途不同，云安全组和系统防火墙只开放实际使用的端口，管理入口优先限制到你的管理 IP。使用域名与 TLS 时，还需要域名解析和证书。
2. 安装面板
先阅读 v3.7.0 发布说明，确认适用环境。下载指定版本脚本并阅读，确认后再执行：
bash
curl -fL https://raw.githubusercontent.com/MHSanaei/3x-ui/v3.7.0/install.sh -o 3x-ui-install.sh
less 3x-ui-install.sh
sudo bash 3x-ui-install.sh v3.7.0保存安装过程给出的管理地址、端口、访问路径及登录信息，不要公开分享。安装默认值可能随版本变化，以实际输出为准。
3. 配置第一个入站
执行 sudo x-ui 打开官方管理菜单，检查服务状态及登录设置。通过安装给出的管理地址访问，设置独立强密码，并按官方文档配置 HTTPS 或受保护的管理通道。
- 协议：选择客户端支持的协议和传输组合。
- 监听端口：避免与 SSH、面板及其他服务冲突，同时核对防火墙和安全组。
- TLS / REALITY：按所选方案填写证书、域名或密钥参数，不要混用。
- 用户：创建独立用户，按需设置流量额度和有效期。
不同协议的字段不同，具体参数参考 协议指南 与官方文档。面板能打开，只能证明管理入口可用。
4. 客户端连接与验证
从面板获得该用户的分享链接或订阅，选择 兼容客户端 并导入。面板管理地址不是订阅地址。
连接后检查客户端日志、实际访问结果，以及面板中对应用户的流量变化。客户端显示“已连接”不代表流量已经通过服务端。失败时依次核对服务器地址、端口放行、两端参数、证书或密钥及服务器时间。
5. 更新、备份和卸载
更新前阅读目标版本发布说明，保存当前版本号，备份数据库、配置与证书，并把备份存到服务器之外的安全位置。数据库可能含有用户凭据，应限制访问权限。
按官方管理菜单或文档更新，然后重新验证面板登录与客户端连接。回退时使用与备份匹配的软件版本及数据库；数据库结构变化后，仅替换旧程序可能无法恢复。
卸载前导出需要保留的数据，再按官方管理菜单操作，并清理不再使用的防火墙规则、域名解析和证书。