容器与云原生 / 系统课时

复制容器文件

复制容器文件

本课演示如何使用 docker cp 在宿主机与容器之间双向复制文件和目录。完成后,你可以提取容器配置、导出临时结果,或把调试文件送入已有容器。

学习目标

  • 掌握宿主机与容器之间双向复制文件的命令格式
  • 理解复制目录本身与复制目录内容的区别
  • 处理目标父目录、文件权限和符号链接等常见边界

准备并从容器导出文件

创建一个持续运行的 Alpine 容器,并在容器内准备配置目录和示例文件。docker cp 只要求容器存在,因此容器停止后仍然可以复制文件。

bash
docker run -d --name copy-demo alpine:3.20 sh -c 'mkdir -p /work/config && printf "mode=prod\n" > /work/config/app.env && tail -f /dev/null'

预期输出:

text
<CONTAINER_ID>

命令格式是 docker cp 源路径 目标路径。容器内路径使用 容器名:路径 表示,宿主机路径按当前操作系统的普通路径规则书写。下面把容器中的配置文件复制到宿主机并读取内容。

bash
mkdir -p ./backup
docker cp copy-demo:/work/config/app.env ./backup/app.env
cat ./backup/app.env

预期输出:

text
mode=prod

这类操作适合提取运行时生成的配置、诊断文件或临时结果。对于持续变化的数据,应先让应用完成写入,避免复制到只写了一部分的文件。

从宿主机复制到容器

反向复制时,把宿主机路径写在前面,把容器路径写在后面。目标父目录必须已经存在,docker cp 不会递归创建缺失的父目录。

bash
printf 'feature=true\n' > ./feature.env
docker cp ./feature.env copy-demo:/work/config/feature.env
docker exec copy-demo cat /work/config/feature.env

预期输出:

text
feature=true

复制到容器中的文件默认由容器内的 root 用户拥有。应用以非 root 用户运行时,还要检查读取权限;需要保留源文件 UID 和 GID 时可使用 docker cp -a。

复制目录并处理边界

源路径以目录名结束时,会复制目录本身;源路径以 /. 结束时,只复制目录中的内容。下面的结果可以直观看出两种写法的差异。

bash
rm -rf ./backup-dir ./backup-content
mkdir -p ./backup-dir ./backup-content
docker cp copy-demo:/work/config ./backup-dir/
docker cp copy-demo:/work/config/. ./backup-content/
find ./backup-dir ./backup-content -maxdepth 2 -type f | sort

预期输出:

text
./backup-content/app.env
./backup-content/feature.env
./backup-dir/config/app.env
./backup-dir/config/feature.env

路径中包含空格时要使用引号。默认复制不会跟随源路径中的符号链接;确实需要复制链接指向的内容时使用 -L。复制大量或持续更新的数据时,应优先使用卷挂载、对象存储或备份工具,而不是反复执行 docker cp。

完成练习后删除测试容器。

bash
docker rm -f copy-demo

预期输出:

text
copy-demo

本课总结

  • docker cp 通过 容器名:路径 区分容器路径,可在两个方向复制文件或目录
  • 目录 会复制目录本身,目录/. 只复制目录内容
  • 复制前要确认目标父目录和权限;批量、长期数据同步不适合依赖 docker cp

下一课预告

下一课将继续控制容器生命周期,学习如何导出日志或归档运行现场,为故障分析和迁移做好准备。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

复制容器文件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通