macOS(Intel芯片)容器内Docker socket属主修改报错如何解决

问题说明 #

全新安装Docker Desktop后，使用docker.io/library/wordpress:latest镜像搭建本地开发环境时触发权限类报错。现有Docker官方文档仅覆盖Ubuntu场景下的套接字权限问题说明，公开社区相关回答要么针对Ubuntu系统，要么适配的Docker版本过旧无参考价值。
报错触发全流程：

• 步骤1：创建Docker开发环境
• 步骤2：选择官方WordPress镜像作为基础镜像
• 步骤3：镜像构建阶段抛出权限相关错误，构建中断

报错输出 #

chown: invalid group: 'root:docker'
WARNING: Could not change owner for docker socket in container : exit code 1
Docker socket permission set to allow in container docker

环境信息 #

• 操作系统：macOS BigSur 11.6.5（Intel芯片）
• Docker Desktop：4.8.2
• VSCode：1.67.1
• Git：2.36.1

问题根因 #

macOS版Docker Desktop的默认容器运行环境中不存在docker用户组，镜像内置的启动脚本执行chown root:docker /var/run/docker.sock命令时无法找到对应用户组，触发报错。

解决步骤 #

快速临时方案（适用于直接docker run启动场景） #

启动容器时指定运行用户为root，跳过套接字属主修改逻辑即可正常启动：

docker run -d --name wordpress-local -p 8080:80 -u root docker.io/library/wordpress:latest

该方案仅适用于本地开发测试，禁止用于生产环境部署

永久适配方案（适用于VSCode Dev Container开发流程） #

1. 打开Docker Desktop设置页，进入「Features in Development」分类，勾选「Use the new Virtualization framework」，Intel芯片机型可额外勾选「Enable VirtioFS accelerated directory sharing」提升文件挂载性能，点击「Apply & Restart」等待Docker重启完成
2. 如果你通过VSCode Dev Container创建开发环境，在项目根目录新建/修改.devcontainer/devcontainer.json配置文件，添加容器初始化命令提前创建docker用户组，配置示例如下：

{
  "name": "WordPress Dev Environment",
  "image": "docker.io/library/wordpress:latest",
  "postCreateCommand": "groupadd -f docker && usermod -aG docker www-data",
  "forwardPorts": [80]
}

3. 重新执行「Reopen in Container」操作，镜像构建过程不会再触发组不存在的报错，容器内服务可正常访问Docker套接字，WordPress服务启动后可通过本地映射端口正常访问。

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