MacOS下构建/运行Docker容器时无法使用Orbstack Docker Daemon

临时解决（单次终端会话生效） #

直接在终端中设置环境变量，让Docker客户端指向Orbstack的daemon套接字：

export DOCKER_HOST=unix:///Users/[你的用户名]/.orbstack/run/docker.sock

设置后即可正常执行docker build、docker run等命令。

永久配置（所有终端会话生效） #

编辑用户目录下的.docker/config.json文件（不存在则新建），添加hosts配置项指定Orbstack的套接字路径：

{
  "hosts": ["unix:///Users/[你的用户名]/.orbstack/run/docker.sock"]
}

保存文件后，重启终端即可永久生效。

修复/var/run/docker.sock软链接 #

如果软链接存在但未被识别，先删除旧链接再重建：

sudo rm /var/run/docker.sock
sudo ln -s /Users/[你的用户名]/.orbstack/run/docker.sock /var/run/docker.sock

重建后检查链接状态：

ls -l /var/run/docker.sock

确保输出显示链接指向正确的Orbstack套接字路径。

检查Orbstack集成设置 #

打开Orbstack应用，进入「Settings」-「Docker」：

• 确认「Enable Docker integration」已开启
• 确认「Create /var/run/docker.sock symlink」已勾选
  若未开启，勾选后重启Orbstack服务。

验证配置 #

重启终端和Orbstack后，执行以下命令验证连接：

docker info

如果输出正常显示Orbstack相关的daemon信息，说明配置成功。

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