ASP.NET Core 3.0 API如何获取客户端真实IP？返回::1问题求助

首先，你看到的::1是IPv6格式的本地回环地址，说明当前请求要么是从本地发起（比如你在本地调试用浏览器/Postman直接访问），要么是你的API没有正确处理经过代理/负载均衡的请求头，导致无法读取真实客户端IP。下面分情况给你解决方案：

1. 本地调试时的正常情况 #

如果是在本地开发环境（用IIS Express或Kestrel直接运行），请求来自本机，返回::1或者127.0.0.1是完全正常的。如果想模拟真实客户端IP，可以在请求里手动添加X-Forwarded-For头（比如用Postman的Headers选项添加X-Forwarded-For: 192.168.1.100），再测试接口。

2. 部署到服务器/有代理时的配置 #

如果你的API前面有Nginx、Apache或者云服务商的负载均衡（比如Azure App Service、AWS ELB），真实客户端IP会被放在X-Forwarded-For请求头里，ASP.NET Core默认不会自动读取这些头，需要配置Forwarded Headers中间件来处理：

步骤1：配置ForwardedHeadersOptions #

在Startup.cs的ConfigureServices方法里添加以下配置：

services.Configure<ForwardedHeadersOptions>(options =>
{
    // 启用读取X-Forwarded-For（客户端IP）和X-Forwarded-Proto（协议http/https）
    options.ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto;
    
    // 添加允许的代理IP（本地调试可以添加回环地址，生产环境替换成你的代理服务器IP）
    options.KnownProxies.Add(IPAddress.Parse("127.0.0.1"));
    options.KnownProxies.Add(IPAddress.IPv6Loopback);
    
    // 如果是云服务，可能需要用KnownNetworks来指定代理的IP段，比如：
    // options.KnownNetworks.Add(new IPNetwork(IPAddress.Parse("10.0.0.0"), 8));
});

步骤2：启用Forwarded Headers中间件（注意顺序！） #

在Startup.cs的Configure方法里，必须在UseRouting之前调用UseForwardedHeaders()：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 其他中间件（比如UseExceptionHandler）...
    
    // 先启用Forwarded Headers
    app.UseForwardedHeaders();
    
    app.UseRouting();
    
    // 后续中间件（UseAuthorization、UseEndpoints）...
}

3. 更可靠的IP获取方法 #

其实你不需要依赖IActionContextAccessor，Controller本身就可以直接访问HttpContext，而且建议处理IPv6转IPv4、多代理场景下的X-Forwarded-For解析：

在你的IndexController里添加一个辅助方法：

private string GetRealClientIp()
{
    var remoteIp = HttpContext.Connection.RemoteIpAddress;
    
    // 如果是IPv6映射的IPv4地址，转成IPv4格式
    if (remoteIp != null && remoteIp.IsIPv4MappedToIPv6)
    {
        remoteIp = remoteIp.MapToIPv4();
    }
    
    // 读取X-Forwarded-For头，这个头里会包含真实客户端IP（当有代理时）
    var forwardedForHeader = HttpContext.Request.Headers["X-Forwarded-For"].FirstOrDefault();
    if (!string.IsNullOrWhiteSpace(forwardedForHeader))
    {
        // X-Forwarded-For可能包含多个IP（格式：客户端IP, 代理1IP, 代理2IP...），取第一个即可
        var ipParts = forwardedForHeader.Split(',', StringSplitOptions.RemoveEmptyEntries);
        if (ipParts.Length > 0 && IPAddress.TryParse(ipParts[0].Trim(), out var realIp))
        {
            remoteIp = realIp;
        }
    }
    
    return remoteIp?.ToString() ?? "Unknown";
}

然后修改你的接口：

[HttpGet()]
[Route("[action]")]
public string GetIPAddress(string id)
{
    return GetRealClientIp();
}

生产环境注意事项 #

• 不要在生产环境随意添加KnownProxies或KnownNetworks，只添加你信任的代理服务器IP/网段，防止恶意请求伪造X-Forwarded-For头欺骗你的API。
• 如果是部署到云平台，很多服务商已经自动配置了Forwarded Headers，比如Azure App Service会自动设置相关头，你只需要确保中间件启用即可。

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