开源本站博客系统 - Publa
自从 2010 年注册了域名 oldj.net 并架设了这个博客，一转眼已经 16 年了，这么长的时间足够发生很多事，比如杨过和小龙女都已经再次重逢了，本站也经历过了 N 次重构甚至推倒重来。最近，在 AI 的帮助之下，我重写了站点的后台，并决定将这个博客系统开源。
历程
这个博客最早的版本是使用 Django 写的，后台使用了 Django 自带的 admin，前台则使用 Django 的模板输出 HTML。
一段时间之后，我有点懒得继续改进，便迁移到了 WordPress。不得不说，WordPress 的功能非常完善，插件也很多，使用起来非常方便。
再后来，我担心自己维护的 WordPress 有安全问题，便一度将站点迁移到了 WordPress.com 官方服务。
不过，又一段时间后，我发现官方服务有不少限制，比如想在文章中插入数学公式需要升级高级会员，成本实在有点高，加上官方服务位于海外，访问总是有一点慢，于是又迁回了自已部署的 WordPress。
但很快，我发现使用 WordPress 时，如果启用了某些功能或者某些插件，站点仍然需要从海外下载文件，整个博客的访问速度也因此被拖慢，于是又起了自建的心思，花了一些时间，用 egg.js 重写了博客系统。
不过 egg.js 本质上来说仍是上一代框架，或者说是基于后端视角开发的框架，它很适合写后台服务或者传统网站，但对 React 生态的支持则几乎没有。此时，React 等前端框架的边界不断拓展，除了写前端代码，还出现了 Next.js 这样的框架，让它能在服务端渲染 React 组件，解决了之前 React 站点对搜索引擎不友好的问题。
于是，我又开始折腾，用 Next.js 重写了这个博客站点。但这次我只用 Next.js 写了博客的前台页面，后台则改为继续使用 Django，Next.js 通过 API 向 Django 读取数据并渲染。
随着时间的流逝，我又逐渐厌倦了在 Django Admin 中写博客的体验，一直计划着再次改进这个博客，只是一直没抽出时间。
转眼到了 2026 年，AI 的发展如火如荼，Codex、Claude 等模型在写代码方面的表现已经非常出色，也深刻地改变了我日常写代码的方式。我决定花一些时间，在 AI 的帮助下完成这个博客系统后台的改造。
于是，就有了现在这个博客系统，我叫它 Publa（读音：/ˈpʌb.la/，帕布啦）。
设计理念
Publa 不是一个大而全的博客系统，它的目标用户是个人或小团队。在设计和开发过程中，我一直秉承着以下设计理念：
轻量
不要做得太重太复杂，要让部署尽可能简单，比如可以直接在 Vercel 上部署，或者只需要一个 Docker 文件就能部署。
动态
现在有很多静态博客系统，它们使用 Markdown 编写内容，最后生成静态文件并发布上线。
这些博客系统都很不错，且因为是纯静态，运行和维护的成本极低。但缺点也在于纯静态，比如作为静态站点，它们天然不支持评论，如果要让访客发布评论，通常还需要使用第三方工具，无论是体验还是数据，都比较割裂。
如果说评论还能用第三方工具搞定，另外一些比如定时发布、历史记录、站内搜索等等功能，静态博客系统就基本没有办法了。
我希望这个新的博客系统自身就能支持评论、留言、定时发布、站内搜索等功能，因此做成动态便是更好的选择。
易于自定义
Publa 内置了浅色和深色两个主题，同时支持自建主题，或者添加自定义 CSS。
同时，在后台设置中，还开放了自定义 HTML 片断的功能，支持在 <head>末尾、 <body> 开头或末尾等位置插入自定义 HTML。
因此，理论上来说，你可以根据偏好，自定义 Publa 博客前台页面的所有外观样式。
易于迁移
Publa 博客的数据可以一键导出为 JSON 文件，你也可以根据这个格式规范，将其他博客的内容转为 JSON 并导入 Publa。
这个导出功能，也可以用作站点的数据备份。
所见即所得编辑器
Markdown 是一项伟大的技术，我也用 Markdown 写了多年的博客和各类文档。不过，当我开始编写 Publa 后台时，我还是添加了一个基于 TipTap 的所见即所得编辑器。我已经用这个编辑器写了几篇文章，目前感觉良好，尤其是在要插入图片等场景，所见即所得编辑器会更加直观易用。
当然，如果你偏好手写 Markdown，或者想发布已经用 Markdown 格式写好的内容，Publa 后台也支持直接输入 Markdown。
顺便，Publa 的编辑器支持内容自动保存，写作的时候，每隔 5 秒会将编辑器中的内容保存到 localStorage，每隔 30 秒会自动将内容保存到云端草稿，如果连续三次自动保存失败（比如网络中断）会在顶部显示通知；同时，后台还会定期为变化的内容保存历史版本，后续如有需要可随时查看或恢复到之前的版本。基本上，你可以放心地在 Publa 后台撰写文章，而不用担心内容丢失。
支持添加自定义页面
除了博客文章，有时我们还需要添加一些自定义页面，比如「关于」页面。
在 Publa 中，你可以任意添加自定义页面，并指定访问路径，只要这个路径与已有页面不重复即可。自定义页面支持复用当前页面框架（页头、页脚），可用于快速添加一些常见的功能页面，也支持不使用任何模板，由你直接输入整个页面的 HTML，添加完全自定义的页面。
一些特色
除了以上设计理念外，Publa 还有一些值得提一下的特色功能。
支持附件上传
写博客少不了配图，有时可能还要向用户提供一些文件以供下载。Publa 内置支持 AWS S3、Cloudflare R2、阿里云 OSS、腾讯云 COS，如果你有这些平台的账号，可在 Publa 后台添加配置，之后便可以直接在附件管理页面上传和查看附件了。也可以直接在编辑器中粘贴图片，Publa 会自动将图片上传到你配置的平台。
Publa 会管理通过它上传的文件，如果你在 Publa 后台删除了文件，对应的存储平台上的文件也会同时删除。
一键将图片设为 1/2 尺寸
这是我之前写博客时的一个痛点。
随着高分屏的普及，我们给屏幕截图时，得到的图片尺寸通常是截图区域的两倍大小，插入到博客中时，我们希望它能以实际尺寸的 1/2 大小进行显示。
在大多数富文本编辑器中，作者只能拖拽调整图片尺寸，然后凭感觉调一个差不多的尺寸。或者在 Markdown 编辑器中，先查看一下原图的尺寸，再人工计算一下，输入一个 1/2 的宽度。
在 Publa 的编辑器中，我专门优化了这个流程，插入图片后，点击选中图片，图片上方便会浮现一个快捷工具栏，其中便有一个将图片一键设为 1/2 尺寸的按钮。如果你使用高分屏并经常要在文章中插入屏幕截图，那么这个功能对你应该会很有用。
支持添加自定义跳转
在 Publa 中，你可以添加自定义跳转规则，将任意访问路径跳转到指定的路径。
如果你之前在使用其他博客系统，它的文章的路径结构和 Publa 不同，那么你可能会需要这个功能，用于将文章的老路径跳转到新路径，以便用户访问老路径时能正确跳到新的页面。
比如老博客系统中文章路径是 /article/{slug} 这样的形式，但 Publa 中文章路径是 /posts/{slug} ，那么便可以设置一条类似下图的跳转规则，以便平滑迁移。
支持 SQLite 和 PostgreSQL
既然是动态博客，后台数据库自然少不了。Publa 同时支持 SQLite 和 PostgreSQL 两种数据库，你可以根据需要选择。
由于支持 SQLite，如果你想开发调试 Publa 非常简单，只需从 GitHub 上下载源码，安装依赖，然后使用 npm run dev 即可启动测试服务器，在没有指定数据库的情况下，Publa 会自动创建并使用本地 SQLite 以便尽快开始开发调试工作。
值得一提的是，Publa 不仅支持本地 SQLite，还支持 Turso 提供的在线 SQLite 服务。Turso 有足够小项目使用的免费额度，因此，对大多数个人博客或小团队博客来说，可以将 Publa 部署在 Vercel 上并使用 Turso 提供的数据库，完全零成本运行。
小结
以上便是对博客系统 Publa 的介绍。
你现在看到的这个博客就是基于 Publa 的，我已经使用这个系统一段时间了，将持续使用并不断改进完善它，如果你也想架设一个动态博客，不妨试一试 Publa。
Publa 基于 MIT 协议开源，任何人都可以免费下载和使用它。
当然，Publa 还很年轻，且之前只有我一位用户，因此可能有一些一直没被发现的 bug，如果你发现了问题，欢迎在 GitHub 上给我提 issue！
最后，希望 Publa 能帮你更好地完成博客写作！❤️
评论：