Nginx 中怎么在缓存键中加入地区编码实现 CDN 边缘缓存-Nginx-PHP中文网

在Nginx中按地区编码区分缓存键，需通过ngx_http_geoip2_module解析IP获取$geoip2_country_code，并在proxy_cache_key中嵌入该变量（建议用map设默认值ZZ），同时支持CDN透传X-Client-Country头以优化性能。

nginx 中怎么在缓存键中加入地区编码实现 cdn 边缘缓存

在 Nginx 中实现按地区编码（如 country_code）区分缓存键，关键是在 proxy_cache_key 中嵌入地理信息变量，并确保该变量在请求到达缓存层前已正确解析。Nginx 本身不内置 IP 地理定位，需依赖 ngx_http_geoip2_module（推荐）或旧版 geoip 模块配合 MaxMind 数据库。

1. 安装并配置 GeoIP2 模块获取地区编码

GeoIP2 是当前主流方案，支持 IPv6 和更精准的数据库更新：

编译 Nginx 时添加 --add-module=/path/to/ngx_http_geoip2_module
下载 MaxMind GeoLite2 Country 数据库（GeoLite2-Country.mmdb），放在安全路径如 /usr/share/GeoIP/GeoLite2-Country.mmdb
在 http 块中加载数据库和定义变量：

http {
    geoip2 /usr/share/GeoIP/GeoLite2-Country.mmdb {
        $geoip2_data_country_code source=$remote_addr country iso_code;
        # 可选：补充城市、ASN 等字段
    }
<pre class="brush:php;toolbar:false;"># 若使用 CDN 回源，真实客户端 IP 通常在 X-Forwarded-For 或 CF-Connecting-IP 中
# 需先用 map 提取最左非私有 IP（示例以 Cloudflare 为例）
map $http_cf_connecting_ip $real_ip {
    "" $remote_addr;
    default $http_cf_connecting_ip;
}

geoip2 /usr/share/GeoIP/GeoLite2-Country.mmdb {
    $geoip2_country_code source=$real_ip country iso_code;
}

}

2. 在 proxy_cache_key 中加入地区编码

缓存键必须唯一标识“内容 + 地区”，避免跨区混用。建议包含协议、主机、路径、查询参数和地区码：

在 location 或 server 块中配置缓存键，例如：

proxy_cache_key "$scheme$request_method$host$request_uri$geoip2_country_code";

注意：$geoip2_country_code 为空时（如 IP 未匹配或数据库缺失）会导致缓存键不一致。可设默认值提升健壮性：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

map $geoip2_country_code $cache_country {
    "" "ZZ";  # 未知地区统一用 ZZ
    default $geoip2_country_code;
}
# 然后使用 $cache_country 替代 $geoip2_country_code

3. 配置缓存策略与验证

启用缓存后需确认地区维度生效：

开启缓存日志或使用 $upstream_cache_status 响应头观察 HIT/MISS
用不同地区出口 IP（如通过代理或 Cloudflare Workers 修改 CF-Connecting-IP）发起相同请求，检查响应头中 X-Cache 是否分别命中
若使用 CDN（如 Cloudflare、Akamai），注意其自身边缘缓存可能覆盖 Nginx 缓存；建议将 Nginx 部署在 CDN 后、应用前，作为二级缓存（L2 cache），并在 CDN 设置中禁用对动态路径的缓存，或透传地区头

4. 补充：兼容 CDN 头部透传与回源控制

为确保 CDN 正确传递客户端地区信息给 Nginx：

在 CDN 控制台设置「缓存规则」，强制透传 CF-IPCountry（Cloudflare）或自定义头如 X-Client-Country
Nginx 中可直接读取该头（比 GeoIP 更快，但依赖 CDN 准确性）：

map $http_x_client_country $cache_country {
    "" "ZZ";
    default $http_x_client_country;
}

这种方式跳过本地 GeoIP 查询，降低延迟，适合 CDN 已提供高可信地区标签的场景。