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 类型泄露文件性质
