MacOS下运行Selenoid失败求助：Docker访问权限异常

环境配置 #

• Selenoid Configuration Manager 1.8.5
• Docker Desktop 4.26.1（内置Docker Engine 24.0.7）

问题现象 #

执行命令：

$ ./cm selenoid start --vnc

出现报错：

Failed to initialize: [can not access Docker: make sure you have Docker installed and current user has access permissions]

但执行docker ps命令可正常返回空列表（无运行容器），说明Docker本身运行状态正常。

排查与解决步骤 #

1. 手动指定Docker端点 #

Selenoid CM可能无法自动识别Docker Desktop的socket路径（尤其是Windows或macOS环境），尝试手动指定端点执行命令：

• Windows环境：

  ./cm selenoid start --vnc --docker-endpoint "npipe:////./pipe/docker_engine"
  

• macOS环境：

  ./cm selenoid start --vnc --docker-endpoint "unix:///var/run/docker.sock"
  

2. 确认运行上下文权限一致性 #

虽然docker ps正常，但CM可能在不同的shell环境或权限上下文运行：

• Linux环境下先执行newgrp docker刷新用户组权限，再重新运行CM命令；
• 确保CM和docker ps在同一个终端会话中执行，避免环境变量不一致。

3. 检查版本兼容性 #

CM 1.8.5与Docker Engine 24.0.7可能存在兼容性问题：

• 尝试将CM升级到最新稳定版，或者将Docker Engine降级到23.x系列稳定版本后重新测试。

4. 重启Docker Desktop #

Docker Desktop可能存在后台初始化不完整的情况，完全关闭并重启Docker Desktop，等待状态栏显示"Running"后，再执行CM启动命令。

5. 排查安全软件拦截 #

防火墙、杀毒软件等安全工具可能拦截CM访问Docker socket：

• 暂时关闭安全软件，重新执行CM命令；若问题解决，需将CM添加到安全软件的信任列表中。

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