raw.githubusercontent.com 在大陆经常超时或被 SNI 阻断。本文记录通过 jsDelivr 及其多个子域名/镜像，在不挂代理的情况下高速拉取 GitHub 仓库中的静态资源（配置文件、图片、JS 脚本等）的实践。

一、URL 拼接通用格式

jsDelivr 提供 GitHub 资源的 CDN 加速，统一格式为：

https://{host}/gh/{user}/{repo}@{ref}/{path}
占位符 说明 示例
{host} CDN 节点域名 fastly.jsdelivr.net
{user}/{repo} GitHub 用户名/仓库名 pengyanai/misc
{ref} 分支名、tag 或 commit SHA main、v1.0、9974b7b...
{path} 仓库内文件路径 collapsed-tiles/img/claude.png

示例：

https://fastly.jsdelivr.net/gh/pengyanai/misc@main/collapsed-tiles/global-ai-availability.stoverride

ref 的三种写法

写法 特点 适用场景
@main 跟踪分支最新 开发阶段，内容会随 push 更新（有缓存延迟）
@v1.0.0 跟踪 Git tag 发布版本，语义化引用
@9974b7b3a44b... 锁定 commit SHA 需要不可变链接时使用，确保内容永远不变

锁定 commit SHA 在代理工具配置中尤其有用——避免 CDN 缓存未刷新导致配置不一致。

二、可用 CDN 节点域名对比

以下域名均遵循同一 URL 格式，只是底层 CDN 提供商不同，大陆可达性差异明显：

域名 CDN 后端 大陆可用性 备注
cdn.jsdelivr.net 自动调度（Fastly/CF/Gcore） 一般 官方默认域名，有时被间歇干扰
fastly.jsdelivr.net Fastly 较好 大陆实测稳定，推荐首选
gcore.jsdelivr.net Gcore 较好 Gcore 在亚太有节点，速度不错
testingcf.jsdelivr.net Cloudflare 一般 CF 节点多但大陆延迟波动较大
jsd.onmicrosoft.cn 国内社区镜像 好 .cn 域名，大陆直连最快
jsd.cdn.zzko.cn 国内社区镜像 已失效 证书过期，不再可用

推荐优先级（大陆无代理场景）：

jsd.onmicrosoft.cn > fastly.jsdelivr.net > gcore.jsdelivr.net > cdn.jsdelivr.net

三、GitHub 原生 raw 域名

https://raw.githubusercontent.com/{user}/{repo}/{ref}/{path}
  • 大陆直连经常超时或被 RST，不建议作为生产链接
  • 可用 refs/heads/main 替代 main（完整 ref 路径写法）
  • 适合作为 fallback 或仅在代理环境下使用

四、缓存刷新：purge 接口

jsDelivr 默认缓存 24h，push 新内容后不会立即生效。手动刷新：

https://purge.jsdelivr.net/gh/{user}/{repo}@{ref}/{path}

用浏览器或 curl 访问即可触发，返回 JSON 表示清除状态：

{
  "id": "eIdWlP9dFM3qB2TR",
  "status": "finished",
  "paths": {
    "/gh/pengyanai/misc@main/collapsed-tiles/global-ai-availability.stoverride": {
      "throttled": false,
      "providers": { "CF": true, "FY": true }
    }
  }
}

CF = Cloudflare, FY = Fastly。两个后端都返回 true 表示缓存已清除。

批量刷新多个文件可以写个简单脚本：

for f in file1.js file2.png file3.yaml; do
  curl -s "https://purge.jsdelivr.net/gh/user/repo@main/$f" | jq .status
done

五、实战：Stash 配置中的图标与脚本引用

在 Stash overlay 配置中引用 GitHub 上的图标和脚本，选择 CDN 域名直接影响大陆用户加载速度：

# 推荐：使用 fastly 节点
icon: https://fastly.jsdelivr.net/gh/pengyanai/misc@main/collapsed-tiles/img/chatgpt.png

# 备选：国内镜像（大陆最快）
icon: https://jsd.onmicrosoft.cn/gh/pengyanai/misc@main/collapsed-tiles/img/claude.png

# 不推荐：直接用 raw（大陆可能超时）
icon: https://raw.githubusercontent.com/pengyanai/misc/refs/heads/main/collapsed-tiles/img/grok.png

同一个仓库、同一个路径，只需替换域名前缀即可在不同 CDN 之间切换。

六、注意事项

  1. 文件大小限制：jsDelivr 对单文件有 50MB 限制，超过需拆分或换方案
  2. 私有仓库不支持：jsDelivr 只能加速公开仓库
  3. 社区镜像稳定性：jsd.onmicrosoft.cn 等非官方镜像由社区维护，可能随时下线，建议保留 fastly.jsdelivr.net 作为 fallback
  4. 缓存延迟：push 后需手动 purge 或等待 ~24h，急用时记得调 purge 接口
  5. commit SHA 锁定：对于代理工具配置等对一致性要求高的场景，建议用 commit SHA 而非分支名

七、快速参考卡片

# 拉取文件（大陆推荐）
https://fastly.jsdelivr.net/gh/{user}/{repo}@{ref}/{path}
https://jsd.onmicrosoft.cn/gh/{user}/{repo}@{ref}/{path}

# 刷新缓存
https://purge.jsdelivr.net/gh/{user}/{repo}@{ref}/{path}

# GitHub 原生（需代理）
https://raw.githubusercontent.com/{user}/{repo}/{ref}/{path}