copy指令用于将宿主机构建上下文中的文件或目录复制到docker镜像指定路径，支持通配符和绝对/相对目标路径，自动创建不存在的目录，推荐用于配置文件等静态资源，且比add更安全透明。

COPY 指令用于在构建 Docker 镜像时，把宿主机上的文件或目录复制到镜像的指定路径中。配置文件（比如 nginx.conf、appsettings.json、.env 等）通常用 COPY 复制进容器，确保应用启动时能正确读取。

基本语法和常见写法

COPY 的标准格式是：

COPY

其中：

• 源路径 是构建上下文（build context）中的相对路径，不能是绝对路径，也不能超出构建上下文范围
• 目标路径 是镜像内的绝对路径；若目录不存在，Docker 会自动创建（但不会递归创建深层父目录，除非最后一级是目录且以 / 结尾）
• 支持通配符（如 COPY *.conf /etc/nginx/conf.d/），匹配规则遵循 Go 的 filepath.Match
• 推荐始终使用绝对路径作为目标路径，避免歧义

复制单个配置文件的典型示例

比如把项目根目录下的 redis.conf 复制到容器的 /usr/local/etc/redis.conf：

COPY redis.conf /usr/local/etc/redis.conf

注意：如果目标路径末尾不带 /，Docker 会把它当作文件处理；如果目标是目录，建议显式加斜杠（如 /etc/nginx/conf.d/），否则可能因路径不存在而报错。

OpenClaw Docker Setup

在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...

下载

复制多个配置文件或整个配置目录

可以分多次 COPY，也可以用一次指令复制整个目录：

COPY config/ /app/config/

这会把本地 config/ 目录（含所有子文件、子目录）递归复制到镜像的 /app/config/。前提是 config/ 在构建上下文中，且 Dockerfile 位于其同级或上级目录。

小技巧：

• 用 .dockerignore 排除不需要的文件（如 *.log、secrets/），避免误传敏感内容或增大镜像
• 如果配置文件依赖构建时变量（如环境名），考虑用 ARG + ENV 配合模板工具（如 envsubst）动态生成，而不是直接 COPY 原始文件

和 ADD 的区别及何时选 COPY

COPY 更简单、更透明、更安全——它只做复制，不自动解压、不支持 URL 源。Docker 官方推荐优先使用 COPY，除非你明确需要 ADD 的额外能力（如自动解压 tar 包或从远程 URL 下载）。对配置文件这类静态资源，COPY 是标准且稳妥的选择。