如何通过 NetworkInterface.GetAllNetworkInterfaces() 精准获取本机局域网 IP 地址
在 C# 开发中，准确获取本机局域网 IP 地址是一项常见需求。最可靠的方法是调用 NetworkInterface.GetAllNetworkInterfaces() 方法，遍历所有网络接口。我们需要筛选出状态为启用（OperationalStatus.Up）且类型为有线以太网（Ethernet）或无线局域网（Wireless80211）的物理网卡。随后，从这些网卡中提取 IPv4 单播地址，并使用一个私有地址判断函数（IsIPv4Private）来验证其是否属于标准的私有 IP 地址段，即 10.0.0.0/8、172.16.0.0/12 或 192.168.0.0/16。这种方法能有效排除虚拟网卡和无效连接。
使用 Dns.GetHostAddresses 获取本机 IP 的注意事项与局限
许多开发者会尝试使用 Dns.GetHostAddresses(Dns.GetHostName()) 来获取本机 IP。这个方法看似直接，但存在一个典型陷阱：它很可能返回 127.0.0.1 这样的回环地址或 IPv6 地址，而这些并非我们需要的局域网 IP。正确的实践应分为两步：首先获取本机所有 IP 地址列表，然后进行精细过滤。过滤条件包括：协议为 IPv4（AddressFamily.InterNetwork）、非回环地址、非未指定地址（0.0.0.0），并且最终落在上述三大私有地址段内。
这三个私有地址段是局域网通信的基础：10.0.0.0/8、172.16.0.0/12、192.168.0.0/16。为确保获取成功，请注意以下要点：
- 避免过度依赖主机名解析，因为系统 hosts 文件或 DNS 配置可能将其指向本地回环地址。
- 相比之下，
NetworkInterface.GetAllNetworkInterfaces()方法更为可靠，它能明确区分物理网卡、虚拟网卡以及已禁用的网络接口。 - 在筛选时，务必检查网卡的运行状态（
OperationalStatus.Up）和类型，优先选择Ethernet或Wireless80211，并主动排除回环接口（Loopback）、隧道接口（Tunnel）等不承载真实局域网流量的类型。
详解使用 NetworkInterface 枚举适配器并提取有效 IPv4 地址
这是目前最推荐、控制粒度最细的 C# 获取本机 IP 方案。其核心流程是遍历所有网络适配器，逐一检查其单播地址集合（UnicastAddresses），并提取出符合条件的 IPv4 地址。
整个流程包含几个不可或缺的关键判断步骤：
- 首先，适配器的运行状态必须为
OperationalStatus.Up，确保其为活动连接。 - 其次，适配器类型需排除
Loopback、Tunnel、Ppp等通常不用于局域网通信的类型。 - 对于每个 IP 地址，需满足两个条件：地址族为
AddressFamily.InterNetwork（即 IPv4），并且通过自定义的IsIPv4Private(address)函数验证为私有地址。 - 需要特别注意，虚拟机（如 VMware、VirtualBox）、容器（如 Docker）或 WSL2 创建的虚拟网卡也会分配私有 IP。是否排除它们取决于具体应用场景——若只需物理网卡地址，则需进行额外过滤。
以下是一个高效的判断 IPv4 地址是否为私有地址的 C# 函数示例：
static bool IsIPv4Private(IPAddress addr)
{
var bytes = addr.GetAddressBytes();
return bytes[0] == 10 ||
(bytes[0] == 172 && bytes[1] >= 16 && bytes[1] <= 31) ||
(bytes[0] == 192 && bytes[1] == 168);
}
排查 GetAllNetworkInterfaces() 返回空 IP 列表的常见原因
有时即使代码正确，也可能无法获取到任何 IP 地址。这通常不是代码逻辑问题，而是由运行环境或系统状态导致的：
- 在 .NET Core / .NET 5+ 跨平台环境下，于 Linux 或 macOS 上运行时，需确保进程有权限读取网络接口信息。在 Docker 容器内运行时，若未使用
--network host模式或未挂载必要的系统目录（如/sys/class/net），也可能导致无法获取信息。 - 在 Windows 系统上，如果“网络连接”服务（Network Connections service）未启动或被禁用，
NetworkInterfaceAPI 可能无法枚举到真实的网络适配器。 - 某些精简版或嵌入式操作系统（如 Windows Nano Server、IoT Core）可能未提供完整的网络接口 API 支持，调用后会返回空数组。
- 对于 WSL2 用户，其默认使用虚拟 NAT 网络。在 Windows 宿主机上看到的
vEthernet (WSL)适配器 IP 是内部网络地址，并非宿主机的物理网卡 IP，需要注意区分。
生产环境下的 IP 地址选择策略与最佳实践
在生产环境中，一台机器往往拥有多个有效的局域网 IP（例如同时连接有线网络和 Wi-Fi）。此时，简单地选取返回列表中的第一个 IP 是极不可靠的。
- 优先级策略：一个通用的经验是，有线网络（Ethernet）的优先级通常高于无线网络（Wi-Fi），再高于其他类型。可以通过检查
NetworkInterfaceType和Description属性（可能包含 “Ethernet”、“Realtek”、“Intel”、“Wi-Fi” 等关键词）来辅助决策。 - 服务绑定场景：如果需要绑定 IP 地址进行监听（例如使用
HttpListener或 Kestrel 服务器），强烈建议使用IPAddress.Any（0.0.0.0）来绑定所有可用接口，而非绑定到某个具体 IP，这样可以避免因特定网卡故障而导致服务不可用。 - 对外提供 IP 地址：如果必须选出一个“代表本机”的 IP 地址返回给外部调用方（例如在微服务注册或 API 响应中），务必记录详细的日志，并设计健壮的回退（fallback）机制。例如，当无法找到合适 IP 时，应返回 null 或抛出明确的异常，而不是错误地返回
127.0.0.1。
总而言之，获取 IP 地址本身的技术实现并不复杂。真正的难点在于获取之后如何根据复杂的网络拓扑和防火墙规则来正确解释和使用它。一个在服务器端可用的 IP，对客户端而言未必可达，这一点在分布式系统设计中至关重要，也是最容易被忽视的关键细节。
