如何在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的默认缓存头:
- 将你的GitHub Pages站点域名(包括
orange.github.io这类官方二级域名)的DNS解析切换到Cloudflare - 在Cloudflare控制台的「缓存」→「缓存规则」中创建新规则:
- 匹配条件设置为「URL路径」包含
/Gilroy.woff2和/img.png - 缓存行为选择「自定义缓存」,设置
Cache-Control为public, max-age=31536000
- 匹配条件设置为「URL路径」包含
- 保存规则后,Cloudflare会在请求这些文件时返回自定义的1年缓存头,覆盖GitHub Pages的默认设置
注意:GitHub Pages本身不支持直接通过配置文件(比如.htaccess、_config.yml)自定义单个文件的缓存时长,以上两种是可行的免费解决方案。
内容的提问来源于stack exchange,提问作者Andrianovi
相关产品推荐
相关产品推荐

