COPY 指令不支持直接复制远程文件，仅支持从构建上下文复制本地文件或目录；虽文档提及可复制 URL，但实际受限于协议（仅 HTTP/HTTPS）、无重定向处理、无认证支持、不自动解压，且易因状态码、DNS 或证书问题失败，推荐改用 RUN + curl/wget 实现可控下载。
COPY 指令可以直接复制远程文件，但需注意：它只支持 HTTP/HTTPS 协议的 URL，不支持 FTP、SSH 或私有仓库直链（如未公开的 Git raw 链接），且 Docker 构建时会自动下载并解压（若为 tar.gz 等归档格式）。
基本语法和用法
写法很简单：
-
COPY https://example.com/file.txt /app/→ 下载后存为/app/file.txt -
COPY https://github.com/user/repo/archive/main.tar.gz /tmp/→ 下载压缩包到/tmp/（不会自动解压）
注意：目标路径必须是绝对路径或相对于 WORKDIR 的路径，且目标目录需存在（或由 COPY 自动创建）；如果目标以 / 结尾，则视为目录，文件将被放入其中。
常见限制与注意事项
Docker 的 COPY 不会执行重定向跳转（如 302），也不支持带认证的 URL（如需 token 或 basic auth）。遇到以下情况会失败：
- URL 返回非 200 状态码（如 404、403）
- 服务端返回重定向但未启用自动跟随（COPY 不处理 Location 头）
- 证书不可信（自签名 HTTPS 站点默认拒绝，除非基础镜像已信任该 CA）
- URL 域名无法解析（构建环境 DNS 配置异常）
替代方案：需要更灵活控制时
当远程文件需鉴权、重试、解压或校验时，建议改用 RUN + curl/wget：
RUN curl -fsSL https://example.com/config.json -o /app/config.jsonRUN wget -qO- https://example.com/app.tgz | tar -xz -C /app- 可加
--retry 3 --timeout 10等参数增强健壮性
这种方式更可控，也便于添加 sha256 校验（例如先下载 checksum 文件再比对）。
多阶段构建中复制远程内容
如果想从远程获取构建工具或 SDK，可在构建阶段使用 COPY URL，但更推荐在 RUN 中完成，因为：
- COPY URL 是原子操作，失败即中断构建
- RUN 允许分步调试（如先 curl -I 检查状态）
- 避免把临时下载文件意外打包进最终镜像（COPY 会固化到层中）
例如，下载编译器并仅保留二进制文件到最终镜像，更适合用 RUN 下载 + mv + rm 组合，而非 COPY URL。
