portainer 点击 connect 报错：Failure Cannot connect to the Docker daemon at unix:///var/run/docker.sock.

【注】使用的环境为 MacOS ，在 Local模式下出现的错误。Linux 和 MacOS 操作是一样的， Windows 的命令与 Linux 存在差异，根据实际情况更改即可。

1. 操作场景

MacOS 上虽然有 Docker Desktop 管理用起来挺方便的，但是如果想要更多直观的信息，就不如 web 端管理的方式舒服，但是在创建完成后，启动 portainer 的时候却出现报错信息：

Failure Cannot connect to the Docker daemon at unix:///var/run/docker.sock.
Is the docker daemon running?

创建 portainer 容器的命令如下：

docker run -d --name portainer -p 9000:9000 portainer/portainer

在 portainer 的模式选择界面，选择的是 Local，然后就报错了。

2. 问题根源

出现问题的原因就在于上面创建容器的命令，上面的命令默认的是使用 portainer 容器中的 /var/run/docker.sock ，而不是本地宿主机器部署的 Docker 。如果选择 Local 模式的话 portainer 无法在自己的容器中找到 /var/run/docker.sock（IPC,进程通讯文件），除非安装过。

并且其实 portainer 的页面上也有提示：

Ensure that you started the Portainer container with the following Docker flag.

确保使用以下 Docker 参数来启动 Portainer 容器。

3. 解决方案

通过 Docker 的文件映射： -v 将容器中的 /var/run/docker.sock 映射到 MacOS 宿主机器上的 /var/run/docker.sock（必须 Docker 启动时才有）。相关命令如下（Windows 请根据实际路径替换，没有改动过一般使用默认就可以）：

docker run -d --name portainer -p 9000:9000 -v /var/run/docker.sock:/var/run/docker.sock portainer/portainer

最后 Local 模式就可以正常使用了。

4. 拓展

Linux/Unix 系统上的 .sock 文件是一个进程通讯（IPC）文件，用于同一台主机的进程间通讯（IPC），通过这个文件可以控制 sock 文件对应的应用程序；portainer 就是通过 docker.sock 这个文件获取并控制 Docker 服务。

博客地址： Roc’s Blog