快速入门：部署 ASP.NET Web 应用

本快速入门介绍如何创建你的第一个 ASP.NET Web 应用并将其部署到 Azure 应用服务。 应用服务支持各种版本的 .NET 应用。 它提供高度可缩放的、可自我修补的 Web 托管服务。 ASP.NET Web 应用具有跨平台特性，可以在 Linux 或 Windows 上托管。 完成后，你会获得一个 Azure 资源组，其中包含一个应用服务托管计划，以及一个部署了 Web 应用程序的应用服务。

或者，可以将 ASP.NET Web 应用部署为应用服务中的 Windows 或 Linux 容器的一部分。

提示

在 Visual Studio、Visual Studio Code 和 Azure 门户步骤中查找 GitHub Copilot 提示。

先决条件

.NET 10

• 具有活动订阅的 Azure 帐户。 免费创建帐户。
• 具有 ASP.NET 和 Web 开发工作负载的 Visual Studio 2026。

.NET 框架 4.8

• 具有活动订阅的 Azure 帐户。 免费创建帐户。
• 具有 ASP.NET 和 Web 开发工作负载的 Visual Studio 2026。 确保选中可选复选框“.NET Framework 项目和项模板”。

如果已安装 Visual Studio 2026：

1. 通过选择“帮助”>“检查更新”，在 Visual Studio 中安装最新更新。
2. 通过选择“工具”>“获取工具和功能”，添加工作负荷。

• 具有活动订阅的 Azure 帐户。 免费创建帐户。
• Visual Studio Code。
• Azure 工具扩展。
• 最新的 .NET 10.0 SDK。

• 具有活动订阅的 Azure 帐户。 免费创建帐户。
• Azure CLI。
• 最新的 .NET 10.0 SDK。

• 具有活动订阅的 Azure 帐户。 免费创建帐户。
• Azure PowerShell。
• 最新的 .NET 10.0 SDK。

• 具有活动订阅的 Azure 帐户。 免费创建帐户。
• GitHub 帐户免费创建帐户。

跳到末尾

可以使用 Azure 开发人员 CLI 快速部署本教程中的 ASP.NET Core 示例应用，并查看它在 Azure 中运行。 只需在 Azure Cloud Shell 中运行以下命令，然后按照提示操作：

mkdir dotnetcore-quickstart
cd dotnetcore-quickstart
azd init --template https://github.com/Azure-Samples/quickstart-deploy-aspnet-core-app-service.git .
azd up

若要删除资源，请执行以下步骤：

azd down

创建 ASP.NET Web 应用

.NET 10

1. 打开 Visual Studio，然后选择“创建新项目”。

2. 在 “创建新项目”中，找到并选择 “Blazor Web App”，然后选择“ 下一步”。

3. 在“配置新项目”中，将应用程序命名为“MyFirstAzureWebApp”，然后选择“下一步”。

4. 选择 .NET 10.0（长期支持）。

5. 确保“身份验证类型”设置为“无身份验证”。 选择“创建”。

   

6. 在 Visual Studio 菜单中，选择“调试”“开始执行(不调试)”以在本地运行 Web 应用。> 如果看到要求信任自签名证书的对话框，请选择“ 是”。

   

.NET 框架 4.8

1. 打开 Visual Studio，然后选择“创建新项目”。

2. 在“创建新项目”中，找到并选择“ASP.NET Web 应用程序 (.NET Framework)”，然后选择“下一步”。

3. 在“配置新项目”中，将应用程序命名为“MyFirstAzureWebApp”，然后选择“创建”。

   

4. 选择 MVC 模板。

5. 确保“身份验证”设置为“不进行身份验证”。 选择“创建”。

   

6. 在 Visual Studio 菜单中，选择“调试”“开始执行(不调试)”以在本地运行 Web 应用。>

   

提示

如果你有 GitHub Copilot 帐户，请尝试获取适用于 Visual Studio 的 GitHub Copilot 功能。

1. 在计算机上打开终端窗口，进入工作目录。 使用 dotnet new webapp 命令创建新的 .NET Web 应用，然后将目录更改为新创建的应用。

   dotnet new blazor -n MyFirstAzureWebApp --framework net10.0
   cd MyFirstAzureWebApp
   

