简介

jsDelivr 是一个免费、快速且可靠的开源 CDN 服务，支持 npm、GitHub、WordPress 等多种资源加速，适合前端库、静态资源、图片等文件的全球分发。

使用说明

  • 无需登录和注册，以 GitHub 为例可加速仓库所有内容。
  • 格式：固定地址 https://cdn.jsdelivr.net/gh/ + github用户名/ + github公开仓库名
  • 完整示例：https://cdn.jsdelivr.net/gh/jquery/static/README.md
    注意：新建仓库后首次加速可能需要等待几分钟。

配置参考

npm 加速

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# 加载 npm 上的任意项目
https://cdn.jsdelivr.net/npm/package@version/file

# 加载 jQuery v3.2.1
https://cdn.jsdelivr.net/npm/jquery@3.2.1/dist/jquery.min.js

# 使用版本范围
https://cdn.jsdelivr.net/npm/jquery@3.2/dist/jquery.min.js
https://cdn.jsdelivr.net/npm/jquery@3/dist/jquery.min.js

# 省略版本获取最新（不推荐用于生产环境）
https://cdn.jsdelivr.net/npm/jquery/dist/jquery.min.js

# 自动获取 .min 版本
https://cdn.jsdelivr.net/npm/jquery@3.2.1/src/core.min.js

# 省略文件路径获取默认文件
https://cdn.jsdelivr.net/npm/jquery@3.2

# 目录结尾加 / 获取目录列表
https://cdn.jsdelivr.net/npm/jquery/

github 加速

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# 加载 GitHub release、commit 或分支
https://cdn.jsdelivr.net/gh/user/repo@version/file

# 加载 jQuery v3.2.1
https://cdn.jsdelivr.net/gh/jquery/jquery@3.2.1/dist/jquery.min.js

# 使用版本范围
https://cdn.jsdelivr.net/gh/jquery/jquery@3.2/dist/jquery.min.js
https://cdn.jsdelivr.net/gh/jquery/jquery@3/dist/jquery.min.js

# 省略版本获取最新（不推荐用于生产环境）
https://cdn.jsdelivr.net/gh/jquery/jquery/dist/jquery.min.js
https://cdn.jsdelivr.net/gh/jquery/jquery@latest/dist/jquery.min.js

# 自动获取 .min 版本
https://cdn.jsdelivr.net/gh/jquery/jquery@3.2.1/src/core.min.js

# 目录结尾加 / 获取目录列表
https://cdn.jsdelivr.net/gh/jquery/jquery/

wordpress 加速

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 加载 WordPress 插件
https://cdn.jsdelivr.net/wp/plugins/project/tags/version/file

# 加载指定版本
https://cdn.jsdelivr.net/wp/plugins/wp-slimstat/tags/4.6.5/wp-slimstat.js

# 加载最新版本（不推荐用于生产环境）
https://cdn.jsdelivr.net/wp/plugins/wp-slimstat/trunk/wp-slimstat.js

# 加载 WordPress 主题
https://cdn.jsdelivr.net/wp/themes/project/version/file

# 加载指定主题版本
https://cdn.jsdelivr.net/wp/themes/twenty-eightteen/1.7/assets/js/html5.js

# 自动获取 .min 版本
# 如果没有，会自动生成

作为图床使用

单文件 20MB 限制，程序包 50MB 限制

结合 github + jsdelivr + picgo 可搭建免费图床：

  • 下载并安装 PicGo
  • PicGo 配置示例：
    1
    2
    3
    4
    5
    6
    7
    8
    9
    # 仓库名为 cangk
    # 分支名为 static 或 static+tag
    # 路径为仓库文件路径，如 `img/`、`video/` 或留空

    仓库名：cangk
    分支名：static
    设定 Token：你的 GitHub Token
    指定存储路径：img/
    设定自定义域名：https://cdn.jsdelivr.net/gh/你的用户名/cangk@static
  • 上传图片后，PicGo 会自动生成 jsDelivr 加速链接。

Github生成链接

清理缓存

常见问题与补充说明

1. 国内可用性

  • jsDelivr 在中国大陆可用性较好，但偶尔会有访问不稳定的情况。
  • 若遇到无法访问，可尝试切换到 fastly.jsdelivr.net 或 gcore.jsdelivr.net。
  • 例如：
    • https://fastly.jsdelivr.net/gh/user/repo/file
    • https://gcore.jsdelivr.net/gh/user/repo/file

2. 资源更新延迟

  • 新上传或修改的文件，CDN 刷新通常需要几分钟。
  • 若急需刷新，可用 purge 接口强制刷新缓存。

3. 资源安全与稳定性

  • jsDelivr 仅支持公开仓库。
  • 不建议将敏感或私有文件托管于公开仓库并通过 CDN 分发。

4. 其他实用技巧

  • 可通过目录结尾加 / 浏览仓库文件列表，方便查找路径。
  • 支持自定义域名绑定（需高级配置）。
  • 可结合 GitHub Actions 自动上传和发布静态资源。

5. 相关链接

如有更多问题，欢迎留言交流。