Mac M1环境下Intellij IDEA集成Docker Desktop提示找不到Docker socket

问题根源 #

M1架构的Mac上，Docker Desktop默认不会生成IntelliJ IDEA默认查找的/var/run/docker.sock套接字文件，实际使用的套接字路径为~/.docker/run/docker.sock，这直接导致IDE无法检测到Docker环境，触发报错。

解决方案 #

方案1：创建软链接映射默认路径 #

在终端执行以下命令，将Docker实际的套接字文件链接到IntelliJ默认查找的路径：

sudo ln -s ~/.docker/run/docker.sock /var/run/docker.sock

执行完成后重启IntelliJ IDEA，再尝试添加Docker服务，IDE即可自动检测到Docker环境。

方案2：在IntelliJ中手动指定套接字路径 #

1. 打开IntelliJ IDEA，进入Settings（或Preferences）> Build, Execution, Deployment > Docker
2. 点击+添加Docker服务，选择Unix socket类型
3. 在API URL字段中填入Docker实际的套接字路径：

   unix:///Users/你的用户名/.docker/run/docker.sock
   

   （替换你的用户名为你Mac的实际用户名，也可直接使用unix://~/.docker/run/docker.sock）
4. 点击Apply保存配置，测试连接即可成功。

方案3：通过TCP连接Docker daemon #

如果前两种方法无效，可尝试开启Docker的TCP访问：

1. 打开Docker Desktop，进入Settings > General
2. 勾选Expose daemon on tcp://localhost:2375 without TLS
3. 在IntelliJ中添加Docker服务时，选择TCP socket类型，API URL填入tcp://localhost:2375
4. 保存配置后测试连接。

额外检查项 #

• 确保Docker Desktop处于运行状态
• 检查IntelliJ IDEA的Docker插件已更新到最新版本（进入Settings > Plugins搜索Docker，确认版本）
• 若权限不足，可执行以下命令赋予套接字读写权限：

  sudo chmod 666 /var/run/docker.sock
  

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