问题不在配置文件,而在「谁来读它」
有一类故障特别容易让人在原地打转:你想把某个目录挂到站点的子路径上,配置写得自认为天衣无缝,重启 Nginx 后访问的却是 403 Forbidden,或者干脆 404。你去看 Nginx 的错误日志,里面只有一行干巴巴的 permission denied;你把目录 chmod 成 777,问题消失了——于是你以为问题解决了。三天后你在别处又遇到同样的情况,才发现之前那次「解决」只是运气。
本文讲的是 Nginx 的 alias 与 root 在真实运维中会遇到的边界问题,重点不是背语法,而是搞清楚四件事:alias 匹配的位置语义、目录权限到底由哪个进程的身份判定、符号链接为什么会在你想不到的地方被拒绝,以及这些行为如何被 SELinux、AppArmor 和 open_basedir 再加一层否决。这四种机制任何一层没通过,都会表现成同一个 403,但修法完全不同。
先给结论:403 不是一种错误,而是一族错误。判断的顺序应该是「路径算得对不对 → 进程有没有读权限 → 路径上是否有符号链接 → 上层安全模块是否放行」。跳过前一步直接改权限,绝大多数时候是在给问题贴补丁。
alias 与 root 的差别:一个替换字符串,一个拼接前缀
root 与 alias 最核心的区别只有一句话:root 是拼接,alias 是替换。用 root 时,Nginx 把 location 匹配到的 URI 整段保留下来接到 root 后面;用 alias 时,location 匹配到的那一段被直接丢掉,换成 alias 指向的路径。
这个差别在 location 以斜杠结尾和不以斜杠结尾时表现完全不同。假设要给 /download/ 这个 URI 前缀提供一个磁盘目录,常见的写法有两种:
location /download/ {
alias /data/files/;
}
location /download {
alias /data/files/;
}第一种写法里,URI 是 /download/a.zip 时,匹配部分是 /download/,被替换成 /data/files/,剩下 a.zip 接上,最终文件路径是 /data/files/a.zip。第二种写法里,匹配部分是 /download(不含斜杠),被替换成 /data/files/ 之后剩下的是 /a.zip,最终变成 /data/files//a.zip——双斜杠通常不影响打开文件,但如果你在 alias 后面漏写了结尾斜杠,就会变成 /data/filesa.zip,直接 404。这类错误在配置里极其隐蔽,因为 location 写得好看,alias 看上去也对。
更常见的一种错法是把 alias 与 location 结尾斜杠配对反了:location /download/ 配上 alias /data/files(无结尾斜杠),结果是 /data/filesa.zip;location /download(无结尾斜杠)配上 alias /data/files/,结果是 /data/files//a.zip 还能打开,但一旦有人访问 /download 本身(不带斜杠),匹配到的替换结果是空,最终路径退化成 /data/files/,Nginx 会去做目录索引,没开 autoindex 就 403。这种「访问 /download/ 正常、访问 /download 报错误」的组合,几乎可以确定是结尾斜杠没对齐。
记住一条硬规则:location 与 alias 的结尾斜杠必须同时有或同时没有。这是所有 alias 排查的第一顺位。
正则 location 里的 alias 必须写捕获组
当 location 用的是正则(以 ~ 或 ~* 开头),alias 的语义又变了一层:它不接受「后缀自动拼接」,你必须用捕获组把要保留的部分显式写出来。典型场景是给不同后缀的文件分别指定目录:
location ~* ^/static/(.+\.(?:png|jpg|webp))$ {
alias /data/images/$1;
}这里 $1 就是被捕获的那段相对路径。如果漏掉 $1,所有请求都会指向 /data/images/ 这个目录,Nginx 会去找一个目录当文件打开,返回 403 或 500。正则里 alias 漏 $1 是很常见的复制粘贴事故:从别处的 root 写法抄过来,root 会自动拼接,alias 不会。
正则 location 与 alias 还有一个容易忽略的坑:捕获组里的路径可能包含 .. 这样的片段。Nginx 在普通文件路径上会做规范化,但在 alias 里配合正则,某些老版本(尤其是未打补丁的 1.10 之前)存在路径穿越风险。如果你还在用很老的 Nginx,看到正则 alias 里有 $1,就该确认版本并且确保捕获组不允许 ..。稳妥的做法是把后缀和字符集都限制死,例如只允许字母数字、下划线、点和斜杠。
403 的第一层:路径算对了,但进程读不到
Nginx 的工作进程以某个用户身份运行,通常写在主配置顶部的 user 指令里,Debian 系默认是 www-data,CentOS 系默认是 nginx。这个身份决定了它能读哪些文件。搞不清这一点,就会出现「我用 root 明明能 cat,怎么 Nginx 说没权限」。
判断顺序是这样的:先看路径算出来的实际文件(用 Nginx 的 debug 日志或者 error_log 里的路径),再逐级看目录的执行位。Linux 上要打开 /data/files/a.zip,进程对 /、/data、/data/files 这三层目录都必须有执行(x)权限,对最后的 a.zip 需要有读(r)权限。注意是每一层目录。把 /data 设成 700 属主 root,文件本身 644 www-data 可读,一样打不开——因为中间那一层目录进不去。这是「文件权限明明对了还是 403」的第一大原因。
所以正确的最小权限是:目录 755(属主可写、其他可进入),文件 644(属主可写、其他可读)。如果确实需要防止目录被遍历,把「可读目录内容」拿掉而保留「可进入」就够:目录设成 711 而不是 700,其他人能按已知路径拿到文件,但列不出目录清单。这比 700 实用得多,也避免了 Nginx 403。
用 namei 可以一次性验完整条链路,它会把每一层的权限都列出来:
namei -l /data/files/a.zip输出会逐行显示 /、/data、/data/files、a.zip 的 owner、group 和 mode。只要看 www-data 能不能在那三列上通过,问题立刻清楚。这个命令比 ls -l 一个文件有用得多,因为它把「路径权限」和「文件权限」一起摊开了。
setgid 与组权限:让新文件自动够得着
比 403 更烦的是「老文件能访问,新上传的访问不了」。原因通常是上传程序用别的用户跑(比如 PHP-FPM 池用户、Docker 容器内的 uid),写出来的文件属主是别人,组也是别人,Nginx 读不到。
稳妥的做法是让整个目录有一个共享组:
chgrp -R www-data /data/files
chmod -R g+rwX /data/files
find /data/files -type d -exec chmod 2755 {} \;
umask 0002目录上的 setgid 位(2755 里的 2)意味着在这个目录里新建的文件和子目录会自动继承父目录的组,而不是创建者的主组。这样无论上传进程是哪个用户,只要它的主组是 www-data 或者它属于 www-data 组,文件写出来就自动带 www-data 组,Nginx 读得到。X 是大写,意思是只给目录和已有执行位的文件加 x,不会把普通数据文件变成可执行——这条细节很关键,用小写 x 会给所有文件加上执行权限。
另外注意容器部署时 uid 的映射:容器里跑 PHP 的 uid 往往是 33(www-data)或者 1000,而在宿主机上挂载的目录属主是 root。这种情况下容器内进程写出来的文件在宿主机上是 33:33 或者 1000:1000,Nginx 在宿主机上如果是另一个 uid,就会读不到。要么把宿主机的组对齐,要么用 user 指令在容器启动时指定 uid,不要让两个进程身份各说各话。
符号链接:为什么 target 明明存在还是 404
符号链接有一道独立的开关:disable_symlinks。Nginx 默认是允许跟随软链的,但很多安全加固指南会建议打开它。一旦打开,就出现「我明明 ln -s 过去了,文件在那里,Nginx 说找不到」的经典现象。
disable_symlinks on;这个指令可以取 if_not_owner、from=、off 等值。if_not_owner 是常见的折中:符号链接本身和它指向的目标属主不同就拒绝。from=/data 则是从某个路径开始检查。这类配法的本意是防住「攻击者上传一个软链指向 /etc/passwd」的路径穿越,但副作用是运维自己的软链也会被拦。
排查时应当先确认有没有这道开关,而不是先怀疑路径。反过来的情况也常见:软链是相对路径,指向的目标在另一个目录层级上解析,结果超出了预期。用 readlink -f 把它解析成绝对路径,一眼就能看出落点:
readlink -f /data/www/upload/image还有一种情况是软链有效但落点目录没有执行位——这又回到上一节的目录权限问题。软链本身不携带自己的权限,权限判定永远发生在目标上。
上层安全模块:SELinux 与 AppArmor 的否决权
如果路径、目录权限、软链都没问题,仍然 403,那么几乎可以肯定是被 SECURITY 模块拦了。
SELinux 在 RHEL 系默认开启。它的判定单位是「类型」,不是文件权限。你把文件放到了 /data/files,而 SELinux 里这个路径的类型可能是 default_t 或 var_t,而 Nginx 进程只能读 httpd_sys_content_t 类型。用 ls -Z 可以看类型:
ls -Z /data/files/
ps -efZ | grep nginx标准修法有两种。一种是给路径打上正确的上下文,永久生效用 semanage fcontext 加 restorecon:
semanage fcontext -a -t httpd_sys_content_t "/data/files(/.*)?"
restorecon -Rv /data/files另一种是放行 Nginx 读用户目录(把 content 放在 /home 下时最常用):
setsebool -P httpd_read_user_content 1注意 setsebool 的 P 参数是持久化,不加这条重启就失效,这是新人最常见的「临时改好了、重启又坏」的原因。要判断当前是不是 SELinux 拦的,用 ausearch 查 AVC 拒绝记录最直接:
ausearch -m AVC -ts recent如果有 comm="nginx" 的 denied 记录,就锁定是 SELinux,再也不用去折腾 chmod 了。
AppArmor 在 Ubuntu/Debian 上是默认启用的,它的判定单位是路径白名单。Nginx 的 AppArmor 配置文件里通常只列出 /var/www 和几个标准路径,你把目录迁到 /srv 或 /data,AppArmor 会直接拒绝并记到 dmesg 里。查证方式是看内核日志,找 apparmor="DENIED" 的行:
dmesg | grep -i apparmor | tail -20修法是把新路径加进 /etc/apparmor.d/usr.sbin.nginx 的白名单并 reload。切忌直接 disable,那等于把整套防护全关了,为了一个目录不值得。
open_basedir 与 open_basedir 之外的一条容易被忽略的:chroot
还有一种 403 来自 PHP 侧而不是 Nginx 侧,但表现很像。当站点用 PHP 的 open_basedir 限制目录范围时,PHP 访问超出范围的路径会报错,而如果错误发生在生成页面阶段,用户看到的就是 403 或者 500。很多人看到 403 就去改 Nginx,其实应该先看 PHP 的错误日志。open_basedir 的路径必须精确、不能写通配符,多个路径用冒号分隔,末尾加上斜杠才表示目录本身。
另外如果 Nginx 配了 chroot,那么所有绝对路径都是相对 chroot 根解释的,alias /data/files/ 在 chroot 之后实际指向 chroot根/data/files。这种情况下用宿主机的视角去看文件「明明存在」,在 chroot 内部是不存在的。出现「配置没变但 403」时,问一句「这套 Nginx 是不是跑在 chroot 或者容器里」往往能少走一小时弯路。
一套可以照着走的排查流程
把上面的内容压成一条线,遇到 403 就按顺序走,每一步只回答一个是非问题,避免同时改动多个层面:
第一步,把日志级别临时调到 debug,看 Nginx 算出的实际文件路径。这一行会直接告诉你路径拼错了没有,alias 结尾斜杠、正则没写捕获组、root 与 alias 混用,都会在这一步暴露。看完记得调回去,debug 级别日志量极大,一天能把磁盘写满。
第二步,用 namei -l 验证整条路径的权限链路,确认 Nginx 用户对每一层目录都有执行位、对文件有读位。如果新文件访问不了而老文件可以,检查 setgid 和 umask 的继承。
第三步,确认 disable_symlinks 的状态和软链落点,用 readlink -f 解析绝对路径。
第四步,用 ausearch 和 dmesg 确认 SELinux 与 AppArmor 有没有拒绝记录。有就按上下文或白名单修,不要关掉整个模块。
第五步,如果 Nginx 侧全部干净,去看 PHP 的 open_basedir 和 chroot 环境。
整个过程中最值得坚持的一条原则是:一次只改一层,改完立刻验证。403 之所以难查,不是因为机制复杂,而是因为四层机制共用同一个错误码,同时改动会让你永远不知道是哪一层起了作用,下一次遇到还是不会。
最后补一个容易被忽略的运维习惯:给这类外挂目录的配置留一条注释,写明目录用途、属主、组和 403 时该看哪几层。半年后接手的人(很可能就是你自己)会感谢这条注释,它比任何排查技巧都省时间。