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
1 parent
5f27ad321d
commit
448b898e40
10 files changed
+221
-109
No files matched your search
@@ -1,6 +1,6 @@
|
||||
#!/usr/bin/env bash
|
||||
# =====================================================================
|
||||
# 配置 git 远端 —— 本项目只有 CNB 一个远端
|
||||
# 配置 git 远端 —— CNB 主仓 + 自建 Gitea 代码同步辅仓
|
||||
# =====================================================================
|
||||
# 历史沿革：
|
||||
# 2026-10-04 从「GitHub + 自建 Gitea 双推」切到「CNB 主 + GitHub 备份」
|
||||
@@ -8,16 +8,18 @@
|
||||
# 2026-10-06 一度改为「CNB 主 + Gitee 辅」，但 Gitee 免费版卡在
|
||||
# 单仓 500MB / 单文件 50MB 两道硬门槛（本仓 bin/linux/hugo 83.1MB），
|
||||
# 云效 Codeup 虽宽松却同属国内大区 —— 多一层同类平台不如换一类介质
|
||||
# ★ 定案：**异地备份不走 git 远端**。
|
||||
# 备份 = 整仓 bundle + AES-256-GCM 加密 → 中兴 F50 上的 OpenList
|
||||
# （scripts/backup-bundle.mjs，计划任务 Blog-BundleBackup 每天 03:30）
|
||||
# 故 git 远端只剩 CNB origin，pushall 也只推 origin。
|
||||
# 2026-10-06 一度定案「远端只剩 CNB，异地备份改走 OpenList 加密 bundle」
|
||||
# ★ 2026-10-06 现行：**CNB 主仓 + 自建 Gitea 辅仓**，OpenList 上的加密
|
||||
# bundle 退为**备选备份**。两层性质不同、互为补充：
|
||||
# · git 辅仓 保「随时能 clone 回来、能按提交追溯」
|
||||
# · 离线 bundle 保「平台全挂/账号被封时仍有一份完整历史」
|
||||
# （整仓 + AES-256-GCM → 中兴 F50 上的 OpenList，
|
||||
# scripts/backup-bundle.mjs，计划任务 Blog-BundleBackup 每天 03:30）
|
||||
#
|
||||
# 为什么当初不用「一个 remote 挂多个 pushurl」：
|
||||
# 为什么不用「一个 remote 挂多个 pushurl」：
|
||||
# 实测（2026-10-04）git 对多个 pushurl 是「顺序推、遇错即停」——
|
||||
# 第一个失败，后面的远端一个都不会推，那就失去备份意义了。
|
||||
# 所以真要加辅仓，得用「独立 remote + 别名」而不是 pushurl。
|
||||
# （现行方案连这个都不需要了 —— 备份已经换介质。）
|
||||
# 所以用「独立 remote + 别名」而不是 pushurl。
|
||||
#
|
||||
# 用法：
|
||||
# bash scripts/setup-cnb-remotes.sh <CNB_URL>
|
||||
@@ -28,6 +30,11 @@
|
||||
# 附带令牌（直接写进 Windows 凭据管理器，以后不再输）：
|
||||
# CNB_TOKEN='你的令牌' bash scripts/setup-cnb-remotes.sh https://cnb.cool/zqlit/blog
|
||||
#
|
||||
# Gitea 辅仓默认按内置地址配，但**凭据必须现给**（不写进本文件）：
|
||||
# GITEA_PASS='Gitea 密码或访问令牌' \
|
||||
# bash scripts/setup-cnb-remotes.sh https://cnb.cool/zqlit/blog
|
||||
# 要换地址/换用户名时再带上 GITEA_URL / GITEA_USER。
|
||||
#
|
||||
# 回退：脚本会把改动前的配置备份到 .workbuddy-backup/git-remotes.<时间戳>.txt
|
||||
# =====================================================================
|
||||
|
||||
@@ -43,7 +50,9 @@ if [ -z "$CNB_URL" ]; then
|
||||
· CNB 仓库地址直接用仓库页地址，带不带 .git 都行
|
||||
· CNB **不支持 SSH**，只能 HTTPS + 访问令牌（用户名固定填 cnb，密码填令牌）
|
||||
令牌：「个人设置 → 访问令牌」，勾「代码仓库 → 读写」
|
||||
· 本项目**没有** git 辅仓。异地备份走中兴 F50 上的 OpenList：
|
||||
· 自建 Gitea 辅仓走 http://23.254.236.47:3001（账号 zqlit），**另需 GITEA_PASS**：
|
||||
GITEA_PASS='Gitea 密码或令牌' bash scripts/setup-cnb-remotes.sh <CNB_URL>
|
||||
· 备选异地备份走中兴 F50 上的 OpenList（与 git 远端无关）：
|
||||
scripts/backup-bundle.mjs 打包 + AES-256-GCM 加密 + 上传（含校验与恢复）
|
||||
.workbuddy-backup/openlist-backup.env 连接与口令配置（被 git 忽略）
|
||||
Windows 计划任务 Blog-BundleBackup 每天 03:30 自动跑
|
||||
@@ -51,6 +60,11 @@ USAGE
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# 自建 Gitea 辅仓（默认地址；GITEA_PASS 必须外部给，不写死在本文件里）
|
||||
GITEA_URL="${GITEA_URL:-http://23.254.236.47:3001/zqlit/blog.git}"
|
||||
GITEA_USER="${GITEA_USER:-zqlit}"
|
||||
GITEA_PASS="${GITEA_PASS:-}"
|
||||
|
||||
case "$CNB_URL" in
|
||||
https://cnb.cool/*) ;;
|
||||
*) echo "地址看起来不是 CNB 的：$CNB_URL"; exit 1 ;;
|
||||
@@ -74,26 +88,45 @@ mkdir -p .workbuddy-backup
|
||||
} > "$BACKUP"
|
||||
echo "原配置已备份：$BACKUP"
|
||||
|
||||
# 1) origin = CNB（唯一远端，fetch + push，触发构建）
|
||||
# 1) origin = CNB（主仓，fetch + push，推送即触发构建）
|
||||
git remote remove origin 2>/dev/null || true
|
||||
git remote add origin "$CNB_URL"
|
||||
|
||||
# 2) 清理退役远端
|
||||
# gh(GitHub) / gitee / gitea 都已不在备份体系内 —— 留着只会在
|
||||
# `git pushall` 或后端按 PUSH_REMOTES 推送时撞上失效远端，白白报错。
|
||||
for retired in gh gitee gitea; do
|
||||
# 2) gitea = 自建 Gitea（代码同步辅仓）
|
||||
# 凭据直接编进远端 URL —— 这是「无凭据助手也能免交互推」的唯一简单写法。
|
||||
# 明文只落在本机 .git/config（不提交、不推送、不进仓库）。
|
||||
# （口令里若含 # 或 & 会被 sed 吃掉，那种情况请改用访问令牌。）
|
||||
if [ -n "$GITEA_PASS" ]; then
|
||||
GITEA_AUTH="$(printf '%s' "$GITEA_URL" | sed -E "s#^(https?://)#\1${GITEA_USER}:${GITEA_PASS}@#")"
|
||||
git remote remove gitea 2>/dev/null || true
|
||||
git remote add gitea "$GITEA_AUTH"
|
||||
echo "gitea 远端已配置：$GITEA_URL（凭据编入 URL，仅存于本机 .git/config）"
|
||||
elif git remote | grep -qx gitea; then
|
||||
echo "gitea 远端已存在，本次未给 GITEA_PASS → 保持原样"
|
||||
else
|
||||
echo "未提供 GITEA_PASS → 跳过 gitea 远端配置（只剩 origin 一个远端）"
|
||||
echo " 需要时：GITEA_PASS='xxx' bash scripts/setup-cnb-remotes.sh $CNB_URL"
|
||||
fi
|
||||
|
||||
# 3) 清理退役远端
|
||||
# gh(GitHub) / gitee 都已不在远端列表里 —— 留着只会在 `git pushall`
|
||||
# 或后端按 PUSH_REMOTES 推送时撞上失效远端，白白报错。
|
||||
# ★ gitea **不在**名单里：它是现行辅仓，别跟着一起清掉。
|
||||
for retired in gh gitee; do
|
||||
if git remote | grep -qx "$retired"; then
|
||||
git remote remove "$retired"
|
||||
echo "已移除退役远端：$retired"
|
||||
fi
|
||||
done
|
||||
|
||||
# 3) pushall
|
||||
# 现在只有一个远端，但仍保留这个别名 —— 文档与肌肉记忆都在用它，
|
||||
# 将来若真要再加辅仓，改这一行即可。
|
||||
git config alias.pushall '!git push origin main'
|
||||
# 4) pushall —— CNB 与 Gitea 都推
|
||||
# ★ 用 `;` 而不是 `&&`：主仓失败时辅仓照样得推上去，
|
||||
# 备份的意义正在于「主仓出问题时它那儿还有」。
|
||||
# 但退出码仍以主仓为准（exit $ec），免得辅仓推成功把主仓的失败盖掉。
|
||||
# 先探一下 gitea 在不在，免得没配辅仓时每次 pushall 都白报一行错。
|
||||
git config alias.pushall '!git push origin main; ec=$?; git remote | grep -qx gitea && git push gitea main; exit $ec'
|
||||
|
||||
# 4) 凭据
|
||||
# 5) 凭据
|
||||
#
|
||||
# 本机全局 helper 是 GCM（git-credential-manager.exe）。实测它对 cnb.cool 这类
|
||||
# 第三方 HTTPS 远端会**每次都弹窗**，而且 GCM_INTERACTIVE=never +
|
||||
@@ -128,8 +161,9 @@ echo "=== 当前远端 ==="
|
||||
git remote -v | sed -E 's#://[^@/]*@#://***@#g'
|
||||
echo
|
||||
echo "=== 下一步 ==="
|
||||
echo " git push origin main # 推 CNB（触发构建）"
|
||||
echo " git pushall # 同上（别名，现在只含这一段）"
|
||||
echo " git pushall # 依次推 origin(CNB) 与 gitea（推荐）"
|
||||
echo " git push origin main # 只推 CNB（触发构建）"
|
||||
echo " git push gitea main # 只推 Gitea 辅仓"
|
||||
echo
|
||||
echo " 异地备份不在这里 —— 想立刻跑一次整仓加密备份："
|
||||
echo " 备选异地备份不在这里 —— 想立刻跑一次整仓加密备份："
|
||||
echo " node scripts/backup-bundle.mjs --verify --keep 7"
|
||||
Reference in new issue
Block a user