Files
docker_practice/appendix/command/docker.md
T
yeasy 31c0f10b89 fix(appendix): 命令速查表落后 Docker 29 CLI 十余条命令
附录三的客户端命令表停留在管理命令引入之前的形态,本书自己讲了整整两章的
`docker buildx`(第 10 章)与 `docker compose`(第 11 章)都不在表里,而全书正文
分别用到 27 次和 127 次;`image`(41 次)、`container`(20 次)、`system`(10 次)、
`manifest`(9 次)、`scout`(5 次)、`init`(3 次)同样缺席。按 docker/cli v29.0.0
的 `cli/command/commands/commands.go`(builder/checkpoint/config/container/context/
image/manifest/network/node/plugin/registry/secret/service/stack/swarm/system/volume)
与官方 CLI 参考页的 Subcommands 表补齐 15 条,保持原有字母序。`trust` 不补——
Engine 29 发行说明明写 "Docker Content Trust was removed from the Docker CLI",
与 2.3 节的叙述一致。

另两处按 v29.0.0 `cli/flags/options.go` 核对后修正:

- TLS 三个默认路径写成了绝对路径 `/.docker/*.pem`,与同一张表第一行
  「`--config` 默认为 `~/.docker`」自相矛盾。源码里默认证书目录就是客户端配置
  目录,应为 `~/.docker/{ca,cert,key}.pem`。
- 全局选项漏了 `-c, --context`。
- `search` 的说明还写着「Docker index」,官方为 "Search Docker Hub for images"。
2026-08-22 23:23:33 -07:00

5.4 KiB
Raw Blame History

客户端命令 - docker

客户端命令选项

  • --config="":指定客户端配置文件,默认为 ~/.docker;
  • -D=true|false:是否使用 debug 模式。默认不开启;
  • -H, --host=[]:指定命令对应 Docker 守护进程的监听接口,可以为 unix 套接字 unix:///path/to/socket,文件句柄 fd://socketfd 或 tcp 套接字 tcp://[host[:port]],默认为 unix:///var/run/docker.sock;
  • -c, --context="":指定连接守护进程时使用的上下文名称,优先于 DOCKER_HOST 环境变量和 docker context use 设定的默认上下文;
  • -l, --log-level="debug|info|warn|error|fatal":指定日志输出级别;
  • --tls=true|false:是否对 Docker 守护进程启用 TLS 安全机制,默认为否;
  • --tlscacert=~/.docker/ca.pem:TLS CA 签名的可信证书文件路径;
  • --tlscert=~/.docker/cert.pem:TLS 可信证书文件路径;
  • --tlskey=~/.docker/key.pem:TLS 密钥文件路径;
  • --tlsverify=true|false:启用 TLS 校验,默认为否。

客户端命令

可以通过 docker COMMAND --help 来查看这些命令的具体用法。

  • attach:依附到一个正在运行的容器中;
  • build:从一个 Dockerfile 创建一个镜像;
  • builder:管理构建器与构建缓存,包括查看、清理等;
  • buildx:扩展构建能力 (BuildKit),支持多平台构建、构建缓存导入导出等 (CLI 插件,详见第 10 章);
  • checkpoint:管理容器检查点,用于保存和恢复容器运行状态 (实验特性);
  • commit:从一个容器的修改中创建一个新的镜像;
  • compose:定义并运行多容器应用 (CLI 插件,详见第 11 章);
  • config:管理 swarm 集群中的配置项,包括创建、查看、删除等;
  • container:管理容器,run、ps、exec 等均是其子命令的快捷形式;
  • context:管理连接上下文,在多个 Docker 守护进程之间切换;
  • cp:在容器和本地宿主系统之间复制文件;
  • create:创建一个新容器,但并不运行它;
  • diff:检查一个容器内文件系统的修改,包括修改和增加;
  • events:从服务端获取实时的事件;
  • exec:在运行的容器内执行命令;
  • export:导出容器内容为一个 tar 包;
  • history:显示一个镜像的历史信息;
  • image:管理镜像,images、pull、build 等均是其子命令的快捷形式;
  • images:列出存在的镜像;
  • import:导入一个文件 (典型为 tar 包) 路径或目录来创建一个本地镜像;
  • info:显示一些相关的系统信息;
  • init:为项目生成 Dockerfile、compose.yaml 等初始文件 (CLI 插件);
  • inspect:显示一个容器的具体配置信息;
  • kill:关闭一个运行中的容器 (包括进程和所有相关资源);
  • load:从一个 tar 包中加载一个镜像;
  • login:注册或登录到一个 Docker 的仓库服务器;
  • logout:从 Docker 的仓库服务器登出;
  • logs:获取容器的 log 信息;
  • manifest:管理镜像的 manifest 与 manifest list,用于发布多架构镜像;
  • network:管理 Docker 的网络,包括查看、创建、删除、挂载、卸载等;
  • node:管理 swarm 集群中的节点,包括查看、更新、删除、提升/取消管理节点等;
  • pause:暂停一个容器中的所有进程;
  • plugin:管理 Docker 插件,包括安装、启用、禁用、删除等;
  • port:查找一个 nat 到一个私有网口的公共口;
  • ps:列出主机上的容器;
  • pull:从一个 Docker 的仓库服务器下拉一个镜像或仓库;
  • push:将一个镜像或者仓库推送到一个 Docker 的注册服务器;
  • rename:重命名一个容器;
  • restart:重启一个运行中的容器;
  • rm:删除给定的若干个容器;
  • rmi:删除给定的若干个镜像;
  • run:创建一个新容器,并在其中运行给定命令;
  • save:保存一个镜像为 tar 包文件;
  • scout:分析镜像的软件成分与已知漏洞 (CLI 插件);
  • search:在 Docker Hub 中搜索镜像;
  • secret:管理 swarm 集群中的密钥,包括创建、查看、删除等;
  • service:管理 Docker 所启动的应用服务,包括创建、更新、删除等;
  • stack:管理 swarm 集群中的应用栈,包括部署、查看、删除等;
  • start:启动一个容器;
  • stats:输出 (一个或多个) 容器的资源使用统计信息;
  • stop:终止一个运行中的容器;
  • swarm:管理 Docker swarm 集群,包括创建、加入、退出、更新等;
  • system:管理 Docker 本身,包括查看磁盘占用、清理无用数据、订阅事件等;
  • tag:为一个镜像打标签;
  • top:查看一个容器中的正在运行的进程信息;
  • unpause:将一个容器内所有的进程从暂停状态中恢复;
  • update:更新指定的若干容器的配置信息;
  • version:输出 Docker 的版本信息;
  • volume:管理 Docker volume,包括查看、创建、删除等;
  • wait:阻塞直到一个容器终止,然后输出它的退出符。

一张图总结 Docker 的命令

如图 A-1 所示,Docker 常用客户端命令可按功能分组理解。

Docker 命令总结

图 A-1:Docker 客户端命令分类示意图

参考