使用 jsDelivr 免费加速 GitHub Pages 博客的静态资源

挺久以前就有网友给我的 GitHub Pages 博客模板提 Issue，说希望能增加 CDN 用于加速静态资源的加载，由于懒，一直没有动。

最近偶尔要打开自己博客看下 Wiki 的时候，要等挺久，比较痛苦，碰巧昨天晚上看到这样一篇帖子：GitHub 图床的正确用法，通过 jsDelivr CDN 全球加速，感觉很适合我的需求场景，于是决定趁这几天休假将这个改造一下。

以下改造前后的加载情况都是在 Edge 浏览器禁用缓存后录制的，录制时间段很接近，从本地访问两个 GitHub Pages 服务的原始响应速度应该类似。

改造前加载

注：由于改造前没有保留加载图，所以这是截的一个使用相同模板的朋友的首页加载情况。

可以看到耗时最长的两个请求时间达到了 12 秒左右，而且很多资源的加载时间在 1 秒以上，页面完成加载时间长达 15 秒多……估计一般的访客是没这个耐心等待的。

改造后加载

这样一对比效果还是很明显的。改造过后耗时最长的是两个没办法走 CDN 的请求，而走 CDN 的那些资源加载时间基本都没超过 60 毫秒，页面完成加载时间缩短到了 3 秒以内。

当然，因为页面自身还是在 GitHub Pages 托管，有时候首个请求还是会挺久才返回。

改造后的效果可以打开 https://mazhuang.org 体验。

优化独立博客的加载速度有一些不同的思路，对应不同的方案：

1. 优化博客代码，精简需要加载的资源；
2. 将博客部署到国内访问快的服务器上；
3. 部署到国内的代码托管平台，比如 Gitee 和 Coding 等；
4. 采用 CDN 加速；

其中 2 和 3 我不想考虑，还是期望只在 GitHub 上管理博客，所以 1 和 4 是优化方向，本文对应的就是 4 的部分。

而采用 CDN 加速的方案，可以考虑

• 将公共库改为直接引用公共 CDN 链接；

• 自己编写和修改的静态资源自己去托管在一个 CDN 服务上。

  有一些 CDN 服务商提供一定的免费额度，可以按喜好选用，或者选择付费服务。这里我没有纠结，看完文首提到的那篇文章，去看了下 jsDelivr 的介绍后觉得靠谱：它原生支持使用 GitHub 项目里的资源，什么都不用配置，更重要的是免费，在国内有节点，而且速度还不错（官网上也把 works in China 作为一个卖点的），遂决定直接用它。

jsDelivr 支持的 GitHub 资源的方式

jsDelivr 对 GitHub 的支持是作为重要特性来宣传的，官网的介绍链接：https://www.jsdelivr.com/features#gh，以下是一些认为需要了解的知识的小结：

这里以我托管博客的 GitHub 仓库为例，地址是 https://github.com/mzlogin/mzlogin.github.io，那它里面的资源可以直接以 https://cdn.jsdelivr.net/gh/mzlogin/mzlogin.github.io/ + 仓库里的文件路径 来访问。

比如仓库里有一个 js 文件 assets/js/main.js，那么它可以用 CDN 链接 https://cdn.jsdelivr.net/gh/mzlogin/mzlogin.github.io/assets/js/main.js 来访问。

另外还支持一些高级用法，比如：

1. 指定 release 版本号/提交 sha1/分支名称，例如指定获取该仓库的名称为 1.2.0 或 v1.2.0 的 release 版本资源：

    https://cdn.jsdelivr.net/gh/mzlogin/[email protected]/assets/js/main.js
   

   如果指定版本为 1 或者 1.2，那它会自动匹配到这个范围内的最新版本号。

   也可以不指定版本或者指定版本为 latest，这样总是使用最新版本的资源。

2. 压缩资源，在 js/css 文件后缀前面加上 .min：

    https://cdn.jsdelivr.net/gh/mzlogin/[email protected]/assets/js/main.min.js
   

3. 合并多个文件，用 combine/file1,file2,file3 格式的链接：

    https://cdn.jsdelivr.net/combine/gh/mzlogin/[email protected]/assets/js/main.min.js,gh/mzlogin/[email protected]/assets/js/simple-jekyll-search.min.js
   

压缩资源、合并文件的 CDN 链接在第一次有人访问时可能比较慢，后面再有人访问就快了。

其它知识点：

• 可以通过 https://cdn.jsdelivr.net/combine/gh/mzlogin/mzlogin.github.io[@<版本号>]/[<文件夹>/] 这样的路径浏览缓存文件列表；
• 可以访问 https://purge.jsdelivr.net/gh/mzlogin/[email protected]/assets/js/main.js 来清除指定文件的缓存；（将引用的 CDN 链接里的 cdn 改成 purge 就是了）
• 可以访问 https://data.jsdelivr.com/v1/package/gh/mzlogin/mzlogin.github.io 来查看 CDN 上的 tags 和 versions 列表，更多数据接口参数参见 https://github.com/jsdelivr/data.jsdelivr.com。

下面是记录具体改造博客模板的步骤：

1. 在 _config.yml 文件中添加控制开关：

    # 对 css 和 js 资源的 cdn 加速配置
    cdn:
        jsdelivr:
            enabled: true
   

2. 修改 _layouts 里的文件，给名为 assets_base_url 的变量赋值，用它来代表加载静态资源的根路径：

    {% assign assets_base_url = site.url %}
    {% if site.cdn.jsdelivr.enabled %}
        {% assign assets_base_url = "https://cdn.jsdelivr.net/gh/" | append: site.repository | append: '@master' %}
    {% endif %}
   

3. 修改以前直接用 {{ site.url }} 拼接的静态资源引用链接，替换为 {{ assets_base_url }}，比如 _includes/header.html 里：

    - <link rel="stylesheet" href="{{ site.url }}/assets/css/posts/index.css">
    + <link rel="stylesheet" href="{{ assets_base_url }}/assets/css/posts/index.css">
   

这样万一哪天 CDN 出了点什么状况，我们也可以很方便地通过一个开关就切回自已的资源链接恢复服务。

主要就是这类修改，当然涉及的地方有多处，以上只是举一处例子记录示意，改造过程和改造后的代码可以参考我的博客仓库 https://github.com/mzlogin/mzlogin.github.io。

• 如果项目曾经打过 tag，那么新增/修改静态资源后，需要刷新 CDN 缓存的话，需要打个新 tag；

  一般发生在修改了博客模板的 js/css 以后。我也还在摸索如何省去这一步的方法。

  Update: 我后来采用的解决方法是删除了所有的 tag，这样以前的 release 就变成了 Draft，对外是不可见的，因为我这个仓库不需要对外可见的 release，所以这个问题也就解决了，不需要再操心刷新 CDN 的问题了。

• 使用 jsDelivr 免费加速 GitHub Pages 博客的静态资源（二）