2. 在同一终端会话中，使用 dotnet run 命令在本地运行该应用程序。

   dotnet run --urls=https://localhost:5001/
   

3. 打开 Web 浏览器并导航到 https://localhost:5001 处的应用。

   你将看到页面中显示的模板 ASP.NET Core 10.0 Web 应用。

   

在此步骤中，你要创建演示项目的分支以进行部署。

.NET 10

1. 转到 .NET 10.0 示例应用。
2. 选择 GitHub 页面右上角的“创建分支”按钮。
3. 选择“所有者”并保留默认存储库名称。
4. 选择“创建分支”。

.NET 框架 4.8

1. 转到 .NET Framework 4.8 示例应用。
2. 选择 GitHub 页面右上角的“创建分支”按钮。
3. 选择“所有者”并保留默认存储库名称。
4. 选择“创建分支”。

发布 Web 应用

遵循以下步骤创建应用服务资源并发布项目：

1. 在“解决方案资源管理器”中右键单击“MyFirstAzureWebApp”项目，然后选择“发布”。

2. 在“发布”中，选择“Azure”，然后单击“下一步”。

   

3. 选择特定目标，即 Azure 应用服务 (Linux) 或 Azure 应用服务 (Windows)。 选择下一步。

   重要

   面向 ASP.NET Framework 4.8 时，请使用 Azure 应用服务 (Windows)。

4. 你的选项取决于你是否已登录 Azure 以及是否有一个链接到 Azure 帐户的 Visual Studio 帐户。 选择“添加帐户”或“登录”以登录 Azure 订阅。 如果你已经登录，请选择所需的帐户。

   

5. 选择“新建”。

   

6. 对于“订阅”，请接受列出的订阅，或从下拉列表中选择一个新订阅。

7. 对于“资源组”，选择“新建”。 在“新资源组名称”中，输入“myResourceGroup”并选择“确定”。

8. 对于托管计划，请选择新建。

9. 在“托管计划:新建”对话框中，输入下表中指定的值：

   设置	建议值	说明
   托管计划	MyFirstAzureWebAppPlan	应用服务计划的名称。
   位置	“西欧”	托管 Web 应用的数据中心。
   大小	选择最低层。	定价层定义托管功能。

10. 在“名称”中，输入唯一的应用名称。 仅包含字符 a-z、A-Z、0-9 和 -。 您可以接受自动生成的唯一名称。

11. 选择“创建”以创建 Azure 资源。

    

    该过程完成后，将为您创建 Azure 资源。 现已准备好发布 ASP.NET Core 项目。

12. 在“发布”对话框中，确保选中你的新的应用服务应用，然后选择“完成”，再选择“关闭”。 Visual Studio 为所选应用服务应用创建发布配置文件。

13. 在“发布”页中，选择“发布”。 如果看到警告消息时，请选择“继续”。

    Visual Studio 将生成、打包应用并将其发布到 Azure，然后在默认浏览器中启动该应用。

    .NET 10

    你将看到页面中显示的 ASP.NET Core 10.0 Web 应用。

    

    .NET 框架 4.8

    你会看到页面中显示的 ASP.NET Framework 4.8 Web 应用。

    

---

1. 从项目的根目录打开 Visual Studio Code。

   code .
   

2. 如果出现提示，请选择“是，我信任作者”。

   提示

   如果你有 GitHub Copilot 帐户，请尝试获取适用于 Visual Studio Code 的 GitHub Copilot 功能。

3. 在 Visual Studio Code 中，选择视图>命令面板打开命令面板。

4. 搜索并选择“Azure 应用服务: 新建 Web 应用(高级)”。

5. 响应提示，如下所述：

   1. 如果出现系统提示，请登录到你的 Azure 帐户。
   2. 选择订阅。
   3. 选择附近的位置。
   4. 选择 “安全唯一的默认主机名”。
   5. 选择“创建新的资源组”并提供一个名称，例如 myResourceGroup。
   6. 输入新 Web 应用的名称。
   7. 当系统提示选择运行时堆栈时，请选择 .NET 10 （LTS）。
   8. 选择操作系统（Windows 或 Linux）。
   9. 选择“创建新的应用服务计划”，提供一个名称，然后选择“免费 (F1)”定价层。
   10. 对于 Application Insights 资源，选择“暂时跳过”。

   等待 Visual Studio 完成 Azure 资源的创建。

