Blazor 发布到 Azure App Service 教程

Blazor应用部署到Azure App Service需区分Server与WebAssembly类型：Server需.NET运行时支持，WebAssembly可作静态网站部署；推荐VS一键发布或GitHub Actions自动部署，并注意WebSocket启用、base href配置及MIME类型问题。

Blazor 应用（尤其是 Blazor Server 或 Blazor WebAssembly）发布到 Azure App Service 是常见且成熟的部署方式。关键在于区分项目类型、正确配置发布管道、处理静态资源与后端依赖，并注意 Azure App Service 的运行环境限制。

确认 Blazor 类型再选部署策略

Blazor Server 和 Blazor WebAssembly 部署方式不同，不能混用：

• Blazor Server：需要 .NET 运行时支持，必须部署到支持 Windows/Linux 的 App Service（.NET Core/.NET 6+），选择“App Service (Windows)”或“App Service (Linux)”并指定对应 .NET 版本（如 .NET 8）。
• Blazor WebAssembly（独立模式）：本质是静态网站，可直接部署到 App Service（Windows/Linux）的静态文件托管路径（wwwroot），无需后端运行时；也可部署到 Azure Static Web Apps（更轻量、免费层友好）。

使用 Visual Studio 一键发布（推荐新手）

适合本地开发完成、快速验证场景：

• 右键项目 → “发布” → “Azure” → “Azure App Service” → 登录账号。
• 选择或新建资源组、App Service（建议选 Linux + .NET 8 Runtime，更稳定且成本低）。
• 发布前勾选“删除目标位置中不存在的文件”，避免旧文件残留干扰。
• 发布完成后，访问 https://your-app-name.azurewebsites.net 即可打开应用。

通过 GitHub Actions 自动部署（推荐生产环境）

实现代码 push 后自动构建、发布，提升可靠性与可追溯性：

标签： linux html 前端 git windows github nginx app websocket 后端 win