在Windows本地安装Appwrite时遇文件写入错误求助

问题根源 #

你遇到的错误是因为在Windows原生环境执行UNIX安装脚本时，脚本试图写入Linux风格的路径/usr/src/code/appwrite/，但Windows不存在该路径结构，且Hyper终端未正确关联WSL2环境，导致文件写入失败。

修复步骤 #

• 先配置WSL2环境

  1. 以管理员身份打开PowerShell，执行命令启用WSL：

     wsl --install
     

  2. 设置默认WSL版本为2：

     wsl --set-default-version 2
     

  3. 从Microsoft Store安装Ubuntu（或其他Linux发行版），完成初始化（设置用户名和密码）。

• 在WSL2内运行安装脚本

  1. 打开Hyper终端，输入wsl进入WSL2环境。
  2. 在WSL文件系统内创建安装目录（避免使用Windows路径）：

     mkdir ~/appwrite && cd ~/appwrite
     

  3. 执行Appwrite官方安装命令：

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

• 权限排查（若问题仍存在）
  若还是报错，检查WSL内目录权限：

  sudo chmod -R 755 ~/appwrite
  

  确保当前用户拥有读写权限。

注意事项 #

不要在Windows原生路径（如C:\Users\你的用户名）下执行安装，WSL访问Windows文件系统存在权限和性能问题，优先使用WSL自身的文件系统。

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