首页/云/云与容器速查/Dockerfile ADD 指令
本包目录(340 条)
云基础概念44 条计算与存储56 条网络与安全组33 条
容器与 Docker106 条
Kubernetes68 条容器排障33 条

Dockerfile ADD 指令

COPY 的增强版:额外支持本地 tar 自动解压与 URL 下载。除『确实需要解压 tar』外,一律优先 COPY——ADD 的隐式解压常让人意外。

云与容器速查云更新于 2026-10-12
额外能力本地 tar 自动解压;支持从 URL 拉取文件
解压范围仅本地 tar(gz/bz2/xz),zip 与远程 tar 都不解
URL 缺陷不校验校验和、权限受限,不建议用于下载
建议普通复制用 COPY;ADD 仅用于明确的 tar 解压场景

典型用法

典型用法
ADD app-2026.tar.gz /opt/app/
ADD config.yaml /etc/app/config.yaml
从 URL ADD 会跳过校验且不自动解压:要下载请用 RUN curl 并校验 sha256,再 COPY 进镜像。

易错点

  • 以为 ADD 能解压 zip 或远程 tar:都不解,落下的是压缩文件
  • tar 内路径带顶层目录:解到 /opt/app/ 变成多一层嵌套,启动脚本找不到文件

数据来源与参考

  • Docker Docs:Dockerfile reference(ADD)

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