使用Rancher Desktop无法连接Docker daemon服务器的原因排查

你遇到的情况是Rancher Desktop配置为dockerd(moby)容器引擎时，docker info提示无法连接到unix:///Users/user1/.rd/docker.sock，但该套接字文件确实存在。以下是具体排查和解决方法：

1. 确认Rancher Desktop的Docker服务状态 #

• 打开Rancher Desktop应用，查看右下角状态栏：
  • 如果图标显示灰色或状态为"Stopped"，点击"Start"启动Docker服务
  • 若服务已启动，尝试重启Rancher Desktop（退出后重新打开）

2. 验证套接字是否被Daemon实际绑定 #

套接字文件存在不代表Docker Daemon正在使用它，执行以下命令检查是否有进程占用该套接字：

lsof /Users/user1/.rd/docker.sock

• 如果返回空结果，说明Daemon未绑定到该套接字，需重启Rancher Desktop的Docker服务
• 如果有进程返回，确认进程是Rancher相关的dockerd进程

3. 检查Docker上下文配置 #

确认当前使用的rancher-desktop上下文配置正确：

1. 查看所有上下文：

docker context ls

2. 检查rancher-desktop上下文的端点配置：

docker context inspect rancher-desktop

3. 确认Endpoints.docker.Host的值为unix:///Users/user1/.rd/docker.sock，若不符，重新切换上下文：

docker context use rancher-desktop

4. 排查套接字文件权限与扩展属性 #

• 虽然文件归属显示为user1，但可能存在异常扩展属性，检查并清理：

# 查看扩展属性
xattr /Users/user1/.rd/docker.sock
# 清理所有扩展属性
xattr -c /Users/user1/.rd/docker.sock

• 确保当前用户属于staff组（macOS下默认Docker权限组），执行id -nG验证，若不在可通过sudo dscl . append /Groups/staff GroupMembership user1添加

5. 重置Rancher Desktop Docker配置 #

如果以上方法无效，尝试重置配置：

1. 打开Rancher Desktop，进入Settings -> Docker
2. 点击Reset to Defaults，确认重置后重启应用
3. 重启后再次执行docker info验证连接

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