termi-blog/deploy/systemd/GO_LIVE_CHECKLIST.md

通知 / digest / systemd 最终上线清单

这份清单按“上线前 -> 首次启动 -> 验证 -> 定时任务”来执行。

A. 上线前参数确认

1. backend / compose

确认 deploy/docker/config.yaml 至少已经填写：

• compose_env.DATABASE_URL
• compose_env.REDIS_URL
• compose_env.JWT_SECRET
• compose_env.APP_BASE_URL
• compose_env.PUBLIC_API_BASE_URL
• compose_env.ADMIN_API_BASE_URL
• compose_env.ADMIN_FRONTEND_BASE_URL
• compose_env.TERMI_ADMIN_TRUST_PROXY_AUTH=true
• compose_env.TERMI_ADMIN_LOCAL_LOGIN_ENABLED=false
• compose_env.TERMI_ADMIN_PROXY_SHARED_SECRET

2. SMTP

订阅 double opt-in 和邮件通知需要：

• compose_env.SMTP_ENABLE=true
• compose_env.SMTP_HOST
• compose_env.SMTP_PORT
• compose_env.SMTP_SECURE
• compose_env.SMTP_USER
• compose_env.SMTP_PASSWORD
• compose_env.SMTP_HELLO_NAME

3. Caddy / TinyAuth / Pocket ID

确认宿主机 Caddy 已经：

• blog.init.cool -> 127.0.0.1:4321
• admin.blog.init.cool -> 127.0.0.1:4322
• admin.blog.init.cool/api/* -> 127.0.0.1:5150
• admin.blog.init.cool 整体挂了 import tinyauth
• /api/* 转发时附带：
  • X-Termi-Proxy-Secret: {$TERMI_ADMIN_PROXY_SHARED_SECRET}

可直接参考：

• deploy/caddy/Caddyfile.tohka.production.example

B. 首次启动

推荐命令：

python deploy/scripts/render_compose_env.py \
  --input deploy/docker/config.yaml \
  --output deploy/docker/.env

docker compose \
  -f deploy/docker/compose.package.yml \
  -f deploy/docker/compose.tohka.override.yml \
  --env-file deploy/docker/.env up -d

然后确认容器状态：

docker compose \
  -f deploy/docker/compose.package.yml \
  -f deploy/docker/compose.tohka.override.yml \
  --env-file deploy/docker/.env ps

应该至少看到：

• backend
• backend-worker
• frontend
• admin

C. 首次验证

1. 健康检查

curl -I http://127.0.0.1:5150/healthz
curl -I http://127.0.0.1:4321/healthz
curl -I http://127.0.0.1:4322/healthz

2. 后台 SSO

打开：

• https://admin.blog.init.cool

确认：

• 可以被 TinyAuth / Pocket ID 正常拦截与登录
• 登录后后台可进入
• 会话信息显示为代理登录（不是本地账号密码）

3. 订阅链路

至少做一次：

1. 前台提交邮箱订阅
2. 收到确认邮件
3. 点击确认链接
4. 能打开偏好页
5. 偏好页可暂停 / 恢复 / 退订

4. ntfy / webhook / digest

后台里至少验证一次：

• 手动发送测试通知
• 手动发送周报
• 手动发送月报
• 查看 delivery 是否从 queued 变成 sent

如果 delivery 一直卡在 queued：

• 优先检查 backend-worker 是否在运行
• 检查 REDIS_URL
• 检查 SMTP / ntfy / webhook 目标

D. 安装 systemd timers

sudo cp deploy/systemd/*.service /etc/systemd/system/
sudo cp deploy/systemd/*.timer /etc/systemd/system/
sudo systemctl daemon-reload

启用：

sudo systemctl enable --now termi-retry-deliveries.timer
sudo systemctl enable --now termi-weekly-digest.timer
sudo systemctl enable --now termi-monthly-digest.timer
sudo systemctl enable --now termi-backup-all.timer
sudo systemctl enable --now termi-backup-prune.timer
sudo systemctl enable --now termi-backup-offsite-sync.timer

查看状态：

systemctl list-timers --all | grep termi

E. 当前默认调度时间

通知 / digest

• termi-retry-deliveries.timer
  • 每 5 分钟执行一次
• termi-weekly-digest.timer
  • 每周一 09:00
• termi-monthly-digest.timer
  • 每月 1 日 09:30

备份

• termi-backup-all.timer
  • 每天 03:10
• termi-backup-prune.timer
  • 每天 04:15
• termi-backup-offsite-sync.timer
  • 每天 04:40

如果时区不是你们想要的，改 .timer 里的 OnCalendar= 后重新：

sudo systemctl daemon-reload
sudo systemctl restart termi-retry-deliveries.timer
sudo systemctl restart termi-weekly-digest.timer
sudo systemctl restart termi-monthly-digest.timer
sudo systemctl restart termi-backup-all.timer
sudo systemctl restart termi-backup-prune.timer
sudo systemctl restart termi-backup-offsite-sync.timer

F. 上线后一周内建议额外确认

• 有真实订阅确认邮件成功送达
• 有真实 ntfy / webhook 通知成功送达
• 至少有一条 digest 成功发出
• retry timer 能把失败投递重新入队
• 备份目录持续产生新文件
• prune 正常清理旧备份
• offsite sync 确实有异地副本
• 至少做过一次恢复演练