数据卷排错核心是三步：确认挂载是否成功、定位存储路径、核查权限是否匹配。需区分命名卷与绑定挂载，检查Mounts字段验证类型，避免匿名卷导致数据丢失，命名卷须符合小写字母、数字、下划线、短横线规则，多服务共享时注意项目前缀与子路径隔离。
数据卷排错，核心就三件事：看它挂没挂上、查它存哪去了、确认权限对不对。别急着改配置文件，先定位问题再动手。
一、容器启动失败，报“找不到文件”或“Permission denied”
这类错误通常不是卷不存在，而是路径或权限出了问题。
- 检查挂载写法是否混淆了命名卷和绑定挂载：比如
- ./config:/app/config是绑定挂载，而- app_config:/app/config才是命名卷；前者依赖宿主机路径存在，后者由 Docker 自动创建目录 - 确认宿主机对应路径有读写权限（尤其 Linux）：绑定挂载时，若容器以非 root 用户运行，宿主机目录需对 uid/gid 可写，否则报 Permission denied
- 用
docker volume inspect <name>查命名卷真实路径，再进宿主机看看该目录是否存在、是否为空、属主是否合理
二、容器运行正常，但数据没持久化或重启后丢失
说明卷没真正生效，或者用了错误类型。
OpenClaw Docker Setup
下载
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
- 执行
docker inspect <container>，搜索Mounts字段，确认目标路径（Destination）确实关联了卷（Type: volume）或绑定路径（Type: bind） - 如果看到
"Type": "volume"但"Name"是一串随机哈希，说明用了匿名卷——容器删掉后数据就断联了，应改用显式命名卷 - 开发中误用绑定挂载替代命名卷（如
- ./db:/var/lib/mysql），可能因路径拼写错误、宿主机目录未初始化，导致 MySQL 拒绝启动
三、多个服务共享卷，出现数据错乱或冲突
常见于 Compose 多服务共用同一卷名，或忽略项目前缀。
- Docker Compose 默认给卷加项目名前缀（如目录叫
myapp，卷db_data实际叫myapp_db_data），跨项目复用时需显式设COMPOSE_PROJECT_NAME - 命名卷名只能含小写字母、数字、下划线和短横线，
DB-Data或MyVolume会创建失败，日志里常提示 “invalid volume name” - 不同服务挂同一命名卷时，确保它们访问的是卷内不同子路径，避免覆盖（如 A 写
/data/logs，B 写/data/config）
四、想改挂载路径，但容器已跑起来了
切记：不要直接改 hostconfig.json 或手动挪数据目录——Docker 不认这种操作，极易丢数据。
- 安全做法是停容器 → 备份原卷数据（
docker run --rm -v old_vol:/from -v $(pwd):/to alpine tar cf /to/backup.tar -C /from .）→ 更新 compose 文件 → 删旧卷 → 启新容器 - 若只是调整绑定挂载的宿主机路径，只需改
docker-compose.yml中volumes下的源路径，然后docker-compose down && docker-compose up -d - 用
docker volume ls和docker volume prune定期清理未被使用的卷，避免磁盘悄悄被占满
