3x-ui面板升级与降级教程：从新版降回2.9.4
（还没装过3x-ui的可以先看3x-ui安装教程。）升级之前，先确认一下当前跑的是哪个版本，不然升完了都不知道是不是真的换了版本：
1 | /usr/local/x-ui/x-ui -v |
如果是Docker部署的，路径不一样，改成 /app/x-ui -v。
确认完版本，3x-ui 的升级方式很简单，SSH 进服务器之后跑 x-ui update 就会重新拉取最新版本的安装脚本并执行，整个过程跟第一次安装差不多，面板会短暂重启。
升级之前建议先备份数据库文件，3x-ui 的配置数据全部存在 /etc/x-ui/x-ui.db，把这个文件复制出来就是完整备份：
1 | cp /etc/x-ui/x-ui.db /root/x-ui-backup-$(date +%Y%m%d).db |
这条命令会在 /root/ 下生成一个带日期的备份文件，升级出了问题可以直接把这个文件覆盖回去。升级本身通常不会清空数据，但不排除版本跨度大的时候数据库结构变化导致问题，备份一下是最保险的做法，具体恢复步骤参考3x-ui面板迁移与备份。
升级命令跑了没反应，或者直接报错怎么办
x-ui update 本质上是去 GitHub Releases 下载新版本的安装包，如果服务器访问 GitHub 不顺畅，会直接卡住或者报错，常见的报错是这样：
1 | ERROR: Failed to download x-ui, please be sure that your server can access GitHub |
看到这个报错说明是网络问题，不是面板本身坏了，先确认服务器能不能正常连到 GitHub：
1 | curl -Is https://github.com | head -1 |
能返回 HTTP/2 200 或者类似的状态码说明网络没问题；如果超时或者连不上，那就是这台服务器访问 GitHub 本身受限，需要先解决网络层面的问题（换线路、配置代理等），单纯重跑 x-ui update 大概率还是会失败在同一步。
升级到最新版之前有一点值得注意。3x-ui 3.0 版本发布之后，不少用户反映稳定性比 2.x 版本差，连接容易出问题，面板本身也有一些 bug。如果你的服务器在稳定跑着节点，升到 3.0 之后出问题的概率不低，不是非要用新功能的话，留在 2.9.4 反而更省心。
目前社区里公认比较稳定的版本是 2.9.4，这个版本功能完整，协议支持也够用，VLESS Reality、Hysteria2 这些都支持，日常使用基本没有什么问题。
如果已经升到新版但想降回 2.9.4，直接去 Github 找到对应版本的安装脚本跑一遍就行。降级之前同样先备份数据库，降级脚本跑完之后数据一般会保留，但保险起见还是备份一次。去 MHSanaei 的 3x-ui 仓库找到 releases 页面，找到 2.9.4 那个版本，复制对应的安装命令跑就行，不需要先卸载当前版本，安装脚本会直接覆盖。
降级完之后跑 x-ui status 确认面板状态是否正常，再登录面板检查入站列表有没有正常显示。如果入站不显示，重启一次面板通常能解决：
1 | x-ui restart |
版本选择上，新服务器直接装 2.9.4 是比较稳妥的做法，跑安装脚本的时候指定版本号就行，不用装完最新版再降级。具体安装方法参考3x-ui安装：MHSanaei版官方脚本与面板配置，里面有完整的安装步骤和面板基本配置。