alias
'alias' 指令为 NGINX 提供了一个用于处理特定请求的备用路径,实际上将请求 URI 映射到本地文件系统路径。 — NGINX HTTP Core
alias
location
语法alias path;
默认值none
上下文location
模块NGINX HTTP Core
参数1
说明
'alias' 指令在 location 上下文中使用,用于指定一个 URI 应映射到的备用本地文件系统路径。例如,当对匹配指定 location 块的 URI 发出请求时,NGINX 会使用 'alias' 的值进行后续处理和文件检索,而不是采用默认行为。这使得在保持客户端请求中有意义的 URL 的同时,可以灵活配置静态文件的位置。 'alias' 指令接受一个单一参数,该参数是当请求匹配时应被用于响应的目录或文件的路径。需要注意的是,使用 'alias' 时,匹配到的 URI 部分会被 alias 路径替换。这不同于 'root' 指令,在 'root' 中请求 URI 会被附加到 'root' 指定的路径后。因此,在配置 'alias' 时需小心,确保它能够将期望的 URI 结构正确映射到相应的文件系统结构。 'alias' 的一种常见用法是在从不遵循 document root 结构的目录中提供图片或静态文件时使用。例如,如果你将图片存储在 '/var/www/images',但希望在 URI 下以 '/images' 提供它们,可以使用 'alias' 指令来实现这种映射,而无需更改后端文件系统的结构。
配置示例
location /images {
alias /var/www/images/;
}⚠
如果请求 URI 未以尾随斜杠结尾,且未正确处理,可能会导致意外行为并返回 404 错误。
⚠
如果要提供目录,请记得在 alias path 后添加尾随斜杠,以确保其与 NGINX 的文件系统查找配合正常。
⚠
未能正确匹配 location block 会导致路径配置错误并产生意外的服务行为。