Nginx 中 Alias 指令如何在多语言站点中映射不同语种的物理静态目录

alias指令专用于URL路径前缀到物理目录的精准替换，需location与alias均以/结尾，适用于同域名下按/zh/、/en/等路径分发多语言静态资源，不适用于按域名区分语种。

在多语言站点中，alias 指令本身不适用于按域名区分语种的主站分发，它专用于按 URL 路径前缀做物理目录映射。若你想让 zh.example.com、en.example.com 各自加载不同目录（如 /var/www/zh/、/var/www/en/），应使用 root + 多 server 块或 map 指令——这是更自然、更标准的做法。

但如果你的多语言站点是统一域名下按路径区分语种，例如：

1. https://example.com/zh/ → 对应中文静态文件
2. https://example.com/en/ → 对应英文静态文件
3. https://example.com/ja/ → 对应日文静态文件

这时 alias 就非常适用，且比 root 更精准、更安全。

用 alias 映射 /zh/、/en/ 等路径到独立语种目录

alias 的核心逻辑是：完全删除 location 匹配的前缀，再把剩余路径拼到 alias 值后面。所以配置必须严格匹配斜杠规则：

1. location /zh/ { alias /var/www/locales/zh/; } → 请求 /zh/css/app.css 实际读取 /var/www/locales/zh/css/app.css
2. location /en/ { alias /var/www/locales/en/; } → 请求 /en/js/i18n.js 实际读取 /var/www/locales/en/js/i18n.js
3. location /ja/ { alias /var/www/locales/ja/; } → 同理

注意：所有 location 和对应 alias 值末尾都必须带 /，否则会因路径拼接错误导致 404 或越权访问。

适配 SPA 类多语言前端（如 Vue/React）

如果每个语种都是一个独立构建的单页应用（比如 Vue 设置了 publicPath: "/zh/"），alias 是唯一推荐方式：

1. root /var/www/locales; + location /zh/ { } 会导致请求 /zh/index.html 去找 /var/www/locales/zh/index.html —— 多了一层 /zh/，但实际文件就在 /var/www/locales/zh/ 根下
2. location /zh/ { alias /var/www/locales/zh/; } 则直接剥离 /zh/，剩余空路径拼过去，精准命中 /var/www/locales/zh/index.html

搭配 try_files 支持前端路由 fallback：

location /zh/ {alias /var/www/locales/zh/;try_files $uri $uri/ /zh/index.html;}

公共资源跨语种复用（如图标、字体）

不同语种站点常共用一套图标、CSS 或国际化 JSON 文件。可单独用 alias 挂载统一资源池：

1. location /shared/icons/ { alias /mnt/assets/icons/; }
2. location /shared/fonts/ { alias /mnt/assets/fonts/; }
3. location /shared/locales/ { alias /mnt/assets/locales/; }

这样所有语种页面都可通过 /shared/icons/logo.svg 访问同一份资源，无需在每个语种目录里重复存放，也彻底脱离 root 体系。

必须检查的三项底层条件

配置写对只是第一步，Nginx 还得真正读到文件：

1. Nginx worker 进程用户（如 www-data）对目标目录有 r-x 权限；父目录（如 /var/www/locales）至少要有执行（x）权限才能进入
2. 所有 alias 后的路径必须是真实存在的绝对路径，Nginx 不会自动创建目录
3. 开启 debug 日志（error_log /var/log/nginx/error.log debug;），查看 access 日志中 open() 调用的实际路径是否与预期一致