zqlit/blog
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,008 Commits 1 Branch 2 Tags
b39dc2975301474cb78f27d8b9367aea0a73bb22
Commit Graph
13 Commits
Author SHA1 Message Date
zqlit b39dc29753 chore(远端): 移除 GitHub，改为「CNB 主仓 + Gitee 辅仓」 
起因：GitHub 账号被平台标记，随后仓库被按 AUP 合规条款清空 ——
远端只剩一条孤立提交（无父提交、无内容）：

    c21d5669  2026-10-06 20:08:32 +0800  zqlit
    chore: remove repository content (AUP compliance)

同时远端 main 的历史与本地**完全分叉**：两边只共享 2024-07-11 的 Initial commit，
之后每个提交 SHA 都不同（远端那份 989 提交、剥离了 .env/私钥/大二进制）。
所以 `git push gh main` 无法快进，也不可能再当备份用。

改动：

- `git remote remove gh`（改动前配置存 .workbuddy-backup/git-remotes.20261006-201354.txt）
- `pushall` 别名 → `git push origin main; git push gitee main`
- `scripts/setup-cnb-remotes.sh`：参数化第二个远端为 Gitee，
  顺带把「若残留 gh remote 就清掉」做进脚本；Gitee 凭据走 wincred
- `架构总览.md`：§2 发布旅程图、§5.2 远端表、§6 遗留待办全部改指向；
  新增 §5.2 的 GitHub 退役记录（含那条孤立提交的原文）
  与 §5.3「Gitee 辅仓的两条硬约束」实测核算
- `CNB构建落地方案.md`、`README.md`：远端与 pushall 说明同步
- **发布链路一起去 GitHub 化**（这几处原先都写死了 gh）：
    · `deploy/editor-api/bootstrap.sh`  GH_URL/GH_SSH_KEY → GITEE_URL/GITEE_SSH_KEY，
      remote `gh` → `gitee`，known_hosts/私钥文件名跟着改；
      保留原设计：**没给私钥就自动降级成只推 origin**，不会让每次发布都报错
    · `docker-compose.editor.yml`   PUSH_REMOTES → origin,gitee
    · `editor-api/server.mjs`       默认值 → 'origin,gitee'
    · `editor-api/README.md`        变量表同步

★ 尚未解决 / 需要决策的两条 Gitee 硬约束（详见 架构总览.md §5.3）：

1. **单文件 ≤ 50MB，而 `bin/linux/hugo` 是 83.1MB**
   —— 不管怎么瘦身历史，只要它还跟踪在 HEAD 里，Gitee 一律拒收。
2. 单仓库 ≤ 500MB，而 `.git` 是 620MB
   —— 移出那个 83MB 后 HEAD ≈ 374MB，才有余量。

另：线上 editor-api 容器的 .env 仍是 `PUSH_REMOTES=origin,gh`，
且仓库里还有一个 `gh` remote。因为推送逻辑对辅仓失败只警告、不阻断发布
（`git.mjs`：主仓成即算成），所以**线上发布没有坏**；
但要真正切到 Gitee，需要等 Gitee 仓库与私钥就位后再部署一次。
 2026-10-06 20:18:29 +08:00
zqlit 740d77e4cb fix(ssl): 修掉 5 处静默失败，本项目全面接管签发部署，Worker 退回只读 
一、1Panel 部署器三个缺陷（其中两个此前完全不可见）

1. `POST /websites/{id}/https` 的字段名是 `websiteSSLId`，不是 `sslId`。
   发 `sslId` 会被 Go 静默忽略成零值 0，于是
   `websiteSSLRepo.GetFirst(WithByID(0))` → 返回
   `HTTP 200 + code 500「服务错误: record not found」`，
   报错文案落在 DB 层，完全指不到参数名 —— 整个 t-t.live 部署被这条卡住。
   对照实验：`sslId=13 → 500` / `websiteSSLId=13 → 200 code=200`。

