Docker中文件拷贝命令`docker cp`详解

9 次阅读

docker cp 是 Docker 日常运维中非常实用的文件传输命令，主要用于在宿主机与容器之间复制文件或目录。无论是从容器中导出日志、配置文件，还是将本地配置、脚本、安装包复制到正在运行的容器中，都可以通过 docker cp 快速完成。

与通过 docker exec 进入容器后再操作文件相比，docker cp 不要求用户进入容器内部，特别适合临时文件提取、故障排查以及容器与宿主机之间的数据交换。

一、docker cp命令基本语法

docker cp 的基本语法如下：

Bash
docker cp [OPTIONS] CONTAINER:SRC_PATH DEST_PATH
docker cp [OPTIONS] SRC_PATH CONTAINER:DEST_PATH

其中：

  • CONTAINER：容器名称或容器 ID。

  • SRC_PATH：源文件或源目录路径。

  • DEST_PATH：目标文件或目录路径。

  • OPTIONS：可选参数，用于控制复制行为。

最常见的两种场景分别是：

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

以及：

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

例如，将容器中的日志文件复制到当前目录：

Bash
docker cp my-container:/var/log/app.log .

将当前目录中的配置文件复制到容器：

Bash
docker cp ./app.conf my-container:/etc/app/app.conf

二、从Docker容器复制文件到宿主机

容器运行过程中产生的日志、配置文件、运行结果等内容，有时需要保存到宿主机进行分析。

假设容器名称为 web-server，需要提取 /var/log/nginx/access.log：

Bash
docker cp web-server:/var/log/nginx/access.log ./access.log

执行完成后，宿主机当前目录会得到：

access.log

也可以直接指定目标目录：

Bash
docker cp web-server:/var/log/nginx/access.log /tmp/

如果需要复制整个目录，同样可以直接指定目录：

Bash
docker cp web-server:/etc/nginx /tmp/nginx

这样可以将容器中的 /etc/nginx 目录及其内容复制到宿主机。

三、从宿主机复制文件到Docker容器

反过来，也可以使用 docker cp 将宿主机上的文件传入容器。

例如：

Bash
docker cp ./nginx.conf web-server:/etc/nginx/nginx.conf

将本地脚本复制到容器：

Bash
docker cp ./backup.sh web-server:/usr/local/bin/backup.sh

如果需要复制整个目录：

Bash
docker cp ./config web-server:/opt/app/

这种方式适合临时修改容器中的配置、传递测试脚本或者导入诊断文件。

不过需要注意，直接修改运行中容器的文件系统通常只适合临时处理。容器被删除并重新创建后，这些修改可能不会保留。对于正式环境中的配置和数据，更推荐使用 Docker Volume、绑定挂载或者重新构建镜像。

四、使用容器ID进行文件复制

除了容器名称之外，还可以使用容器 ID。

先查看当前容器：

Bash
docker ps

可能得到类似结果：

CONTAINER ID   IMAGE          COMMAND       STATUS         NAMES
a1b2c3d4e5f6   nginx:latest   "nginx -g..." Up 10 minutes  web-server

此时可以执行：

Bash
docker cp a1b2c3d4e5f6:/etc/nginx/nginx.conf ./nginx.conf

容器 ID 不一定需要完整输入，只要 Docker 能够唯一识别即可。例如：

Bash
docker cp a1b2c3:/etc/nginx/nginx.conf .

实际使用中，容器名称通常更容易阅读和维护。

五、复制整个目录

docker cp 不仅支持单个文件，也支持目录。

例如：

Bash
docker cp web-server:/var/www/html ./html

执行后，宿主机上会出现相应目录结构。

也可以将宿主机目录复制到容器：

Bash
docker cp ./static web-server:/var/www/

复制目录时，需要特别留意源路径和目标路径的关系。不同路径组合可能导致目录被放置在目标目录内部，或者直接覆盖已有文件，因此在执行生产环境操作前，最好先确认目标目录结构。

六、复制文件时的路径写法

docker cp 中容器路径需要使用：

容器名称:/路径

例如：

Bash
docker cp app:/usr/src/app/package.json .

而宿主机路径则按照当前操作系统的路径规则填写。

Linux：

Bash
docker cp app:/data/result.txt /home/user/

