FastCGI 参数注入是 Nginx 与 PHP-FPM 组合里最容易被跳过的一类风险:请求没有触发任何 SQL 注入或文件上传漏洞,却因为 PATH_INFO 解析与 fastcgi_param 拼接不当,让一个图片文件被当成 PHP 脚本执行。本文从现状探测开始,给出关闭解析歧义、收敛执行入口、拦截控制字符、封死 fpm 暴露面的完整配置。
适用场景
以下部署形态建议按本文完整加固,只改一两行通常堵不住:
- 站点采用 Nginx 反向代理加 PHP-FPM(Laravel、ThinkPHP、WordPress、Discuz 均属此类);
- 伪静态规则里出现了 location ~ \.php$ 这类泛匹配,或使用了 fastcgi_split_path_info;
- 站点存在可写目录(上传、缓存、附件、session),攻击者可落地任意扩展名文件;
- PHP 仍运行 7.x 早期版本,cgi.fix_pathinfo 保持默认值 1;
- php-fpm 池监听 0.0.0.0:9000,安全组或防火墙未对 9000 做限制。
前置条件
- Nginx 1.18 及以上,PHP-FPM 7.4 及以上,具备 root 或 sudo 权限;
- 已备份配置:
cp -a /etc/nginx /etc/nginx.bak.$(date +%F)与cp -a /etc/php /etc/php.bak.$(date +%F); - 本机可执行 curl、ss、nmap,用于逐项验证;
- 确认业务是否真的依赖 PATH_INFO,这一步决定改造幅度;
- 选择低峰期变更,改完立即复测核心业务链路。
原理说明
Nginx 通过 FastCGI 协议把请求交给 php-fpm,传递的方式是把一组键值对写进 FastCGI 参数区,其中最关键的是 SCRIPT_FILENAME,它决定 fpm 去执行磁盘上的哪个文件。Nginx 侧由 fastcgi_param 指令负责填值,常见写法是 $document_root$fastcgi_script_name。
第一个风险点是路径裁剪。当 cgi.fix_pathinfo 为 1 时,PHP 拿到一个不存在的脚本路径,会不断往上裁剪目录,直到找到一个真实存在的 .php 文件为止。于是请求 /uploads/2026/a.jpg/x.php 时,fpm 最终执行的是 a.jpg。只要上传目录允许图片落地,攻击者把 PHP 代码写进图片尾部即可获得执行权,这也是图片马长期有效的原因。Nginx 若再用 fastcgi_split_path_info 把 URI 拆成脚本名与 PATH_INFO 两段,等于主动把这个裁剪行为坐实。
第二个风险点是参数拼接。fastcgi_param 的值由 Nginx 变量展开,而 $uri 是经过 URL 解码后的结果。若请求里带 %0a,解码后就是换行符,会被原样写进 FastCGI 环境变量。后端把这段内容拼入 CGI 环境或响应头时,换行即成为分隔符,形成参数注入与日志注入;更老的组合里,这个问题配合路径裁剪演变成内存越界,CVE-2019-11043 就是 fastcgi_split_path_info 加上 try_files 缺位导致的 php-fpm 越界写入。
第三个风险点是端口暴露。FastCGI 协议本身没有任何认证,任何人连上 9000 端口都能自行指定 SCRIPT_FILENAME。因此加固必须三条线同时收:不裁剪、不全匹配、不出网。
操作步骤
第一步:定位现有风险项
先取一份配置全文,把可疑指令全部列出来,不要凭印象改:
# 1. 找出所有泛匹配与 PATH_INFO 拆分
nginx -T 2>/dev/null | grep -nE 'location .*\.php|fastcgi_split_path_info|fastcgi_pass|fastcgi_param[[:space:]]+SCRIPT_FILENAME'
# 2. 查看 PHP 关键开关
php -i | grep -E '^cgi\.fix_pathinfo|^expose_php|^open_basedir|^disable_functions'
# 3. 查看 fpm 监听地址(socket 还是 TCP,是否绑到 0.0.0.0)
ss -lntp | grep -E ':9000|php.*fpm'
grep -nE '^listen' /etc/php/*/fpm/pool.d/www.conf
# 4. 从公网视角判断 9000 是否可达
nmap -Pn -p 9000 --open 服务器公网IP
四条命令的输出就是基线。第 1 条若命中 location ~ \.php$,说明任意路径下只要拼出 .php 后缀就会进入 PHP 处理分支;第 2 条 fix_pathinfo 为 1 是裁剪行为的前提;第 4 条若显示 open,说明 FastCGI 直接暴露在公网,优先级高于其他所有项。
第二步:关闭路径裁剪并收紧 PHP 运行面
修改 php.ini,让 PHP 只执行明确指定的文件。open_basedir 是纵深防御的第二道墙,即便前一层被绕过,也只能在限定目录内读取:
; /etc/php/8.1/fpm/php.ini
cgi.fix_pathinfo = 0
expose_php = Off
open_basedir = /data/www/example:/tmp
; 若业务不依赖这些函数,一并禁用
; 注意:部分框架的图片处理依赖 exec,禁用前务必回归测试
disable_functions = exec,passthru,shell_exec,system,proc_open,popen
改完后重载 fpm:systemctl reload php8.1-fpm。这一步只是让 PHP 不再向上裁剪,Nginx 侧仍可能把错误路径传下来,所以下一步必须同步改。
第三步:把 PHP 执行入口收敛为精确匹配
不要再对全站声明 \.php$。正确做法是只给唯一入口开一个精确匹配的 location,其余路径一律走静态文件与 404:
server {
listen 443 ssl http2;
server_name www.example.com;
root /data/www/example;
index index.php index.html;
# 唯一执行入口:精确匹配,不接受任何 PATH_INFO
location = /index.php {
fastcgi_pass unix:/run/php/php8.1-fpm.sock;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO "";
fastcgi_param HTTP_PROXY "";
fastcgi_read_timeout 60s;
fastcgi_hide_header X-Powered-By;
}
# 静态资源直出,任何 .php 请求直接拒绝
location / {
try_files $uri $uri/ =404;
}
# 可写目录:禁止脚本执行,只允许读
location ^~ /uploads/ {
location ~ \.php$ {
return 403;
}
try_files $uri =404;
}
location ^~ /cache/ {
deny all;
}
}
关键点有三处。location = /index.php 用等号前缀,只匹配这一个 URI,/index.php/foo/bar 不会命中;fastcgi_param PATH_INFO "" 显式把 PATH_INFO 置空,避免后端从环境变量里拼出第二条脚本路径;上传目录内嵌的 location ~ \.php$ 优先级更高,命中就返回 403。
如果业务确实必须使用 /index.php/module/action 这种 URL 形态,不要让 fpm 去猜,改为在 Nginx 层截断后重写。把 PATH_INFO 交给框架解析,脚本名始终固定为 index.php:
# 保留 pretty URL 但不产生脚本歧义
location ~ ^/index\.php(/.*)?$ {
fastcgi_pass unix:/run/php/php8.1-fpm.sock;
include fastcgi_params;
fastcgi_split_path_info ^(/index\.php)(/.*)$;
fastcgi_param SCRIPT_FILENAME $document_root/index.php;
fastcgi_param PATH_INFO $fastcgi_path_info;
}
这里 SCRIPT_FILENAME 被写死为 index.php,即便 fastcgi_split_path_info 拆出了别的片段,也不会改变真正执行的文件。拆分只用于生成 PATH_INFO 变量,风险面被限制在可控范围。
第四步:拦截换行与控制字符
在 server 块首部加一条前置判断。$request_uri 是未解码的原始 URI,因此可以直接匹配百分号编码:
server {
# 放在所有 location 之前,命中即拒绝
if ($request_uri ~* "%0a|%0d|%00|%09") {
return 400;
}
}
不要用 $uri 做这个判断,它已经解码,换行符不会再以 %0a 形式出现。若需要更严格的净化,可对传入 fastcgi_param 的自定义变量做白名单映射,例如只允许字母数字与短横线:
map $http_x_forwarded_proto $safe_proto {
default "";
"~^(https?)$" $1;
}
# 使用处
fastcgi_param X-Forwarded-Proto $safe_proto;
这一类 map 的价值在于把外部可控字符串压成有限枚举值,无论输入带什么控制字符,最终都落到空字符串,注入链路被切断。
第五步:封死 php-fpm 暴露面
FastCGI 用 socket 通信比 TCP 更安全,至少不占端口、不出网。修改池配置并确保 Nginx 运行用户与 socket 属主一致:
; /etc/php/8.1/fpm/pool.d/www.conf
listen = /run/php/php8.1-fpm.sock
listen.owner = www-data
listen.group = www-data
listen.mode = 0660
; 若必须用 TCP,只允许本机
; listen = 127.0.0.1:9000
随后在防火墙上兜底,规则要在云安全组与主机层各做一次,避免只配了一侧:
# 主机层:拒绝外部访问 9000
iptables -I INPUT -p tcp --dport 9000 ! -s 127.0.0.1 -j DROP
# 持久化
apt-get install -y iptables-persistent
netfilter-persistent save
# 复核监听状态
ss -lntp | grep 9000 || echo "9000 未监听 TCP,符合预期"
如果用 systemd 管理,还可以给 fpm 服务加一层网络隔离,彻底断掉对外连接能力:systemctl edit php8.1-fpm 中加入 [Service] 段与 IPAddressDeny=any、IPAddressAllow=localhost。这样即使配置被改回 0.0.0.0,进程也无法接受外部连接。
配置验证
逐项复测,每一条都有明确的期望结果,任何一项不符说明对应环节未生效:
HOST=www.example.com
echo "== 1. 路径裁剪(期望 403 或 404)"
curl -s -o /dev/null -w "%{http_code}\n" "https://$HOST/uploads/test.jpg/x.php"
echo "== 2. 多重后缀(期望 403 或 404)"
curl -s -o /dev/null -w "%{http_code}\n" "https://$HOST/index.php/a.jpg/x.php"
echo "== 3. 换行注入(期望 400)"
curl -s -o /dev/null -w "%{http_code}\n" "https://$HOST/index.php%0aX-Injected:%20yes"
echo "== 4. 版本头泄露(期望无输出)"
curl -sI "https://$HOST/" | grep -i "x-powered-by" || echo "OK 无泄露"
echo "== 5. 正常业务(期望 200)"
curl -s -o /dev/null -w "%{http_code}\n" "https://$HOST/"
- 第 1、2 条返回 403 表示上传目录拦截生效;返回 404 表示入口收敛生效,两者都可接受,返回 200 必须立刻回查第二节;
- 第 3 条返回 400 说明控制字符前置判断生效,返回 200 说明判断写在了 location 内部,未覆盖全部路径;
- 第 5 条必须仍为 200,且首页内容与改造前一致,业务可用性是加固的底线。
常见问题
Q1:关闭 fix_pathinfo 后,框架的伪静态页面全部 404 怎么办?
这不是加固做错了,而是说明业务原本依赖路径裁剪。处理顺序是:先确认框架的路由模式,Laravel 用 try_files $uri $uri/ /index.php?$query_string 即可,PATH_INFO 由 REQUEST_URI 推导;ThinkPHP 可在配置中把 URL 模式改为兼容模式,用 ?s=/module/action;对于必须依赖 PATH_INFO 的老系统,采用第三步中第二种写法,把 SCRIPT_FILENAME 固定为入口文件,让拆分只服务于变量。切勿为了恢复访问把 fix_pathinfo 改回 1。
Q2:上传目录禁止执行 PHP 后,附件下载与图片预览都失效了?
排查两处。其一是 location 嵌套顺序,若外层用了 location /uploads/ 而没有 ^~,正则 location 可能先被匹配走,导致整段拒绝规则未执行;其二是 try_files 缺位,某些情况下请求被交给上游而非本地文件。正确写法是外层 ^~ 前缀加内层正则拒绝,再加 try_files $uri =404。若附件实际存放在上级目录并靠 alias 映射,还要检查 alias 尾部斜杠,避免路径拼出目录穿越。
Q3:线上已有大量图片马,配置改完是否就安全了?
不安全。配置只切断执行链路,恶意文件仍在磁盘上,一旦某次发版回滚或新增一个通配 location,风险立即恢复。必须配合一次存量清理:按扩展名与内容双重特征扫描可写目录,找出含 PHP 起始标签的图片与文本文件,逐个人工确认后删除;同时在上传环节增加扩展名白名单、内容类型校验与随机文件名。清理脚本应保留扫描清单与处理时间,作为事件记录留存。
总结
FastCGI 参数注入的根因是路径解释权与执行权没有分离。落地顺序固定为四步:拉配置基线确认风险项、关闭 fix_pathinfo 与 open_basedir 限界、执行入口收敛为精确匹配、控制字符前置拦截,最后把 fpm 收回 socket 并用防火墙兜底。整套改动只有几十行配置,难点在兼容既有路由,因此每次变更都应保留 nginx -T 的输出,出问题时能在一分钟内回滚。