2. 换证书内容的接口选错。`POST /websites/ssl/update` 的结构体
   `WebsiteSSLUpdate` **根本没有** `certificate` / `privateKey` 字段，
   传了被丢弃、且 `domains` 只从 `otherDomains` 取（不传就清空），
   还会顺带把 `autoRenew` 置 false —— 而它**照样返回 200 success**。
   实测：原样 update 后 5 个站点的 `ssl/*.pem` mtime+md5 一个都没变。
   正确接口是 `POST /websites/ssl/upload` + `sslID > 0`：取记录 → 覆盖
   → 重算 ExpireDate/domains → `UpdateSSLConfig()` → 重新物化站点文件。
   副作用：`Upload()` 把 `primaryDomain` 重算成证书第一个 SAN
   （#11 因此从 `usj.cc` 漂成 `*.usj.cc`）→ 必须补 `domains` 兜底匹配，
   否则每次续期都新建一条重复记录。

3. `deploy()` 幂等捷径漏了「记录被换过」这一维：`sslId` 没变但内容变了时
   会跳过绑定，站点文件就停留在旧证书。改为引入 `replaced` 标志强制重绑。

二、另外两处静默失败

4. `parsePemInfo()` 对**完整链**返回 `{}`：旧实现把 PEM 各段 base64 拼接后
   一次 `atob`，中间段尾部的 `=` 填充导致抛错，整函数返回空 →
   `rec.expireAt` 退化成「签发时刻 + 90 天」。而完整链恰恰是部署器最常
   拿到的形态。改为只解析第一段（叶证书）。
   顺带新增 `derLen()` / `parseSanFromDer()`，精确定位 SAN 扩展
   OID `2.5.29.17` 再读 `[2] dNSName`，替掉原来的字节扫描启发式。
   这条同时是「多吉云复用失效」的根因：判据缺到期时间，只看域名集合
   就永远认为已覆盖 → 续期静默空转。修好后判据带上 `notAfter` 比对（1 天容差）。

5. DNS-01 挑战通知会撞 `400 authorization must be pending`（200181.xyz 连中两次）。
   这是**竞态**不是逻辑错：「先读状态再 POST」挡不住毫秒级窗口。
   已在 POST 侧做幂等容错（只认这一句），最终由 `pollAuthz` 定论。

三、Worker 退回只读

- `crons` 去掉 `10 4 * * *`，`index.ts` 里 renew 分支整体删除
- `POST /ssl/issue` 改 **501 硬拒绝**（而不是静默降级），响应给出国内机命令
- 签发 + 部署整条链路跑在国内机容器 `cn-certkeeper`

四、顺带修掉的两个「配置被悄悄抹掉」

- `configSave()` 不再丢掉表单不管理的 `probe_connect` / `probe_sni`。
  之前管理员在面板改任何一项，这两个字段就会被清空，
  后果是挂在 CDN 后的 t-t.live 探针退回公网、被误判成「还剩 80 多天」，
  源站证书到期也不续。现在保存时从旧配置带过来。

五、新增 4 个常驻运维工具（deploy/cn-certkeeper/src/）

- `renew-one.mjs`      只对单个域名签发+部署（原 `/renew` 无域名过滤，会全量重签）
- `redeploy.mjs`        复用已签好的证书只重跑部署（不碰 ACME，不白烧配额）
- `rollback-dogecloud.mjs` 应急把 CDN 域名绑回指定证书 id
- `txt-inspect.mjs`     `_acme-challenge` 下的 TXT 残留盘点/清理
- `selfcheck-acme.mjs`  CA 层诊断：只读目录 + 复用账户，不签发不部署

六、测试与文档

- 自测新增 [11] 节 8 项 PEM 解析回归（样本是 openssl 现场生成、内联写死的
  叶+中间证书，两段都以 `=` 结尾，正是 bug 现场），含精确值断言：
  > 125 项通过，0 失败
- `npm run typecheck` 零错误
- 方案文档：§9.11 由「待验证」改为定案（`ssl/update` 不物化、
  `ssl/upload+sslID` 才物化）；新增 §9.12「本轮又修掉的 5 个静默失败」、
  §9.13「本轮最终状态」、§9.14「certimate 工作流清查」

线上验收：三个域名（t-t.live / usj.cc / 200181.xyz）线上证书均为
LiteSSL ECC、2027-01-04 到期、daysLeft=90、needRenew=false；
1Panel 证书库 5 条精简为 3 条且全部在用；
certimate 停掉全部「会签发并部署」的工作流（团团 / 优世界 / 200181.xyz），
保留三条纯监控告警。
 2026-10-06 20:08:28 +08:00
