Windows 环境下使用 Docker 部署 Java 开发中间件指南

点击 "Apply & Restart" 应用配置。

2.2 启用 WSL2 后端（推荐）

WSL2 提供了更好的性能和 Linux 兼容性：

# 启用 WSL
wsl --install
# 设置 WSL2 为默认版本
wsl --set-default-version 2
# 在 Docker Desktop 中启用 WSL2
# Settings → General → Use WSL 2 based engine

三、Java 开发常用中间件部署

3.1 数据库服务

MySQL 8.0 部署：

# PowerShell 中运行（注意反引号续行）
docker run -d --name mysql `
  -e MYSQL_ROOT_PASSWORD=123456 `
  -p 3306:3306 `
  -v mysql_data:/var/lib/mysql `
  -e MYSQL_DATABASE=testdb `
  mysql:8.0

# 连接到 MySQL
docker exec -it mysql mysql -uroot -p123456

Redis 7.0 部署：

docker run -d --name redis `
  -p 6379:6379 `
  -v redis_data:/data `
  redis:7-alpine `
  redis-server --requirepass 123456 --appendonly yes

# Redis 客户端连接测试
docker exec -it redis redis-cli -a 123456 ping

PostgreSQL 15 部署：

docker run -d --name postgres `
  -e POSTGRES_PASSWORD=123456 `
  -p 5432:5432 `
  -v postgres_data:/var/lib/postgresql/data `
  postgres:15

# 创建数据库
docker exec -it postgres createdb -U postgres mydb

3.2 微服务生态组件

Nacos 2.x（服务发现 + 配置中心）：

docker run -d --name nacos `
  -p 8848:8848 -p 9848:9848 -p 9849:9849 `
  -e MODE=standalone `
  -e PREFER_HOST_MODE=hostname `
  -e SPRING_DATASOURCE_PLATFORM=embedded `
  nacos/nacos-server:v2.2.3

# 访问地址：http://localhost:8848/nacos
# 默认账号：nacos/nacos

RabbitMQ 3.12（消息队列）：

docker run -d --name rabbitmq `
  -p 5672:5672 -p 15672:15672 `
  -p 25672:25672 -p 61613:61613 `
  -e RABBITMQ_DEFAULT_USER=admin `
  -e RABBITMQ_DEFAULT_PASS=admin `
  rabbitmq:3.12-management

# 访问管理界面：http://localhost:15672

MinIO（对象存储，兼容 S3）：

docker run -d --name minio `
  -p 9000:9000 -p 9001:9001 `
  -e MINIO_ROOT_USER=admin `
  -e MINIO_ROOT_PASSWORD=admin123456 `
  -v minio_data:/data `
  minio/minio server /data --console-address ":9001"

# API 端点：http://localhost:9000
# 控制台：http://localhost:9001

3.3 监控与日志

Prometheus + Grafana 监控：

# 创建配置文件 prometheus.yml
@" global:
  scrape_interval: 15s
  scrape_configs:
    - job_name: 'prometheus'
      static_configs:
        - targets: ['localhost:9090']
"@ | Out-File -FilePath prometheus.yml -Encoding UTF8

# 启动 Prometheus
docker run -d --name prometheus `
  -p 9090:9090 `
  -v ${PWD}/prometheus.yml:/etc/prometheus/prometheus.yml `
  prom/prometheus

# 启动 Grafana
docker run -d --name grafana `
  -p 3000:3000 `
  -e GF_SECURITY_ADMIN_PASSWORD=admin `
  grafana/grafana

Elasticsearch + Kibana（ELK 日志系统）：

# Elasticsearch
docker run -d --name elasticsearch `
  -p 9200:9200 -p 9300:9300 `
  -e "discovery.type=single-node" `
  -e "xpack.security.enabled=false" `
  -e "ES_JAVA_OPTS=-Xms512m -Xmx512m" `
  elasticsearch:8.10.0

# Kibana
docker run -d --name kibana `
  -p 5601:5601 `
  -e ELASTICSEARCH_HOSTS=http://localhost:9200 `
  kibana:8.10.0

四、使用 Docker Compose 编排服务

对于复杂的多容器应用，推荐使用 Docker Compose 进行编排。

4.1 创建 docker-compose.yml

