核心思路是用自定义网络隔离环境、显式子网规划和统一编排管理，避免默认分配撞车；需提前避开docker默认桥接网段172.17.0.0/16及常见私有网段，按开发、测试、预发、生产分设独立子网并绑定容器，杜绝跨环境混用，结合docker-compose按环境拆分配置，辅以网络检查与清理防冲突。

核心思路是：用自定义网络隔离环境 + 显式子网规划 + 统一编排管理，避免默认分配撞车。

明确各环境网络范围，提前避开重叠

Docker默认桥接网段（172.17.0.0/16）极易与公司内网、云VPC或数据库内网冲突。多环境部署前必须人工划分子网，不能依赖自动分配。

• 开发环境用 192.168.100.0/24
• 测试环境用 192.168.101.0/24
• 预发环境用 192.168.102.0/24
• 生产环境用 10.100.0.0/16（避开常见私有网段）

创建时直接指定子网：

docker network create --driver bridge --subnet=192.168.100.0/24 --gateway=192.168.100.1 dev-network

为每个环境创建独立网络并绑定容器

不同环境的容器绝不能共用同一网络，否则服务发现混乱、DNS解析错乱、甚至跨环境调用。

Docker Compose Linter

检查 docker-compose.yml 文件的安全问题、最佳实践和端口冲突

下载

• 启动开发环境服务时显式指定网络：docker run --network dev-network --name api-dev ...
• 测试环境走 test-network，预发走 staging-network，互不干扰
• 容器内通过服务名访问（如 curl http://db:5432），Docker 自动做 DNS 解析

用 docker-compose 按环境分组管理

避免手写一堆 docker run 命令，用 compose 文件按环境拆分配置，网络定义内聚在各自文件中。

示例 docker-compose.dev.yml：

version: '3.8'
services:
  api:
    image: myapp:dev
    networks:
      - dev-net
  db:
    image: postgres:15
    networks:
      - dev-net
<p>networks:
dev-net:
driver: bridge
ipam:
config:</p>

• subnet: 192.168.100.0/24 gateway: 192.168.100.1

  启动命令也按环境区分：docker-compose -f docker-compose.dev.yml up -d

检查与清理残留网络，防止静默冲突

旧环境停用后，残留网络可能仍占用子网，导致新环境创建失败（报错 Pool overlaps with other one）。

• 列出所有网络：docker network ls
• 检查某网络详细配置：docker network inspect dev-network，重点看 Subnet 和 IPRange 是否一致
• 删除无用网络：docker network rm dev-network（确保无容器连接后再删）
• 若发现 bridge 默认网段异常（如 Subnet 和 IPRange 不匹配），需重启 Docker 服务或重置 daemon.json 配置