CONTAINER LENS

Docker 镜像文件浏览器v0.2.0

本地离线 · 不运行容器
尚未选择归档文件
TAR · TAR.GZ · TGZ / Docker save · OCI · 普通归档
准备读取…
不止解压归档,更能浏览镜像。

像浏览文件夹一样,
查看镜像里的每一个路径。

选择本地 Docker 镜像包,展开目录、搜索文件并查看源码和配置。识别镜像层后,按顺序合并出镜像打包时的文件系统。

把 .tar.gz / .tar 文件拖到这里或点击右侧按钮选择 · 无需 Docker、WSL 或服务器
01 / 浏览

真实目录结构

原始归档、逐层内容和合并视图。保留完整路径、来源层及 Linux 文件属性。

02 / 预览

源码与配置预览

安全地以纯文本查看 Python、JSON、YAML、Shell 等文件,不执行归档里的代码。

03 / 提取

按需提取

下载单个普通文件、导出路径清单,或继续打开包内嵌套的 TAR 归档。

归档识别
—
当前视图条目
0
镜像层数
—
普通文件逻辑大小
—
文件名 / 路径大小来源

使用说明与支持边界

开始使用

用较新版本的 Windows Edge / Chrome 打开页面,点击“选择镜像文件”或拖入归档。首次使用可点“打开演示”,查看两层示例镜像。演示数据不是你的项目文件。

三个视图

合并文件系统:按镜像清单顺序应用层,处理同路径覆盖、.wh.* 删除标记以及目录不透明标记。原始归档:浏览实际打包结构。单层视图:查看该层原始条目,包括删除标记;它不代表最终文件系统。

文件预览与下载

单击目录进入,单击文件查看详情。搜索作用于整个当前视图,不局限当前目录。默认最多预览 512 KiB;二进制预览最多显示 4 KiB 的十六进制。源码、HTML、SVG 均按纯文本显示,不运行。可下载普通文件;硬链接仅在找到内容时可下载,符号链接只显示目标。

下载保持文件内容,但 Windows 浏览器下载不会保留 Linux 权限、属主、时间戳或原目录结构。“导出路径清单”导出当前整个视图的 CSV,不导出文件内容,也不受搜索条件限制。对包内 TAR / GZIP 文件可继续打开,并返回上级归档。

格式与范围

支持外层 TAR / TAR.GZ / TGZ、常见 Docker-save 清单、OCI 索引与多镜像选择,以及普通 TAR(包括 docker export 文件系统包)。层内容支持 TAR 与 GZIP;支持常见 ustar、PAX、GNU 长文件名。优先面向 Linux 镜像。

暂不支持 ZIP / XZ / BZIP2 / ZSTD、GNU sparse 稀疏文件、Windows 容器层合并、镜像修改与重新打包、整目录批量提取。不会下载归档外的远程层;不校验 OCI 内容摘要与镜像签名。单层视图对跨层硬链接可能只能显示链接目标。

大包与内存

解析在 Worker 中进行,可随时取消;不等于无限内存。GZIP 解压结果仍需保留供随机浏览,实际内存/临时空间消耗可能明显超过原压缩包。默认将当前分析的 GZIP 累计展开量限制为 1 GiB;可调整到 256 MiB / 2 GiB / 4 GiB。提高限额可能导致浏览器或系统内存不足。

对大镜像,建议先将最外层 GZIP 解为 .tar 再选择;此时按 Blob 分片索引,无须把整个 TAR 读成一块数组。仍受条目数、嵌套层压缩、浏览器资源等限制。每个 TAR 最多索引 500,000 项;右侧列表分页,目录树分批展开。首次使用真实大包前请保留原文件。

看到的不是运行中容器

这里显示镜像打包时已有的文件,不包括运行后写入的可写层、数据库卷或宿主机挂载目录。源码若在构建时被删除、编译或未复制进镜像,本工具不会还原它。

镜像元数据(原文)

仅显示归档内已有的配置,不启动容器。环境变量等内容可能包含敏感信息,请勿随意分享。