VOLUME 指令用于声明容器内路径为数据卷挂载点，不创建实际卷，仅作运行时挂载标识；支持单路径或JSON数组格式，不可用变量；需配合 docker run -v 或 --mount 使用，否则自动创建匿名卷。

VOLUME 指令在 Dockerfile 中用于**声明容器内一个或多个路径为数据卷挂载点**，它不创建实际的数据卷，也不挂载宿主机目录，而是告诉 Docker：“这个路径将来可能需要被挂载为卷”，从而让容器启动时能自动关联匿名卷（或用户指定的命名卷/绑定挂载）。

作用和典型场景

它主要用于：

• 明确标出应用持久化数据的位置（如数据库文件、日志目录、上传的附件等）
• 避免容器内数据随容器删除而丢失（配合 docker run -v 或 --mount 使用）
• 提升镜像可移植性——不同环境可灵活挂载本地路径、NFS、云存储等
• 绕过 UnionFS 层，提升 I/O 性能（尤其对频繁读写的目录）

基本写法

语法简单，支持单个路径或 JSON 数组格式：

# 单个路径
VOLUME /data
<h1>多个路径（推荐 JSON 格式，避免空格解析歧义）</h1><p>VOLUME ["/var/log/app", "/opt/config", "/uploads"]

注意：不能使用变量（如 $HOME）或构建参数（ARG），因为 VOLUME 在镜像构建阶段就固定了路径，运行时才决定挂载源。

实际使用方式（运行时挂载）

Dockerfile 中的 VOLUME 只是“预留接口”，真正生效需在 docker run 时显式挂载：

OpenClaw Docker Setup

在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...

下载

• 用 -v 挂载宿主机目录：docker run -v /host/data:/data myapp
• 用 -v 创建匿名卷（Docker 自动分配）：docker run -v /data myapp（此时 /data 会映射到一个新匿名卷）
• 用 --mount 挂载命名卷：docker run --mount source=mydata,target=/data myapp

如果只写 VOLUME /data 但运行时没挂载，Docker 会自动创建一个匿名卷并挂载到该路径，数据仍可持久化（但不易管理）。

注意事项与常见误区

容易踩坑的地方：

• 不能在 VOLUME 后用 COPY 或 ADD 向该路径写入文件：因为构建时挂载点尚未存在，这些指令会被忽略或写入镜像层，但运行时该路径会被卷覆盖，导致内容丢失
• 不要用 VOLUME 替代初始化逻辑：比如想预置配置文件，应把模板放镜像里，再通过 ENTRYPOINT 脚本在首次启动时复制到卷中（若卷为空）
• 路径必须是绝对路径，且建议提前用 mkdir -p 和 chown 设置好权限（尤其多用户容器）
• 多个 VOLUME 指令效果等同于合并写法，无需拆分

例如正确初始化数据卷的惯用做法：

VOLUME /data
COPY init.sh /init.sh
RUN chmod +x /init.sh
ENTRYPOINT ["/init.sh"]

其中 init.sh 可检查 /data 是否为空，再复制默认配置进去。