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

2020/05/01 GitHub 共 3209 字,约 10 分钟

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

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

先看效果

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

改造前加载

before use cdn

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

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

改造后加载

after use cdn

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

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

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

方案考虑

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

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

其中 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.0v1.2.0 的 release 版本资源:

     https://cdn.jsdelivr.net/gh/mzlogin/mzlogin.github.io@1.2.0/assets/js/main.js
    

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

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

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

     https://cdn.jsdelivr.net/gh/mzlogin/mzlogin.github.io@1.2.0/assets/js/main.min.js
    
  3. 合并多个文件,用 combine/file1,file2,file3 格式的链接:

     https://cdn.jsdelivr.net/combine/gh/mzlogin/mzlogin.github.io@1.2.0/assets/js/main.min.js,gh/mzlogin/mzlogin.github.io@1.2.0/assets/js/simple-jekyll-search.min.js
    

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

其它知识点:

  • 可以通过 https://cdn.jsdelivr.net/combine/gh/mzlogin/mzlogin.github.io[@<版本号>]/[<文件夹>/] 这样的路径浏览缓存文件列表;
  • 可以访问 https://purge.jsdelivr.net/gh/mzlogin/mzlogin.github.io@1.2.0/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 的问题了。

参考链接

文档信息

Search

    Table of Contents