用 Cloudflare / jsDelivr 加速 GitHub 静态资源

如果你要在网页里引用 GitHub 上的 JS/CSS/图片,或让访客更快下载仓库里的文件,借助公共 CDN 能显著提速——尤其对国内访客。本文讲最常用的 jsDelivr 与 Cloudflare 思路。

一、jsDelivr:GitHub 仓库文件加速(最常用)

jsDelivr 是免费公共 CDN,直接镜像 GitHub 仓库文件。转换规则:

# GitHub raw 原地址
https://raw.githubusercontent.com/用户/仓库/分支/路径/file.js

# jsDelivr 加速地址
https://cdn.jsdelivr.net/gh/用户/仓库@分支/路径/file.js

要点:

• gh/ 表示 GitHub 源,@分支 可换成 @标签 或 @commit(更稳定,推荐锁版本)。
• 支持整个目录,也支持自动压缩(.min.js)。

示例:

<!-- 引用某仓库 main 分支的 CSS -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/用户/仓库@main/dist/style.css">

<!-- 锁定到某个 tag,避免以后文件变动 -->
<script src="https://cdn.jsdelivr.net/gh/用户/仓库@v1.2.0/dist/app.min.js"></script>

也支持 npm 包:

<script src="https://cdn.jsdelivr.net/npm/包名@版本/dist/包.min.js"></script>

限制

jsDelivr 有单文件大小限制,不适合超大文件 / Release 大附件。大文件加速见 Release 下载加速。另外 jsDelivr 有缓存,刚推送的改动可能延迟几分钟生效,@commit 或刷新缓存可解决。

二、加速 GitHub Pages 站点(Cloudflare)

如果你用 GitHub Pages 建站,想让国内访客更快、更稳,可以在前面套一层 Cloudflare:

1. 域名 DNS 托管到 Cloudflare。
2. 添加一条 CNAME 记录指向你的 用户名.github.io。
3. 开启 Cloudflare 的 Proxy(橙色云),启用 CDN 缓存与 HTTPS。

这样访客访问的是 Cloudflare 边缘节点,回源到 GitHub Pages,既加速又隐藏源站、抗一定流量。

三、raw 文件 / 脚本加速

安装脚本、配置文件走 raw 慢时,同样用 jsDelivr 替换 raw 链接:

sh -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/用户/仓库@分支/install.sh)"

详见 👉 raw.githubusercontent.com 无法访问的修复方法。

四、常见问题

Q:jsDelivr 也打不开? 少数网络下公共 CDN 域名也会被干扰。可换其他 CDN 镜像,或走 代理。

Q:改了文件但 jsDelivr 还是旧的? CDN 缓存所致。用 @commit 精确引用,或通过 jsDelivr 的 purge 接口刷新。

Q:能加速私有仓库吗? 不能。jsDelivr 只镜像公开仓库。私有内容请走代理直连。

适用场景速查

需求	方案
网页引用 GitHub 上的 JS/CSS	jsDelivr gh/
README / 网页里的图片	jsDelivr gh/(见 图片不显示)
一键安装脚本(raw)	jsDelivr 替换 raw
GitHub Pages 整站加速	Cloudflare 套 CDN
Release 大附件	见 下载加速

小结

• 仓库内小文件 / 静态资源 → jsDelivr,改个链接即可,强烈建议锁 @tag/@commit。
• Pages 整站 → 套 Cloudflare CDN。
• 大文件、私有仓库 → CDN 不适用,走 代理 或专门的下载加速。

---

本文仅供技术学习与研究,请遵守所在国家/地区法律法规。