Docker容器化部署.NET API应用实战指南
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做了三件事：
- 使用SDK镜像编译项目
- 发布构建输出
- 使用更轻量的运行时镜像运行应用
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解决方案：
- 找出占用进程：
sudo lsof -i :8080 - 终止进程或改用其他端口
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 docker6.3 容器内应用崩溃
典型症状：容器启动后立即退出。排查步骤：
- 查看日志：
docker logs <容器ID> - 进入调试模式：
docker run -it --entrypoint /bin/bash weather-api- 手动运行应用查找问题
7. 进阶部署技巧
7.1 多环境配置管理
通过环境变量区分环境：
ENV ASPNETCORE_ENVIRONMENT=Development在docker-compose中覆盖：
environment: - ASPNETCORE_ENVIRONMENT=Production7.2 健康检查配置
在Dockerfile中添加：
HEALTHCHECK --interval=30s --timeout=3s \ CMD curl -f http://localhost/health || exit 17.3 资源限制
防止单个容器占用过多资源：
deploy: resources: limits: cpus: '0.5' memory: 512M8. 性能优化实战
8.1 镜像瘦身技巧
原始镜像大小可能超过200MB，通过以下优化可缩减到100MB以内：
- 使用alpine基础镜像：
FROM mcr.microsoft.com/dotnet/aspnet:6.0-alpine- 清理构建缓存：
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 appuser9.2 敏感信息管理
使用Docker secret或环境变量文件：
docker run --env-file .env weather-api9.3 镜像扫描
定期扫描镜像漏洞：
docker scan weather-api10. 持续集成实践
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:latest10.2 多架构构建
支持ARM和AMD平台：
docker buildx build --platform linux/amd64,linux/arm64 -t yourusername/weather-api --push .经过这些步骤，你的.NET API就已经在Docker容器中稳定运行了。在实际项目中，我还习惯用Portainer来可视化管理系统中的容器，这对管理多个微服务特别有用。记住，容器化不是银弹，但对于解决环境一致性问题，它确实是最优雅的方案之一。