5、docker镜像管理命令

1、命令总览

2、docker   buildx*    

2.1、Docker build

# 构建镜像并标记为 myapp:v1
docker build -t myapp:v1 .

# 构建指定标签的 Docker 镜像
docker build -t myImage:v0.1.0 .

# 使用指定目录中的 Dockerfile 构建映像
docker build -t myImage -f demo/Dockerfile

2.2、docker buildx create

# 创建一个新的名为 mybuilder 的 builder 实例
docker buildx create --name mybuilder

# 创建使用 Docker 容器作为驱动的 builder 实例
docker buildx create --name mybuilder --driver docker-container

# 创建并自动启动 builder 实例
docker buildx create --name mybuilder --bootstrap

# 创建新的 builder 并将其设为默认
docker buildx create --name mybuilder --use

# 创建一个自定义 builder 实例并立即激活
docker buildx create --name mybuilder --use

2.3、docker buildx use

# 切换到名为 mybuilder 的 builder 实例
docker buildx use mybuilder

# 切换到名为 mybuilder 的 builder 实例，并将其设为默认
docker buildx use --name mybuilder --use

# 创建新的 builder 实例并立即切换到它
docker buildx use --bootstrap

# 列出所有可用的 builder 实例
docker buildx use --list

# 切换到默认的 builder 实例
docker buildx use default

2.4、docker buildx ls

# 列出所有可用的 builder 实例及其详细信息
docker buildx ls

# 仅列出所有 builder 的名称
docker buildx ls -q

# 列出 builder 名称和使用的驱动名称
docker buildx ls --format "table {{.Name}}\t{{.DriverName}}"

# 列出所有 builder，包括详细信息
docker buildx ls --all

2.5、docker buildx build

# 使用当前激活的 builder 构建镜像
docker buildx build -t myimage:latest .

# 指定目标平台构建并推送镜像
docker buildx build --platform linux/amd64,linux/arm64 -t myregistry/myimage:latest --push .

# 构建完成后将镜像导入本地环境
docker buildx build -t myimage:latest --load .

# 构建时不使用缓存，强制重新构建所有层
docker buildx build --no-cache -t myimage:latest .

# 构建时传递构建参数
docker buildx build --build-arg HTTP_PROXY=http://proxy:8080 -t myimage:latest .

# 构建并导出为 tar 文件
docker buildx build -t myimage:latest -o type=docker,dest=myimage.tar .

2.6、docker buildx bake

# 构建所有目标
docker buildx bake

# 构建特定目标
docker buildx bake myapp

# 构建特定目标并推送
docker buildx bake --push myapp

# 构建特定目标并导入到本地环境
docker buildx bake --load myapp

# 构建特定目标不使用缓存
docker buildx bake --no-cache myapp

# 构建特定目标并覆盖配置
docker buildx bake --set "myapp.tags=latest" myapp

2.7、docker buildx inspect

# 显示名为 mybuilder 的 builder 实例的详细信息
docker buildx inspect mybuilder

# 以 JSON 格式输出 builder 实例的信息，便于脚本处理
docker buildx inspect mybuilder --format "{{json .}}"

# 仅输出 builder 实例的节点信息
docker buildx inspect mybuilder --format "{{json .Node }}"

2.8、docker buildx du

# 查看当前构建器的磁盘使用情况
docker buildx du

# 使用详细输出来检查磁盘使用记录
docker buildx du -v

# 检查特定构建器实例的磁盘使用情况
docker buildx du --builder mybuilder

2.9、docker buildx prune

# 清理所有构建缓存
docker buildx prune

# 清理所有构建缓存，包括内部镜像
docker buildx prune --all

# 清理构建缓存，保留最近5分钟的数据
docker buildx prune --filter "until=5m"

# 清理构建缓存，保留1GB的存储空间
docker buildx prune --keep-storage 1g

2.10、docker buildx stop

# 停止名为 mybuilder 的 builder 实例
docker buildx stop mybuilder

# 列出所有 builder 实例并停止
docker buildx ls -q | xargs -n 1 docker buildx stop

# 停止所有 builder 实例
docker buildx stop --all

2.11、docker buildx rm

# 删除名为 mybuilder 的 builder 实例
docker buildx rm mybuilder

# 强制删除名为 mybuilder 的 builder 实例（如果正在运行也会被删除）
docker buildx rm -f mybuilder

# 删除所有 builder 实例
docker buildx rm --all

2.12、docker buildx imagetools

# 使用 docker buildx imagetools create 命令创建新镜像
docker buildx imagetools create my-multi-stage-image:latest ~/project

# 检查单平台 Docker 镜像的详细信息
docker buildx imagetools inspect hello-world

