ASP.NET Core 如何将Prometheus、健康检查、Swagger路由发布至8080端口？

核心逻辑 #

ASP.NET Core 默认会把所有映射的端点同时暴露在所有绑定的监听端口上，要实现「业务流量走默认80端口、指定运维类端点单独走8080端口」，本质是通过端口维度的路由匹配规则，把指定路径的访问权限和端口绑定，同时拦截这些路径从非目标端口的请求。 #

实现步骤 #

1. 先完成Kestrel的双端口基础绑定 #

首先必须让应用同时监听80和8080两个端口，这是后续路由匹配的基础，漏掉这一步所有路由规则都不会生效。
在Program.cs的主机构建阶段添加配置：

builder.WebHost.ConfigureKestrel(serverOptions =>
{
    // 保留80端口承载正常业务流量
    serverOptions.ListenAnyIP(80);
    // 新增8080端口用于承载运维类端点
    serverOptions.ListenAnyIP(8080);
});

2. 逐个为目标端点添加8080端口访问约束 #

利用ASP.NET Core 内置的HostAttribute元数据，给每个需要单独暴露的端点绑定端口限制，不需要写额外的全局拦截逻辑，性能和可靠性都和普通路由一致。注意提前引入Microsoft.AspNetCore.Hosting命名空间，否则会出现类型找不到的编译错误。

• Prometheus指标端点（/metrics）
  如果你使用prometheus-net.AspNetCore库暴露指标，不要把中间件直接挂载在全局管道，改成手动映射路由并加端口约束：

  // 仅允许来自*:8080的请求访问指标端点
  app.MapMetrics("/metrics")
      .WithMetadata(new HostAttribute("*:8080"));
  

• 健康检查端点（/health）
  映射健康检查路由时同样绑定端口限制：

  app.MapHealthChecks("/health")
      .WithMetadata(new HostAttribute("*:8080"));
  

• Swagger与OpenAPI元数据端点
  覆盖内嵌Swagger UI、JSON schema两类形式，给所有swagger相关路径加统一的端口约束：

  // 绑定OpenAPI JSON schema端点的端口限制
  app.MapSwagger()
      .WithMetadata(new HostAttribute("*:8080"));
  
  // 仅在8080端口的管道上挂载Swagger UI
  app.When(
      predicate: context => context.Connection.LocalPort == 8080,
      configure: swaggerApp =>
      {
          swaggerApp.UseSwaggerUI(options =>
          {
              options.SwaggerEndpoint("/swagger/v1/swagger.json", "接口文档v1");
          });
      });
  

常见踩坑点 #

• 不要在全局管道里写路径判断拦截80端口的请求，很容易和现有业务路由产生优先级冲突，用HostAttribute做端口绑定是路由层原生支持的能力，不会出现路由意外放行的问题。
• 如果应用部署在反向代理（Nginx、K8s Ingress、云负载均衡）后面，需要确保代理正确传递原始端口的转发头，并且ASP.NET Core 启用了转发头中间件，不然Kestrel 读取到的本地端口会是代理的内部端口，导致端口约束失效。
• 配置完成后一定要做双向验证：从80端口访问三个目标端点，应该返回404；从8080端口访问三个端点，应该正常返回对应内容，正常业务接口的访问不受影响。

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