【注】使用的环境为 MacOS ,在 Local 模式下出现的错误。Linux 和 MacOS 操作是一样的, Windows 的命令与 Linux 存在差异,根据实际情况更改即可。
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
,然后就报错了。
【原因】出现问题的原因就在于上面创建容器的命令,上面的命令默认的是使用 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 容器。
【解决方案】 通过 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
模式的正常使用了。
【拓展】
Linux/Unix
系统上的 .sock
文件是一个进程通讯(IPC
)文件,用于同一台主机的进程间通讯(IPC
),通过这个文件可以控制 sock
文件对应的应用程序;portainer
就是通过 docker.sock
这个文件获取并控制 Docker
服务。