version: '3.8'
services:
  # MySQL 数据库
  mysql:
    image: mysql:8.0
    container_name: dev-mysql
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: 123456
      MYSQL_DATABASE: appdb
      TZ: Asia/Shanghai
    ports:
      - "3306:3306"
    volumes:
      - mysql_data:/var/lib/mysql
      - ./mysql/init:/docker-entrypoint-initdb.d
    networks:
      - dev-network
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      timeout: 20s
      retries: 10

  # Redis 缓存
  redis:
    image: redis:7-alpine
    container_name: dev-redis
    restart: unless-stopped
    command: redis-server --requirepass 123456 --appendonly yes
    ports:
      - "6379:6379"
    volumes:
      - redis_data:/data
    networks:
      - dev-network
    healthcheck:
      test: ["CMD", "redis-cli", "-a", "123456", "ping"]
      interval: 10s
      timeout: 5s
      retries: 5

  # Nacos 服务注册中心
  nacos:
    image: nacos/nacos-server:v2.2.3
    container_name: dev-nacos
    restart: unless-stopped
    environment:
      MODE: standalone
      PREFER_HOST_MODE: hostname
      SPRING_DATASOURCE_PLATFORM: embedded
    ports:
      - "8848:8848"
      - "9848:9848"
      - "9849:9849"
    networks:
      - dev-network
    depends_on:
      mysql:
        condition: service_healthy

  # RabbitMQ 消息队列
  rabbitmq:
    image: rabbitmq:3.12-management
    container_name: dev-rabbitmq
    restart: unless-stopped
    environment:
      RABBITMQ_DEFAULT_USER: admin
      RABBITMQ_DEFAULT_PASS: admin
    ports:
      - "5672:5672"
      - "15672:15672"
    volumes:
      - rabbitmq_data:/var/lib/rabbitmq
    networks:
      - dev-network

  # RedisInsight 管理界面
  redisinsight:
    image: redislabs/redisinsight:latest
    container_name: dev-redisinsight
    restart: unless-stopped
    ports:
      - "5540:5540"
    volumes:
      - redisinsight_data:/db
    networks:
      - dev-network

networks:
  dev-network:
    driver: bridge
    name: java-dev-network

volumes:
  mysql_data:
  redis_data:
  rabbitmq_data:
  redisinsight_data:

4.2 启动和管理服务

# 1. 创建项目目录
mkdir C:\java-dev-env
cd C:\java-dev-env

# 2. 创建 docker-compose.yml
# 将上面的内容保存为 docker-compose.yml

# 3. 启动所有服务
docker-compose up -d

# 4. 查看运行状态
docker-compose ps

# 5. 查看日志
docker-compose logs -f mysql
docker-compose logs -f nacos

# 6. 停止服务
docker-compose down

# 7. 停止并清理数据
docker-compose down -v

五、Windows 特有技巧和注意事项

5.1 路径问题处理

Windows 和 Linux 的路径格式不同，在挂载卷时需要特别注意：

# ❌ 错误：直接使用 Windows 路径
docker run -v C:\Users\test\data:/data...

# ✅ 正确：使用 Docker Desktop 共享驱动器
# 1. 在 Docker Desktop Settings → Resources → File Sharing
# 2. 添加 C:\Users（或你的工作目录）
# 3. 然后使用以下格式：

# 方式一：使用 /c/ 前缀
docker run -v /c/Users/test/data:/data...

# 方式二：在 WSL2 环境中使用
# 先将项目放在 WSL2 文件系统中
docker run -v /home/username/project/data:/data...

5.2 端口冲突解决

# 查看端口占用
netstat -ano | findstr :3306

# 结束占用进程
taskkill /PID 进程号 /F

# 或者在 docker-compose 中修改端口映射
# mysql:
#   ports:
#     - "3307:3306" # 将主机端口改为 3307

5.3 资源限制配置

在 Docker Desktop Settings → Resources 中：

• 分配适当的 CPU 和内存
• 配置磁盘镜像大小
• 设置 WSL 集成

六、快速启动脚本

6.1 PowerShell 启动脚本（start-dev.ps1）

# 开发环境快速启动脚本
param([switch]$Help = $false, [string]$Profile = "basic")

