运行容器

Docker 在隔离的容器中运行进程。容器是在主机上运行的进程。主机可以是本地主机或远程主机。当您执行 `docker run` 时,运行的容器进程是隔离的,因为它拥有自己的文件系统、自己的网络和自己的隔离进程树,与主机分开。

此页面详细介绍了如何使用 `docker run` 命令运行容器。

一般形式

`docker run` 命令采用以下形式:

$ docker run [OPTIONS] IMAGE[:TAG|@DIGEST] [COMMAND] [ARG...]

`docker run` 命令必须指定一个 镜像引用 来从中创建容器。

镜像引用

镜像引用是镜像的名称和版本。您可以使用镜像引用来创建或运行基于镜像的容器。

  • docker run IMAGE[:TAG][@DIGEST]
  • docker create IMAGE[:TAG][@DIGEST]

镜像标签是镜像版本,省略时默认为 `latest`。使用标签从镜像的特定版本运行容器。例如,要运行 `ubuntu` 镜像的 `24.04` 版本:`docker run ubuntu:24.04`。

镜像摘要

使用 v2 或更高版本镜像格式的镜像具有称为摘要的内容寻址标识符。只要用于生成镜像的输入不变,摘要值就是可预测的。

以下示例从具有 `sha256:9cacb71397b640eca97488cf08582ae4e4068513101088e9f96c9814bfda95e0` 摘要的 `alpine` 镜像运行容器:

$ docker run alpine@sha256:9cacb71397b640eca97488cf08582ae4e4068513101088e9f96c9814bfda95e0 date

选项

[OPTIONS] 允许您配置容器的选项。例如,您可以为容器命名(`--name`),或将其作为后台进程运行(`-d`)。您还可以设置选项来控制资源约束和网络等内容。

命令和参数

您可以使用 `[COMMAND]` 和 `[ARG...]` 位置参数来指定容器启动时要运行的命令和参数。例如,您可以将 `sh` 指定为 `[COMMAND]`,并结合 `-i` 和 `-t` 标志,在容器中启动交互式 shell(如果您选择的镜像在 `PATH` 上具有 `sh` 可执行文件)。

$ docker run -it IMAGE sh

注意

根据您的 Docker 系统配置,您可能需要在 `docker run` 命令前加上 `sudo`。为避免必须对 `docker` 命令使用 `sudo`,系统管理员可以创建一个名为 `docker` 的 Unix 组并将用户添加到该组。有关此配置的更多信息,请参阅您操作系统的 Docker 安装文档。

前台和后台

启动容器时,容器默认在前台运行。如果您想改为在后台运行容器,可以使用 `--detach`(或 `-d`)标志。这将启动容器而不会占用您的终端窗口。

$ docker run -d <IMAGE>

当容器在后台运行时,您可以使用其他 CLI 命令与容器交互。例如,`docker logs` 允许您查看容器的日志,而 `docker attach` 将其带到前台。

$ docker run -d nginx
0246aa4d1448a401cabd2ce8f242192b6e7af721527e48a810463366c7ff54f1
$ docker ps
CONTAINER ID   IMAGE     COMMAND                  CREATED         STATUS        PORTS     NAMES
0246aa4d1448   nginx     "/docker-entrypoint.…"   2 seconds ago   Up 1 second   80/tcp    pedantic_liskov
$ docker logs -n 5 0246aa4d1448
2023/11/06 15:58:23 [notice] 1#1: start worker process 33
2023/11/06 15:58:23 [notice] 1#1: start worker process 34
2023/11/06 15:58:23 [notice] 1#1: start worker process 35
2023/11/06 15:58:23 [notice] 1#1: start worker process 36
2023/11/06 15:58:23 [notice] 1#1: start worker process 37
$ docker attach 0246aa4d1448
^C
2023/11/06 15:58:40 [notice] 1#1: signal 2 (SIGINT) received, exiting
...

有关与前台和后台模式相关的 `docker run` 标志的更多信息,请参阅:

有关重新附加到后台容器的更多信息,请参阅 docker attach

容器标识

您可以通过三种方式识别容器

标识符类型示例值
UUID 长标识符f78375b1c487e03c9438c729345e54db9d20cfa2ac1fc3494b6eb60872e74778
UUID 短标识符f78375b1c487
名称evil_ptolemy

UUID 标识符是由守护进程分配给容器的随机 ID。

守护进程会自动为容器生成随机字符串名称。您还可以使用 --name标志 定义自定义名称。定义name是为容器添加意义的一种便捷方法。如果指定了name,则可以在用户定义的网络中引用容器时使用它。这适用于后台和前台 Docker 容器。

容器标识符与镜像引用不同。镜像引用指定运行容器时要使用的镜像。您不能运行docker exec nginx:alpine sh以在基于nginx:alpine镜像的容器中打开 shell,因为docker exec需要容器标识符(名称或 ID),而不是镜像。

虽然容器使用的镜像不是容器的标识符,但您可以使用--filter标志查找使用某个镜像的容器的 ID。例如,以下docker ps命令获取基于nginx:alpine镜像的所有正在运行的容器的 ID

$ docker ps -q --filter ancestor=nginx:alpine

有关使用过滤器的更多信息,请参阅 过滤

容器网络

容器默认情况下启用网络,并且可以进行传出连接。如果您正在运行需要相互通信的多个容器,则可以创建自定义网络并将容器附加到该网络。

