.NET应用部署到Linux服务器:一步步完整操作指南

来源:这里教程网 时间:2026-02-21 17:32:00 作者:

将.NET应用部署到Linux服务器并不复杂,只要掌握关键步骤。本文以.NET 6或更高版本(支持跨平台)为例,带你从零开始完成部署全过程,适用于Web API、MVC或后台服务类应用。

1. 准备Linux服务器环境

选择主流发行版如Ubuntu 20.04/22.04 LTS 或 CentOS 7+/Rocky Linux 8+。以下以Ubuntu为例:

更新系统包: sudo apt update && sudo apt upgrade -y 安装.NET运行时(以.NET 6为例): wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb
sudo apt update
sudo apt install -y apt-transport-https && sudo apt update
sudo apt install -y dotnet-runtime-6.0

若要运行ASP.NET Core应用,还需安装托管运行时:

sudo apt install -y aspnetcore-runtime-6.0

2. 发布.NET应用并上传到服务器

在开发机上使用.NET CLI发布为独立部署或框架依赖发布。推荐使用框架依赖发布(更轻量):

dotnet publish -c Release -r linux-x64 --self-contained false 输出目录通常为 bin/Release/net6.0/linux-x64/publish 将整个publish文件夹通过SCP、SFTP或rsync上传到服务器,例如传到 /var/www/myapp scp -r bin/Release/net6.0/linux-x64/publish user@your-server:/var/www/myapp

3. 配置守护进程(使用systemd管理应用)

让.NET应用作为后台服务运行,并在系统启动时自动拉起。

创建服务配置文件:
sudo nano /etc/systemd/system/myapp.service
写入以下内容(根据实际情况修改路径和用户): [Unit]
Description=My .NET Web Application
After=network.target

[Service]
Type=notify
ExecStart=/usr/bin/dotnet /var/www/myapp/myapp.dll
Restart=always
RestartSec=10
SyslogIdentifier=myapp
User=www-data
Environment=ASPNETCORE_ENVIRONMENT=Production

[Install]
WantedBy=multi-user.target
启用并启动服务: sudo systemctl enable myapp
sudo systemctl start myapp

查看运行状态:

sudo systemctl status myapp

4. 配置反向代理(Nginx)

将外部HTTP请求转发给Kestrel内嵌服务器。

安装Nginx: sudo apt install -y nginx创建站点配置: sudo nano /etc/nginx/sites-available/myapp添加以下配置(替换your-domain.com): server {
listen 80;
server_name your-domain.com;

location / {
proxy_pass http://127.0.0.1:5000; # Kestrel默认监听端口
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection keep-alive;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_cache_bypass $http_upgrade;
proxy_buffering off;
}
}
启用站点: sudo ln -s /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/测试配置并重启Nginx: sudo nginx -t
sudo systemctl restart nginx

5. (可选)配置HTTPS(使用Let's Encrypt)

使用Certbot申请免费SSL证书:

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d your-domain.com

按提示操作,Certbot会自动修改Nginx配置并启用HTTPS。建议设置自动续期:

sudo certbot renew --dry-run

6. 日志与调试

查看应用日志是排查问题的关键:

sudo journalctl -u myapp -f

也可以在代码中启用日志输出,配合Serilog或写入文件。

检查Kestrel是否正常监听:

curl http://localhost:5000

基本上就这些。部署过程看似步骤多,实际操作一次后就很清晰。关键是确保运行时安装正确、systemd配置无误、Nginx代理设置完整。只要这三块打通,你的.NET应用就能稳定运行在Linux上了。

相关推荐