Docker 常用命令

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

docker version                                 # 客户端与服务端版本
docker info                                    # Docker Engine 配置、资源和存储信息
docker context ls                              # 已配置的连接环境
docker context show                            # 当前 context 名称
docker context use 【context名】                # 切换默认连接环境
docker compose version                         # Compose 版本
docker run --help                              # 查看某条命令的参数

# 仅本次连接指定环境，查询容器
docker --context 【context名】 ps

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

docker images                                # 本地镜像，等同于 docker image ls
docker images --digests                      # 同时显示镜像摘要
docker search 【关键词】                       # 搜索 Docker Hub，不是搜索本地镜像
docker pull 【镜像:标签】                      # 拉取指定镜像
docker image inspect 【镜像:标签】             # 镜像配置、架构等详情
docker history 【镜像:标签】                   # 镜像各层的历史信息

# 按仓库名和标签筛选本地镜像
docker images --filter 'reference=nginx:*'
# 用摘要指定镜像内容
docker pull 【镜像仓库】@sha256:【摘要】

1
2
3
4
5

# 基本形式：Docker 参数在镜像之前，容器内命令及参数在镜像之后
docker run 【Docker参数】 【镜像:标签】 【容器内命令及参数】

# 新建临时容器并进入 Shell，退出后自动删除
docker run --rm -it alpine:3 sh

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 准备页面和容器网络
mkdir html
printf '%s\n' '<h1>Hello Docker</h1>' > html/index.html
docker network create app-net

docker run -d \
  --name web \
  --restart unless-stopped \
  --network app-net \
  -p 127.0.0.1:8080:80 \
  -v "$PWD/html:/usr/share/nginx/html:ro" \
  --cpus=1 \
  --memory=256m \
  nginx:alpine

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

docker ps                                      # 运行中的容器
docker ps -a                                   # 所有容器，包含已停止的
docker ps -q                                   # 只输出运行中容器的 ID
docker ps -a --filter status=exited            # 筛选已退出容器
docker ps --filter name=web                    # 按名称匹配，可能匹配多个容器
docker start 【容器】                           # 启动已有的停止状态容器
docker stop --timeout 30 【容器】               # 请求停止，最多等待 30 秒后强制结束
docker restart 【容器】                         # 重启已有容器
docker rename 【容器】 【新名称】                 # 修改容器名
docker pause 【容器】                           # 暂停容器进程
docker unpause 【容器】                         # 恢复容器进程

1

docker ps -a --format 'table {{.Names}}\t{{.Image}}\t{{.Status}}'

1
2
3
4
5
6
7
8

docker logs 【容器】                           # 已保留的容器日志
docker logs --tail 100 【容器】                # 最后 100 行
docker logs -f --tail 100 【容器】             # 持续跟踪，Ctrl+C 结束查看
docker logs --since 10m 【容器】               # 最近 10 分钟
docker logs --timestamps 【容器】              # 增加时间戳

# 合并标准输出与标准错误，再筛选关键词
docker logs --since 1h 【容器】 2>&1 | grep -F '【关键词】'

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

docker exec -it 【容器】 sh                     # 在运行中的容器里启动交互式 Shell
docker exec -it 【容器】 bash                   # 镜像中安装了 Bash 时可用
docker exec 【容器】 【命令及参数】               # 执行单条命令
docker exec -u root -it 【容器】 sh             # 以容器内 root 身份执行

# 管道由容器内的 Shell 解释，单引号避免本地 Shell 提前处理
docker exec 【容器】 sh -c 'ls /etc | head -n 5'
# 本机 → 容器
docker cp 【本地文件】 【容器】:【容器路径】
# 容器 → 本机
docker cp 【容器】:【容器文件】 【本地路径】

1

docker attach 【容器】                         # 连接已有主进程的输入、输出和错误流

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

docker inspect 【容器】                         # 完整配置和状态，默认 JSON
docker top 【容器】                             # 容器中的进程
docker stats                                   # 持续显示运行中容器的资源用量
docker stats --no-stream 【容器】               # 只采样一次

