Docker容器内存限制方法全解析

Docker容器内存限制远不止简单设置`-m`参数那么简单——只用`-m 512m`会导致系统默认启用等量swap（即总内存上限达1GB），使容器实际可用内存翻倍、OOM行为失控，甚至引发生产环境神秘崩溃；真正有效的内存管控必须同步精确配置`--memory-swap`（如禁用swap需显式设为`--memory-swap=512m`），并警惕JVM类应用堆外内存绕过cgroup限制、旧版cgroup未生效等隐蔽陷阱，唯有通过`cat /sys/fs/cgroup/...`验证+`stress`超限实测才能确保限制真正落地。

直接说结论：用 -m（或 --memory）就能限制容器物理内存上限，但只设这个不够——--memory-swap 必须同步确认，否则系统会默认给你开一倍 swap，实际可用内存远超预期，OOM 行为也会变得不可控。

为什么 -m 512m 启动的容器，top 里却看到用了 900MB？

这是最常被忽略的默认行为：当你只指定 -m 512m，Docker 会把 --memory-swap 自动设为 1g（即 512MB 物理内存 + 512MB swap）。容器进程可以 malloc 到接近 1GB 才触发 OOM killer。

• 验证方式：进容器执行 cat /sys/fs/cgroup/memory/memory.limit_in_bytes 和 cat /sys/fs/cgroup/memory/memory.memsw.limit_in_bytes
• 想禁用 swap？必须显式写成 -m 512m --memory-swap=512m（两个值相等）
• 想彻底禁用 swap？用 -m 512m --memory-swap=0，但注意：部分内核版本不支持该组合，会报错

--memory-swap 的三种典型取值含义

这个参数不是“额外 swap 大小”，而是“物理内存 + swap 的总上限”。它的值和 -m 的关系决定 swap 是否可用、能用多少：

• -m 512m --memory-swap=-1：不限制总内存（swap 无限），等同于没设限制
• -m 512m --memory-swap=1g：最多用 512MB 物理内存 + 最多 512MB swap（因为 1g − 512m = 512m）
• -m 512m --memory-swap=512m：禁止使用任何 swap，超 512MB 直接 OOM

注意：--memory-swap 不能小于 -m 值，否则 Docker daemon 启动容器时会拒绝并报错 invalid argument: memory-swap must be greater than or equal to memory。

压测验证内存限制是否生效，别用错 stress 参数

用 stress 测试时，关键不是看它分配了多少，而是看它是否在限额内循环、还是直接崩溃：

• 正确命令示例：docker run -it -m 128m --memory-swap=128m progrium/stress --vm 1 --vm-bytes 130m
• 现象：容器秒退，docker ps -a 显示状态为 Exited (137)（137 = OOM kill）
• 错误示范：--vm-bytes 100m —— 这个值远低于 128MB，根本压不出限制，只能说明“没超”，不能证明“限制生效”
• 单位要对齐：130m 是 130 MiB ≈ 136314880 字节，而 /sys/fs/cgroup/memory/memory.limit_in_bytes 显示的是字节数，可直接比对

生产环境设置内存限制的两个硬约束

光写对参数还不够。真实服务跑起来，容易栽在这两点上：

• JVM 类应用（如 Spring Boot、Tomcat）必须显式传 -Xmx，且该值要 ≤ 容器 -m 值的 75% 左右；否则 JVM 自己申请堆外内存（Netty direct buffer、JIT code cache 等）会绕过 cgroup 限制，导致容器被 OOM kill
• 容器启动后，建议立刻检查 cat /sys/fs/cgroup/memory/memory.max（cgroup v2）或 memory.limit_in_bytes（cgroup v1），确认值与预期一致；某些旧版 Docker 或 systemd 环境下，cgroup v2 未启用会导致限制静默失效

真正卡住人的，往往不是参数记不住，而是 swap 默认行为和 JVM 堆外内存这两个点没对齐。调完 -m，一定要进容器看 cgroup 文件、再用 stress 超一点试杀一次，才算闭环。

今天关于《Docker容器内存限制方法全解析》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于Linux的内容请关注golang学习网公众号！