You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在GitHub Pages上设置指定文件的缓存存储时长?

如何为GitHub Pages的部分文件设置自定义缓存时长?

可以实现,以下是两种免费方案:

方案1:文件名添加内容哈希(官方推荐,无需额外工具)

GitHub Pages对包含内容哈希的文件名会自动应用长期缓存规则(Cache-Control: public, max-age=31536000, immutable,也就是1年有效期)。你只需要:

  • 给目标文件重命名,加入基于文件内容生成的哈希值,比如把Gilroy.woff2改成Gilroy.d41d8cd98f00b204e9800998ecf8427e.woff2,img.png改成img.a1b2c3d4e5f6.png(哈希值可以用MD5、SHA-1等工具生成,确保文件内容变化时哈希值同步更新)
  • 更新站点中引用这些文件的路径(比如HTML/CSS里的链接地址)

这种方法完全依托GitHub Pages原生机制,不需要额外服务,还能避免缓存过期后用户仍拿到旧文件的问题——文件内容变更时哈希值改变,浏览器会自动请求新资源。

方案2:用Cloudflare免费版自定义缓存规则

如果不想修改文件名,可以通过Cloudflare免费CDN层覆盖GitHub Pages的默认缓存头:

  1. 将你的GitHub Pages站点域名(包括orange.github.io这类官方二级域名)的DNS解析切换到Cloudflare
  2. 在Cloudflare控制台的「缓存」→「缓存规则」中创建新规则:
    • 匹配条件设置为「URL路径」包含/Gilroy.woff2和/img.png
    • 缓存行为选择「自定义缓存」,设置Cache-Control为public, max-age=31536000
  3. 保存规则后,Cloudflare会在请求这些文件时返回自定义的1年缓存头,覆盖GitHub Pages的默认设置

注意:GitHub Pages本身不支持直接通过配置文件(比如.htaccess、_config.yml)自定义单个文件的缓存时长,以上两种是可行的免费解决方案。

内容的提问来源于stack exchange,提问作者Andrianovi

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.13 04:12:07