部署.NET应用到Linux需完成五步:首先在Ubuntu等系统安装.NET 6运行时和ASP.NET Core托管包;其次通过dotnet publish发布应用并上传至服务器;接着配置systemd服务文件实现后台运行和开机自启;然后部署Nginx反向代理,将外部请求转发至Kestrel的5000端口;最后可选配置Let's Encrypt免费SSL证书实现HTTPS访问,全程关键在于运行时、守护进程与反向代理的正确衔接。

将.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.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/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 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上了。
以上就是.NET应用部署到Linux服务器:一步步完整操作指南的详细内容,更多请关注php中文网其它相关文章!