首页/云/Docker 容器速查/compose labels 与自动标签
Compose 编排55 条

compose labels 与自动标签

为服务容器写自定义标签,同时每个容器自带 compose 自动标签(项目、服务、配置哈希等),可用来做筛选与审计。

Docker 容器速查云更新于 2026-10-12
自定义labels: [com.example.team=ops] 或映射形式
自动标签com.docker.compose.project / service / config-hash
用途筛选、监控、资产归属

示例

示例
services:
  api:
    image: app/api:1.4.2
    labels:
      com.example.team: platform
      com.example.env: prod

查询

查询
docker ps --filter label=com.example.team=platform
docker ps --filter label=com.docker.compose.project=shop --format '{{.Names}}'
自动标签由 compose 维护,能反查容器归属;自定义标签建议带组织域名前缀避免冲突。

易错点

  • 标签值会出现在 docker inspect 与监控系统里,不要写敏感内容
  • 手工 docker run 的容器没有 compose 自动标签,按标签清理时会漏掉它们

数据来源与参考

  • Docker 官方文档:Compose labels 参考(docs.docker.com/reference/compose-file/services)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