Docker Compose 本地环境搭建:独立 Compose + 共享网络 + .env 统一管理(架构设计篇)

Docker Compose 本地环境搭建:独立 Compose + 共享网络 + .env 统一管理(架构设计篇)

  • [🔗 前言:Docker Compose 本地环境搭建相关文章](#🔗 前言:Docker Compose 本地环境搭建相关文章)
  • [🐳 Docker Compose 本地环境搭建:独立 Compose + 共享网络 + .env 统一管理(架构设计篇)](#🐳 Docker Compose 本地环境搭建:独立 Compose + 共享网络 + .env 统一管理(架构设计篇))

🔗 前言:Docker Compose 本地环境搭建相关文章


🐳 Docker Compose 本地环境搭建:独立 Compose + 共享网络 + .env 统一管理(架构设计篇)

一、背景说明

在日常开发或测试环境中,我们通常会依赖多个基础服务,例如:

  • MySQL
  • Redis
  • Elasticsearch
  • Nacos
  • SkyWalking

如果把所有服务全部写在一个 docker-compose.yml 中,会带来几个问题:

  • ❌ 文件臃肿,不易维护
  • ❌ 服务之间强耦合
  • ❌ 无法按需启动/停止
  • ❌ 团队协作困难

因此,本篇文章介绍一种更清晰、可扩展的方式:

独立 Compose + 共享网络 + 统一 env 管理


二、整体设计思路

核心思想分为三点:

1️⃣ 服务拆分(按模块独立)

每一个基础服务使用独立的 docker-compose.yml:

  • MySQL 单独一个 compose
  • Redis 单独一个 compose
  • Elasticsearch 单独一个 compose

👉 好处:

  • 可以单独启动某个服务
  • 方便定位问题
  • 配置清晰

2️⃣ 统一环境变量(.env)

所有服务共享一个 .env 文件:

👉 好处:

  • 避免重复配置
  • 修改一次,全局生效
  • 方便统一端口、账号、路径等

3️⃣ 共享网络(关键设计)

所有服务加入同一个 Docker 网络,例如:

bash 复制代码
dev-network

👉 好处:

  • 服务之间可以通过 容器名互相访问
  • 避免使用 IP
  • 更贴近生产环境

三、目录结构设计

推荐使用如下结构:

bash 复制代码
infra/
├── .env

├── mysql/
│   └── docker-compose.yml

├── redis/
│   └── docker-compose.yml

├── elasticsearch/
│   └── docker-compose.yml

├── skywalking/
│   └── docker-compose.yml

├── nacos/
│   └── docker-compose.yml

四、.env 文件设计(核心)

.env 是整个架构的核心配置入口。

示例:

env 复制代码
# =========================
# 通用配置
# =========================
COMPOSE_PROJECT_NAME=infra
DOCKER_NETWORK=dev-network

# =========================
# MySQL
# =========================
MYSQL_ROOT_PASSWORD=123456
MYSQL_PORT=3306
MYSQL_DATA_DIR=./data/mysql

# =========================
# Redis
# =========================
REDIS_PORT=6379
REDIS_PASSWORD=123456

# =========================
# Elasticsearch
# =========================
ES_PORT=9200
ES_JAVA_OPTS=-Xms512m -Xmx512m

# =========================
# Nacos
# =========================
NACOS_PORT=8848

# =========================
# SkyWalking
# =========================
SW_OAP_PORT=11800
SW_UI_PORT=8080

五、共享网络创建

在使用之前,需要手动创建网络(只需一次):

bash 复制代码
docker network create dev-network

⚠️ 注意:所有 compose 都必须引用这个网络


六、Compose 文件的统一规范(约定)

虽然每个服务的 docker-compose.yml 不同,但建议统一规范:

1️⃣ 引入 env 文件

yaml 复制代码
env_file:
  - ../.env

2️⃣ 使用统一网络

yaml 复制代码
networks:
  default:
    external: true
    name: ${DOCKER_NETWORK}

3️⃣ 服务命名规范

yaml 复制代码
services:
  mysql:
  redis:
  elasticsearch:

👉 建议直接使用服务名作为容器 DNS 名


4️⃣ 端口、路径统一从 env 获取

yaml 复制代码
ports:
  - "${MYSQL_PORT}:3306"

七、启动方式(推荐)

每个服务独立启动:

bash 复制代码
cd mysql
docker compose --env-file ../.env up -d

cd ../redis
docker compose --env-file ../.env up -d

👉 优点:

  • 按需启动
  • 控制粒度更细

八、服务访问方式

在同一网络下:

服务 访问方式
MySQL mysql:3306
Redis redis:6379
ES elasticsearch:9200

👉 重点:使用服务名访问,而不是 IP


九、这种架构的优势总结

  • ✅ 模块解耦
  • ✅ 易于扩展(新增服务只需加目录)
  • ✅ 配置统一(.env)
  • ✅ 更接近生产环境
  • ✅ 团队协作友好

相关推荐
赤生云电竞2 小时前
云游戏边缘节点部署实践:机房选址与网络拓扑选型
网络·游戏·php
ITxiaobing20232 小时前
中国广告技术公司海外反欺诈中的 IP 应用:从“库查询”到“多层信号”
网络·tcp/ip·web安全
安易算力3 小时前
智算中心网络架构选型:RDMA/IB/以太网深度对比与落地实践
网络·架构
2401_868534783 小时前
天融信网络安全面试题
服务器·网络
注塑机数据采集联网5 小时前
注塑机智能数据采集联网网关 ZK-D1/D3 如何读取力劲注塑机控制器数据并对接 MES/IOT 平台
大数据·网络·物联网·数据挖掘·注塑机网关
星落梦生6 小时前
Docker学习(11)
学习·docker·容器
万里侯9 小时前
日志聚类之后别把 noise 扔掉:降噪应该改变视图,不抹掉证据
人工智能·微服务·ai·容器·k8s
我不会插花弄玉17 小时前
13.多路转接epoll【由浅入深-网络】
网络·c++·epoll
最强小杰18 小时前
某 OpenAI 兼容网关上的 `kimi-k3.1-pro`:Cline、Zed 接入与 SSE 排错示例
java·服务器·网络·ai
byte轻骑兵1 天前
如何为你的 Web 应用添加文档编辑能力:ONLYOFFICE 文档集成实战
docker·私有化部署·系统集成·在线协作·wsl2·onlyoffice docs