Docker中network_mode与networks的区别及实践困惑求解

1. network_mode与networks的实践区别 #

• networks配置：是Docker Compose推荐的标准化网络接入方式，遵循Docker网络模型规则。当你通过它指定外部bridge网络时，Compose会尝试为容器配置网络别名等高级特性——但默认bridge是Docker的内置网络，并非用户自定义网络，不支持网络范围别名这类功能，这也是你触发报错的核心原因。
• network_mode配置：属于更底层的网络命名空间指定方式，会绕过Compose的网络管理逻辑，直接让容器复用目标网络的命名空间。设置为bridge时，容器只是单纯挂到Docker默认bridge网络下，不会触发Compose的别名配置等额外操作。

简言之：networks适配Docker网络的完整特性，适合规范的服务组网；network_mode是极简的网络挂载方式，适合直接复用现有网络环境，但会丢失Compose的网络管理能力。

2. 为何network_mode: bridge时docker network inspect bridge能看到所有关联容器 #

Docker默认的bridge是全局内置网络，任何通过合法方式接入它的容器，都会被docker network inspect识别并列出：

• 用network_mode: bridge时，容器直接跳过Compose的额外配置逻辑，正常挂载到默认bridge网络，自然会出现在检查结果里。
• 修改前的networks配置，因为Compose尝试给容器添加网络别名（Compose默认行为），但默认bridge不支持该特性，导致容器启动失败或未正常接入网络，所以不会出现在检查结果中——你看到的“正确关联”是修改后配置下容器正常启动并挂载的结果。

跨Compose服务通信的推荐方案 #

不要使用默认bridge网络，创建一个用户自定义网络（执行docker network create my-shared-network），然后在每个docker-compose.yml中通过networks接入该网络：

services:
  local-db:
    image: mysql

networks:
  default:
    external:
      name: my-shared-network

自定义网络支持自动DNS解析、网络别名等特性，能稳定实现不同Compose服务间的通信。

内容的提问来源于stack exchange，提问作者José Victor