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.