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 |
七、使用技巧
- 查看命令详情:执行
docker 命令 --help可查看具体命令的完整选项(如docker run --help)。 - 简写用法:
docker ps -aq:仅显示所有容器的IDdocker rm $(docker ps -aq):删除所有容器docker rmi $(docker images -aq):删除所有镜像
- 清理垃圾资源:
docker system prune -a(清理未使用的镜像、容器、网络、数据卷)。
总结
- Docker 命令分为核心命令(run/exec/ps等)、管理命令(container/image/network等)和Swarm命令三类,管理命令是官方推荐的新用法;
- 容器管理核心:
run(创建运行)、start/stop/restart(启停重启)、rm(删除)、inspect(查看详情); - 镜像管理核心:
pull/push(拉取/推送)、build(构建)、images/rmi(查看/删除); - 数据持久化核心:
-v(目录挂载)、volume(数据卷管理)。