自动缓存清理说明
用户下次访问时,系统会自动校验资源是否已过期:
已过期 → 回源拉取最新版本
未过期 → 继续使用缓存
如您有紧急清理需求,建议通过平台手动提交刷新任务,时效性更高。自动清理仅作为兜底机制,不保证实时性,后续策略如有调整以平台最新公告为准。
发布后调用一次刷新,JSDMirror 自动清理 CDN 边缘缓存并同步回源刷新上游。无需改代码、无需等 TTL,新内容快速生效;带版本号的资源发布后自动生效,无需清理。
统一纳管所有镜像站点与 CDN 厂商,一处提交、全域生效。
提交 URL 即触发多节点缓存清理并同步回源,边缘缓存无需等待 TTL 过期即可访问新内容。
主流 CDN 厂商一站纳管,按站点独立配置,互不影响,刷新任务自动分发到对应节点。
POST / GET 双模式 + X-API-Key 鉴权,无缝嵌入 CI/CD 自动发布流程。
每次刷新全量留痕,成功率、耗时、趋势一目了然,故障可回溯。
积分制平滑刷新频率,签到补给,既防滥用又保障源站稳定。
站点 / 用户 / 管理员三级权限,API Key 隔离,安全可审计。
从注册到自动化,分钟级上手。
注册即可直接使用,无需提前建站或绑定站点,开箱即用。
在控制台为自己签发独立 Key,按需在 CI 中注入环境变量。
发布后调用 API 或控制台一键刷新,新内容无需等待 TTL 即可生效。
POST 用 Header 鉴权,GET 用 Query 传参,参数完全一致。
# X-API-Key 鉴权,JSON Body 传参 $ curl -X POST \ https://cache.jsdmirror.com/api/v1/purge \ -H "Content-Type: application/json" \ -H "X-API-Key: 你的Key" \ -d '{ "url":"https://cdn.jsdmirror.com/npm/jquery@3.7.1/dist/jquery.min.js", "method":"invalidate", "provider":"edgeone,esa"}' { "success": true, "data": { "job_id": "pur_8f2a" } }
# Query 参数传 Key + URL $ curl -G "https://cache.jsdmirror.com/api/v1/purge" \ --data-urlencode "key=你的Key" \ --data-urlencode "url=https://cdn.jsdmirror.com/npm/jquery@3.7.1/dist/jquery.min.js" \ --data-urlencode "method=invalidate" \ --data-urlencode "provider=edgeone,esa" { "success": true, "data": { "job_id": "pur_9c1b", "zone": "站点名称" } }
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| url | string | 必填 | 需清理的完整 URL。POST 走 JSON body,GET 走 query。 |
| method | string | 可选 | 刷新方式,默认 invalidate(标记过期),可选 delete(立即删除)。 |
| provider | string | 可选 | 指定要刷新的 CDN 平台,多个用逗号分隔。可选值:edgeone(腾讯 EdgeOne)、esa(阿里云 ESA)、baishan(白山云)、bs(白山云别名)。留空则自动使用该站点配置的主力 CDN。 |
按清理范围与方式计分,多选 CDN 平台按阶梯递增,签到即可持续补给。
精确文件级失效,发布单个文件的标配。
按目录前缀批量失效,整组文件一次搞定。
整站缓存一键失效,兜底方案。
选择 2 个 CDN 平台按 ×2 计分、3 个按 ×3 计分;每日签到 +50 积分,连续 7 天额外 +1000。
还有疑问?控制台内可随时联系管理员。