Windows11+WSL2(Ubuntu)+Docker Desktop+WordPress本地环境权限与性能问题

核心问题根源 #

WSL2本地用户（如andy）与Docker容器内www-data用户的UID/GID不匹配，导致双方无法同时拥有目录读写权限，进而引发WordPress、VS Code、FileZilla的操作权限冲突。

分步解决方案 #

1. 获取本地用户的UID/GID #

在WSL2的Ubuntu终端执行以下命令，记录输出的UID和GID：

id -u andy  # 输出本地用户的UID，例如1000
id -g andy  # 输出本地用户的GID，例如1000

2. 修改docker-compose.yml配置 #

在wordpress服务中添加自定义命令，将容器内www-data的UID/GID修改为与本地用户一致，同时确保目录权限正确：

version: '3.8'
services:
  db:
    image: mysql:5.7
    volumes:
      - db_data:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: somewordpress
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: wordpress
  wordpress:
    depends_on:
      - db
    image: wordpress:latest
    ports:
      - "80:80"
    volumes:
      - ./:/var/www/html  # 替换为你的实际项目目录映射路径
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: wordpress
    # 关键：调整www-data的UID/GID并重置目录权限
    command: >
      sh -c "usermod -u 1000 www-data && groupmod -g 1000 www-data && 
             chown -R www-data:www-data /var/www/html && 
             apache2-foreground"
volumes:
  db_data:

注意：将命令中的1000替换为你第一步获取的实际UID和GID。

3. 重置本地项目目录权限 #

在WSL2终端执行以下命令，确保本地用户拥有项目目录的所有权，并设置安全的权限：

# 递归设置目录所有权为本地用户
sudo chown -R andy:andy /home/andy/your-project-dir
# 设置目录权限为755，文件权限为644
find /home/andy/your-project-dir -type d -exec chmod 755 {} \;
find /home/andy/your-project-dir -type f -exec chmod 644 {} \;

替换/home/andy/your-project-dir为你的实际项目路径。

4. 验证与测试 #

1. 重新启动容器：

   docker-compose down && docker-compose up -d
   

2. 验证容器内www-data的UID/GID是否匹配：

   docker exec -it [你的WordPress容器名称] id www-data
   

3. 测试各项功能：
   • WordPress后台：尝试安装插件、上传媒体文件
   • VS Code：修改wp-content内的文件或创建目录
   • FileZilla：在wp-content/uploads内创建文件夹、上传文件

额外注意事项 #

• 避免使用777权限：不仅不安全，Docker还可能自动重置目录权限
• 不要以root用户运行容器：会导致性能下降和权限混乱
• 确保Docker Desktop已开启WSL2集成：在Docker设置中勾选对应的Ubuntu发行版

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