3x-ui面板升级与降级教程：从新版降回2.9.4

3x-ui 的升级方式很简单，SSH 进服务器之后跑 x-ui update 就会重新拉取最新版本的安装脚本并执行，整个过程跟第一次安装差不多，面板会短暂重启。

升级之前建议先备份数据库文件，3x-ui 的配置数据全部存在 /etc/x-ui/x-ui.db，把这个文件复制出来就是完整备份：

```bash
cp /etc/x-ui/x-ui.db /root/x-ui-backup-$(date +%Y%m%d).db
```

这条命令会在 /root/ 下生成一个带日期的备份文件，升级出了问题可以直接把这个文件覆盖回去。升级本身通常不会清空数据，但不排除版本跨度大的时候数据库结构变化导致问题，备份一下是最保险的做法，具体恢复步骤参考3x-ui面板迁移与备份。

升级到最新版之前有一点值得注意。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 确认面板状态是否正常，再登录面板检查入站列表有没有正常显示。如果入站不显示，重启一次面板通常能解决：

```bash
x-ui restart
```

版本选择上，新服务器直接装 2.9.4 是比较稳妥的做法，跑安装脚本的时候指定版本号就行，不用装完最新版再降级。具体安装方法参考3x-ui安装：MHSanaei版官方脚本与面板配置，里面有完整的安装步骤和面板基本配置。