ADD 指令仅自动解压本地 tar 类格式（.tar、.tar.gz、.tgz、.tar.bz2、.tar.xz），且要求源为本地路径、目标为目录、归档内无绝对或上级路径；.zip 等格式及远程 URL 均不解压，推荐用 COPY + RUN 显式解压。
ADD 指令在 Dockerfile 中确实支持自动解压本地压缩包，但有严格限制条件，并非所有格式都适用。
哪些压缩格式会被自动解压？
只有满足以下全部条件的本地 tar 归档文件，才会被 ADD 自动解压：
- 必须是
.tar、.tar.gz、.tgz、.tar.bz2或.tar.xz格式 - 必须是本地路径（即源路径不能是 URL）
- 目标路径（destination）必须是目录（以
/结尾，或目标已存在为目录） - 归档内不能含有绝对路径或上级路径（如
/etc/passwd或../secret），否则解压失败
常见误区与失效情况
以下情况 ADD 不会解压，而是直接复制文件本身：
- 源文件是
.zip、.7z、.rar等非 tar 系列格式 - 源路径是远程 URL（例如
ADD https://example.com/app.tar.gz /app/）→ 此时只下载不解压 - 目标路径指向一个具体文件名（如
ADD app.tar.gz /app，而非/app/）→ 视为目标文件，直接覆盖写入 - Docker 构建上下文外的路径（如
ADD /home/user/app.tar.gz /app/）→ 构建报错，根本无法访问
推荐替代方案：显式解压更可控
为避免隐式行为带来的不确定性（如格式不兼容、路径安全限制、调试困难），建议显式控制解压过程：
- 用
COPY复制压缩包（语义明确，不触发解压） - 用
RUN调用系统解压命令（如tar -xzf、unzip），可加校验、指定权限、过滤路径 - 对
.zip等格式，这是唯一可靠方式
示例：
COPY app.zip /tmp/RUN unzip /tmp/app.zip -d /app && rm /tmp/app.zip
小结：ADD 解压是便利特性，不是通用解包工具
它只为简化常见 tar 类资源的部署而设计，不可依赖其处理任意压缩格式或复杂逻辑。生产环境建议优先使用显式 COPY + RUN 组合，提升可读性、可维护性和安全性。
