如何配置代理缓存针对不同的地理位置 GeoIP 输出并缓存不同语言版本的页面-Nginx-PHP中文网

要让nginx对不同地理位置用户缓存不同语言版本页面，关键在于缓存键必须包含地理标识（如国家代码）和语言标识，并确保后端响应正确区分内容变体；需启用geoip2模块、构建含$geoip2_data_country_code和$lang的cache_key、配置proxy_cache_path与vary头，并使后端依据x-geo-country头适配内容。

如何配置代理缓存针对不同的地理位置 geoip 输出并缓存不同语言版本的页面

要让 Nginx 对不同地理位置的用户缓存不同语言版本的页面，关键在于：**缓存键（cache key）必须包含地理标识（如国家代码）和语言标识（如 lang 参数或 Accept-Language 头），同时确保后端响应能正确区分内容变体**。单纯靠 GeoIP 识别还不够，必须把地域信息“注入”到缓存决策链中。

1. 启用并验证 GeoIP2 模块

Nginx 官方包默认不带 GeoIP2 支持，需确认已安装动态模块并加载：

检查是否启用：nginx -V 2>&1 | grep -o http_geoip2 —— 有输出才表示可用
数据库路径需可读，推荐放在 /etc/nginx/geoip/GeoLite2-Country.mmdb
在 http 块中配置解析逻辑（注意：不是旧版 geoip_country）：

geoip2 /etc/nginx/geoip/GeoLite2-Country.mmdb {
$geoip2_data_country_code country iso_code;
$geoip2_data_country_name country names en;
}

2. 构建带地理维度的缓存键

默认 cache key 是 $scheme$request_method$host$request_uri，它不区分用户所在国。需显式加入 $geoip2_data_country_code 和语言信号：

Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载

定义自定义 cache key（放在 http 块）：

proxy_cache_key "$scheme$request_method$host$request_uri$lang$geoip2_data_country_code";

其中 $lang 可通过 map 从 Accept-Language 或 $geoip2_data_country_code 推导（推荐后者保持一致性）：

map $geoip2_data_country_code $lang {
  default en;
  CN zh;
  JP ja;
  KR ko;
  DE de;
  FR fr;
}

3. 配置缓存区域与代理行为

在 server 或 location 中启用缓存，并确保响应头允许缓存变体：

定义缓存区（http 块）：

proxy_cache_path /var/cache/nginx/geo_cache levels=1:2 keys_zone=geo_cache:10m max_size=1g inactive=60m use_temp_path=off;

在 location 中启用缓存 + 设置 Vary 头（关键！）：

location / {
  proxy_cache geo_cache;
  proxy_cache_valid 200 302 10m;
  proxy_cache_use_stale error timeout updating http_500;
  add_header X-Cache-Status $upstream_cache_status;
  add_header Vary "X-Geo-Country, Accept-Language";
  proxy_set_header X-Geo-Country $geoip2_data_country_code;
  proxy_pass http://backend;
}

注意：Vary 头告诉 CDN 或浏览器“这个响应是按国家和语言区分的”，避免混用缓存。