静态响应缓存
缓存模式需主动开启。在代理密码后添加有效的
_cache-...后缀即可启用。该后缀本身就是完整的开启方式：无需账户级激活，也无需令牌白名单。没有该后缀时，Litport不会拦截或缓存任何内容：普通代理行为保持不变。证书处理仅在缓存模式下才需要。
实际用途#
当许多工作进程反复访问共用同一批带版本号资源的公开页面时，缓存最有用。浏览器自动化和重复抓取可以复用来自同一节点的图片、字体、CSS和JavaScript，而不必为每个工作进程重复购买相同的响应字节。
实测示例：1,000次票务页面访问#
仅统计解码后的响应体。绕过缓存、过期、淘汰、节点变更以及实际费率都会影响结果；不限流量方案会显示免费字节数，但不会获得现金抵扣。
缓存适用范围#
缓存模式适用于Litport的所有客户产品系列：数据中心代理、ISP/静态住宅IP、住宅IP、移动代理、不限流量和按流量计费。通过HTTP代理端点发出的每个启用缓存的请求都会被评估。符合条件的静态HTTPS GET请求可能被存储或命中；不符合条件的请求会绕过缓存，走普通代理路径。SOCKS5入口从不缓存。
| 配置 | 结果 |
|---|---|
| 有效后缀 + HTTP代理 + 符合条件的HTTPS静态GET | 符合缓存条件 |
| 有效后缀 + HTTP代理 + 其他、私有或非静态HTTPS | 绕过，正常计费 |
| 有效后缀 + HTTP代理 + 普通HTTP目标 | 正常计费；不存储 |
| 有效后缀 + SOCKS5 + HTTP或HTTPS | 普通SOCKS5；不缓存 |
| 无后缀 | 所有情况下均为普通行为 |
快速入门#
- 下载并信任Litport缓存根证书，或使用该页面中面向公开数据自动化的隔离环境跳过验证选项。
- 将
_cache-scripts添加到代理密码中。 - 通过
hub-us-7.litport.net两次请求同一个符合条件的HTTPS URL。 - 打开“流量统计”，查看未命中、命中、免费字节数以及按流量计费的节省金额。
# Proxy endpoint: http://hub-us-7.litport.net:PORT · Target: pinned Lodash on jsDelivr
curl --proxy 'http://hub-us-7.litport.net:PORT' \
--proxy-user 'USER:PASSWORD_cache-scripts' \
--cacert litport-cache-root.crt \
'https://cdn.jsdelivr.net/npm/[email protected]/lodash.min.js'
代理URL以http://开头，是因为curl通过HTTP CONNECT连接Litport。这并不会让目标变成普通HTTP：末尾的URL必须以https://开头。
每个缓存条目归属于一个节点#
缓存条目仅存在于所在节点，并在该节点的服务重启后保留。它们不会复制到其他节点。预热hub-us-7.litport.net不会预热hub-eu-1.litport.net，但同一个Litport根证书适用于这两个启用缓存的节点。
查看节省了多少#
流量统计可以按天、小时或月份汇总用量。所有产品都会显示免费的缓存字节数；按流量计费的流量还会显示节省的美元金额。集成可以通过令牌API获取相同的用量数据。
缓存后缀没有附加费或倍率。未命中和绕过缓存仍按所选代理产品或代理池的正常价格计费；只有缓存命中返回的响应字节免费。
哪些请求符合条件#
密码选择缓存 → HTTP代理入口 → 目标为HTTPS → 方法为GET → 路径以所选静态类型结尾 → 请求不含私密或部分内容信号 → 响应为200且可缓存。任一步骤未通过时，该请求会变为普通计费的代理请求；它不会仅因为不可缓存而失败。
支持的类别：
- 图片：PNG、JPEG、GIF、SVG、ICO和WebP
- 脚本：JavaScript、CSS、WebAssembly和source map
- 字体：WOFF、WOFF2、TTF、EOT和OTF
缓存标识为完整URL，包括精确的查询字符串。带有cookie、授权、字节范围、不受支持的Vary或请求no-cache指令的响应始终绕过缓存。
为什么只支持HTTPS？#
Litport仍会正常代理普通的http://目标。它们不会被缓存，因为未经验证的响应可能在节点与源站之间被篡改；存储这样的响应会把一次网络拦截变成共享缓存投毒。安装Litport CA或关闭证书检查，也不会使普通HTTP目标符合缓存条件。
安全的默认设置#
默认缓存时长为120分钟；如果源站的s-maxage或max-age更短，则以其为上限。_cacheignoreheader-1可以在源站将响应标记为private、no-cache或no-store时仍然存储该响应；其请求的时长从Litport存储完整响应时开始计算。仅对公开、无需认证的静态资源使用此覆盖选项。同一节点上的条目由Litport客户共享，因此对个性化内容忽略源站的隐私指令是不安全的。