ASP.NET Core SignalR 支持子域名访问的配置问题咨询

你遇到的两个报错分别对应两类问题：

1. System.Net.Http.HttpRequestException: The Host is unknown 是系统无法解析a.localhost这类子域名，默认操作系统不会自动将localhost的子域名指向127.0.0.1
2. Postman请求返回404+Connection ID required属于SignalR的正常响应：SignalR hub遵循专门的协商连接协议，直接发起GET请求未携带协商参数就会返回该提示，不是接口失效的证明

1. 域名解析配置 #

编辑本地hosts文件手动绑定子域名：

• Windows系统路径：C:\Windows\System32\drivers\etc\hosts
• macOS/Linux系统路径：/etc/hosts

添加以下内容（可根据测试需求替换为a.localhost等自定义子域名）：

127.0.0.1 a.domain.com
127.0.0.1 b.domain.com

保存后执行DNS缓存刷新命令生效：

• Windows：ipconfig /flushdns
• macOS：sudo dscacheutil -flushcache

2. 应用监听配置 #

控制台直接运行场景 #

在Program.cs中配置监听所有主机头的请求：

var builder = WebApplication.CreateBuilder(args);
// 其他服务注册逻辑...
builder.WebHost.UseUrls("http://*:5000"); // 端口替换为你实际使用的端口，*表示接收任意域名的请求

IIS Express调试场景 #

修改项目根目录下Properties/launchSettings.json的iisSettings配置：

"iisSettings": {
  "windowsAuthentication": false,
  "anonymousAuthentication": true,
  "iisExpress": {
    "applicationUrl": "http://*:你的实际端口/",
    "sslPort": 0
  }
}

修改后重启IIS Express即可接收所有子域名的请求。

不需要给SignalR做单独的子域名适配，仅需调整Ingress规则：

• 将*.domain.com或者你指定的a.domain.com、b.domain.com的路由规则指向承载SignalR的ASP.NET Core应用Service即可
• 应用保持默认监听0.0.0.0对应端口的配置即可，无需绑定特定域名

如果你的应用开启了主机校验或者跨域限制，需要补充以下配置：

允许子域名主机访问 #

builder.Services.Configure<HostOptions>(options =>
{
    options.AllowedHosts = new[] { "*.domain.com" };
});

跨域配置（前端和接口域名不同时需要） #

builder.Services.AddCors(options =>
{
    options.AddPolicy("AllowSubDomainClients", policy =>
    {
        policy.WithOrigins("http://a.domain.com", "http://b.domain.com")
              .AllowAnyHeader()
              .AllowAnyMethod()
              .AllowCredentials(); // SignalR要求必须开启凭据支持
    });
});

// 中间件配置顺序要正确，CORS要放在SignalR之前
var app = builder.Build();
app.UseCors("AllowSubDomainClients");
app.MapHub<ProcessHub>("/ProcessHub");
// 其他中间件配置...

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