### Docker Compose 子网范围定义规则及解决网络池重叠问题的方法 #### 子网范围定义规则 在 Docker Compose 文件中，子网范围的定义通过 `ipam` 配置完成。子网范围必须符合 CIDR 表示法（例如 `192.168.0.0/24`），并且不能与其他已存在的 Docker 网络子网范围冲突[^1]。 以下是一个定义自定义网络子网范围的示例： ```yaml networks: custom_network: driver: bridge ipam: config: - subnet: 192.168.1.0/24 # 定义一个唯一的子网范围 gateway: 192.168.1.1 # 可选：指定网关地址 ``` #### 解决网络池重叠问题的方法 当遇到 `Pool overlaps with other one on this address space` 错误时，通常是因为新创建的网络子网范围与现有网络的子网范围发生了冲突。以下是几种解决方案： 1. **指定唯一的子网范围** 在 Docker Compose 文件中明确指定一个不与其他网络冲突的子网范围。例如，如果默认的 `172.18.0.0/16` 被占用，则可以选择其他未使用的子网范围，如 `192.168.1.0/24`[^1]。 示例： ```yaml networks: demo_net: driver: bridge ipam: config: - subnet: 192.168.2.0/24 # 选择一个未被占用的子网 ``` 2. **删除冲突的网络** 如果冲突的网络是不再需要的遗留网络，可以手动删除这些网络以释放子网范围。使用以下命令列出并删除冲突的网络： ```bash docker network ls # 列出所有网络 docker network rm <network_name> # 删除指定网络 ``` 3. **调整默认子网范围** 如果不想为每个网络手动指定子网范围，可以通过修改 Docker 的配置文件来调整默认的子网范围。编辑 `/etc/docker/daemon.json` 文件，添加或修改 `default-address-pools` 配置： ```json { "default-address-pools": [ {"base": "192.168.10.0/24", "size": 24} ] } ``` 修改完成后，重启 Docker 服务以使更改生效： ```bash sudo systemctl restart docker ``` 4. **检查现有网络的子网范围** 在定义新网络之前，先检查当前所有网络的子网范围，确保不会发生冲突。使用以下命令查看现有网络的详细信息： ```bash docker network inspect <network_name> ``` #### 注意事项 - **子网范围唯一性**：确保每个自定义网络的子网范围唯一，避免与默认网络或其他自定义网络冲突[^1]。 - **网关地址冲突**：除了子网范围外，还需要注意网关地址是否与其他网络冲突。 - **Docker 版本差异**：不同版本的 Docker 可能在默认子网范围分配上有所不同，建议始终检查当前环境的具体配置。 --- ###