镜像站使用教程

1. 什么是 jsDelivr？

jsDelivr 是一个全球免费 CDN 服务，专门加速前端资源的加载，包括：

• JavaScript 库和框架
• CSS 样式表
• 字体文件
• 图片资源

核心功能

国内访问问题：由于备案吊销，jsDelivr 官方域名 (cdn.jsdelivr.net) 在国内访问受限。本镜像站 (jsd.liiiu.cn) 提供国内优化节点来解决这一问题。

2. 镜像站使用指南

基础规则

将官方域名替换为镜像域名：

- https://cdn.jsdelivr.net
+ https://jsd.liiiu.cn

1. 加载 JavaScript 库

<script src="https://jsd.liiiu.cn/npm/jquery@3.6.0/dist/jquery.min.js"></script>

• npm/：NPM 加速前缀
• jquery：库名称
• @3.6.0：强烈建议指定版本，避免破坏性更新
• /dist/jquery.min.js：资源路径

2. 加载 CSS 文件

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

3. 加载 GitHub 资源

<img src="https://jsd.liiiu.cn/gh/user/repo@v1.2.0/assets/logo.png">

• gh/：GitHub 加速前缀
• user/repo：GitHub 用户名和仓库名
• @v1.2.0：标签、分支或 Commit ID

4. 版本控制技巧

5. 获取最新版本（不推荐）

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

生产环境中这样做有风险，可能因上游破坏性更新导致站点异常。

6. 加载默认文件

当库的 package.json 定义了 main 字段时：

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

会自动返回 package.json 指定的入口文件。

7. 查看目录结构

在路径末尾添加 /：

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

会返回 JSON 格式的目录列表。

3. 镜像站优缺点分析

优势

• 国内 CDN 节点，平均加载速度更低
• 完整兼容 NPM、GitHub、cdnjs 等官方功能
• 支持 SemVer 语义化版本控制
• 免费使用

限制

• 服务稳定性仍可能受政策影响
• 不支持大于 50MB 的大文件
• 建议搭配其他 CDN 或对象存储作为灾备方案

4. 注意事项

安全规范

• 禁止托管敏感数据，例如 API 密钥和配置文件
• 私有仓库资源需通过 ?access_token= 方式授权

性能优化

• 启用长期缓存，例如 Cache-Control: max-age=31536000
• 可配合 SRI 完整性校验一起使用

<script src="https://jsd.liiiu.cn/..." integrity="sha384-..."></script>

故障排查

5. 技术支持