要让特定ip段强制绕过nginx缓存，需通过geo指令标记ip、proxy_cache_bypass与proxy_no_cache共用同一变量实现“识别→赋值→绕过”闭环，并配合real_ip配置确保ip准确；仅配bypass不配no_cache会导致缓存污染。
要让特定 IP 段的请求强制绕过 Nginx 缓存、直连后端获取实时数据，不能只靠 IP 限制本身，必须把 IP 判断结果转化为 proxy_cache_bypass 可识别的变量，并与缓存机制联动。核心是“IP 识别 → 变量赋值 → 绕过读写”三步闭环。
用 geo 指令标记目标 IP 段
在 http 块顶层定义一个变量，根据客户端真实 IP 是否属于指定网段来设值：
geo $bypass_by_ip {
default 0;
192.168.10.0/24 1;
10.200.0.0/16 1;
2001:db8::/32 1; # 支持 IPv6
}
注意：若使用 CDN 或反向代理，需先配置 real_ip_header 和 set_real_ip_from，确保 $remote_addr 是用户真实 IP，否则 geo 判断会失效。
在 location 中启用绕过逻辑
确保该 location 已启用 proxy_cache，再加入两行关键指令：
- proxy_cache_bypass $bypass_by_ip; —— 值为 1 时跳过缓存查找，直接发请求给后端
- proxy_no_cache $bypass_by_ip; —— 值为 1 时禁止将本次响应写入缓存，避免敏感或实时数据污染缓存池
两者必须共用同一个变量，缺一不可。只配 bypass 不配 no_cache，会导致管理员查后台接口返回的用户列表被缓存，其他用户可能看到错误数据。
验证是否生效
绕过成功时，响应头中会出现：
- X-Cache-Status: BYP（Nginx 自定义头，需手动添加：add_header X-Cache-Status $upstream_cache_status;）
- $upstream_cache_status 变量值为 BYP（可用于日志记录或调试）
可在 access_log 中加入 log_format 定制字段，例如：
log_format cache_log '$remote_addr - $upstream_cache_status "$request"';
方便快速确认某次请求是否命中、绕过或未缓存。
补充建议：避免误伤与权限收敛
不建议直接对整个 server 块启用此逻辑。更稳妥的做法是：
- 将管理类、数据看板、内部 API 路径单独归入独立 location（如
location ^~ /api/internal/），仅在此处启用 bypass + no_cache - 配合 auth_basic 或 token 校验，防止 bypass 规则被外部滥用
- 若需临时关闭某 IP 段的绕过能力，只需改 geo 块中的值为 0，无需 reload Nginx
