windows本地开发环境搭建指南：Docker + 常用中间件一键部署

本文介绍如何在本地使用 Docker Desktop 快速搭建包含 MySQL、Redis、PostgreSQL、Nacos、Kafka 等常用中间件的开发环境。所有服务的数据与配置文件均持久化到本地删除容器后数据不丢失配置随时可改。目录一、安装 Docker Desktop二、可选汉化 Docker Desktop三、修改镜像存储目录四、配置镜像加速五、准备目录与配置文件六、拉取所需镜像七、编写 docker-compose.yml八、Nacos 数据库初始化可选九、初始化 PostgreSQL 配置文件十、启动服务十一、访问各服务一、安装 Docker Desktop前往官网下载并安装 https://www.docker.com/products/docker-desktop/二、可选汉化 Docker Desktop如需中文界面可参考以下步骤否则跳过此节。汉化包地址https://github.com/asxez/DockerDesktop-CN操作步骤关闭 Docker Desktop找到app.asar文件并先备份防止意外系统默认路径WindowsC:\Program Files\Docker\Docker\frontend\resourcesmacOS/Applications/Docker.app/Contents/MacOS/Docker Desktop.app/Contents/ResourcesUbuntu/Debian/opt/docker-desktop/resources将下载的汉化.asar文件重命名为app.asar替换原文件重启 Docker Desktop三、修改镜像存储目录Docker 默认将镜像存放在系统盘建议改到空间更大的磁盘。操作路径Docker Desktop → ⚙️ 设置 → Resources → Advanced → Disk image location将路径修改为目标目录例如D:\Docker\wsl\data四、配置镜像加速由于网络原因拉取镜像时可能较慢可配置国内镜像源。操作路径Docker Desktop → ⚙️ 设置 → Docker Engine在编辑器中粘贴以下配置{max-concurrent-downloads:5,max-concurrent-uploads:5,registry-mirrors:[https://docker.1ms.run,https://docker.xuanyuan.me,https://docker.m.daocloud.io,https://dockerpull.com]}点击Apply Restart使配置生效。五、准备目录与配置文件选择一个工作目录如D:\Docker后续所有操作均在此目录下进行。5.1 创建目录结构mkdirmysql\data mysql\conf.d redis\data redis\conf postgres\data postgres\conf kafka\data nacos\logs cloudbeaver\workspace5.2 创建 MySQL 配置文件在mysql/conf.d/下新建my.cnf[mysqld] # ── 字符集 ────────────────────────────── character-set-serverutf8mb4 collation-serverutf8mb4_unicode_ci # ── 连接 ──────────────────────────────── max_connections200 # 最大连接数 max_connect_errors10 # 同一客户端连续失败超过此次数则拒绝连接 wait_timeout28800 # 非交互连接空闲超时时间秒8小时 interactive_timeout28800 # 交互连接空闲超时时间秒8小时 # ── 时区 ──────────────────────────────── default-time-zone08:00 # ── InnoDB 存储引擎 ────────────────────── innodb_buffer_pool_size512M # 缓冲池大小建议设为可用内存的 50-70% innodb_log_file_size128M # redo log 文件大小影响写入性能 innodb_flush_log_at_trx_commit1 # 1每次提交刷盘最安全2性能好但断电可能丢1秒数据 innodb_file_per_table1 # 每张表独立 ibd 文件便于管理和回收空间 # ── 临时表 ────────────────────────────── tmp_table_size64M # 内存临时表最大大小 max_heap_table_size64M # 用户创建的内存表最大大小需与上面保持一致 # ── 慢查询日志 ─────────────────────────── slow_query_log1 # 开启慢查询日志 slow_query_log_file/var/log/mysql/slow.log long_query_time2 # 超过 2 秒的查询记录到慢日志 log_queries_not_using_indexes1 # 未走索引的查询也记录到慢日志 general_log0 # 记录所有 SQL调试时可设为 1生产禁用 # ── 二进制日志用于数据恢复 / 主从复制── log_binmysql-bin # 开启 binlog文件名前缀 binlog_formatROW # ROW 模式记录行变更最安全 expire_logs_days7 # binlog 保留 7 天后自动清理 [client] default-character-setutf8mb4 [mysql] default-character-setutf8mb45.3 创建 Redis 配置文件在redis/conf/下新建redis.conf# ── 网络 ──────────────────────────────── bind 0.0.0.0 # 绑定所有网卡容器内必须 port 6379 # 监听端口 timeout 0 # 客户端空闲多少秒后断开0 表示不断开 tcp-keepalive 300 # TCP keepalive 心跳间隔秒 # ── 认证 ──────────────────────────────── requirepass 123456 # 访问密码 # ── 内存 ──────────────────────────────── maxmemory 512mb # 最大内存按实际机器情况调整 maxmemory-policy allkeys-lru # 内存满时淘汰策略优先删除最久未使用的 key # 常用策略说明 # noeviction 不淘汰内存满时写入直接报错默认值 # allkeys-lru 所有 key 中淘汰最久未使用的推荐缓存场景 # volatile-lru 只淘汰设置了过期时间的 key 中最久未使用的 # allkeys-random 随机淘汰任意 key # volatile-ttl 优先淘汰剩余过期时间最短的 key # ── 持久化RDB 快照 ───────────────────── save 900 1 # 900 秒内有 1 次写操作则触发快照 save 300 10 # 300 秒内有 10 次写操作则触发快照 save 60 10000 # 60 秒内有 10000 次写操作则触发快照 dbfilename dump.rdb # RDB 文件名 dir /data # 数据文件存储目录对应容器内挂载路径 # ── 持久化AOF 日志 ───────────────────── appendonly yes # 开启 AOF比 RDB 更安全推荐开启 appendfilename appendonly.aof # AOF 文件名 appendfsync everysec # 每秒刷盘一次兼顾性能和安全 no-appendfsync-on-rewrite no # AOF 重写期间是否暂停刷盘no 表示不暂停 auto-aof-rewrite-percentage 100 # AOF 文件比上次重写后增长 100% 时触发重写 auto-aof-rewrite-min-size 64mb # AOF 文件至少达到 64MB 才触发重写 # ── 慢查询日志 ─────────────────────────── slowlog-log-slower-than 10000 # 记录执行超过 10ms10000 微秒的命令 slowlog-max-len 128 # 慢日志最多保留 128 条 # ── 日志 ──────────────────────────────── loglevel notice # 日志级别debug / verbose / notice / warning logfile # 空字符串表示输出到标准输出容器内推荐 # ── 其他 ──────────────────────────────── databases 16 # 数据库数量默认 16 个db0 ~ db15 hz 10 # 后台任务执行频率影响过期 key 清理速度5.4 PostgreSQL 配置文件说明PostgreSQL 的配置文件在数据库首次初始化时自动生成无法提前手动创建。需要先启动容器再将配置文件复制到本地详见 第九节。完成后目录结构如下PostgreSQL 配置文件在第九步补充dev-docker/ ├── mysql/ │ ├── data/ # MySQL 数据持久化 │ └── conf.d/ │ └── my.cnf # ✅ MySQL 自定义配置 ├── redis/ │ ├── data/ # Redis 持久化数据 │ └── conf/ │ └── redis.conf # ✅ Redis 自定义配置 ├── postgres/ │ ├── data/ # PostgreSQL 数据持久化 │ └── conf/ # ⏳ 第九步从容器复制配置文件到此处 ├── kafka/ │ └── data/ # Kafka 日志数据 ├── nacos/ │ └── logs/ # Nacos 运行日志 ├── cloudbeaver/ │ └── workspace/ # CloudBeaver 工作区 ├── mysql-schema.sql # Nacos 初始化 SQL可选见第八节 └── docker-compose.yml六、拉取所需镜像可以在 https://hub.docker.com/ 查询最新版本。执行以下命令拉取本文所用镜像dockerpull mysql:8.0dockerpull redis:7-alpinedockerpull postgres:16dockerpull nacos/nacos-server:v2.4.0dockerpull confluentinc/cp-kafka:8.1.2dockerpull dbeaver/cloudbeaver:latestdockerpull prom/node-exporter:latest七、编写 docker-compose.yml在工作目录下创建docker-compose.yml内容如下services:# MySQL 数据库 (8.0 版本) mysql:image:mysql:8.0# 使用官方 MySQL 8.0 镜像container_name:mysql-dev# 容器名称设置为 mysql-devrestart:unless-stopped# 除非手动停止否则容器崩溃或 Docker 重启后自动拉起environment:# 设置环境变量MYSQL_ROOT_PASSWORD:123456# 设置 root 用户的初始密码MYSQL_DATABASE:nacos_config# 容器启动时自动创建名为 nacos_config 的数据库ports:# 端口映射-3306:3306# 将宿主机 3306 映射到容器 3306 端口volumes:# 挂载卷配置-./mysql/data:/var/lib/mysql# 将数据库数据持久化到本地目录防止容器删除后数据丢失-./mysql/conf.d:/etc/mysql/conf.d# 挂载本地配置目录用于存放自定义的 .cnf 配置文件-./mysql-schema.sql:/docker-entrypoint-initdb.d/nacos-mysql.sql# 自动初始化脚本容器首次启动时会执行此 SQLcommand:--default-authentication-pluginmysql_native_password# 启动参数使用传统密码认证插件以兼容旧版客户端healthcheck:# 健康检查供其他服务依赖判断test:[CMD,mysqladmin,ping,-h,localhost,-u,root,-p123456]# 检查命令尝试 ping 数据库interval:10s# 每隔 10 秒检查一次timeout:5s# 检查超时时间为 5 秒retries:5# 连续失败 5 次后认为容器不健康# Nacos 注册中心/配置中心 nacos:image:nacos/nacos-server:v2.4.0# 使用 Nacos 2.4.0 官方镜像container_name:nacos-dev# 容器名称restart:unless-stopped# 自动重启策略depends_on:# 服务依赖mysql:# 依赖 mysql 服务condition:service_healthy# 必须等 mysql 健康检查通过后再启动 nacosenvironment:# Nacos 运行时配置项MODE:standalone# 运行模式单机模式SPRING_DATASOURCE_PLATFORM:mysql# 指定外部数据源类型为 mysqlMYSQL_SERVICE_HOST:mysql-dev# MySQL 的主机名对应上面的容器名MYSQL_SERVICE_PORT:3306# MySQL 端口MYSQL_SERVICE_DB_NAME:nacos_config# Nacos 使用的数据库名MYSQL_SERVICE_USER:root# 数据库用户名MYSQL_SERVICE_PASSWORD:123456# 数据库密码NACOS_AUTH_IDENTITY_KEY:nacos# 开启鉴权后的身份标识 keyNACOS_AUTH_IDENTITY_VALUE:nacos# 开启鉴权后的身份标识 valueNACOS_AUTH_TOKEN:SecretKey012345678901234567890123456789012345678901234567890123456789# 鉴权使用的 Token 密钥ports:# 端口映射-8848:8848# Nacos 控制台 Web 访问端口-9848:9848# Nacos 2.x 版本的客户端 gRPC 通信端口-9849:9849# Nacos 2.x 版本的服务端 gRPC 通信端口volumes:# 挂载卷-./nacos/logs:/home/nacos/logs# 将容器内的日志挂载到本地方便排查问题# Redis 缓存 redis:image:redis:7-alpine# 使用轻量级的 Redis 7 (Alpine Linux) 镜像container_name:redis-dev# 容器名称restart:unless-stopped# 自动重启策略ports:# 端口映射-6379:6379# 映射默认 6379 端口volumes:# 挂载卷-./redis/data:/data# 持久化 Redis 数据库文件-./redis/conf/redis.conf:/etc/redis/redis.conf# 挂载本地配置文件到容器内command:redis-server /etc/redis/redis.conf# 指定使用挂载的配置文件启动 Redishealthcheck:# 健康检查test:[CMD,redis-cli,-a,123456,ping]# 检查命令使用密码 123456 执行 pinginterval:10s# 每 10 秒检查一次timeout:3s# 超时时间 3 秒retries:3# 失败 3 次标记为不健康# PostgreSQL 数据库 postgres:image:postgres:16# 使用官方 PostgreSQL 16 镜像container_name:postgres-dev# 容器名称restart:unless-stopped# 自动重启策略environment:# 环境变量POSTGRES_PASSWORD:123456# 设置超级用户 postgres 的密码ports:# 端口映射-5432:5432# 映射默认 5432 端口volumes:# 挂载卷-./postgres/data:/var/lib/postgresql/data# 持久化 PG 数据库数据-./postgres/conf/postgresql.conf:/etc/postgresql/postgresql.conf# 挂载主配置文件-./postgres/conf/pg_hba.conf:/etc/postgresql/pg_hba.conf# 挂载访问控制配置文件command:postgres-c config_file/etc/postgresql/postgresql.conf# 启动参数指定配置文件路径healthcheck:# 健康检查test:[CMD-SHELL,pg_isready -U postgres]# 使用内置命令 pg_isready 检查连通性interval:10s# 每 10 秒检查timeout:5s# 超时时间 5 秒retries:5# 失败重试次数# CloudBeaver (Web 版数据库管理工具) cloudbeaver:image:dbeaver/cloudbeaver:latest# 使用 DBeaver 官方出品的 Web 版镜像container_name:cloudbeaver# 容器名称restart:unless-stopped# 自动重启策略ports:# 端口映射-8978:8978# Web 访问地址为 http://localhost:8978volumes:# 挂载卷-./cloudbeaver/workspace:/opt/cloudbeaver/workspace# 持久化保存用户的数据库连接配置和 SQL 脚本# Kafka 消息队列 (KRaft 模式) kafka:image:confluentinc/cp-kafka:8.1.2# 使用 Confluent 提供的 Kafka 镜像container_name:kafka-dev# 容器名称restart:unless-stopped# 自动重启策略ports:# 端口映射-9092:9092# 映射外部客户端访问端口volumes:# 挂载卷-./kafka/data:/var/lib/kafka/data# 持久化 Kafka 消息数据environment:# Kafka 环境变量KRaft 模式配置KAFKA_NODE_ID:1# 节点 IDKAFKA_PROCESS_ROLES:broker,controller# 本节点同时担任消息代理(broker)和控制器(controller)KAFKA_CONTROLLER_QUORUM_VOTERS:1kafka-dev:9093# 集群控制器投票者配置KAFKA_LISTENERS:PLAINTEXT://0.0.0.0:9092,CONTROLLER://0.0.0.0:9093# 定义内部和外部监听器KAFKA_ADVERTISED_LISTENERS:PLAINTEXT://localhost:9092# 暴露给宿主机的地址Windows 本地代码连接用 localhostKAFKA_LISTENER_SECURITY_PROTOCOL_MAP:CONTROLLER:PLAINTEXT,PLAINTEXT:PLAINTEXT# 定义监听器的协议映射KAFKA_CONTROLLER_LISTENER_NAMES:CONTROLLER# 指定控制器监听器名称KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR:1# 偏移量主题副本数单机设为 1KAFKA_TRANSACTION_STATE_LOG_MIN_ISR:1# 事务日志最小同步副本数KAFKA_TRANSACTION_STATE_LOG_REPLICATION_FACTOR:1# 事务日志副本数KAFKA_LOG_DIRS:/var/lib/kafka/data# 消息日志存储目录healthcheck:# 健康检查test:[CMD-SHELL,kafka-topics --bootstrap-server localhost:9092 --list]# 检查命令尝试列出 topicinterval:15s# 每 15 秒检查一次timeout:10s# 超时时间 10 秒retries:5# 失败重试次数start_period:30s# 容器启动后等待 30 秒再开始检查Kafka 启动慢# Node Exporter (指标采集) node-exporter:image:prom/node-exporter:latest# 使用 Prometheus 官方节点采集镜像container_name:node-exporter# 容器名称restart:unless-stopped# 自动重启策略ports:# 端口映射-9100:9100# 暴露指标采集端口Prometheus 可通过该端口抓取数据# 网络配置 networks:default:# 默认网络配置name:dev-network# 自定义网络名称为 dev-network所有服务均在此网络下八、Nacos 数据库初始化可选如果只是简单体验 Nacos可跳过此步Nacos 将使用内置的 Derby 数据库但重启后配置不会持久化。若需要配置持久化到 MySQL则必须执行此步骤。步骤前往 https://github.com/alibaba/nacos/releases 下载与镜像版本一致的 Nacos Server 安装包本文为 v2.4.0解压后在conf/目录中找到mysql-schema.sql将该文件复制到工作目录与docker-compose.yml同级命名为mysql-schema.sqlMySQL 容器首次启动时会自动执行该 SQL 脚本完成初始化。如果不使用 MySQL 持久化记得删除或注释掉docker-compose.yml中 MySQL 的 SQL 挂载行以及 Nacos 的数据源相关环境变量# MySQL volumes 中注释掉# - ./mysql-schema.sql:/docker-entrypoint-initdb.d/nacos-mysql.sql# Nacos environment 中注释掉# SPRING_DATASOURCE_PLATFORM: mysql# MYSQL_SERVICE_HOST: mysql-dev# ...九、初始化 PostgreSQL 配置文件由于 PostgreSQL 的配置文件在数据库首次初始化时自动生成需要先临时启动 PostgreSQL将配置文件复制到本地再完整启动所有服务。第一步临时注释配置文件挂载将docker-compose.yml中 PostgreSQL 的配置文件挂载和 command 行临时注释掉postgres:...volumes:-./postgres/data:/var/lib/postgresql/data# - ./postgres/conf/postgresql.conf:/etc/postgresql/postgresql.conf # 暂时注释# - ./postgres/conf/pg_hba.conf:/etc/postgresql/pg_hba.conf # 暂时注释# command: postgres -c config_file/etc/postgresql/postgresql.conf # 暂时注释单独启动 PostgreSQLdocker-composeup-dpostgres第二步复制配置文件到本地等待容器启动后执行dockercppostgres-dev:/var/lib/postgresql/data/postgresql.conf ./postgres/conf/postgresql.confdockercppostgres-dev:/var/lib/postgresql/data/pg_hba.conf ./postgres/conf/pg_hba.conf第三步恢复配置并重启将docker-compose.yml中刚才注释掉的三行取消注释恢复为完整配置然后重建 PostgreSQL 容器docker-composeup-dpostgres此后 PostgreSQL 将读取本地的配置文件启动。如需调整配置直接编辑postgres/conf/postgresql.conf并重启容器即可。十、启动服务完成以上所有准备工作后在工作目录下执行# 后台启动所有服务docker-composeup-d# 查看各服务运行状态docker-composeps# 查看某个服务的日志以 nacos 为例docker-composelogs-fnacos停止服务# 停止并保留数据docker-composedown# 停止并清除所有数据卷慎用数据将丢失docker-composedown-v十一、访问各服务服务访问地址账号 / 密码CloudBeaverWeb 数据库管理http://localhost:8978首次启动自行设置Nacos配置 注册中心http://localhost:8848/nacosnacos / nacosMySQLlocalhost:3306root / 123456Redislocalhost:6379密码123456PostgreSQLlocalhost:5432postgres / 123456Kafkalocalhost:9092无认证Node Exporter监控指标http://localhost:9100/metrics无附持久化总览服务本地数据目录本地配置文件MySQLmysql/data/mysql/conf.d/my.cnfRedisredis/data/redis/conf/redis.confPostgreSQLpostgres/data/postgres/conf/postgresql.conf/pg_hba.confKafkakafka/data/通过环境变量配置无独立文件Nacos—通过环境变量配置日志在nacos/logs/CloudBeavercloudbeaver/workspace/—附常用 Docker 命令速查# 查看所有运行中的容器dockerps# 进入容器内部以 mysql-dev 为例dockerexec-itmysql-devbash# 查看容器日志dockerlogs-f容器名# 修改配置后重启某个服务docker-composerestart服务名# compose 文件有改动时重新创建并启动某个服务docker-composeup-d服务名提示所有数据与配置文件均已挂载到本地目录删除容器不会导致数据丢失。如需彻底重置某个服务停止容器后手动清空对应的data/目录再重新启动即可。附更换电脑数据完整迁移由于数据和配置全部在本地工作目录中迁移的核心就是复制这个目录。旧电脑打包迁移先停止所有服务确保数据完整写入磁盘docker-composedown然后将整个工作目录打包通过移动硬盘或网盘传输到新电脑。如果新电脑网络不好可以顺带导出镜像一并带走dockersave\mysql:8.0 redis:7-alpine postgres:16\nacos/nacos-server:v2.4.0 confluentinc/cp-kafka:8.1.2\dbeaver/cloudbeaver:latest prom/node-exporter:latest\-oall-images.tar新电脑恢复启动安装 Docker Desktop参考本文第一至四节完成基础配置将工作目录解压到目标路径建议与旧电脑路径一致无需改任何配置导入镜像如果导出了的话或直接重新docker pull# 离线导入dockerload-iall-images.tar# 或重新拉取dockerpull mysql:8.0dockerpull redis:7-alpine# ...进入工作目录直接启动docker-composeup-d各服务会直接读取原来的数据目录和配置文件启动后数据与迁移前完全一致。注意Nacos 如果使用的是内置 Derby 数据库非 MySQL 持久化模式配置数据存储在容器内部迁移前需在 Nacos 控制台手动导出配置到新环境后再导入。使用 MySQL 持久化模式则无此问题数据随 MySQL 一起迁移。