首页/云/Kubernetes 速查/kubectl cp 与容器互传文件
本包目录(307 条)
kubectl 基础56 条
工作负载36 条网络与服务55 条配置与存储54 条调度与资源52 条集群运维与排障54 条

kubectl cp 与容器互传文件

在本地与容器之间复制文件/目录,基于 tar 实现:日常用来取日志、导配置、塞临时脚本,注意容器内需要有 tar。

Kubernetes 速查云更新于 2026-10-12
用途本地 ↔ 容器文件复制(依赖容器内 tar)
语法kubectl cp <pod>:<路径> <本地路径> [-c 容器];反向同理

常用示例

常用示例
kubectl cp prod/web-x:/var/log/app.log ./app.log
kubectl cp prod/web-x:/etc/app/conf.d ./conf-backup
kubectl cp ./hotfix.sh web-x:/tmp/hotfix.sh
kubectl cp ./data.csv web-x:/tmp/data.csv -c sidecar
命名空间随 Pod 语法写在前面(ns/pod);容器内没有 tar 时会报 'tar: not found'。

易错点

  • Windows 源路径带盘符(C:\...)会与 pod:path 语法冲突,先 cd 到目标目录用相对路径
  • 大文件传输慢且无进度显示,批量迁移建议走对象存储或挂载卷

数据来源与参考

  • Kubernetes 官方文档 · kubectl cp
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