Nginx 中 server 块如何实现多语言站点自动跳转-Nginx-PHP中文网

nginx 实现多语言自动跳转需依赖 http 块的 map 指令提取语言标识，server 块负责路由分发；典型场景包括：1. 基于 accept-language 的根路径跳转；2. 结合 cookie 的用户偏好持久化；3. 多语言路径的静态资源服务，须用 alias 而非 root。

nginx 中 server 块如何实现多语言站点自动跳转

Nginx 的 server 块本身不直接支持“根据语言自动跳转”，真正起作用的是配合 http 块中的 map 指令 + server 内的条件响应逻辑。关键不在 server 块写得多复杂，而在于结构分工清晰：map 提前提取语言标识，server 负责路由分发。

下面分三类典型场景说明如何在 server 块中落地多语言自动跳转：

用 Accept-Language 请求头做根路径跳转

这是最常用、对 SEO 友好的方式。

map 在 http 块里定义（必须顶层）：

map $http_accept_language $lang {
  ~*zh-cn|zh-sg|zh-hans|zh-hans-cn  zh;
  ~*zh-tw|zh-hant|zh-hk|zh-mo      zh-hant;
  ~*en-us|en-gb|en-ca|en-au|en-nz  en;
  ~*ja-jp|ja                       ja;
  ~*ko-kr|ko                       ko;
  default                           en;
}

server 块中处理 / 请求：
```
location = / {
  return 302 /$lang/;
}
```
这样访问 https://example.com/ 时，Nginx 根据浏览器 Accept-Language 自动跳到 /zh/、/en/ 等路径。上线后可将 302 改为 301 提升 SEO 效果。

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

下载

结合 Cookie 实现用户偏好持久化

适合 Vue/React 等 SPA 首屏语言识别，避免白屏等待 JS 加载。

先在 http 块中映射 Cookie 值：

map $cookie_lang $lang_from_cookie {
  ~^zh  zh;
  ~^en  en;
  ~^ja  ja;
  ~^ko  ko;
  default en;
}

server 块内按优先级判断：

location = / {
  # 有有效 lang Cookie → 直接跳转
  if ($cookie_lang ~ ^[a-z]{2}) {
      return 302 /$lang_from_cookie/;
  }
  # 无 Cookie → 退回到 Accept-Language
  if ($http_accept_language ~ ^(zh|en|ja|ko)) {
      add_header Set-Cookie "lang=$matches_1; Path=/; Max-Age=31536000; SameSite=Lax";
      return 302 /$matches_1/;
  }
  # 都没命中 → 默认英语并设 Cookie
  add_header Set-Cookie "lang=en; Path=/; Max-Age=31536000; SameSite=Lax";
  return 302 /en/;
}

多语言路径的静态资源服务

跳转过去之后，得让 /zh/、/en/ 这些路径能正确返回对应语言首页。

不要用 root 拼接，改用 alias 避免路径错位：
```
location ~ ^/(zh|zh-hant|en|ja|ko)/$ {
  alias /var/www/site/$1/;
  index index.html;
  try_files $uri $uri/ /$1/index.html;
}
```
注意：alias 结尾带 /，且 $1 是正则捕获组，确保 /zh/ 映射到 /var/www/site/zh/ 目录；若用 root，会变成 /var/www/site//zh/，多一层斜杠易出错。

不复杂但容易忽略