当多个容器附加到同一个自定义网络时,它们可以使用容器名称作为 DNS 主机名相互通信。以下示例创建名为my-net的自定义网络,并运行两个附加到该网络的容器。

$ docker network create my-net
$ docker run -d --name web --network my-net nginx:alpine
$ docker run --rm -it --network my-net busybox
/ # ping web
PING web (172.18.0.2): 56 data bytes
64 bytes from 172.18.0.2: seq=0 ttl=64 time=0.326 ms
64 bytes from 172.18.0.2: seq=1 ttl=64 time=0.257 ms
64 bytes from 172.18.0.2: seq=2 ttl=64 time=0.281 ms
^C
--- web ping statistics ---
3 packets transmitted, 3 packets received, 0% packet loss
round-trip min/avg/max = 0.257/0.288/0.326 ms

有关容器网络的更多信息,请参阅 网络概述

文件系统挂载

默认情况下,容器中的数据存储在短暂的、可写的容器层中。删除容器也会删除其数据。如果您想将持久性数据与容器一起使用,可以使用文件系统挂载将数据持久地存储在主机系统上。文件系统挂载还可以让您在容器和主机之间共享数据。

Docker 支持两大类挂载

  • 卷挂载
  • 绑定挂载

卷挂载非常适合持久存储容器的数据以及在容器之间共享数据。另一方面,绑定挂载用于在容器和主机之间共享数据。

您可以使用docker run命令的--mount标志将文件系统挂载添加到容器。

以下部分显示了创建卷和绑定挂载的基本示例。有关更深入的示例和说明,请参考文档中 存储部分

卷挂载

创建卷挂载

$ docker run --mount source=<VOLUME_NAME>,target=[PATH] [IMAGE] [COMMAND...]

在这种情况下,--mount标志采用两个参数:sourcetargetsource参数的值是卷的名称。target的值是容器内卷的挂载位置。创建卷后,即使您停止或删除容器,写入卷的任何数据都将被持久保存。

$ docker run --rm --mount source=my_volume,target=/foo busybox \
  echo "hello, volume!" > /foo/hello.txt
$ docker run --mount source=my_volume,target=/bar busybox
  cat /bar/hello.txt
hello, volume!

target必须始终是绝对路径,例如/src/docs。绝对路径以/(正斜杠)开头。卷名必须以字母数字字符开头,后跟a-z0-9_(下划线)、.(句点)或-(连字符)。

绑定挂载

创建绑定挂载

$ docker run -it --mount type=bind,source=[PATH],target=[PATH] busybox

在这种情况下,--mount标志采用三个参数。一个类型(bind)和两条路径。source路径是您要绑定挂载到容器中的主机上的位置。target路径是容器内的挂载目标。

绑定挂载默认情况下是读写的,这意味着您可以从容器读取和写入挂载位置的文件。您所做的更改(例如添加或编辑文件)会反映在主机文件系统上。

$ docker run -it --mount type=bind,source=.,target=/foo busybox
/ # echo "hello from container" > /foo/hello.txt
/ # exit
$ cat hello.txt
hello from container

退出状态

docker run 的退出代码提供有关容器运行失败或退出原因的信息。以下部分描述了不同容器退出代码值的含义。

125

退出代码125表示错误与 Docker 守护程序本身有关。

$ docker run --foo busybox; echo $?

flag provided but not defined: --foo
See 'docker run --help'.
125

126

退出代码126表示无法调用指定的容器命令。以下示例中的容器命令是:/etc; echo $?

$ docker run busybox /etc; echo $?

docker: Error response from daemon: Container command '/etc' could not be invoked.
126

127

退出代码127表示找不到容器命令。

$ docker run busybox foo; echo $?

docker: Error response from daemon: Container command 'foo' not found or does not exist.
127

其他退出代码

125126127之外的任何退出代码都表示提供的容器命令的退出代码。

$ docker run busybox /bin/sh -c 'exit 3'
$ echo $?
3

资源的运行时约束

操作员还可以调整容器的性能参数

