使用Laravel Sail全新安装项目后，如何解决权限冲突问题？

核心原因 #

容器默认以root用户运行，导致挂载的本地文件在容器内归属root；而容器内sail用户的UID/GID与本地tonysong用户不匹配，直接修改容器内文件权限会导致本地用户失去操作权限。

解决方案 #

方法1：通过.env文件指定用户ID映射 #

Laravel Sail支持通过环境变量同步本地用户的UID和GID：

1. 在本地终端执行以下命令，获取tonysong的UID和GID：

   id -u  # 输出UID，比如1000
   id -g  # 输出GID，比如1000
   

2. 打开项目根目录的.env文件，添加以下配置：

   WWWUSER=你的UID
   WWWGROUP=你的GID
   

3. 重新构建并启动容器：

   sail build --no-cache && sail up -d
   

方法2：修改docker-compose.yml配置用户 #

如果.env配置不生效，可直接在docker-compose.yml中指定用户：

1. 打开项目根目录的docker-compose.yml，找到laravel.test服务，添加user配置：

   services:
       laravel.test:
           build:
               context: ./vendor/laravel/sail/runtimes/8.1
               dockerfile: Dockerfile
               args:
                   WWWGROUP: '${WWWGROUP}'
           # 添加此行，替换为你的UID和GID
           user: "1000:1000"
           # 其他原有配置...
   

2. 重启容器：

   sail down && sail up -d
   

方法3：修复本地文件权限（若之前执行过chown -R sail .） #

如果之前在容器内修改权限导致本地无法操作，先在本地终端执行：

sudo chown -R tonysong:tonysong .

完成后再执行上面的方法1或2配置容器权限映射。

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