wagoodman/dive

Dive Docker镜像分析工具

概述和主要用途

Dive是一个开源的Docker镜像分析工具，旨在帮助开发者和运维人员深入探索Docker镜像的内部结构，查看各层内容，并识别可优化的空间，从而有效减小镜像体积。通过交互式界面和详细的层对比分析，Dive简化了镜像优化流程，是Docker镜像构建和优化的得力助手。

核心功能和特性

• 交互式镜像探索：提供直观的终端交互式界面，可逐层浏览镜像文件系统，查看文件添加、修改或删除情况。
• 层内容对比：清晰展示相邻层之间的文件差异，帮助识别冗余文件和不必要的层内容。
• 文件大小可视化：以树形结构和百分比展示每个文件/目录的大小占比，快速定位大文件。
• 镜像优化建议：基于层分析结果，提供减小镜像大小的建议（如合并层、删除临时文件等）。
• 多源镜像支持：支持分析本地Docker镜像、远程仓库镜像（需指定完整仓库路径）及tar格式导出的镜像文件。
• 非交互式模式：支持命令行非交互运行，便于集成到CI/CD流程中进行自动化镜像检查。

使用场景和适用范围

• Docker镜像优化：开发人员在编写Dockerfile后，通过Dive分析镜像层结构，识别冗余文件，优化构建步骤（如使用多阶段构建、清理缓存等）。
• CI/CD流程集成：在持续集成过程中自动检查镜像大小，确保镜像符合团队大小规范。
• 镜像故障排查：当镜像运行异常时，通过Dive查看各层文件内容，定位文件缺失或配置错误问题。
• Docker学习与教学：帮助理解Docker镜像分层原理，直观展示每层构建指令对文件系统的影响。

使用方法和配置说明

安装方式

通过Docker运行（推荐）

无需本地安装，直接通过Docker容器运行Dive：

bash
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock wagoodman/dive:latest [镜像名或ID]

示例：分析本地nginx:alpine镜像

bash
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock wagoodman/dive:latest nginx:alpine

本地二进制安装

从https://github.com/wagoodman/dive/releases%E4%B8%8B%E8%BD%BD%E5%AF%B9%E5%BA%94%E7%89%88%E6%9C%AC%E7%9A%84%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6%EF%BC%8C%E6%B7%BB%E5%8A%A0%E6%89%A7%E8%A1%8C%E6%9D%83%E9%99%90%E5%90%8E%E5%8D%B3%E5%8F%AF%E4%BD%BF%E7%94%A8%EF%BC%9A

bash
# 示例：Linux amd64系统（替换为最新版本号）
curl -LO https://github.com/wagoodman/dive/releases/download/v0.11.0/dive_0.11.0_linux_amd64.tar.gz
tar -zxvf dive_0.11.0_linux_amd64.tar.gz
chmod +x dive
sudo mv dive /usr/local/bin/

基本使用命令

交互式分析本地镜像

bash
dive [镜像名或ID]

示例：分析本地ubuntu:20.04镜像

bash
dive ubuntu:20.04

分析远程仓库镜像

bash
dive [仓库地址]/[镜像名]:[标签]

示例：分析Docker Hub上的python:3.9-slim镜像

bash
dive python:3.9-slim

分析tar格式镜像文件

bash
dive --source tar [tar文件路径]

交互式界面操作

启动Dive后进入交互式界面，主要操作如下：

• 文件树区域（左侧）：显示当前层文件系统结构，按Tab切换至此区域。
  • ↑/↓：移动光标；Enter：展开/折叠目录；Ctrl+A/Ctrl+E：跳转至顶部/底部。
• 层信息区域（右侧下）：显示镜像所有层，按Tab切换至此区域。
  • ↑/↓：切换层；Space：展开/折叠层详情。
• 全局快捷键：q退出，?查看帮助，Ctrl+C强制退出。

配置参数

示例：CI模式检查镜像大小

bash
dive --ci --threshold 5 nginx:alpine

若镜像大小增加超过5%，命令返回非0退出码，CI流程可据此判断失败。

环境变量

• DOCKER_HOST：指定Docker引擎地址（默认/var/run/docker.sock），适用于远程Docker环境分析。

示例：分析远程Docker引擎上的镜像

bash
DOCKER_HOST=tcp://remote-docker:2375 dive nginx:alpine