看见如果

博客跑的是 Typecho,自己写了个 REST API 插件(OpenClawApi),平时用来把 Obsidian 里的笔记一键推成文章。前阵子让 AI 帮忙做了一次完整的代码审查,结果查出 16 个问题,从「密钥明文进访问日志」这种 P0 级事故,到计数漂移这种暗坑都有。趁着假期一次性修完,顺便把过程记录下来。

一、最要命的问题:密钥在日志里裸奔

老版本支持 ?openclaw_key=xxx 在 URL 里传密钥。写脚本的时候图省事就用了这种方式,后果是——每一次调用的密钥都以明文形式写进了 nginx 访问日志,而且日志文件本身是公网可下载的。翻了一下历史日志,已经积了 247 行。

修复分两步:

  1. 服务端只认请求头:X-OpenClaw-Key 或 Authorization: Bearer,URL 传参直接 401,不给任何兼容窗口(留了一个默认关闭的开关,纯应急用);
  2. 轮换密钥 + 清洗历史:生成新密钥,旧密钥立即作废;历史日志里所有 openclaw_key= 后面的值批量打码后压缩归档。

现在就算日志泄露,也倒推不出任何有效凭证。

二、一个按钮就能废掉你的 Key

regenKey(重新生成密钥)接口有三个连环坑:

  • 用 GET 就能触发,页面上放个 <img src="...regenKey"> 就能把密钥换成你不知道的值;
  • 没有 CSRF Token,跨站请求直接打穿;
  • 更隐蔽的是:配置页表单把密钥的哈希值当隐藏字段回传,点一次「保存设置」,刚生成的新 Key 就被旧哈希回滚覆盖——界面上一切正常,密钥其实已经悄悄变回去了。

修复:regen 改 POST + Typecho 的 Security Token 校验;哈希独立存储,不再参与表单提交,从根上消灭「保存回滚」这类问题。

三、数据完整性:删除文章≠文章消失

老版本删除文章只删主表,自定义字段(fields)残留在库里成了孤儿数据——清查时扫出 238 行,分属 41 个已删除的文章 ID。分类/标签的计数靠手工 +1/-1 维护,久了必然漂移,实际查出 9 条对不上。

修复后的删除流程走事务:一次性清理关联关系、自定义字段、评论、附件挂载,然后分类计数改成按关联表精确重算,不再有「加减法账」。顺手写了维护端点 /maintenance,孤儿数据和计数漂移一键归零。

四、发布链路补齐

这些是日常写自动化脚本时真正会踩的坑:

  • 标签只认数字 ID:按名字传会被 intval() 变成 0 然后静默丢弃——README 的示例恰恰教用户传名字,等于官方挖坑。现在标签名自动创建、分类名不存在直接返回 400 报错;
  • PATCH 全量覆盖:改个标题漏传标签,原标签就被清空。现在默认只改传入字段,tags_mode: append/remove 控制增删;
  • GET 伪装 DELETE:?method=DELETE 这种覆盖已废除,写操作只认真实 HTTP 方法;
  • 搜索通配符注入:搜「100%」里的 % 会被 LIKE 当通配符,直接全表扫描。改用原生 SQL + ESCAPE 转义;
  • 不支持自定义字段和时间回填:现在可以写 ai_summary、thumb,也能指定 created 把文章日期回填到过去。

五、顺手做的性能优化

正文里的站外图片(图床、AI 生成的外链图)以前是直接拉原图,一张 144KB 的图手机端照单全收,还没有宽高属性,加载时页面会跳动。现在统一走缓存管道:下载一次 → 转多档 WebP 存本地 → 按屏幕宽度出 srcset + 宽高属性。实测同一张图从 144KB 降到 18KB(640w 档),17 篇含外链图的文章全部生效。

六、整改清单速览

批次内容数量
P0密钥只走 Header、轮换、日志打码、regen 加 CSRF、防保存回滚3
P1标签/分类按名解析、fields、created、status 白名单、事务删除、精确计数、PATCH 局部更新、batch 计数6
P2搜索转义、分页响应头、禁 GET 覆盖、评论邮箱脱敏、no-store、1.3 API 统一、审计日志、IP 白名单7

全部改完后跑了一轮全接口回归:鉴权、CSRF、增删改查、批量、搜索特殊字符、邮箱脱敏,该有的 401/405 一个不少。


这篇总结本身就是通过重写后的 API 自动发布的——算是食髓知味,用新管道测试新管道。

标签: typecho, 自动化, OpenClaw

添加新评论

发布动态

登录

页面加载时间: 30.59ms | 缓存状态: ✅ 缓存命中