C#怎么使用Docker Compose实现多容器编排部署？实战教程详解

Docker Compose是Docker官方提供的多容器编排工具，它允许你通过一个YAML文件定义应用程序需要的全部服务，再用一条命令把所有容器一起启动。对一个典型的C#项目来说，应用本身往往不是孤立运行的，它需要SQL Server或PostgreSQL存数据，需要Redis做缓存，需要Nginx做反向代理。如果手工一个个docker run去启动这些容器，参数一多就容易出错，而且难以维护。Compose正好解决这个问题，它把这些容器的镜像、端口、环境变量、依赖关系全部声明在配置文件里，团队任何人拿到代码就能一键启动完整环境。本文将以一个ASP.NET Core Web API项目为主线，完整演示从编写Dockerfile到编排多容器再到验证部署的全过程。

一、准备C#项目的Dockerfile

在开始使用Compose之前，首先要保证C#应用本身可以构建成镜像。在项目根目录下创建一个名为Dockerfile的文件，注意没有扩展名。对于ASP.NET Core项目，微软官方提供了两阶段构建的推荐写法：第一阶段使用SDK镜像编译发布，第二阶段使用运行时镜像承载发布产物。这样最终镜像只包含运行时和编译结果，体积能缩小到一百多MB。

# 第一阶段：编译
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["MyApi.csproj", "./"]
RUN dotnet restore
COPY . .
RUN dotnet publish -c Release -o /app/publish

# 第二阶段：运行
FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS final
WORKDIR /app
COPY --from=build /app/publish .
EXPOSE 8080
ENTRYPOINT ["dotnet", "MyApi.dll"]

这里有两个细节需要注意。第一，先单独COPY csproj文件再执行dotnet restore，可以利用Docker的层缓存机制，只要项目文件不变，后续修改代码不会重新还原NuGet包，构建速度大幅提升。第二，.NET 8默认监听8080端口，所以EXPOSE写的是8080；如果你的程序里通过ASPNETCORE_URLS指定了其他端口，这里要保持一致。

另外建议在项目根目录添加.dockerignore文件，把bin、obj、.git等目录排除掉，避免把本地编译产物复制进镜像导致体积膨胀甚至编译冲突。完成之后，先执行docker build -t myapi .验证镜像能否正常构建，确认无误再进入下一步。

二、编写docker-compose.yml编排多个容器

Dockerfile解决了单个应用的容器化，Compose则负责把应用和它的依赖组织起来。在解决方案根目录创建docker-compose.yml文件，定义三个服务：Web API、SQL Server和Redis。下面是一份可以直接使用的完整配置。

version: "3.8"

services:
  myapi:
    build: .
    container_name: myapi-app
    ports:
      - "5000:8080"
    environment:
      - ASPNETCORE_ENVIRONMENT=Development
      - ConnectionStrings__Default=Server=sqlserver;Database=MyDb;User Id=sa;Password=YourStr0ngPass;TrustServerCertificate=True
      - Redis__ConnectionString=redis:6379
    depends_on:
      sqlserver:
        condition: service_healthy
      redis:
        condition: service_started
    restart: unless-stopped

  sqlserver:
    image: mcr.microsoft.com/mssql/server:2022-latest
    container_name: myapi-sql
    environment:
      - ACCEPT_EULA=Y
      - MSSQL_SA_PASSWORD=YourStr0ngPass
    ports:
      - "1433:1433"
    volumes:
      - sqldata:/var/opt/mssql
    healthcheck:
      test: ["CMD-SHELL", "/opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P YourStr0ngPass -C -Q 'SELECT 1' || exit 1"]
      interval: 10s
      timeout: 5s
      retries: 10
      start_period: 20s

  redis:
    image: redis:7-alpine
    container_name: myapi-redis
    ports:
      - "6379:6379"

volumes:
  sqldata:

这份配置中有几个关键点值得展开说明。首先是网络别名机制：Compose会自动创建一个专属网络，同一网络内的容器可以通过服务名互相访问。所以C#应用里的连接字符串写的是Server=sqlserver而不是localhost，这一点是新手最常踩的坑，容器内的localhost指的是容器自己，不是宿主机。

其次是环境变量中的双下划线写法。ConnectionStrings__Default会被.NET的配置系统自动映射为ConnectionStrings:Default配置项，这是覆盖appsettings.json配置的标准方式，不需要修改任何代码就能在不同环境切换数据库地址。

最后是健康检查与服务依赖。SQL Server容器启动后需要十几秒才能接受连接，如果API容器直接启动就会连接失败。上面配置中给sqlserver服务定义了healthcheck，用sqlcmd执行一条查询命令判断数据库是否就绪，再通过depends_on的condition: service_healthy让API等到数据库真正可用后才启动。这个机制比单纯依赖启动顺序可靠得多。

三、启动、验证与日常运维命令

配置文件写好后，在docker-compose.yml所在目录执行docker compose up -d --build，Compose会自动拉取缺失镜像、构建API镜像、创建网络和卷，然后依次启动所有容器。-d表示后台运行，--build表示每次都重新构建应用镜像，开发阶段建议始终带上它，避免改动代码后跑的还是旧镜像。

启动完成后可以用几个常用命令检查状态。docker compose ps查看各容器状态是否为running或healthy；docker compose logs -f myapi实时跟踪API的输出日志，排查启动报错非常方便；docker compose exec sqlserver bash可以直接进入数据库容器内部执行命令。需要停止时用docker compose down，加上-v参数会同时删除数据卷，注意这会清空数据库数据，生产环境慎用。

验证服务是否正常，可以在宿主机上请求映射出来的端口，例如访问http://localhost:5000/health或任意一个业务接口。如果返回正常说明API、数据库、Redis整条链路已经通了。如果失败，优先用logs命令看报错信息，常见问题包括连接字符串写错服务名、SA密码不符合复杂度要求、健康检查命令路径不对等。

最后补充几个生产环境的实践建议。密码等敏感信息不要明文写在yml文件里，应该使用.env文件或Docker secrets管理，并把.env加入版本库忽略列表；镜像版本号尽量固定到具体版本而不是latest，避免某次重新部署时镜像升级引发兼容问题；对外端口只暴露必要的，Redis和数据库如果不需要外部访问可以去掉ports映射，只让内部网络访问，安全性会更好。掌握这些内容后，你就可以把C#项目的多容器部署完整地管理起来了。

C# Docker Compose多容器编排容器化部署修改时间：2026-09-02 12:46:35