zqlit 432cf5e398 feat: 证书探测改走国内机真 Node —— Workers 拿不到证书正文的兜底方案 
根因：Workers 上 cloudflare:sockets 没有 getPeerCertificate，
node:tls 的同名方法是桩函数（调用即抛 not implemented）。

- editor-api 新增 /ssl-probe 本地端点（真 Node，读对端证书正文）：
  不外发、不落盘；ssl 白名单放行，admin/ssl 可用，editor/匿名拒绝
- certprobe 改两级：首选国内机（带 X-Editor-Token），失败自动降级本地握手
- certProbe/certCheck 接线 EDITOR_API_BASE + EDITOR_TOKEN，撤掉 ?debug 诊断
- wrangler.toml 显式开 nodejs_compat（compat date 早于默认启用阈值）
- 手写 node:tls 最小类型声明（保持零依赖）
- seed-ssl-config.mjs 净化：真实凭据移到 secrets-backup/certkeeper-seeds.json，
  TOKEN_SECRET 改从 .dev.vars 读；脚本本体不含任何凭据
- role-perm 新增第 9 节 12 项（59/59），UI 探测 37 项全过
 2026-10-06 15:55:22 +08:00
zqlit a40a92f526 feat: SSL 证书管家 —— 后台面板 + 专属角色 + 国内机放行 
集成在 api.200181.xyz（同一个 Worker），国内机 writeapi.usj.cc 同步可用。

新增第三档后台角色 'ssl'：
- 只拿证书管家钥匙，看不到评论/文章/用户等模块
- 判定正着枚举放行（canManageSSL = admin|ssl），不用排除法，
  免得以后新增角色静默获得私钥权限
- 鉴权只认 Bearer 会话，绝不走 isAdminRequest —— 后者有 Artalk
  老客户端的 query 兜底，一旦进来的就是 TLS 私钥

数据（复用 RSS_KV，前缀 certkeeper:）：
- 凭据一条一键，避开 KV 读-改-写无事务导致的并发丢数据
- 私钥/AK-SK 一律 AES-GCM 密文（TOKEN_SECRET 经 PBKDF2 派生）
- 列表接口只回显前 4 后 4 位，明文不进内存
- 配置读失败抛错而非返回空，避免一次保存覆盖线上配置

只读监控：
- probeTls 走 cloudflare:sockets 拿证书正文，实现到期分级
  与「库里记录 vs 线上实测」对比（match/mismatch/live-only/unreachable）
- 到期提醒邮件（HTML 已转义）

国内机 editor-api：
- identify 识别 ssl 角色；业务分支前白名单，ssl 只能碰 /health、
  /admin/session、/admin/logout 与 /api/v2/ssl*
- /api/v2/ssl* 反代放行 admin + ssl（RSS 仍是 admin-only）
- posts.mjs 越权兜底方向修正：owns() 从「非 editor 即放行」改为
  「只有 admin 不受限」，漏进来的 ssl 被当受限编辑而非管理员全放行
- createPost 显式拒绝非写作角色

验证：typecheck ✓ / selftest:ssl 117 项 ✓ / 浏览器 37 项 ✓
 2026-10-06 14:19:01 +08:00
zqlit 5e9d328841 fix(排序): 同日文章 date 补全时分秒 + EdgeOne 部署重试增强 
现象：小乖同一天发的第二篇排到了第一篇后面。

根因：front matter 的 date 只写到年月日（写入侧只收得到日期），
同一天多篇的时间戳完全并列 → 排序退化成比标题，前台/后台都错。

改动：
- 数据（6 篇）：用目录名/slug 里的时间戳把 date 补全为
  'YYYY-MM-DDTHH:MM:SS+08:00'，slug 即写作时刻。每篇仅 1 行 diff。
  2026-10-05 两篇（必须）、2026-06-02 / 06-03 四篇（同一 bug 的历史遗留）。
- 写入侧根治
  - editor-api/src/posts.mjs：新建时「只到天」补北京时间此刻；
    保存时「同日保真」——没换日子则原有时分秒一字符不动。
  - write-server/src/lib/posts.ts：parseDate 按 Asia/Shanghai 归日，
    列表同天排序不再受 UTC 时区漂移影响。
- 回归测试：新增 editor-api/test/date-time.mjs（8 项，自带一次性临时仓库）。
- .cnb.yml：EdgeOne stage 重试 3 次/20s → 5 次/30s。
  构建节点到 api.edgeone.ai 偶发 15s 超时会被 CLI 误报
  「Invalid EDGEONE_PAGES_API_TOKEN」，纯网络抖动，令牌没坏。
