在 nginx 中实现多语言子目录域名跳转,核心做法是利用 server_name 匹配主域名,并在 location 块中使用正则表达式捕获 url 中的语言代码段,随后通过 return 301 或 rewrite 指令将请求重定向到对应的子目录。具体而言,配置一个包含所有目标语言的 server_name,使用 ~* ^/(? 这样的正则来提取语言标识,并将原始 uri 拼接至重定向地址中。若用户访问不带语言前缀的根路径,可设置默认语言并重定向;若访问的语言代码不在白名单内,则返回 404 或重定向至默认语言。

如何配置 server_name 以支持多语言路由
要实现多语言子目录跳转,首先需要在 server 块中定义 server_name 为当前站点的主域名,例如 www.example.com。接着,在 location 块中编写正则匹配规则,识别 URL 路径的第一级目录是否为预定义的语言代码(如 en, zh, fr)。如果匹配成功,Nginx 会将该语言代码存入命名捕获组 $lang,并将剩余路径存入 $1。此时,可以通过 return 301 /$lang/$1; 确保请求被规范化地指向带语言前缀的子目录。这种配置方式允许单一域名处理多种语言的入口流量,并通过 HTTP 301 状态码告知浏览器更新书签和缓存。

server {
listen 80;
server_name www.example.com;
# 默认语言为 en,如果访问根路径则重定向到 /en/
location = / {
return 301 /en$request_uri;
}
# 匹配语言子目录:/zh/path/to/page -> /zh/path/to/page (保持原样)
# 或者用于内部转发,这里演示重定向逻辑
location ~* ^/(?<lang>en|zh|fr|de)(/.*)?$ {
# 如果已经包含语言前缀,且后续路径存在,则直接代理或重写
# 此处为了演示跳转逻辑,假设我们需要统一格式
if ($request_uri !~ ^/(en|zh|fr|de)/) {
return 301 /en$request_uri;
}
# 实际生产中,通常在此处 proxy_pass 到后端应用
# proxy_pass http://backend_app;
}
# 其他静态资源或 API 不需要语言前缀
location /api/ {
proxy_pass http://backend_app;
}
}</lang>
如何处理非标准语言代码或无效路径
当用户输入的语言代码不在预设列表中时,Nginx 的正则匹配会失败,从而落入默认的 location / 块。为了确保用户体验的一致性,可以在默认位置块中添加逻辑,将所有未识别的请求重定向至默认语言(例如英语)。此外,对于完全无效的路径,可以直接返回 404 错误码。这种处理方式避免了服务器暴露内部结构或返回模糊的错误信息。通过明确区分有效语言路径和无效路径,可以简化后端的国际化逻辑,因为后端只需处理带有正确语言前缀的请求即可。
为跨境电子商务生成多语言、SEO 优化的产品描述。支持英语、西班牙语、俄语和阿拉伯语,并针对不同搜索引擎(Google / Bing、Yandex、中东市场)进行专项 SEO 优化。适用于以下场景:用户需为国际市场创建符合 SEO 规范的产品文案、批量生成产品描述,或针对特定搜索引擎及区域用户偏好优化内容。

# 补充配置:处理无效语言代码
location / {
# 如果请求不是以 /en/, /zh/, /fr/, /de/ 开头
if ($request_uri !~ ^/(en|zh|fr|de)/) {
# 重定向到默认语言 /en/
return 301 /en$request_uri;
}
# 如果匹配了语言前缀,但后端没有对应资源,由后端返回 404
proxy_pass http://backend_app;
}
基于 server_name 匹配结果的具体跳转行为验证
在上述配置下,当用户访问 http://www.example.com/about 时,由于不匹配任何语言正则,触发默认 location / 中的 if 判断,最终返回 301 重定向至 http://www.example.com/en/about。如果用户直接访问 http://www.example.com/zh/news,则匹配 location ~* ^/(?,此时 $lang 为 zh,$1 为 /news。若配置中包含内部重写逻辑,Nginx 会将请求转发给后端应用,并携带语言上下文。这种机制确保了无论用户从哪个入口进入,URL 结构都符合预期的多语言规范,有利于 SEO 和用户记忆。










