同一服务器上Docker Compose服务名是否必须唯一？部署冲突咨询

问题场景 #

我有两个独立服务，分别放在 /opt/service1/ 和 /opt/service2/ 目录下，各自的 docker-compose.yml 里服务名都设为 web，但指定了不同的 container_name：

# /opt/service1/docker-compose.yml
services:
  web:
    container_name: service1

# /opt/service2/docker-compose.yml
services:
  web:
    container_name: service2

依次执行部署命令：

cd /opt/service1/ && docker compose up -d
cd /opt/service2/ && docker compose up -d

结果显示 service1 容器被重建，service2 启动后，service1 完全消失。但只要把其中一个服务名改成 app 之类的其他名称，两个容器就能正常共存。这就产生疑问：部署不同Web服务时，每个都想命名为 db，难道不行吗？

核心原因 #

Docker Compose 识别服务的唯一标识是 项目名（project name）+ 服务名（service name），而非你指定的 container_name。

• 默认情况下，项目名是执行 docker compose 命令时所在目录的名称。如果两个服务的项目名+服务名组合重复，Docker Compose 会认为这是同一个服务的更新操作，直接删除旧容器并创建新容器。
• 你遇到的覆盖情况，大概率是因为项目名被意外统一：比如全局设置了 COMPOSE_PROJECT_NAME 环境变量，或者执行命令时不小心指定了相同的项目名，导致 service1/web 和 service2/web 变成了同一个标识。

解决办法 #

要让多个同名服务（比如都叫 web 或 db）共存，只需保证它们的项目名+服务名组合唯一，具体有三种方式：

1. 依赖默认项目名（最简便） #

确保每个服务的 docker-compose.yml 放在不同名称的目录下，执行命令时切换到对应目录。Docker Compose 会自动将目录名作为项目名，这样 service1/web 和 service2/web 就是两个独立的服务，不会互相干扰。

如果还是出现覆盖问题，检查系统环境变量是否设置了 COMPOSE_PROJECT_NAME，这个变量会覆盖默认的项目名。

2. 命令行指定项目名 #

使用 -p 参数手动指定项目名，确保每个服务的项目名唯一：

# 部署 service1，指定项目名为 service1-proj
cd /opt/service1/
docker compose -p service1-proj up -d

# 部署 service2，指定项目名为 service2-proj
cd /opt/service2/
docker compose -p service2-proj up -d

3. 在配置文件中指定项目名 #

在每个 docker-compose.yml 的顶部添加 name 字段，明确指定项目名：

# /opt/service1/docker-compose.yml
name: service1-proj
services:
  web:
    container_name: service1

# /opt/service2/docker-compose.yml
name: service2-proj
services:
  web:
    container_name: service2

这样无论在哪个目录执行命令，Docker Compose 都会使用配置文件中指定的项目名，彻底避免冲突。

总结 #

container_name 只是容器的显示名称，不影响 Docker Compose 对服务的唯一性识别。只要保证每个服务的项目名+服务名组合唯一，即使多个服务都叫 db 或 web，也能正常共存。

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