将.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.debsudo 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.02. 发布.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/myapp3. 配置守护进程(使用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 myapp4. 配置反向代理(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-nginxsudo certbot --nginx -d your-domain.com
按提示操作,Certbot会自动修改Nginx配置并启用HTTPS。建议设置自动续期:
sudo certbot renew --dry-run6. 日志与调试
查看应用日志是排查问题的关键:
sudo journalctl -u myapp -f也可以在代码中启用日志输出,配合Serilog或写入文件。
检查Kestrel是否正常监听:
curl http://localhost:5000基本上就这些。部署过程看似步骤多,实际操作一次后就很清晰。关键是确保运行时安装正确、systemd配置无误、Nginx代理设置完整。只要这三块打通,你的.NET应用就能稳定运行在Linux上了。
