docker cp 是 Docker 原生轻量文件传输命令，支持宿主机与容器双向复制，保留权限但需注意 UID 映射、路径结尾斜杠及通配符限制，适用于绝大多数场景。
在 Docker 开发和运维中，经常需要在宿主机（Docker 主机）和容器之间快速传输配置文件、日志、脚本或数据。Docker 原生命令 docker cp 是最直接、轻量且无需额外工具的方式，适用于绝大多数场景。
使用 docker cp 从宿主机复制文件到容器
该操作会将宿主机上的文件或目录复制进正在运行（或已停止）的容器内部指定路径：
- 语法：
docker cp <宿主机路径> <容器名或ID>:<容器内路径> - 示例：把本地的
nginx.conf复制到名为web的容器的/etc/nginx/目录下：docker cp ./nginx.conf web:/etc/nginx/nginx.conf - 注意：目标路径若为目录，需确保末尾有斜杠（
/）或明确指定文件名；否则会被当作新文件名处理。
使用 docker cp 从容器复制文件到宿主机
常用于提取日志、导出数据库备份、获取生成的配置等：
- 语法：
docker cp <容器名或ID>:<容器内路径> <宿主机路径> - 示例：从
db容器中拉取最近的 PostgreSQL 日志：docker cp db:/var/lib/postgresql/data/log/postgresql-2024-06-15_10.log ./logs/ - 支持通配符（如
*）仅限于容器内路径（需用引号包裹），但宿主机路径不支持通配符。
复制整个目录及权限注意事项
docker cp 默认保留源文件的读写执行权限（mode）和所有者 UID/GID，但容器内用户可能不存在对应 UID，导致权限显示异常（如显示为 1001 而非 www-data）：
- 复制目录时，目标路径若不存在，Docker 会自动创建；若存在，则将内容合并进该目录（类似
rsync -r） - 若需严格控制权限，建议在容器内用
chown或chmod二次调整，例如：docker exec db chmod 600 /backup/dump.sql - 对只读挂载（
:ro）的卷，docker cp仍可写入容器可写层，不受卷挂载选项限制。
替代方案与适用边界
当 docker cp 不便时（如需频繁同步、跨平台或自动化程度高），可考虑以下方式：
-
绑定挂载（Bind Mount）：启动容器时用
-v /host/path:/container/path实现双向实时共享，适合开发调试 -
命名卷（Named Volume）：适合持久化数据，但需先用
docker volume create创建，再通过临时容器进行拷贝中转 - 容器内启用 SSH 或 HTTP 服务：不推荐——增加攻击面，仅作特殊网络隔离场景下的兜底手段
掌握 docker cp 的基本用法和常见陷阱，就能高效完成绝大多数主机与容器间的文件交换任务，无需安装额外组件，也无需重启容器。