if ($Help) {
  Write-Host "用法： .\start-dev.ps1 [-Profile basic|full|monitor]" -ForegroundColor Cyan
  Write-Host " -Profile basic: 基础服务 (MySQL+Redis)" -ForegroundColor Yellow
  Write-Host " -Profile full: 完整服务 (基础+Nacos+MQ)" -ForegroundColor Yellow
  Write-Host " -Profile monitor: 监控服务 (Prometheus+Grafana)" -ForegroundColor Yellow
  exit
}

function Start-Services {
  param([string]$composeFile)
  Write-Host "正在启动服务..." -ForegroundColor Green
  docker-compose -f $composeFile up -d
  if ($LASTEXITCODE -eq 0) {
    Write-Host "服务启动成功！" -ForegroundColor Green
    docker-compose -f $composeFile ps
  } else {
    Write-Host "服务启动失败，请检查配置" -ForegroundColor Red
  }
}

Write-Host "Java 开发环境启动器" -ForegroundColor Cyan
Write-Host "======================" -ForegroundColor Cyan

switch ($Profile) {
  "basic" {
    Write-Host "启动基础服务..." -ForegroundColor Yellow
    Start-Services "docker-compose-basic.yml"
  }
  "full" {
    Write-Host "启动完整开发环境..." -ForegroundColor Yellow
    Start-Services "docker-compose-full.yml"
  }
  "monitor" {
    Write-Host "启动监控服务..." -ForegroundColor Yellow
    Start-Services "docker-compose-monitor.yml"
  }
  default {
    Write-Host "使用默认配置启动基础服务..." -ForegroundColor Yellow
    Start-Services "docker-compose.yml"
  }
}

Write-Host "`n 服务访问地址：" -ForegroundColor Cyan
Write-Host "MySQL: localhost:3306 (root/123456)" -ForegroundColor Yellow
Write-Host "Redis: localhost:6379 (密码:123456)" -ForegroundColor Yellow
Write-Host "Nacos: http://localhost:8848/nacos (nacos/nacos)" -ForegroundColor Yellow
Write-Host "RabbitMQ: http://localhost:15672 (admin/admin)" -ForegroundColor Yellow
Write-Host "RedisInsight: http://localhost:5540" -ForegroundColor Yellow

七、常见问题排查

7.1 Docker Desktop 无法启动

• 问题：Docker Desktop 启动失败

解决：

# 以管理员运行 PowerShell
# 重启 Docker 服务
net stop com.docker.service
net start com.docker.service

# 或重置 Docker
& 'C:\Program Files\Docker\Docker\DockerCli.exe' -SwitchDaemon

7.2 容器启动缓慢

• 问题：容器启动特别慢

解决：

1. 检查是否开启了杀毒软件实时防护
2. 在 Docker Desktop 中增加资源分配
3. 确保使用 WSL2 后端
4. 清理 Docker 缓存：

docker system prune -a

7.3 网络连接问题

• 问题：容器间无法通信

解决：

# 检查网络
docker network ls
docker network inspect 网络名

# 使用自定义网络
docker network create my-network
docker run --network=my-network ...

八、生产环境注意事项

虽然本文主要针对开发环境，但了解生产环境的最佳实践也很重要：

1. 安全配置：不要使用默认密码，启用 TLS/SSL
2. 数据备份：定期备份 Volume 数据
3. 监控告警：配置容器监控和告警
4. 资源限制：设置 CPU 和内存限制
5. 日志管理：配置日志轮转和集中收集
6. 镜像管理：使用私有镜像仓库，扫描安全漏洞

总结

Windows 平台上的 Docker 开发环境已经相当成熟，通过 Docker Desktop 配合 WSL2，可以获得接近 Linux 的开发体验。本文介绍的中间件部署方案覆盖了 Java 开发中的常见需求，从数据库到消息队列，从服务注册到监控系统，基本可以满足大部分项目的开发需求。

通过使用 Docker Compose 进行服务编排，我们可以轻松地管理复杂的多容器应用，实现一键启动、统一管理。希望这篇指南能帮助你在 Windows 上搭建高效的 Java 开发环境。

最后的小贴士：

• 定期更新 Docker 和基础镜像
• 使用 .dockerignore 文件优化构建
• 为不同项目创建独立的网络
• 使用 Docker 的日志驱动功能
• 考虑使用 Portainer 进行可视化管理