使用方法

1. 什么是 jsDelivr?

jsDelivr 是一个全球性的免费 CDN(内容分发网络),用于加速 JavaScript、CSS、图片、字体文件等前端资源的加载。它可以帮助站长减少服务器带宽占用,并提高网站的访问速度。

jsDelivr 主要支持以下几种加速服务:

  • NPM 加速: 加速 NPM 上的前端库和框架。
  • GitHub 仓库加速: 直接从 GitHub 加载 JavaScript、CSS、图片等资源。
  • WordPress 插件加速: 专门为 WordPress 提供的加速方案。
  • cdnjs 加速: 提供经典 JavaScript 库的快速加载。

然而,由于某些原因,jsDelivr 的国内备案已被吊销,导致国内访问速度大幅下降,甚至部分地区出现无法访问的情况。为了解决这个问题,本镜像站(jsd.liiiu.cn)提供了 jsDelivr 的国内优化版。

2. 使用本镜像站的基本方法

本镜像站的使用方式与官方 jsDelivr 完全一致,唯一的区别是需要将 https://cdn.jsdelivr.net 替换为 https://jsd.liiiu.cn

(1)加载 JavaScript 库

例如,要加载 jQuery,你可以这样写:

<script src="https://jsd.liiiu.cn/npm/jquery@3.6.0/dist/jquery.min.js"></script>
  • https://jsd.liiiu.cn/npm/:使用 NPM 加速服务。
  • jquery:要加载的库名称。
  • @3.6.0:指定版本号(可省略,但建议指定)。
  • /dist/jquery.min.js:资源文件路径。

(2)加载 CSS 文件

例如,要加载 Bootstrap:

<link rel="stylesheet" href="https://jsd.liiiu.cn/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css">

(3)加载 GitHub 资源

支持从 GitHub 直接加载文件,例如:

<img src="https://jsd.liiiu.cn/gh/user/repo@version/path/to/image.png" alt="Example Image">
  • https://jsd.liiiu.cn/gh/:使用 GitHub 加速服务。
  • user/repo:指定 GitHub 用户和仓库。
  • @version:可选的版本号。
  • /path/to/image.png:文件路径。

(4)获取文件的不同版本

你可以使用版本范围,而不是固定版本:

https://jsd.liiiu.cn/npm/jquery@3.6/dist/jquery.min.js
https://jsd.liiiu.cn/npm/jquery@3/dist/jquery.min.js

(5)获取最新版本

如果想始终使用最新版本,可以省略版本号:

https://jsd.liiiu.cn/npm/jquery/dist/jquery.min.js

⚠️ 重要提示: 生产环境中不建议省略版本号,以确保文件稳定性。

(6)获取默认文件

如果库的 package.json 中定义了默认文件,则可直接访问:

https://jsd.liiiu.cn/npm/jquery@3.6

(7)获取目录列表

在路径末尾添加 / 以查看目录结构:

https://jsd.liiiu.cn/npm/jquery/

3. jsDelivr 国内镜像的优缺点

优点:

  • 采用国内加速节点,提供更快的访问速度。
  • 支持 NPM、GitHub、WordPress、cdnjs 等多种资源加速。
  • 具备版本管理功能,方便开发者锁定特定版本。
  • 免费提供服务,无需额外配置。

缺点:

  • 由于某些政策原因,可能随时调整或关停。
  • 不支持直接加载大文件,如视频或高分辨率图片。
  • 建议搭配其他国内国外 CDN(如 Cloudflare七牛云)以提高稳定性。

4. 其他注意事项

  • 请勿使用本服务托管私人或敏感文件。
  • 若资源长期不可用,请检查 GitHub 仓库或 NPM 包是否仍然存在。
  • 为确保最佳性能,建议结合浏览器缓存策略。

5. 联系站长

如果你在使用过程中遇到任何问题,欢迎通过以下方式联系站长:

希望本镜像站能给你带来更快的前端资源加载体验!🎉