feat(远端): 恢复自建 Gitea 代码辅仓,OpenList 降为备选备份

用户定案:「自建 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 均通过
This commit is contained in:
zqlit committed 2026-10-06 21:42:08 +08:00
1 parent 5f27ad321d
commit 448b898e40
10 files changed
+221 -109

No files matched your search

+48 -16
View File
@@ -20,23 +20,30 @@
#
# 可选环境变量(都有默认值):
# CNB_URL 默认 https://cnb.cool/zqlit/blog.git
# GITEA_URL 默认 http://23.254.236.47:3001/zqlit/blog.git(自建 Gitea 辅仓)
# GITEA_USER 默认 zqlit
# GITEA_PASS 可选:Gitea 的密码 / 访问令牌。**给了才会把 gitea 加进推送远端**,
# 否则 PUSH_REMOTES 自动降级成只推 origin(CNB 主仓)
# BLOG_DIR /srv/blog 仓库工作区
# APP_DIR /srv/editor-api compose + .env
# TRASH_DIR /srv/editor-trash 删除文章的回收目录(故意放在仓库外)
# BIND_PORT 8017 只绑 127.0.0.1
# PUSH_REMOTES origin 发布时依次推送的远端(默认只有 CNB 主仓)
# PUSH_REMOTES origin,gitea 发布时依次推送的远端
# GIT_AUTHOR_NAME / GIT_AUTHOR_EMAIL / BLOG_BASE
#
# ★ 2026-10-06(定案):**异地备份不再走 git 远端**。
# - GitHub(GH_URL / GH_SSH_KEY / remote `gh`):账号被平台标记,仓库被按
# AUP 清空 → 已从本脚本与整个链路移除
# ★ 远端与备份定案(2026-10-06):
# - CNB(remote `origin`):**主仓**,唯一的 fetch 源,推送即触发 CNB 构建
# - 自建 Gitea(remote `gitea`,23.254.236.47:3001):**代码同步辅仓**,
# 只作代码留档与找回,不参与构建(.github/ 已删,Actions 早已停用)
# - GitHub(GH_URL / GH_SSH_KEY / remote `gh`):账号被平台标记、仓库被按
# AUP 清空 → 已彻底移除,别再往回加
# - Gitee:单仓 500MB / 单文件 50MB 两道硬门槛,本仓 `bin/linux/hugo`
# 是 83.1MB → 未采用
# - 自建 Gitea:已从远端列表移除
# 现行备份 = CNB 主仓 + OpenList 上的加密 bundle(scripts/backup-bundle.mjs,
# 由 Windows 计划任务 Blog-BundleBackup 每天 03:30 跑)。
# 所以 PUSH_REMOTES 默认只有 origin;将来若要再加辅仓,设
# PUSH_REMOTES=origin,<名字> 并在下面「远端配置」一节补上对应 remote。
# - OpenList(中兴 F50 上的加密 bundle,scripts/backup-bundle.mjs,
# Windows 计划任务 Blog-BundleBackup 每天 03:30):**备选异地备份**,
# 与 git 远端无关,独立于上面三者
# 推送语义见 editor-api/src/git.mjs:逐个远端推、**主仓成功即算发布成功**,
# 辅仓失败只警告不阻断 —— 所以 gitea 挂了不会让文章发不出去。
# =====================================================================
set -euo pipefail
@@ -48,6 +55,8 @@ die() { printf '\033[1;31m!! %s\033[0m\n' "$*" >&2; exit 1; }
: "${ADMIN_PASS:?必须设置 ADMIN_PASS(后台登录密码,账号固定 admin)}"
CNB_URL="${CNB_URL:-https://cnb.cool/zqlit/blog.git}"
GITEA_URL="${GITEA_URL:-http://23.254.236.47:3001/zqlit/blog.git}"
GITEA_USER="${GITEA_USER:-zqlit}"
BLOG_DIR="${BLOG_DIR:-/srv/blog}"
APP_DIR="${APP_DIR:-/srv/editor-api}"
TRASH_DIR="${TRASH_DIR:-/srv/editor-trash}"
@@ -55,7 +64,15 @@ BIND_PORT="${BIND_PORT:-8017}"
GIT_AUTHOR_NAME="${GIT_AUTHOR_NAME:-blog-editor}"
GIT_AUTHOR_EMAIL="${GIT_AUTHOR_EMAIL:-editor@usj.cc}"
BLOG_BASE="${BLOG_BASE:-}"
PUSH_REMOTES="${PUSH_REMOTES:-origin}"
PUSH_REMOTES="${PUSH_REMOTES:-origin,gitea}"
# 没给 Gitea 凭据就只推主仓 —— 宁可少推一个辅仓,
# 也不要让每次发布都对着一个认证不过的远端空转一遍。
# (这里是有意直接覆盖成 origin:默认列表就是 origin,gitea,
# 没有 gitea 凭据等于只剩 origin;要推别的远端请连同 gitea 一起显式写全。)
if [ -z "${GITEA_PASS:-}" ]; then
PUSH_REMOTES="origin"
fi
command -v docker >/dev/null || die "没有 docker"
docker compose version >/dev/null 2>&1 || die "没有 docker compose"
@@ -78,11 +95,22 @@ else
git clone --branch main "$AUTH_URL" "$BLOG_DIR"
fi
# 退役的远端:以前这一节会配 GitHub / Gitee 辅仓。2026-10-06 起异地备份改走
# OpenList 上的加密 bundle(与 git 远端无关),所以 git 远端只留 CNB 主仓。
# 若这份工作区是从旧部署续用的,顺手把残留的退役远端清掉,
# 免得 `git pushall` 或后端按 PUSH_REMOTES 推送时撞上已失效的远端。
for _retired_remote in gh gitee gitea; do
# 自建 Gitea 辅仓:只有给了 GITEA_PASS 才配(没给就只推 origin,见上面 PUSH_REMOTES 降级)。
# 凭据直接编进远端 URL —— 容器里没有交互终端、也没有 credential helper,
# 这是唯一能让 `git push gitea` 免交互跑通的写法。
# 明文只落在 $APP_DIR/.env 与容器内的 .git/config,不会进仓库。
if [ -n "${GITEA_PASS:-}" ]; then
_gitea_auth="$(printf '%s' "$GITEA_URL" | sed -E "s#^(https?://)#\1${GITEA_USER}:${GITEA_PASS}@#")"
git -C "$BLOG_DIR" remote remove gitea 2>/dev/null || true
git -C "$BLOG_DIR" remote add gitea "$_gitea_auth"
unset _gitea_auth
fi
# 退役的远端:以前这一节会配 GitHub / Gitee 辅仓,两者都已退役
# (GitHub 被平台按 AUP 清空、Gitee 卡体积门槛)。若这份工作区是从旧部署续用的,
# 顺手把残留的退役远端清掉,免得后端按 PUSH_REMOTES 推送时撞上已失效的远端。
# ★ gitea **不在**退役名单里 —— 它是现行辅仓,别跟着一起清掉。
for _retired_remote in gh gitee; do
git -C "$BLOG_DIR" remote remove "$_retired_remote" 2>/dev/null || true
done
@@ -142,7 +170,7 @@ services:
TRASH_DIR: $TRASH_IN_CT
BIND_HOST: 0.0.0.0
GIT_BRANCH: main
PUSH_REMOTES: \${PUSH_REMOTES:-origin}
PUSH_REMOTES: \${PUSH_REMOTES:-origin,gitea}
GIT_AUTHOR_NAME: \${GIT_AUTHOR_NAME:-blog-editor}
GIT_AUTHOR_EMAIL: \${GIT_AUTHOR_EMAIL:-editor@usj.cc}
BLOG_BASE: \${BLOG_BASE:-}
@@ -176,6 +204,10 @@ for i in $(seq 1 30); do
echo " · 宿主机 nginx(1Panel 站点)加反代:location ^~ / { proxy_pass http://127.0.0.1:$BIND_PORT; ... }"
echo " · Cloudflare Worker 变量:EDITOR_API_BASE=https://<指向本机的域名> EDITOR_TOKEN=$EDITOR_TOKEN"
echo " · 推送远端:PUSH_REMOTES=$PUSH_REMOTES"
if [ -z "${GITEA_PASS:-}" ]; then
echo " · 未提供 GITEA_PASS → 本次只推 origin,Gitea 辅仓未启用"
echo " (要启用:GITEA_PASS='<Gitea 密码或令牌>' 重跑本脚本)"
fi
exit 0
fi
sleep 2