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

发布时间：2021-12-23 13:34:34 作者：iii
来源：亿速云阅读：233

# 如何在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. 具体安全加固措施