1. Linux环境下.NET Core的完整部署指南作为微软推出的跨平台开发框架.NET Core在Linux服务器上的应用越来越广泛。根据2023年Stack Overflow开发者调查已有超过28%的.NET开发者选择Linux作为主要部署环境。本文将基于Ubuntu 22.04 LTS详细演示从环境准备到应用部署的全流程。提示虽然本文以Ubuntu为例但所述方法同样适用于Debian、CentOS等主流Linux发行版只需替换对应的包管理命令即可。1.1 环境准备与依赖安装在开始安装前需要确保系统已更新至最新状态。执行以下命令完成基础环境准备sudo apt update sudo apt upgrade -y sudo apt install -y wget curl gnupg apt-transport-https.NET Core运行时需要一些基础依赖库特别是对于Web应用sudo apt install -y libunwind8 libicu70 libssl3 libgssapi-krb5-2 zlib1g对于生产环境建议单独创建运行账户sudo adduser --disabled-password --gecos dotnetuser1.2 官方仓库配置微软为Linux系统维护了专门的软件仓库我们需要先将其添加到APT源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验证仓库是否添加成功apt-cache search dotnet-sdk | grep microsoft应该能看到类似dotnet-sdk-7.0这样的包名显示出来。2. .NET Core的安装方式对比2.1 通过APT包管理器安装推荐这是最稳定的安装方式适合生产环境sudo apt update sudo apt install -y dotnet-sdk-7.0安装后验证版本dotnet --version如果只需要运行时环境不开发只运行可以安装更轻量的运行时sudo apt install -y aspnetcore-runtime-7.02.2 通过Snap安装适合快速体验Canonical维护的Snap包更新更及时适合开发环境sudo snap install dotnet-sdk --classic --channel7.0 sudo snap alias dotnet-sdk.dotnet dotnet2.3 手动安装灵活但复杂当需要特定版本或离线安装时可以下载二进制包mkdir -p $HOME/dotnet cd $HOME/dotnet wget https://download.visualstudio.microsoft.com/download/pr/abcdefg/dotnet-sdk-7.0.100-linux-x64.tar.gz tar zxf dotnet-sdk-7.0.100-linux-x64.tar.gz echo export DOTNET_ROOT$HOME/dotnet ~/.bashrc echo export PATH$PATH:$HOME/dotnet ~/.bashrc source ~/.bashrc3. 项目部署实战3.1 创建测试项目验证安装是否成功的最快方式dotnet new webapp -o HelloWeb cd HelloWeb dotnet run访问http://localhost:5000应该能看到默认页面。3.2 生产环境部署要点发布优化dotnet publish -c Release -o ./publish --self-contained false -r linux-x64进程管理 使用systemd创建服务[Unit] DescriptionHelloWeb .NET Web App [Service] WorkingDirectory/var/www/helloweb ExecStart/usr/bin/dotnet /var/www/helloweb/HelloWeb.dll Restartalways Userdotnetuser Groupwww-data [Install] WantedBymulti-user.target反向代理配置Nginx示例server { listen 80; server_name 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; } }4. 常见问题排查指南4.1 SSL连接问题当连接SQL Server时出现provider: ssl provider, error: 31错误通常需要sudo apt install -y openssl export DOTNET_SYSTEM_NET_HTTP_USESOCKETSHTTPHANDLER04.2 多版本管理使用global.json文件指定项目使用的SDK版本{ sdk: { version: 7.0.100, rollForward: latestFeature } }4.3 性能优化对于计算密集型应用建议设置GC模式export COMPlus_gcServer1启用分层编译export DOTNET_TieredCompilation15. 进阶配置技巧5.1 容器化部署使用官方.NET镜像的Dockerfile示例FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build WORKDIR /src COPY . . RUN dotnet publish -c release -o /app FROM mcr.microsoft.com/dotnet/aspnet:7.0 WORKDIR /app COPY --frombuild /app . ENTRYPOINT [dotnet, HelloWeb.dll]5.2 监控与日志集成Application Insightsdotnet add package Microsoft.ApplicationInsights.AspNetCore在Program.cs中添加builder.Services.AddApplicationInsightsTelemetry();5.3 安全加固建议定期更新sudo apt update sudo apt upgrade dotnet-sdk-7.0文件权限设置sudo chown -R dotnetuser:www-data /var/www/helloweb sudo chmod -R 750 /var/www/helloweb禁用开发模式if (!app.Environment.IsDevelopment()) { app.UseExceptionHandler(/Error); app.UseHsts(); }在实际部署过程中我发现Ubuntu 22.04与.NET 7的兼容性最好特别是对于需要连接SQL Server的场景。对于内存受限的VPS建议将COMPlus_GCHeapCount设置为CPU核心数的一半能显著降低内存压力。
1. Linux环境下.NET Core的完整部署指南作为微软推出的跨平台开发框架.NET Core在Linux服务器上的应用越来越广泛。根据2023年Stack Overflow开发者调查已有超过28%的.NET开发者选择Linux作为主要部署环境。本文将基于Ubuntu 22.04 LTS详细演示从环境准备到应用部署的全流程。提示虽然本文以Ubuntu为例但所述方法同样适用于Debian、CentOS等主流Linux发行版只需替换对应的包管理命令即可。1.1 环境准备与依赖安装在开始安装前需要确保系统已更新至最新状态。执行以下命令完成基础环境准备sudo apt update sudo apt upgrade -y sudo apt install -y wget curl gnupg apt-transport-https.NET Core运行时需要一些基础依赖库特别是对于Web应用sudo apt install -y libunwind8 libicu70 libssl3 libgssapi-krb5-2 zlib1g对于生产环境建议单独创建运行账户sudo adduser --disabled-password --gecos dotnetuser1.2 官方仓库配置微软为Linux系统维护了专门的软件仓库我们需要先将其添加到APT源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验证仓库是否添加成功apt-cache search dotnet-sdk | grep microsoft应该能看到类似dotnet-sdk-7.0这样的包名显示出来。2. .NET Core的安装方式对比2.1 通过APT包管理器安装推荐这是最稳定的安装方式适合生产环境sudo apt update sudo apt install -y dotnet-sdk-7.0安装后验证版本dotnet --version如果只需要运行时环境不开发只运行可以安装更轻量的运行时sudo apt install -y aspnetcore-runtime-7.02.2 通过Snap安装适合快速体验Canonical维护的Snap包更新更及时适合开发环境sudo snap install dotnet-sdk --classic --channel7.0 sudo snap alias dotnet-sdk.dotnet dotnet2.3 手动安装灵活但复杂当需要特定版本或离线安装时可以下载二进制包mkdir -p $HOME/dotnet cd $HOME/dotnet wget https://download.visualstudio.microsoft.com/download/pr/abcdefg/dotnet-sdk-7.0.100-linux-x64.tar.gz tar zxf dotnet-sdk-7.0.100-linux-x64.tar.gz echo export DOTNET_ROOT$HOME/dotnet ~/.bashrc echo export PATH$PATH:$HOME/dotnet ~/.bashrc source ~/.bashrc3. 项目部署实战3.1 创建测试项目验证安装是否成功的最快方式dotnet new webapp -o HelloWeb cd HelloWeb dotnet run访问http://localhost:5000应该能看到默认页面。3.2 生产环境部署要点发布优化dotnet publish -c Release -o ./publish --self-contained false -r linux-x64进程管理 使用systemd创建服务[Unit] DescriptionHelloWeb .NET Web App [Service] WorkingDirectory/var/www/helloweb ExecStart/usr/bin/dotnet /var/www/helloweb/HelloWeb.dll Restartalways Userdotnetuser Groupwww-data [Install] WantedBymulti-user.target反向代理配置Nginx示例server { listen 80; server_name 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; } }4. 常见问题排查指南4.1 SSL连接问题当连接SQL Server时出现provider: ssl provider, error: 31错误通常需要sudo apt install -y openssl export DOTNET_SYSTEM_NET_HTTP_USESOCKETSHTTPHANDLER04.2 多版本管理使用global.json文件指定项目使用的SDK版本{ sdk: { version: 7.0.100, rollForward: latestFeature } }4.3 性能优化对于计算密集型应用建议设置GC模式export COMPlus_gcServer1启用分层编译export DOTNET_TieredCompilation15. 进阶配置技巧5.1 容器化部署使用官方.NET镜像的Dockerfile示例FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build WORKDIR /src COPY . . RUN dotnet publish -c release -o /app FROM mcr.microsoft.com/dotnet/aspnet:7.0 WORKDIR /app COPY --frombuild /app . ENTRYPOINT [dotnet, HelloWeb.dll]5.2 监控与日志集成Application Insightsdotnet add package Microsoft.ApplicationInsights.AspNetCore在Program.cs中添加builder.Services.AddApplicationInsightsTelemetry();5.3 安全加固建议定期更新sudo apt update sudo apt upgrade dotnet-sdk-7.0文件权限设置sudo chown -R dotnetuser:www-data /var/www/helloweb sudo chmod -R 750 /var/www/helloweb禁用开发模式if (!app.Environment.IsDevelopment()) { app.UseExceptionHandler(/Error); app.UseHsts(); }在实际部署过程中我发现Ubuntu 22.04与.NET 7的兼容性最好特别是对于需要连接SQL Server的场景。对于内存受限的VPS建议将COMPlus_GCHeapCount设置为CPU核心数的一半能显著降低内存压力。
