首页/云/Docker 容器速查/docker run --memory 内存硬限制
资源与安全50 条

docker run --memory 内存硬限制

限制容器可用的物理内存:达到硬限触发 OOM 终止;配合 --memory-reservation 设置软限,是资源限制里应优先设置的项。

Docker 容器速查云更新于 2026-10-12
用途内存硬上限
语法--memory=512m / 1g
相关--memory-reservation 软限(弹性回收)

示例

示例
docker run -d --memory=512m --memory-reservation=384m --name api app/api:1.4.2
docker inspect -f '{{.HostConfig.Memory}} reserve={{.HostConfig.MemoryReservation}}' api
docker stats --no-stream api
内存限制按 cgroup 计量,包含应用、缓存与 tmpfs 等占用;Java 等应用要同步调整堆上限。

易错点

  • 超过硬限时进程被内核杀死且退出码 137,应用日志往往没有痕迹,需查 OOMKilled 标记
  • 限制低于应用启动期峰值会导致容器反复起不来,先观测真实峰值再定

数据来源与参考

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