2012 年 3 月,我用 WordPress 搭了第一个博客。十几年下来,域名换了一堆,主机换了一堆,程序也换了一堆:WordPress、Typecho、Ghost 都用过。2025 年 7 月,博客定名「方糖」,域名定在 fangtang.net,副标题写着:半糖生活,微甜日常。
之前用的程序都挺好,但总有些地方不顺手:想改个细节要去翻插件、翻主题;数据和文件散在各处;想加个自己想要的功能,得先看程序支不支持。后来索性自己写了一个:后端 Hono,前端 Astro,数据放在 SQLite 里,文章就是一个个 Markdown 文件。
这篇文章就是这套东西的搭建和改造记录,想到哪写到哪,贴点代码,算是给自己留个档,也给想折腾的朋友一个参考。

一、整体长什么样
先说结论:访客看到的是纯静态页面,打开快,也不依赖后端在线;评论提交、搜索、管理后台这些动态的部分,走 Hono 写的 API;文章的源头是 Markdown 文件,后端启动时扫一遍写进 SQLite,前端构建时再从 API 读出来;图片和附件走对象存储。
技术选型一句话:Node、Hono、Astro、SQLite、Markdown。刻意保持简单:没有 MySQL,没有 Redis,没有容器,整站就是一个 Node 进程加一个静态目录,搬家时拷走就能跑。
访客 → Nginx → 静态页面(Astro 构建产物)
├─ /api/ → Hono 后端(本机 18268 端口)
└─ /media/ → 磁盘上的上传文件
文章源头:Markdown 文件 → 后端扫描 → SQLite → 构建时读 API
二、后端:Hono + SQLite,一个文件跑全站
后端只有一个入口文件 server.js,路由、数据库、渲染都在里面,依赖很少:
{
"dependencies": {
"hono": "^4.6.0",
"markdown-it": "^14.1.0",
"nodemailer": "^10.3.1",
"pinyin-pro": "^3.29.5"
}
}
数据库用的是 Node 自带的 node:sqlite,不用另外装数据库服务。文章就一张表:
CREATE TABLE IF NOT EXISTS posts(
slug TEXT PRIMARY KEY, title TEXT, date TEXT, type TEXT,
draft INTEGER DEFAULT 0, summary TEXT, body_html TEXT,
word_count INTEGER, reading_minutes INTEGER
);
文章以 Markdown 文件为准。后端启动时扫一遍 content 目录,逐个解析 frontmatter、渲染正文,写进库里;库里有、文件里没了的行会被清掉:
function indexPostFile(file) {
const raw = readFileSync(join(CONTENT_DIR, file), 'utf8');
const { fm, body } = parseFrontMatter(raw);
const slug = fm.slug || basename(file, '.md');
const summary = (fm.summary || '').trim()
? String(fm.summary).trim().slice(0, 200)
: summarize(body);
upsertPost.run(slug, fm.title || slug, fm.date || '', fm.type || 'post',
fm.draft === 'true' ? 1 : 0, summary, cover,
md.render(body), words, Math.max(1, Math.ceil(words / 400)));
return slug;
}
function scanContent() {
const files = readdirSync(CONTENT_DIR).filter(f => f.endsWith('.md'));
const seen = new Set();
for (const file of files) {
const slug = indexPostFile(file);
if (slug) seen.add(slug);
}
for (const row of db.prepare(`SELECT slug FROM posts`).all()) {
if (!seen.has(row.slug)) db.prepare(`DELETE FROM posts WHERE slug=?`).run(row.slug);
}
bumpVersion();
}
保存一篇文章时只重新索引这一篇,不全量重扫。以前每次保存都全量扫,五百多篇文章,保存一次要等很久,改完这点保存立刻就回来了。
每篇文章在磁盘上就是一个 .md 文件,头信息长这样:
---
title: 博客搭建与改造之AI战记
slug: fang-tang-bo-ke-da-jian-yu-gai-zao-shou-ji
date: 2026-11-15
type: post
draft: true
---
写文件用的也是后端自己的函数,原子写入,先写临时文件再改名:
function writePostFile(slug, { title, date, type, draft, body, summary, cover }) {
const lines = [
`title: ${fmText(title)}`,
`slug: ${slug}`,
`date: ${date}`,
`type: ${type}`,
`draft: ${draft ? 'true' : 'false'}`,
];
if (fmText(summary)) lines.push(`summary: ${fmText(summary)}`);
if (fmText(cover)) lines.push(`cover: ${fmText(cover)}`);
const content = `---\n${lines.join('\n')}\n---\n\n${body}\n`;
const tmp = join(CONTENT_DIR, `.${slug}.tmp-${process.pid}`);
writeFileSync(tmp, content, 'utf8');
renameSync(tmp, join(CONTENT_DIR, `${slug}.md`));
}
草稿就是 draft: true,公开接口永远只返回草稿标志为 0 的文章,草稿只在管理后台看得见。
三、前端:Astro,构建时拉数据
前端用 Astro,只负责在构建时把数据取回来,生成静态页。页面里不做 Markdown 解析,不用内容集合,所有数据都来自后端 API:
export const API_BASE = import.meta.env.API_BASE || 'http://127.0.0.1:18268';
async function get(path) {
const res = await fetch(`${API_BASE}${path}`);
if (!res.ok) throw new Error(`API ${path} -> ${res.status}`);
return res.json();
}
export const apiPosts = (limit) => get(`/api/posts${limit ? `?limit=${limit}` : ''}`);
export const apiPost = (slug) => get(`/api/posts/${slug}`).then((d) => d.post);
export const apiArchive = () => get('/api/archive').then((d) => d.archive);
构建产物是六百多页静态 HTML,首页 8 篇一页真分页,归档按年,搜索框是弹窗。样式是自己写的国风:水墨背景、宣纸面板、金色点缀。字体用的 MiSans,自己切了子集放在站内,不走第三方字体 CDN。
静态资源带 ?v= 版本号,版本号只有一个来源,改了文件就升一位,不然浏览器会一直拿缓存——这个后面踩坑里还会提到。
四、文章、链接与评论
中文标题自动转拼音做链接,靠的是 pinyin-pro:
function slugify(text) {
const withPinyin = String(text || '').replace(/[\u4e00-\u9fff]+/g, (run) =>
' ' + pinyin(run, { toneType: 'none', type: 'array' }).join(' ') + ' ');
return withPinyin
.normalize('NFKD').replace(/[\u0300-\u036f]/g, '')
.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/-+/g, '-').replace(/^-+|-+$/g, '');
}
三百多篇老文章的中文链接就是这么批量转过来的,零冲突。新的文章保存时自动生成拼音链接,之后不让改,省得外链失效。
评论是自己写的:昵称必填,邮箱和网址选填,默认先审后发,楼中楼回复。评论等级是按邮箱累计的通过数算的,借了《仙逆》的境界名:凝气 1 条、筑基 3 条、结丹 5 条、元婴 8 条……一路到大天尊 600 条,站长本人固定显示踏天境。
反垃圾没接任何第三方服务,全是本地规则:评论至少要含一个汉字;第一次留言的人不能带链接;同一地址短时间内只能发几条。规则不完美,但够用,真有人绕过再收紧。
评论开关是后来加的:后台能分别关全站、友链页、关于页的评论。关了只拦新评论,已有的照常显示,回复按钮也一并失效,保存立刻生效,不用重新构建。
五、说说:把 Memos 接进来
说说页接的是自己搭的 Memos,只读公开的备忘。后端每半小时同步一次,前端构建时分页,一页 10 条。说说的评论复用了博客自己的评论系统,每条说说一个虚拟链接,等级也一样算。
管理后台能直接发说说、删说说,不用去 Memos 里操作。发图还没接,这是下一阶段的事。
六、友链、热力图与 RSS
友链页是融合版:每位朋友一张小卡片,身份加最近三篇文章,按最近更新排序。后端每小时抓一次各家的 RSS,慢的源会重试,个别源只能走 HTTP。
首页有一张归档热力图:最近 12 个月,每周一行,金色深浅表示当天写了几篇。构建时生成,新文章要等下次构建才出现在图上。
RSS 是构建时生成的静态文件,地址和日期都按规范写,还套了个国风样式的 XSL,浏览器里打开能直接看。
七、微信里也能管博客
微信里也能管博客:通过官方的微信机器人插件接进来,网关跑在自己的电脑上。在微信里发「状态」能看到文章、评论、说说的计数和最新文章,发「发说说:内容」就能发一条说说。
安全上收得很紧:机器人用的是一枚独立令牌,只能做「发说说」和「看计数」这两件事,看不到邮箱、看不到评论内容,也动不了文章和管理后台;令牌可以随时在后台吊销重发。
八、部署与备份
主站跑在香港的 VPS 上,宝塔面板管站点和证书,Nginx 前面扛着:静态文件直接 serve,/api/ 代理给本机的后端,/media/ 直接映射到磁盘:
location ^~ /api/ {
proxy_pass http://127.0.0.1:18268;
}
location ^~ /media/ {
alias /www/wwwroot/fangtang/app/media/;
}
后端是 systemd 服务,开机自启,挂了自动拉起来:
[Service]
Type=simple
WorkingDirectory=/www/wwwroot/fangtang/app/backend
Environment=PORT=18268
Environment=CONTENT_DIR=/www/wwwroot/fangtang/app/content
Environment=DATA_DIR=/www/wwwroot/fangtang/app/data
ExecStart=/usr/bin/node server.js
Restart=on-failure
还有一台备用机,代码和数据都有一份,平时在上面先测新功能,没问题再推到主站。文章内容会定时推到私有的 Git 仓库,整站目录也有宝塔的定时备份。
发文章不会自动更新前台:保存只写 Markdown 和数据库,公开页面要等点了「重新生成前台」才变。这是特意这么定的,改几处攒一次再构建。
九、踩过的坑
- 数据库是 WAL 模式,拷库不能直接拷文件,得用
sqlite3 .dump导出,不然拷出来是坏的。 - rsync 会保留源文件的权限,目标目录权限不对就 403,部署完要顺手把权限刷一遍。
- Astro 会把没有任何属性的
<script src>标签在构建时吃掉,加载外部 JS 的 script 标签一定记得加个data-*属性。 - 浏览器缓存:每次部署改了文件就升
?v=,哪怕是当天的小修,不然手机上死活看不到新版。 - 有些站的防火墙会拦我这台开发机的出口 IP,构建时抓不到对方的文章,所以备用机的构建要在备用机上做,不能在开发机上构建完传过去。
- 前端改动要部署两次:构建产物发到静态目录,源码也要同步到服务器上,不然下次在服务器上点「重新生成前台」,会用旧源码把新改动盖回去。这条是真金白银踩出来的。
结尾
这套东西没什么高深的,就是把「够用、自己说了算」贯彻到底。博客 2012 年写到现在,换程序不换写字。后面想做的事还不少:说说的图片上传、微信发文章、每条友链的 RSS 地址……慢慢来,写字第一,折腾第二。
暂无评论。