Docker Compose 本身不支持标签调度，仅通过 docker stack deploy 在 Swarm 集群中结合 deploy.placement.constraints 才能实现基于节点标签的调度；单机 docker compose up 忽略约束。
Docker Compose 本身不支持基于标签（label-based）的容器调度，它是一个面向单机、声明式编排的工具，所有服务默认在本地 Docker 引擎上启动，不涉及节点选择、资源约束或标签匹配逻辑。真正的标签调度属于集群编排系统（如 Docker Swarm 或 Kubernetes）的能力。
但你可以通过组合使用 Docker Compose + Docker Swarm 模式，在 Swarm 集群中利用 deploy.placement.constraints 基于节点标签实现调度控制。以下是清晰可行的实践路径：
✅ 明确前提：Compose ≠ 调度器，Swarm 才管调度
-
docker-compose.yml是配置文件格式，可被docker compose（CLI v2+）或docker stack deploy解析； -
只有
docker stack deploy命令会将 Compose 文件提交给 Swarm manager，并触发调度逻辑； - 单用
docker compose up启动的服务，无论加多少 label，都不会触发跨节点调度。
✅ 在 Swarm 集群中用 Compose 实现标签调度
1. 给 Swarm 节点打标签（Label）
在目标节点（如 worker1）执行：
docker node update --label-add env=prod worker1 docker node update --label-add disk=ssd worker1 docker node update --label-add role=cache worker2
✅ 标签格式为
key=value，支持多组；可通过docker node inspect <node>查看。
2. 在 docker-compose.yml 中声明调度约束
使用 deploy.placement.constraints 字段（仅 Swarm mode 生效）：
version: "3.8"
services:
redis-cache:
image: redis:7-alpine
deploy:
placement:
constraints:
- node.labels.env == "prod"
- node.labels.disk == "ssd"
replicas: 2
api-server:
image: myapp/api:v1.2
deploy:
placement:
constraints:
- node.role == "manager" # 内置角色也可约束
- node.labels.role == "backend"⚠️ 注意：
OpenClaw Docker Setup下载在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
constraints是数组，多个条件是 AND 关系；node.labels.xxx访问节点标签，node.role是 Swarm 内置属性；replicas和placement必须配合deploy块使用，普通docker compose up会忽略它们。
3. 部署到 Swarm 集群（关键步骤）
确保已在 manager 节点初始化 Swarm：
docker swarm init --advertise-addr <MANAGER_IP>
然后部署：
docker stack deploy -c docker-compose.yml myapp
✅ 此时 Swarm scheduler 会根据
constraints匹配带对应标签的节点，并仅在满足条件的节点上启动容器。
4. 验证调度结果
# 查看服务实际运行在哪几个节点
docker service ps myapp_redis-cache
# 查看节点标签是否生效
docker node ls --format "table {{.Hostname}}\t{{.Status}}\t{{.Availability}}\t{{.Labels}}"❌ 常见误区澄清
不要在 service 级别加
labels:字段试图做调度labels:是容器元数据（用于日志、监控、服务发现），不影响调度位置。depends_on不等于调度依赖
它只控制启动顺序，不决定容器部署到哪台机器。scale命令（如docker compose up --scale web=3）不支持标签调度
它只在单机上启动多个副本，仍由本地引擎分配，无节点选择能力。
✅ 补充建议：标签调度的最佳实践
- 标签命名统一前缀，例如
org.team=backend、org.env=staging，避免冲突； - 敏感标签（如
region=cn-shanghai）建议通过docker node update --label-add动态管理，而非硬编码； - 若需灰度发布，可结合
deploy.update_config和标签滚动更新（如先调度到env=canary节点）； - 避免过度约束（如同时要求 3 个标签），否则可能导致服务无法启动（
no suitable node错误）。
不复杂但容易忽略——调度行为取决于你用哪个命令执行 Compose 文件，而不是文件里写了什么。
