多个独立docker-compose项目如何跨文件连接共用MySQL数据库服务

核心原理 #

Docker默认会为每个docker-compose项目创建独立的隔离桥接网络，不同compose的容器默认无法通过容器名互访。你只需要将MySQL和两个自研应用都加入同一个共享自定义桥接网络，即可实现容器名直接通信，且应用执行docker-compose down操作完全不会影响MySQL服务。

操作步骤 #

1. 配置共享网络（无需重启现有生产MySQL） #

如果你的MySQL已经在运行不想中断服务，直接执行以下命令手动创建共享网络并将MySQL接入：

• 创建固定名称的共享网络：docker network create shared_db_net
• 将运行中的MySQL容器加入共享网络：docker network connect shared_db_net <你的MySQL容器名>
  全程不会停止MySQL服务，不影响线上业务。

如果是新部署的MySQL，可以直接在MySQL的docker-compose.yml中声明共享网络，配置示例：

version: '3.8'
services:
  mysql:
    image: mysql:8.0
    container_name: mysql_prod # 必须和你应用配置里的MySQL连接地址的容器名完全一致
    networks:
      - shared_db_net
    # 保留你原本的volumes、environment、ports等配置不变
volumes:
  mysql_data:
networks:
  shared_db_net:
    name: shared_db_net # 固定网络名，避免compose自动加项目前缀

执行docker-compose up -d启动MySQL时会自动创建共享网络。

2. 配置自研应用的docker-compose.yml #

在两个应用的compose配置中，声明接入已有的共享网络即可，配置示例：

version: '3.8'
services:
  app1: # 自研应用2同理修改服务名和镜像即可
    image: 你的自研应用镜像:版本号
    networks:
      - shared_db_net # 接入共享网络后即可直接通过MySQL容器名访问数据库
    # 保留你原本的ports、volumes、environment等配置不变
networks:
  shared_db_net:
    external: true # 标记为外部已存在网络，compose不会创建/删除该网络

3. 验证生效 #

直接执行应用的docker-compose up -d启动服务即可，应用会自动接入共享网络，和MySQL正常通信。后续你更新应用执行docker-compose down时，只会删除应用自身的容器，完全不会触碰共享网络和MySQL服务。

注意事项 #

• 必须固定MySQL的container_name，和应用配置中连接地址的容器名完全一致，不要依赖compose自动生成的服务名，避免前缀问题
• 如果应用需要同时接入其他网络（比如公网网关网络），可以给服务配置多个网络，互不影响

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