运维、升级、备份与恢复手册

更新时间：2026-08-21 11:55:33 阅读：31 收藏：0 收藏
# 运维、升级、备份与恢复手册

> **读者**：客户侧运维。  
> **先认拓扑**：Docker Compose 与裸机是两套脚本，**不可混用**。  
> 若你使用的是产品页下载的 Windows/Linux **安装包**，请只用下文「裸机」章节。

| 拓扑 | 备份 | 恢复 | 升级 |
|------|------|------|------|
| Docker Compose（厂商交付的 Compose 环境） | `deploy/scripts/backup.ps1` | `deploy/scripts/restore.ps1` | `deploy/scripts/upgrade.ps1` |
| 裸机 Win/Linux（安装包） | `backup-bare-metal.ps1` / `.sh` | `restore-bare-metal.ps1` / `.sh` | 管理端「升级并重启」或换官方升级包（**不要**跑 `upgrade.ps1`） |

## 日常检查

每天关注管理端「部署与运行状态」、任务失败率、client 是否在线、许可证是否有效。排障时尽量提供：时间、Job ID、步骤日志、是否刚升级或改过 Provider。

## 备份（裸机 · 安装包用户请用这节）

覆盖：数据库 + 本地素材目录 + 配置 + 许可证相关文件。归档会加密，请单独保管 `BACKUP_ENCRYPTION_PASSWORD`。

```powershell
# Windows（安装根以实际为准，常见 D:\go-ai）
$env:BACKUP_ENCRYPTION_PASSWORD = '至少16位强密码'
pwsh ./deploy/scripts/backup-bare-metal.ps1 -InstallRoot 'D:\go-ai'
```

```bash
# Linux
export BACKUP_ENCRYPTION_PASSWORD='至少16位强密码'
sudo -E ./deploy/scripts/backup-bare-metal.sh --install-root /opt/go-ai
```

建议异地再留一份；定期做一次恢复演练，未演练的备份不算有效。

## 恢复（裸机）

恢复会覆盖库与素材，确认目标环境无误后再执行，并加强制参数：

```powershell
pwsh ./deploy/scripts/restore-bare-metal.ps1 -InstallRoot 'D:\go-ai' `
  -BackupFile 'D:\go-ai\backups\bare-metal-YYYYMMDD-HHMMSS.tar.gz.enc' -Force
```

```bash
sudo -E ./deploy/scripts/restore-bare-metal.sh --install-root /opt/go-ai \
  --backup-file /opt/go-ai/backups/bare-metal-YYYYMMDD-HHMMSS.tar.gz.enc --force
```

## 升级（裸机 · 管理端 OTA）

适用：产品页 / 厂商通道下发的 **server zip**（含二进制、`public/{h5,admin}`、migrations）。**Docker 环境不要用本节**，改用文末 Compose 升级脚本。

1. **先备份**（见上节）。
2. 登录管理端，打开 **系统配置 → 部署与运行状态**（或运维相关页）。
3. 点击 **「检查更新」**，确认当前版本与最新版本、是否「需要更新」。
4. 仅当提示需要更新时，会出现 **「升级并重启」**：
   - 确认后，系统下载 zip（二进制 + C 端 + 管理端 + migrations），覆盖本地文件，并以约定退出码退出；
   - Windows 服务（NSSM）或 Linux `systemd` / 前台脚本会自动拉起新进程。
5. 升级完成后再次打开「部署与运行状态」，确认版本号与健康检查；抽测管理端与一条最小任务。

注意：

- 「升级并重启」**只在检测到有可用更新时显示**；没有按钮通常表示已是最新或未检查到更新通道。
- 升级不应覆盖你的域名、品牌、Provider 密钥与许可证文件；若异常中断，用备份恢复后再联系支持。
- Client 二进制若需单独升级，可在管理端客户端列表使用「检查并升级二进制」（以页面文案为准）。

也可由厂商提供升级包后，按交付说明手工覆盖安装目录中的程序文件并重启服务——效果与 OTA 类似，仍须先备份。

## 备份 / 升级 / 恢复（Docker Compose）

仅当你的环境是厂商按 Compose 交付时使用：

```powershell
pwsh ./deploy/scripts/backup.ps1 -EnvFile ./deploy/.env.production -OutputDir /srv/ai-platform/backups
pwsh ./deploy/scripts/upgrade.ps1 -Version <版本> -ManifestFile ./deploy/release-manifest.json -EnvFile ./deploy/.env.production
pwsh ./deploy/scripts/restore.ps1 -BackupFile <加密备份路径> -EnvFile ./deploy/.env.production -Force
```

升级不会也不应覆盖你的域名、品牌、Provider 密钥与许可证文件；若脚本提示密钥不一致，先按提示处理后再恢复。

## 提交问题前

请参阅 [问题采集清单](/doc-10)，勿在工单中粘贴明文密钥。

相关文档：

- [授权激活说明](/doc-7)
- [官方资源库导入](/doc-11)
评论区
