发布时间:2026-09-30 05:00 更新时间:2026-09-30 05:00 阅读量:11
装完宝塔或者自己编译 LNMP 之后,很多人会在 Nginx 站点配置里看到一行 fastcgi_pass,它的值有时是 127.0.0.1:9000,有时是 unix:/tmp/php-cgi-74.sock。这两种写法对应 PHP-FPM 的两种监听方式:TCP 端口和 Unix socket。网上常说 socket 更快,但改完就 502 的情况也不少。这篇文章把原理、切换步骤、权限与目录设置,以及 502 的排查顺序一次讲清楚,照着做就能少走弯路。
PHP-FPM 启动时会按配置文件里的 listen 指令决定自己监听什么。写 listen = 127.0.0.1:9000 就是监听本机回环网卡上的 9000 端口,Nginx 通过 TCP 三次握手连上去;写 listen = /run/php-fpm/www.sock 则是创建一个 Unix 域套接字文件,Nginx 通过文件系统路径直接连过去。
差别主要有三点。第一是开销:TCP 要经过协议栈,包一层 IP 和 TCP 头,走回环虽然不经过物理网卡,仍有系统调用与校验成本;Unix socket 在内核里完成,少一层封装,理论上延迟更低、吞吐略高。第二是隔离与可控性:TCP 端口可以被外部访问,约束靠防火墙和 listen.allowed_clients;socket 是文件,靠文件权限控制,天然只对本机进程开放。第三是运维习惯:socket 路径写在 Nginx 和 PHP-FPM 两处配置里,一旦路径不一致或权限不对,立刻 502;TCP 只要端口通就能连,排查路径更短。
需要提醒的是,两者性能差距主要体现在高并发短请求场景,日常访问量不大的站点未必能感知。数值上的差异与 PHP 版本、内核、并发模型都有关,具体以实际压测为准,不建议只看网上的结论就照搬。
先找到 PHP-FPM 的池配置。宝塔面板一般放在 /www/server/php/版本号/etc/php-fpm.d/ 下,自己装的常见于 /etc/php-fpm.d/ 或 /etc/php/版本号/fpm/pool.d/,文件名多为 www.conf。打开后找到 listen 一行,改成 socket 写法,同时把注释掉的权限相关项放开:
; 用 socket 监听时,路径建议放在有权限约束的目录
listen = /run/php-fpm/www.sock
; socket 文件属主与属组,通常与 Nginx 运行用户一致
listen.owner = www
listen.group = www
listen.mode = 0660
; 可选的进程数等参数按内存和并发调整
pm = dynamic
pm.max_children = 20
路径不要随手写 /tmp/xxx.sock,/tmp 目录通常对其他用户可写,容易带来权限与安全上的麻烦。用 /run/php-fpm/ 这类目录时,注意系统重启后 /run 下的内容可能被清理,需要确认目录由服务启动脚本创建,或者改用 /var/run/php-fpm/ 等持久位置,具体以发行版与 PHP 版本的默认约定为准。
改完 PHP-FPM 后,回到 Nginx 站点配置,把 fastcgi_pass 的值改成同一个路径:
location ~ \.php$ {
try_files $uri =404;
fastcgi_pass unix:/run/php-fpm/www.sock;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
两边都改好后,先检查语法再平滑重载,避免配置写错直接把站点打挂:
# 检查 Nginx 配置语法
nginx -t
检查 PHP-FPM 配置语法,路径按实际版本调整
php-fpm -t -c /www/server/php/74/etc/php.ini
重载服务
systemctl reload nginx
systemctl reload php-fpm
确认 socket 文件已生成,且属主属组、权限符合预期
ls -l /run/php-fpm/www.sock
如果服务名不是 php-fpm,用 systemctl list-units | grep php 找到真实单元名再操作,不同发行版的命名差异较大。
502 的本质是 Nginx 连不上上游。排查从「socket 文件是否存在」开始,一层层往外推,不要一上来就重启服务。第一步看文件:ls -l /run/php-fpm/www.sock,如果提示找不到,说明 PHP-FPM 没起来或 listen 路径写错,先看它的启动日志。第二步看权限:Nginx 的运行用户(常见是 www 或 nginx)必须对 socket 文件有读写权限,属主、属组、mode 三者都要对,否则就是 502。第三步看路径一致性:Nginx 里 unix: 后面的路径与 PHP-FPM 的 listen 必须逐字符相同,多一个空格都会失败。
第四步看 Nginx 错误日志,里面通常会写明 connect() to unix:/... failed,跟着这个提示定位比猜要快。第五步确认 SELinux 或 AppArmor 有没有拦住:开启 SELinux 的系统上,socket 所在目录需要正确的上下文标签,可用 ausearch 或 dmesg 查看拒绝记录,具体策略以发行版文档为准。第六步如果以上都对还是不通,用 curl 直接请求一次本地站点,同时观察 PHP-FPM 的慢日志与错误日志,确认请求有没有真正到达 PHP 层。
TCP 方式出问题时思路类似:用 ss -lntp | grep 9000 确认端口在监听,用 curl -v telnet://127.0.0.1:9000 之类方式验证连通性,再核对 Nginx 里的 IP 端口是否与 listen 一致。切回 TCP 时记得把 listen.owner 等相关项注释掉,避免残留配置引发困惑。
小结一下:追求更低开销、站点只在本机访问时,Unix socket 是合理选择;更看重排查简单、需要跨容器或跨机器连接时,TCP 更省事。切换动作本身不复杂,难点在路径、权限、目录位置这三处细节。建议在低峰期操作,改之前备份 php-fpm 池配置和站点 vhost 文件,改完立刻用 curl -I 验证首页返回码,确认正常后再观察一段时间错误日志,有问题能快速回退。
| 📑 | 📅 |
|---|---|
| 网站上线前DNS预检清单:A/CNAME/MX/TXT记录核对与TTL切换节奏 | 2026-09-29 |
| 宝塔面板多站点共用服务器MySQL连接数被打满的排查思路 | 2026-09-29 |
| WordPress附件库臃肿:按月分目录、清理wp_posts与CDN回源调整 | 2026-09-29 |
| 网站换域名后301跳转全流程:DNS、Nginx与收录改址 | 2026-09-29 |
| 宝塔面板站点被搜索引擎抓取异常频繁:UA白名单与抓取频率限制的Nginx写法 | 2026-09-29 |
| WordPress迁移后小工具和菜单丢失:序列化数据与WP-CLI替换思路 | 2026-09-30 |
| 宝塔面板 Nginx 反代 Node.js 与 Python:proxy_pass、WebSocket 与 502 排查 | 2026-09-30 |
| Nginx 与 PHP-FPM 用 Unix socket 报 502:属主与用户组对齐排查 | 2026-09-30 |
| 宝塔面板站点开 HTTP/3:Nginx 版本、Brotli 与 CDN 回源链路评估 | 2026-09-30 |
| WordPress数据库MyISAM转InnoDB:引擎、行格式与写入观察 | 2026-09-30 |