3x-ui 完整指南:安装、升级、配置与排障
这个页面按使用顺序整理 3x-ui 常用操作入口。当前推荐版本见 核心栈版本状态。
安装
- 3x-ui 安装教程:官方脚本安装与面板初始配置
- 新装建议直接用最新稳定版(当前 v3.11.0),不要用旧版。
升级与安全更新
- 3x-ui 升级与降级教程:升级命令、备份方法、常见报错对照表
- Xray-core v26.10.21 紧急安全更新:印度证书事件的原委,以及 v26.10.10、v26.10.17 被撤版的原因
- Xray 安全更新怎么处理:针对 v26.10.21 证书问题的升级步骤
- 3x-ui v3.11.0 更新内容:随机初始账号、AmneziaWG 等变更
出站与路由
- 3x-ui 配置 Warp 添加 IPv4/IPv6 出口:纯 IPv6 机器获得 IPv4 出口,或纯 IPv4 获得 IPv6
- 面板内置 Hysteria2 支持;不想用面板可以用独立脚本,见 Hysteria2 一键安装脚本
维护
- 3x-ui 卸载方法和数据清理:彻底卸载与残留文件处理
- 升级或迁移前备份
/etc/x-ui/x-ui.db,恢复时直接覆盖即可。
建议阅读顺序
- 先安装(新装用最新版)
- 确认已拿到 Xray 安全更新(v3.11.0+)
- 按需配置出站(Warp / Hysteria2 等)
- 遇到升级失败或入站异常时查升级教程的报错对照表