WPF集成ASP.NET Core Web API用IPAddress.Any监听外网连接被拒问题

核心问题点 #

• 配置优先级冲突：Host.CreateDefaultBuilder默认会按优先级加载多层配置（命令行参数 > 环境变量 > appsettings.json > 代码内UseUrls配置），你写在代码里的监听地址很可能被其他配置源覆盖，实际服务只绑定在127.0.0.1回环地址上，外部访问自然会被主动拒绝。另外直接插值IPAddress.Any的写法兼容性不足，Kestrel原生支持多网卡适配的配置方式，不需要手动指定0.0.0.0。
• 冗余配置干扰：默认WebHost构建逻辑会自动加载IIS集成模块，WPF桌面场景下没有IIS托管环境，这部分配置可能干扰端口绑定逻辑。
• 系统防火墙拦截：当服务绑定到非回环地址时，Windows Defender防火墙默认会阻止外部来源的TCP入站连接，这是非代码层面最常见的连接拒绝原因。
• 控制器配置缺失：当前HomeController没有标记[ApiController]特性，部分路由场景下会出现请求匹配失败的问题。另外你定义的delReceiveWebRequest委托是给原生HttpListener用的，ASP.NET Core的Kestrel服务器不依赖这个组件，可以直接删除。

代码修改方案 #

直接替换WebAPI启动逻辑，显式配置Kestrel服务器，把监听配置的优先级提到最高，避免被默认配置覆盖：

internal class WebAPI
{
    private static IHost _host;
    public static async Task StartAsync()
    {
        _host = Host.CreateDefaultBuilder()
            .ConfigureAppConfiguration((context, config) =>
            {
                // 清空默认配置源，避免其他位置的urls配置覆盖监听地址
                config.Sources.Clear();
                config.AddJsonFile("appsettings.json", optional: true, reloadOnChange: true);
                config.AddEnvironmentVariables();
            })
            .ConfigureWebHostDefaults(webHostBuilder =>
            {
                webHostBuilder.UseStartup<Startup>();
                // 显式配置Kestrel，优先级高于所有其他配置
                webHostBuilder.ConfigureKestrel(serverOptions =>
                {
                    // 监听所有网卡的20002端口，同时兼容IPv4/IPv6
                    serverOptions.ListenAnyIP(20002);
                });
                // 禁用IIS集成，适配桌面无IIS场景
                webHostBuilder.UseSetting(WebHostDefaults.IISIntegrationSettingKey, "false");
                webHostBuilder.UseSetting(WebHostDefaults.PreventHostingStartupKey, "true");
            })
            // 关闭控制台生命周期绑定，适配WPF桌面应用
            .UseConsoleLifetime(options => options.SuppressStatusMessages = true)
            .Build();

        await _host.StartAsync();
    }

    public static async Task StopAsync()
    {
        if (_host == null) return;
        await _host.StopAsync();
        _host.Dispose();
    }
}

给HomeController补上必要的特性，保证路由正常匹配：

[ApiController]
public class HomeController : ControllerBase
{
    [HttpGet("/api/command/")]
    public string Get() => "Hello World";
}

注意启动WebAPI时不要用同步的Start()方法，WPF主线程上同步等待容易造成死锁，在WPF的启动事件里用await WebAPI.StartAsync()调用即可。

可移植性优化（减少用户手动配置） #

你提到端口转发是用户必须完成的配置项，防火墙规则可以通过代码自动完成，不需要用户手动操作：

• 程序第一次启动时，自动检测20002端口的入站规则是否存在，不存在则调用系统命令添加规则，命令如下：

  netsh advfirewall firewall add rule name="Game RCON WebAPI" dir=in action=allow protocol=TCP localport=20002
  

• 该操作只需要一次性管理员权限，授权后规则永久生效，后续启动不需要重复提权。如果不想触发提权提示，也可以在端口转发配置说明里提示用户将转发目标地址设为127.0.0.1:20002，此时服务只绑定回环地址，不需要配置防火墙规则，缺点是局域网内其他设备无法直接访问接口，只能通过本机端口转发访问。

验证方法 #

启动程序后执行命令netstat -ano | findstr 20002，如果输出中存在0.0.0.0:20002或[::]:20002的LISTENING记录，说明端口绑定成功，此时同局域网下的设备访问http://<本机局域网IP>:20002/api/command/即可正常得到响应。

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