Nginx 中怎么在 nginx.conf 中配置别名 alias 映射外部目录-Nginx-PHP中文网

alias本质是url路径前缀替换：先完整删除location匹配段，再将剩余uri拼接到指定物理路径后；location与alias末尾斜杠必须严格一致，否则导致路径粘连404；需确保权限、路径真实存在，并可配合try_files实现spa回退。

nginx 中怎么在 nginx.conf 中配置别名 alias 映射外部目录

在 nginx.conf 中用 alias 映射外部目录，关键不是“指向”，而是“替换前缀”——把 URL 中匹配的路径段整个去掉，再把剩余部分拼到你指定的物理路径后。它不依赖网站根目录（root），适合挂载独立静态资源、子应用或跨磁盘目录。

这是最容易出错的地方。二者末尾斜杠必须严格同步：

如果 location 以 / 结尾（如 location /static/ { ... }），那么 alias 也必须以 / 结尾（如 alias /mnt/data/assets/;）
如果 location 不带尾部斜杠（如 location /favicon.ico），alias 就不能加斜杠，且要指向具体文件（如 alias /var/www/favicon.ico;）

错误示例：location /static/ { alias /mnt/data/assets; }（alias 少斜杠）→ 请求 /static/logo.png 会尝试读取 /mnt/data/assetslogo.png，直接 404。

假设你想把 http://example.com/uploads/ 映射到服务器上另一块硬盘的 /mnt/storage/uploads/：

Nginx Hosting

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

下载

location /uploads/ {
    alias /mnt/storage/uploads/;
    expires 1h;
    add_header Cache-Control "public";
}

这时请求 /uploads/photo.jpg → Nginx 去掉 /uploads/，剩下 photo.jpg，再拼到 /mnt/storage/uploads/ 后，实际读取 /mnt/storage/uploads/photo.jpg。

权限：Nginx 工作进程用户（如 www-data 或 nginx）需对 /mnt/storage/uploads/ 及其所有父目录有执行（x）权限（Linux 下进入目录必需），对文件有读（r）权限
路径真实存在：/mnt/storage/uploads/ 必须是已创建的绝对路径，Nginx 不会自动建目录
验证实际路径：开启 debug 日志（error_log /var/log/nginx/error.log debug;），看日志中 open() 调用的目标是否与预期一致

尤其用于单页应用（SPA）或资源兜底时：

location /admin/ {
    alias /var/www/my-vue-app/;
    try_files $uri $uri/ /admin/index.html;
}

注意：/admin/index.html 对应的是 /var/www/my-vue-app/index.html，因为 alias 规则同样作用于 fallback 路径中的 URI 部分。