VOLUME指令仅声明容器内卷挂载点，不挂载宿主机目录或传递数据；语法为VOLUME /path或VOLUME ["/p1","/p2"]，路径须绝对；构建时创建匿名卷占位，运行时自动挂载，但此前对该路径的COPY或RUN操作内容会被覆盖。
在 Docker 镜像构建（Dockerfile）中，VOLUME 指令本身**不用于挂载宿主机目录或传递数据**，它只声明一个“卷挂载点”，告诉 Docker 这个路径将来会被作为卷（volume）或绑定挂载（bind mount）使用。它不会复制文件、不读取宿主机内容，也不影响构建阶段的文件系统。
Volume 在 Dockerfile 中怎么写
VOLUME 指令语法简单，支持两种格式：
-
单路径写法：
VOLUME /data -
多路径写法（JSON 数组）：
VOLUME ["/var/log", "/app/config"]
路径必须是绝对路径。Docker 构建时会为每个路径创建匿名卷的“占位声明”，容器启动时若未显式指定挂载，Docker 就自动创建匿名卷并挂载到该路径。
常见误区：VOLUME 不等于复制或挂载宿主机文件
很多人误以为写 VOLUME /app/data 就能把当前目录下的 data/ 文件夹打包进镜像或绑定到宿主机——这是错的：
- 构建阶段所有文件操作（
COPY、RUN mkdir等）照常进行，VOLUME不干扰这些操作； - 但一旦某路径被声明为
VOLUME，后续在 Dockerfile 中对该路径的COPY或RUN echo等修改，在容器运行时会被“屏蔽”——因为运行时该路径已被卷覆盖，原始内容不可见； - 它不读取、不写入宿主机任何文件，纯属运行时行为提示。
什么时候该用 VOLUME？典型场景
适合声明那些**需要持久化、且内容由容器进程动态生成**的目录，例如：
- 数据库的数据目录（如 MySQL 的
/var/lib/mysql） - 应用日志路径（如
/var/log/myapp），方便日志收集或保留 - 用户上传文件存储路径（如
/uploads）
这样做的好处是：用户启动容器时可自由选择用命名卷、匿名卷或 bind mount 替换，而无需修改 Dockerfile。
实际构建建议：先 COPY 再 VOLUME
如果镜像需要提供默认配置或初始数据，正确顺序是：
✅ 正确（先放文件，再声明卷）：COPY config.yml /app/config.yml VOLUME /app/data
这样 config.yml 会进入镜像；而 /app/data 启动后由卷接管，不影响初始化逻辑。
VOLUME /app/data COPY initial-data/ /app/data/
此时 COPY 的内容在运行时不可见——因为卷挂载后覆盖了该路径。
