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本地开发环境
- 终端执行
id -u和id -g获取当前本地用户的UID和GID,一般默认返回值为1000:1000 - 在
wordpress和wpcli服务下都添加user参数,值为你查询到的UID:GID - 重启容器后权限即可对齐,本地和容器内都可正常读写文件
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
相关产品推荐
相关产品推荐

