跳转到正文
ZStatic.net ZStatic

文档页面

快速开始

了解如何将 cdnjs、BootCDN、Staticfile 和 unpkg 链接替换为 ZStatic CDN 地址，并遵守使用规则。

更新于

在使用本服务前，建议完整阅读该页面，以充分了解使用方法与应该遵守的规则。

一、替换链接

cdnjs 资源

将下列任一前缀替换为 https://s4.zstatic.net/ajax/libs/：

  • https://cdnjs.cloudflare.com/ajax/libs/
  • https://cdn.bootcdn.net/ajax/libs/
  • https://cdn.bootcdn.net/（省略 /ajax/libs/ 的写法）
  • https://cdn.staticfile.net/
  • https://cdn.staticfile.org/（Staticfile 旧域名）

比如：

- https://cdnjs.cloudflare.com/ajax/libs/jquery/3.5.1/jquery.min.js
- https://cdn.bootcdn.net/jquery/3.5.1/jquery.min.js
- https://cdn.staticfile.net/jquery/3.5.1/jquery.min.js
+ https://s4.zstatic.net/ajax/libs/jquery/3.5.1/jquery.min.js

您可以参考 cdn.zstatic.net 搜索 cdnjs 上的库。

npm 资源

将 https://unpkg.com/ 替换为 https://s4.zstatic.net/npm/：

- https://unpkg.com/preact@10.26.4/dist/preact.min.js
+ https://s4.zstatic.net/npm/preact@10.26.4/dist/preact.min.js

二、在 HTML 中引用

替换后的链接可以直接用于 HTML，样式与脚本的写法如下：

<!-- 样式文件 -->
<link
  rel="stylesheet"
  href="https://s4.zstatic.net/ajax/libs/bootstrap/5.3.3/css/bootstrap.min.css"
  integrity="sha384-..."
  crossorigin="anonymous"
/>

<!-- 脚本文件 -->
<script
  src="https://s4.zstatic.net/ajax/libs/jquery/3.7.1/jquery.min.js"
  integrity="sha384-..."
  crossorigin="anonymous"
></script>

上面的 integrity 值仅为占位示例，请替换为实际文件的校验值。出于安全考虑，建议您使用时增设 SRI，我们提供简单的 生成器，可为链接生成 sha384 或 sha512 校验值。使用 SRI 时请保留 crossorigin="anonymous"，否则浏览器可能拒绝加载跨域资源。

三、批量替换

为便于迁移，可以使用以下命令批量替换项目中的链接。命令会原地修改文件，执行前请先提交代码或做好备份。

# cdnjs
find . -type f -exec sed -i 's#https://cdnjs.cloudflare.com/ajax/libs#https://s4.zstatic.net/ajax/libs#g' {} +

# BootCDN：先替换带 /ajax/libs/ 的完整路径
find . -type f -exec sed -i 's#https://cdn.bootcdn.net/ajax/libs#https://s4.zstatic.net/ajax/libs#g' {} +

# BootCDN：再替换省略 /ajax/libs/ 的写法
find . -type f -exec sed -i 's#https://cdn.bootcdn.net#https://s4.zstatic.net/ajax/libs#g' {} +

# Staticfile：新域名与旧域名
find . -type f -exec sed -i 's#https://cdn.staticfile.net#https://s4.zstatic.net/ajax/libs#g' {} +
find . -type f -exec sed -i 's#https://cdn.staticfile.org#https://s4.zstatic.net/ajax/libs#g' {} +

# unpkg
find . -type f -exec sed -i 's#https://unpkg.com#https://s4.zstatic.net/npm#g' {} +

上述命令适用于 Linux 的 GNU sed；macOS 自带的 sed 需要写成 sed -i ''。BootCDN 的两条命令顺序不能颠倒，否则 cdn.bootcdn.net/ajax/libs/ 会被重复拼接为错误的路径。

四、版本号规则

  • 请始终使用精确版本号，例如 jquery/3.5.1 或 preact@10.26.4。
  • 不支持版本范围（如 preact@10），这类链接会直接请求失败。
  • ^10、latest 或省略版本号（如 /npm/preact/...）不由 ZStatic 节点直接提供服务，而是会重定向至站外上游 unpkg 主机，失去镜像加速效果且可能请求失败；请务必使用精确版本号。

使用须知

一旦您开始使用 静态资源 ZStatic.net（下称“本服务”），即视为您同意并遵守 服务条款 和 隐私政策。

除此以外，还有几点您必须知悉：

  • 您应尽量避免人为、刻意或放任，使您运行或维护的程序对本网站发起具有恶意性质的高频率、大流量或其他不正常的访问。
  • 您应始终确保对本网站发起的请求来源于遵守中华人民共和国现行法律，并且内容与价值观符合公序良俗的程序。

如您未能尽到以上义务，本网站有权屏蔽来自您 IP、域名、UA、行为特征、资源路径等的请求并视具体情况保留追责的权利。

发现内容有误或需要补充？欢迎前往 反馈页 告诉我们。

下一篇

介绍