选项描述
-m, --memory=""内存限制(格式:<number>[<unit>])。Number 是正整数。Unit 可以是bkmg之一。最小值为 6M。
--memory-swap=""总内存限制(内存 + 交换空间,格式:<number>[<unit>])。Number 是正整数。Unit 可以是bkmg之一。
--memory-reservation=""内存软限制(格式:<number>[<unit>])。Number 是正整数。Unit 可以是bkmg之一。
--kernel-memory=""内核内存限制(格式:<number>[<unit>])。Number 是正整数。Unit 可以是bkmg之一。最小值为 4M。
-c, --cpu-shares=0CPU 份额(相对权重)
--cpus=0.000CPU 数量。Number 是分数。0.000 表示无限制。
--cpu-period=0限制 CPU CFS(完全公平调度程序)周期
--cpuset-cpus=""允许执行的 CPU(0-3、0、1)
--cpuset-mems=""允许执行的内存节点 (MEM)(0-3、0、1)。仅在 NUMA 系统上有效。
--cpu-quota=0限制 CPU CFS(完全公平调度程序)配额
--cpu-rt-period=0限制 CPU 实时周期。以微秒为单位。需要设置父 cgroups,并且不能高于父级。还要检查 rtprio ulimits。
--cpu-rt-runtime=0限制 CPU 实时运行时间。以微秒为单位。需要设置父 cgroups,并且不能高于父级。还要检查 rtprio ulimits。
--blkio-weight=0块 IO 权重(相对权重)接受 10 到 1000 之间的权重值。
--blkio-weight-device=""块 IO 权重(相对设备权重,格式:DEVICE_NAME:WEIGHT
--device-read-bps=""限制从设备读取速率(格式:<device-path>:<number>[<unit>])。Number 是正整数。Unit 可以是kbmbgb之一。
--device-write-bps=""限制向设备写入速率(格式:<device-path>:<number>[<unit>])。Number 是正整数。Unit 可以是kbmbgb之一。
--device-read-iops=""限制从设备读取速率(每秒 IO 次数)(格式:<device-path>:<number>)。Number 是正整数。
--device-write-iops=""限制向设备写入速率(每秒 IO 次数)(格式:<device-path>:<number>)。Number 是正整数。
--oom-kill-disable=false是否禁用容器的 OOM Killer。
--oom-score-adj=0调整容器的 OOM 偏好(-1000 到 1000)
--memory-swappiness=""调整容器的内存交换行为。接受 0 到 100 之间的整数。
--shm-size=""/dev/shm 的大小。格式为<number><unit>number必须大于0。Unit 可选,可以是b(字节)、k(千字节)、m(兆字节)或g(千兆字节)。如果省略单位,则系统使用字节。如果完全省略大小,则系统使用64m

用户内存约束

我们有四种方法可以设置用户内存使用情况

选项结果
memory=inf, memory-swap=inf(默认)容器没有内存限制。容器可以使用任意数量的内存。
memory=L<inf, memory-swap=inf(指定内存并设置内存交换为-1) 容器不允许使用超过L字节的内存,但可以使用所需的交换空间(如果主机支持交换内存)。
memory=L<inf, memory-swap=2*L(指定内存但不指定内存交换) 容器不允许使用超过L字节的内存,交换空间 *加* 内存使用量为其两倍。
memory=L<inf, memory-swap=S<inf, L<=S(同时指定内存和内存交换) 容器不允许使用超过L字节的内存,交换空间 *加* 内存使用量限制在S以内。

示例

$ docker run -it ubuntu:24.04 /bin/bash

我们没有设置任何关于内存的选项,这意味着容器中的进程可以使用他们需要的任意数量的内存和交换内存。

$ docker run -it -m 300M --memory-swap -1 ubuntu:24.04 /bin/bash

我们设置了内存限制并禁用了交换内存限制,这意味着容器中的进程可以使用300M内存以及所需的交换内存(如果主机支持交换内存)。

$ docker run -it -m 300M ubuntu:24.04 /bin/bash

我们只设置了内存限制,这意味着容器中的进程可以使用300M内存和300M交换内存,默认情况下,总虚拟内存大小(--memory-swap)将设置为内存的两倍,在这种情况下,内存 + 交换空间将为2*300M,因此进程也可以使用300M交换内存。

$ docker run -it -m 300M --memory-swap 1G ubuntu:24.04 /bin/bash

我们同时设置了内存和交换内存,因此容器中的进程可以使用300M内存和700M交换内存。

内存预留是一种内存软限制,允许更好地共享内存。在正常情况下,容器可以使用所需的任意数量的内存,并且仅受使用-m/--memory选项设置的硬限制约束。当设置内存预留时,Docker 会检测内存竞争或内存不足,并强制容器将其内存消耗限制在预留限制内。

始终将内存预留值设置为低于硬限制,否则硬限制优先。预留值为0与不设置预留相同。默认情况下(未设置预留),内存预留与硬内存限制相同。

内存预留是一项软限制功能,不能保证不会超过限制。相反,此功能尝试确保当内存竞争激烈时,内存将根据预留提示/设置进行分配。

以下示例将内存 (-m) 限制为 500M,并将内存预留设置为 200M。

$ docker run -it -m 500M --memory-reservation 200M ubuntu:24.04 /bin/bash

在此配置下,当容器消耗的内存超过 200M 但小于 500M 时,下一次系统内存回收尝试将容器内存缩小到 200M 以下。

以下示例在没有硬内存限制的情况下将内存预留设置为 1G。

$ docker run -it --memory-reservation 1G ubuntu:24.04 /bin/bash

容器可以使用所需的任意数量的内存。内存预留设置可确保容器不会长时间消耗过多内存,因为每次内存回收都会将容器的消耗缩减到预留值。

默认情况下,如果发生内存不足 (OOM) 错误,内核会终止容器中的进程。要更改此行为,请使用--oom-kill-disable选项。仅在您也设置了-m/--memory选项的容器上禁用 OOM killer。如果未设置-m标志,这可能会导致主机内存不足,并需要终止主机的系统进程以释放内存。

以下示例将内存限制为 100M,并为该容器禁用 OOM killer。

$ docker run -it -m 100M --oom-kill-disable ubuntu:24.04 /bin/bash

以下示例说明了一种危险的标志使用方法。

$ docker run -it --oom-kill-disable ubuntu:24.04 /bin/bash

容器具有无限内存,这可能会导致主机内存不足,并需要终止系统进程以释放内存。可以更改--oom-score-adj参数来选择系统内存不足时要终止哪些容器的优先级,负分使它们不太可能被终止,正分则更容易被终止。

内核内存约束

内核内存与用户内存 fundamentally 不同,因为内核内存无法交换出去。无法交换使得容器可以通过消耗过多的内核内存来阻塞系统服务。内核内存包括:

  • 堆栈页
  • slab 页
  • 套接字内存压力
  • tcp 内存压力

您可以设置内核内存限制来约束这些类型的内存。例如,每个进程都会消耗一些堆栈页。通过限制内核内存,您可以防止在内核内存使用率过高时创建新进程。

内核内存永远不会完全独立于用户内存。相反,您是在用户内存限制的上下文中限制内核内存。假设“U”是用户内存限制,“K”是内核限制。有三种可能的限制设置方式

选项结果
U != 0, K = inf (默认)这是使用内核内存之前已经存在的标准内存限制机制。内核内存完全被忽略。
U != 0, K < U内核内存是用户内存的子集。此设置在每个 cgroup 的总内存量超额分配的部署中很有用。绝对不建议超额分配内核内存限制,因为系统仍然可能耗尽不可回收的内存。在这种情况下,您可以配置 K,以确保所有组的总和永远不会大于总内存。然后,您可以以牺牲系统服务质量为代价自由设置 U。
U != 0, K > U由于内核内存收费也会反馈到用户计数器,并且会针对这两种内存触发容器的回收。此配置为管理员提供了统一的内存视图。对于只想跟踪内核内存使用情况的人来说也很有用。

示例

$ docker run -it -m 500M --kernel-memory 50M ubuntu:24.04 /bin/bash

我们设置了内存和内核内存,因此容器中的进程总共可以使用 500M 内存,在这 500M 内存中,最多可以使用 50M 内核内存。

$ docker run -it --kernel-memory 50M ubuntu:24.04 /bin/bash

我们设置了内核内存,但没有使用 -m,因此容器中的进程可以使用他们想要的任意数量的内存,但他们只能使用 50M 内核内存。

Swappiness 约束

默认情况下,容器的内核可以交换一部分匿名页。要为容器设置此百分比,请指定 0 到 100 之间的--memory-swappiness值。值为 0 将关闭匿名页交换。值为 100 将所有匿名页设置为可交换的。默认情况下,如果您不使用--memory-swappiness,则内存交换率值将继承自父级。

例如,您可以设置

$ docker run -it --memory-swappiness=0 ubuntu:24.04 /bin/bash

当您想要保留容器的工作集并避免交换性能损失时,设置--memory-swappiness选项很有帮助。

CPU 共享约束

默认情况下,所有容器都获得相同比例的 CPU 周期。可以通过更改容器的 CPU 共享权重相对于所有其他正在运行的容器的权重来修改此比例。

要从默认值 1024 修改比例,请使用-c--cpu-shares标志将权重设置为 2 或更高。如果设置为 0,则系统将忽略该值并使用默认值 1024。

只有在运行 CPU 密集型进程时,比例才适用。当一个容器中的任务空闲时,其他容器可以使用剩余的 CPU 时间。实际的 CPU 时间量将取决于系统上运行的容器数量。

例如,考虑三个容器,一个容器的 cpu-share 为 1024,另外两个容器的 cpu-share 设置为 512。当所有三个容器中的进程尝试使用 100% 的 CPU 时,第一个容器将获得总 CPU 时间的 50%。如果您添加第四个 cpu-share 为 1024 的容器,则第一个容器仅获得 33% 的 CPU。其余容器分别获得 16.5%、16.5% 和 33% 的 CPU。

在多核系统上,CPU 时间的份额将分布在所有 CPU 内核上。即使容器的 CPU 时间限制低于 100%,它也可以使用每个 CPU 内核的 100%。

例如,考虑一个具有三个以上内核的系统。如果您启动一个使用-c=512运行一个进程的容器{C0},以及另一个使用-c=1024运行两个进程的容器{C1},这可能会导致以下 CPU 份额划分

PID    container	CPU	CPU share
100    {C0}		0	100% of CPU0
101    {C1}		1	100% of CPU1
102    {C1}		2	100% of CPU2

CPU 周期约束

默认 CPU CFS(完全公平调度程序)周期为 100ms。我们可以使用--cpu-period设置 CPU 的周期以限制容器的 CPU 使用率。通常--cpu-period应该与--cpu-quota一起使用。

示例

$ docker run -it --cpu-period=50000 --cpu-quota=25000 ubuntu:24.04 /bin/bash

如果有 1 个 CPU,这意味着容器每 50ms 可以获得 50% CPU 的运行时间。

除了使用--cpu-period--cpu-quota设置 CPU 周期约束外,还可以使用浮点数指定--cpus来实现相同目的。例如,如果只有一个 CPU,则--cpus=0.5将获得与设置--cpu-period=50000--cpu-quota=25000(50% CPU)相同的结果。

--cpus的默认值为0.000,这意味着没有限制。

有关更多信息,请参阅关于带宽限制的 CFS 文档

Cpuset 约束

我们可以设置允许容器执行的CPU。

示例

$ docker run -it --cpuset-cpus="1,3" ubuntu:24.04 /bin/bash

这意味着容器中的进程可以在 cpu 1 和 cpu 3 上执行。

$ docker run -it --cpuset-cpus="0-2" ubuntu:24.04 /bin/bash

这意味着容器中的进程可以在 cpu 0、cpu 1 和 cpu 2 上执行。

我们可以设置允许容器执行的内存节点。仅在 NUMA 系统上有效。

示例

$ docker run -it --cpuset-mems="1,3" ubuntu:24.04 /bin/bash

此示例将容器中的进程限制为仅使用内存节点 1 和 3 的内存。

$ docker run -it --cpuset-mems="0-2" ubuntu:24.04 /bin/bash

此示例将容器中的进程限制为仅使用内存节点 0、1 和 2 的内存。

CPU 配额约束

--cpu-quota标志限制容器的CPU使用率。默认值 0 允许容器占用 100% 的 CPU 资源(1 个 CPU)。CFS(完全公平调度程序)处理正在执行进程的资源分配,并且是内核使用的默认 Linux 调度程序。将此值设置为 50000 以将容器限制为 50% 的 CPU 资源。对于多个 CPU,请根据需要调整--cpu-quota。有关更多信息,请参阅关于带宽限制的 CFS 文档

块 IO 带宽 (Blkio) 约束

默认情况下,所有容器都获得相同比例的块IO带宽 (blkio)。此比例为 500。要修改此比例,请使用--blkio-weight标志更改容器的 blkio 权重相对于所有其他正在运行的容器的权重。

注意

blkio 权重设置仅适用于直接 IO。目前不支持缓冲 IO。

--blkio-weight标志可以将权重设置为 10 到 1000 之间的任何值。例如,以下命令创建两个具有不同 blkio 权重的容器

$ docker run -it --name c1 --blkio-weight 300 ubuntu:24.04 /bin/bash
$ docker run -it --name c2 --blkio-weight 600 ubuntu:24.04 /bin/bash

如果您同时在两个容器中执行块 IO,例如

$ time dd if=/mnt/zerofile of=test.out bs=1M count=1024 oflag=direct

您会发现时间比例与两个容器的 blkio 权重比例相同。

--blkio-weight-device="DEVICE_NAME:WEIGHT"标志设置特定设备的权重。DEVICE_NAME:WEIGHT是一个包含冒号分隔的设备名称和权重的字符串。例如,要将/dev/sda设备的权重设置为200

$ docker run -it \
    --blkio-weight-device "/dev/sda:200" \
    ubuntu

如果同时指定--blkio-weight--blkio-weight-device,Docker 将使用--blkio-weight作为默认权重,并使用--blkio-weight-device在特定设备上使用新值覆盖此默认值。以下示例使用 300 的默认权重,并在/dev/sda上将此默认权重覆盖为 200

$ docker run -it \
    --blkio-weight 300 \
    --blkio-weight-device "/dev/sda:200" \
    ubuntu

--device-read-bps标志限制从设备读取的速率(每秒字节数)。例如,此命令创建一个容器,并将从/dev/sda读取的速率限制为每秒1mb

$ docker run -it --device-read-bps /dev/sda:1mb ubuntu

--device-write-bps标志限制写入设备的速率(每秒字节数)。例如,此命令创建一个容器,并将写入/dev/sda的速率限制为每秒1mb

$ docker run -it --device-write-bps /dev/sda:1mb ubuntu

这两个标志都采用<device-path>:<limit>[unit]格式的限制。读写速率必须为正整数。您可以使用kb(千字节)、mb(兆字节)或gb(千兆字节)指定速率。

--device-read-iops标志限制从设备读取的速率(每秒IO次数)。例如,此命令创建一个容器,并将从/dev/sda读取的速率限制为每秒1000次IO。

$ docker run -it --device-read-iops /dev/sda:1000 ubuntu

--device-write-iops标志限制写入设备的速率(每秒IO次数)。例如,此命令创建一个容器,并将写入/dev/sda的速率限制为每秒1000次IO。

$ docker run -it --device-write-iops /dev/sda:1000 ubuntu

这两个标志都采用<device-path>:<limit>格式的限制。读写速率必须为正整数。

附加组

--group-add: Add additional groups to run as

默认情况下,docker容器进程使用为指定用户查找的补充组运行。如果想向该组列表添加更多组,可以使用此标志

$ docker run --rm --group-add audio --group-add nogroup --group-add 777 busybox id

uid=0(root) gid=0(root) groups=10(wheel),29(audio),99(nogroup),777

运行时权限和 Linux 功能

选项描述
--cap-add添加Linux功能
--cap-drop删除Linux功能
--privileged赋予此容器扩展权限
--device=[]允许您在容器内运行设备,无需--privileged标志。

默认情况下,Docker 容器是“非特权的”,例如,不能在 Docker 容器内运行 Docker 守护程序。这是因为默认情况下,容器不允许访问任何设备,但“特权”容器可以访问所有设备(请参阅有关cgroups 设备 的文档)。

--privileged标志赋予容器所有功能。当操作员执行docker run --privileged时,Docker 将启用对主机上所有设备的访问,并重新配置 AppArmor 或 SELinux 以允许容器几乎与在主机上容器外部运行的进程具有相同的对主机的访问权限。谨慎使用此标志。有关--privileged标志的更多信息,请参阅docker run 参考

如果要限制对特定设备或设备的访问,可以使用--device标志。它允许您指定一个或多个可在容器内访问的设备。

$ docker run --device=/dev/snd:/dev/snd ...

默认情况下,容器将能够读取写入mknod这些设备。可以使用第三个:rwm选项集覆盖每个--device标志。

$ docker run --device=/dev/sda:/dev/xvdc --rm -it ubuntu fdisk  /dev/xvdc

Command (m for help): q
$ docker run --device=/dev/sda:/dev/xvdc:r --rm -it ubuntu fdisk  /dev/xvdc
You will not be able to write the partition table.

Command (m for help): q

$ docker run --device=/dev/sda:/dev/xvdc:w --rm -it ubuntu fdisk  /dev/xvdc
    crash....

$ docker run --device=/dev/sda:/dev/xvdc:m --rm -it ubuntu fdisk  /dev/xvdc
fdisk: unable to open /dev/xvdc: Operation not permitted

除了--privileged之外,操作员还可以使用--cap-add--cap-drop对功能进行细粒度控制。默认情况下,Docker 具有保留的默认功能列表。下表列出了默认允许并可以删除的 Linux 功能选项。

功能键功能描述
AUDIT_WRITE将记录写入内核审计日志。
CHOWN对文件UID和GID进行任意更改(参见chown(2))。
DAC_OVERRIDE绕过文件读取、写入和执行权限检查。
FOWNER绕过通常需要进程的文件系统UID与文件的UID匹配的操作的权限检查。
FSETID修改文件时,不要清除set-user-ID和set-group-ID权限位。
KILL绕过发送信号的权限检查。
MKNOD使用mknod(2)创建特殊文件。
NET_BIND_SERVICE将套接字绑定到互联网域特权端口(端口号小于 1024)。
NET_RAW使用RAW和PACKET套接字。
SETFCAP设置文件功能。
SETGID对进程GID和补充GID列表进行任意操作。
SETPCAP修改进程功能。
SETUID对进程UID进行任意操作。
SYS_CHROOT使用chroot(2),更改根目录。

下表显示默认情况下未授予并且可以添加的功能。

功能键功能描述
AUDIT_CONTROL启用和禁用内核审计;更改审计筛选器规则;检索审计状态和筛选器规则。
AUDIT_READ允许通过组播 netlink 套接字读取审计日志。
BLOCK_SUSPEND允许阻止系统挂起。
BPF允许创建BPF映射,加载BPF类型格式(BTF)数据,检索BPF程序的JIT代码等等。
CHECKPOINT_RESTORE允许检查点/恢复相关操作。在内核 5.9 中引入。
DAC_READ_SEARCH绕过文件读取权限检查和目录读取和执行权限检查。
IPC_LOCK锁定内存 (mlock(2)、mlockall(2)、mmap(2)、shmctl(2))。
IPC_OWNER绕过对 System V IPC 对象的操作的权限检查。
LEASE在任意文件上建立租约(参见fcntl(2))。
LINUX_IMMUTABLE设置FS_APPEND_FL和FS_IMMUTABLE_FL i-node标志。
MAC_ADMIN允许MAC配置或状态更改。为Smack LSM实现。
MAC_OVERRIDE覆盖强制访问控制 (MAC)。为 Smack Linux 安全模块 (LSM) 实现。
NET_ADMIN执行各种网络相关操作。
NET_BROADCAST进行套接字广播,并收听组播。
PERFMON允许使用perf_events、i915_perf和其他内核子系统进行系统性能和可观察性特权操作
SYS_ADMIN执行一系列系统管理操作。
SYS_BOOT使用reboot(2)和kexec_load(2),重新启动并加载新的内核以供以后执行。
SYS_MODULE加载和卸载内核模块。
SYS_NICE提高进程 nice 值 (nice(2)、setpriority(2)) 并更改任意进程的 nice 值。
SYS_PACCT使用acct(2),启用或禁用进程会计。
SYS_PTRACE使用ptrace(2)跟踪任意进程。
SYS_RAWIO执行I/O端口操作(iopl(2)和ioperm(2))。
SYS_RESOURCE覆盖资源限制。
SYS_TIME设置系统时钟 (settimeofday(2)、stime(2)、adjtimex(2));设置实时(硬件)时钟。
SYS_TTY_CONFIG使用vhangup(2);对虚拟终端采用各种特权ioctl(2)操作。
SYSLOG执行特权syslog(2)操作。
WAKE_ALARM触发将唤醒系统的内容。

更多参考信息可在capabilities(7) - Linux 手册页Linux 内核源代码 中找到。

这两个标志都支持值ALL,因此要允许容器使用除MKNOD之外的所有功能

$ docker run --cap-add=ALL --cap-drop=MKNOD ...

--cap-add--cap-drop 标记接受以 CAP_ 前缀指定的权限。因此,以下示例是等效的

$ docker run --cap-add=SYS_ADMIN ...
$ docker run --cap-add=CAP_SYS_ADMIN ...

为了与网络堆栈交互,应该使用 --cap-add=NET_ADMIN 来修改网络接口,而不是使用 --privileged

$ docker run -it --rm  ubuntu:24.04 ip link add dummy0 type dummy

RTNETLINK answers: Operation not permitted

$ docker run -it --rm --cap-add=NET_ADMIN ubuntu:24.04 ip link add dummy0 type dummy

要挂载基于 FUSE 的文件系统,需要同时使用 --cap-add--device

$ docker run --rm -it --cap-add SYS_ADMIN sshfs sshfs sven@10.10.10.20:/home/sven /mnt

fuse: failed to open /dev/fuse: Operation not permitted

$ docker run --rm -it --device /dev/fuse sshfs sshfs sven@10.10.10.20:/home/sven /mnt

fusermount: mount failed: Operation not permitted

$ docker run --rm -it --cap-add SYS_ADMIN --device /dev/fuse sshfs

# sshfs sven@10.10.10.20:/home/sven /mnt
The authenticity of host '10.10.10.20 (10.10.10.20)' can't be established.
ECDSA key fingerprint is 25:34:85:75:25:b0:17:46:05:19:04:93:b5:dd:5f:c6.
Are you sure you want to continue connecting (yes/no)? yes
sven@10.10.10.20's password:

root@30aa0cfaf1b5:/# ls -la /mnt/src/docker

total 1516
drwxrwxr-x 1 1000 1000   4096 Dec  4 06:08 .
drwxrwxr-x 1 1000 1000   4096 Dec  4 11:46 ..
-rw-rw-r-- 1 1000 1000     16 Oct  8 00:09 .dockerignore
-rwxrwxr-x 1 1000 1000    464 Oct  8 00:09 .drone.yml
drwxrwxr-x 1 1000 1000   4096 Dec  4 06:11 .git
-rw-rw-r-- 1 1000 1000    461 Dec  4 06:08 .gitignore
....

默认的 seccomp 配置文件会根据选择的权限进行调整,以允许使用权限允许的功能,因此您无需调整此设置。

覆盖镜像默认值

Dockerfile构建镜像或提交镜像时,您可以设置多个在镜像作为容器启动时生效的默认参数。运行镜像时,可以使用 docker run 命令的标志覆盖这些默认值。

默认命令和选项

docker run 命令语法支持可选地为容器的入口点指定命令和参数,在以下概要示例中表示为 [COMMAND][ARG...]

$ docker run [OPTIONS] IMAGE[:TAG|@DIGEST] [COMMAND] [ARG...]

此命令是可选的,因为创建 IMAGE 的人可能已经使用 Dockerfile 的 CMD 指令提供了默认的 COMMAND。运行容器时,只需指定新的 COMMAND 即可覆盖该 CMD 指令。

如果镜像还指定了 ENTRYPOINT,则 CMDCOMMAND 将作为参数附加到 ENTRYPOINT

默认入口点

--entrypoint="": Overwrite the default entrypoint set by the image

入口点是指运行容器时调用的默认可执行文件。容器的入口点使用 Dockerfile 的 ENTRYPOINT 指令定义。它类似于指定默认命令,因为它指定了默认命令,但区别在于需要传递显式标志来覆盖入口点,而可以使用位置参数来覆盖默认命令。它定义了容器的默认行为,其理念是,当设置入口点时,您可以运行容器,_就好像它是该二进制文件一样_,包括默认选项,并且您可以将更多选项作为命令传递。但是,在某些情况下,您可能希望在容器内运行其他内容。这时,使用 docker run 命令的 --entrypoint 标志在运行时覆盖默认入口点就派上用场了。

--entrypoint 标志需要一个字符串值,表示容器启动时要调用的二进制文件的名称或路径。以下示例显示如何在已设置为自动运行其他二进制文件(如 /usr/bin/redis-server)的容器中运行 Bash shell

$ docker run -it --entrypoint /bin/bash example/redis

以下示例显示如何使用位置命令参数将附加参数传递给自定义入口点。

$ docker run -it --entrypoint /bin/bash example/redis -c ls -l
$ docker run -it --entrypoint /usr/bin/redis-cli example/redis --help

例如,可以通过传递空字符串来重置容器的入口点。

$ docker run -it --entrypoint="" mysql bash

注意

传递 --entrypoint 会清除镜像上设置的任何默认命令。也就是说,构建它时使用的 Dockerfile 中的任何 CMD 指令。

公开端口

默认情况下,运行容器时,没有任何容器端口暴露给主机。这意味着您将无法访问容器可能正在侦听的任何端口。要使容器的端口可从主机访问,需要发布这些端口。

可以使用 -P-p 标志启动容器以暴露其端口

  • -P(或 --publish-all)标志将所有暴露的端口发布到主机。Docker 将每个暴露的端口绑定到主机上的随机端口。

    -P 标志仅发布明确标记为已暴露的端口号,可以使用 Dockerfile 的 EXPOSE 指令或 docker run 命令的 --expose 标志。

  • -p(或 --publish)标志允许您显式地将容器中的单个端口或端口范围映射到主机。

容器内的端口号(服务侦听的位置)不需要与容器外部发布的端口号(客户端连接的位置)匹配。例如,在容器内,HTTP 服务可能正在侦听端口 80。在运行时,该端口可能绑定到主机上的 42800。要查找主机端口和暴露端口之间的映射,可以使用 docker port 命令。

环境变量

Docker 在创建 Linux 容器时会自动设置一些环境变量。Docker 在创建 Windows 容器时不会设置任何环境变量。

为 Linux 容器设置以下环境变量:

变量
HOME基于 USER 的值设置
HOSTNAME与容器关联的主机名
PATH包含常用目录,例如 /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
TERM如果为容器分配了伪 TTY,则为 xterm

此外,可以使用一个或多个 -e 标志设置容器中的任何环境变量。甚至可以覆盖上面提到的变量,或者在构建镜像时使用 Dockerfile ENV 指令定义的变量。

如果命名环境变量而未指定值,则主机上命名变量的当前值将传播到容器的环境中。

$ export today=Wednesday
$ docker run -e "deep=purple" -e today --rm alpine env

PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
HOSTNAME=d2219b854598
deep=purple
today=Wednesday
HOME=/root
PS C:\> docker run --rm -e "foo=bar" microsoft/nanoserver cmd /s /c set
ALLUSERSPROFILE=C:\ProgramData
APPDATA=C:\Users\ContainerAdministrator\AppData\Roaming
CommonProgramFiles=C:\Program Files\Common Files
CommonProgramFiles(x86)=C:\Program Files (x86)\Common Files
CommonProgramW6432=C:\Program Files\Common Files
COMPUTERNAME=C2FAEFCC8253
ComSpec=C:\Windows\system32\cmd.exe
foo=bar
LOCALAPPDATA=C:\Users\ContainerAdministrator\AppData\Local
NUMBER_OF_PROCESSORS=8
OS=Windows_NT
Path=C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0\;C:\Users\ContainerAdministrator\AppData\Local\Microsoft\WindowsApps
PATHEXT=.COM;.EXE;.BAT;.CMD
PROCESSOR_ARCHITECTURE=AMD64
PROCESSOR_IDENTIFIER=Intel64 Family 6 Model 62 Stepping 4, GenuineIntel
PROCESSOR_LEVEL=6
PROCESSOR_REVISION=3e04
ProgramData=C:\ProgramData
ProgramFiles=C:\Program Files
ProgramFiles(x86)=C:\Program Files (x86)
ProgramW6432=C:\Program Files
PROMPT=$P$G
PUBLIC=C:\Users\Public
SystemDrive=C:
SystemRoot=C:\Windows
TEMP=C:\Users\ContainerAdministrator\AppData\Local\Temp
TMP=C:\Users\ContainerAdministrator\AppData\Local\Temp
USERDOMAIN=User Manager
USERNAME=ContainerAdministrator
USERPROFILE=C:\Users\ContainerAdministrator
windir=C:\Windows

健康检查

docker run 命令的以下标志允许您控制容器健康检查的参数:

选项描述
--health-cmd运行以检查健康的命令
--health-interval运行检查之间的时间间隔
--health-retries需要报告不健康的连续失败次数
--health-timeout允许一个检查运行的最长时间
--health-start-period容器在启动健康检查倒计时之前初始化的启动时间段
--health-start-interval启动期间运行检查之间的时间间隔
--no-healthcheck禁用任何容器指定的 HEALTHCHECK

示例

$ docker run --name=test -d \
    --health-cmd='stat /etc/passwd || exit 1' \
    --health-interval=2s \
    busybox sleep 1d
$ sleep 2; docker inspect --format='{{.State.Health.Status}}' test
healthy
$ docker exec test rm /etc/passwd
$ sleep 2; docker inspect --format='{{json .State.Health}}' test
{
  "Status": "unhealthy",
  "FailingStreak": 3,
  "Log": [
    {
      "Start": "2016-05-25T17:22:04.635478668Z",
      "End": "2016-05-25T17:22:04.7272552Z",
      "ExitCode": 0,
      "Output": "  File: /etc/passwd\n  Size: 334       \tBlocks: 8          IO Block: 4096   regular file\nDevice: 32h/50d\tInode: 12          Links: 1\nAccess: (0664/-rw-rw-r--)  Uid: (    0/    root)   Gid: (    0/    root)\nAccess: 2015-12-05 22:05:32.000000000\nModify: 2015..."
    },
    {
      "Start": "2016-05-25T17:22:06.732900633Z",
      "End": "2016-05-25T17:22:06.822168935Z",
      "ExitCode": 0,
      "Output": "  File: /etc/passwd\n  Size: 334       \tBlocks: 8          IO Block: 4096   regular file\nDevice: 32h/50d\tInode: 12          Links: 1\nAccess: (0664/-rw-rw-r--)  Uid: (    0/    root)   Gid: (    0/    root)\nAccess: 2015-12-05 22:05:32.000000000\nModify: 2015..."
    },
    {
      "Start": "2016-05-25T17:22:08.823956535Z",
      "End": "2016-05-25T17:22:08.897359124Z",
      "ExitCode": 1,
      "Output": "stat: can't stat '/etc/passwd': No such file or directory\n"
    },
    {
      "Start": "2016-05-25T17:22:10.898802931Z",
      "End": "2016-05-25T17:22:10.969631866Z",
      "ExitCode": 1,
      "Output": "stat: can't stat '/etc/passwd': No such file or directory\n"
    },
    {
      "Start": "2016-05-25T17:22:12.971033523Z",
      "End": "2016-05-25T17:22:13.082015516Z",
      "ExitCode": 1,
      "Output": "stat: can't stat '/etc/passwd': No such file or directory\n"
    }
  ]
}

健康状态也显示在 docker ps 输出中。

用户

容器中的默认用户是 root (uid = 0)。可以使用 Dockerfile 的 USER 指令设置默认用户以运行第一个进程。启动容器时,可以使用 -u 选项覆盖 USER 指令。

-u="", --user="": Sets the username or UID used and optionally the groupname or GID for the specified command.

以下示例均有效

--user=[ user | user:group | uid | uid:gid | user:gid | uid:group ]

注意

如果传递数值用户 ID,则它必须在 0-2147483647 范围内。如果传递用户名,则用户必须存在于容器中。

工作目录

在容器内运行二进制文件的默认工作目录是根目录 (/)。可以使用 Dockerfile 的 WORKDIR 命令设置镜像的默认工作目录。可以使用 docker run 命令的 -w(或 --workdir)标志覆盖镜像的默认工作目录。

$ docker run --rm -w /my/workdir alpine pwd
/my/workdir

如果该目录在容器中尚不存在,则会创建它。