zzreo
← 全部文章

Docker 常用命令手册

本文目录
  1. 📋 快速速查表
  2. 1. 基本概念速览
  3. 2. 镜像管理
  4. 3. 容器生命周期管理
    1. docker run 常用选项
  5. 4. 容器查看与排障
  6. 5. 数据卷(Volume)管理
    1. 挂载方式对比
  7. 6. 网络管理
  8. 7. Docker Compose 常用命令
  9. 8. 系统清理与维护
  10. 9. 多平台构建(Buildx)
  11. 10. 快速排障流程
  12. 11. 常用组合命令(巧用管道)
  13. 12. 安全与最佳实践总结

本手册涵盖日常开发、服务器部署、容器排障和系统维护所需的所有常用 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. 快速排障流程

遇到容器异常时,按顺序执行以下检查:

  1. 查看容器状态
    docker ps -a → 确认是否运行、退出码、重启次数。

  2. 查看日志
    docker logs <容器名> --tail 50 → 查找错误栈或超时信息。

  3. 检查资源占用
    docker stats → 是否 CPU/内存耗尽。

  4. 进入容器检查
    docker exec -it <容器名> bash → 查看进程、文件、网络。

  5. 检查卷权限(常见于 MySQL)
    docker inspect <容器> | grep -A 10 Mounts → 确认卷路径,检查宿主机目录所有者是否为容器内用户(如 MySQL 的 uid 999)。

  6. 查看系统日志(宿主机)
    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:构建时排除无关文件,加速构建并减小镜像体积。
  • 为镜像打标签:版本号或日期,便于回滚和追溯。

本手册将持续更新,建议收藏。如有遗漏命令,可自行补充。