MacOS 等机器配置 Docker 启用 Remote API

Docker 不仅可以通过本地命令行docker命令进行调用，还可以通过开启远程控制 API，使用 HTTP 调用接口来进行访问，远程控制 Docker Daemon 来做很多操作。

安装 Docker

如果没有 Docker 可以先进行安装：

# 国外主机
curl -sSL https://get.docker.com | sh

# 国内主机
curl -sSL https://get.daocloud.io/docker | sh

启用 API

Docker 的远程 API 服务默认监听的是 TCP 2375 端口，为了保证安全，Docker 安装后默认不会启用远程 API 服务，因为这个服务默认不做权限认证。

如果你的防火墙或者安全组允许了 2375 端口访问，同时也开启了 Docker 默认的远程 API 服务，那么大几率你的服务器会被拿来挖矿…

所以推荐在内网环境中使用，安全上会有保证，如果是外网生产环境建议做好iptables安全加固或用完即焚或使用 TLS 安全认证等等。

下面分别说明 CentOS 以及 MacOS 如何开启远程 API 服务：

CentOS

CentOS 的开启方法比较简单，先修改配置：

vim /usr/lib/systemd/system/docker.service

修改ExecStart配置项，默认如下：

ExecStart=/usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

增加一个-H tcp://0.0.0.0:2375选项

ExecStart=/usr/bin/dockerd -H fd:// -H tcp://0.0.0.0:2375 --containerd=/run/containerd/containerd.sock

如果是内网生产环境，也可以将0.0.0.0改为内网 IP。同样的，2375 端口也可以修改。

但是这样可能还有一个问题，无法在命令行使用docker命令了，还需要添加sock选项：-H unix:///var/run/docker.sock，最后为：

ExecStart=/usr/bin/dockerd -H fd:// -H unix:///var/run/docker.sock -H tcp://10.105.3.115:2375 --containerd=/run/containerd/containerd.sock

修改完配置之后需要重启 Docker 服务：

systemctl daemon-reload
systemctl restart docker

重启完成后，可以使用netstat查看端口是否监听来确认是否成功：

[root@VM-3-115-centos ~]# netstat -nutlp | grep 2375
tcp        0      0 10.105.3.115:2375       0.0.0.0:*               LISTEN      32316/dockerd

MacOS

在 Mac 下无法直接修改配置文件来开启远程 API 服务，后来在 docker/for-mac 的 issue 中得到了解决方案。

可以运行一个 socat 容器，将 unix socket 上的 Docker API 转发到 MacOS 上指定的端口中：

docker run -d -v /var/run/docker.sock:/var/run/docker.sock -p 127.0.0.1:2375:2375 bobrik/socat TCP-LISTEN:2375,fork UNIX-CONNECT:/var/run/docker.sock

测试

启用成功后，可以进行一些测试，例如直接使用浏览器访问info和version等页面获取信息。

http://127.0.0.1:2375/info

http://127.0.0.1:2375/version

这里以version为例，访问后可以得到如下内容则表示启用成功：

{
    "Platform": {
        "Name": "Docker Engine - Community"
    },
    "Components": [
        {
            "Name": "Engine",
            "Version": "20.10.7",
            "Details": {
                "ApiVersion": "1.41",
                "Arch": "amd64",
                "BuildTime": "2021-06-02T11:54:58.000000000+00:00",
                "Experimental": "false",
                "GitCommit": "b0f5bc3",
                "GoVersion": "go1.13.15",
                "KernelVersion": "5.10.25-linuxkit",
                "MinAPIVersion": "1.12",
                "Os": "linux"
            }
        },
        {
            "Name": "containerd",
            "Version": "1.4.6",
            "Details": {
                "GitCommit": "d71fcd7d8303cbf684402823e425e9dd2e99285d"
            }
        },
        {
            "Name": "runc",
            "Version": "1.0.0-rc95",
            "Details": {
                "GitCommit": "b9ee9c6314599f1b4a7f497e1f1f856fe433d3b7"
            }
        },
        {
            "Name": "docker-init",
            "Version": "0.19.0",
            "Details": {
                "GitCommit": "de40ad0"
            }
        }
    ],
    "Version": "20.10.7",
    "ApiVersion": "1.41",
    "MinAPIVersion": "1.12",
    "GitCommit": "b0f5bc3",
    "GoVersion": "go1.13.15",
    "Os": "linux",
    "Arch": "amd64",
    "KernelVersion": "5.10.25-linuxkit",
    "BuildTime": "2021-06-02T11:54:58.000000000+00:00"
}