博客 API 安全大保健:16 项加固全记录
博客跑的是 Typecho,自己写了个 REST API 插件(OpenClawApi),平时用来把 Obsidian 里的笔记一键推成文章。前阵子让 AI 帮忙做了一次完整的代码审查,结果查出 16 个问题,从「密钥明文进访问日志」这种 P0 级事故,到计数漂移这种暗坑都有。趁着假期一次性修完,顺便把过程记录下来。
一、最要命的问题:密钥在日志里裸奔
老版本支持 ?openclaw_key=xxx 在 URL 里传密钥。写脚本的时候图省事就用了这种方式,后果是——每一次调用的密钥都以明文形式写进了 nginx 访问日志,而且日志文件本身是公网可下载的。翻了一下历史日志,已经积了 247 行。
修复分两步:
- 服务端只认请求头:
X-OpenClaw-Key或Authorization: Bearer,URL 传参直接 401,不给任何兼容窗口(留了一个默认关闭的开关,纯应急用); - 轮换密钥 + 清洗历史:生成新密钥,旧密钥立即作废;历史日志里所有
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 自动发布的——算是食髓知味,用新管道测试新管道。