镜像站使用教程

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 节点：平均加载速度 <100ms（官方节点 >300ms）
• 全功能支持：完整兼容 NPM/GitHub/cdnjs 等官方功能
• 版本管理：支持 SemVer 语义化版本控制
• 零成本：完全免费使用

⚠️ 限制

• 服务稳定性：受政策影响可能存在调整风险
• 文件限制：不支持 >50MB 的大文件（如视频/RAW 图片）
• 备用方案：建议搭配 七牛云 或 Cloudflare 作为灾备方案

4. 注意事项

安全规范

• 🚫 禁止托管敏感数据（如 API 密钥、配置文件）
• 🔒 私有仓库资源需通过 ?access_token= 授权（参考 GitHub API）

性能优化

• 启用长期缓存（推荐 Cache-Control: max-age=31536000）
• 使用 SRI 完整性校验：

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

故障排查

5. 技术支持