6. 在 Visual Studio Code 中，再次选择 “查看>命令面板 ”。

7. 搜索并选择“Azure 应用服务: 部署到 Web 应用”。

   1. 选择“MyFirstAzureWebApp”作为要部署的文件夹。
   2. 在出现提示时选择“添加配置”。
   3. 选择订阅。
   4. 选择 Web 应用。
   5. 出现提示时，选择“部署”。

8. 在对话框“始终将工作区‘MyFirstAzureWebApp’部署到 <app-name>”中选择“是”，以便每次进入该工作区，Visual Studio Code 都会部署到相同的应用服务应用。

9. 发布完成后，选择通知中的“浏览网站”。

   你将看到页面中显示的 Blazor Web 应用。

   

1. 使用 az login 命令并按照提示登录到你的 Azure 帐户：

   az login
   

   • 如果无法识别 az 命令，请确保已按照先决条件中所述安装了 Azure CLI。

2. 使用 az webapp up 将代码部署到本地 MyFirstAzureWebApp 目录中：

   az webapp up --sku F1 --name <app-name> --os-type <os>
   

   • 将 <app-name> 替换为在整个 Azure 中均唯一的名称。 有效字符为 a-z、0-9 和 -。 一个好的做法是将公司名称和应用标识符结合使用。
   • --sku F1 参数在“免费”定价层上创建 Web 应用。 省略此参数可使用更快的高级层，这会按小时计费。
   • 用 <os> 或 linux 替换 windows。
   • 可以选择包含参数 --location <location-name>，其中 <location-name> 是可用的 Azure 区域。 若要获取 Azure 帐户允许的区域列表，请运行 az account list-locations 命令。

   命令可能需要几分钟时间才能完成。 当该命令运行时，它会提供有关以下操作的消息：创建资源组、应用服务计划和托管应用，配置日志记录，然后执行 ZIP 部署。 然后，它会显示一条消息，其中包含应用的 URL。

3. 打开 Web 浏览器并导航到 URL。 你将看到页面中显示的 ASP.NET Core 10.0 Web 应用。

   

注意

建议使用 Azure PowerShell 在 Windows 托管平台上创建应用。 若要在 Linux 上创建应用，请使用其他工具，例如 Azure CLI。

1. 使用 Connect-AzAccount 命令按照提示登录到你的 Azure 帐户：

   Connect-AzAccount
   

2. 使用 New-AzWebApp 命令创建新的应用：

   New-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -Location westeurope
   

   • 将 <app-name> 替换为在整个 Azure 中均唯一的名称。 有效字符为 a-z、0-9 和 -。 公司名称和应用标识符结合是个不错的模式。
   • 可选择包含参数 -Location <location-name>，其中 <location-name> 是可用的 Azure 区域。 若要获取 Azure 帐户允许的区域列表，请运行 Get-AzLocation 命令。

   命令可能需要几分钟时间才能完成。 该命令将创建资源组、应用服务计划和应用服务资源。

3. 从应用程序根文件夹运行 dotnet publish 命令，以准备本地 MyFirstAzureWebApp 应用程序进行部署：

   dotnet publish --configuration Release
   

4. 更改为发布目录，并根据内容创建一个 zip 文件：

   cd bin\Release\net10.0\publish
   Compress-Archive -Path * -DestinationPath deploy.zip
   

5. 使用 Publish-AzWebApp 命令将 zip 文件发布到 Azure 应用：

   Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force
   

   注意

   -ArchivePath 需要 zip 文件的完整路径。

6. 打开 Web 浏览器并导航到 URL。 你将看到页面中显示的 Blazor Web 应用。

   

1. 在 Azure 门户中，在搜索中键入 应用服务 。 在“服务”下选择“应用程序服务”。

   

2. 在“应用服务”页面中，请选择“创建”>“Web 应用”。