- .gitignore：忽略 *.zip 与 .edgeone/（误留的 blog.zip 达 361MB）。
 2026-10-05 21:54:03 +08:00
zqlit 68416366eb fix(editor-api): 身份判定改为会话优先，防止配置漂移静默提权 
identify() 原来「令牌优先」：令牌对得上就用 X-Editor-* 头的身份，没有头时默认 admin。
国内线路的 nginx 目前不注入令牌，但一旦配置回滚到「注入令牌」的旧版本，编辑的请求
会命中令牌分支 → 静默获得管理员权限（看到全部文章、能改别人的、能全量发布）。

改为「会话（真实的人）优先于共享令牌（服务身份）」，把边界写死在代码里而不是靠配置。
新增断言：编辑会话 + 管理员令牌头 → 仍按编辑身份。role-perm.mjs 47/47
 2026-10-05 14:41:02 +08:00
zqlit d899cd793b feat(编辑角色): editor 只能写并发布自己的文章 
- D1 users 加 role 列（''/editor/admin），与 is_admin 成对写入
- Worker routes/editor.ts 放行 admin+editor，反代注入 X-Editor-Uid/User/Role（昵称 encodeURIComponent）
- editor-api 引入 identify()：身份取自注入头或本机会话；文章归属记 frontmatter author_id
- 编辑发布改精确 pathspec（只提交自己文章目录），管理员保持全量；空 pathspec 显式拦截
- 国内机直连登录改为转发 CF /user/access_token 校验，CF 不可达回退本机管理员
- handoff 签名覆盖身份（ts/uid/name/role），防编辑一键跳转变管理员
- admin.js：编辑只渲染「文章编辑」tab、作者框只读；用户管理加角色下拉 + 新建用户
 2026-10-05 14:34:56 +08:00
zqlit bcfa229105 邮件模板微信化 + 评论老友自动填充 + CF 后台国内线路一键跳 
- 邮件模板重做成微信聊天式：灰底、自己评论绿色气泡靠右、对方白色气泡靠左、
  40px 圆角方头像（weavatar，邮箱 md5 不外泄）、时间居中、#07C160 主按钮；
  布局全嵌套表格（Outlook 稳），表情内联 max-height:28px（修掉「表情太大」）、
  配图限宽 100%；管理员主题从「新的评论待审」改成「您有一个新的评论」
- 老友自动填充：新增 /comments/lookup（只回昵称+网址，绝不含邮箱；IP 限速
  30 次/10 分钟）+ 主题 comment-autofill 模块（填昵称弹提示、填邮箱自动带出
  上次的昵称/网址，事件委托不怕 Artalk 重建编辑器）
- CF 后台新增「国内线路」一键跳：/editor/handoff 用共享令牌对时间戳 HMAC
  签名 → editor-api /admin/handoff 验签发会话 Cookie（2 分钟有效、防重放），
  晚高峰丢包时直达国内机后台免重新登录
 2026-10-05 07:36:26 +08:00
zqlit 18a4882577 登录页去掉订阅口令：订阅接口认后台会话 + editor-api 反代 
- Worker 侧 requireAuth 新增两条通道：① Authorization 管理员会话（CF 版后台
  登录后订阅模块免口令）；② X-Editor-Token 共享令牌（服务端到服务端）。
  原 ?token=/Cookie 通道保留，RSS 阅读器与友圈页不受影响
- editor-api 新增订阅反代（/api/feeds|links|link-apply）：国内机后台的
  订阅源/友链由本机带共享令牌去 CF 取，前端不再持有任何口令；GET 幂等重试
  抗跨境抖动
- 登录页只留账号+密码（CF 版与国内机版统一）；国内机后台侧栏新增订阅中心
  入口；RSS_TOKEN / LS_RSS 前端残留全部清理
 2026-10-04 23:57:02 +08:00
zqlit 9f586d625b 后台登录改造：自建登录页 + Cookie 会话，弃用 basic auth 弹窗 
- editor-api 新增 /admin/login|session|logout：HttpOnly Cookie 会话（落盘持久化）、
  登录失败限速（5 次锁 5 分钟）、鉴权改为「X-Editor-Token 或 会话」双通道
