如何配置 proxy_cache_methods 开启针对特定请求方式的静态边缘加速方案-Nginx-PHP中文网

proxy_cache_methods 不开启静态边缘加速，仅限制可缓存的HTTP方法；真正实现需 proxy_cache + proxy_cache_valid + 缓存头组合，且默认 GET/HEAD 已足够安全。

如何配置 proxy_cache_methods 开启针对特定请求方式的静态边缘加速方案

proxy_cache_methods 本身不用于开启“静态边缘加速”，它只是控制哪些 HTTP 请求方法可以被缓存——真正实现静态边缘加速的是 proxy_cache + proxy_cache_valid + 缓存头（如 Cache-Control）的组合。proxy_cache_methods 的作用是收窄缓存范围，确保只有安全、幂等的方法（如 GET、HEAD）进缓存，而避免把 POST、PUT 等写操作误缓存。

如果你的目标是「对静态资源做边缘缓存加速」，重点不是开启 proxy_cache_methods，而是正确配置它来配合整体缓存策略，防止缓存污染或行为异常。

以下是实用配置要点：

明确支持的请求方法

Nginx 默认只缓存 GET 和 HEAD 请求（这是最安全的），无需额外设置。但若你明确需要扩展（极少见），可显式声明：

proxy_cache_methods GET HEAD;
# 不建议加入 POST / PUT / DELETE —— 它们本就不该被缓存

GET：获取资源，天然适合缓存
HEAD：仅校验元信息，响应体为空，复用 GET 缓存即可
✅ 保持默认即可，不建议修改

静态资源缓存必须配套的关键项

仅设 proxy_cache_methods 没有意义。要真正生效，需在 location 块中完整配置：

Bailian Usage Proxy

阿里百炼大模型平台多人共享账号用量统计代理服务。解决公司共用账号时无法区分个人用量的问题。适用场景：1)部署用量统计代理；2)统计多人Token用量和调用次数；3)管理大模型API调用配额。

下载

启用缓存区（必须与 proxy_cache_path 中定义的 keys_zone 名称一致）
设置缓存有效期（按状态码区分）
保证后端响应带合理缓存头（或由 Nginx 强制注入）
确保 proxy_cache_key 不包含易变字段（如 Cookie、随机参数）

示例（针对 /static/ 下的图片、JS、CSS）：

location ~* \.(js|css|png|jpg|gif|woff2|svg)$ {
    proxy_cache my_edge_cache;
    proxy_cache_valid 200 304 1y;
    proxy_cache_valid 404 1m;
    add_header Cache-Control "public, immutable";
    expires 1y;
    proxy_pass https://origin;
}

特别注意：避免缓存非幂等请求

如果业务中存在某些“伪静态”接口（比如带查询参数的 JSON 接口），又想缓存，不要靠改 proxy_cache_methods 来实现，而应：

使用 proxy_cache_key 精确构造（如含 $arg_id 但不含 $cookie_session）
配合 proxy_cache_bypass 控制绕过条件（如带 X-Refresh 头时跳过）
对 POST 请求，即使加了 proxy_cache_methods POST，也极易引发数据一致性问题，生产环境严禁启用

小结：你应该怎么做

保留默认 proxy_cache_methods GET HEAD，不改动
把精力放在：
- 正确定义 proxy_cache_path（磁盘路径、共享内存区）
- 在 location 中启用 proxy_cache 并配 proxy_cache_valid
- 用 add_header Cache-Control 或 expires 主动下发强缓存指令
- 前端 URL 指向 CDN 域名，让边缘节点真正参与分发

这样，静态资源才能稳定命中边缘缓存，实现加载加速与源站减负。