2026-11 全站Typecho迁移Kite记录
这个月给站点做了一次比较大的调整:把原来跑在腾讯云上的 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 和数据库的限制。