blog/scripts at 8abe93d17a0ed336937e17282867ae6258f870b8 - blog

zqlit/blog

0 Fork 0

Files

T

zqlit 8abe93d17a feat(backup): 整仓离线备份上线 —— bundle 加密后传中兴 F50 上的 OpenList

背景：GitHub 被按 AUP 清空后，用户提出自己的中兴 F50（5G CPE + 内置 256GB）
上跑着 OpenList，想用它当第三层备份。实测可行，已落地并跑通。

为什么是 bundle 而不是直接推 git：
  WebDAV 不支持原子的 rename/lock，bare repo 挂上去 push 会让对象写坏 ——
  表面成功、实际随机损坏，可能几个月后才发现。bundle 是单文件顺序写，安全。

为什么加密（用户一度想省掉）：
  历史里含 .env、TLS 私钥、GITEA_SECRETS.md。介质是随身设备的内部存储，
  明文 = 把密钥放在一台可能丢失/刷机/送修的机器上。
  OpenList 的登录只保护「访问通道」，不保护「存储介质」——拆机就能读。
  加密成本实测仅 1.9~2.9 秒、体积不变；且 CNB/Gitea 仍是明文副本，
  口令丢失只是少一份备份，不构成单点。

实现（scripts/backup-bundle.mjs，零 npm 依赖）：
  - git bundle create --all → AES-256-GCM（Node 内置 crypto）
  - 布局 magic(8)|salt(16)|iv(12)|密文|tag(16)，scrypt(N=32768,r=8,p=1) 派生密钥
  - 为什么不用 gpg：本机 gpg 2.4.9 在 Windows 下已损坏（反复 stale lockfile，
    node spawn 直接 EBUSY）；换内置 crypto 后零外部依赖且带认证标签
  - 上传后可选 --verify：下载回来比对 sha256，端到端闭环
  - --keep 控制远端保留份数；--decrypt 恢复；--list 盘点；--dry 不上传

定时任务（scripts/backup-task.cmd + Windows 计划任务 Blog-BundleBackup）：
  - 每天 03:30 本地时间，默认 --verify --keep 3
  - InteractiveToken + LeastPrivilege、StartWhenAvailable、1h 超时、IgnoreNew 防重入
  - 日志追加到 .workbuddy-backup/logs/backup.log，超 5MB 轮转

★ backup-task.cmd 内容必须全 ASCII：
  cmd.exe 按当前代码页（zh-CN 是 GBK）解析批处理文件，而 node 输出 UTF-8。
  UTF-8 中文注释会吞掉 CR/LF 并把下一行当命令执行 —— 实测踩到（一条 rem 被当命令跑）。
  ASCII 是 UTF-8 子集，纯英文注释与 node 的中文输出混写不会乱。
  同理不能用 %date%（含本地化星期），改用系统时间 API 取 ISO 格式时间。
  日志轮转的 for 语句必须加 if exist 守卫，否则首次运行报「系统找不到指定的路径」。

实测（由计划任务实际拉起，非手工执行）：
  bundle 6.8~9.9s（605.5MB）/ 加密 1.9~2.9s / 上传 19.4~20.6s（29.4~31.3 MB/s）
  / 下载回读 sha256 一致，端到端退出码 0
  恢复链路已演练：--decrypt → git bundle verify 报 "records a complete history"
  → 1008 提交完整一致

文档（架构总览.md）：
  - §5.3 从「Gitee 两条硬约束」扩写为「辅仓选型」，补入云效 Codeup 基础版对照
    （Git 5GiB + 单文件命令行 200MB）—— 选它则 bin/linux/hugo 不必出库、
    构建链路一行不用改
  - 新增 §5.6 整仓离线备份（介质 / 为什么 bundle / 为什么加密 / 加密格式 / 用法 /
    配置 / 定时任务 / 恢复流程 / 实测数据）
  - §6 待办：#2 改为「辅仓选型未定」并说明 pushall 现状；#3 标注只有选 Gitee 才必须做；
    #9 补记「不改写历史」的唯一障碍已随 GitHub 消失；新增 #10 备份已上线 + 三项安全待办

2026-10-06 21:03:29 +08:00

__pycache__

1317

2026-06-25 13:17:45 +08:00

add_ancient_chars.py

feat: 添加古风官职字符到字体子集

2026-06-03 13:53:12 +08:00

add_draft_to_hidden.ps1

rename content/post to content/posts

2026-06-02 15:37:49 +08:00

add_draft_to_hidden.py

fix(ci): 用 Python 重写 pre-build 脚本，替换 PowerShell 依赖