1. 项目背景与核心价值

在Linux环境下部署.NET应用一直是个让开发者又爱又恨的话题。作为在Ubuntu上折腾过数十个.NET项目的过来人，我深刻理解从零开始配置环境的痛点。这次我们要用Docker这个"集装箱"技术，把.NET API应用打包成标准化单元，实现"一次构建，到处运行"的理想状态。

为什么选择Docker？想象你开发时用的是Windows系统，而生产环境是Ubuntu。传统部署方式下，你可能会遇到运行时版本不一致、依赖库缺失等各种"玄学"问题。Docker通过容器化技术，将应用及其所有依赖打包在一起，彻底解决了"在我机器上能跑"的经典难题。根据2023年Stack Overflow开发者调查，超过70%的专业开发者在使用容器技术，其中Docker占比高达89%。

2. 环境准备与Docker安装

2.1 系统要求检查

在开始前，先确认你的Ubuntu版本：

lsb_release -a

我推荐使用Ubuntu 20.04 LTS或22.04 LTS版本，这两个长期支持版有最好的兼容性。我曾尝试在18.04上安装最新版Docker，结果遭遇了内核版本不兼容的问题，不得不花半天时间升级系统。

重要提示：确保你的用户已加入sudo组，否则所有安装命令都需要通过root用户执行。

2.2 Docker安装四步曲

步骤1：卸载旧版本（如有）

sudo apt-get remove docker docker-engine docker.io containerd runc

这个步骤很多人会忽略，但如果你之前装过Docker的测试版，残留文件可能导致冲突。我就曾因为没清理干净，导致后续安装一直报错。

步骤2：设置仓库

sudo apt-get update sudo apt-get install \ ca-certificates \ curl \ gnupg \ lsb-release sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

步骤3：安装Docker引擎

sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

步骤4：验证安装

sudo docker run hello-world

看到"Hello from Docker!"就说明安装成功了。我第一次看到这个提示时，感觉就像收到了来自新世界的问候。

3. .NET环境配置技巧

3.1 安装.NET SDK

虽然我们要用Docker运行应用，但本地开发还是需要SDK。推荐使用微软官方提供的安装方式：

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 sudo apt-get update sudo apt-get install -y dotnet-sdk-6.0

避坑指南：SDK版本要与你的项目目标框架一致。我有次装了.NET 7 SDK却要构建.NET 6项目，结果各种警告让人抓狂。

3.2 创建测试API项目

让我们快速创建一个演示用的Weather API：

dotnet new webapi -o WeatherApi cd WeatherApi

这个模板项目自带Swagger文档和示例控制器，非常适合演示部署流程。

4. Docker化.NET应用实战

4.1 编写Dockerfile

在项目根目录创建Dockerfile：

# 使用官方.NET镜像作为基础 FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build WORKDIR /src COPY . . # 构建应用 RUN dotnet restore RUN dotnet publish -c release -o /app # 运行时镜像 FROM mcr.microsoft.com/dotnet/aspnet:6.0 WORKDIR /app COPY --from=build /app . ENTRYPOINT ["dotnet", "WeatherApi.dll"]

这个多阶段构建的Dockerfile做了三件事：

1. 使用SDK镜像编译项目
2. 发布构建输出
3. 使用更轻量的运行时镜像运行应用

4.2 构建Docker镜像

docker build -t weather-api .

构建过程可能会花费几分钟，取决于你的网络速度和机器性能。我第一次构建时因为没配置镜像加速，等了将近20分钟。

4.3 运行容器

docker run -d -p 8080:80 --name my-weather-api weather-api

现在你的API已经在容器中运行了！访问 http://localhost:8080/swagger 就能看到Swagger UI。

5. 生产环境优化策略

5.1 使用docker-compose管理服务

创建docker-compose.yml文件：

version: '3.8' services: weather-api: image: weather-api build: . ports: - "8080:80" environment: - ASPNETCORE_ENVIRONMENT=Production restart: unless-stopped

这样可以通过简单的命令管理服务：

docker-compose up -d # 启动 docker-compose down # 停止

5.2 日志与监控配置

查看容器日志：

docker logs -f my-weather-api

设置日志驱动（在docker-compose.yml中）：

logging: driver: "json-file" options: max-size: "10m" max-file: "3"

6. 常见问题排雷指南

6.1 端口冲突问题

如果遇到端口被占用错误：

Error starting userland proxy: listen tcp4 0.0.0.0:8080: bind: address already in use

解决方案：

1. 找出占用进程：sudo lsof -i :8080
2. 终止进程或改用其他端口

6.2 镜像构建缓慢

国内用户建议配置镜像加速器：

sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json <<-'EOF' { "registry-mirrors": ["https://<你的镜像加速地址>.mirror.aliyuncs.com"] } EOF sudo systemctl daemon-reload sudo systemctl restart docker

6.3 容器内应用崩溃

典型症状：容器启动后立即退出。排查步骤：

1. 查看日志：docker logs <容器ID>
2. 进入调试模式：

docker run -it --entrypoint /bin/bash weather-api

3. 手动运行应用查找问题

7. 进阶部署技巧

7.1 多环境配置管理

通过环境变量区分环境：

ENV ASPNETCORE_ENVIRONMENT=Development

在docker-compose中覆盖：

environment: - ASPNETCORE_ENVIRONMENT=Production

7.2 健康检查配置

在Dockerfile中添加：

HEALTHCHECK --interval=30s --timeout=3s \ CMD curl -f http://localhost/health || exit 1

7.3 资源限制

防止单个容器占用过多资源：

deploy: resources: limits: cpus: '0.5' memory: 512M

8. 性能优化实战

8.1 镜像瘦身技巧

原始镜像大小可能超过200MB，通过以下优化可缩减到100MB以内：

1. 使用alpine基础镜像：

FROM mcr.microsoft.com/dotnet/aspnet:6.0-alpine

2. 清理构建缓存：

RUN rm -rf /usr/share/dotnet /var/lib/apt/lists/*

8.2 构建缓存优化

合理安排Dockerfile指令顺序，把变化频率低的放在前面：

COPY *.csproj . RUN dotnet restore COPY . .

这样每次代码变更不会导致全部依赖重新下载。

9. 安全加固措施

9.1 非root用户运行

在Dockerfile中添加：

RUN adduser --disabled-password --gecos '' appuser && chown -R appuser /app USER appuser

9.2 敏感信息管理

使用Docker secret或环境变量文件：

docker run --env-file .env weather-api

9.3 镜像扫描

定期扫描镜像漏洞：

docker scan weather-api

10. 持续集成实践

10.1 GitHub Actions自动化

创建.github/workflows/docker.yml：

name: Docker Build on: [push] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 - name: Login to Docker Hub uses: docker/login-action@v1 with: username: ${{ secrets.DOCKER_HUB_USERNAME }} password: ${{ secrets.DOCKER_HUB_TOKEN }} - name: Build and push uses: docker/build-push-action@v2 with: push: true tags: yourusername/weather-api:latest

10.2 多架构构建

支持ARM和AMD平台：

docker buildx build --platform linux/amd64,linux/arm64 -t yourusername/weather-api --push .

经过这些步骤，你的.NET API就已经在Docker容器中稳定运行了。在实际项目中，我还习惯用Portainer来可视化管理系统中的容器，这对管理多个微服务特别有用。记住，容器化不是银弹，但对于解决环境一致性问题，它确实是最优雅的方案之一。