Docker Compose 网络配置2种自定义网段方案与容器互通测试在微服务架构盛行的今天Docker Compose 已成为本地开发和测试环境部署的标准工具。但许多开发者在使用过程中都会遇到一个共同痛点当多个Compose项目同时运行时默认的172.17.0.0/16网段可能导致IP冲突或者与企业内网环境不兼容。本文将深入探讨两种实用的自定义网段配置方案并通过实际案例演示如何实现跨项目的容器网络互通。1. 理解Docker Compose网络基础Docker Compose 默认会为每个项目创建一个独立的bridge网络这种设计虽然提供了隔离性但也带来了网络规划的挑战。我们先来看一个典型的默认网络配置version: 3.8 services: web: image: nginx ports: - 8080:80执行docker-compose up后使用docker network inspect project_name_default命令查看网络详情你会发现类似这样的配置{ Subnet: 172.18.0.0/16, Gateway: 172.18.0.1 }这种自动分配的网段存在三个主要问题可能与现有企业内网冲突多个Compose项目间无法直接通信难以实现可预测的IP地址分配提示使用docker network ls可以查看所有网络列表Compose创建的网络通常以项目名称为前缀2. 方案一Compose文件内定义自定义网络这是最灵活且推荐的方式特别适合需要精细控制网络配置的场景。下面是一个完整示例version: 3.8 services: app: image: my-app:latest networks: - backend - frontend db: image: postgres:13 networks: - backend environment: POSTGRES_PASSWORD: example networks: backend: driver: bridge ipam: config: - subnet: 10.5.0.0/24 gateway: 10.5.0.1 frontend: driver: bridge ipam: config: - subnet: 10.6.0.0/24 gateway: 10.6.0.1这种配置的优势在于明确划分了前端和后端网络边界每个子网只包含254个可用IP(10.x.0.1-10.x.0.254)可以预定义网关地址服务可以加入多个网络关键参数说明参数说明示例值driver网络驱动类型bridge/overlay/macvlansubnet网络地址段10.5.0.0/24gateway网关地址10.5.0.1ip_range可选IP范围10.5.0.128/25aux_address保留IP映射host110.5.0.1293. 方案二全局预定义地址池对于需要统一管理多个Compose项目网络的环境可以在Docker守护进程级别配置默认地址池。编辑/etc/docker/daemon.json文件{ default-address-pools: [ { base: 10.20.0.0/16, size: 24 }, { base: 10.30.0.0/16, size: 24 } ] }配置说明base地址池基础网段size每个子网的大小(24表示/24子网)需要重启Docker服务生效sudo systemctl restart docker这种方式的优势是所有新建网络自动从预定义池分配避免不同项目的子网重叠无需在每个Compose文件中重复配置注意修改全局配置会影响所有Docker网络建议在开发环境统一规划4. 跨项目网络互通实战假设我们有两个独立Compose项目需要通信项目A(docker-compose.db.yml)version: 3.8 services: mysql: image: mysql:8.0 networks: - shared networks: shared: name: shared_network driver: bridge ipam: config: - subnet: 10.100.0.0/24项目B(docker-compose.app.yml)version: 3.8 services: app: image: my-app networks: - shared networks: shared: external: true name: shared_network操作步骤先启动项目Adocker-compose -f docker-compose.db.yml up -d再启动项目Bdocker-compose -f docker-compose.app.yml up -d测试连通性docker exec -it app_app_1 ping mysql互通的关键点使用相同的network name一方创建网络另一方通过external: true引用确保子网配置一致5. 高级网络诊断技巧当网络出现问题时这些命令能帮你快速定位查看容器网络详情docker inspect container --format{{json .NetworkSettings.Networks}}测试容器间连通性docker exec -it container1 ping container2_ip检查路由表docker exec -it container ip route网络流量捕获docker run --rm --net container:target_container nicolaka/netshoot tcpdump -i eth0 -w /tmp/capture.pcap常见问题排查表现象可能原因解决方案无法解析主机名DNS配置错误检查/etc/resolv.conf能ping通IP但无法连接端口防火墙规则限制检查iptables规则间歇性连接失败ARP缓存问题清除ARP缓存跨主机通信失败网络驱动不匹配使用overlay驱动在实际项目中我曾遇到一个典型案例两个服务明明在同一个网络却无法通过服务名通信。最终发现是因为其中一个容器修改了/etc/hosts文件覆盖了Docker的自动DNS配置。这个教训告诉我们永远不要手动修改容器内的网络配置文件。