docker容器标签（label）是嵌入容器元数据的键值对，用于标识项目归属、环境、角色等信息，支持精准筛选、监控集成与自动化运维。
Docker 中的容器标签（Label）不是镜像标签（Tag），而是嵌入在容器元数据中的键值对，用于为运行中的容器添加自描述信息。它不参与镜像拉取或版本控制，但却是服务分类、筛选、监控和自动化运维的关键工具。
用 Labels 给容器打“身份标签”
Labels 是容器启动时注入的静态元数据，由 docker run -l 或 docker-compose.yml 中的 labels: 字段定义。它们像“数字身份证”，让每个容器自带上下文信息。
-
项目归属：标定所属业务系统，如
app.project=payment-service -
环境标识：区分部署环境，如
env=prod、env=staging -
服务角色：说明功能定位，如
role=api、role=worker、role=cache -
团队/负责人：便于协作追踪，如
owner=backend-team -
生命周期信息：如
deployed-by=jenkins-20260807或version=v2.4.1
通过 Labels 实现精准筛选与批量操作
利用 docker ps --filter label=... 可快速过滤目标容器，无需依赖名称或端口等易变字段。
- 查所有生产环境 API 服务：
docker ps --filter "label=env=prod" --filter "label=role=api" - 停掉测试环境中所有缓存容器：
docker stop $(docker ps -q --filter "label=env=test" --filter "label=role=cache") - 导出某项目全部容器信息：
docker ps --format "{{.Names}}\t{{.Status}}\t{{.Labels}}" --filter "label=app.project=user-profile"
结合 Docker Compose 自动化打标
Compose 会自动添加 com.docker.compose.* 系列内置标签，同时支持自定义扩展：
-
com.docker.compose.project：项目名（来自COMPOSE_PROJECT_NAME或目录名） -
com.docker.compose.service：对应docker-compose.yml中的服务名 -
com.docker.compose.config-hash：配置文件哈希，可用于检测是否需重建 - 你还可以叠加业务标签：
services:<br> api:<br> image: myapp:v2.4<br> labels:<br> - env=prod<br> - role=api<br> - team=auth<br> - version=v2.4.1
对接监控与编排系统的实用场景
Labels 是 Prometheus、cAdvisor、Portainer 等工具识别和分组容器的基础依据。
- Prometheus 使用
docker_sd_configs自动发现容器，并通过relabel_configs提取env、role作为指标标签 - Portainer 的资源视图支持按 Label 过滤，比如只看
env=prod下的所有服务 - Kubernetes 的 Docker shim 层也会将 Pod Labels 映射为容器 Labels，保持一致性
- 日志采集工具（如 Fluentd）可按 Label 路由日志到不同索引，例如
env=staging日志进staging-logs索引
