Docker 核心命令中文文档

本文档基于 Docker 官方命令行帮助信息,整理了 Docker 常用命令的中文说明、使用场景和核心参数,适合新手快速查阅和使用。

一、命令行基础格式

docker [全局选项] 命令 [命令选项] [参数]

二、全局选项(Global Options)

选项 说明 默认值
--config string 客户端配置文件的存储位置 /root/.docker
-c, --context string 指定连接守护进程的上下文名称(覆盖 DOCKER_HOST 环境变量) -
-D, --debug 启用调试模式 关闭
-H, --host list 要连接的守护进程套接字 -
-l, --log-level string 设置日志级别(可选:debug/info/warn/error/fatal) info
--tls 使用 TLS 加密连接(隐含 --tlsverify 关闭
--tlscacert string 信任的 CA 证书路径 /root/.docker/ca.pem
--tlscert string TLS 证书文件路径 /root/.docker/cert.pem
--tlskey string TLS 密钥文件路径 /root/.docker/key.pem
--tlsverify 使用 TLS 并验证远程端 关闭
-v, --version 打印版本信息并退出 -

三、常用核心命令(Common Commands)

1. run - 创建并运行新容器

作用:从镜像创建并启动一个新容器,是最常用的命令之一。 基本格式

docker run [选项] 镜像名称[:标签] [命令] [参数]

核心选项

  • -d:后台运行容器(守护进程模式)
  • --name:指定容器名称
  • -p:端口映射(格式:主机端口:容器端口)
  • -v:目录挂载(格式:主机目录:容器目录)
  • --restart:容器重启策略(always/unless-stopped/no)
  • -e:设置环境变量

示例

docker run -d --name mynginx -p 80:80 nginx:latest

2. exec - 在运行中的容器执行命令

作用:进入运行中的容器执行命令(如进入容器终端)。 基本格式

docker exec [选项] 容器名称/ID 命令 [参数]

核心选项

  • -it:交互式终端(常用:进入容器命令行)
  • -d:后台执行命令

示例

docker exec -it mynginx /bin/bash  # 进入nginx容器终端

3. ps - 列出容器

作用:查看容器的运行状态。 基本格式

docker ps [选项]

核心选项

  • -a:显示所有容器(包括已停止的)
  • -q:仅显示容器ID
  • -l:仅显示最新创建的容器

示例

docker ps -a  # 查看所有容器

4. build - 从 Dockerfile 构建镜像

作用:基于 Dockerfile 构建自定义镜像。 基本格式

docker build [选项] 构建上下文路径/URL

核心选项

  • -t:为镜像打标签(格式:名称:标签)
  • -f:指定 Dockerfile 路径(默认:上下文路径下的 Dockerfile)

示例

docker build -t myapp:v1.0 -f ./Dockerfile .

5. pull - 从镜像仓库下载镜像

作用:从 Docker Hub/私有仓库拉取镜像到本地。 基本格式

docker pull [选项] 镜像名称[:标签]

示例

docker pull nginx:latest  # 拉取官方nginx最新版
docker pull registry.cn-shanghai.aliyuncs.com/usual2970/certimate:latest  # 拉取阿里云镜像

6. push - 上传镜像到仓库

作用:将本地镜像推送到 Docker Hub/私有仓库。 基本格式

docker push [选项] 镜像名称[:标签]

7. images - 列出本地镜像

作用:查看本地已下载的镜像列表。 基本格式

docker images [选项] [镜像名称]

核心选项

  • -a:显示所有镜像(包括中间层)
  • -q:仅显示镜像ID
  • --digests:显示镜像摘要信息

8. login/logout - 登录/退出镜像仓库

作用:认证镜像仓库(如 Docker Hub、阿里云镜像仓库)。 基本格式

docker login [选项] [仓库地址]  # 登录
docker logout [选项] [仓库地址]  # 退出

示例

docker login registry.cn-shanghai.aliyuncs.com  # 登录阿里云镜像仓库

9. search - 搜索 Docker Hub 镜像

作用:在 Docker Hub 上搜索公开镜像。 基本格式

docker search [选项] 关键词

10. version - 显示 Docker 版本信息

作用:查看 Docker 客户端、守护进程的版本和系统信息。

docker version

11. info - 显示系统级信息

作用:查看 Docker 系统状态(如容器数、镜像数、存储驱动、网络等)。

docker info

四、管理类命令(Management Commands)

1. container - 容器管理(替代传统单命令)

作用:统一管理容器的全生命周期,是 Docker 推荐的新用法(功能等价于传统命令)。

子命令 等价传统命令 说明
docker container ls docker ps 列出容器
docker container run docker run 创建并运行容器
docker container start docker start 启动已停止的容器
docker container stop docker stop 停止运行中的容器
docker container rm docker rm 删除容器
docker container inspect docker inspect 查看容器详细信息

2. image - 镜像管理

作用:统一管理镜像(替代 docker images/rmi/tag 等)。

子命令 等价传统命令 说明
docker image ls docker images 列出镜像
docker image rm docker rmi 删除镜像
docker image tag docker tag 为镜像打标签
docker image build docker build 构建镜像

3. network - 网络管理

作用:管理 Docker 网络(创建、删除、查看网络等)。 常用子命令

  • docker network ls:列出所有网络
  • docker network create:创建自定义网络
  • docker network connect:将容器连接到网络
  • docker network disconnect:断开容器与网络的连接

4. volume - 数据卷管理

作用:管理 Docker 数据卷(持久化容器数据)。 常用子命令

  • docker volume ls:列出所有数据卷
  • docker volume create:创建数据卷
  • docker volume rm:删除数据卷
  • docker volume inspect:查看数据卷详细信息

5. 其他管理命令

命令 说明
docker builder 管理构建器
docker buildx 扩展构建功能(多平台镜像构建)
docker compose 管理多容器应用(基于 docker-compose.yml)
docker context 管理 Docker 上下文(切换不同环境)
docker manifest 管理镜像清单和清单列表
docker plugin 管理 Docker 插件
docker system 管理 Docker 系统(如清理垃圾:docker system prune
docker trust 管理镜像的信任机制

五、Swarm 命令

命令 说明
docker swarm 管理 Docker Swarm 集群(初始化、加入、离开集群等)

六、其他常用命令(Commands)

命令 说明 核心选项/示例
attach 连接到运行中的容器的标准输入/输出/错误流 docker attach mycontainer
commit 从容器的修改创建新镜像 docker commit mycontainer myimage:v1
cp 在容器和本地文件系统间复制文件/文件夹 docker cp mycontainer:/app/logs ./logs
create 创建新容器(仅创建不启动) docker create --name mynginx nginx
diff 检查容器文件系统的修改 docker diff mycontainer
events 从 Docker 服务器获取实时事件 docker events
export 将容器文件系统导出为 tar 归档 docker export mycontainer > container.tar
history 显示镜像的构建历史 docker history nginx:latest
import 从 tar 包导入内容创建文件系统镜像 docker import container.tar myimage:v1
inspect 获取 Docker 对象(容器/镜像/网络等)的底层信息 docker inspect mycontainer
kill 强制终止运行中的容器 docker kill mycontainer
load 从 tar 归档或标准输入加载镜像 docker load < image.tar
logs 获取容器日志 docker logs -f mycontainer(-f:实时跟踪)
pause 暂停容器内所有进程 docker pause mycontainer
port 列出容器的端口映射 docker port mycontainer
rename 重命名容器 docker rename oldname newname
restart 重启容器 docker restart mycontainer
rm 删除容器 docker rm -f mycontainer(-f:强制删除运行中的容器)
rmi 删除镜像 docker rmi myimage:v1
save 将镜像保存为 tar 归档 docker save nginx:latest > nginx.tar
start 启动已停止的容器 docker start mycontainer
stats 实时显示容器资源使用统计(CPU/内存/网络等) docker stats mycontainer
stop 停止运行中的容器(优雅终止) docker stop mycontainer
tag 为镜像创建标签 docker tag nginx:latest mynginx:v1
top 显示容器内运行的进程 docker top mycontainer
unpause 恢复暂停的容器进程 docker unpause mycontainer
update 更新容器配置(如重启策略、资源限制) docker update --restart always mycontainer
wait 阻塞直到容器停止,然后打印退出码 docker wait mycontainer

七、使用技巧

  1. 查看命令详情:执行 docker 命令 --help 可查看具体命令的完整选项(如 docker run --help)。
  2. 简写用法
    • docker ps -aq:仅显示所有容器的ID
    • docker rm $(docker ps -aq):删除所有容器
    • docker rmi $(docker images -aq):删除所有镜像
  3. 清理垃圾资源docker system prune -a(清理未使用的镜像、容器、网络、数据卷)。

总结

  1. Docker 命令分为核心命令(run/exec/ps等)、管理命令(container/image/network等)和Swarm命令三类,管理命令是官方推荐的新用法;
  2. 容器管理核心:run(创建运行)、start/stop/restart(启停重启)、rm(删除)、inspect(查看详情);
  3. 镜像管理核心:pull/push(拉取/推送)、build(构建)、images/rmi(查看/删除);
  4. 数据持久化核心:-v(目录挂载)、volume(数据卷管理)。