3. 在“基本信息”选项卡中：

   .NET 10

   • 在“资源组”下，选择“新建”。 输入myResourceGroup作为名称。
   • 在 名称下，输入你的网页应用名称。
   • 在“发布”下，选择“代码”。
   • 在“运行时堆栈”下，选择“.NET 8 (LTS)”。
   • 在“操作系统”下选择“Windows”。 如果选择“Linux”，则无法在下一步配置 GitHub 部署，但仍可在“部署中心”页中创建应用后执行此操作。
   • 选择要为应用提供服务的区域。
   • 在“应用服务计划”下，选择“新建”，然后输入 myAppServicePlan 作为名称。
   • 在“定价计划”下，选择“免费 F1”。

   

   .NET 框架 4.8

   • 在“资源组”下，选择“新建”。 输入myResourceGroup作为名称。
   • 在 名称下，输入你的网页应用名称。
   • 在“发布”下，选择“代码”。
   • 在“运行时堆栈”下，选择“ASP.NET V4.8”。
   • 依次选择“操作系统”以及你希望在其中提供应用的“区域”。
   • 在“应用服务计划”下，选择“新建”，然后输入 myAppServicePlan 作为名称。
   • 在“定价计划”下，选择“免费 F1”。

   

   注意

   在 Azure 门户中创建的新应用服务资源使用一个安全的唯一默认主机名，格式为 <AppName>-<Hash>.<Region>.azurewebsites.net。 该主机名是自动生成的，以帮助防止子域名被占领。 欲了解更多信息，请参阅 Azure 应用服务 中的防止子域名接管。

4. 选择页面顶部的“部署”选项卡

5. 在“GitHub Actions 设置”下，将“持续部署”设置为“启用”。

6. 在“GitHub Actions 详细信息”下，使用 GitHub 帐户进行身份验证，然后选择以下选项：

   .NET 10

   • 对于“组织”，请选择在其中创建了演示项目分支的组织。
   • 在存储库中，选择dotnetcore-docs-hello-world项目。
   • 对于“分支”，请选择“main”。

   

   .NET 框架 4.8

   • 对于“组织”，请选择在其中创建了演示项目分支的组织。
   • 对于“存储库”，请选择“app-service-web-dotnet-get-started”项目。
   • 对于“分支”，请选择“main”。

   

   注意

   默认情况下，资源创建过程会禁用基本身份验证。 它使用用户分配的标识创建 GitHub Actions 部署。 如果在创建资源期间出现权限错误，则表示你的 Azure 帐户可能没有足够的权限。 你可以稍后用 Azure 管理员为你生成的身份来配置 GitHub Actions 部署，或者启用基础认证。

7. 在页面底部选择“查看 + 创建”。

8. 运行验证之后，请选择页面底部的创建。

9. 在部署完成之后，选择“转到资源”。

   

10. 若要浏览到已创建的应用，请在“概述”页中选择默认域。 如果看到“你的 Web 应用正在运行，并在等待你的内容”消息，则表明 GitHub 部署仍在运行。 请等待几分钟，然后刷新页面。

    .NET 10

    

    .NET 框架 4.8

    

更新应用并重新部署

对默认页面做修改并重新部署以查看更改。

1. 在 解决方案资源管理器中，查找项目中的默认页面，并按如下所示替换内容：

   .NET 10

   在 Components/Pages/Home.razor 中，将所有内容替换为以下代码：

   @page "/"
   
   <PageTitle>Home</PageTitle>
   
   <h1>.NET 💜 Azure</h1>
   
   Example .NET app to Azure App Service.
   

   .NET 框架 4.8

   在 Views/Home/Index.cshtml 中，将第一个 <div> 元素替换为以下代码：

   <div class="jumbotron">
       <h1>.NET 💜 Azure</h1>
       <p class="lead">Example .NET app to Azure App Service.</p>
   </div>
   

   提示

   在 Visual Studio 中启用 GitHub Copilot 后，尝试执行以下步骤：

   1. 键入 Alt+/。
   2. 要求 Copilot“更改为显示‘.NET 💜 Azure’的启动卡。”

   保存所做更改。

2. 若要重新部署到 Azure，请在“解决方案资源管理器”中右键单击“MyFirstAzureWebApp”项目，然后选择“发布”。

