Dockerfile 仅能通过 VOLUME 指令声明挂载点，不能定义运行时动态存储映射；实际路径绑定须在容器启动时由用户通过 -v 或 --mount 指定，VOLUME 仅标记目录为可挂载且触发匿名卷自动创建。
Dockerfile 本身不能定义运行时的动态存储映射关系（如 -v 或 --mount），它只能声明镜像期望的挂载点（通过 VOLUME 指令），真正的路径映射必须在容器启动时由用户指定。理解这个分工是避免常见误区的关键。
明确 Dockerfile 的职责边界
VOLUME 指令的作用是预先声明一个或多个目录为“匿名卷”挂载点，告诉 Docker：“这里将来可能需要外部存储”。它不绑定宿主机路径，也不创建实际目录，只是在镜像层中标记该路径为可被挂载的持久化位置。
- 例如：
VOLUME ["/data", "/config"]表示镜像设计上支持将宿主机目录挂到这两个路径 - 构建后运行容器时，若未显式挂载，Docker 会自动创建匿名卷并挂载到这些路径
-
VOLUME不影响构建过程，也不会让镜像自带数据；它仅影响容器运行时行为
用 ENTRYPOINT 或 CMD 配合挂载点实现动态行为
真正实现“动态存储映射”的逻辑，往往靠启动脚本判断挂载状态并自适应初始化。比如检查 /data 是否为空，决定是否从模板复制默认配置。
OpenClaw Docker Setup
下载
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
- 在 Dockerfile 中把初始化脚本设为入口：
COPY entrypoint.sh /entrypoint.sh+ENTRYPOINT ["/entrypoint.sh"] - 脚本内可用
if [ ! -f /data/.initialized ]; then ... fi判断是否首次挂载 - 这样即使用户用
-v ./mydata:/data启动，也能自动适配已有数据，不覆盖也不重复初始化
推荐：用 docker-compose.yml 统一管理挂载配置
生产中应避免在 Dockerfile 里硬编码路径，而是把挂载逻辑外移到编排文件中，实现环境差异化和可复用性。
- 在
docker-compose.yml中写：volumes:<br> - ./local-config:/app/config<br> - data-volume:/app/data
- 这样开发用本地目录，测试用命名卷，生产连 NFS 或云存储，镜像本身完全不变
- 配合
environment和command可进一步控制初始化逻辑分支
避开常见陷阱
很多人误以为 VOLUME 能自动同步宿主机路径，或试图在 Dockerfile 里写 RUN mkdir -p /host/path —— 这些都无效甚至引发错误。
- 构建阶段无法访问宿主机文件系统，
RUN中的路径只是镜像内的临时路径 -
VOLUME后对同一路径的COPY或RUN mkdir会被忽略（Docker 会清空该路径内容） - 若需预置默认数据，应放在非
VOLUME路径（如/defaults/data），再由启动脚本按需复制
