Docker 常用命令手册
本文目录
本手册涵盖日常开发、服务器部署、容器排障和系统维护所需的所有常用 Docker 命令,按场景分类,并附有实用建议。
📋 快速速查表
| 场景 | 命令示例 |
|---|---|
| 查看运行中的容器 | docker ps |
| 查看所有容器(含停止) | docker ps -a |
| 查看本地镜像 | docker images |
| 实时查看容器日志 | docker logs -f <容器名> |
| 进入容器内部 | docker exec -it <容器名> bash |
| 启动/停止/重启容器 | docker start/stop/restart <容器名> |
| 构建镜像 | docker build -t myapp:1.0 . |
| 导出/导入镜像 | docker save -o myapp.tar myapp:1.0<br>docker load -i myapp.tar |
| Compose 启动/停止 | docker compose up -d<br>docker compose down |
| 清理无用资源(危险) | docker system prune -a --volumes -f |
1. 基本概念速览
| 概念 | 说明 |
|---|---|
| 镜像(Image) | 应用及其运行环境的只读模板,类似虚拟机的快照。 |
| 容器(Container) | 镜像的运行实例,一个镜像可以启动多个容器。 |
| 仓库(Registry) | 存储和分发镜像的服务,如 Docker Hub、阿里云 ACR。 |
| 卷(Volume) | 持久化数据的存储机制,独立于容器生命周期。 |
2. 镜像管理
| 命令 | 说明 | 示例 |
|---|---|---|
docker pull <镜像名>[:标签] |
从仓库拉取镜像 | docker pull nginx:1.27 |
docker images |
列出本地所有镜像 | docker images |
docker rmi <镜像ID或名称> |
删除镜像(需无容器依赖) | docker rmi myapp:1.0 |
docker rmi -f <镜像ID> |
强制删除(即使有容器) | docker rmi -f $(docker images -q) |
docker build -t <名称:标签> <路径> |
构建镜像 | docker build -t myapp:1.0 . |
docker save -o <文件.tar> <镜像> |
导出镜像为 tar 包 | docker save -o myapp.tar myapp:1.0 |
docker load -i <文件.tar> |
从 tar 包导入镜像 | docker load -i myapp.tar |
docker tag <源镜像> <新标签> |
给镜像打新标签 | docker tag myapp:1.0 myregistry/myapp:latest |
docker push <镜像名> |
推送镜像到仓库 | docker push myregistry/myapp:latest |
docker image prune |
删除悬挂镜像(<none>:<none>) |
– |
docker image prune -a |
删除所有未使用的镜像(较激进) | – |
3. 容器生命周期管理
| 命令 | 说明 | 示例 |
|---|---|---|
docker run [选项] <镜像> |
创建并启动容器 | docker run -d --name web -p 80:80 nginx |
docker start <容器名或ID> |
启动已停止的容器 | docker start web |
docker stop <容器名或ID> |
优雅停止容器(发送 SIGTERM) | docker stop web |
docker restart <容器名或ID> |
重启容器 | docker restart web |
docker pause <容器名或ID> |
暂停容器进程 | docker pause web |
docker unpause <容器名或ID> |
恢复暂停的容器 | – |
docker rm <容器名或ID> |
删除已停止的容器 | docker rm web |
docker rm -f <容器名或ID> |
强制删除运行中的容器 | docker rm -f web |
docker rename <旧名> <新名> |
重命名容器 | docker rename web web-prod |
docker update --restart=always <容器> |
设置容器自动重启策略 | – |
docker run 常用选项
| 选项 | 说明 | 示例 |
|---|---|---|
-d |
后台运行(detach) | docker run -d nginx |
--name <名称> |
指定容器名称 | --name mynginx |
-p <宿主机端口>:<容器端口> |
端口映射 | -p 8080:80 |
-v <宿主机路径>:<容器路径> |
挂载数据卷(bind mount) | -v /data:/app/data |
-e <键>=<值> |
设置环境变量 | -e MYSQL_ROOT_PASSWORD=123 |
--network <网络> |
指定网络 | --network mynet |
--restart <策略> |
重启策略(no/always/unless-stopped) |
--restart unless-stopped |
--user <UID:GID> |
指定容器内运行用户 | --user "999:999" |
--platform <架构> |
指定运行平台(如 linux/amd64) |
--platform linux/amd64 |
4. 容器查看与排障
| 命令 | 说明 | 示例 |
|---|---|---|
docker ps |
列出运行中的容器 | – |
docker ps -a |
列出所有容器(含停止) | – |
docker ps -q |
只显示容器 ID | – |
docker logs <容器名> |
查看容器日志 | docker logs web |
docker logs -f <容器名> |
实时跟踪日志输出 | docker logs -f web |
docker logs --tail 100 <容器名> |
查看最后 100 行日志 | – |
docker logs --since 10m <容器名> |
查看最近 10 分钟的日志 | – |
docker exec -it <容器名> <命令> |
在运行中的容器内执行命令 | docker exec -it web bash |
docker exec -it <容器名> sh |
若没有 bash,用 sh | – |
docker inspect <容器名或ID> |
查看容器的详细配置(JSON) | docker inspect web |
docker inspect --format='{{.NetworkSettings.IPAddress}}' <容器> |
仅查看容器 IP 地址 | – |
docker stats |
实时显示容器资源占用(CPU/内存/网络) | – |
docker top <容器名> |
查看容器内运行进程 | docker top web |
docker port <容器名> |
查看容器端口映射 | docker port web |
docker diff <容器名> |
查看容器内文件系统的变更(与镜像相比) | – |
5. 数据卷(Volume)管理
| 命令 | 说明 | 示例 |
|---|---|---|
docker volume create <卷名> |
创建命名卷 | docker volume create myvol |
docker volume ls |
列出所有卷 | – |
docker volume inspect <卷名> |
查看卷详细信息(宿主机路径) | docker volume inspect myvol |
docker volume rm <卷名> |
删除卷(需未被容器使用) | docker volume rm myvol |
docker volume prune |
删除未使用的卷(⚠️ 谨慎) | – |
挂载方式对比
| 挂载类型 | 语法 | 特点 |
|---|---|---|
| Bind mount | -v /host/path:/container/path |
宿主机目录直接映射,便于开发调试。 |
| Named volume | -v myvol:/container/path |
由 Docker 管理,适合生产环境持久化。 |
| Anonymous volume | -v /container/path |
自动生成随机名称,仅用于临时数据。 |
最佳实践:数据库、上传文件等永久数据务必使用 named volume 或 bind mount,并注意权限(容器内用户 UID/GID)。
6. 网络管理
| 命令 | 说明 | 示例 |
|---|---|---|
docker network ls |
列出所有网络 | – |
docker network create <网络名> |
创建自定义桥接网络 | docker network create mynet |
docker network inspect <网络名> |
查看网络详情及连接的容器 | – |
docker network connect <网络> <容器> |
将容器连接到网络 | docker network connect mynet web |
docker network disconnect <网络> <容器> |
从网络断开容器 | – |
docker network rm <网络名> |
删除网络(需无容器使用) | – |
docker network prune |
删除未使用的网络 | – |
常见网络模式:
bridge:默认,容器之间通过 NAT 访问。host:容器直接使用宿主机网络(性能高,但端口冲突)。none:无网络。overlay:跨主机通信(需 Swarm 模式)。
7. Docker Compose 常用命令
要求
docker-compose.prod.yml或docker-compose.yml存在于当前目录,或使用-f指定。
| 命令 | 说明 | 示例 |
|---|---|---|
docker compose up |
启动服务(前台) | – |
docker compose up -d |
后台启动所有服务 | – |
docker compose down |
停止并删除容器、网络(默认保留卷) | – |
docker compose down -v |
停止并删除容器、网络、卷(⚠️ 数据丢失) | – |
docker compose ps |
查看服务状态 | – |
docker compose logs -f |
实时查看所有服务日志 | – |
docker compose logs -f <服务名> |
查看特定服务日志 | docker compose logs -f web |
docker compose restart |
重启所有服务 | – |
docker compose restart <服务> |
重启指定服务 | docker compose restart server |
docker compose exec <服务> <命令> |
在服务容器中执行命令 | docker compose exec server bash |
docker compose up -d --no-deps --force-recreate <服务> |
重建特定服务(不重启依赖) | 增量更新常用 |
docker compose pull |
拉取所有服务的最新镜像 | – |
docker compose build |
重新构建所有服务的镜像 | – |
docker compose config |
验证 compose 文件语法 | – |
8. 系统清理与维护
| 命令 | 说明 | 风险等级 |
|---|---|---|
docker system df |
查看磁盘占用(镜像、容器、卷、构建缓存) | 安全 |
docker system prune |
删除停止的容器、未使用的网络、悬挂镜像、构建缓存 | ⚠️ 中等 |
docker system prune -a |
删除所有未使用的镜像(不仅仅是悬挂的) | 🔴 高 |
docker system prune --volumes |
额外删除未使用的卷 | 🔴 极高 |
docker image prune |
删除悬挂镜像(<none>:<none>) |
⚠️ 中等 |
docker container prune |
删除所有已停止的容器 | ⚠️ 中等 |
docker volume prune |
删除未使用的卷(数据永久丢失) | 🔴 极高 |
docker builder prune |
删除构建缓存 | ⚠️ 中等 |
安全建议:
- 执行
prune前先使用docker system df查看占用。 - 生产环境谨慎使用
--volumes,务必确认数据已备份。 - 可配合
-f自动确认,但强烈建议先不加-f预览要删除的内容。
9. 多平台构建(Buildx)
| 命令 | 说明 | 示例 |
|---|---|---|
docker buildx create --name <构建器名> --use |
创建并启用新的构建器 | – |
docker buildx inspect --bootstrap |
查看构建器状态 | – |
docker buildx build --platform <平台列表> -t <镜像> --load <路径> |
构建指定平台并加载到本地 | --platform linux/amd64,linux/arm64 |
docker buildx build --platform <平台> -t <镜像> --push <路径> |
构建并直接推送到仓库 | – |
docker buildx prune |
清理构建缓存 | – |
实践:当你需要在 Apple M1(ARM)上构建 amd64 镜像给云服务器使用时,必须使用 --platform linux/amd64。
10. 快速排障流程
遇到容器异常时,按顺序执行以下检查:
-
查看容器状态
docker ps -a→ 确认是否运行、退出码、重启次数。 -
查看日志
docker logs <容器名> --tail 50→ 查找错误栈或超时信息。 -
检查资源占用
docker stats→ 是否 CPU/内存耗尽。 -
进入容器检查
docker exec -it <容器名> bash→ 查看进程、文件、网络。 -
检查卷权限(常见于 MySQL)
docker inspect <容器> | grep -A 10 Mounts→ 确认卷路径,检查宿主机目录所有者是否为容器内用户(如 MySQL 的 uid 999)。 -
查看系统日志(宿主机)
journalctl -u docker.service或dmesg | grep docker。
11. 常用组合命令(巧用管道)
| 目的 | 命令 |
|---|---|
| 停止所有容器 | docker stop $(docker ps -q) |
| 删除所有容器(含运行中) | docker rm -f $(docker ps -aq) |
| 删除所有镜像 | docker rmi -f $(docker images -q) |
| 删除所有卷 | docker volume rm $(docker volume ls -q) |
| 一键彻底清理(注意风险) | docker system prune -a --volumes -f |
| 查看容器 IP | docker inspect -f '{{.NetworkSettings.IPAddress}}' <容器> |
| 查看容器日志最后 100 行并跟踪 | docker logs -f --tail 100 <容器> |
12. 安全与最佳实践总结
- 持久化数据必须挂载卷:数据库、上传文件、配置文件等绝对不要存放在容器内部。
- 限制容器资源:使用
--memory和--cpus防止单个容器耗尽宿主机资源。 - 使用非 root 用户运行容器:在 Dockerfile 中用
USER指令,或在docker run时用--user。 - 定期更新镜像和容器:关注安全漏洞,及时拉取官方修复版本。
- 清理无用资源:定期执行
docker system prune,但确认数据已备份。 - 使用 .dockerignore:构建时排除无关文件,加速构建并减小镜像体积。
- 为镜像打标签:版本号或日期,便于回滚和追溯。
本手册将持续更新,建议收藏。如有遗漏命令,可自行补充。