SubBoost

外观

更新维护 ​

更新前备份数据库和 .env，并定期保留可用备份。

状态 ​

一键部署：

bash
subboost status
subboost doctor

高级部署在 local 目录运行：

bash
docker compose ps

检查 /api/health/ready。

备份 ​

一键部署：

bash
subboost backup

备份内容包含数据库和 .env。两者要放在安全位置。

高级部署在 local 目录运行：

bash
docker compose exec db sh -c 'pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" --format=custom --compress=6 -f /tmp/subboost-backup.pgdump'
docker compose exec db sh -c 'pg_restore --list /tmp/subboost-backup.pgdump >/dev/null'
docker compose cp db:/tmp/subboost-backup.pgdump ./subboost-backup.pgdump
docker compose exec db rm -f /tmp/subboost-backup.pgdump
cp .env subboost-env.backup

保存 subboost-backup.pgdump 和 subboost-env.backup。

更新 ​

一键部署：

bash
subboost update
subboost doctor

如果页面异常，先看日志：

bash
subboost logs

高级部署在 local 目录运行：

bash
git pull --ff-only
docker compose up -d --build

恢复 ​

恢复顺序：

  1. 停止服务。
  2. 恢复同一份 .env。
  3. 恢复 PostgreSQL 数据库。
  4. 启动服务。
  5. 打开 /api/health/ready。
  6. 登录管理员账号，刷新一个订阅。

高级部署示例：

bash
docker compose stop app cron
cp subboost-env.backup .env
docker compose up -d db
docker compose cp ./subboost-backup.pgdump db:/tmp/subboost-backup.pgdump
docker compose exec db sh -c 'pg_restore --list /tmp/subboost-backup.pgdump >/dev/null'
docker compose exec db sh -c 'pg_restore -U "$POSTGRES_USER" -d "$POSTGRES_DB" --clean --if-exists --no-owner --no-acl /tmp/subboost-backup.pgdump'
docker compose exec db rm -f /tmp/subboost-backup.pgdump
docker compose up -d --build

健康检查 ​

地址用途
/api/health/live服务进程是否响应。
/api/health/ready数据库等依赖是否就绪。

如果 ready 失败，优先检查 .env、数据库容器、数据库密码和 DATABASE_URL。

Copyright © 2026 SubBoost