首页/云/Docker 容器速查/compose profiles 分组启动
Compose 编排55 条

compose profiles 分组启动

给服务打 profiles 标签实现按需启动:up 默认只起无 profile 的服务,需要时用 --profile 或 COMPOSE_PROFILES 激活整组服务。

Docker 容器速查云更新于 2026-10-12
用途分组选择性启动
激活docker compose --profile 组名 up -d / COMPOSE_PROFILES 环境变量
规则无 profile 的服务始终启动

示例

示例
services:
  api:
    image: app/api:1.4.2
  debug-tools:
    image: nicolaka/netshoot
    profiles: [debug]
    command: sleep infinity
  metrics:
    image: prom/prometheus
    profiles: [monitoring]
适合把调试、监控、一次性工具与主业务放进同一份文件而不互相干扰。

易错点

  • profiled 服务在未激活时对 logs/exec 不可见,先确认当前是否带了 --profile
  • 依赖关系跨 profile 时启动会报缺服务,依赖方要么同组要么去掉 profile

数据来源与参考

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