S-UI升级到新版本，出问题了怎么退回旧版本

发表于 分类于
S-UI升级本质上是原地重跑一遍安装脚本，数据不会丢；新版本用着有问题的话，面板菜单里也有专门指定回退到某个具体版本号的选项。

S-UI 的升级机制比想象中简单一些——不是那种下载安装包覆盖安装的思路，本质上就是重新跑一遍安装脚本，脚本会自动拉取最新版本的程序文件替换掉旧的，数据库不会被碰。

SSH 进服务器，运行 s-ui 调出管理菜单，升级相关的是这两项：

  • 2. Update —— 更新到最新版本
  • 3. Custom Version —— 安装/回退到指定的具体版本号

更新到最新版

选第 2 项，会先弹出一句确认提示，原话大意是"这个操作会强制重装到最新版本，但数据不会丢失"，确认之后脚本会自动下载安装最新版本，装完自动重启面板，整个过程不需要额外操作。

不想走交互菜单的话，也可以直接在命令行执行：

1
s-ui update

效果跟菜单里选第2项一样，适合写进自动化脚本或者懒得进菜单、想一条命令搞定的场景。

新版本有问题，怎么退回去

升级之后如果发现新版本有 bug、用着不顺手，想退回之前的版本，用第 3 项 Custom Version。选中之后会让你输入一个具体的版本号（比如 0.0.1），脚本会重新安装到这个指定版本，不需要先手动卸载。版本号去 alireza0/s-ui 的 Releases 页面查，确认好想回退到哪个版本再操作。

这个功能不只是用来回退，需要在多台服务器上保持同一个版本号（比如生产环境不想随便用最新版，想固定用某个已经验证过稳定的版本）时也能用上，指定版本号装就行。

升级前后要注意的

虽然官方保证数据不会丢，稳妥起见升级之前手动备份一下 db/ 目录还是有必要的，具体位置和备份方法参考alireza0/s-ui官方仓库与常用命令里"关于删库"那一节提到的路径。升级过程中面板会有短暂的重启，正在连接的节点会断开几秒钟，选一个没什么人用的时间段操作，影响会小一些。

如果升级之后面板彻底打不开了，先别急着删库重装，按S-UI忘记密码怎么办和改面板端口和访问路径里提到的排查思路先确认是不是端口、路径或者密码的问题，这几个原因比"升级升坏了"常见得多。