容器与云原生 / 系统课时
复制容器内外文件
复制容器内外文件
本课解决宿主机与容器之间临时传输文件的问题。完成后,你可以使用 docker cp 将配置、日志或测试文件复制到容器内,也能把容器中的文件取回宿主机进行检查。
学习目标
- 掌握
docker cp的双向复制语法 - 验证文件在宿主机和容器中的内容
- 理解路径、权限和持久化方面的局限
docker cp 基本语法
docker cp 的源路径和目标路径中,只要一端使用 容器名:路径,Docker 就能判断复制方向。从宿主机复制到容器:
docker cp <宿主机路径> <容器名>:<容器路径>。从容器复制到宿主机:
docker cp <容器名>:<容器路径> <宿主机路径>
容器可以处于运行或停止状态,但容器必须存在。目标文件的父目录也必须提前存在,docker cp 不会自动创建缺失的多级目录。
完成一次双向复制
下面创建一个 Alpine 容器,将宿主机文件复制到容器的 /tmp 目录,再把它复制回当前目录。
docker run -d --name cp-demo alpine:3.20 sleep 1d
echo 'hello from host' > host.txt
docker cp ./host.txt cp-demo:/tmp/host.txt
docker exec cp-demo cat /tmp/host.txt
docker cp cp-demo:/tmp/host.txt ./copied-back.txt
cat ./copied-back.txt
docker rm -f cp-demo
rm -f host.txt copied-back.txt预期输出
<CONTAINER_ID>
hello from host
hello from host
cp-demo<CONTAINER_ID> 是动态生成的容器 ID,实际值不同。部分 Docker 版本还会显示文件复制进度,不影响结果判断。
复制目录与处理路径
复制目录时,Docker 会递归处理目录中的文件。需要特别区分“复制目录本身”和“复制目录内容”:源路径末尾是否包含 /.,可能影响目标目录结构。
建议先使用 docker exec <容器名> ls -l <目标路径> 检查容器目录,再执行复制。路径包含空格时,应使用引号包裹完整参数。
局限与安全注意事项
docker cp 适合临时传输和故障排查,不适合持续同步。容器被删除后,其可写层中的文件也会消失,重要数据应放在绑定挂载或 Docker 卷中。
复制后的文件权限和所有者可能与源端不同。配置文件、脚本或证书复制完成后,应通过 ls -l 检查权限,避免因权限过宽或无法读取导致服务异常。
符号链接默认按链接本身处理;需要跟随链接指向的内容时,可以使用 docker cp -L。使用该选项前应确认链接目标,避免复制超出预期范围的文件。