语 法:disable_symlinks off;
disable_symlinks on | if_not_owner [from=part];
默认值:disable_symlinks off;
上下文:http, server, location
该指令出现在 1.1.15 版中。
设置打开文件时应如何处理符号链接:
off:允许且不检查路径名中的符号链接,默认行为。
on:如果路径名的任何组成部分是符号链接,则拒绝访问文件。
if_not_owner:如果路径名的任何组成部分是符号链接,并且链接指向的链接和对象具有不同的所有者,则拒绝访问文件。
from=part:检查符号链接(参数 on 和 if_not_owner)时,通常会检查路径名的所有组成部分。通过额外指定 from=part 参数,可以避免检查路径名初始部分中的符号链接。在这种情况下,仅从指定初始部分后面的路径名组件检查符号链接。如果该值不是检查的路径名的初始部分,则检查整个路径名,就好像根本没有指定此参数一样。如果该值与整个文件名匹配,则不会检查符号链接。注意:该指令的参数值可以包含变量。
disable_symlinks on from=$document_root;
该指令仅在具有 openat() 和 fstatat() 接口的系统上可用,此类系统包括现代版本的 FreeBSD、Linux 和 Solaris。
参数 on 和 if_not_owner 增加了处理开销。
在不支持仅为搜索而打开目录的系统上,要使用这些参数,工作进程需要对所有被检查的目录具有读取权限。
ngx_http_autoindex_module、ngx_http_random_index_module 和 ngx_http_dav_module 模块目前忽略了这个指令。