跳转至

备份、升级与恢复

升级原则

Sub2API 不应自动追 latest。当前生产版本应固定，升级前先备份，升级后做端到端测试。

cd /opt/sub2api
sudo docker compose ps
curl https://api.ynumerics.top/health

PostgreSQL 备份

示例：

sudo install -d -m 700 /opt/sub2api-backups
sudo docker exec sub2api-postgres \
  sh -lc 'pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Fc' \
  | sudo tee /opt/sub2api-backups/sub2api-db-$(date +%F-%H%M%S).dump >/dev/null

同时备份 .env 和 docker-compose.yml，但这些文件含敏感配置，只能放在受控位置。

升级流程

  1. 数据库与配置备份；
  2. 记录当前镜像版本；
  3. 拉取目标固定版本；
  4. docker compose up -d；
  5. 检查三个容器 healthy；
  6. 测试 /health；
  7. 测试 Flash Responses（Agent）和 Pro Chat Completions（Chat only）；
  8. 测试普通用户订阅扣费；
  9. 测试 Codex 文件操作；
  10. 确认使用记录费用非 0。

HTTPS 证书

sudo certbot certificates
sudo certbot renew --dry-run

api.ynumerics.top 和 docs.ynumerics.top 都应在自动续期体系内。