S-UI项目升级至v0.0.5版本时的数据库迁移问题解析

在S-UI项目从v0.0.4升级到v0.0.5版本的过程中，部分用户遇到了面板无法正常工作的错误。这一问题主要源于数据库结构的变更，需要执行特定的迁移操作才能确保数据兼容性。

问题现象

当用户通过非标准方式（如使用watchtower工具）直接更新容器镜像时，升级后的S-UI面板会出现错误提示。典型表现为面板界面无法正常加载，系统日志中可能显示数据库相关的错误信息。

问题根源

v0.0.5版本对数据库结构进行了重要调整，特别是对config、inbounds和links三个表列的数据类型进行了修改，将它们统一为TEXT类型。这种结构性变更必须通过专门的迁移脚本来完成数据转换，否则会导致新版软件无法正确读取旧版数据。

标准解决方案

官方推荐以下两种升级方式：

1. 使用项目提供的安装脚本进行升级
2. 通过s-ui命令行工具执行更新操作

这两种方式都会自动处理数据库迁移过程，确保数据结构的平滑过渡。

Docker环境下的特殊处理

对于使用Docker Compose部署的用户，需要特别注意迁移步骤：

1. 首先回退到v0.0.4版本并运行一次面板
2. 停止服务后替换为v0.0.5版本的sui可执行文件
3. 手动执行迁移命令
4. 重新启动服务

或者在docker-compose.yml中配置自动迁移：

entrypoint: "./sui migrate && ./sui"

故障恢复方案

如果已经错误升级导致问题，可以采取以下恢复措施：

1. 回退到v0.0.4版本运行一次
2. 再次升级到v0.0.5并执行迁移
3. 或者选择清空数据库重新配置（会丢失所有现有数据）

最佳实践建议

1. 对于生产环境，建议先备份数据库目录再进行升级
2. 仔细阅读版本更新说明，了解是否有数据库变更
3. 优先使用官方推荐的升级方式
4. 在Docker环境中，考虑将迁移命令永久保留在entrypoint中

通过遵循这些指导原则，可以确保S-UI项目升级过程的平稳进行，避免因数据结构变更导致的服务中断。