从 302 到 201:不开浏览器,把一篇文章发上 Halo 2.26
起因:一个朴素的需求
我有一个很朴素的需求:用脚本往 Halo 博客里自动发文章——定时早报、AI 生成的内容,总不能每次都手动开后台粘贴吧。
第一反应当然是 HTTP Basic 认证:用户名密码一对,curl -u 一带,天下我有。于是我信心满满地敲下了:
curl -i -u 'tomato:••••••••' \
'https://tomato.loan/apis/api.console.halo.run/v1alpha1/posts?size=1'第一堵墙:Basic 认证被「无视」了
返回的不是文章列表,也不是 401 Unauthorized,而是一个客客气气的重定向:
HTTP/2 302
location: /login?authentication_required
set-cookie: SESSION=22e48b23-…; Path=/; HTTPOnly有意思的地方在于它压根没有返回 WWW-Authenticate 质询头。HTTP Basic 的设计是「服务端发 401 + 质询头 → 客户端补上 Authorization: Basic … 重试」,而 Halo 2.26 的安全配置里根本没有启用 Basic 这套挑战-应答机制。你辛辛苦苦带上去的凭据,被当成空气,请求被原样踢回登录页。
翻了翻 Halo 的安全模型,/apis/** 下的 Console API 只认几种身份:
- 浏览器登录后的 SESSION 会话(就是那个 HttpOnly 的
SESSIONcookie) - 后台生成的个人访问令牌 PAT(Personal Access Token)
- 插件或 OAuth2 等扩展认证方式
PAT 需要人工在后台点出来,而我的场景里手上只有账号和密码。那就只剩下一条路:像浏览器一样,走一遍真实的登录流程,把 SESSION 换到手。
侦察登录页:这居然是个服务端渲染的表单
先别急着 POST,老老实实像浏览器一样「打开」登录页看看。这里有个小坑:直接 curl https://tomato.loan/login 会拿到 302 在 /login 和 /console 之间打转——因为缺了浏览器导航特有的 Accept: text/html 头,Spring Security 把它当成了 AJAX 请求。补上之后:
curl -s -c cookies.txt \
-H 'Accept: text/html,application/xhtml+xml' \
'https://tomato.loan/login'这次拿到了一个真正的登录页 HTML,信息量很大:
<form class="halo-form" id="login-form" action="/login" method="post">
<input type="hidden" name="_csrf"
value="50-LkPdr67cyAW7qyo…"/>
<input type="hidden" name="password" id="password"/>
<input id="plainPassword" name="" type="password"/>
<input id="username" name="username" type="text"/>
</form>三个关键发现:
- CSRF token 直接内嵌在表单里——一个
_csrfhidden 字段,POST 时原样带回即可; - 有两个密码框:用户真正输入的
plainPassword甚至没有name,而隐藏的password才是提交给服务端的——页面 JS 会在表单 submit 前把加密结果填进去; - 页面里内嵌了一段 RSA 公钥(4096 位,X.509 格式),配套的加密逻辑一目了然:
function encryptPassword(password) {
const encrypt = new JSEncrypt();
encrypt.setPublicKey(publicKey);
return encrypt.encrypt(password);
}
loginForm.addEventListener("submit", function (event) {
passwordInput.value = encryptPassword(plainPasswordInput.value);
});也就是说,密码在离开浏览器之前就已经被 RSA 加密了——服务端拿到的永远是密文,登录页传输层之外又多了一层防线。好在 JSEncrypt 用的是最朴素的 RSA PKCS#1 v1.5 填充,输出 base64,任何语言都能轻松复刻。
复刻登录:三步换一个 SESSION
第一步:取 CSRF token 和公钥
请求 GET /login,两个正则搞定:
html = session.get(BASE + "/login", headers=NAV_HEADERS).text
csrf = re.search(r'name="_csrf"\s+value="([^"]+)"', html).group(1)
public_key = re.search(r'publicKey\s*=\s*"([^"]+)"', html).group(1)第二步:用同款算法加密密码
Python 的 cryptography 库三行复刻 JSEncrypt:
from cryptography.hazmat.primitives.asymmetric import padding
pub = serialization.load_der_public_key(base64.b64decode(public_key))
cipher = pub.encrypt(PASSWORD.encode("utf-8"), padding.PKCS1v15())
encrypted = base64.b64encode(cipher).decode()第三步:表单提交,守株待兔
resp = session.post(BASE + "/login", data={
"username": "tomato",
"password": encrypted, # 密文,不是明文
"_csrf": csrf,
"remember-me": "true",
}, headers={"Content-Type": "application/x-www-form-urlencoded"})判定成功的标志:302 跳向 /uc(而不是跳回 /login?error)。此时 requests.Session 里已经躺着一个通过认证的 SESSION cookie,之后带着它请求 Console API,就是「已登录」身份。
走 Console API:标签 → 分类 → 文章 → 发布
还有最后一个细节:/apis/** 的写操作同样受 CSRF 保护。SPA 前端走的是 XSRF-TOKEN cookie → X-XSRF-TOKEN 请求头这条路,我们照做即可(cookie 虽然是 HttpOnly 的,但值在 Set-Cookie 响应头里已经拿到了)。
创建标签与分类
标签和分类是 Halo 的自定义资源(CR),直接 POST 对应的聚合 API:
POST /apis/content.halo.run/v1alpha1/tags
{
"apiVersion": "content.halo.run/v1alpha1",
"kind": "Tag",
"metadata": { "generateName": "tag-" },
"spec": { "displayName": "Halo", "slug": "halo" }
}
# → HTTP 201 Created分类同理,kind: Category,POST 到 /apis/content.halo.run/v1alpha1/categories。
创建文章:两个真实的坑
创建文章用的是 Console 专用的聚合接口,一次性把正文、标签、分类都带上:
POST /apis/api.console.halo.run/v1alpha1/posts
{
"post": {
"spec": {
"title": "…", "slug": "…", "visible": "PUBLIC",
"tags": ["tag-6miz9l9u", "tag-gd17qk4m"], # 注意:标签的 metadata.name
"categories": ["categorie-yvcy2ssx"],
"excerpt": { "autoGenerate": False, "raw": "手写的摘要" }
},
"apiVersion": "content.halo.run/v1alpha1",
"kind": "Post",
"metadata": { "generateName": "post-" }
},
"content": {
"raw": "<h2>正文 HTML…</h2>",
"content": "<h2>正文 HTML…</h2>",
"rawType": "HTML"
}
}坑一:rawType。rawType: "HTML" 是 Halo 默认富文本编辑器的存储格式。填对了,这篇文章在后台打开时就是所见即所得的可编辑状态;填成 MARKDOWN 而正文又是 HTML 的话,编辑器加载出来就是一堆裸标签。
坑二:标签分类的关联被「静默忽略」。不少老教程会把 tags、categories 放在请求顶层,我照做后接口返回 200、文章创建成功——一切看起来都很完美,直到打开后台才发现文章的标签和分类是空的,公网文章页渲染出来的「标签」只是全站侧栏,跟这篇文章没有半毛钱关系。
排查方法很简单,直接 GET 文章的自定义资源看原始数据:
GET /apis/content.halo.run/v1alpha1/posts/{name}
# spec.tags: null ← 压根没写进去
# 对照一篇后台手动发布的文章:
# spec.tags: ["tag-j7ephu6o"]原来在 2.26 里,关联关系就存在 post.spec.tags / post.spec.categories 里,值是标签和分类的 metadata.name(而不是显示名)。把这两个字段直接内联进 spec 再 PUT 一次,关联立刻就有了——静默失败不报错,这种坑只有实际跑一遍才能发现。
发布
创建出来的文章还只是草稿(spec.publish = false),发布是独立动作:
PUT /apis/api.console.halo.run/v1alpha1/posts/{metadata.name}/publish
# → HTTP 200Halo 会为文章生成版本快照、装配路由,稍等片刻 /archives/{slug} 就能从公网访问了。
验收:从公网看一眼
发布成功不等于万事大吉——渲染才是真理。验收脚本要从未登录的公网侧抓两个页面:
# 首页:新文章应该出现在文章列表里
curl -s https://tomato.loan/ | grep -c '从 302 到 201'
# 文章页:标题、正文、摘要、分类、标签逐项核对
curl -s https://tomato.loan/archives/halo-console-api-login \
| grep -E '<title>|技术折腾|</article>'最硬核的验收方式其实是:你现在读到的这篇文章,就是这套脚本发出的。如果标题、摘要、右侧的分类和标签都完好无损地展示在你面前,说明从 CSRF、RSA、SESSION 到 Console API 的整条链路都通了——文章本身就是它的验收报告。
延伸:其实还有更省事的路
必须坦白:如果你只是想无人值守地发文章,PAT(个人访问令牌)才是正解。后台「个人令牌」页签生成一个,之后所有请求带一个头就行,不用模拟登录、不用管 CSRF:
curl -H 'Authorization: Bearer pat_xxxxxxxx' \
'https://tomato.loan/apis/api.console.halo.run/v1alpha1/posts'那什么时候需要本文这套「笨办法」?——手上只有账号密码(比如帮朋友临时发一篇)、需要完整复刻浏览器行为做自动化测试、或者单纯想搞明白 Halo 登录到底发生了什么。另外,Halo 自带了完整的 API 文档,登录后台后访问 /swagger-ui 可以按图索骥。
从
302到201,中间隔着一段 CSRF、一次 RSA 和一个 SESSION。拆开看,每一步都平平无奇;连起来,就是浏览器的日常。

