首页/云/Docker 容器速查/docker run --pids-limit 限制进程数
资源与安全50 条

docker run --pids-limit 限制进程数

限制容器内可创建的进程/线程总数:防止单个服务异常 fork 或线程失控把宿主调度资源耗尽。

Docker 容器速查云更新于 2026-10-12
用途进程数量上限
语法--pids-limit=200(-1 为不限)
查看docker stats 的 PIDS 列

示例

示例
docker run -d --pids-limit=256 --name api app/api:1.4.2
docker stats --no-stream --format '{{.Name}} pids={{.PIDs}}' api
docker inspect -f '{{.HostConfig.PidsLimit}}' api
线程也计入该限额,线程模型重的运行时要按峰值线程数放大余量。

易错点

  • 限额设置过小会让服务在高并发时无法创建线程而报错,压测后按峰值上浮
  • 宿主机 pid 总量饱和时全局都会受影响,限额只保护自己这一层

数据来源与参考

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