Docker cp命令成功提示中的文件大小为何不准确？

问题现象 #

使用docker cp复制文件时，命令返回的成功提示大小和主机上实际文件大小不一致：

• 复制3.20KB的文件，提示复制了5.12KB
• 复制空文件，提示复制了1.54KB，但实际文件大小为0
• 双向复制（主机→容器/容器→主机）均存在此问题

核心原因 #

Docker cp底层是通过tar归档格式完成文件传输的，命令提示的大小是传输的tar包总大小，而非原始文件的实际大小：

• 即使是空文件，tar包也会包含该文件的元数据（文件名、权限、创建时间等），这些元数据会占用一定空间
• 非空文件的tar包除了文件内容，还会加上tar头部信息、块对齐填充数据，导致总大小比原始文件大

提示信息的实际意义 #

这个看似“不准确”的提示并非无用，它的价值在于：

1. 确认传输完整性：它反映的是实际完成传输的数据总量，告诉你整个复制过程没有中断，数据已完整送达目标端
2. 排查传输异常：如果多次复制同一文件时，提示的传输大小波动较大，可能暗示存在网络不稳定、存储IO异常等问题
3. 适配复杂复制场景：当复制目录、符号链接、设备文件等特殊对象时，tar会包含这些对象的完整元数据，此时传输大小能准确体现实际处理的数据量，而原始文件大小无法覆盖这些场景的信息

对应示例验证 #

针对你提到的空文件复制场景：

> docker cp my-container:/empty-file /opt/empty-file
Successfully copied 1.54kB to /opt/empty-file
> stat /opt/empty-file
File: /opt/empty-file
Size: 0               Blocks: 0          IO Block: 4096   regular empty file

这里的1.54KB就是包含空文件元数据的tar包大小，实际文件内容为0是正常表现。

内容的提问来源于stack exchange，提问作者Tobias Liefke