3. 在发布摘要页中选择发布。

   发布完成后，Visual Studio 将启动浏览器并转到 Web 应用的 URL。

   .NET 10

   你将看到页面中显示的已更新的 ASP.NET Core 10.0 Web 应用。

   

   .NET 框架 4.8

   你会看到页面中显示的更新后的 ASP.NET Framework 4.8 Web 应用。

   

1. 在工作区中，找到 Components/Pages/Home.razor ，并将所有内容替换为以下代码：

   @page "/"
   
   <PageTitle>Home</PageTitle>
   
   <h1>.NET 💜 Azure</h1>
   
   Example .NET app to Azure App Service.
   

   提示

   使用 GitHub Copilot 尝试此方法：

   1. 选择内容，然后选择 。
   2. 选择“”并修改“”。
   3. 输入“更改为显示 .NET 💜 Azure 的启动卡。”

   保存所做更改。

2. 在 Visual Studio Code 中，再次选择 “查看>命令面板 ”。

3. 搜索并选择“Azure 应用服务: 部署到 Web 应用”。

4. 选择之前使用的订阅和 Web 应用。

5. 出现提示时，选择“部署”。

6. 发布完成后，选择通知中的“浏览网站”。

   你将看到页面中显示的已更新的 ASP.NET Core 10.0 Web 应用。

   

提示

若要了解带 GitHub Copilot 的 Visual Studio Code 如何帮助改善 Web 开发体验，请参阅 Visual Studio Code 步骤。

1. 在本地目录中，找到 Components/Pages/Home.razor ，并将所有内容替换为以下代码：

   @page "/"
   
   <PageTitle>Home</PageTitle>
   
   <h1>.NET 💜 Azure</h1>
   
   Example .NET app to Azure App Service.
   

2. 保存更改，然后再次使用 az webapp up 命令重新部署应用，并将 <os> 替换为 linux 或 windows。

   az webapp up --os-type <os>
   

   此命令使用本地缓存在 .azure/config 文件中的值，包括应用名称、资源组和应用服务计划。

3. 部署完成后，切换回在“浏览到应用”步骤中打开的浏览器窗口，并刷新页面。

   你将看到页面中显示的已更新的 ASP.NET Core 10.0 Web 应用。

   

1. 在本地目录中，打开 Components/Pages/Home.razor ，并将所有内容替换为以下代码：

   @page "/"
   
   <PageTitle>Home</PageTitle>
   
   <h1>.NET 💜 Azure</h1>
   
   Example .NET app to Azure App Service.
   

2. 从应用程序根文件夹中，使用 dotnet publish 命令准备本地 MyFirstAzureWebApp 应用程序进行部署：

   dotnet publish --configuration Release
   

3. 更改为发布目录，并根据内容创建一个 zip 文件：

   cd bin\Release\net10.0\publish
   Compress-Archive -Path * -DestinationPath deploy.zip -Force
   

4. 使用 Publish-AzWebApp 命令将 zip 文件发布到 Azure 应用：

   Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force
   

   注意

   -ArchivePath 需要 zip 文件的完整路径。

5. 部署完成后，切换回在“浏览到应用”步骤中打开的浏览器窗口，并刷新页面。

   你将看到页面中显示的已更新的 Blazor Web 应用。

   

1. 浏览到示例代码的 GitHub 分支。

2. 在存储库页面上，通过选择“代码”>“在 main 分支上创建 codespace”来创建 codespace。

   .NET 10

   

   .NET 框架 4.8

   

3. 在 解决方案资源管理器中，查找项目中的默认页面，并按如下所示替换内容：

   .NET 10

   在 Components/Pages/Home.razor 中，将所有内容替换为以下代码。 更改会自动保存。

   @page "/"
   
   <PageTitle>Home</PageTitle>
   
   <h1>.NET 💜 Azure</h1>
   
   Example .NET app to Azure App Service.
   

   .NET 框架 4.8

   在 Views/Home/Index.cshtml 中，将第一个 <div> 元素替换为以下代码。 更改会自动保存。

   <div class="jumbotron">
       <h1>.NET 💜 Azure</h1>
       <p class="lead">Example .NET app to Azure App Service.</p>
   </div>
   

   提示

   使用 GitHub Copilot 尝试此方法：

   1. 选择所有内容，然后选择 。
   2. 要求 Copilot“更改为显示‘.NET 💜 Azure’的启动卡。”