# 主进程状态、退出码、是否被 OOM 杀死
docker inspect --format '{{.State.Status}} {{.State.ExitCode}} {{.State.OOMKilled}}' 【容器】
# 挂载信息、端口映射、重启策略
docker inspect --format '{{json .Mounts}}' 【容器】
docker inspect --format '{{json .NetworkSettings.Ports}}' 【容器】
docker inspect --format '{{json .HostConfig.RestartPolicy}}' 【容器】
# 修改已有容器的重启策略
docker update --restart unless-stopped 【容器】

1
2
3
4
5
6
7
8
9

docker port 【容器】                           # 已发布的端口映射
docker network ls                             # 网络列表
docker network inspect 【网络名】               # 网络配置及连接的容器
docker network create 【网络名】                # 默认创建自定义 bridge 网络
docker network connect 【网络名】 【容器】        # 将已有容器接入网络
docker network disconnect 【网络名】 【容器】     # 断开连接，会影响通信

# 新建容器时指定已存在的网络
docker run -d --name 【容器名】 --network 【网络名】 【镜像:标签】

1
2
3
4
5
6
7
8

docker volume ls                              # 数据卷列表
docker volume create 【卷名】                  # 创建命名卷
docker volume inspect 【卷名】                 # 驱动、挂载位置等信息

# 使用命名卷，Docker 管理实际存储位置
docker run -d --name 【容器名】 --mount type=volume,src=【卷名】,dst=/data 【镜像:标签】
# 绑定主机目录，只读挂入容器；源目录需预先存在
docker run -d --name 【容器名】 --mount type=bind,src=【主机绝对路径】,dst=/data,readonly 【镜像:标签】

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 在项目目录执行，默认读取当前目录的 Dockerfile
docker build -t 【镜像名】:【标签】 .
# 指定 Dockerfile，最后的点仍表示当前目录作为构建上下文
docker build -f 【Dockerfile路径】 -t 【镜像名】:【标签】 .
# 尝试更新基础镜像，并且不复用构建缓存
docker build --pull --no-cache -t 【镜像名】:【标签】 .

# 为同一镜像增加一个远程仓库标签
docker tag 【本地镜像:标签】 【仓库地址】/【命名空间】/【镜像名】:【标签】
docker login 【仓库地址】                      # 按提示完成认证
docker push 【仓库地址】/【命名空间】/【镜像名】:【标签】
docker logout 【仓库地址】                     # 移除本地保存的登录凭据

1

docker buildx build --platform linux/amd64 --load -t 【镜像名】:【标签】 .

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# 镜像 → tar 文件；把文件复制到另一台机器后，用 load 恢复
docker save -o 【镜像归档.tar】 【镜像:标签】
docker load -i 【镜像归档.tar】

# 容器文件系统 → tar 文件；import 从文件系统归档创建新镜像
docker export -o 【文件系统.tar】 【容器】
docker import 【文件系统.tar】 【新镜像:标签】

# 将容器文件改动保存为新镜像，适合临时留存调试现场
docker commit 【容器】 【新镜像:标签】

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

docker compose config                         # 解析、合并配置，检查格式
docker compose config --services              # 列出服务名
docker compose up -d                          # 创建或更新服务，后台运行
docker compose up -d --build                  # 先构建镜像，再启动或更新
docker compose ps                             # 当前项目的容器状态
docker compose ps -a                          # 包含已停止的容器
docker compose logs -f --tail 100 【服务名】    # 跟踪指定服务日志
docker compose exec 【服务名】 sh               # 在运行中的服务容器里启动 Shell
docker compose stop                           # 停止服务，保留容器
docker compose start                          # 启动已有的停止状态容器
docker compose restart 【服务名】               # 重启指定服务
docker compose pull                           # 拉取服务镜像，不重建容器
docker compose down                           # 停止并删除项目容器及相关网络

# 显式指定配置文件和项目名，后续操作也使用相同参数
docker compose -f 【配置文件.yaml】 -p 【项目名】 up -d

1
2
3
4
5
6

docker system df                             # 镜像、容器、卷和构建缓存占用
docker system df -v                          # 展开占用详情
docker rm 【容器】                            # 删除已停止的容器
docker rmi 【镜像:标签】                       # 删除本地镜像引用，等同于 docker image rm
docker network rm 【网络名】                  # 删除没有容器连接的网络
docker volume rm 【卷名】                     # 删除未被容器引用的卷及其中数据