如何从HttpContext中获取正确的IPv4地址？

核心原因说明 #

你获取到IPv6地址，大概率是因为服务器同时监听IPv4和IPv6端口，或者客户端通过IPv6网络连接，也可能是反向代理转发了IPv6地址。另外，纯IPv6地址无法直接转换为IPv4（如你提到的），必须从网络配置和代码解析两方面入手解决。

一、配置服务器强制监听IPv4 #

先确保你的ASP.NET应用服务器只绑定IPv4端口，拒绝IPv6连接：

IIS配置 #

• 打开IIS管理器，找到目标网站，右键点击「编辑绑定」
• 删除所有IPv6类型的绑定，只保留IPv4绑定（可以选择具体服务器IPv4，或0.0.0.0表示所有IPv4地址）

Kestrel（ASP.NET Core）配置 #

• 在appsettings.json中指定IPv4终结点：

"Urls": "http://0.0.0.0:5000;https://0.0.0.0:5001"

• 或者在Program.cs中强制绑定：

var builder = WebApplication.CreateBuilder(args);
builder.WebHost.UseUrls("http://0.0.0.0:5000", "https://0.0.0.0:5001");

二、正确解析反向代理转发的IPv4地址 #

如果你的应用部署在反向代理（如Nginx、Apache）之后，需要确保代理正确转发客户端IPv4，并且应用信任该代理：

1. 代理服务器配置（以Nginx为例）：
   在反向代理配置中添加：

   proxy_set_header X-Forwarded-For $remote_addr;
   proxy_set_header X-Forwarded-Proto $scheme;
   

2. ASP.NET Core应用配置：
   在Program.cs中启用转发头解析，并指定可信代理：

   var builder = WebApplication.CreateBuilder(args);
   // 配置信任反向代理的IP地址
   builder.Services.Configure<ForwardedHeadersOptions>(options =>
   {
       options.ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto;
       // 添加你的反向代理服务器IPv4到KnownProxies
       options.KnownProxies.Add(IPAddress.Parse("192.168.1.100"));
       // 或者信任整个内网网段
       options.KnownNetworks.Add(new IPNetwork(IPAddress.Parse("192.168.0.0"), 24));
   });
   
   var app = builder.Build();
   // 必须在其他中间件之前启用ForwardedHeaders
   app.UseForwardedHeaders();
   

三、代码层面的IPv4解析逻辑 #

写一个工具方法，优先从转发头中提取IPv4，再处理直接连接的IP，避免强行转换纯IPv6地址：

using System.Net;
using System.Net.Http.Headers;

public static class IpHelper
{
    public static string GetClientIPv4(HttpRequest request)
    {
        // 优先处理X-Forwarded-For头（反向代理场景）
        if (request.Headers.TryGetValue("X-Forwarded-For", out var forwardedValues))
        {
            var forwardedFor = forwardedValues.FirstOrDefault();
            if (!string.IsNullOrEmpty(forwardedFor))
            {
                // 拆分多层代理的地址列表，取第一个真实客户端IP
                var ipList = forwardedFor.Split(',', StringSplitOptions.RemoveEmptyEntries);
                foreach (var ipStr in ipList)
                {
                    var trimmedIp = ipStr.Trim();
                    if (IPAddress.TryParse(trimmedIp, out var ip) && ip.AddressFamily == AddressFamily.InterNetwork)
                    {
                        return ip.ToString();
                    }
                }
            }
        }

        // 处理直接连接的IP
        var remoteIp = request.RemoteIpAddress;
        if (remoteIp != null)
        {
            // 处理IPv4映射的IPv6地址（格式如::ffff:192.168.1.1）
            if (remoteIp.IsIPv4MappedToIPv6)
            {
                return remoteIp.MapToIPv4().ToString();
            }
            // 纯IPv4直接返回
            else if (remoteIp.AddressFamily == AddressFamily.InterNetwork)
            {
                return remoteIp.ToString();
            }
        }

        // 无有效IPv4地址返回null
        return null;
    }
}

关键注意事项 #

如果客户端本身使用的是IPv6网络（如原生IPv6环境），那么无法获取到IPv4地址，这种情况只能引导用户切换到IPv4网络，或者你的服务接受IPv6地址作为合法客户端标识。

内容的提问来源于stack exchange，提问作者Dan Gifford