You need to enable JavaScript to run this app. docker-compose搭建WordPress环境使用WP-CLI的权限及启动错误问题咨询
优惠活动
大模型
产品
解决方案
定价
更多

docker-compose搭建WordPress环境使用WP-CLI的权限及启动错误问题咨询

问题原因分析

1. 原wpcli启动失败问题

错误原因是你自定义了错误的entrypoint: wordpress参数,wordpress:cli镜像的默认可执行文件是wp而非wordpress,删除自定义的entrypoint和command参数即可解决,你后续修改的配置逻辑是正确的。

2. 文件夹只读权限问题

该问题和卷的rw参数无关,rw仅控制容器对挂载卷的读写开关,本质原因是容器内运行进程的用户UID和宿主机本地用户UID不匹配导致的权限冲突:

  • WordPress官方镜像内运行Web服务的用户是www-data,默认UID为33
  • 你本地宿主机的用户UID不是33,所以挂载到本地的文件要么容器内无写入权限,要么本地用户无修改权限

修复方案

适配不同开发环境的权限修复方法

Linux本地开发环境

  1. 终端执行id -u和id -g获取当前本地用户的UID和GID,一般默认返回值为1000:1000
  2. 在wordpress和wpcli服务下都添加user参数,值为你查询到的UID:GID
  3. 重启容器后权限即可对齐,本地和容器内都可正常读写文件

macOS Docker Desktop环境

打开Docker Desktop设置,进入Resources > File Sharing,确认你挂载的WordPress根目录已经被添加到共享列表,重启Docker后重新启动服务即可。

Windows Docker Desktop环境

  • 若使用WSL2后端:和Linux操作一致,获取WSL内当前用户的UID/GID配置user参数即可
  • 若使用Hyper-V后端:在Docker Desktop设置的File Sharing中开启对应目录的共享权限即可

完整可用的docker-compose配置示例

version: '2'

services:
  mysql:
    image: mysql:5.7
    restart: always
    ports:
      - 32787:3306
    environment:
      MYSQL_USER: wordpress
      MYSQL_ROOT_PASSWORD: wordpress
      MYSQL_DATABASE: wordpress
      MYSQL_PASSWORD: wordpress
    volumes:
      - mysql_data:/var/lib/mysql # 命名卷存储数据库数据,重启不会丢失

  wordpress:
    depends_on:
      - mysql
    image: wordpress
    ports:
      - 32788:80
    restart: always
    user: "1000:1000" # 替换为你本地id -u和id -g返回的实际数值
    volumes:
      - ../../../:/var/www/html
      - ./:/var/www/html/wp-content/themes/lorraine # 单独挂载主题目录,开发更便捷
    environment:
      WORDPRESS_DB_HOST: mysql:3306
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: wordpress

  wpcli:
    image: wordpress:cli
    user: "1000:1000" # 和wordpress服务的user参数保持一致
    volumes:
      - ../../../:/var/www/html
    depends_on:
      - mysql
      - wordpress
    environment:
      WORDPRESS_DB_HOST: mysql:3306
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: wordpress

volumes:
  mysql_data:

wpcli使用示例

执行以下命令即可调用wpcli执行操作,生成的文件权限会自动对齐本地用户:

docker-compose run --rm wpcli plugin install woocommerce --activate

内容的提问来源于stack exchange,提问作者Lorraine

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.20 17:57:03