Docker部署WordPress数据卷权限异常，求更优解决方法

问题描述 #

部署Docker版WordPress后，数据卷内文件无法通过VSCode编辑，保存时提示：

Failed to save 'hello.php': Insufficient permissions. Select 'Retry as Sudo' to retry as superuser.

数据卷权限信息：

total 20
drwxr-xr-x 4 www-data www-data 4096 Aug 24 19:33 .
drwxrwxr-x 7 marty marty 4096 Aug 24 18:09 ..
-rw-r--r-- 1 www-data www-data 28 Jan 8 2012 index.php
drwxr-xr-x 3 www-data www-data 4096 Aug 8 21:32 plugins
drwxr-xr-x 5 www-data www-data 4096 Aug 8 21:32 themes

现有思路分析 #

思路1：递归修改数据卷所属用户/组为marty #

可行但存在风险：WordPress容器内的www-data用户（UID/GID通常与宿主机不同）会失去文件读写权限，导致WordPress无法正常运行（比如无法上传插件、修改主题）。除非同步调整容器内www-data的UID/GID与宿主机marty一致，否则不建议直接操作。

思路2：将marty加入www-data组 #

这里的www-data是宿主机的用户组（你是在宿主机查看的权限），只要容器内www-data的GID与宿主机www-data组ID匹配，就能保证容器正常读写。操作步骤：

• 查看宿主机www-data组的GID：

  getent group www-data
  

  输出类似www-data:x:33:，其中33为GID。
• 将marty加入宿主机www-data组：

  sudo usermod -aG www-data marty
  

• 重启VSCode或重新登录终端，让组权限生效。
• 递归修改数据卷文件夹的组权限为可读写：

  sudo chmod -R g+w /path/to/your/wordpress-volume
  

  这样www-data组内的marty可编辑文件，容器内www-data用户也能正常读写。

更优解决方案：同步容器与宿主机的UID/GID #

这是Docker数据卷权限问题的标准根治方案，彻底避免后续权限冲突：

1. 查看容器内www-data用户的UID和GID：

   docker exec -it your-wordpress-container-id id www-data
   

   输出类似uid=33(www-data) gid=33(www-data) groups=33(www-data)。
2. 调整容器用户匹配宿主机marty的UID/GID：
   • 方式一：修改docker-compose.yml，添加用户参数：

     services:
       wordpress:
         image: wordpress:latest
         user: "1000:1000" # 替换成宿主机marty的UID:GID，用`id marty`查看
         volumes:
           - ./wordpress-data:/var/www/html
     

   • 方式二：创建自定义Docker镜像，修改容器内www-data的UID/GID：

     FROM wordpress:latest
     RUN usermod -u 1000 www-data && groupmod -g 1000 www-data
     

3. 重启容器后，数据卷文件权限会自动适配，marty和容器内www-data均可正常读写，无需手动调整权限。

总结 #

• 思路2是快速解决当前问题的方法，需确保容器内www-data的GID与宿主机一致。
• 同步UID/GID的方案是长期最优解，彻底消除权限冲突隐患。

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