docker update 只能动态修改资源限制（如 --cpus、--memory、--memory-reservation、--restart）和部分运行时策略，无法更改端口映射、挂载卷、环境变量、网络模式、CMD/ENTRYPOINT 等静态配置，后者必须重启容器或重建。

`docker update` 命令用于**动态调整正在运行的容器的资源限制和重启策略**，但它**不能修改网络配置、挂载卷、环境变量、端口映射、CMD/ENTRYPOINT 等运行时不可变项**。简单说：它只管“资源配额”和“重启行为”，不管“怎么启动”。

哪些配置能用 docker update 修改？

以下参数可在容器运行中实时更新（无需重启）：

• --cpus：限制 CPU 核心数（如 --cpus=1.5）
• --memory / -m：限制内存上限（如 -m 512m 或 --memory 2g）
• --memory-reservation：设置内存软限制（触发 OOM 前的预警阈值）
• --restart：修改重启策略（如 --restart=on-failure:3）
• --kernel-memory（已弃用，新版 Docker 中被移除，不建议使用）

哪些配置不能用 docker update 修改？

以下常见配置**修改后会报错或被忽略**，必须通过 docker run 重建容器：

• 端口映射（-p 8080:80）
• 挂载卷（-v /host:/container）
• 环境变量（-e KEY=VAL）
• 网络模式（--network host）、自定义网桥、DNS 配置
• 容器名称（--name）、主机名（--hostname）
• 工作目录（-w）、用户（-u）、CMD/ENTRYPOINT

实际操作示例

假设有一个正在运行的容器 webapp，想把它内存上限从默认调高到 1GB，CPU 限制为 2 核，并设为失败时最多重启 5 次：

Docker Cli

使用 Docker CLI 构建、运行、停止、检查和管理容器与镜像的助手。用于执行容器相关任务。

下载

docker update --memory 1g --cpus 2 --restart on-failure:5 webapp

执行后立即生效，可通过以下命令验证：

docker inspect webapp | jq '.[0].HostConfig.Memory, .[0].HostConfig.NanoCpus, .[0].HostConfig.RestartPolicy'

或更简洁地查看资源设置：

docker container stats webapp

注意事项

• 容器必须处于 running 或 paused 状态；已停止的容器无法 update（需先 start）
• 降低内存限制时，若当前使用量超新限制，可能触发 OOM killer 杀死进程
• 修改 --restart 不影响当前运行状态，只作用于下次退出后的重启行为
• Linux 宿主机需启用 cgroups v1 或 v2（Docker 默认支持），否则部分限制可能不生效