首页/云/Docker 容器速查/docker run --cpus 限制 CPU
资源与安全50 条

docker run --cpus 限制 CPU

限制容器可使用的 CPU 时间上限:--cpus=1.5 表示可用一个半核的时间片,多核机器上按秒分配,适合防单容器吃满整机。

Docker 容器速查云更新于 2026-10-12
用途CPU 时间上限
语法--cpus=1.5 / --cpus=2
查看宿主机 docker stats 对照 CPU% 与限额

示例

示例
docker run -d --cpus=1.5 --name api app/api:1.4.2
docker run --rm --cpus=2 alpine sh -c 'nproc; cat /sys/fs/cgroup/cpu.max 2>/dev/null || true'
--cpus 设置的是总数配额(CFS quota),与容器内看到的核数显示无关,以实际吞吐为准。

易错点

  • --cpus 与 --cpu-shares 语义不同:前者是硬上限,后者只在争抢时生效,别互相替代
  • 压测时注意限额导致的排队延迟,CPU 密集型服务要留出突发余量

数据来源与参考

  • Docker 官方 CLI 参考:docker run --cpus(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