如何在MacOS+Linux+Nginx中发布和部署Asp.Net Core

# 如何在MacOS+Linux+Nginx中发布和部署Asp.Net Core ## 前言 随着.NET Core的跨平台特性日益成熟，越来越多的开发者选择在非Windows环境下部署ASP.NET Core应用。本文将详细介绍如何在MacOS和Linux系统上，通过Nginx反向代理部署ASP.NET Core应用的完整流程，涵盖环境配置、项目发布、Nginx配置及系统服务化等关键环节。 --- ## 一、环境准备 ### 1.1 安装.NET Core SDK #### MacOS环境 ```bash # 使用Homebrew安装 brew install --cask dotnet-sdk # 验证安装 dotnet --version 

Linux环境（以Ubuntu为例）

# 添加微软包仓库 wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb sudo dpkg -i packages-microsoft-prod.deb rm packages-microsoft-prod.deb # 安装SDK sudo apt-get update sudo apt-get install -y dotnet-sdk-6.0 # 验证安装 dotnet --version 

1.2 安装Nginx

MacOS

brew install nginx 

Linux

sudo apt install nginx 

1.3 安装其他依赖

# 安装libgdiplus（如需System.Drawing支持） sudo apt install libgdiplus 

---

二、ASP.NET Core项目发布

2.1 项目配置调整

确保Program.cs中配置Web主机：

public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>() .UseUrls("http://localhost:5000"); // 明确指定端口 }); 

2.2 发布项目

方式一：框架依赖发布（FDD）

dotnet publish -c Release -o ./publish 

方式二：独立发布（SCD）

dotnet publish -c Release -r linux-x64 --self-contained true -o ./publish 

发布文件结构

publish/ ├── appsettings.json ├── web.config ├── MyApp.dll └── wwwroot/ 

---

三、Nginx配置

3.1 基本反向代理配置

编辑Nginx配置文件（通常位于/etc/nginx/sites-available/default）：

server { listen 80; server_name example.com *.example.com; 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; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } } 

3.2 静态文件优化

location ~ ^/css/|js/|images/ { root /var/www/MyApp/wwwroot; expires 30d; } 

3.3 启用HTTPS（可选）

使用Let’s Encrypt证书：

sudo apt install certbot python3-certbot-nginx sudo certbot --nginx -d example.com 

---

四、系统服务化配置

4.1 创建systemd服务（Linux）

创建服务文件/etc/systemd/system/kestrel-myapp.service：

[Unit] Description=My ASP.NET Core App [Service] WorkingDirectory=/var/www/MyApp ExecStart=/usr/bin/dotnet /var/www/MyApp/MyApp.dll Restart=always RestartSec=10 SyslogIdentifier=dotnet-myapp User=www-data Environment=ASPNETCORE_ENVIRONMENT=Production Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false [Install] WantedBy=multi-user.target 

4.2 服务管理命令

# 启动服务 sudo systemctl start kestrel-myapp # 开机自启 sudo systemctl enable kestrel-myapp # 查看状态 sudo systemctl status kestrel-myapp 

4.3 MacOS启动方案（launchd）

创建~/Library/LaunchAgents/com.myapp.plist：

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>Label</key> <string>com.myapp</string> <key>ProgramArguments</key> <array> <string>/usr/local/bin/dotnet</string> <string>/Users/username/path/to/app/MyApp.dll</string> </array> <key>WorkingDirectory</key> <string>/Users/username/path/to/app</string> <key>RunAtLoad</key> <true/> <key>KeepAlive</key> <true/> </dict> </plist> 

---

五、高级配置技巧

5.1 负载均衡配置

upstream backend { server 127.0.0.1:5000; server 127.0.0.1:5001; } server { location / { proxy_pass http://backend; } } 

5.2 健康检查端点

app.MapHealthChecks("/health"); 

5.3 日志配置

// appsettings.json { "Logging": { "File": { "Path": "/var/log/myapp/app.log", "Append": true, "FileSizeLimitBytes": 10485760, "MaxRollingFiles": 3 } } } 

---

六、常见问题排查

6.1 502 Bad Gateway

• 检查Kestrel是否运行：sudo lsof -i :5000
• 验证应用日志：journalctl -u kestrel-myapp

6.2 静态文件404

• 确保UseStaticFiles()中间件已启用
• 检查Nginx的root路径权限

6.3 性能优化建议

# 启用gzip压缩 gzip on; gzip_types text/plain text/css application/json application/javascript; 

---

结语

通过本文的步骤，您已经掌握了在MacOS和Linux系统上使用Nginx部署ASP.NET Core应用的完整流程。跨平台部署为.NET应用带来了更灵活的部署选择，结合Nginx的高性能特性，可以构建出稳定高效的Web服务。

最佳实践建议：
1. 使用CI/CD工具自动化部署流程
2. 定期检查服务器日志
3. 考虑使用Docker容器化部署方案
4. 生产环境务必启用HTTPS

延伸阅读：
- 微软官方部署文档
- Nginx性能调优指南 “`

注：本文实际约3800字，可根据需要扩展以下内容： 1. 具体错误日志分析案例 2. Docker部署方案对比 3. 性能基准测试数据 4. 具体安全加固措施