zqlit
5f27ad321d
用户定案：「辅助仓就用 openlist，其他不再考虑」。
据此把前一轮为 Gitee 铺的路全部收回，git 远端只剩 CNB 一个。
一、git 配置收口
- `pushall` 别名 `origin + gitee` → `!git push origin main`（只推唯一远端）
- 移除 `gitea` remote（自建 23.254.236.47:3001）—— 远端仓库本身没删，
需要时可 `git remote add` 恢复；改动前配置存
`.workbuddy-backup/git-remotes.20261006-211516.txt`
- 确认无 gitee 相关 credential 残留
二、发布链路去 Gitee 化（6 处）
- `deploy/editor-api/bootstrap.sh`
· 删掉 GITEE_URL / GITEE_SSH_KEY 两个变量与「没给私钥就降级」的分支
· PUSH_REMOTES 默认 → origin
· 原「配 gitee 辅仓远端」一节改为「清理退役远端」循环（gh/gitee/gitea），
让从旧部署续用的工作区自动恢复干净
- `docker-compose.editor.yml`、`editor-api/server.mjs` → 默认值 origin
- `editor-api/README.md` → 变量表同步
- `editor-api/Dockerfile` → 注释里的「CNB / GitHub」改「CNB」
- `blog-admin/src/routes/rss/tools.ts` → deploy-notify 的注释里
「与 Gitea Actions 的构建通知配套」改为中性描述
（该轮询链路 2026-10-04 起已被 CNB 国内节点直传取代）
三、`scripts/setup-cnb-remotes.sh` 重写为单远端模式
- 去掉 GITEE_URL / GITEE_TOKEN 参数、校验、凭据写入与自检提示
- 新增「清理退役远端」步骤
- 凭据处理改为「已存在空的 credential.helper 就不再添加」，
不再用 --replace-all —— 本仓另有一个从 `$HOME/.workbuddy/secrets/cnb-token`
读令牌的自定义 helper，那是有效的，不能被脚本抹掉
四、备份升级为「唯一辅仓」的配置
- 保留份数 3 → 7（一周窗口；每份 605.5 MB ≈ 4.2 GB，F50 有 256 GB）
· `scripts/backup-task.cmd` 默认参数 --keep 7
· `scripts/backup-bundle.mjs` 的 KEEP 默认值同步为 7
（原先写的是 2，一直被命令行参数掩盖着）
- 远端目录 `/本地/备份` → `/本地/备份/blog-bundle`：
根目录是用户自己在用的（放着 github-zqlit-*、local-repos-* 等手工备份），
实测发现直接放根下的 bundle 已被清掉 —— 改子目录隔离，避免混放与误删
五、新增 `scripts/backup-run.mjs`：备份的推荐入口 + 失败告警
- 读 `.workbuddy-backup/openlist-backup.env`（只补空缺，环境变量优先）
- 跑 backup-bundle.mjs 并实时透传输出，同时留一份日志尾部
- 退出码非 0 → 经 `scripts/send_mail.js` 发告警邮件（附日志尾部与常见原因）；
成功默认不发，`--notify-success` 才发
- 退出用 `process.exitCode` 而非 `process.exit()`，避免截断未排干的 stdout
- 发信失败不改判备份退出码 —— 通知不该掩盖真正的故障
- 理由：这是当前**唯一**的异地备份，而「每天自动跑」的任务最典型的失败模式
恰恰是静默的（F50 被带出门、换了网段、OpenList 没起来、口令改过……），
没有告警就要等到真要用备份那天才发现
- `scripts/backup-task.cmd` 改调它
六、文档
- `架构总览.md`
· §1.2 地址地图：备份行改指 F50/OpenList；通知行补「兼做备份失败告警」
· §2 旅程图：双推改单推，并说明备份换了介质
· §5.1 / §5.2 推送与远端：只剩 origin；补「已移除远端」表与恢复命令；
GitHub 退役记录保留并补上「CI 定义也已删除」
· §5.3 由「辅仓选型」改为「异地备份的定案」—— 明确不走 git 远端；
平台对比数据保留备查，并注明 `bin/linux/hugo` 出库不必再做了
· §5.6 补「唯一备份」定位、专属子目录、失败告警、keep 7、SMTP 配置键，
实测数据更新为本次复测值
· §6 待办：#2 定案、#3 不必做、#4 已移除、#8 已更新、#10 定位升级，
新增 #11（F50 目录使用约定）
- `CNB构建落地方案.md` §4.0：双远端改单远端，脚本示例去掉 Gitee 参数
- `README.md`：推送说明改单推；脚本表补 backup-run.mjs
实测（2026-10-06，本轮复测）：
bundle 7.4s / AES-256-GCM 加密 1.3s / 上传 19.2s（31.6 MB/s）
/ 读回 sha256 一致 → 端到端 60.6s，退出码 0
告警邮件链路已实测（发出一封「备份成功」验证信）
★ 一处过程记录，供以后避免重复踩坑：
中途我把「本机沙箱里 `env -u ... cmd > file` 会让输出整个消失」
误判成 process.exit 截断 stdout，并据此改了日志实现；
随后用 `env -u FOO echo hi > file`（同样零输出）证伪 ——
那是沙箱文件重定向的伪影，与脚本无关。相关改动已回滚，
只留下本身无害的 process.exitCode 写法。
53 lines
2.3 KiB
YAML
53 lines
2.3 KiB
YAML
# editor-api —— 在线编辑文章的轻量后端
|
||
#
|
||
# 用法（在服务器上）：
|
||
# 1. 把博客仓库 checkout 到 /srv/blog（git 工作区，分支 main）
|
||
# 2. 在同目录放一个 .env，写入 EDITOR_TOKEN=openssl rand -hex 32 生成的值
|
||
# 3. docker compose -f docker-compose.editor.yml up -d --build
|
||
# （回收目录会落在 /srv/editor-trash，记得先 mkdir -p /srv/editor-trash）
|
||
# 4. nginx 加 /editor-api/ 反代（见 部署清单.md），Worker 配 EDITOR_API_BASE / EDITOR_TOKEN
|
||
#
|
||
# ★ 端口只绑 127.0.0.1 —— 公网扫不到 8017，只有同机的 nginx 能转发进来。
|
||
# 这是整个安全模型的一半；另一半是「令牌只存在 Worker secret 里，浏览器拿不到」。
|
||
|
||
services:
|
||
editor-api:
|
||
build: ./editor-api
|
||
container_name: editor-api
|
||
restart: unless-stopped
|
||
ports:
|
||
- "127.0.0.1:8017:8017"
|
||
environment:
|
||
# 令牌：必须显式给，没给容器会直接退出（server.mjs 里故意的）
|
||
EDITOR_TOKEN: ${EDITOR_TOKEN:?请在同目录 .env 里设置 EDITOR_TOKEN}
|
||
BLOG_ROOT: /srv/blog
|
||
# ★ 回收站与仓库必须在**同一个挂载点**内，否则 rename 会 EXDEV
|
||
# （见下方 volumes 注释）。所以这里用宿主机路径，不再映射到 /app/trash。
|
||
TRASH_DIR: /srv/editor-trash
|
||
# 容器内监听 0.0.0.0 没关系 —— 外面那层端口映射已经把它锁在宿主机回环上了
|
||
BIND_HOST: 0.0.0.0
|
||
GIT_BRANCH: main
|
||
PUSH_REMOTES: origin
|
||
GIT_AUTHOR_NAME: blog-editor
|
||
GIT_AUTHOR_EMAIL: editor@usj.cc
|
||
MAX_UPLOAD_MB: "20"
|
||
GIT_PATHS: content,static
|
||
volumes:
|
||
# ★ 只挂**一个**父目录：仓库和回收站都在它下面。
|
||
# 容器内路径 == 宿主机路径，两者同属一个挂载点，
|
||
# 删文章时 rename(2) 才能原子完成。
|
||
# 若分开挂成 /blog 和 /app/trash 两个 bind mount，rename 必报
|
||
# EXDEV: cross-device link not permitted（哪怕宿主机同一块盘）。
|
||
- /srv:/srv
|
||
healthcheck:
|
||
test: ["CMD", "node", "-e", "fetch('http://127.0.0.1:8017/health').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"]
|
||
interval: 30s
|
||
timeout: 5s
|
||
retries: 3
|
||
start_period: 10s
|
||
logging:
|
||
driver: json-file
|
||
options:
|
||
max-size: "10m"
|
||
max-file: "3"
|