2026-11 全站Typecho迁移Kite记录

· 3 MIN · 974 字

这个月给站点做了一次比较大的调整:把原来跑在腾讯云上的 Typecho 博客,迁到了基于 Kite 的纯 Markdown 博客,并顺手把写作、发布、排版和视觉都重新整理了一遍。

为什么要迁移

腾讯云 Lighthouse 实例将在 2027-04到期,于是开始考虑后续怎么续命。Cloudflare 免费版很诱人,但它不跑 PHP 和 MySQL,Typecho 没法原样搬过去。几番比较之后,选了 Kite:一个 Go 写的单二进制博客引擎,文章是磁盘上的 Markdown 文件,既能本地写作,也能导出纯静态页面,正好适合免费托管。

迁移过程

1. 新建备份站

在宝塔里新建 www2.dosth.fun,单独申请 Let's Encrypt 证书并开启 HTTP 强制跳转,先把导航站的内容复制过去作为快照。

2. 导出 Typecho 数据

直接从数据库读出文章、页面、分类、标签、关系表和评论:

  • 12 篇文章、7 个页面
  • 68 个分类/标签
  • 53 条评论
  • 88 个上传附件,约 14MB

然后写转换脚本,把 Typecho 的内容生成成 Hexo 兼容的 Markdown 源文件:标题、日期、分类、标签写成 front matter,图片地址从绝对路径改成站内路径,每篇文章写入 permalink 保留原来的 /archives/xxx.html 地址。

3. 导入 Kite 并生成静态站

用 Kite 自带的 kite import hexo 导入,得到 11 篇文章、1 个页面、88 个附件和 11 个旧地址别名;再执行 kite build 生成静态页面,发布到 www2。

旧链接并不会 404——Kite 会为每个别名生成一个带 canonical 的跳转页,原来的 /archives/154.html 之类地址仍然能用。

写作与自动发布

浏览器写作后台

Kite 自带写作后台 Studio

保存后自动上线

写完之后不用手动构建:后台服务每 10 秒检查一次源文件变化,检测到改动后等待 5 秒防抖,然后自动重新构建,并用 rsync 同步到站点目录。整个过程大约 15–20 秒,同步时会避开 SSL 验证目录和宝塔的 .user.ini。

视觉与排版

字体

博客借鉴了 kite.plus 的字体方案,正文与标题用 Noto Serif SC,代码与标签用 JetBrains Mono。为了避免依赖 Google Fonts,字体全部下载到服务器本地。Noto Serif SC 原本按汉字拆成上百个子集,这里只提取博客实际用到的 1071 个字符对应的 114 个子集,约 4MB。

顶部横幅

做了一张高压输电线交错风格的宽幅图:铁塔剪影、层叠线缆和暖色霞光,左侧留白正好放首页标题。旧的电路图版本留在服务器备份里。

旧语法清理

迁移过程中发现几类 Typecho/Handsome 遗留语法在 Kite 里不能正常渲染,已全部批量清理:

  • ##标题 缺空格,改成 ## 标题
  • [button ...]文字[/button] 短代码改成普通 Markdown 链接
  • Handsome 专有的播放器、折叠框、Tab 短代码改成行内代码、details 和列表
  • 文末 [1]: url 参考式链接改成内联写法
  • 双层方括号 [[Steam](url)] 改成标准链接

另外,主题导航指向 /about/,而页面实际落在 /aboutme/,已通过别名修复,旧地址 /aboutme.html 也能正常跳转。

结果

项目 状态
文章与页面 11 篇文章、1 个页面已迁移
旧链接 11 个 /archives/xxx.html 别名保留
附件 88 个文件完整迁移
评论 53 条已导出 JSON 备份,静态站暂不显示
写作后台 /admin/ 可用
自动发布 Markdown 保存后约 15–20 秒上线

这次迁移把 content 从数据库里解放出来,文章就是普通的 Markdown 文件,备份和版本管理都变得简单。后续如果正式切到免费托管,也不用再受 PHP 和数据库的限制。