升级、备份与迁移

升级

cd assemblyai-hub
git pull                       # 更新 compose 文件和 .env.example
docker compose pull app
docker compose up -d
curl http://localhost:18080/healthz   # 确认 version 已更新

固定版本时，修改 .env 里的 HUB_IMAGE 标签后执行 docker compose up -d。

数据库表结构在启动时自动创建和补齐，无需手动迁移。升级前请阅读 更新日志，主版本号变化时可能包含不兼容的改动。

回滚

把 HUB_IMAGE 改回之前的版本标签，docker compose up -d 即可。

备份

docker compose exec -T db pg_dump -U hub hub | gzip > hub-$(date +%F).sql.gz

同时妥善保存 .env 里的 SECRET_KEY：没有它，备份里加密的上游 Key 无法解密。

恢复

gunzip -c hub-2026-10-27.sql.gz | docker compose exec -T db psql -U hub hub
docker compose restart app

迁移到新服务器

1. 在旧服务器备份数据库。
2. 在新服务器部署，.env 中使用相同的 SECRET_KEY。
3. 恢复数据库，重启 app。
4. 更新 DNS，确认 PUBLIC_BASE_URL 指向新地址。

也可以不迁移数据库，只用 AAI_ACCOUNTS 和 HUB_API_KEYS 在新环境重新导入账号和 Key（任务记录会丢失）。