alpine/dfimage 镜像文档

镜像概述与主要用途

alpine/dfimage镜像基于Whaler工具构建，Whaler是一个Go语言程序，核心功能是对Docker镜像进行反向工程，生成其构建时使用的Dockerfile。该镜像适用于开发者分析未知Docker镜像的构建逻辑、提取配置信息（如环境变量、开放端口）、检索潜在密钥文件等场景，支持多平台部署。

核心功能与特性

多平台支持

• 支持多种架构平台，包括linux/arm/v7、linux/arm64/v8、linux/arm/v6、linux/amd64、linux/ppc64le、linux/s390x。

Whaler核心能力

Whaler工具具备以下功能：

• 从Docker镜像生成对应的Dockerfile
• 在添加的文件中搜索潜在的密钥文件
• 提取通过Docker ADD/COPY指令添加到镜像中的文件
• 展示镜像的 miscellaneous 信息，如开放端口、运行用户、环境变量等

相关资源

• GitHub仓库：[***]
• 构建日志：[***]
• Docker镜像标签：[***]

使用方法与配置说明

基本运行方式

该镜像会自动拉取目标Docker镜像，参数-sV=1.36并非始终必需，具体根据实际情况调整。

设置命令别名（推荐）

为简化操作，建议先创建别名：

alias dfimage="docker run -v /var/run/docker.sock:/var/run/docker.sock --rm alpine/dfimage"

运行示例：分析nginx:latest镜像

dfimage -sV=1.36 nginx:latest

输出说明

执行上述命令后，将输出以下内容：

• 镜像分析概览（如Docker版本、GraphDriver）
• 环境变量列表（如PATH、NGINX_VERSION等）
• 开放端口（如80）
• 运行用户（如root）
• 潜在密钥文件（如有）
• 生成的Dockerfile内容（包含CMD、LABEL、ENV、RUN、COPY、ENTRYPOINT等完整指令）

示例输出片段

Analyzing nginx:latest
Docker Version: 18.09.7
GraphDriver: overlay2
Environment Variables
|PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
|NGINX_VERSION=1.19.0
|NJS_VERSION=0.4.1
|PKG_RELEASE=1~buster

Open Ports
|80

Image user
|User is root

Dockerfile:
CMD ["bash"]
LABEL maintainer=NGINX Docker Maintainers <***>
ENV NGINX_VERSION=1.19.0
...