# 检查多平台 Docker 镜像的详细信息
docker buildx imagetools inspect alpine

3、docker save

# ---------- docker save 常用示例 ----------
# 1) 打包单个镜像
docker save -o nginx_alpine.tar nginx:alpine

# 2) 一次打包多个镜像到一个 tar
docker save -o web_cache.tar redis:7 alpine:3.18

# 3) 打包并实时压缩
docker save nginx:alpine | gzip > nginx_alpine.tar.gz

# 4) 管道直连：A 机器 → B 机器，无需中间文件
docker save myapp:latest | ssh user@192.168.1.100 "docker load"

# 5) 查看 tar 包里包含哪些镜像
tar -tf web_cache.tar | grep "\.json" | head

4、docker   load

       Load an image from a tar archive or STDIN

# ---------- docker load 常用示例 ----------
# 1) 从本地 tar 导入镜像
docker load -i web_cache.tar

# 2) 重定向导入（效果同上）
docker load < web_cache.tar

# 3) 静默导入（不输出详细进度）
docker load --quiet -i web_cache.tar

# 4) 管道直连：远程机器把 tar 流过来直接 load
ssh user@192.168.1.100 "cat /tmp/web_cache.tar" | docker load

# 5) 解压并导入（tar.gz 场景）
gunzip -c web_cache.tar.gz | docker load

5、docker   tag

        Create a tag TARGET_IMAGE that refers to SOURCE_IMAGE

# ---------- docker tag 常用示例 ----------
# 1) 为已有镜像 nginx:alpine 创建本地新标签
docker tag nginx:alpine mynginx:latest

# 2) 按镜像 ID 打标签（假设 ID 为 1a2b3c4d）
docker tag 1a2b3c4d myapp:v1.0.0

# 3) 为推送私有仓库打标签
docker tag myapp:v1.0.0 harbor.example.com/library/myapp:v1.0.0

# 4) 一次镜像多版本标签（方便回滚）
docker tag myapp:v1.0.0 myapp:stable
docker tag myapp:v1.0.0 myapp:1.0
docker tag myapp:v1.0.0 myapp:latest

# 5) 批量重命名脚本示例（把旧仓库名统一换成新仓库名）
for t in $(docker images --format '{{.Repository}}:{{.Tag}}' | grep '^oldrepo/'); do
    new_name=$(echo "$t" | sed 's#^oldrepo/#newrepo/#')
    docker tag "$t" "$new_name"
done

6、docker rmi  

      Remove one or more images

# ---------- docker rmi 常用示例 ----------
# 1) 删除单个镜像（按仓库:标签）
docker rmi nginx:alpine

# 2) 删除单个镜像（按镜像 ID，前 4 位即可）
docker rmi 7d8e

# 3) 强制删除（即使有容器正在使用）
docker rmi -f myapp:latest

# 4) 一次删除多个镜像
docker rmi redis:7 alpine:3.18 busybox:1.35

# 5) 批量删除所有“悬空”镜像（<none>:<none>）
docker rmi $(docker images -f "dangling=true" -q)

# 6) 危险！一次性清空本地所有镜像（慎用）
# docker rmi $(docker images -q)

7、docker   image

   Manage images

# ---------- docker image 常用示例 ----------
# 1) 列出本地镜像（简洁格式）
docker image ls

# 2) 仅显示镜像 ID（脚本用）
docker image ls -q

# 3) 删除指定镜像
docker image rm nginx:alpine

# 4) 强制批量删除所有悬空镜像
docker image prune -f

# 5) 强制删除所有未被容器引用的镜像（慎用）
docker image prune -a -f

# 6) 查看镜像完整元数据
docker image inspect nginx:alpine

# 7) 查看镜像分层历史（带大小）
docker image history --no-trunc nginx:alpine

# 8) 给镜像打标签（与 docker tag 等价）
docker image tag nginx:alpine harbor.example.com/library/nginx:v1

8、docker history

    Show the history of an image

# ---------- docker history 常用示例 ----------
# 1) 查看镜像分层历史（默认表格式）
docker history nginx:alpine

# 2) 显示完整命令（不被截断）
docker history --no-trunc nginx:alpine

# 3) 仅查看镜像 ID 与大小（脚本友好）
docker history --format "table {{.ID}}\t{{.Size}}" nginx:alpine

# 4) 按层大小排序（由大到小）
docker history --format "{{.Size}}\t{{.CreatedBy}}" nginx:alpine | sort -hr

# 5) 配合 jq 统计总大小（需安装 jq）
docker history --format '{{json .}}' nginx:alpine | jq -s 'map(.Size | tonumber) | add' | numfmt --to=iec