关键在于网络空间隔离:为每个环境创建专属自定义网络(如myapp-dev),docker-compose.yml中显式指定networks;服务间通过服务名通信,依赖Docker内置DNS实现同名不同实;采用多文件组合(基础+环境覆盖)复用配置;跨环境通信需显式桥接,禁用--link。

要让不同环境(开发、测试、生产)在 Docker 中互不干扰又能各自跑通,关键不是“多开几个容器”,而是靠网络空间隔离把它们逻辑上彻底分开——每个环境独占一套网络、服务名、数据卷,连 DNS 解析都互不看见。
用自定义网络划清环境边界
Docker 默认的 bridge 网络是全局共享的,多个 docker-compose.yml 项目如果没显式声明网络,可能意外连通。正确做法是为每个环境创建专属网络:
- 运行
docker network create myapp-dev、docker network create myapp-test,命名带环境标识 - 在
docker-compose.yml里明确指定:networks:default:name: myapp-dev - 这样,dev 环境的
web容器只能通过db这个服务名访问同网的数据库,test 环境的web根本解析不到它
服务名即环境标识,避免硬编码主机名
容器间通信不该写 172.17.0.3 或 localhost,而应统一用服务名(如 redis、api)。Docker 内置 DNS 会自动把服务名解析成当前网络内的容器 IP:
- 开发环境
docker-compose.dev.yml里写redis://redis:6379 - 生产环境
docker-compose.prod.yml里也写redis://redis:6379,但实际连接的是另一个网络里的 redis 容器 - 应用代码完全不用改,靠网络隔离实现“同名不同实”
多 compose 文件组合,复用基础配置
避免为每个环境复制粘贴一整套 docker-compose.yml。推荐分层管理:
-
docker-compose.yml:只写共性部分(服务定义、镜像、端口暴露、基础环境变量) -
docker-compose.override.yml:本地开发用,挂载源码、开调试端口、用myapp-dev网络 -
docker-compose.prod.yml:生产专用,加资源限制、健康检查、用myapp-prod网络、挂载只读配置卷 - 启动时用
docker-compose -f docker-compose.yml -f docker-compose.prod.yml up组合生效
跨环境通信需显式桥接,不默认打通
极少数场景需要让 dev 的前端调用 test 的 API(比如联调),不能靠“放通所有网络”,而应主动设计网关或代理:
- 新建一个中间网络
shared-api-net - 把 test 环境的
api服务和 dev 环境的web服务同时接入该网络 - web 容器内用
http://api:8000访问,其他服务仍保持原网络隔离 - 禁止使用
--link(已废弃)或直接操作/etc/hosts,破坏可维护性


