Windows PowerShell：

PowerShell
docker cp app:/data/result.txt C:UsersAdminDesktop

Windows 环境下如果路径包含空格，建议使用引号：

PowerShell
docker cp app:/data/result.txt "C:UsersAdminMy Files"

七、docker cp支持停止状态的容器吗

可以。

docker cp 并不要求目标容器必须处于运行状态。即使容器已经停止，只要容器仍然存在，也可以复制其中的文件。

例如：

Bash
docker ps -a

查看包括停止状态在内的所有容器，然后：

Bash
docker cp old-container:/var/log/app.log ./app.log

这在故障排查时非常有用。

例如某个容器启动失败：

Bash
docker ps -a

发现容器已经退出，此时不一定需要重新启动容器，可以直接提取配置文件或日志：

Bash
docker cp failed-app:/var/log/app.log .

然后在宿主机上分析问题。

八、docker cp与docker exec的区别

docker cp 和 docker exec 经常被一起使用，但两者解决的问题并不相同。

docker cp 主要负责文件复制：

Bash
docker cp app:/tmp/test.log .

docker exec 主要负责在运行中的容器内部执行命令：

Bash
docker exec app ls -la /tmp

如果只是想把容器中的文件拿出来，使用 docker cp 更直接。

如果需要查看、修改或者执行容器内部命令，则可以使用：

Bash
docker exec -it app /bin/bash

进入容器后再进行操作。

例如：

Bash
docker exec app cat /etc/nginx/nginx.conf

如果只是希望将配置文件复制出来：

Bash
docker cp app:/etc/nginx/nginx.conf ./nginx.conf

后者通常更加方便。

九、docker cp复制文件的覆盖问题

如果目标位置已经存在同名文件，复制操作可能会覆盖目标文件内容，因此执行重要操作之前应该确认目标路径。

例如：

Bash
docker cp app:/etc/app/config.yml ./config.yml

如果当前目录已经存在 config.yml，不要直接认为 Docker 会自动帮你保留原文件。

生产环境中建议先备份：

Bash
cp ./config.yml ./config.yml.bak

再执行：

Bash
docker cp app:/etc/app/config.yml ./config.yml

对于重要配置文件，保留原始版本可以降低误操作带来的风险。

十、docker cp复制权限问题

文件复制完成后，权限和属主是实际使用中需要重点关注的问题。

例如从容器中复制文件：

Bash
docker cp app:/opt/app/data.db .

复制到宿主机后，可以检查：

Bash
ls -l data.db

如果文件需要由特定用户访问，应根据实际情况调整：

Bash
chown user:user data.db

同样，将宿主机文件复制进容器后，也需要确认容器内进程是否拥有访问权限。

例如：

Bash
docker cp ./app.conf app:/etc/app/app.conf

如果容器中的应用使用非 root 用户运行，而复制后的文件权限不允许该用户读取，就可能导致应用启动或加载配置失败。

因此，文件复制完成后不要只关注文件是否存在，还应该检查：

Bash
ls -l

以及容器内的：

Bash
docker exec app ls -l /etc/app/app.conf

十一、docker cp复制隐藏文件

Linux 中以 . 开头的文件属于隐藏文件，例如：

.env
.gitignore
.ssh

docker cp 可以直接复制这些文件。

例如：

Bash
docker cp app:/usr/src/app/.env ./.env

复制隐藏目录：

Bash
docker cp app:/root/.ssh ./ssh

操作配置文件时尤其要注意 .env 等隐藏文件，因为它们可能包含数据库连接信息、API密钥等敏感内容。

十二、docker cp处理文件名和目录名

如果路径中包含空格或者特殊字符，应使用引号。

例如：

Bash
docker cp app:"/opt/my app/config.json" .

宿主机路径同样需要根据 Shell 的解析规则处理：

Bash
docker cp ./my config.json app:/tmp/

更稳妥的方式是使用引号：

Bash
docker cp "./my config.json" app:/tmp/

这样可以避免 Shell 将空格解释成参数分隔符。

十三、docker cp的常见错误

1. No such container

执行：

Bash
docker cp myapp:/tmp/test.txt .

出现：

No such container

通常说明容器名称或 ID 写错了。

可以使用：