- 登录页重做：品牌标识、图标输入框、密码可见切换、柔光背景，深浅色适配
- 前端以 /admin/session 探测部署模式：国内机走本机会话，CF 版走原令牌流程
- nginx：/admin/ 与 /api/v2/editor/ 去掉 basic auth 与令牌注入，登录凭据只存 Cookie
- bootstrap.sh 同步 ADMIN_USER/ADMIN_PASS，保持一键迁移能力
 2026-10-04 23:40:23 +08:00
zqlit 96751b8143 fix(editor): 删文章 EXDEV 修正 + 订阅口令不再阻断登录 
1) 删除文章报 EXDEV（cross-device link not permitted）
   · 根因一：容器内 /blog 与 /app/trash 是两个独立 bind mount，
     rename(2) 跨挂载点必然 EXDEV —— 哪怕宿主机上它们同在一块盘。
   · 根因二：退化成 fs.cpSync 后，Windows 上遇到**中文目录名**会把
     Node 进程直接干崩（exit 127，不抛异常，stdout 缓冲丢失）。
     而文章目录名几乎必然含中文（<日期>-<中文标题>-<slug>）。
   · 修法：改用 readdirSync/copyFileSync 自己递归复制（宽字符路径，中文 OK）；
     bootstrap.sh / compose 改成挂 BLOG_DIR 的父目录，让仓库与回收站
     落在**同一个挂载点**内，正常情况下 rename 直接成功、不再复制。

2) 登录页「订阅口令」填错会阻断整个登录
   · 它只是可选订阅模块的口令，不该 throw 掉登录流程。
   · rssApi() 无条件 searchParams.set('token', RSS_TOKEN)，会用浏览器里
     记住的旧口令覆盖调用方刚传的值 → 正确口令也验不过。
   · 现在：填错只 toast 提示 + 清掉失效旧口令；rssApi 尊重调用方传的值。

3) wrangler.toml：EDITOR_API_BASE 改指国内机新域名 writeapi.usj.cc
   （原指向即将到期的境外机 post.usj.cc，且那台从未部署过 editor-api）

验证：api-e2e 44/44；front matter 往返 130/130；保存往返 130/130；
中文路径删除实测通过（目录 + 中文子目录 + 图片全部移入回收站，进程不崩）。
 2026-10-04 22:11:02 +08:00
zqlit e8d13b9a6e fix(docker): apk 默认走阿里云镜像（国内构建实测官方源单包 30~40s） 2026-10-04 21:33:39 +08:00
zqlit c217d20c30 feat(editor): 在线编辑文章（Worker 前端 + 轻量 docker 后端） 
后端（新增 editor-api/，零 npm 依赖，只用 node 内置模块）：
- 只做文章相关：列表/读取/新建/保存/删除/图片上传/git 状态·发布·同步
- front matter 往返保真：未改动的块按字节照抄，CRLF/块标量/引号写法都不动
- 列表用目录名当 id，slug 撞名不再静默改错文件（返回 409 列候选）
- 鉴权只有一条路：X-Editor-Token（只存在 Worker 侧，浏览器拿不到）
- 端口只绑 127.0.0.1，由宿主机 nginx 反代出去

部署（新增 deploy/editor-api/bootstrap.sh）：
- 一条命令在新机器上完成 克隆仓库→写 .env→起容器→健康检查
- 状态全在两个目录（/srv/blog 仓库工作区 + /srv/editor-api 配置），
  迁移 = 复制目录或在新机重跑本脚本，容器本身无状态

Cloudflare Worker 侧（blog-admin）：
- src/routes/editor.ts：鉴权 + 反代，浏览器只跟 Worker 说话
- 管理面板新增「文章编辑」：两栏布局 + 快捷插入面板（13 项短代码，
  与 write-server 的 ShortcutPanel 一致）+ 底部 草稿/保存/发布
- 系统设置改为 schema 驱动的表单，且**以运行时实际生效的配置为准**
  （frontend_conf/captcha/moderator/ip_region/site_default + KV human_check），
  修复「表单显示一套、评论系统跑另一套」的脱节问题

验证：tsc 0 错；front matter 往返 130/130；保存往返 130/130；
API e2e 44/44；无头 Chrome UI e2e 14/14
 2026-10-04 21:16:06 +08:00