博客最近的架构改动

创建 更新

嗯，是的，我又回来了。最近打算写一篇关于数据驱动UI的博文，于是我又关注起了我的博客，然后发现有个事项好像还没做：更新博客的构建。正好我自己的Git托管服务也搭得差不多了，我就考虑把构建迁移到我自己的服务上。当然，现在这种情况再用GitHub Pages不方便——于是网页就换成Cloudflare Pages托管。

这就是这次架构更新的大概方向。不过，这次改动中我确实遇到了一些问题，这些才是有意思的部分。

Hexo的增量构建

不知道之前有没有人注意博客文章的时间，所有博客文章的更新时间都是一样的，而且实际上没有任何更新（xD）。我一直以为Hexo只能一次构建全部页面，但是这次我想顺便看看有没有增量更新的方案——然后我就发现Hexo其实是支持增量更新的！（GitHub issue）只需要保留db.json和生成产物文件夹public就可以了。

所以我在构建的时候，直接将它们缓存起来，这样就可以最小化每次构建的变更（Actions工作流描述文件）。

1
2
3
4
5
6
7
8
9
10
# ...
    - name: Cache Generated Files
      id: files-cache
      uses: actions/cache@v4
      with:
        path: |
          public/**
          db.json
        key: generated-files-1
# ...

当需要重新构建整个网站的时候，只需要改一下key就可以了。我想到这回事是因为另一个惨痛教训……

actions/checkout@v4无法检出LFS文件

这次迁移还涉及到另一个我想试用的新东西：Git LFS (Large File System)。作为一个博客，有点二进制大文件再正常不过了：图片、pdf、幻灯片……所以我按照说明在本地安装了程序、设定参数、Commit、推送、等待部署。看起来一切都挺好，然后我就睡觉去了。

第二天起床打开某篇文章一看：我的图片呢？打开开发者工具查看一下网络请求，是有这个文件，但是好像不是图片，而且统一在130字节左右。我知道检出LFS需要一个额外的下载过程，所以我检查了一下actions/checkout@v4，发现它有一个默认不启用的lfs参数。

看来就是这个问题，我就打开了这个功能，等待图片回到我的网站。

1
2
3
4
5
6
[command]/usr/bin/git lfs fetch origin refs/remotes/origin/master
fetch: Fetching reference refs/remotes/origin/master
...
error: failed to fetch some objects from 'https://code.lightstands.xyz/Rubicon/blog.git/info/lfs'
::remove-matcher owner=checkout-git::
::error::The process '/usr/bin/git' failed with exit code 2

“？”

是不是遇上了和Forgejo Actions一样的网络问题（DNS不生效导致我没办法隔离执行actions的网络）？我怀疑是因为我手动将代码托管网站指定为内网地址造成的，于是我登上服务器修改了hosts，问题依旧。

然后我就只能在网络上漫游，寻找一个答案。然后，啊哈，我发现你啦！就是这个：#164 ‘actions/checkout@v3’ with LFS fails because of double auth header on gitea.com/gitea/act_runner。

原来这个是actions/checkout的bug，它会为两个相同的域名设置相同的HTTP头用作验证，导致HTTP头重复了。如果HTTP服务器比较严格的话就会拒绝服务。因为我没在Nginx的日志里找到相关信息，只能死马当活马医，先试试他的workaround，结果就能用了。

但是增量更新没有更新老文件，于是我再重新生成整个网站，图片这下就出现了。

大概是LFS用的人真的不多吧。

Robots.txt

这个是我偶然发现的。我想用Google的PageInsight看一下我网页的加载速度，自我得瑟一下（xD）。然后发现在SEO这项下面提示Robots.txt格式错误，里面是我的主页。

这大概是因为Cloudflare Pages对所有文件名找不到的请求返回主页（嗯，index.html，有人把这个叫做“伪静态”），所以如果没有Robots.txt，它也会返回主页。这也是个GitHub Pages没有的功能，所以我也没注意。为了正常被索引，我只好自己添加了一个空的Robots.txt。