Bash
docker ps -a

确认准确的容器名称。

2. No such file or directory

例如：

Bash
docker cp app:/tmp/test.txt .

出现路径不存在的错误，需要确认容器内文件是否真实存在：

Bash
docker exec app ls -la /tmp

对于已经停止的容器，可以根据应用配置、镜像内容或者重新启动后进行检查。

3. Permission denied

如果复制或后续使用过程中出现权限错误，需要检查源文件、目标目录以及容器进程用户的权限。

可以查看容器内部权限：

Bash
docker exec app ls -l /path/to/file

查看宿主机权限：

Bash
ls -ld /path/to/directory

4. Error response from daemon

这类错误可能由路径错误、Docker 守护进程异常或者容器状态等原因造成。建议结合完整错误信息逐步排查，而不是仅根据错误最后一行判断原因。

十四、docker cp与Volume应该如何选择

docker cp 更适合一次性的文件传输。

例如：

  • 临时导出日志；

  • 提取容器中的配置；

  • 复制测试文件；

  • 从停止容器中恢复数据；

  • 向容器临时传入脚本。

而 Docker Volume 更适合需要长期保存的数据。

例如数据库数据：

Bash
docker volume create mysql-data

然后将 Volume 挂载到容器：

Bash
docker run -d 
  --name mysql 
  -v mysql-data:/var/lib/mysql 
  mysql

这样容器删除后，数据仍然可以保存在 Volume 中。

因此，docker cp 更像是“文件搬运工具”，Volume 则更适合“持久化存储”。

十五、docker cp在故障排查中的实际应用

假设某个 Web 应用突然无法启动：

Bash
docker ps -a

发现：

app   Exited (1)

此时可以先复制日志：

Bash
docker cp app:/var/log/app/error.log ./error.log

分析日志：

Bash
cat ./error.log

如果怀疑配置文件错误，还可以将配置导出：

Bash
docker cp app:/opt/app/config/application.yml ./application.yml

在宿主机上检查配置：

Bash
cat ./application.yml

这种方法不需要反复进入容器，也不要求容器必须处于运行状态，非常适合故障现场分析。

十六、docker cp的实用命令汇总

从容器复制文件到宿主机：

Bash
docker cp app:/tmp/test.txt .

从宿主机复制文件到容器：

Bash
docker cp ./test.txt app:/tmp/

复制容器目录到宿主机：

Bash
docker cp app:/opt/data ./data

复制宿主机目录到容器：

Bash
docker cp ./data app:/opt/

使用容器 ID：

Bash
docker cp 8f3a21c:/var/log/app.log .

复制停止状态容器中的文件：

Bash
docker cp stopped-app:/etc/app/config.yml .

复制隐藏文件：

Bash
docker cp app:/usr/src/app/.env .

复制前查看容器：

Bash
docker ps -a

检查容器内文件：

Bash
docker exec app ls -la /path

十七、使用docker cp时的注意事项

第一，不要把 docker cp 当成正式的数据持久化方案。容器内部手工修改的文件可能随着容器重新创建而消失。

第二，生产环境中复制配置文件前应做好备份，尤其是数据库配置、反向代理配置和应用核心配置。

第三，复制包含敏感信息的文件时要特别谨慎。例如 .env、SSH密钥、数据库配置以及认证凭据，都不应该随意复制到公共目录。

第四，复制文件后检查权限和属主。如果应用使用普通用户运行，root 用户复制进去的文件可能导致应用无法正常访问。

第五，使用目录复制时应确认源路径和目标路径，避免因为路径层级理解错误导致文件被放置到意料之外的位置。

第六，对于经常需要共享的数据，不建议反复依赖 docker cp。应根据应用需求选择 Volume、绑定挂载或其他持久化方案。

docker cp 的核心作用可以概括为“在容器文件系统与宿主机文件系统之间复制文件和目录”。掌握容器名称、源路径、目标路径以及文件权限等几个关键点后，就可以覆盖日志提取、配置备份、故障排查、测试文件传输等大量 Docker 使用场景。对于一次性的文件交换，docker cp 简单直接；对于长期数据管理，则应结合 Volume 或挂载机制进行设计。

文章标签
Docker docker cp Docker容器 Docker文件复制 容器文件拷贝