本文共 13660 字，大约阅读时间需要 45 分钟。
Usage: docker run [OPTIONS] IMAGE [COMMAND] [ARG...]
-a, --attach=[] Attach to STDIN, STDOUT or STDERR
如果在执行 run 命令时没有指定 -a，那么 docker 默认会挂载所有标准数据流，包括输入输出和错误。你可以特别指定挂载哪个标准流。
$ docker run -a stdin -a stdout -i -t ubuntu:14.04 /bin/bash
(只挂载标准输入输出)
--add-host=[] Add a custom host-to-IP mapping (host:ip)
添加 host-ip 到容器的 hosts 文件
$ docker run -it --add-host db:192.168.1.1 ubuntu:14.04 /bin/bashroot@70887853379d:/# cat /etc/hosts 172.17.0.2 70887853379d 127.0.0.1 localhost ::1 localhost ip6-localhost ip6-loopback fe00::0 ip6-localnet ff00::0 ip6-mcastprefix ff02::1 ip6-allnodes ff02::2 ip6-allrouters 192.168.1.1 db
--blkio-weight=0 Block IO (relative weight), between 10 and 1000
相对于 CPU 和 内存 的配额控制，docker 对磁盘 IO 的控制相对不成熟，大多数都必须在有宿主机设备的情况下使用。主要包括以下参数：
DEVICE_NAME:WEIGHT 存储配额控制的相关参数，可以参考Red Hat 文档中 blkio 这一章，了解它们的详细作用。blkio-weight
要使 –blkio-weight 生效，需要保证 IO 的调度算法为 CFQ。可以使用下面的方式查看：
root@ubuntu:~# cat /sys/block/sda/queue/schedulernoop [deadline] cfq
使用下面的命令创建两个 –blkio-weight 值不同的容器：
$ docker run -ti –rm –blkio-weight 100 ubuntu:stress$ docker run -ti –rm –blkio-weight 1000 ubuntu:stress
在容器中同时执行下面的 dd 命令，进行测试：
time dd if=/dev/zero of=test.out bs=1M count=1024 oflag=direct
device-write-bps
使用下面的命令创建容器，并执行命令验证写速度的限制。
$ docker run -tid –name disk1 –device-write-bps /dev/sda:1mb ubuntu:stress
在 docker 使用 devicemapper 作为存储驱动时，默认每个容器和镜像的最大大小为 10 G。如果需要调整，可以在 daemon 启动参数中，使用 dm.basesize 来指定，但需要注意的是，修改这个值，不仅仅需要重启 docker daemon 服务，还会导致宿主机上的所有本地镜像和容器都被清理掉。
使用 aufs 或者 overlay 等其他存储驱动时，没有这个限制。--cidfile= Write the container ID to the file
将 container ID 保存到 cid_file, 保存的格式为长 UUID
$ docker run -it --cidfile=cid_file ubuntu:14.04 /bin/bash #cat cid_file 5fcf835f2688844d1370e6775247c35c9d36d47061c4fc73e328f9ebf920b402
--cpu-shares=0 CPU shares (relative weight)
默认情况下，使用 -c 或者 --cpu-shares 参数值为0，可以赋予当前活动 container 1024个 cpu 共享周期。这个0值可以针对活动的 container 进行修改来调整不同的 cpu 循环周期。
比如，我们使用 -c 或者 --cpu-shares=0 启动了 C0，C1，C2 三个c ontainer，使用 -c/–cpu-shares=512 启动了C3.这时，C0，C1，C2 可以 100%的使用 CPU 资源(1024)，但 C3 只能使用 50%的 CPU 资源(512)。如果这个 host 的 OS 是时序调度类型的，每个 CPU 时间片是 100 微秒，那么C0，C1，C2将完全使用掉这 100 微秒，而 C3 只能使用 50 微秒。--cpu-period=0 Limit CPU CFS (Completely Fair Scheduler) period --cpu-quota=0 Limit CPU CFS (Completely Fair Scheduler) quota
–cpu-period 和 --cpu-quota，这两个参数是相互配合的，–cpu-period 和 --cpu-quota 的这种配置叫 Ceiling Enforcement Tunable Parameters，–cpu-shares 的这种配置叫 Relative Shares Tunable Parameters。–cpu-period是用来指定容器对CPU的使用要在多长时间内做一次重新分配，而 --cpu-quota 是用来指定在这个周期内，最多可以有多少时间用来跑这个容器。跟 --cpu-shares 不同的是这种配置是指定一个绝对值，而且没有弹性在里面，容器对CPU资源的使用绝对不会超过配置的值。
比如说 A 容器配置的 --cpu-period=100000 --cpu-quota=50000，那么 A 容器就可以最多使用 50% 个 CPU 资源，如果配置的–cpu-quota=200000，那就可以使用 200% 个 CPU 资源。
那么有什么样的应用场景呢？简单举个例子，加入对外提供 A 和 B 两个服务，但是 A 的优先级比 B 要高，假如只用 --cpu-shares来配置，B 服务占用资源太高时是会对 A 有一定的影响的，但是如果通过 --cpu-period 和 --cpu-quota 来配置，就能起到绝对的控制，做到无论B怎么样，都不会影响到 A。
cpu-period 和 cpu-quota 的单位为微秒（μs）。cpu-period的最小值为1000微秒，最大值为1秒（10^6 μs），默认值为 0.1 秒（100000 μs）。cpu-quota 的值默认为 -1，表示不做控制。
--cpuset-cpus= CPUs in which to allow execution (0-3, 0,1) --cpuset-mems= MEMs in which to allow execution (0-3, 0,1)
对多核 CPU 的服务器，docker 还可以控制容器运行限定使用哪些 cpu 内核和内存节点，即使用 –cpuset-cpus 和 –cpuset-mems参数。对具有 NUMA 拓扑（具有多 CPU、多内存节点）的服务器尤其有用，可以对需要高性能计算的容器进行性能最优的配置。如果服务器只有一个内存节点，则 –cpuset-mems 的配置基本上不会有明显效果。
使用示例：
#表示创建的容器只能用 0、1、2 这三个内核。最终生成的 cgroup 的cpu docker run -tid –name cpu1 –cpuset-cpus 0-2 ubuntu
内核配置如下：
# cat /sys/fs/cgroup/cpuset/docker/ <容器的完整长id> /cpuset.cpus 0-2
通过 docker exec <容器ID> taskset -c -p 1(容器内部第一个进程编号一般为1)，可以看到容器中进程与 CPU 内核的绑定关系，可以认为达到了绑定 CPU 内核的目的。
-d, --detach=false Run container in background and print container ID
如果在 docker run 后面追加 -d=true 或者 -d，则 containter 将会运行在后台模式(Detached mode)。此时所有 I/O 数据只能通过网络资源或者共享卷组来进行交互。因为 container 不再监听你执行 docker run 的这个终端命令行窗口。但你可以通过执行docker attach 来重新挂载这个container 里面。需要注意的时，如果你选择执行 -d 使 container 进入后台模式，那么将无法配合"–rm"参数。
--device=[] Add a host device to the container
--disable-content-trust=true Skip image verification
跳过镜像验证。
--dns=[] Set custom DNS servers
自定义DNS：
$ docker run -it --dns=8.8.8.8 --rm ubuntu:14.04 /bin/bash root@b7a6f0e63e65:/# cat /etc/resolv.conf nameserver 8.8.8.8
--dns-opt=[] Set DNS options
--dns-search=[] Set custom DNS search domains
-e, --env=[] Set environment variables
自这义环境变量
--entrypoint= Overwrite the default ENTRYPOINT of the image
字面意思是进入点，而它的功能也恰如其意。
An ENTRYPOINT allows you to configure a container that will run as an executable.
它可以让你的容器功能表现得像一个可执行程序一样。
使用下面的 ENTRYPOINT 构造镜像：
ENTRYPOINT ["/bin/echo"]
那么 docker build 出来的镜像以后的容器功能就像一个 /bin/echo 程序：
比如我 build 出来的镜像名称叫 imageecho，那么我可以这样用它：docker run -it imageecho “this is a test”
这里就会输出”this is a test”这串字符，而这个 imageecho 镜像对应的容器表现出来的功能就像一个 echo 程序一样。 你添加的参数“this is a test”会添加到 ENTRYPOINT 后面，就成了这样 /bin/echo “this is a test” 。
ENTRYPOINT ["/bin/cat"]
构造出来的镜像你可以这样运行(假设名为 st)：
docker run -it st /etc/fstab
这样相当： /bin/cat /etc/fstab 这个命令的作用。运行之后就输出 /etc/fstab 里的内容。
–env-file--env-file=[] Read in a file of environment variables
读取设置环境变量的文件。
--expose=[] Expose a port or a range of ports
告诉 Docker 服务端容器暴露的端口号，供互联系统使用。
$ docker run -it --expose=22 --rm ubuntu:14.04 /bin/bash
--group-add=[] Add additional groups to join
-h, --hostname= Container host name
设置容器主机名。
$ docker run -it --hostname=web --rm ubuntu:14.04 /bin/bash
进入容器后
root@web:/#
-i, --interactive=false Keep STDIN open even if not attached
保持标准输入，常同 -t 一起使用来申请一个控制台进行数据交互。
--ipc= IPC namespace to use
IPC(POSIX/SysV IPC) 命名空间提供了相互隔离的命名共享内存，信号灯变量和消息队列。
共享内存可以提高进程数据交互速度。共享内存一般用在 database 和高性能应用(C/OpenMPI, C++/using boost libraries)上或者金融服务上。如果需要容器里面部署上述类型的应用，那么就应该在多个容器直接采取共享内存了。--kernel-memory= Kernel memory limit
内核内存，不会被交换到 swap 上。一般情况下，不建议修改，可以直接参考 docker 的官方文档。
-l, --label=[] Set meta data on a container --label-file=[] Read in a line delimited file of labels
--link=[] Add link to another container
用于连接两个容器。
启动容器1：web
$ docker run --name web -d -p 22 -p 80 -it webserver:v1
启动容器2：ap1连接到web，并命名为apache
$ docker run --name ap1 --link=web:apache -d -p 22 -p 80 -it webserver:v1
--log-driver= Logging driver for container --log-opt=[] Log driver options
Docker 增加了对 json-file 型（默认）log driver 的 rotate 功能，我们可通过 max-size 和 max-file 两个 –log-opt 来配置。
比如：我们启动一个 nginx 容器，采用 json-file日志引擎，每个 log 文件限制最大为 1 k，轮转的日志个数为 5 个：
docker run -d --log-driver=json-file --log-opt max-size=1k --log-opt max-file=5 --name webserver -p 9988:80 nginx
有了 rotate，我们就不必担心某个 container 的日志暴涨而将同 host 的其他 container 拖死了。
--mac-address= Container MAC address(e.g. 92:d0:c6:0a:29:33)
设置容器的 mac 地址。
-m, --memory= Memory limit
设置容器使用的最大内存上限。默认单位为 byte，可以使用 K、G、M 等带单位的字符串。
默认情况下，容器可以使用主机上的所有空闲内存。设置容器的内存上限，参考命令如下所示：
docker run -tid —name mem1 —memory 128m ubuntu:14.04 /bin/bash
默认情况下，除了 –memory 指定的内存大小以外，docker 还为容器分配了同样大小的 swap 分区，也就是说，上面的命令创建出的容器实际上最多可以使用 256 MB内存，而不是 128 MB内存。如果需要自定义 swap 分区大小，则可以通过联合使用 –memory–swap 参数来实现控制。
对上面的命令创建的容器，可以查看到在 cgroups 的配置文件中，查看到容器的内存大小为 128 MB (128×1024×1024=134217728B)，内存和 swap 加起来大小为 256MB (256×1024×1024=268435456B)。#cat /sys/fs/cgroup/memory/docker/ <容器的完整id> /memory.limit_in_bytes134217728#cat /sys/fs/cgroup/memory/docker/ <容器的完整id> /memory.memsw.limit_in_bytes268435456
注意：
执行上述命令时，命令行可能会输出下面的警告：
WARNING: Your kernel does not support swap limit capabilities, memory limited without swap. 这是因为主机上默认不启用 cgroup 来控制 swap 分区，可以参考 docker 官方的相应文档，修改 grub 启动参数。
--memory-reservation= Memory soft limit
启用弹性的内存共享，当宿主机资源充足时，允许容器尽量多地使用内存，当检测到内存竞争或者低内存时，强制将容器的内存降低到 memory-reservation 所指定的内存大小。按照官方说法，不设置此选项时，有可能出现某些容器长时间占用大量内存，导致性能上的损失。
--memory-swap= Total memory (memory + swap), '-1' to disable swap
等于内存和 swap 分区大小的总和，设置为 -1 时，表示 swap 分区的大小是无限的。默认单位为 byte，可以使用 K、G、M 等带单位的字符串。如果 –memory-swap 的设置值小于 –memory 的值，则使用默认值，为 –memory-swap 值的两倍。
--memory-swappiness=-1 Tuning container memory swappiness (0 to 100)
控制进程将物理内存交换到 swap 分区的倾向，默认系数为 60。系数越小，就越倾向于使用物理内存。值范围为 0-100。当值为100 时，表示尽量使用 swap 分区；当值为 0 时，表示禁用容器 swap 功能(这点不同于宿主机，宿主机 swappiness 设置为 0 也不保证 swap 不会被使用)。
--name= Assign a name to the container
为容器指定一个名字。
$ docker run -it --name=web ubuntu:14.04 /bin/bash
--net=default Set the Network for the container
以下是网络设置中常用的参数：
none 关闭 container 内的网络连接：
将网络模式设置为 none 时，这个 container 将不允许访问任何外部 router。这个 container 内部只会有一个 loopback 接口，而且不存在任何可以访问外部网络的 outer。bridge 通过veth接口来连接 contianer 默认选项：
Docker 默认是将 container 设置为 bridge 模式。此时在 host 上面讲存在一个 docker0 的网络接口，同时会针对 container 创建一对 veth 接口。其中一个 veth 接口是在 host 充当网卡桥接作用，另外一个 veth 接口存在于 container 的命名空间中，并且指向 container 的 loopback。Docker 会自动给这个 container 分配一个IP，并且将 container 内的数据通过桥接转发到外部。host 允许 container 使用 host 的网络堆栈信息：
当网络模式设置为 host 时，这个 container 将完全共享 host 的网络堆栈。host 所有的网络接口将完全对 container 开放。container 的主机名也会存在于 host 的 hostname 中。这时，container 所有对外暴露的 port 和对其它 container 的 link，将完全失效。Container：
当网络模式设置为 Container 时，这个 container 将完全复用另外一个 container 的网络堆栈。同时使用时这个 container 的名称必须要符合下面的格式：–net container:. 比如当前有一个绑定了本地地址 localhost 的 redis container。如果另外一个 container 需要复用这个网络堆栈，则需要如下操作：$ docker run -d --name redis example/redis --bind 127.0.0.1 # use the redis container's network stack to access localhost $ sudo docker run --rm -ti --net container:redis example/redis-cli -h 127.0.0.1
--oom-kill-disable=false Disable OOM Killer
-P, --publish-all=false Publish all exposed ports to random ports
对外映射所有端口。
-p, --publish=[] Publish a container's port(s) to the host
对外映射指定端口，如不指定映射后的端口将随机指定。
$ docker run –d -p 10022:22 -p 10080:80 -it webserver:v1
使用 docker run 来启动我们创建的容器。-d让容器以后台方式运行。使用多个-p来映射多个端口，将容器的22端口映射为本地的10022,80映射为10080。
--pid= PID namespace to use
设置容器的 PID 模式。两种：
host: use the host's PID namespace inside the container. Note: the host mode gives the container full access to local PID and is therefore considered insecure.
--privileged=false Give extended privileges to this container
默认情况下container是不能访问任何其他设备的。但是通过"privileged"，container就拥有了访问任何其他设备的权限。
当操作者执行docker run --privileged时，Docker将拥有访问host所有设备的权限$ docker run -it --rm --privileged ubuntu:14.04 /bin/bash
--read-only=false Mount the container's root filesystem as read only
启用后，容器的文件系统将为只读。
$ docker run -it --rm --read-only ubuntu:14.04 /bin/bash root@d793e24f0af1:/# touch a touch: cannot touch 'a': Read-only file system
示例：
$ docker run -it --restart=always ubuntu:14.04 /bin/bash
--rm=false Automatically remove the container when it exits
当容器退出时，清除所有该容器的信息。
--security-opt=[] Security Options
安全选项。
--sig-proxy=true|false Proxy received signals to the process (non-TTY mode only). SIGCHLD, SIGSTOP, and SIGKILL are not proxied. The default is true.
--stop-signal=SIGTERM Signal to stop a container, SIGTERM by default
-t, --tty=false Allocate a pseudo-TTY
分配一个模拟终端，常和 -i 一块使用.