1. Windows 11 运行 Docker Compose 环境准备在 Windows 11 上运行 Docker Compose 需要先完成基础环境配置。不同于 Linux 或 macOS 系统Windows 平台需要特别注意以下组件兼容性问题1.1 系统版本要求必须使用 Windows 11 专业版/企业版/教育版家庭版不支持 Hyper-V系统版本需为 21H2 或更高确保 BIOS 中已开启虚拟化技术Intel VT-x/AMD-V验证方法任务管理器 → 性能选项卡 → 查看虚拟化是否启用1.2 安装 WSL 2Windows Subsystem for Linux 2 是 Docker Desktop 的依赖项安装步骤如下# 启用WSL功能 dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart # 启用虚拟机平台 dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart # 下载并安装WSL2内核更新包 # 下载地址https://aka.ms/wsl2kernel # 设置WSL2为默认版本 wsl --set-default-version 21.3 安装 Docker Desktop从官网下载 Docker Desktop for Windows 安装包安装时勾选以下选项Install required Windows components for WSL 2Add shortcut to desktop安装完成后需重启系统2. Docker Compose 配置与优化2.1 基础配置文件示例创建docker-compose.yml文件示例version: 3.8 services: web: image: nginx:alpine ports: - 8080:80 volumes: - ./html:/usr/share/nginx/html networks: - app-network db: image: postgres:13 environment: POSTGRES_PASSWORD: example volumes: - postgres_data:/var/lib/postgresql/data networks: - app-network volumes: postgres_data: networks: app-network: driver: bridge2.2 Windows 特有配置项在 Windows 上需要特别注意的配置参数services: app: # Windows路径需要双反斜杠或正斜杠 volumes: - C:\\Users\\user\\data:/data - /c/Users/user/config:/config # 处理Windows换行符问题 environment: - SHELL/bin/bash - PWD/app2.3 性能优化建议将项目文件存储在 WSL 2 文件系统中\\wsl$在 Docker Desktop 设置中分配至少 4GB 内存启用 WSL 2 后端关闭 Windows 防火墙对 Docker 的限制对于数据库类服务建议db: deploy: resources: limits: cpus: 2 memory: 2G3. 常见问题解决方案3.1 端口冲突处理当出现端口占用错误时# 查找占用端口的进程 netstat -ano | findstr :8080 # 终止对应进程 taskkill /PID 进程ID /F3.2 文件权限问题Windows 和 Linux 文件系统权限差异解决方案在 docker-compose.yml 中添加services: app: user: 1000:1000 # 匹配WSL中的用户UID/GID或者在 Dockerfile 中统一权限RUN chown -R www-data:www-data /var/www3.3 启动速度优化使用.dockerignore文件排除不必要的文件采用多阶段构建减少镜像体积对于开发环境可以挂载源代码目录services: app: volumes: - .:/app # 避免node_modules被覆盖 - /app/node_modules4. 高级应用场景4.1 多环境配置管理使用扩展字段管理不同环境# docker-compose.yml services: app: extends: file: common-services.yml service: app-base # common-services.yml services: app-base: build: . environment: - NODE_ENVdevelopment4.2 GPU 加速支持在 Windows 11 上启用容器 GPU 加速安装 NVIDIA 容器工具包修改配置services: ai-service: deploy: resources: reservations: devices: - driver: nvidia count: 1 capabilities: [gpu]4.3 CI/CD 集成在 GitHub Actions 中的典型配置jobs: build: runs-on: windows-latest steps: - uses: actions/checkoutv2 - run: docker-compose -f docker-compose.ci.yml build - run: docker-compose -f docker-compose.ci.yml up -d - run: docker-compose exec -T app npm test提示Windows 容器与 Linux 容器模式切换时需要重新启动 Docker 服务
