怎么使用Linux的lsof和netstat命令排查Workerman端口?

胖芳小哥_8386

胖芳小哥_8386

2026-05-25

491人浏览

原创

应使用lsof -i :端口号或netstat -tuln | grep :端口号确认Workerman是否真正在监听目标端口,若无输出说明未成功绑定,若有则需检查监听地址是否为0.0.0.0而非127.0.0.1,并排除防火墙、安全组及残留进程干扰。

怎么使用linux的lsof和netstat命令排查workerman端口?

查 Workerman 进程是否在监听目标端口

Workerman 默认用 Worker::listen() 启动 TCP/UDP 服务,但不会自动打印监听地址。如果客户端连不上,第一件事是确认进程确实在监听——而不是只启动了但没成功绑定端口。

用 lsof -i :2345(把 2345 换成你的实际端口)直接查端口占用。如果返回空,说明没进程在监听;如果有输出,看 PID 和 COMMAND 列是否匹配你的 Workerman 主进程名(比如 php 或你自定义的 start.php)。

netstat -tuln | grep :2345 效果类似,但更轻量。注意加 -n 避免 DNS 解析拖慢响应,-tul 分别表示 TCP、UDP、监听态、显示 PID/程序名(部分系统需 root 权限才显示 PID)。

  • 常见错误:只查 localhost:2345 却忽略 *:2345 ——Workerman 默认绑定 0.0.0.0,lsof 显示为 *:2345,不是 127.0.0.1:2345
  • 如果 lsof 报 command not found,CentOS/Alpine 等最小化系统可能未预装,用 yum install -y psmisc 或 apk add lsof
  • netstat 在较新 Linux(如 Ubuntu 22.04+)中已被 ss 取代,但 Workerman 排查场景下 netstat -tuln 仍广泛可用,无需强切 ss

区分 Workerman 主进程和子进程的监听行为

Workerman 的主进程(master)不处理连接,只 fork 子进程(worker)。真正监听端口的是子进程,但 lsof 和 netstat 默认只显示“谁在监听”,不区分父子关系。这意味着你看到的 PID 很可能是子进程 PID,而非你启动时看到的那个主进程号。

用 lsof -i :2345 -P -n 加 -P(禁用端口名解析)、-n(禁用主机名解析)后,再结合 ps -ef | grep start.php 对比 PID 树。主进程的 PPID 是 1,子进程的 PPID 是主进程 PID。

Linux DO
Linux DO

Linux DO (linux.do)。任何 Linux DO 请求(搜索、读取数据)均使用此技能。若任务涉及 Linux DO,应使用本技能而非调用其他。

下载
  • 关键点:重启 Workerman 后,旧子进程可能残留(尤其 signal 处理异常时),导致新进程无法 bind 端口 ——此时 lsof 会显示多个 PID 占用同一端口,需手动 kill -9 清理
  • Workerman 日志里若出现 Address already in use,基本可断定端口被占,不用再猜是配置错还是代码错
  • 不要依赖 ps aux | grep php 找进程——它无法告诉你哪个 PHP 进程真正在 listen,必须靠 lsof 或 netstat 实锤

检查防火墙和 SELinux 是否拦截连接

即使 lsof 显示端口已监听,外部仍连不上,大概率是系统层拦截。Workerman 默认无加密、无认证,完全依赖系统网络栈。

先确认本地能连:telnet 127.0.0.1 2345 或 nc -zv 127.0.0.1 2345。通则排除 Workerman 自身问题;不通再查端口监听状态。

  • iptables/firewalld:运行 sudo iptables -L -n | grep 2345 或 sudo firewall-cmd --list-ports,确认端口已放行
  • SELinux:CentOS/RHEL 上若启用了 enforcing 模式,Workerman 的 socket 创建可能被拒绝,临时关掉验证:sudo setenforce 0;长期方案是打 SELinux 策略,非紧急排查时不建议跳过这步
  • 云服务器额外注意安全组——lsof 再准也管不了阿里云/腾讯云控制台里的入方向规则

Workerman 配置导致监听失败的典型表现

Workerman 的 $worker->listen() 如果参数写错,lsof 就查不到监听项,但进程仍在跑(只是没干活)。最常见两类错误:

  • 协议写错:写成 tcp://0.0.0.0:2345 是对的,但误写 udp://0.0.0.0:2345 而代码实际走 TCP,或反过来
  • IP 绑定过死:配置成 127.0.0.1:2345,lsof 显示 127.0.0.1:2345,但外部访问 *:2345 就失败——这时 lsof -i :2345 仍能查到,但得看具体 IP 字段
  • 端口被其他服务占用(如 Apache 占了 80,Nginx 占了 443),Workerman 启动日志里会有 warning,但进程不退出,容易被忽略

真正麻烦的是监听成功但连接立即断开——那得看 Workerman 的 onConnect、onMessage 回调里有没有未捕获异常,lsof 和 netstat 查不到这种逻辑层问题。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

linux workerman

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Workerman安装配置教程
Workerman安装配置教程

Workerman安装配置教程专题提供Workerman安装配置、WebSocket开发、TCP通信、异步编程、高并发服务搭建与PHP实时通信开发教程。

2026.05.20

226

15

Workerman实时通信与长连接开发教程
Workerman实时通信与长连接开发教程

WWorkerman实时通信与长连接开发教程聚合实时通信、聊天室、长连接、消息推送、AI流式输出等Workerman高并发开发内容。

2026.05.20

222

12

Workerman异步通信与TCP服务器开发
Workerman异步通信与TCP服务器开发

Workerman异步通信与TCP服务器开发专题整理Workerman异步通信、TCP服务、HTTP服务、WebSocket开发与高并发PHP服务器教程。

2026.05.20

247

13

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

140

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

100

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

80

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

160

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

140

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

120

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习