安装部署
升级指南
升级 Mopheus 服务和 CLI 工具，并保留现有配置与业务数据。
本页说明已部署 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仅当服务端镜像或 CLI 实际发生变化时，升级器才会重启 Daemon；两者均未变化时会跳过重启。若需要强制重启，可添加 --restart。Cron 包装脚本固定跟踪 dev 渠道。若要定期运行，请在服务账号的 crontab 中添加：
30 10 * * * /app/mopheus/scripts/online-update-cron.sh包装脚本会写入 /app/mopheus/logs/online-update.log，日志超过 1 MiB 时会轮转旧文件。
需要先预览变更时，可以使用 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
# 升级单独安装的 admin CLI
mopheus-admin upgrade
mopheus-admin upgrade --dev
升级 CLI 后检查版本和当前配置：
mopheus version
mopheus config show升级后检查
- 使用
./mopheus.sh status确认服务正常运行。 - 使用
./mopheus.sh logs检查启动和数据库迁移日志。 - 登录 Web UI，确认工作区、工单和文件等业务数据可正常访问。
- 如果使用守护进程，执行
mopheus daemon status确认运行时已重新连接。