方糖博客半糖生活,微甜日常

文章 · 2026-11-15

博客搭建与改造之AI战记

从 WordPress 换到自研方案:后端 Hono + SQLite,前端 Astro 生成静态页,文章以 Markdown 为源。实现了拼音链接、评论分级、说说同步、微信管理等功能,并记录了部署与踩坑经验。

2012 年 3 月,我用 WordPress 搭了第一个博客。十几年下来,域名换了一堆,主机换了一堆,程序也换了一堆:WordPress、Typecho、Ghost 都用过。2025 年 7 月,博客定名「方糖」,域名定在 fangtang.net,副标题写着:半糖生活,微甜日常。

之前用的程序都挺好,但总有些地方不顺手:想改个细节要去翻插件、翻主题;数据和文件散在各处;想加个自己想要的功能,得先看程序支不支持。后来索性自己写了一个:后端 Hono,前端 Astro,数据放在 SQLite 里,文章就是一个个 Markdown 文件。

这篇文章就是这套东西的搭建和改造记录,想到哪写到哪,贴点代码,算是给自己留个档,也给想折腾的朋友一个参考。

AI配图-博客搭建与改造手记.webp

一、整体长什么样

先说结论:访客看到的是纯静态页面,打开快,也不依赖后端在线;评论提交、搜索、管理后台这些动态的部分,走 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 和数据库,公开页面要等点了「重新生成前台」才变。这是特意这么定的,改几处攒一次再构建。

九、踩过的坑

结尾

这套东西没什么高深的,就是把「够用、自己说了算」贯彻到底。博客 2012 年写到现在,换程序不换写字。后面想做的事还不少:说说的图片上传、微信发文章、每条友链的 RSS 地址……慢慢来,写字第一,折腾第二。

评论

暂无评论。