结论

主机层没有开启 swap ，容器运行时无论怎么设置 --memory-swap，都不会使用到 swap，容器最大能使用的内存等于设置的内存限制；

主机层开启了 swap 如下表：

memory	memory-swap	效果
M	正数 S	容器最大可用内存为S，其中 ram 为 M，swap 为（S-M），若 S=M 则无可用 swap 资源
M	0	相当于未设置 memory-swap
M	-1	容器最大可用内存为 M+主机可用swap
M	未设置	容器最大可用内存为 2M，其中 ram 为 M，swap 为 M

主机开启 swap

不设置 --memory-swap 参数

容器最大可以使用 2 倍的 --memory 内存 (可使用的 swap 大小跟内存限制的大小一样)

限制内存 100M，不设置 --memory-swap，容器申请使用 2X90M=180M，程序可以正常运行；docker stats 显示使用的内存量等于限制的内存量；查看 cgroup 里的 memory.stat 可以看到，swap 使用了大概 80M

限制内存 100M，不设置 --memory-swap，容器申请使用 2X150M=300M，由于最大允许使用内存 200M，容器启动失败；

设置 --memory-swap 100M

限制内存 100M，设置 --memory-swap=100M，容器申请使用 2X51M=102M，由于最大允许使用内存 100M，容器启动失败；

设置 --memory-swap -1

限制内存 100M，设置 --memory-swap=-1，容器申请使用 2X150M=300M，由于最大允许使用内存为 100M + 系统 swap 大小，所以容器运行正常；docker stats 显示使用的内存量等于限制的内存量；查看 cgroup 里的 memory.stat 可以看到，swap 使用了大概 200M

限制内存 100M，设置 --memory-swap=-1，容器申请使用 2X200M=400M，由于最大允许使用内存为 100M + 系统 swap 大小，所以容器运行正常；docker stats 显示使用的内存量等于限制的内存量；查看 cgroup 里的 memory.stat 可以看到，swap 使用了大概 300M

主机关闭 swap

不设置 --memory-swap 参数

限制内存 100M，未设置 --memory-swap(表示可以使用与内存限制一样的swap)，容器申请使用 2X51M=102M，由于最大允许使用内存 100M，主机没有 swap 可用，容器启动失败；

设置 --memory-swap 100M

限制内存 100M，设置 --memory-swap=200M，容器申请使用 2X51M=102M，由于最大允许使用内存 100M，主机没有 swap 可用，容器启动失败；

设置 --memory-swap -1

限制内存 100M，设置 --memory-swap=-1(表示使用主机的所有 swap)，容器申请使用 2X51M=102M，由于最大允许使用内存 100M，主机没有 swap 可用，容器启动失败；

文章来源：李斯文的笔记本