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"]</p>
注意：不能使用变量（如 $HOME）或构建参数（ARG），因为 VOLUME 在镜像构建阶段就固定了路径，运行时才决定挂载源。
OpenClaw Docker Setup
下载
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
实际使用方式（运行时挂载）
Dockerfile 中的 VOLUME 只是“预留接口”，真正生效需在 docker run 时显式挂载：
- 用
-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 是否为空，再复制默认配置进去。
