nginx可通过map指令解析accept-language头实现多语言自动路由，支持按语言代理至不同后端或重定向到语义化路径（如/zh/），兼顾seo与用户体验，且需注意缓存键标准化及https透传。
Nginx 本身不支持运行 JavaScript 或调用语言检测模型（如 Accept-Language 解析仅靠 HTTP 头），但它可以通过分析请求头中的 Accept-Language 字段，结合内置变量和 map 指令，实现基于浏览器语言偏好自动跳转或多路径代理。这种方案无需后端参与语言判断，由 Nginx 在入口层完成轻量路由，适合静态站点或前后端分离架构。
用 map 指令提取首选语言
Nginx 的 map 模块（默认启用）可将 http_accept_language 的值映射为简写语言码，例如：
# 在 http 块顶部（/etc/nginx/nginx.conf 或 conf.d/ 目录下单独文件）
map $http_accept_language $lang {
~*zh-cn|zh-sg|zh-hans|zh-hans-cn zh;
~*zh-tw|zh-hk|zh-hant|zh-hant-tw zh-Hant;
~*en-us|en-gb|en-ca|en-au|en-nz en;
~*fr-fr|fr-be|fr-ch fr;
~*es-es|es-mx|es-ar|es-cl es;
~*ja-jp ja;
default en;
}
这个映射会把常见语言头转成 zh、en、fr 等短码，供后续 location 或 proxy_pass 使用。
按语言自动代理到不同后端服务
假设你有三套独立部署的多语言 API 服务：
- 英文版：
http://localhost:3001 - 中文版：
http://localhost:3002 - 法文版：
http://localhost:3003
可在 server 块中这样配置：
server {
listen 80;
server_name example.com;
# 根据 $lang 变量选择上游
set $backend "http://localhost:3001"; # 默认英文
if ($lang = "zh") { set $backend "http://localhost:3002"; }
if ($lang = "fr") { set $backend "http://localhost:3003"; }
location / {
proxy_pass $backend;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Accept-Language $http_accept_language; # 透传原始头
}
}
⚠️ 注意：if 在 location 外使用是安全的；Nginx 官方不推荐在 location 内用 if，但此处用于变量赋值无副作用。
配合路径前缀实现语义化路由 + 自动 fallback
更推荐的方式是保留 /zh/、/en/ 等路径语义，并对无前缀请求做自动重定向：
server {
listen 80;
server_name example.com;
# 自动重定向根路径
location = / {
return 302 /$lang/;
}
# 匹配 /zh/、/en/ 等路径，代理到对应后端
location ~ ^/(?<lcode>[a-z]{2}(-[a-z]{2})?)/ {
# 构建后端地址：en → http://api-en:3000，zh → http://api-zh:3000
set $upstream "http://api-$lcode:3000";
proxy_pass $upstream;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
# 兜底：未匹配语言前缀时走默认英文
location / {
proxy_pass http://api-en:3000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}</lcode>
此方式兼顾 SEO 友好性、用户可感知性与自动适配能力。
补充建议
-
不要依赖 $lang 做缓存键：
Accept-Language值高度碎片化（如en-US,en;q=0.9,de;q=0.8），直接缓存易导致命中率低。建议用标准化后的$lang（如en）作为proxy_cache_key的一部分。 -
支持 Cookie 或 URL 参数覆盖：用户手动切换语言时，可通过
cookie(lang=fr)或?lang=fr覆盖自动识别结果，需额外用map或if判断。 -
HTTPS 下务必透传 X-Forwarded-Proto：避免后端生成
http://链接，尤其影响前端资源加载和重定向逻辑。
不复杂但容易忽略
