设置--memory参数可为容器添加内存硬限制，超出即触发OOM Killer终止主进程；支持docker run、docker update和docker-compose三种配置方式，并需注意swap禁用、软硬限制搭配及Java堆上限对齐等关键点。

直接设置 --memory（或 -m）参数，就能为容器加上内存硬限制。它像一道物理闸门：一旦容器实际使用内存超过该值，内核会立即触发 OOM Killer 终止容器内主进程，从而阻止内存泄漏持续蔓延、拖垮宿主机。

硬限制的核心作用

硬限制不是“建议”或“预警”，而是强制截断机制。Docker 通过 Linux cgroups 的 memory.limit_in_bytes 实现，超出即杀，不等待、不交换（除非显式启用 swap）。这对防止 Java 应用未调 JVM 堆上限、Python 进程缓存失控、或 Node.js 内存持续增长导致整机卡死特别有效。

Docker Encyclopedia

Docker 文档优先工作流：针对 Docker 特定问题、故障排除、命令规划、镜像/构建、容器/运行时操作及 Compose 等

下载

三种常用配置方式

• 单次运行时设置：适合测试或临时部署
  docker run -d --memory=1g --name myapp nginx
  容器最多用 1GB 物理内存，超限立刻被杀
• 更新已有容器：无需重启，即时生效（需容器处于运行或暂停状态）
  docker update --memory=512m myapp
  注意：不能对已停止的容器直接 update 内存，需先 start 再 update
• Docker Compose 中配置：适用于多服务编排
  在 docker-compose.yml 的 service 下写：
  mem_limit: 2g（v2/v3 非 Swarm 模式）
  或
  

  deploy:<br>  resources:<br>    limits:<br>      memory: 2G

  （Swarm 模式）

关键搭配与避坑点

• 禁用 swap 更安全：加 --memory-swap=1g（与 --memory 值相同），避免因换页掩盖问题、延迟 OOM 触发
• 不要只设硬限制：建议同步配 --memory-reservation=512m（软限制），让系统在内存紧张时优先压缩高内存容器，保留关键服务可用性
• Java 容器要双控：硬限制（--memory）必须 ≥ JVM 堆上限（-Xmx），否则容器可能因堆外内存（如 Metaspace、Direct Buffer）超限被杀，而 JVM 还没报错
• 单位大小写敏感：用 m 或 M 都可，但 g 和 G 含义一致；避免写成 MB 或 GB（Docker 不识别）

验证是否真正生效

启动后立刻执行：
docker stats myapp —— 查看 “MEM USAGE / LIMIT” 是否显示你设定的上限值
docker inspect myapp | grep -A 5 Memory —— 确认 Memory 和 MemorySwap 字段数值准确
再进容器制造内存压力（如 dd if=/dev/zero of=/tmp/big bs=1M count=2000），观察是否在接近限制时被自动终止