驱动兼容性取决于卷驱动类型与宿主机环境支持能力是否匹配；docker原生仅支持local和none，nfs等需额外安装插件或内核模块，须通过docker volume ls -d和create测试，并检查工具、语法及平台限制。

直接看驱动兼容性，关键不在 Compose 版本本身，而在于 卷驱动类型 与 宿主机环境支持能力 是否匹配。配置写对了，但驱动没装、参数不识别、内核模块缺失，照样启动失败。

确认驱动是否被 Docker 环境识别

不是所有驱动默认可用。Docker 只原生支持 local 和 none；NFS、SSHFS、云盘驱动等需额外安装插件或内核支持。

• 运行 docker volume ls -d 查看当前已注册的驱动列表
• 执行 docker volume create -d nfs --name test-nfs 测试驱动能否实例化（会报错则说明未就绪）
• 检查宿主机是否已安装对应工具：比如 NFS 驱动依赖 nfs-common（Ubuntu/Debian）或 nfs-utils（CentOS/RHEL）

正确声明驱动与选项（语法必须匹配 Compose 文件版本）

从 v2.4 起支持 driver_opts，但不同驱动对字段名和值格式敏感。例如：

OpenClaw Docker Setup

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

下载

• type: nfs 必须小写，大写或带空格会解析失败
• o: "addr=192.168.1.100,rw,hard,intr" 中的逗号不能换行，引号需闭合
• device: ":/export/data" 的冒号开头是 NFS 协议要求，漏掉会导致挂载路径错误
• v3.x 文件中若混用 bind 类型与 local 驱动，需明确指定 type: none，否则部分引擎会拒绝加载

规避常见驱动兼容陷阱

这些情况在跨平台部署时高频出现：

• Mac 或 Windows 上 Docker Desktop 默认不支持 sshfs 或 gcePersistentDisk —— 这类驱动仅适用于 Linux 宿主机
• 使用 local 驱动 + type: bind 时，路径必须是绝对路径，且宿主机目录需提前存在（Compose 不自动创建）
• 云环境驱动（如 aws-ebs）依赖 CLI 工具和 IAM 权限，需在容器外完成认证配置，而非写在 driver_opts 里
• 某些旧版 Docker Engine（driver_opts 中含特殊字符的值解析异常，建议用单引号包裹整个字符串

验证驱动行为是否符合预期

光能启动不等于驱动生效。建议三步验证：

• 启动后进入容器：docker exec -it <service> sh</service>，运行 mount | grep <your-volume></your-volume> 确认挂载类型和参数
• 尝试写入文件并重启容器，检查数据是否保留（验证持久性）
• 在多节点 Swarm 或 Kubernetes 场景下，避免使用依赖单机路径的 local 驱动，应切换为网络驱动或云存储