Windows 10安装Appwrite遇Docker卷规格无效错误求助

问题原因 #

你碰到的错误是因为Appwrite官方文档的默认命令是给Linux/macOS环境写的，Windows系统里Docker用的是命名管道，不是类Unix系统的/var/run/docker.sock路径，直接用这个路径会导致Docker识别不了卷规格。

解决方案 #

1. 修改安装命令里的卷挂载部分 #

把原命令中的/var/run/docker.sock:/var/run/docker.sock换成Windows专用的挂载格式：

• 用CMD执行的话，替换为：//./pipe/docker_engine://./pipe/docker_engine
• 用PowerShell执行的话，替换为：/./pipe/docker_engine:/./pipe/docker_engine

举个实际修改例子：
原官方启动命令大概是这样：

docker run -it --rm \
    --volume /var/run/docker.sock:/var/run/docker.sock \
    --volume "$(pwd)/appwrite:/usr/src/code/appwrite" \
    --entrypoint="install" \
    appwrite/appwrite:latest

修改后的CMD版本命令：

docker run -it --rm ^
    --volume //./pipe/docker_engine://./pipe/docker_engine ^
    --volume "%cd%/appwrite:/usr/src/code/appwrite" ^
    --entrypoint="install" ^
    appwrite/appwrite:latest

修改后的PowerShell版本命令：

docker run -it --rm `
    --volume /./pipe/docker_engine:/./pipe/docker_engine `
    --volume "$(Get-Location)/appwrite:/usr/src/code/appwrite" `
    --entrypoint="install" `
    appwrite/appwrite:latest

2. 开启Docker Desktop的WSL 2集成 #

打开Docker Desktop设置，进入Resources > WSL Integration，确保你在用的WSL发行版（比如Ubuntu）已经启用，之后重启Docker Desktop。

3. 验证Docker环境正常 #

执行以下命令确认Docker能正常工作：

docker info

如果返回正常的Docker系统信息，说明环境没问题，再执行修改后的Appwrite安装命令就行。

内容的提问来源于stack exchange，提问作者Legend Crafter