升级指南

本页说明已部署 Mopheus 实例的升级方法。升级前确认当前安装目录、备份策略和目标版本，并确保升级过程中没有正在执行的维护操作。

在线升级服务

进入现有安装目录，先检查当前版本和远程版本：

cd /app/mopheus
./mopheus.sh online-version

确认版本后执行升级：

# 自动检测版本并升级到最新稳定版本
./mopheus.sh online-update

# 使用 dev 渠道
./mopheus.sh online-update --dev

# 指定目标版本
./mopheus.sh online-update --tag v1.2.3

需要先预览变更时，可以使用 dry run：

./mopheus.sh online-update --dry-run

升级完成后检查服务状态和日志：

./mopheus.sh status
./mopheus.sh ps
./mopheus.sh logs

离线升级服务

将目标版本的离线安装包上传到服务器，在现有安装目录执行：

cd /app/mopheus
./mopheus.sh update-offline /tmp/mopheus-install-<new-version>-linux-<arch>.tar.gz

如果需要同时强制重装安装包中的 CLI 工具：

./mopheus.sh update-offline \
  /tmp/mopheus-install-<new-version>-linux-<arch>.tar.gz \
  --reinstall

改名前版本的首次升级

从产品改名前安装的实例首次升级时，使用新安装包中的引导脚本：

cd /path/to/existing-installation
mkdir -p /tmp/mopheus-upgrade
tar -zxvf /tmp/mopheus-install-<new-version>-linux-<arch>.tar.gz \
  -C /tmp/mopheus-upgrade
/tmp/mopheus-upgrade/upgrade-offline.sh --install-dir "$PWD" \
  /tmp/mopheus-install-<new-version>-linux-<arch>.tar.gz

重要： 不要在产品改名前的安装目录中执行 setup.sh update-offline。旧升级脚本只识别旧安装包结构，无法安装新的迁移逻辑。

升级修改文件前会创建配置快照：backups/<旧版本>-<日期时间>/。快照包含 .env、当前 docker-compose.yml、nginx/ 和 newapi/。应用数据保留在 data/ 中，升级不会复制或删除这些数据。

升级 CLI

# 升级到最新稳定版本
mopheus upgrade

# 升级到最新开发版本
mopheus upgrade --dev

# 安装指定版本
mopheus upgrade --version v1.1.0

升级 CLI 后检查版本和当前配置：

mopheus version
mopheus config show

升级后检查

使用 ./mopheus.sh status 确认服务正常运行。
使用 ./mopheus.sh logs 检查启动和数据库迁移日志。
登录 Web UI，确认工作区、工单和文件等业务数据可正常访问。
如果使用守护进程，执行 mopheus daemon status 确认运行时已重新连接。