如何修改作为Windows服务托管的Blazor Server应用的URL

一、修改Blazor Server应用配置，支持子路径与外部绑定 #

1. 设置路径基址（PathBase） #

在Program.cs中添加UsePathBase中间件，确保放在路由配置之前：

var builder = WebApplication.CreateBuilder(args);

// 保留原有服务配置代码

var app = builder.Build();

// 配置应用的子路径前缀
app.UsePathBase("/myapp");

// 保留原有中间件（UseStaticFiles、UseRouting等）配置

app.UseEndpoints(endpoints =>
{
    endpoints.MapBlazorHub();
    endpoints.MapFallbackToPage("/_Host");
});

app.Run();

2. 配置Kestrel绑定外部可访问地址 #

修改appsettings.Production.json（或appsettings.json），添加Kestrel端点配置，允许绑定到服务器所有网卡：

{
  "AllowedHosts": "*",
  "Kestrel": {
    "Endpoints": {
      "Http": {
        "Url": "http://0.0.0.0:5000"
      }
    }
  }
}

也可以通过启动参数临时覆盖配置（后续Windows服务配置会用到）：

dotnet YourBlazorApp.dll --urls "http://0.0.0.0:5000"

3. 适配应用内路由与资源 #

• 页面@page指令无需额外修改，PathBase会自动作为路由前缀
• 静态资源（CSS、JS）使用相对路径或@Url.Content("~/")生成，避免硬写绝对路径
• 确保_Host.cshtml中的Blazor脚本引用正确：

<script src="_framework/blazor.server.js"></script>

二、更新Windows服务启动配置 #

如果服务是通过sc create命令创建的，按以下步骤修改：

1. 停止当前服务：

sc stop YourBlazorServiceName

2. 更新服务启动命令，指定应用路径与启动参数：

sc config YourBlazorServiceName binPath= "\"C:\Publish\Path\dotnet.exe\" \"C:\Publish\Path\YourBlazorApp.dll\" --urls \"http://0.0.0.0:5000\""

注意：binPath=后的空格必须保留，路径引号需用\"转义。

3. 重启服务：

sc start YourBlazorServiceName

三、配置Windows防火墙允许外部访问 #

1. 打开Windows Defender防火墙→「高级设置」
2. 创建新入站规则：
   • 规则类型选「端口」，协议选「TCP」，指定端口5000
   • 选择「允许连接」，应用域根据网络环境勾选「域、专用、公网」
   • 命名规则（如「Blazor Server 5000端口」）

四、配置域名解析与反向代理（实现http://example.com/myapp） #

推荐用IIS做反向代理，适配Windows生产环境：

1. 安装IIS模块 #

• 安装「Application Request Routing (ARR)」和「URL Rewrite」模块
• 打开IIS管理器→服务器节点→「Application Request Routing Cache」，勾选「Enable proxy」启用代理

2. 创建IIS应用程序 #

• 找到绑定example.com的站点，右键→「添加应用程序」：
  • 别名填myapp，物理路径可指定空目录（反向代理无需物理文件）
  • 应用程序池选择无托管代码的池（或新建.NET Core适配池）

3. 配置反向代理规则 #

• 进入myapp应用程序→「URL Rewrite」→「添加规则」→「反向代理规则」
• 目标地址填写http://localhost:5000/myapp，按需勾选「启用SSL Offloading」
• 保存规则后，访问http://example.com/myapp即可验证效果

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