docker 命令官方文档Reference documentation | Docker Documentation
Docker 环境信息命令
docker info
docker info : 显示 Docker 系统信息，包括镜像和容器数。
docker info [OPTIONS]
docker version
docker version :显示 Docker 版本信息。
docker version [OPTIONS]
OPTIONS说明：
-f :指定返回值的模板文件。
系统日志信息常用命令
docker events
docker events : 从服务器获取实时事件
docker events [OPTIONS]
OPTIONS说明：
-f ：根据条件过滤事件；
--since ：从指定的时间戳后显示所有事件;
--until ：流水时间显示到指定的时间为止；
//第一个终端执行 docker events
//第二个终端操作容器 docker start/stop/restart
//查看第一个终端输出
docker logs
docker logs : 获取容器的日志
docker logs [OPTIONS] CONTAINER
OPTIONS说明：
-f : 跟踪日志输出
--since :显示某个开始时间的所有日志
-t : 显示时间戳 --tail :仅列出最新N条容器日志
docker logs -f mynginx
docker history
docker history : 查看指定镜像的创建历史。
docker history [OPTIONS] IMAGE
OPTIONS说明：
-H :以可读的格式打印镜像大小和日期，默认为true；
--no-trunc :显示完整的提交记录；
-q :仅列出提交记录ID
docker history mynginx:v1
容器的生命周期管理命令
docker create
docker create ：创建一个新的容器但不启动它
语法同docker run
docker run
docker run :创建一个新的容器并运行一个命令
docker run [OPTIONS] IMAGE [COMMAND] [ARG...]
常用选项
1. --add-host：容器中hosts文件添加 host:ip 映射记录
docker run --rm -it --add-host db-static:86.75.30.9 ubuntu cat /etc/hosts
2. -a, --attach：附加到 STDIN, STDOUT 或 STDERR
docker run --rm -a stdin -a stdout -i -t ubuntu /bin/bash
3. --cidfile：将容器id写入到指定文件
docker run --rm --cidfile /tmp/idfile ubuntu
4. -d, --detach：后台运行容器并打印容器id
5. --detach-keys：指定将容器切回后台的按键，默认：CTRL-p+CTRL-q
6. --disable-content-trust：跳过镜像验证，默认为TRUE
7. --domainname：设置容器网络服务域名 8. --entrypoint：覆盖镜像默认程序入口
docker run --rm -it --entrypoint /bin/bash nginx
9. -e, --env：设置环境变量
10. --env-file：从文件中读取环境变量
11. --expose：暴露一个或多个端口
12. --group-add：为容器用户添加更多用户组
docker run --rm --group-add audio --group-add nogroup --group-add 777 ubuntu id
13. -h, --hostname string：设置主机名
14. --init 在容器内运行init，转发信号并捕获进程
# ps 对比容器的元祖进程
docker run --rm -it ubuntu bash
docker run --rm -it --init ubuntu bash
15. -i, --interactive：保持标准输入设备处于打开状态
16. -l, --label list：设置容器元数据labels
17. --label-file list：从文件中读取以换行作为分隔符的label
18. --link：添加一个其他容器的链接，及修改当容器的/etc/hosts文件
19. --log-driver：容器日志驱动，none、local、json-file、syslog、journald、gelf、fluentd、 awslogs、splunk、etwlogs、gcplogs、logentries
20. --log-opt：日志驱动选项
21. --mount：将文件系统挂载到容器，与 -v 类似
# 挂载volume
docker run -t -i --rm --mount type=volume,target=/data ubuntu bash
# 创建目录
mkdir /tmp/data
# 修改目录所有权，仅当使用userns的情况下需要
sudo chown 165536:root /tmp/data
# bind 磁盘已存在目录
docker run -t -i --rm --mount type=bind,src=/tmp/data,dst=/data ubuntu bash
22. --name：指定容器名称
23. --privileged：授予容器超级权限
24. -p, --publish：发布容器端口都主机端口
25. -P, --publish-all：将所有暴露的端口发布到主机随机端口
26. --pull：运行前拉取图像，（always|missing|never）,默认 missing
27. --pids-limit：限制容器中pid个数
28. --read-only ：将容器跟文件系统装载为只读 29. --restart：当容器退出时的重启策略，默认为no
no：当容器退出时，不要自动重新启动
on-failure[:max-retries]：仅当容器以非零退出状态退出时才重新启动。
always：无论退出状态如何，始终重新启动容器。无论容器的当前状态如何，容器也将 始终在守护程序 启动时启动
unless-stopped：论退出状态如何，始终重新启动容器，包括守护程序启动时，除非容 器在Docker守护 程序停止之前处于停止状态。
27. --rm：当容器退出时，自动删除容器
28. --sig-proxy：将接收到的信号代理到进程（默认为true）
29. --stop-signal：停止容器的信号（默认为“SIGTERM”）
30. --stop-timeout：容器停止超时时长，单位s
31. --tmpfs：装载tmpfs目录
docker run -dit --rm --tmpfs /run1:rw,noexec,nosuid,size=65536k ubuntu bash
32. -t, --tty：分配一个伪终端设备
33. -u, --user： 用户名或用户ID (格式: [:])
34. -v, --volume ：绑定数据卷
35. --volume-driver：容器的可选卷驱动程序
36. --volumes-from：从指定的容器装载数据卷
37. -w, --workdir：容器内的工作目录
系统
1. --cap-add：添加linux功能
2. --cap-drop：删除linux功能
docker run --cap-add=ALL --cap-drop=MKNOD ...
docker run --cap-add=SYS_ADMIN ...
docker run --cap-add=CAP_SYS_ADMIN ...
3. --isolation：指定容器的隔离技术
linux系统：只支持default，即linux命名空间隔离技术
windows系统：
default:表示使用docker守护进程配置的选项，否则默认使用process选项
process:命名空间隔离
hyperv:基于Hyper-V 管理程序基于分区的隔离
4. --platform：设置平台，如果服务器支持多个平台
5. --runtime：用于此容器使用的运行时
6. --security-opt：通过指定--security opt标志来覆盖每个容器的默认标签方案
7. --shm-size：设置/dev/shm设备的大小，/dev/shm是一个基于内存的临时文件系统
8. --storage-opt：容器的存储驱动程序选项
9. --sysctl：设置系统参数，默认 map[]
10. --ulimit：设置Ulimit选项，默认[]
网络
1. --ip：ip4地址
2. --ip6：ip6地址
3. --dns 设置自定义dns服务器，将修改容器中 /etc/resolv.conf 文件
4. --dns-option：设置DNS选项，将修改容器中 /etc/resolv.conf 文件
5. --dns-search：设置自定义DNS搜索域名，将修改容器中 /etc/resolv.conf 文件
6. --link-local-ip：设置一个或多个容器的以太网设备的链路本地IPv4/IPv6地址
7. --mac-address：容器Mac地址
8. --network：将容器加入到指定网络
9. --network-alias：为容器添加网络范围的别名
健康检查
1. --health-cmd：健康检查命令
2. --health-interval：健康检查频率（ms|s|m|h）,默认0s
3. --health-retries：健康检查重试次数，连续失败指定次数则判断为不健康
4. --health-start-period：设置启动容器的初始化时间，在此期间的健康检查不作为参考依据， （ms|s|m|h）,默认0s
5. --health-timeout：每一次检查超时时间（ms|s|m|h）,默认0s
6. --no-healthcheck：禁用健康检查
docker run --rm --health-cmd "curl http://localhost" --health-interval 2s -- health-retries 5 --health-start-period 10s --health-timeout 1s nginx
命名空间选项
1. --cgroup-parent：容器的可选父cgroup
2. --cgroupns：要使用的Cgroup命名空间(host|private) host：在Docker主机的cgroup命名空间中运行容器 private：在容器的私有cgroup命名空间中运行容器 ""：使用配置的cgroup命名空间
3. --pid：pid 命名空间使用，默认使用命名空间隔离，指定host则使用主机pid命名空间
4. --userns：用户与组命名空间，默认为主机模式，在daemon.json中配置后，默认隔离，可通过指 定host为主机模式
5. --uts：uts命名空间，默认隔离，可指定host为主机模式
cgroup资源限制选项
CPU
1. --cpu-period：限制（完全公平调度程序）CPU分配周期
2. --cpu-quota：限制（完全公平调度程序）CPU配额
docker run --rm -dit --cpu-period=50000 --cpu-quota=25000 ubuntu /bin/bash
3. --cpu-rt-period：限制CPU实时周期（微秒）
4. --cpu-rt-runtime：限制CPU实时运行时间（微秒）
docker run --rm -dit --cpu-rt-period=50000 --cpu-rt-runtime=25000 ubuntu /bin/bash
7. -c, --cpu-shares：CPU相对权重
8. --cpus：指定CPU配额，例如：--cpus=0.5，表示可以使用0.5个CPU的配额
CPUset
1. --cpuset-cpus：指定容器在哪个或哪几个CPU上运行
docker run --rm -dit --cpuset-cpus="1,3" ubuntu /bin/bash
docker run --rm -it --cpuset-cpus="0-2" ubuntu /bin/bash
2. --cpuset-mems：指定容器使用的内存节点
docker run --rm -dit --cpuset-mems="1,3" ubuntu /bin/bash
docker run --rm -dit --cpuset-mems="0-2" ubuntu /bin/bash
device
1. --device：添加主机设备到容器，默认权限：read, write, mknod，可通过:rwm 覆盖默认权限
docker run --rm -dit --device=/dev/sda:/dev/sda --device=/dev/snd:/dev/snd:r ubuntu /bin/bash
2. --device-cgroup-rule：将规则添加到cgroup允许的设备列表
3. --device-read-bps：限制设备的读取速率（字节/秒）
docker run --rm -dit --device-read-bps /dev/sda:1mb ubuntu
4. --device-read-iops：限制设备每秒读取次数（io/秒）
docker run --rm -dti --device-read-iops /dev/sda:1000 ubuntu
5. --device-write-bps：限制设备的写入速率（字节/秒）
docker run --rm -dit --device-write-bps /dev/sda:1mb ubuntu
6. --device-write-iops：限制设备每秒写入次数（io/秒）
docker run --rm -dti --device-write-iops /dev/sda:1000 ubuntu
7. --gpus：要添加到容器的GPU设备（“all”传递所有GPU）
memory
ubuntu系统开启内核支持
1. 修改系统文件/etc/default/grub
GRUB_CMDLINE_LINUX="cgroup_enable=memory swapaccount=1"
2. 更新并重启机器 update-grub; reboot;
选项
1. -m, --memory：内存限制，硬限制
2. --memory-reservation：内存限制，软限制
docker run --rm -dit -m 500M --memory-reservation 200M ubuntu /bin/bash
3. --memory-swap：交换区限制，等于内存限制加swap限制，-1表示无限制
docker run --rm -dit -m 300M --memory-swap 1G ubuntu /bin/bash
4. --memory-swappiness：调整容器内存交换，取值 0 ~ 100 ，默认为-1。为0表示尽可能的使用物理内存，为100表示尽可能的使用交换区。产生交换的场景：1.系统需要的内存大于可用内存 2.应用启动之初需要大量内存，启动之后不再使用的内存将被交换。
docker run --rm -dit --memory-swappiness=0 ubuntu /bin/bash
5. --oom-kill-disable：禁用内存超限，杀死进程功能
docker run --rm -dit -m 100M --oom-kill-disable ubuntu /bin/bash
6. --oom-score-adj：调整容器进程超限被杀的优先级，分数越高被杀的优先级越高，取值范围-1000 ~ 1000
docker run --rm -dit -m 100M --oom-score-adj 100 ubuntu /bin/bash
docker start/stop/restart
docker start :启动一个或多个已经被停止的容器
docker stop :停止一个运行中的容器
docker restart :重启容器
docker start [OPTIONS] CONTAINER [CONTAINER...]
docker stop [OPTIONS] CONTAINER [CONTAINER...]
docker restart [OPTIONS] CONTAINER [CONTAINER...]
docker restart mynginx
docker stop mynginx
docker start mynginx
docker kill
docker kill :杀掉一个运行中的容器
docker kill [OPTIONS] CONTAINER [CONTAINER...]
OPTIONS说明：
-s :向容器发送一个信号
docker kill -s KILL mynginx
docker kill -s TERM mynginx
如果容器终止时的状态对用户而言很重要，用户可能会想要了解docker kill 和docker stop之间的区别。 docker kill 的行为和标准的kill 命令行程序并不相同。kill 程序的默认工作方式是向指定的进程发送 TERM信号（即信号值为15）。这个信号表示程序应该被终止，但是不要强迫程序终止。当这个信号被处理时，大多数程序将执行某种清理工作，但是该程序也可以执行其他操作，包括忽略该信号。 而docker kill 对正在运行的程序使用的是KILL信号，这使得该进程没办法处理终止过程。这就意味着一 些诸如包含运行进程ID之类的文件可能会残留在文件系统中。根据应该用程序管理状态的能力，如果再次启动容器，这可能会也可能不会造成问题。 docker stop 命令则像kill 命令那样工作，发送的是一个TERM型号。
docker rm
docker rm ：删除一个或多个容器。
docker rm [OPTIONS] CONTAINER [CONTAINER...]
OPTIONS说明：
-f :通过 SIGKILL 信号强制删除一个运行中的容器。
-l :移除容器间的网络连接，而非容器本身。
-v :删除与容器关联的卷。
docker pause/unpause
docker pause :暂停容器中所有的进程。
docker unpause :恢复容器中所有的进程。
docker pause CONTAINER [CONTAINER...]
docker unpause CONTAINER [CONTAINER...]
容器运维操作命令
docker exec
docker exec ：在运行的容器中执行命令
docker exec [OPTIONS] CONTAINER COMMAND [ARG...]
OPTIONS说明：
-d :分离模式: 在后台运行
-i :即使没有附加也保持STDIN 打开
-t :分配一个伪终端
docker exec -i -t mynginx /bin/bash
// 通过exec 执行命令
docker exec mynginx ls
docker ps
docker ps : 列出容器
docker ps [OPTIONS]
OPTIONS说明：
-a :显示所有的容器，包括未运行的。
-f :根据条件过滤显示的内容。
--format :指定返回值的模板文件。
-l :显示最近创建的容器。
-n :列出最近创建的n个容器。
--no-trunc :不截断输出。
-q :静默模式，只显示容器编号。
-s :显示总的文件大小。
docker ps
docker inspect
docker inspect : 获取容器/镜像的元数据。
docker inspect [OPTIONS] NAME|ID [NAME|ID...]
OPTIONS说明：
-f :指定返回值的模板文件。
-s :显示总的文件大小。
--type :为指定类型返回JSON
// 查看容器的示例id
docker inspect -f '{{.Id}}'
// 检查镜像或者容器的参数，默认返回 JSON 格式
docker inspect <id>
docker top
docker top :查看容器中运行的进程信息，支持 ps 命令参数
docker top [OPTIONS] CONTAINER [ps OPTIONS]
# 查看所有运行容器的进程信息。
for i in `docker ps |grep Up|awk '{print $1}'`;do echo \ &&docker top $i; done
docker attach
docker attach :连接到正在运行中的容器
docker attach [OPTIONS] CONTAINER
docker attach mynginx
docker exec 与 docker attach 的区别：
1. exec 在容器中执行命令，并且可以通过-i -t 创建虚拟终端的方式与容器交互
2. attach 进入容器某个正在执行的命令终端，不能交互操作。但是如果该容器的命令终端是一个可以 交互的终端，那么也可以交互
退出attach模式：
1. 运行容器时指定 -i -t 参数，那么attach容器后可通过Ctrl + P + Ctrl + Q 退出attach状态
docker run -d -it -P nginx
docker attach <containerID>
2. 仅指定-t参数，可以通过Ctrl + C 退出attach状态
docker run -d -t -P nginx
docker attach
3. 不指定-t参数，在attach的时候指定 --sig-proxy=false ，可以通过 Ctrl + C 退出attach状态。--sigproxy 仅在没有指定-t参数的情况下生效。于--sig-proxy 默认值为true，默认将所有接收信号代理 给了容器中的进程，所以Ctrl + C 的时候会将sigint (signal interrupt)终止信号发送到attach进程， 从而转发到被attach的进程，导致容器中进程中断，从而退出容器。
docker run -d -i -P nginx
docker run -d -P nginx
docker attach --sig-proxy=false
docker wait
docker wait : 阻塞运行直到容器停止，然后打印出它的退出代码。
docker wait [OPTIONS] CONTAINER [CONTAINER...]
docker export
docker export :将文件系统作为一个tar归档文件导出到STDOUT。
docker export [OPTIONS] CONTAINER
OPTIONS说明：
-o :将输入内容写到文件。
docker export mynginx -o mynginx.tar
# 解压归档文件，查看内容 tar vxf mynginx.tar -c mynginx
docker port
docker port :列出指定的容器的端口映射，或者查找将PRIVATE_PORT NAT到面向公众的端口。
docker port [OPTIONS] CONTAINER [PRIVATE_PORT[/PROTO]]
docker port mynginx
docker cp
docker cp :用于容器与主机之间的数据拷贝
docker cp [OPTIONS] CONTAINER:SRC_PATH DEST_PATH|-
docker cp [OPTIONS] SRC_PATH|- CONTAINER:DEST_PATH
OPTIONS说明：
-L :保持源目标中的链接
# 主机/www/html目录拷贝到容器1881f0cba5bc的/www目录下
docker cp /www/html 1881f0cba5bc:/www/
# 将主机/www/html目录拷贝到容器1881f0cba5bc中，目录重命名为www。
docker cp /www/html 1881f0cba5bc:/www
# 将容器1881f0cba5bc的/www目录拷贝到主机的/tmp目录中
docker cp 1881f0cba5bc:/www /tmp/
docker diff
docker diff : 检查容器里文件结构的更改。
docker diff命令会列出 3 种容器内文件状态变化（A - Add, D - Delete, C - Change ）的列表清单
docker diff [OPTIONS] CONTAINER
docker diff mynginx
docker rename
docker rename CONTAINER NEW_NAME
docker stats
docker stats [容器]
docker update
# 查看帮助，可以看出docker update 是用来修改docker run 指定的运行参数
docker update -h
docker update --restart always myubuntu3
docker update --restart no myubuntu3
镜像管理命令
docker build
docker build 命令用于使用 Dockerfile 创建镜像。
docker build [OPTIONS] PATH | URL | -
OPTIONS说明：
--add-host :向hosts文件中添加自定义 host:ip 映射
--build-arg=[] :设置镜像创建时的变量；
--cache-from :指定镜像用作当前构建的缓存镜像
--cgroup-parent :容器的可选父cgroup
--compress : 使用gzip压缩构建上下文
--cpu-period :限制 CPU CFS周期；
--cpu-quota :限制 CPU CFS配额；
-c,--cpu-shares :设置 cpu 使用权重；
--cpuset-cpus :指定使用的CPU id；
--cpuset-mems :指定使用的内存 id；
--disable-content-trust :跳过镜像校验，默认为true;
-f,--file :指定要使用的Dockerfile路径；
--force-rm :不论构建是否成功，总是删除中间容器，默认false。注意：中间容器；
--iidfile :将镜像ID写入到文件
--isolation :使用容器隔离技术；
linux系统：只支持default，即linux命名空间隔离技术
windows系统：
default:表示使用docker守护进程配置的选项，否则默认使用process选项
process:命名空间隔离
hyperv:基于Hyper-V 管理程序基于分区的隔离
--label=[] :设置镜像使用的元数据；
-m :设置内存最大值；
--memory-swap :设置Swap的最大值为内存+swap，"-1"表示不限swap；
--network: 在构建期间为RUN指令设置网络模式（默认“default”）与docker run指令无关 --no-cache :创建镜像的过程不使用缓存；
--pull :总是尝试去更新镜像的新版本；
--quiet, -q :安静模式，成功后只输出镜像 ID；
--rm :构建成功后，删除中间容器，默认true。注意：中间容器，不是镜像；
--security-opt :安全选项
--shm-size :设置/dev/shm的大小，默认值是64M；/dev/shm 是基于内存的tmpfs文件系统。
--ulimit :Ulimit配置。
--tag, -t : 镜像的名字及标签，通常 name:tag 或者 name 格式；可以在一次构建中为一个镜像设置 多个标签。
--target : 设置要生成的目标生成阶段
--ulimit : Ulimit 选项
docker build -t nodetodo:v1.0.0 -f Dockerfile .
docker images
docker images : 列出本地镜像。
docker images [OPTIONS] [REPOSITORY[:TAG]]
OPTIONS说明：
-a :列出本地所有的镜像（含中间映像层，默认情况下，过滤掉中间映像层）；
--digests :显示镜像的摘要信息；
-f :显示满足条件的镜像；
--format :指定返回值的模板文件；
--no-trunc :显示完整的镜像信息；
-q :只显示镜像ID
# 查看所有悬空镜像
docker images --filter dangling=true
# 清除所有悬空镜像
docker image prune
docker rmi
docker rmi : 删除本地一个或多个镜像。
docker rmi [OPTIONS] IMAGE [IMAGE...]
OPTIONS说明：
-f :强制删除；
--no-prune :不移除该镜像的过程镜像，默认移除；
docker tag
docker tag : 标记本地镜像，将其归入某一仓库
docker tag [OPTIONS] IMAGE[:TAG] [REGISTRYHOST/][USERNAME/]NAME[:TAG]
docker tag mynginx:v1 mynginx:1.0
docker save
docker save : 将指定镜像保存成 tar 归档文件。
docker save [OPTIONS] IMAGE [IMAGE...]
OPTIONS 说明：
-o :输出到的文件。
docker save -o mynginx.tar mynginx:v1
# 解压文件，查看内容
tar vxf mynginx.tar -C mynginx
docker load
docker load : 导入使用 docker save 命令导出的镜像
docker load [OPTIONS]
OPTIONS 说明：
--input , -i : 指定导入的文件，代替 STDIN。
--quiet , -q : 精简输出信息。
docker load -i mynginx.tar
docker import
docker import : 从归档文件中创建镜像。
docker import [OPTIONS] file|URL|- [REPOSITORY[:TAG]]
OPTIONS说明：
-c :应用docker 指令创建镜像；
-m :提交时的说明文字
docker import mynginx.tar mynginx:v3
docker commit
docker commit :从容器创建一个新的镜像。
docker commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]]
OPTIONS说明：
-a :提交的镜像作者；
-c :使用Dockerfile指令来创建镜像；
-m :提交时的说明文字；
-p :在commit时，将容器暂停
docker commit -a "nick" -m "mynginx commit" mynginx mynginxtest:1.0
镜像仓库命令
docker login/logout
docker login : 登陆到一个Docker镜像仓库，如果未指定镜像仓库地址，默认为官方仓库 Docker Hub
docker logout : 登出一个Docker镜像仓库，如果未指定镜像仓库地址，默认为官方仓库 Docker Hub
docker login [OPTIONS] [SERVER]
docker logout [OPTIONS] [SERVER]
OPTIONS说明：
-u :登陆的用户名
-p :登陆的密码
docker login -u 用户名 -p 密码
docker logout
docker pull
docker pull : 从镜像仓库中拉取或者更新指定镜像
docker pull [OPTIONS] NAME[:TAG|@DIGEST]
OPTIONS说明：
-a :拉取所有 tagged 镜像
--disable-content-trust :忽略镜像的校验,默认开启
docker pull nginx
docker push
docker push : 将本地的镜像上传到镜像仓库,要先登陆到镜像仓库
docker push [OPTIONS] NAME[:TAG]
OPTIONS说明：
--disable-content-trust :忽略镜像的校验,默认开启
docker search
docker search : 从Docker Hub查找镜像
docker search [OPTIONS] TERM
OPTIONS说明：
--automated :只列出 automated build类型的镜像；
--no-trunc :显示完整的镜像描述；
-f :列出收藏数不小于指定值的镜像
//从 Docker Hub 查找所有镜像名包含 nginx，并且收藏数大于 10 的镜像
docker search -f stars=10 nginx
参数说明：
NAME: 镜像仓库源的名称
DESCRIPTION: 镜像的描述
OFFICIAL: 是否 docker 官方发布
stars: 类似 Github 里面的 star，表示点赞、喜欢的意思。
AUTOMATED: 自动构建。
