ASP.NET Core中GetServerVariable("REMOTE_ADDR")始终返回null的问题排查

核心原因 #

GetServerVariable是IIS专属API，仅当ASP.NET Core应用以IIS托管模式运行时才能正常使用。如果你的应用直接运行Kestrel（比如控制台启动、Docker部署等），调用这个方法必然返回null——这是因为Kestrel本身不支持IIS服务器变量体系。

正确获取客户端IP的方式 #

1. 无反向代理场景（直接访问Kestrel） #

直接通过HttpContext.Connection.RemoteIpAddress读取客户端IP，这是Kestrel原生支持的方式：

app.MapGet("/MainPage/", async (HttpContext context) => {
    string? remoteIp = context.Connection.RemoteIpAddress?.ToString();
    Console.WriteLine(remoteIp);
    await context.Response.WriteAsync($"Your IP: {remoteIp}");
});

2. 反向代理/路由器端口转发场景（读取X-Forwarded-For） #

如果应用部署在反向代理或路由器端口转发之后，需要先配置ASP.NET Core信任代理来源，才能正确解析X-Forwarded-For头：

• 第一步：在Program.cs中添加代理信任配置

builder.Services.Configure<ForwardedHeadersOptions>(options =>
{
    options.ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto;
    // 添加信任的代理IP（比如你的路由器内网IP）
    options.KnownProxies.Add(IPAddress.Parse("192.168.1.1"));
    // 本地测试可添加环回地址
    options.KnownProxies.Add(IPAddress.Parse("127.0.0.1"));
    options.KnownProxies.Add(IPAddress.IPv6Loopback);
});

• 第二步：在中间件管道最前面启用转发头处理

app.UseForwardedHeaders();

• 第三步：获取真实IP
  此时context.Connection.RemoteIpAddress会自动解析X-Forwarded-For中的真实客户端IP，也可以手动读取请求头：

string? xForwardedFor = context.Request.Headers.XForwardedFor.ToString();
Console.WriteLine(xForwardedFor);

3. 关键注意事项 #

• 不要直接用X-Forwarded-For做安全校验，这个请求头可被伪造，必须通过KnownProxies或KnownNetworks限制信任来源。
• 本地测试时如果直接访问Kestrel，无需配置转发头，直接使用RemoteIpAddress即可。

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