容器与云原生 / 系统课时
复制容器文件
复制容器文件
本课演示如何使用 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
下一课预告
下一课将继续控制容器生命周期,学习如何导出日志或归档运行现场,为故障分析和迁移做好准备。
按自己的节奏,确认真正理解。