.NET5 Blazor WASM PWA应用无法获取请求设备本地IP如何解决

• Blazor WASM 代码完全运行在用户浏览器沙箱内，受浏览器安全策略限制，前端侧无权限直接读取设备网卡的本地IP地址，也不存在公开合规的浏览器API支持直接获取该信息。
• 你之前获取到服务器IP，本质是把获取IP的逻辑错误放在了WASM客户端侧执行，或是服务端获取IP的逻辑未正确处理请求转发、未读取真实请求来源信息，最终拿到的是服务端自身地址而非请求端地址。

首先明确：客户端IP分两类，公网出口IP是设备访问公网服务时对外暴露的IP，可稳定获取；局域网私有IP（如192.168.1.xx、10.0.0.xx）是设备在内网的地址，受浏览器隐私保护限制，目前无法稳定获取。

方案1：获取客户端公网出口IP（生产可用，适配绝大多数场景） #

所有IP获取逻辑必须放在托管Blazor WASM的ASP.NET Core服务端实现，WASM侧仅需调用服务端接口拿结果即可，具体步骤：

1. 配置转发头中间件（适配反向代理/CDN/IIS部署场景，避免拿到代理节点IP）
   在.NET 5 服务端项目的Startup.ConfigureServices方法中添加配置：

services.Configure<ForwardedHeadersOptions>(options =>
{
    options.ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto;
    // 生产环境建议按需配置已知代理IP，测试环境可先清空默认规则避免拦截
    options.KnownNetworks.Clear();
    options.KnownProxies.Clear();
});

在Startup.Configure方法中，将转发头中间件放在所有其他中间件的最前面注册：

app.UseForwardedHeaders();

如果使用Nginx做反向代理，需要在Nginx配置中添加对应转发规则：

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

2. 编写供WASM调用的IP查询接口

[ApiController]
[Route("api/client")]
public class ClientController : ControllerBase
{
    [HttpGet("ip")]
    public IActionResult GetRequestIp()
    {
        var ipAddress = HttpContext.Connection.RemoteIpAddress;
        // 处理IPv4映射到IPv6格式的地址，统一返回标准IPv4格式
        if (ipAddress?.AddressFamily == System.Net.Sockets.AddressFamily.InterNetworkV6)
        {
            ipAddress = ipAddress.MapToIPv4();
        }
        return Ok(new { Ip = ipAddress?.ToString() });
    }
}

3. WASM侧调用接口获取IP
   在Blazor WASM页面中注入HttpClient，直接调用上述接口即可拿到当前请求设备的公网IP：

@inject HttpClient Http

<p>当前设备公网IP：@ClientIp</p>

@code{
    private string ClientIp { get; set; } = "获取中...";

    protected override async Task OnInitializedAsync()
    {
        var result = await Http.GetFromJsonAsync<ClientIpResult>("api/client/ip");
        ClientIp = result?.Ip ?? "获取失败";
    }

    public class ClientIpResult
    {
        public string Ip { get; set; }
    }
}

方案2：获取客户端局域网私有IP（不推荐，兼容性极差） #

早期浏览器可通过WebRTC的ICE候选信息泄露本地私有IP，目前Chrome、Edge、Firefox等主流浏览器新版本已默认启用mDNS匿名化处理，WebRTC返回的本地地址为随机生成的.local域名，无法拿到真实私有IP。该方案仅能在特定旧版本浏览器、关闭安全隐私配置的特殊场景下使用，不具备生产可用性，不建议投入开发。

• 不要在Blazor WASM项目中直接尝试注入HttpContext获取IP，WASM运行在客户端浏览器，不存在真实的服务端HttpContext对象，即便通过其他方式拿到模拟对象，也无法获取真实请求IP。
• 本地调试时用本机访问服务拿到127.0.0.1或::1属于正常现象，部署到公网服务器后，外网设备访问即可拿到对应公网出口IP。
• 如果服务端拿到的IP始终是网关/代理IP，优先检查反向代理是否正确配置X-Forwarded-For头转发，以及转发头中间件是否注册在所有中间件的最前端。

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