从零到一：在Ubuntu Server上部署你的第一个.NET 8 Web API（含Dockerfile编写与容器化实战）
从零到一：在Ubuntu Server上部署你的第一个.NET 8 Web API（含Dockerfile编写与容器化实战）
最近两年，.NET跨平台开发能力突飞猛进，特别是.NET 8的发布让Linux服务器部署变得前所未有的简单。作为一名长期在Linux环境部署.NET应用的全栈开发者，我想分享一个完整的实战流程——从裸机Ubuntu Server开始，到最终运行在Docker容器中的Web API服务。这个过程不仅涉及基础环境配置，更重要的是教会你如何将开发成果转化为可部署的生产级应用。
1. 环境准备：Ubuntu Server与.NET 8 SDK
在开始之前，确保你有一台运行Ubuntu Server 22.04 LTS的机器（物理机或云实例均可）。这个版本之所以被推荐，是因为它提供了最完整的.NET支持且生命周期长达5年。
1.1 安装基础依赖
首先更新系统包索引并安装必要的工具链：
sudo apt update && sudo apt upgrade -y sudo apt install -y curl wget git unzip1.2 安装.NET 8 SDK
对于Ubuntu 22.04，微软提供了官方的APT源配置方式：
sudo apt install -y dotnet-sdk-8.0安装完成后验证版本：
dotnet --version # 预期输出：8.0.x注意：如果系统提示找不到包，可能需要先添加微软的GPG密钥和软件源：
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
2. 创建你的第一个Web API项目
2.1 初始化项目结构
使用.NET CLI创建一个最小化的Web API项目：
dotnet new webapi -n WeatherAPI --no-https -o ~/WeatherAPI cd ~/WeatherAPI这个命令创建了一个：
- 不启用HTTPS的Web API项目（简化开发环境配置）
- 名为WeatherAPI的天气服务示例
- 项目目录位于用户主文件夹下
2.2 关键代码解析
打开Program.cs，你会看到一个精简的现代.NET API模板：
var builder = WebApplication.CreateBuilder(args); builder.Services.AddControllers(); var app = builder.Build(); app.MapControllers(); app.Run();相比传统Startup类，这种"最小API"模式更符合现代开发习惯。让我们添加一个简单的天气控制器：
touch Controllers/WeatherForecastController.cs编辑该文件并加入：
using Microsoft.AspNetCore.Mvc; namespace WeatherAPI.Controllers; [ApiController] [Route("[controller]")] public class WeatherForecastController : ControllerBase { private static readonly string[] Summaries = new[] { "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching" }; [HttpGet(Name = "GetWeatherForecast")] public IEnumerable<WeatherForecast> Get() { return Enumerable.Range(1, 5).Select(index => new WeatherForecast { Date = DateOnly.FromDateTime(DateTime.Now.AddDays(index)), TemperatureC = Random.Shared.Next(-20, 55), Summary = Summaries[Random.Shared.Next(Summaries.Length)] }) .ToArray(); } }2.3 本地运行测试
启动开发服务器：
dotnet run用curl测试API端点：
curl http://localhost:5000/WeatherForecast | jq你应该能看到返回的JSON格式天气数据。按Ctrl+C停止服务。
3. 容器化部署：Docker实战
3.1 安装Docker引擎
在Ubuntu上安装Docker CE：
sudo apt install -y docker.io sudo systemctl enable --now docker sudo usermod -aG docker $USER newgrp docker # 刷新用户组3.2 编写生产级Dockerfile
在项目根目录创建Dockerfile：
# 构建阶段 FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build WORKDIR /src COPY . . RUN dotnet restore RUN dotnet publish -c Release -o /app # 运行时阶段 FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS runtime WORKDIR /app COPY --from=build /app . EXPOSE 80 ENTRYPOINT ["dotnet", "WeatherAPI.dll"]这个多阶段构建的Dockerfile具有以下优化：
- 分离构建环境和运行时环境，减小最终镜像体积
- 使用官方微软镜像，确保兼容性
- 明确暴露80端口（HTTP标准端口）
3.3 构建并运行容器
执行构建命令：
docker build -t weatherapi .运行容器实例：
docker run -d -p 8080:80 --name weather weatherapi验证服务：
curl http://localhost:8080/WeatherForecast | jq4. 生产环境优化建议
4.1 性能调优参数
在docker run命令中添加.NET运行时优化参数：
docker run -d -p 8080:80 \ -e DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1 \ -e ASPNETCORE_ENVIRONMENT=Production \ --name weather weatherapi关键环境变量说明：
| 变量名 | 推荐值 | 作用 |
|---|---|---|
| DOTNET_SYSTEM_GLOBALIZATION_INVARIANT | 1 | 禁用全球化特性，提升性能 |
| ASPNETCORE_ENVIRONMENT | Production | 启用生产模式配置 |
| COMPlus_ReadyToRun | 1 | 启用AOT编译优化 |
4.2 日志与监控配置
修改Program.cs添加结构化日志：
builder.Logging.ClearProviders(); builder.Logging.AddJsonConsole(options => { options.IncludeScopes = true; options.TimestampFormat = "HH:mm:ss"; options.JsonWriterOptions = new() { Indented = true }; });4.3 健康检查端点
添加健康检查路由：
app.MapGet("/health", () => Results.Ok(new { status = "healthy" }));然后在Dockerfile中添加健康检查指令：
HEALTHCHECK --interval=30s --timeout=3s \ CMD curl -f http://localhost/health || exit 15. CI/CD集成示例
5.1 GitHub Actions自动化流程
创建.github/workflows/docker-build.yml：
name: Docker Build on: push: branches: [ "main" ] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: Login to Docker Hub uses: docker/login-action@v2 with: username: ${{ secrets.DOCKER_HUB_USERNAME }} password: ${{ secrets.DOCKER_HUB_TOKEN }} - name: Build and push uses: docker/build-push-action@v4 with: push: true tags: yourusername/weatherapi:latest5.2 多架构镜像构建
修改Dockerfile支持ARM64：
# syntax=docker/dockerfile:1.4 FROM --platform=$BUILDPLATFORM mcr.microsoft.com/dotnet/sdk:8.0 AS build # ...其余内容保持不变...构建命令更新为：
docker buildx build --platform linux/amd64,linux/arm64 -t yourusername/weatherapi:multiarch --push .在实际部署中发现，这种多阶段构建配合ARM64支持的配置，能让同一套代码无缝运行在树莓派到云服务器的各种环境。特别是在Kubernetes集群中部署时，节点架构差异完全由Docker自动处理，大大简化了运维复杂度。