做一个自己的博客,最有意思的部分不只是写文章,还有把它从本地电脑稳稳地送到互联网上。

我现在更喜欢把这件事拆成两部分:本地负责写作和生成页面,服务器负责稳定地把页面交付给访客。这样一来,发布流程更简单,也不用让服务器承担不必要的构建工作。

为什么选静态博客

像 Hexo 这样的静态博客工具,会把 Markdown 文章和主题模板生成 HTML、CSS、JavaScript 文件。访问者打开网页时,服务器只要把这些文件返回即可,不必为每次访问查询数据库或运行博客后台。

这套方式特别适合个人博客:

  • 文章用 Markdown 管理,迁移和备份都方便;
  • 生成后的站点可以部署到普通 Web 服务器;
  • 没有数据库和在线编辑后台,维护面相对简单;
  • 本地预览和构建通过后再发布,线上环境更可控。

当然,静态站点也意味着写文章、生成页面通常要在本地完成。对个人博客来说,这往往是一个很划算的取舍。

发布链路:先生成,再上传

一次发布可以看作四步:

  1. 在 source/_posts/ 下写 Markdown;
  2. 在本地预览,检查正文、链接和排版;
  3. 运行 Hexo 生成静态文件;
  4. 把 public/ 的内容上传到服务器的网站目录。

生成过程可以先在本地确认:

1
2
npx hexo clean
npx hexo generate

完成后,生成的网站文件会放在 public/。部署时上传的是这些生成结果,而不是整个项目目录;服务器也不需要安装 Hexo 或 Node.js 来处理每次页面请求。

服务器上要准备什么

一台 Linux 服务器通常需要完成几件事:把域名解析到服务器、安装并配置 Nginx 或其他 Web 服务、准备网站目录,以及为站点启用 HTTPS。

以 Nginx 为例,站点配置的核心是让域名对应到静态文件目录。部署前先确认:

  • 域名的 DNS 记录已经指向服务器;
  • Web 服务读取的网站目录与部署目录一致;
  • HTTP 和 HTTPS 都能正确访问;
  • 部署账号只拥有更新站点所需的权限。

证书和防火墙规则要根据实际服务器系统及服务商配置。不要为了方便把管理端口或文件权限开放给所有人;能用 SSH 密钥认证时,优先使用密钥并妥善保管私钥。

让上传变成可重复的流程

手动复制文件也能上线,但很容易漏文件或传错目录。把构建和上传写进部署脚本之后,每次发布都能走同一条流程:构建、打包、上传、解压。

服务器地址、登录用户和目标目录等参数则放在本地单独的配置文件中,不要写进文章、脚本或公开仓库。发布前也要确认目标目录确实是网站目录,避免把文件传到错误位置。

发布之后,我会至少检查首页和刚发布的文章链接;如果页面异常,先看构建输出和服务器日志,再判断是静态文件、域名解析还是 Web 服务配置的问题。把问题按链路拆开,通常比一上来重装服务更快。

备份和回滚别等出问题再想

静态站点没有数据库,并不代表不需要备份。至少保留两份东西:

  • 项目源文件,尤其是 source/、主题和站点配置;
  • 最近一次可用的构建产物,或服务器上的上一版站点文件。

更新前保留上一版,更新后做一次访问检查。这样即使新版本缺资源或配置出错,也能先恢复旧页面,再慢慢排查。文章源文件最好也用版本管理,服务器则不要成为唯一存放副本的地方。

我的检查清单

每次发布前,我会快速过一遍:

  • 新文章的标题、日期和标签是否正确;
  • 本地构建是否成功,生成页面是否存在;
  • 上传目标是否正确,服务器连接配置是否保密;
  • 发布后首页、文章页和静态资源能否正常打开;
  • 是否保留了源文件和可回滚的版本。

把博客部署到自己的服务器,真正需要花心思的不是“把文件传上去”,而是让写作、构建、发布、检查和回滚连成一条可靠的链路。链路清楚之后,服务器就不再是一个需要反复手工照看的黑盒,而是整个写作流程里稳定的一环。