Nginx 代理请求头中怎么传递自定义的客户端地理位置国家代码-Nginx-PHP中文网

Nginx反向代理需显式配置透传客户端国家代码头。通过proxy_set_header指令转发X-Country-Code或CF-IPCountry，并可用map做格式校验，最后在后端验证头存在且值正确。

nginx 代理请求头中怎么传递自定义的客户端地理位置国家代码

在 Nginx 作为反向代理时，若上游服务需要知道客户端的国家代码（如 Country-Code），而该信息来自真实客户端（比如通过 CDN、边缘节点或前端 JS 获取），Nginx 默认不会自动传递自定义请求头。你需要显式配置 Nginx 将它从原始请求中提取并转发给后端。

确保客户端或前置层已设置该头

国家代码通常不由浏览器原生提供，需由以下方式之一注入：

CDN（如 Cloudflare）在请求中添加 CF-IPCountry 头（值为两位大写 ISO 国家码，如 US）
前端 JS 通过 IP 定位 API 获取后，用 fetch 手动添加请求头（注意：需服务端允许 CORS，且非简单请求会触发预检）
客户端 SDK 或网关层统一注入 X-Country-Code 等自定义头

在 Nginx 中透传或重命名该头

使用 proxy_set_header 指令将原始请求中的国家代码头转发给后端。例如：

location /api/ {
    proxy_pass https://backend;
    # 若客户端发来 X-Country-Code，则直接透传
    proxy_set_header X-Country-Code $http_x_country_code;
<pre class="brush:php;toolbar:false;"># 或从 Cloudflare 的 CF-IPCountry 转换为标准头
proxy_set_header X-Country-Code $http_cf_ipcountry;

# 若想强制小写或做简单校验，可用 map 指令预处理（见下节）

}

用 map 做轻量级标准化（可选）

如果希望统一格式（如转为小写、过滤非法值），可在 http 块中定义映射：

Nginx Hosting

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

下载

map $http_cf_ipcountry $country_code {
    default "";
    ~^[A-Z]{2}$ $http_cf_ipcountry;  # 只接受标准两位大写
}
<h1>然后在 location 中使用</h1><p>proxy_set_header X-Country-Code $country_code;</p>

这样能避免后端收到空值、乱码或超长字符串。

验证是否生效

在后端服务中打印所有请求头，确认 X-Country-Code（或你指定的头名）存在且值正确。也可用 curl 测试：

curl -H "X-Country-Code: CN" http://your-nginx/api/test

同时检查 Nginx 日志是否记录该头（需开启 log_format 包含 $http_x_country_code）。