从一次「图片上传不上去」说起
上周有个朋友找我,说他站点的后台一上传图片就报 500,前台一切正常。他给上传目录执行了 chmod -R 777,问题好了半天,第二天又不行了,而且更奇怪——首页多了一个不认识的 php 文件。
这两个现象其实是同一件事的两面:777 这种权限不是「够用」,而是「对所有人敞开」。敞开之后,一方面上传目录变成了可执行目录,另一方面任何本地用户(包括被入侵后落地的低权限账号)都能往里塞东西。而他第二天遇到的 500,恰恰是 777 让 PHP-FPM 的 umask 与目录的 setgid 位互相打架的结果。
这篇讲的是 Linux 权限在这类场景下的真正用法:为什么 777 是错的、正确的权限模型长什么样、umask 在哪里生效,以及比权限更该先做的——把 sudo 权限收窄。
三位八进制数,每一位管三件事
先把基础摆正,因为大多数 777 都是「不懂那一串数字」的结果。755 拆开是 owner=7、group=5、other=5,而 7=4+2+1:
r (4):读。对文件是能读取内容,对目录是能列出名字(ls)。
w (2):写。对文件是能修改内容,对目录是能创建和删除其中的条目。
x (1):执行。对文件是能运行,对目录是能进入并访问其中具体路径。
这里有两个最容易被误解的点,而它们恰好是上传目录出事的核心:
第一,目录的 x 比 r 更重要。一个目录如果是 644(没有 x),你就算知道里面文件的完整路径,访问它也会得到 Permission denied。上传目录必须是 755 或 750,而不是 644。反过来,一个目录是 711 时,别人不能 ls 看见里面有什么,但知道确切文件名就能访问——这就是「可访问但不可枚举」。
第二,删除权限由目录决定,不由文件决定。文件本身是 444(只读),只要它所在的目录对你有 w,你就能 rm 它。这个规则解释了为什么「把 config.php 设成 444 防止被改」是无效防御:攻击者只要能在同目录创建文件,就能删掉它再写一个新的。真正有效的是把目录设成不可写。
777 到底放开了什么
当上传目录是 777 时,发生的是这样一串连锁反应:
drwxrwxrwx www-data www-data uploads/
# 任何本地用户都能在这里:创建文件、删除别人上传的文件、把已有文件改名危险来自三处,一处比一处严重:
它可以被当成投放点。站点如果被拖了一个低权限 shell(比如某个插件漏洞),攻击者不用提权,直接把 webshell 写进 777 的上传目录就行,路径还是网站根目录下的,直接能从浏览器访问。
它可以被当成删除入口。目录里 w 权限意味着能删。删掉 .htaccess、删掉上传保护配置、删掉索引文件,都是顺手的事。
它会掩盖真正的问题。这才是最要命的——原本的 500 是权限不对(比如目录属主是 root,PHP-FPM 以 www-data 运行,没权限写),执行 777 之后「能写了」,问题看起来解决了,但根因(属主错)一直都在。下次升级、迁移、重装,问题会以另一种形式回来。
我的原则很简单:服务器上不允许出现 777。真需要「大家都能写」的时候,用「同组 + setgid」而不是「other 全开」。
正确的上传目录模型:属主、组、setgid
一个站点正常的权限布局是这样的(假设 PHP-FPM 以 www-data 运行,SSH 登录用户是 deploy):
# 代码目录:属主 deploy,组 www-data,目录 750、文件 640
chown -R deploy:www-data /var/www/site
find /var/www/site -type d -exec chmod 750 {} \;
find /var/www/site -type f -exec chmod 640 {} \;
# 上传目录:属主 www-data(PHP 要写),组 www-data,目录 2775、文件 664
chown -R www-data:www-data /var/www/site/uploads
find /var/www/site/uploads -type d -exec chmod 2775 {} \;
find /var/www/site/uploads -type f -exec chmod 664 {};关键在于目录上的那个 2:2775 里的 2 是 setgid 位。它有两个效果,第二个才是重点:
效果一:目录下新建的文件继承该目录的组,而不是创建者的主组。这样无论谁创建的文件,组都是 www-data。
效果二:目录下新建的子目录自动继承 setgid 位。这一点决定了子目录不会「掉链子」——如果不设 setgid,上传时自动创建的 uploads/2026/11/ 这类子目录会沿用父目录的组,但新建的下一级又会变回创建者的主组,层级一深就乱了。
# 验证 setgid 是否生效
mkdir -p /tmp/t && chmod 2775 /tmp/t && ls -ld /tmp/t
# 期望看到:drwxrwsr-x (组权限位上的 s 就是 setgid)
# 检查站点里是否还有缺失的 setgid
find /var/www/site/uploads -type d ! -perm -2000 -ls为什么属主给 www-data 而不是 deploy?因为上传目录的写入者就是 PHP 进程。如果属主是 deploy、组是 www-data、权限 750,PHP 依然写不进去(other 无权限)。所以上传目录必须让 www-data 有写权,最直接的方式就是属主设它。
那 deploy 用户怎么维护这些文件?答案是加进 www-data 组,并给目录组写权限:
usermod -aG www-data deploy
# 重新登录生效,验证:
id deploy
# 应包含 groups=...,27(www-data)umask:权限的另一半,而且常常被忽略
上面说的 chmod 是「显式设权限」,umask 是「新建文件时默认去掉哪些权限」。两者是互补的,很多人只调了前者,结果新建的文件又是 666/777。
规则是:新建文件的权限 = 默认值 & ~umask。默认值文件是 666,目录是 777。umask 022 时,文件得 644、目录得 755;umask 027 时,文件得 640、目录得 750。
# 看当前 umask
umask
# 输出如 0022 或 0027
# systemd 服务里单独指定(推荐,不影响全系统)
systemctl edit php8.1-fpm.service
# [Service]
# UMask=0027这里有个 PHP 特有的坑:PHP-FPM 的 umask 与应用里 mkdir()、move_uploaded_file() 的权限参数是叠加关系。如果代码写 mkdir($dir, 0777),而 FPM 的 umask 是 0027,实际得到 0750——看起来还好。但如果 umask 是 0000(有些面板会这么设),得到的就是真正的 0777。这也是为什么有人「代码里明明写的是 0755」,上线后却发现目录是 777。
所以正确处理是两头都管:代码里传 0755 或 0775(不要 0777),同时给 PHP-FPM 设 UMask=0027。两处收窄,得到一致的结果。
再补一个排查手法:新建的文件权限对不对,能反推是哪个进程创建的。比如发现 uploads/ 里有 644 root 的文件,那就是某个 root 跑的定时脚本生成的(比如备份脚本、图片处理 cron),而 PHP 进程之后无法覆盖它——这就是「上传时好时坏」的常见原因之一。
上传目录的安全收口:权限只是第一层
把权限设对,只是不让上传目录变成公共投递点。上传功能真正的风险是「有人传了个 .php 上去并且被执行」。这需要第二、三层防护,而且成本极低:
第一层:禁止在上传目录执行脚本。Nginx 里单独给上传目录加一个 location,直接拒掉 php:
location ~* ^/uploads/.*\.(php|php5|phtml|phar)$ {
deny all;
return 403;
}
# 更稳的做法:上传目录只当作静态资源,任何脚本一律不解析
location ^~ /uploads/ {
location ~ \.(php|phtml|phar)$ { return 403; }
expires 30d;
add_header X-Content-Type-Options nosniff;
}第二层:不信任任何上传的文件名。重命名成随机串,扩展名走白名单(只允许 jpg/png/webp/gif),并且把 MIME 类型从文件内容里读取校验,而不是信 $_FILES['type'](那个是客户端传的,可以随便伪造)。文件名里的 ../ 要过滤,否则能写到上级目录。
第三层:open_basedir 把 PHP 能碰到的路径限死在站点目录内。在 PHP-FPM 池配置里加:
php_admin_value[open_basedir] = /var/www/site:/tmp
# 注意:这是「允许访问」清单,漏了 /tmp 会导致 session 和上传临时文件失败这一条能挡住「通过某个漏洞读到 /etc/shadow 或别人的站点」的横向渗透。open_basedir 配错的典型症状是上传失败但错误日志只写 file_put_contents(): open_basedir restriction in effect,看到这句就知道是配置而不是权限。
比权限更重要:sudo 的最小化
权限模型管的是「谁能碰这些文件」。但如果登录用户本身就能 sudo 一切,前面的努力瞬间归零——sudo su 一行就拿到了 root。所以真正要做的是:日常运维不用 root,只在少数必要命令上开 sudo,并且范围写死。
先看现状,这一步常常吓人:
# 谁在 sudo 组里
getent group sudo
# 谁能免密 sudo(输出为空才正常,非空要逐个核对)
sudo grep -rE 'NOPASSWD' /etc/sudoers /etc/sudoers.d/
# 谁能直接 bash 成 root(这是最常见的过度授权)
sudo grep -rE 'ALL\s*$|ALL:ALL' /etc/sudoers /etc/sudoers.d/deploy ALL=(ALL:ALL) ALL 这句话的意思是「deploy 可以在任何主机上、以任何用户身份、运行任何命令」。它等价于:这个账号就是 root,只是多打四个字符。
正确的做法是用 /etc/sudoers.d/ 分文件写,并且每条都限定到具体命令:
# /etc/sudoers.d/deploy-ops (用 visudo -f 编辑,别用普通编辑器)
Cmnd_Alias SITE_RESTART = /bin/systemctl restart php8.1-fpm, \
/bin/systemctl reload nginx, \
/bin/systemctl reload php8.1-fpm
Cmnd_Alias SITE_LOG = /usr/bin/journalctl -u nginx, \
/usr/bin/tail -f /var/log/nginx/error.log
deploy ALL=(root) NOPASSWD: SITE_RESTART, SITE_LOG
deploy ALL=(root) /usr/bin/apt update, /usr/bin/apt upgrade几个必须注意的细节,每一条都是「看着像限制了、其实没限制」的陷阱:
命令路径要写绝对路径,而且要和 which 的结果一致。写 systemctl 而不是 /bin/systemctl,sudo 会报找不到命令;而如果路径写错了成另一个同名二进制,等于给了别人执行任意程序的入口。
不要给能起 shell 的命令。vi/vim/less/man/find/awk/tar/docker/systemctl(某些子命令)都能逃逸成 root shell。sudo vi 里执行 :!sh 就是 root shell,这是渗透里的标准操作。所以上面只给 systemctl restart 具体服务,而不是给 systemctl。
参数也要限死,或者至少不给通配符。deploy ALL=(root) NOPASSWD: /bin/chmod * 看着很安全,实际上 chmod --reference 加一个精心构造的路径就能做很多事;而且通配符 * 在 sudo 里不匹配 /,但会匹配一串参数,容易超出预期。能给固定参数就给固定参数。
用 visudo -c 验证语法。sudoers 语法错会导致所有 sudo 失效,包括你自己的——这是把自己锁在门外的经典事故。/etc/sudoers.d/ 下的文件如果有一个反斜杠写错,sudo 全线报 syntax error。所以每次改完立刻:
visudo -c
# 期望输出:/etc/sudoers: parsed OK 以及每个 drop-in 文件 OK还有一条保命建议:改 sudo 之前另开一个 root 会话别关。如果新配置有问题,你还留着一扇开着的门。
把权限和 sudo 一起做成一次基线检查
单次修好不算完,站点会不断产生新文件(上传、缓存、日志、定时任务输出),权限会漂移。所以我用两个脚本,一个查、一个纠,都放进 crontab 每周跑一次。
#!/bin/bash
# /usr/local/bin/perm-audit.sh —— 只报告,不修改
set -uo pipefail
ROOT=/var/www
echo "== 777 的目录和文件(必须为 0) =="
find "$ROOT" -perm -0002 -o -perm /0002 2>/dev/null | head -20
echo "== 属主不是 deploy/www-data 的文件 =="
find "$ROOT" ! -user deploy ! -user www-data -ls 2>/dev/null | head -20
echo "== uploads 下缺 setgid 的目录 =="
find "$ROOT/site/uploads" -type d ! -perm -2000 2>/dev/null | head -20
echo "== 站点目录里不该出现的可执行脚本 =="
find "$ROOT/site/uploads" -type f \( -name '*.php' -o -name '*.phtml' -o -name '*.phar' \) 2>/dev/null
echo "== world-writable 的配置文件 =="
find "$ROOT" -name '*.php' -perm /0002 2>/dev/null第一行 find -perm -0002 是「至少 other 有写位」,这是要清零的目标。第二行找属主异常,往往是 root 跑过的脚本留下的。第四行找上传目录里的脚本文件,这些一旦出现就该立刻删掉并查日志。
纠正脚本要更保守,只动目录和明确的类型,并且先打印再执行(我坚持用 dry-run 开头):
#!/bin/bash
# /usr/local/bin/perm-fix.sh —— 先在 dry-run 下看清,再改成真跑
set -uo pipefail
ROOT=/var/www/site
DRY=${DRY:-1}
run() { if [ "$DRY" = 1 ]; then echo "[dry] $*"; else "$@"; fi; }
run find "$ROOT" -type d -exec chmod 755 {} \;
run find "$ROOT" -type f -exec chmod 644 {} \;
run find "$ROOT/uploads" -type d -exec chmod 2775 {} \;
run find "$ROOT/uploads" -type f -exec chmod 664 {} \;
run chown -R www-data:www-data "$ROOT/uploads"DRY=0 ./perm-fix.sh 才真跑。这个习惯救过我一次:某次 ROOT 变量写错了一个字母,dry-run 直接打印出了 4000 多条待改路径,一眼就看出不对,没造成任何后果。
一份可以照着走的次序
如果现在站点正乱着,别一口气全改。按这个次序,每步验证完再下一步:
1. 先发现状。跑一遍上面的审计脚本,把 777 的、属主异常的、uploads 里有 php 的三类全部列出来。先不动手。
2. 先清危险,再理整齐。上传目录里的可执行脚本先删(并备份到别处),这是安全隐患;777 改成 755/2775 是第二步。
3. 修属主,不动权限。把该是 www-data 的改成 www-data,该是 deploy 的改成 deploy。很多 500 在这一步就好了——之前 777 只是把属主错掩盖了。
4. 上 setgid 与 umask。目录 2775,PHP-FPM 加 UMask=0027,代码里 mkdir 改 0775。验证新上传的文件是不是 664。
5. 收口上传执行。Nginx 拒掉 uploads 下的 php,加 open_basedir,文件名白名单+随机化。
6. 收 sudo。列出所有 NOPASSWD 和 ALL,改成按命令白名单,visudo -c 验证,另开 root 会话保底。
7. 定期复跑。审计脚本进 cron,每周一次,结果直接发到自己的邮箱或者一个日志文件。权限漂移是持续发生的,不会一次治愈。
小结
权限和 sudo 是这个方向上最容易「以为懂了」的两件事。记住四条就够:目录的 x 决定能不能访问、目录的 w 决定能不能删除;上传目录的正确形态是 www-data 属主 + 2775(setgid);umask 决定新建文件的默认权限,必须和 chmod 一起管;sudo 要按命令白名单授权,ALL=(ALL:ALL) ALL 等于交出 root。至于 777,它不是「省事」,它是把问题藏起来的同时多开了一扇门。