不装框架,我用 Node.js 原生模块搭了一个博客

路由、会话、Markdown 渲染和 RSS,全部用 Node.js 自带模块完成。这不是反对框架,而是一次把“魔法”拆开看看的练习。

不装框架,我用 Node.js 原生模块搭了一个博客 的封面插画
山止川行 · 2026年11月12日

一个没有前端构建、没有数据库、没有第三方依赖的博客,能不能体面地跑起来?可以,而且它现在就在你眼前。

先想清楚:我到底需要什么

写这个站点之前,我列了一张很短的清单:能发文章,能修改文章,读者能按标签和关键词找到内容,作者能用一个本地账号登录后台。没有评论系统,没有推荐算法,也没有“增长”指标。

清单越短,技术选择越清楚。最后整个项目只依赖 Node.js 自带模块:node:http 负责服务,node:crypto 负责密码和会话,文件系统负责持久化。没有 npm install,也没有构建步骤。

路由:把 URL 当作数据结构

我不需要复杂的路由器。一个请求进来,先解析路径,再按前缀分发:

js
const url = new URL(req.url, 'http://localhost');
const pathname = decodeURIComponent(url.pathname);

if (pathname === '/') return renderHome(res);
if (pathname.startsWith('/post/')) {
  return renderPost(res, pathname.slice('/post/'.length));
}
if (pathname === '/login' && req.method === 'POST') {
  return handleLogin(req, res);
}

真正容易出错的地方不是匹配,而是顺序:静态文件必须放在动态路由之后,404 必须放在最后,POST 请求要先校验来源和 CSRF token。

登录:别把密码存进 Cookie

本地登录只需要一个账号,但我仍然坚持三件事:

  1. 密码只保存 scrypt 哈希和随机盐,不保存明文。
  2. 会话 token 放在 HttpOnly Cookie 里,JavaScript 读不到。
  3. 所有修改操作都校验 CSRF token,并限制登录失败次数。
js
const hash = crypto.scryptSync(password, salt, 64, {
  N: 16384, r: 8, p: 1, maxmem: 64 * 1024 * 1024,
});

Cookie 则长这样:

text
Set-Cookie: szcx_session=...; HttpOnly; SameSite=Lax; Path=/; Max-Age=43200

因为站点只在本机运行,我没有加 Secure。如果哪天放到公网,这一项和 HTTPS 必须一起补上。

Markdown:先转义,再渲染

我想要的 Markdown 支持很有限:标题、段落、粗体、链接、列表、引用和代码块。自己写一个小渲染器,最大的好处是能把安全边界想清楚:

  • 先把所有原文做 HTML 转义;
  • 再处理行内语法;
  • 链接只允许 http、https、mailto、站内路径和锚点;
  • 代码块单独提取,最后再放回去。

顺序反过来,就等于给 XSS 留门。渲染器不需要“完整支持 CommonMark”,它只需要支持我实际会写的那部分语法,并且对不支持的部分保持诚实。

静态文件和缓存

CSS、JS 和封面图都从 public/ 目录读取。这里有两个细节:

  • 路径先做规范化,再确认最终路径仍然位于 public/ 里面,防止 ../ 穿越;
  • HTML、CSS 和 JS 都不缓存,改完刷新就能看到;封面图缓存一天,避免每次都重新下载。

没有打包器,意味着没有 source map,也没有“为什么线上和本地不一样”。对一个小站点来说,这是划算的交换。

那些不起眼但很重要的细节

原子写入。 保存文章时先写临时文件,再用 rename 覆盖正式文件。进程如果在写入途中被杀掉,旧文件仍然完整。

输入长度。 标题、摘要、标签、正文都设上限。不是为了防黑客,而是为了防止自己某天粘贴一整本书。

404 也是页面。 它应该和站点其他部分长得一样,并且给出回首页的路径,而不是一行冷冰冰的 Cannot GET。

RSS 不是装饰。 既然写作是为了被读到,就顺手生成一份 /rss.xml。它只多几十行代码,却能让读者把站点带进自己的阅读器。

最后

这套东西当然不适合所有人。如果团队需要权限、协作、预览环境和内容工作流,现成的框架能省下大量时间。自己写一遍的价值,不在于“以后都自己写”,而在于下一次使用框架时,你知道它在替你做什么。

这个博客现在运行在一台很普通的机器上。没有容器,没有云函数,也没有数据库。它只是把几个文件读进内存,拼成 HTML,然后安静地等下一个读者。对我来说,这已经足够浪漫。