守护进程响应错误:创建卷:此平台不支持卷驱动 "local"
Error response from daemon: create volume: volume driver "local" is not supported on this platform
ID: docker/volume-driver-not-supported
版本兼容性
| 版本 | 状态 | 引入 | 弃用 | 备注 |
|---|---|---|---|---|
| Docker Desktop 4.27.0 | active | — | — | — |
| Docker Engine 24.0.5 | active | — | — | — |
| Docker CE 25.0.1 | active | — | — | — |
根因分析
Docker 安装缺少或配置了错误的 'local' 驱动卷插件,通常由于在非标准 Linux 发行版或具有 WSL2 问题的 Windows 上安装不完整。
English
The Docker installation is missing or has a misconfigured volume plugin for the 'local' driver, often due to incomplete installation on non-standard Linux distributions or Windows with WSL2 issues.
官方文档
https://docs.docker.com/engine/extend/plugins/解决方案
-
检查 docker-volume-local 插件是否已安装并启用:'docker plugin ls'。如果缺失,使用 'docker plugin install --grant-all-permissions vieux/sshfs' 安装,或重新安装包含 local 驱动插件的 Docker 包。
-
在 Windows 上使用 WSL2 时,确保 Docker Desktop WSL2 后端配置正确:前往设置 > 资源 > WSL 集成,为你的 WSL 发行版启用集成,然后重启 Docker Desktop。
-
如果使用自定义 Docker 根目录,请验证卷插件路径在 /etc/docker/daemon.json 中是否正确设置,例如 {"volume-plugin": "/usr/lib/docker/plugins"}。
无效尝试
常见但无效的做法:
-
50% 失败
The issue is often a missing plugin configuration, not the Docker engine itself; reinstalling may not fix the plugin path or driver registration.
-
90% 失败
The error is about the volume driver not being supported, not about directory existence; Docker will still fail to create the volume via the driver.
-
40% 失败
Other drivers may also be unsupported if the plugin infrastructure is broken; this is a workaround that may not resolve the root cause.