Docker中如何隔离网络实现同应用多实例并行运行避免端口冲突

核心结论 #

完全可以通过Docker自定义网桥实现网络隔离，无需修改应用内部端口配置即可同时运行多个相同应用实例，完美适配多分支并行Cypress测试的需求。

实现原理 #

Docker默认桥接网络下，宿主机端口映射存在唯一性限制，同一宿主机端口只能绑定一个容器，这是端口冲突的根本原因。通过为每个应用实例创建独立的自定义网桥，不同网桥之间网络天然二层隔离，不同网桥内的容器即使使用完全相同的内部端口也不会产生冲突。

具体操作步骤 #

• 为每个代码分支创建独立的自定义Docker网络
  执行命令 docker network create <分支标识>-net，例如存在dev、feat两个测试分支时，分别执行：

  docker network create dev-net
  docker network create feat-net
  

• 启动对应分支的应用实例，无需修改应用内置端口配置，仅需将实例加入对应分支的专属网络即可。如果不需要从宿主机直接访问应用，可以不配置宿主机端口映射，彻底规避端口冲突：

  # 启动dev分支应用，内部端口默认使用3000
  docker run -d --name dev-app --network dev-net 你的应用镜像名
  # 启动feat分支应用，内部端口同样使用3000，无冲突
  docker run -d --name feat-app --network feat-net 你的应用镜像名
  

• 对应分支的Cypress测试容器加入相同分支网络，直接通过容器名+应用内部端口即可访问目标服务，不需要额外配置端口：

  # 执行dev分支Cypress测试
  docker run --network dev-net -e CYPRESS_BASE_URL=http://dev-app:3000 你的Cypress镜像名
  # 执行feat分支Cypress测试
  docker run --network feat-net -e CYPRESS_BASE_URL=http://feat-app:3000 你的Cypress镜像名
  

优化方案（Docker Compose场景） #

如果使用Docker Compose管理服务，只需要为不同分支的Compose配置指定独立的网络即可，即使不同分支的服务名、内部端口完全一致也不会冲突，示例配置如下：

# docker-compose.dev.yml 对应dev分支配置
version: '3'
services:
  app:
    build: .
  cypress:
    image: cypress/included:latest
    environment:
      - CYPRESS_BASE_URL=http://app:3000
    depends_on:
      - app
networks:
  default:
    name: dev-net

不同分支的Compose配置仅需修改最后default网络的name值，启动时执行docker compose -f docker-compose.<分支名>.yml up即可。

内容的提问来源于stack exchange，提问作者p1nod0x