简介
背景和优势
ASP.NET Core 自 .NET Core 1.0（2016 年）起支持跨平台，Linux 部署具有以下优势：
高性能：Linux 服务器（如 Ubuntu）资源占用低，适合高并发。
成本效益：开源操作系统，降低服务器成本。
生态支持：支持 MySQL、Docker、Nginx 等，适配微服务和云原生。
社区活跃：Linux 是云部署（如 AWS、Azure）的首选。
部署方式
ASP.NET Core Web 项目在 Linux 上有以下主要部署方式：
独立部署（Self-contained）：
打包应用和 .NET 运行时，独立运行。
适合无 .NET 运行时的 Linux 服务器。
框架依赖部署（Framework-dependent）：
仅打包应用，依赖服务器安装的 .NET SDK/运行时。
适合已配置 .NET 环境的服务器。
Docker 容器部署：
使用 Docker 容器封装应用和依赖。
适合微服务、云原生和 CI/CD。
云平台部署：
使用云服务（如 Azure App Service、AWS Elastic Beanstalk）。
适合快速部署和扩展。
前提条件
目标机器
发行版（Ubuntu、CentOS、Debian、Alpine 等）
已安装 .NET 运行时或 SDK（建议至少 .NET 6 LTS 及以上）
.NET 安装
# 以 Ubuntu 为例，安装 .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
sudo apt update
sudo apt install -y aspnetcore-runtime-6.0
防火墙与端口
确保托管应用使用的端口（如 5000 或 80/443）在防火墙/安全组中开放。
发布与运行（Self-Contained vs Framework-Dependent）
Framework-Dependent 部署
依赖目标主机已安装 .NET 运行时，发布包更小。
dotnet publish -c Release -o ./publish
Self-Contained 部署
包含运行时，无需预装 .NET，但体积更大。
dotnet publish -c Release -r linux-x64 --self-contained true -o ./publish
-c Release：发布优化版本。
-o ./publish：输出到 publish 目录。
--self-contained true：包含 .NET 运行时。
-r linux-x64：目标运行时（Linux 64 位）。
运行：./publish/YourApp
部署应用
传输文件
使用 scp 或 rsync 将 publish 目录上传到 Linux 服务器：
scp -r ./publish user@server:/var/www/yourapp
设置权限
sudo chown -R www-data:www-data /var/www/yourapp
sudo chmod -R 755 /var/www/yourapp
直接运行（Kestrel 自托管）
启动应用
cd yourapp
dotnet YourApp.dll # Framework-Dependent
# 或 ./YourApp # Self-Contained
监听所有接口
在 appsettings.json 或环境变量中配置：
"Kestrel": {
"Endpoints": {
"Http": { "Url": "http://0.0.0.0:5000" }
}
}
或：
export ASPNETCORE_URLS="http://0.0.0.0:5000"
dotnet YourApp.dll
优点：部署简单；
缺点：缺少负载均衡、TLS 终端、日志管理等企业特性。
使用 systemd 守护进程
将应用作为服务后台运行并随系统启动。
创建 systemd Unit 文件 /etc/systemd/system/kestrel-yourapp.service：
[Unit]
Description=YourApp ASP.NET Core Service
After=network.target
[Service]
WorkingDirectory=/var/www/yourapp
ExecStart=/usr/bin/dotnet /var/www/yourapp/YourApp.dll
Restart=always
RestartSec=10
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=ASPNETCORE_URLS=http://0.0.0.0:5000
[Install]
WantedBy=multi-user.target
启动与启用
sudo systemctl daemon-reload
sudo systemctl start kestrel-yourapp
sudo systemctl enable kestrel-yourapp
sudo journalctl -fu kestrel-yourapp
反向代理（Nginx/Apache）+ Kestrel
推荐生产环境中使用反向代理，实现静态文件缓存、TLS 终端、路径重写等。
安装 Nginx
sudo apt install -y nginx
配置 Nginx
在 /etc/nginx/sites-available/yourapp 中：
server {
listen 80;
server_name your.domain.com;
# 将 HTTP 重定向到 HTTPS（可选）
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
server_name your.domain.com;
ssl_certificate /etc/ssl/certs/your.crt;
ssl_certificate_key /etc/ssl/private/your.key;
location / {
proxy_pass http://127.0.0.1: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;
}
# 可选：静态文件直连
location /static/ {
root /var/www/yourapp/wwwroot;
expires 30d;
}
}
启用配置并重启 Nginx：
sudo ln -s /etc/nginx/sites-available/yourapp /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx
容器化部署（Docker）
使用 Docker 将环境一致性和可移植性做到极致。
Dockerfile 示例
FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["YourApp.csproj", "./"]
RUN dotnet restore
COPY . .
RUN dotnet publish -c Release -o /app/publish
FROM base AS final
WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "YourApp.dll"]
构建与运行
docker build -t yourapp:1.0 .
docker run -d -p 80:80 --name yourapp -e ASPNETCORE_ENVIRONMENT=Production yourapp:1.0
使用 Docker Compose
version: '3.8'
services:
web:
image: yourapp:latest
build:
context: .
dockerfile: Dockerfile
ports:
- "8080:80"
environment:
- ASPNETCORE_ENVIRONMENT=Production
depends_on:
- mysql
networks:
- app-network
mysql:
image: mysql:8.0
environment:
- MYSQL_ROOT_PASSWORD=password
volumes:
- mysql-data:/var/lib/mysql
ports:
- "3306:3306"
networks:
- app-network
nginx:
image: nginx:latest
ports:
- "80:80"
volumes:
- ./nginx.conf:/etc/nginx/nginx.conf
depends_on:
- web
networks:
- app-network
networks:
app-network:
driver: bridge
volumes:
mysql-data:
Nginx 配置（nginx.conf）：
events {}
http {
server {
listen 80;
location / {
proxy_pass http://web:80;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
}
PaaS 平台部署
若不想自管服务器，可选用云厂商 PaaS：
Azure App Service for Linux
AWS Elastic Beanstalk (Docker/.NET Core 平台)
Google Cloud Run (容器化)
Heroku (使用 Docker buildpacks)
这些平台通常只需推送代码或镜像，自动完成构建、运行、负载均衡与 TLS。
运维与监控
日志集中
使用 Microsoft.Extensions.Logging 输出到文件、Syslog、ELK/EFK 或 Prometheus。
健康检查
在 Startup 配置健康检查端点 app.MapHealthChecks("/health")，并让负载均衡器探活。
自动重启
systemd 的 Restart=always 或 Kubernetes 的 livenessProbe。
性能分析
利用 dotnet-counters、dotnet-trace、Application Insights、Prometheus + Grafana 等。
# 安装 dotnet-counters
dotnet tool install -g dotnet-counters
# 监控应用性能
dotnet-counters monitor -n your-app --counters System.Runtime,Microsoft.AspNetCore.Http
# 安装 dotnet-trace
dotnet tool install -g dotnet-trace
# 收集性能跟踪
dotnet-trace collect -n your-app --format Speedscope
关键诊断命令
# 检查端口监听
sudo ss -tulpn | grep ':5000\|:5001'
# 查看应用日志
journalctl -u your-app --since "10 minutes ago" -f
# 测试数据库连接
psql -h localhost -U your_app_user -d your_app_db -c "SELECT 1"
# 网络连通性测试
curl -v http://localhost:5000/health
# 分析内存使用
top -p $(pgrep -f YourApp)
最佳实践清单
环境标准化：
使用相同版本的 OS 和 .NET 运行时
配置统一的环境变量管理
安全优先：
最小权限原则（非 root 用户运行）
定期更新安全补丁
强制 HTTPS 连接
可靠部署：
使用 CI/CD 流水线自动化部署
实现蓝绿部署或金丝雀发布
保留上一个版本的回滚能力
性能优化：
启用 ReadyToRun 编译
配置响应压缩
使用负载均衡和水平扩展
监控告警：
实现全面的健康检查
集成 APM 工具（如 Application Insights）
设置关键指标告警（CPU、内存、错误率）
灾难恢复：
定期备份数据库和应用配置
制定并测试恢复计划
多区域部署关键应用
小结
方式
优点
缺点
直接运行（Kestrel）
最简单、零依赖
缺少 TLS、负载均衡
systemd 管理
稳定重启、开机自启
无反向代理、证书管理需额外
Nginx/Apache 反向代理 + systemd
TLS 终端、路径重写、静态缓存
配置略复杂
Docker 容器化
环境隔离、可移植、高度一致
学习成本、镜像管理
云 PaaS
最少运维、自动伸缩
平台依赖、成本相对较高
资源和文档
官方文档：
ASP.NET Core on Linux：https://learn.microsoft.com/en-us/aspnet/core/host-and-deploy/linux-nginx
Docker with ASP.NET Core：https://learn.microsoft.com/en-us/aspnet/core/host-and-deploy/docker