Nginx 中怎么配置 proxy_pass 实现多语言环境下的动态后端代理-Nginx-PHP中文网

Nginx通过结合Accept-Language、URI路径、Cookie或自定义Header实现多语言动态代理，核心是条件路由而非语义识别；常用map指令映射语言变量，再注入proxy_pass目标，需注意upstream预定义、路径斜杠处理及Header透传。

nginx 中怎么配置 proxy_pass 实现多语言环境下的动态后端代理

在 Nginx 中用 proxy_pass 实现多语言环境下的动态后端代理，核心不是靠 Nginx 自身“识别语言”，而是结合请求头（如 Accept-Language）、URI 路径、Cookie 或自定义 Header，把不同语言流量分发到对应后端服务。Nginx 本身不翻译也不判断语义，它做的是条件路由。

基于 Accept-Language 请求头做语言路由

Nginx 可通过 map 指令提取并映射语言偏好，再注入到 proxy_pass 目标中。这是最常见且符合 HTTP 规范的做法：

在 http 块中定义语言映射关系，例如：

map $http_accept_language $backend_lang {
    ~*zh-cn|zh-sg|zh-hk  zh;
    ~*en-us|en-gb       en;
    ~*ja                ja;
    ~*ko                ko;
    default             en;
}

然后在 location 中使用该变量拼接后端地址：

location /api/ {
    proxy_pass http://backend-$backend_lang/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

注意：proxy_pass 后的斜杠必须保留，否则路径拼接会出错；后端服务需部署为 backend-zh、backend-en 等独立 upstream 或 DNS 名称。

基于 URI 路径前缀区分语言

更可控、更利于 SEO 和调试的方式是显式暴露语言标识在 URL 中，例如 /zh-CN/products、/en-US/products：

用 location ^~ /zh- 或正则匹配剥离语言前缀，再重写路径转发：

location ~ ^/(zh-CN|zh-TW|en-US|ja-JP|ko-KR)(/.*)?$ {
    set $lang $1;
    set $path $2;
    proxy_pass http://backend-$lang$path;
    proxy_set_header X-Language $lang;
}

这种方式无需依赖客户端 Header，适合移动端或 CDN 缓存场景，也便于灰度发布和 A/B 测试。

aperture: the L402 aware reverse proxy

安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。

下载

配合 Cookie 或自定义 Header 做用户级语言偏好

当用户登录后主动选择语言，可通过 Cookie（如 lang=ja）或前端透传的 X-Preferred-Language 控制路由：

用 map 提取 Cookie 值优先级高于 Accept-Language：

map $cookie_lang $route_lang {
    zh  zh;
    en  en;
    ja  ja;
    ko  ko;
    ""  $http_accept_language; # fallback
}
<p>map $route_lang $upstream {
~<em>zh-cn|zh.</em>  backend-zh;
~<em>en.</em>        backend-en;
~<em>ja.</em>        backend-ja;
default       backend-en;
}</p>

再在 location 中引用：

location / {
    proxy_pass http://$upstream;
}

这样既支持自动协商，又允许用户手动覆盖，体验更灵活。

注意事项与常见坑

动态 proxy_pass 容易忽略的关键点：

变量不能用于 upstream 名字的直接拼接：Nginx 不支持 proxy_pass http://$upstream/ 中的 $upstream 是域名时做 DNS 解析（除非启用 resolver 并用 set + resolver 配合）；推荐方案是预先定义好 named upstream，再用 map 映射到 upstream 名，或改用 DNS 可解析的服务名（如 Kubernetes Service 名）。
路径重写要一致：如果 location /zh-CN/ 匹配了，而 proxy_pass http://backend-zh/ 后没加尾部斜杠，Nginx 会把 /zh-CN/api 错误转发为 http://backend-zh/zh-CN/api；加斜杠才能去掉前缀。
Header 透传别遗漏：后端需要知道原始语言意图，务必设置 proxy_set_header X-Language $lang 或类似字段，避免业务层重复解析。