docker config_error ai_generated partial

守护进程响应错误:创建卷:此平台不支持卷驱动 "local"

Error response from daemon: create volume: volume driver "local" is not supported on this platform

ID: docker/volume-driver-not-supported

其他格式: JSON · Markdown 中文 · English
78%修复率
83%置信度
1证据数
2024-09-22首次发现

版本兼容性

版本状态引入弃用备注
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.

generic

官方文档

https://docs.docker.com/engine/extend/plugins/

解决方案

  1. 检查 docker-volume-local 插件是否已安装并启用:'docker plugin ls'。如果缺失,使用 'docker plugin install --grant-all-permissions vieux/sshfs' 安装,或重新安装包含 local 驱动插件的 Docker 包。
  2. 在 Windows 上使用 WSL2 时,确保 Docker Desktop WSL2 后端配置正确:前往设置 > 资源 > WSL 集成,为你的 WSL 发行版启用集成,然后重启 Docker Desktop。
  3. 如果使用自定义 Docker 根目录,请验证卷插件路径在 /etc/docker/daemon.json 中是否正确设置,例如 {"volume-plugin": "/usr/lib/docker/plugins"}。

无效尝试

常见但无效的做法:

  1. 50% 失败

    The issue is often a missing plugin configuration, not the Docker engine itself; reinstalling may not fix the plugin path or driver registration.

  2. 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.

  3. 40% 失败

    Other drivers may also be unsupported if the plugin infrastructure is broken; this is a workaround that may not resolve the root cause.