如何在 Docker 环境中将宿主机的文件复制到容器目录

在 Docker 环境中将宿主机的文件复制到容器目录，主要有以下三种方式，根据场景选择最合适的方法：

方法 1：docker cp 命令（临时复制）

适用场景：快速向已存在的容器复制少量文件（无需重建镜像或挂载卷）。

操作步骤：

1. 查找容器名称/ID：

   docker ps  # 查看运行中的容器列表
   

2. 复制文件到容器：

   # 复制单个文件
   docker cp /宿主机/文件路径 容器名或ID:/容器内/目标路径
   
   # 复制目录（递归复制）
   docker cp /宿主机/目录路径 容器名或ID:/容器内/目标路径
   

3. 从容器复制到宿主机（反向操作）：

   docker cp 容器名或ID:/容器内/文件路径 /宿主机/目标路径
   

示例：

# 复制本地文件 app.conf 到名为 web-server 的容器的 /etc/nginx 目录
docker cp ~/app.conf web-server:/etc/nginx/

# 复制本地目录 logs 到容器的 /var/log 目录
docker cp ./logs/ web-server:/var/log/

注意事项：

• 容器无需处于运行状态（停止的容器也可操作）。
• 目标路径需存在，否则会被识别为文件路径（可能导致覆盖）。
• 文件权限可能需在容器内手动调整（如 chmod）。

方法 2：Dockerfile 构建镜像（永久固化文件）

适用场景：将文件永久固化到镜像中（适合静态配置文件、程序代码等）。

操作步骤：

1. 在 Dockerfile 中使用 COPY 或 ADD 指令：

   FROM base-image:tag
   COPY ./宿主机/文件路径 /容器内/目标路径
   ADD ./宿主机/目录路径 /容器内/目标路径
   

2. 构建镜像并运行容器：

   docker build -t my-image .
   docker run -d --name my-container my-image
   

COPY vs ADD：

• COPY：仅复制本地文件到镜像。
• ADD：额外支持自动解压压缩包（如 .tar）和从 URL 下载文件（不推荐，需注意安全）。

方法 3：挂载数据卷（动态同步文件）

适用场景：宿主机与容器动态共享文件（如开发环境代码热更新、日志持久化）。

方式 1：直接挂载宿主机目录（Bind Mount）

docker run -d --name my-container \
  -v /宿主机/绝对路径:/容器内/目标路径 \
  image:tag

方式 2：使用命名卷（Volume）

# 创建卷
docker volume create my-vol

# 挂载卷到容器
docker run -d --name my-container \
  -v my-vol:/容器内/目标路径 \
  image:tag

# 复制文件到卷（需临时挂载）
docker run --rm -v my-vol:/target busybox cp /宿主机/文件 /target/

优势：

• 文件修改实时同步（双向）。
• 数据持久化（容器删除后文件仍保留）。

总结选择方案

常见问题解决

1. 权限问题：

   • 容器内访问挂载文件时可能因用户权限失败，可通过 -u 指定用户或修改文件权限：

     docker run -u root -v /host/path:/container/path image:tag
     

2. 路径错误：

   • 使用绝对路径（宿主机路径必须为绝对路径）。

3. 覆盖风险：

   • 若容器目标路径已存在同名文件，docker cp 或挂载会直接覆盖。