如何获取ASP.NET Web API实际监听的IP与端口（支持多部署场景）

问题根源 #

你之前的方法存在两个核心问题：

1. 用Dns.GetHostAddresses获取的是容器内部的私有IP（比如26.16.80.29），这个地址仅容器网络内部可见，外部无法直接访问
2. 用TcpListener临时创建的端口和Web API实际监听的5000/5001完全无关，属于无效端口

要实现本地/容器环境通用的可访问地址获取，需要结合ASP.NET Core内置特性和环境变量配置。

可行方案 #

方案1：结合内置服务地址特性+外部地址配置 #

利用ASP.NET Core的IServerAddressesFeature获取应用实际监听的内部地址，同时通过配置/环境变量支持外部可访问地址的手动指定（容器场景必备）。

代码实现（Program.cs）

var builder = WebApplication.CreateBuilder(args);

// 注册服务、配置中间件等常规操作
// ...

var app = builder.Build();

// 获取服务器实际绑定的监听地址
var serverAddresses = app.Services.GetRequiredService<IServerAddressesFeature>().Addresses;

// 优先从配置/环境变量读取外部可访问地址（容器运行时需传入）
var externalBaseUrl = builder.Configuration["ExternalBaseUrl"];

// 确定最终可访问地址
var accessibleUrl = string.IsNullOrEmpty(externalBaseUrl) 
    ? serverAddresses.FirstOrDefault() ?? "http://localhost:5000" 
    : externalBaseUrl;

// 解析IP和端口
var uri = new Uri(accessibleUrl);
var targetIp = uri.Host;
var targetPort = uri.Port;

// 执行存入数据库的逻辑
// SaveServiceAddressToDatabase(targetIp, targetPort);

// 启动应用
app.Run();

环境适配配置

• 本地开发（非容器）：无需额外配置，代码会自动读取Web API实际监听的地址（比如https://localhost:5001）
• Docker容器运行：启动容器时通过环境变量传入外部可访问地址：

  # 宿主机端口映射为8081:5001，传入宿主机IP和映射端口
  docker run -p 8080:5000 -p 8081:5001 -e ExternalBaseUrl=https://192.168.1.100:8081 your-api-image
  

  如果是Docker Compose：

  services:
    api-service:
      image: your-api-image
      ports:
        - "8080:5000"
        - "8081:5001"
      environment:
        # 本地测试用host.docker.internal访问宿主机，生产环境替换为实际公网/内网IP
        - ExternalBaseUrl=https://host.docker.internal:8081
  

方案2：自动识别容器环境（进阶） #

如果不想手动传入环境变量，可以通过检测容器特有的标识（比如环境变量DOCKER_CONTAINER）来自动适配，但这种方式依赖容器启动时的标识注入，可靠性略低于方案1。

示例代码片段

bool isDocker = !string.IsNullOrEmpty(builder.Configuration["DOCKER_CONTAINER"]);

if (isDocker)
{
    // 容器环境下，从环境变量读取宿主机IP和映射端口
    targetIp = builder.Configuration["HOST_IP"];
    targetPort = int.Parse(builder.Configuration["HOST_PORT_HTTPS"]);
}
else
{
    // 本地环境，直接用监听地址
    var uri = new Uri(serverAddresses.First());
    targetIp = uri.Host;
    targetPort = uri.Port;
}

关键说明 #

• 容器内无法直接获取宿主机的端口映射信息，必须通过环境变量传递外部可访问地址，这是Docker网络隔离特性决定的
• IServerAddressesFeature能准确获取Web API实际绑定的端口，避免了之前临时端口的错误
• 两种方案都支持本地/容器环境无缝切换，符合你的需求

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