alias 指令通过完全替换 location 路径来隐藏真实目录结构，如 location /static/ { alias /data/assets/; } 将 /static/js/app.js 映射为 /data/assets/js/app.js；需注意末尾斜杠一致性、禁用 autoindex 和 internal 限制访问。

Nginx 的 alias 指令可以将请求的 URI 路径映射到服务器上某个具体目录，从而避免暴露网站根目录（如 /var/www/html）下的完整文件结构。它比 root 更灵活，适用于需要将特定 location 与非根路径下的资源绑定的场景。

alias 与 root 的核心区别

alias 会**完全替换**匹配的 location 路径；而 root 是在路径末尾**追加** URI。这是隐藏真实路径的关键逻辑差异。

• 配置 location /static/ { alias /data/assets/; }：访问 /static/js/app.js 实际读取的是 /data/assets/js/app.js —— /static/ 被彻底替换，URI 剩余部分（js/app.js）拼接到 /data/assets/ 后
• 同样 URI 下用 root：location /static/ { root /data/assets; } 会尝试读取 /data/assets/static/js/app.js —— 容易意外暴露上级目录结构或返回 404

正确配置 alias 隐藏敏感路径

确保目标目录不在 Web 根目录内，并禁止列出目录内容，是隐藏真实结构的基础。

• 避免将 alias 指向 /var/www/html/private/ 这类仍在 root 下的子目录，否则仍可能通过其他路径跳转访问
• 推荐指向独立路径，例如 /srv/app-configs/ 或 /opt/secrets/，并确保该路径 nginx worker 进程有读取权限
• 在 alias 块中显式关闭自动索引：autoindex off;，防止用户访问目录时看到文件列表
• 可配合 internal; 限制仅内部重定向可访问，例如用于 try_files 或 error_page 后端资源

常见错误与安全提醒

alias 配置不当反而会扩大暴露面，尤其要注意末尾斜杠和路径拼接行为。

• location 和 alias 值都必须以 / 结尾，或都不以 / 结尾：比如 location /media/ { alias /storage/images/; } 是安全的；若写成 alias /storage/images（缺末尾 /），则 /media/photo.jpg 会被映射为 /storage/imagesphoto.jpg，导致 404 或误读文件
• 不要在 alias 中使用变量（如 $host），Nginx 不支持动态 alias，否则会报错或行为不可控
• alias 不支持正则 location 的捕获变量直接拼接（如 ~ ^/u/(.+)$ { alias /data/users/$1/; } 是无效的），应改用 rewrite + root 或 Lua 模块处理复杂逻辑

实用示例：隐藏配置文件访问入口

假设你有一组运行时配置放在 /etc/myapp/conf.d/，不希望用户通过 HTTP 直接猜到路径，但又需要 Nginx 在响应头或 Lua 脚本中读取它们：

• 添加专用 location：location /_conf/ { alias /etc/myapp/conf.d/; internal; autoindex off; };
• 这样只有 Nginx 内部指令（如 auth_request 子请求、content_by_lua_block）能触发访问，浏览器直接请求会返回 404
• 配合 types { } 或 default_type application/octet-stream; 可进一步防止 MIME 类型泄露文件性质