4. 在“源代码管理”菜单中输入提交消息，例如“Modify homepage”。 然后选择“提交”，并通过选择“是”确认暂存所做的更改。

   .NET 10

   

   .NET 框架 4.8

   

   提示

   通过在消息框中选择 ，让 GitHub Copilot 为你创建提交消息。

5. 选择同步更改 1，然后通过选择确定进行确认。

6. 需要几分钟才能运行部署。 若要查看进度，请导航到 https://github.com/<your-github-alias>/dotnetcore-docs-hello-world/actions。

7. 返回到在“浏览到应用”步骤中打开的浏览器窗口，然后刷新页面。

   .NET 10

   你将看到页面中显示的已更新的 ASP.NET Core 10.0 Web 应用。

   

   .NET 框架 4.8

   你会看到页面中显示的更新后的 ASP.NET Framework 4.8 Web 应用。

   

管理 Azure 应用

若要管理 Web 应用，请转到 Azure 门户，然后搜索并选择“应用服务”。

在“应用服务”页上，选择 Web 应用的名称。

你的网页应用概 览 页面包含了基本管理选项，比如浏览、停止、开始、重启和删除。 左侧菜单提供用于配置应用的更多页面。

清理资源

在前面的步骤中，你在资源组中创建了 Azure 资源。 如果将来不再需要这些资源，可以通过删除资源组来删除它们。

1. 在 Azure 门户的 Web 应用的“概述”页中，选择“资源组”下的 myResourceGroup 链接。
2. 在资源组页面上，确保所列出的那些资源是您想要删除的。
3. 选择“删除资源组”，在文本框中键入“myResourceGroup”，然后选择“删除”。
4. 通过选择“删除”再次进行确认。

清理资源

在前面的步骤中，你在资源组中创建了 Azure 资源。 如果将来不再需要这些资源，可以通过删除资源组来删除它们。

1. 在 Azure 门户的 Web 应用的“概述”页中，选择“资源组”下的 myResourceGroup 链接。
2. 在资源组页面上，确保所列出的那些资源是您想要删除的。
3. 选择“删除资源组”，在文本框中键入“myResourceGroup”，然后选择“删除”。
4. 通过选择“删除”再次进行确认。

在前面的步骤中，你在资源组中创建了 Azure 资源。 如果认为将来不需要这些资源，请在 Cloud Shell 中运行以下命令删除资源组：

az group delete

为方便起见，每当你从此项目运行 命令时，你之前在此项目中运行的 az 命令都会将资源组名称保存为默认值。

清理资源

在前面的步骤中，你在资源组中创建了 Azure 资源。 如果你认为将来不再需要这些资源，请运行以下 PowerShell 命令删除资源组：

Remove-AzResourceGroup -Name myResourceGroup

运行此命令可能需要一分钟时间。

清理资源

在前面的步骤中，你在资源组中创建了 Azure 资源。 如果将来不再需要这些资源，可以通过删除资源组来删除它们。

1. 在 Azure 门户的 Web 应用的“概述”页中，选择“资源组”下的 myResourceGroup 链接。
2. 在资源组页面上，确保所列出的那些资源是您想要删除的。
3. 选择“删除资源组”，在文本框中键入“myResourceGroup”，然后选择“删除”。
4. 通过选择“删除”再次进行确认。

后续步骤

.NET 10

请继续学习下一篇文章，了解如何创建 .NET Core 应用并将其连接到 SQL 数据库：

教程：将 ASP.NET Core 应用与 SQL 数据库配合使用

应用模板：ASP.NET Core 应用，其中包含使用 CI/CD GitHub Actions 部署的 SQL 数据库和 App Insights

配置 ASP.NET Core 应用

.NET 框架 4.8

请继续学习下一篇文章，了解如何创建 .NET Framework 应用并将其连接到 SQL 数据库：

教程：将 ASP.NET 应用与 SQL 数据库配合使用

配置 ASP.NET Framework 应用

  使用自定义域和证书进行保护