Fastify 监听所有网络接口的地址获取问题解析

在 Fastify 框架中，当开发者使用 0.0.0.0 作为监听地址时，调用 addresses() 方法只会返回 0.0.0.0 这个地址，而不会列出所有实际可用的网络接口地址。这个问题在开发过程中可能会给开发者带来一些困扰。

问题背景

Fastify 的 listen() 方法支持传入 host 参数来指定监听地址。当设置为 0.0.0.0 时，表示监听所有 IPv4 网络接口。然而，调用 addresses() 方法时，返回的结果仅包含 0.0.0.0 地址，而不是所有具体可用的网络接口地址。

解决方案

开发者可以通过结合 Node.js 的 os 模块来获取所有网络接口地址。以下是一个实用的解决方案：

const os = require('os');

let addresses = app.addresses();
if (addresses[0].address === '0.0.0.0' || addresses[0].address === '::') {
  addresses = Object.values(os.networkInterfaces())
    .flat()
    .filter(({ family }) => addresses.map(({ family }) => family).includes(family))
    .map(({ address, family }) => ({ 
      address, 
      family, 
      port: app.server.address().port 
    }))
    .sort((a, b) => a.address.localeCompare(b.address));
}

IPv6 注意事项

对于 IPv6 网络，对应的通配地址是 ::。Fastify 会分别处理 IPv4 和 IPv6 的监听地址，不会自动合并两者。如果需要同时监听 IPv4 和 IPv6 的所有接口，需要分别指定 0.0.0.0 和 :: 作为监听地址。

最佳实践

1. 明确指定需要监听的地址类型（IPv4 或 IPv6）
2. 使用上述代码片段获取所有实际可用的网络接口地址
3. 在生产环境中，建议明确指定需要监听的特定地址，而不是使用通配地址

通过这种方式，开发者可以更全面地了解 Fastify 服务实际监听的网络接口情况，便于调试和监控。