zqlit
448b898e40
用户定案：「自建 gitea 同步一下吧，openlist 也作为备选备份」。
于是把上一轮「撤销全部 git 辅仓」的决定部分回退：在线那一路回到自建 Gitea，
OpenList 上的加密 bundle 从「唯一异地备份」改为「备选异地备份」。
两层不是重复，而是失效模式不同：
· 自建 Gitea（在线、可增量、可浏览）—— 不受任何第三方平台规则约束
· 离线 bundle（离线、单一文件、完整历史）—— 平台全挂也能恢复
一、实际同步
- Gitea 位于 23.254.236.47:3001（Gitea 28.0.0），本机直连即可推，
**不需要广州中转机**（旧结论「沙箱跑不通 git smart HTTP」只针对当时的代理）
- 远端停在 ed38f938（2026-10-04），落后 57 个提交，且是本地 HEAD 的**祖先**
→ 一次 fast-forward 追平，**未强推、未丢历史**
- 同步后 origin 与 gitea 均指向 5f27ad32
二、git 配置
- 恢复 remote `gitea`（凭据编在 URL 里，只落本机 .git/config，不入库）
- `pushall` 回到双推：
!git push origin main; ec=$?; git remote | grep -qx gitea && git push gitea main; exit $ec
· 用 `;` 而非 `&&` → 主仓挂了辅仓照样推
· `exit $ec` → 退出码仍以主仓为准，辅仓成功不掩盖主仓失败
· gitea 段带存在性前置判断 → 没配辅仓时静默跳过，不白报错
三、发布链路恢复 gitea（前一轮刚去掉，现按新定案加回）
- `deploy/editor-api/bootstrap.sh`
· 新增 GITEA_URL / GITEA_USER / GITEA_PASS（凭据必须现给，不写死在脚本里）
· PUSH_REMOTES 默认 → origin,gitea；没给 GITEA_PASS 则降级为 origin
· 恢复「配 gitea 远端」一节；退役远端名单去掉 gitea（只留 gh / gitee）
—— 否则新部署会把现行辅仓当成退役远端清掉
· 结尾补一句「未启用 Gitea 辅仓」的提示
- `docker-compose.editor.yml`、`editor-api/server.mjs` → 默认 origin,gitea
- `editor-api/README.md` → 变量表同步；`editor-api/Dockerfile` → 注释补 http 情形
四、`scripts/setup-cnb-remotes.sh` 改回双远端模式
- 头部沿革、USAGE、凭据段全部重写；GITEA_PASS 走环境变量，不入库
- 退役远端循环只清 gh / gitee；pushall 写同一份定义
五、文档
- `架构总览.md`：§1.2 地址地图加「代码辅仓」行、备份行降为「备选」；
§2 旅程图改双推；§5.1 推送重写（含别名实际定义与三条取舍）；
§5.2 远端改双行表 + Gitea 接入细节；§5.3 由「不走 git 远端」改为
「远端与备份的分工」（三层各自的失效模式）；§5.6 定位改备选；
§6 待办 #2/#4/#7/#10 更新
- `CNB构建落地方案.md` §4.0 目标形态与定案块、§4.1 第 4 条
- `README.md` 发布流程图、推送说明、脚本表
- `scripts/backup-run.mjs` 头部注释：不再是「唯一备份」
实测：
git push gitea main → ed38f938..5f27ad32 main -> main
git pushall → origin / gitea 双向同步，退出码 0
bash -n 校验 bootstrap.sh 与 setup-cnb-remotes.sh 均通过
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,gitea
|
||
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"
|