Swoole Server 无法直接监听多网卡，本质是操作系统不支持单 socket 绑定多个 IP；正确做法是对每块网卡的独立 IP（如 192.168.1.10、10.0.0.5）分别调用 addlistener()，且必须在 start() 前完成并检查返回值。
一个 Swoole Server 实例无法直接“绑定多个网卡”来监听同一端口，但可以通过监听不同 IP 地址实现等效效果——关键不是网卡，而是 IP。
为什么不能直接“监听多网卡”
Swoole 的 listen() 或 addlistener() 接收的是 IP 地址 + 端口组合，底层调用的是 bind(2)。操作系统不支持“一个 socket 同时 bind 多个 IP”，所以不存在“监听 eth0 和 eth1”的 API。所谓“多网卡监听”，本质是：为每个网卡配置的 IP（如 192.168.1.10、10.0.0.5）分别调用一次 addlistener()。
- 错误认知：“让一个端口在所有网卡上生效” → 应该用
0.0.0.0（IPv4 所有地址）或::（IPv6 所有地址） - 真实需求：“只允许内网访问管理端口，外网访问业务端口” → 分别监听
192.168.1.10:9502和203.203.203.203:9501 - 混淆风险：把
127.0.0.1和0.0.0.0当作“同一网卡的不同模式”，其实它们是完全不同的地址族行为
如何正确监听多个网卡 IP
每块网卡若有独立 IPv4 地址（如 enp0s3→192.168.1.10，enp0s8→10.0.0.5），就为每个 IP 单独添加一个监听端口：
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
- 必须在
$server->start()之前完成所有addlistener()调用 - 每次调用返回值必须检查：
if (!$server->addlistener('192.168.1.10', 9501, SWOOLE_SOCK_TCP)) { throw new RuntimeException('bind 192.168.1.10:9501 failed'); } - 监听相同端口号（如都用
9501）是允许的，只要 IP 不同；但127.0.0.1:9501和0.0.0.0:9501会冲突（后者已覆盖前者） - IPv6 需显式使用
SWOOLE_SOCK_IPV6标志，例如：$server->addlistener('::1', 9501, SWOOLE_SOCK_TCP | SWOOLE_SOCK_IPV6)
常见失败现象与排查点
现象：只看到主端口（第一个 addlistener）生效，其他端口 telnet 不通、netstat -tuln 里看不到对应条目。
- 静默失败：
addlistener()返回false但没判断 → 必须检查返回值 - IP 不存在：运行
ip addr确认目标 IP 确实已配置在某张网卡上，而非仅存在于路由表 - 防火墙拦截：Linux 的
iptables/nftables或云厂商安全组可能放行了0.0.0.0却未放行具体网卡 IP - SELinux 限制（CentOS/RHEL）：
setsebool -P httpd_can_network_bind 1可能影响非标准端口绑定 - 端口已被占用：即使 IP 不同，若另一进程已用
0.0.0.0:9501监听，192.168.1.10:9501仍会 bind 失败（因0.0.0.0是通配）
connection_info 中的 from_port 不可靠？
当监听多个 IP + 相同端口（如 192.168.1.10:9501 和 10.0.0.5:9501）时，$serv->connection_info($fd)['from_port'] 始终返回 9501，无法区分来源网卡 —— 这是正常行为，因为端口相同。
- 真正可区分的是
from_fd字段：它对应监听该连接的swoole_server_port对象索引（从 0 开始） - 更稳妥做法：在每个 port 上单独注册
on('receive')回调，避免混用主回调 +connection_info判定 - 示例：
$port1 = $server->addlistener('192.168.1.10', 9501, SWOOLE_SOCK_TCP); $port1->on('receive', fn() => echo "from intranet");
最易被忽略的一点：监听多个具体 IP 时，你实际放弃了“自动适配新网卡”的能力；一旦新增网卡并配置 IP，必须手动更新代码并重启服务。用 0.0.0.0 虽不够精细，但在动态环境里反而更鲁棒。
