如何配置 Docker 使用代理服务器

因为网络的原因，我们拉取不到 docker 官方的容器，还有 gcr.io 的容器，github上的容器，因此需要通过代理来拉取容器镜像。使用 Docker 的时候，有3种情况需要使用代理服务器，配置的方法不一样。

1.Docker pull 的时候，使用的 Docker 服务的环境变量来设置 dockerd 进程的代理。

2.而在 Docker 内部容器运行时，需要设置宿主机的 docker 的 config.json 文件来设置代理。

3.另外在 docker build 镜像的时候，需要设置 docker build 的代理。

我的代理服务器用的 vmess，方便 pull 到 docker 官方的容器镜像。

我的工作机是一台 Debian Linux，如果你的机器是其他 Linux 系统或者 Mac，Windows，第一种情况设置 dockerd 代理的方法（文件路径，命令）可能会略有不同，取决于操作系统的特性。

一、设置dockerd代理

在执行docker pull时，是由守护进程dockerd来执行。因此，代理需要配在dockerd的环境中。而这个环境，则是受systemd所管控，因此实际是systemd的配置。

sudo mkdir -p /etc/systemd/system/docker.service.d

sudo touch /etc/systemd/system/docker.service.d/proxy.conf

在这个proxy.conf文件（可以是任意*.conf的形式）中，添加以下内容：

[Service]

Environment=“HTTP_PROXY=192.168.1.10:7890"

Environment="HTTPS_PROXY=192.168.1.10:7890"

Environment="NO_PROXY=localhost,127.0.0.1,.example.com"

其中，proxy.example.com:8080要换成可用的免密代理。

重启生效

代理配置完成后，dockerd代理的修改比较特殊，它实际上是改systemd的配置，因此需要重载systemd并重启dockerd才能生效。使得代理生效：

sudo systemctl daemon-reload

sudo systemctl restart docker

检查代理配置：

systemctl show --property=Environment docker

二、Container代理

在容器运行阶段，如果需要代理上网，则需要配置~/.docker/config.json。以下配置，只在Docker 17.07及以上版本生效。

{"proxies":{"default":{"httpProxy": "http://proxy.example.com:8080","httpsProxy": "http://proxy.example.com:8080","noProxy": "localhost,127.0.0.1,.example.com"}}}

这个是用户级的配置，除了proxies，docker login等相关信息也会在其中。而且还可以配置信息展示的格式、插件参数等。

此外，容器的网络代理，也可以直接在其运行时通过-e注入http_proxy等环境变量。这两种方法分别适合不同场景。 config.json非常方便，默认在所有配置修改后启动的容器生效，适合个人开发环境。在CI/CD的自动构建环境、或者实际上线运行的环境中，这种方法就不太合适，用-e注入这种显式配置会更好，减轻对构建、部署环境的依赖。当然，在这些环境中，最好用良好的设计避免配置代理上网。

三、docker build代理

虽然docker build的本质，也是启动一个容器，但是环境会略有不同，用户级配置无效。在构建时，需要注入http_proxy等参数。

docker build . \

--build-arg "HTTP_PROXY=http://proxy.example.com:8080/" \

--build-arg "HTTPS_PROXY=http://proxy.example.com:8080/" \

--build-arg "NO_PROXY=localhost,127.0.0.1,.example.com" \

-t your/image:tag

注意：无论是docker run还是docker build，默认是网络隔绝的。如果代理使用的是localhost:3128这类，则会无效。这类仅限本地的代理，必须加上--network host才能正常使用。而一般则需要配置代理的外部IP，而且代理本身要开启gateway模式。