在Ubuntu上部署ASP.NET指南-精创网络云防护

帮助文档
在Ubuntu上部署ASP.NET指南
来源：www.jcwlyf.com更新时间：2025-02-12
随着 .NET Core 的推出，ASP.NET 开发框架已不再局限于 Windows 系统，开发者可以在多个平台上运行 ASP.NET 应用程序。对于 Linux 用户来说，Ubuntu 系统是最受欢迎的选择之一。本文将详细介绍如何在 Ubuntu 上部署 ASP.NET 应用程序，帮助开发者顺利搭建 ASP.NET 环境并运行 Web 应用。
一、准备环境
在开始之前，我们需要准备好在 Ubuntu 上运行 ASP.NET 应用程序所需的环境。这包括安装 .NET SDK 和运行时环境，以及配置好 Nginx 反向代理以确保 ASP.NET 应用能够顺利提供服务。
1.1 安装 .NET SDK 和运行时
首先，打开终端，更新系统软件包列表：
```
sudo apt update
```
然后，安装必要的依赖库：
```
sudo apt install -y wget apt-transport-https software-properties-common
```
接下来，添加 Microsoft 的 APT 存储库并安装 .NET SDK 和运行时。执行以下命令：
```
wget https://packages.microsoft.com/config/ubuntu/20.04/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 417A0893
sudo apt update
sudo apt install -y dotnet-sdk-6.0
```
通过以上步骤，你可以成功安装 .NET SDK。如果只是运行应用，不需要开发，可以只安装 .NET 运行时：
```
sudo apt install -y dotnet-runtime-6.0
```
1.2 验证安装
完成安装后，输入以下命令确认 .NET 是否正确安装：
```
dotnet --version
```
如果返回了版本号，说明 .NET SDK 已成功安装。
二、创建 ASP.NET Web 应用
现在，我们将创建一个简单的 ASP.NET Core Web 应用并进行部署。
2.1 创建新项目
在终端中导航到你希望存放项目的目录，使用以下命令创建一个新的 Web 应用程序：
```
dotnet new webapp -n MyAspNetApp
```
这会在当前目录下创建一个名为 “MyAspNetApp” 的文件夹，并生成一个基础的 ASP.NET Web 应用。接着，进入该目录：
```
cd MyAspNetApp
```
2.2 运行项目
在本地开发过程中，你可以通过以下命令来启动该应用：
```
dotnet run
```
默认情况下，应用会在 http://localhost:5000 上运行。如果在浏览器中访问该地址，你将看到一个默认的 ASP.NET Web 应用界面。
三、发布应用
为了在 Ubuntu 服务器上部署应用，我们需要先将应用发布成可以在生产环境中运行的文件。通过以下步骤完成发布过程。
3.1 发布应用
在项目根目录下，执行以下命令将应用发布到指定文件夹：
```
dotnet publish -c Release -o /var/www/MyAspNetApp
```
此命令会将应用发布到 /var/www/MyAspNetApp 目录下。发布的文件包括所有运行时所需的 DLL、配置文件和其他资源。
3.2 配置 Nginx 反向代理
由于 ASP.NET Core 是一个跨平台的框架，通常会运行在 Kestrel 服务器上，而 Nginx 是常用的反向代理服务器，可以用来转发请求到 ASP.NET Core 应用。首先，安装 Nginx：
```
sudo apt install nginx
```
安装完成后，启动并启用 Nginx 服务：
```
sudo systemctl start nginx
sudo systemctl enable nginx
```
接着，配置 Nginx 来代理转发到 ASP.NET Core 应用。在 Nginx 配置文件中添加一条代理规则：
```
sudo nano /etc/nginx/sites-available/default
```
在 server 区块中，修改配置如下：
```
server {
    listen 80;
    server_name your_domain_or_ip;

    location / {
        proxy_pass http://localhost:5000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection keep-alive;
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}
```
保存并关闭文件后，重新加载 Nginx 配置：
```
sudo systemctl reload nginx
```
此时，Nginx 将会将所有 HTTP 请求转发到运行在本地端口 5000 上的 ASP.NET 应用。
四、配置应用作为服务运行
为了确保 ASP.NET 应用在服务器重启后能够自动启动，我们需要将其配置为系统服务。我们可以使用 systemd 来实现这一点。
4.1 创建 systemd 服务文件
使用以下命令创建一个新的 systemd 服务文件：
```
sudo nano /etc/systemd/system/myaspnetapp.service
```
将以下内容复制到文件中：
```
[Unit]
Description=My ASP.NET Core Web App
After=network.target

[Service]
WorkingDirectory=/var/www/MyAspNetApp
ExecStart=/usr/bin/dotnet /var/www/MyAspNetApp/MyAspNetApp.dll
Restart=always
RestartSec=10
SyslogIdentifier=dotnet-example
User=www-data
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false

[Install]
WantedBy=multi-user.target
```
保存并关闭文件。此服务文件配置了 .NET 应用在 Ubuntu 上的启动、停止和重启行为。
4.2 启动和启用服务
执行以下命令，重新加载 systemd 配置并启动应用服务：
```
sudo systemctl daemon-reload
sudo systemctl start myaspnetapp
sudo systemctl enable myaspnetapp
```
通过以上命令，你的 ASP.NET 应用已经被配置为开机自启动并且已经成功启动。
五、检查日志和调试
如果应用在运行过程中遇到问题，可以通过查看日志来进行调试。使用以下命令查看 systemd 服务的日志：
```
sudo journalctl -fu myaspnetapp
```
这将输出关于 ASP.NET 应用的实时日志，可以帮助你定位问题。
六、总结
本文详细介绍了如何在 Ubuntu 上部署 ASP.NET 应用程序，从环境准备、应用创建到发布与配置 Nginx 反向代理，以及将应用配置为 systemd 服务，确保它能自动启动并稳定运行。通过这些步骤，开发者可以顺利地将 ASP.NET Core 应用部署到 Ubuntu 上，享受高效、安全的 Web 服务。
部署完毕后，你可以根据实际需求对应用进行优化和扩展，确保它能够在生产环境中高效稳定地运行。