首页/云/Docker 容器速查/compose 项目名与资源命名
本包目录(366 条)
基础命令50 条镜像与构建107 条网络与存储52 条
Compose 编排55 条
资源与安全50 条容器排障52 条

compose 项目名与资源命名

项目名决定容器/网络/卷的前缀:默认取目录名,可用 -p、COMPOSE_PROJECT_NAME 或顶层 name 字段覆盖;改名前先评估资源重建影响。

Docker 容器速查云更新于 2026-10-12
优先级-p > COMPOSE_PROJECT_NAME > 顶层 name > 目录名
影响容器、网络、卷命名前缀
查看docker compose ls / ps 显示的项目名

示例

示例
docker compose -p shop up -d
COMPOSE_PROJECT_NAME=shop docker compose up -d
docker ps --filter label=com.docker.compose.project=shop
同一台机器多套环境(dev/staging)靠项目名隔离,避免容器与网络撞名。

易错点

  • 换了项目名继续 up 等于新起一套资源,旧容器与卷仍在,容易造成端口冲突与数据分裂
  • 自动化脚本依赖默认目录名时,改目录名会连带改变项目名

数据来源与参考

  • Docker 官方文档:Compose project name(docs.docker.com/compose/project-name)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