Docker 网络代理
有时因为网络原因,比如公司NAT,或其它的需求,需要使用代理。Docker的代理配置,略显复杂,因为有三种场景。但基本原理都是一致的,都是利用Linux的http_proxy等环境变量。

dockerd代理

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

  1. sudo mkdir -p /etc/systemd/system/docker.service.d
  2. touch /etc/systemd/system/docker.service.d/proxy.conf

proxy.conf文件(可以是任意*.conf的形式)中,添加以下内容:

  1. [Service]
  2. Environment="HTTP_PROXY=http://proxy.example.com:8080/"
  3. Environment="HTTPS_PROXY=http://proxy.example.com:8080/"
  4. Environment="NO_PROXY=localhost,127.0.0.1,.example.com"

其中,proxy.example.com:8080要换成可用的免密代理。通常使用cntlm在本机自建免密代理,去对接公司的代理。可参考《Linux下安装配置Cntlm代理》。

Container代理

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

  1. {
  2. "proxies":
  3. {
  4. "default":
  5. {
  6. "httpProxy": "http://proxy.example.com:8080",
  7. "httpsProxy": "http://proxy.example.com:8080",
  8. "noProxy": "localhost,127.0.0.1,.example.com"
  9. }
  10. }
  11. }

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

docker build代理

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

  1. docker build . \
  2. --build-arg "HTTP_PROXY=http://proxy.example.com:8080/" \
  3. --build-arg "HTTPS_PROXY=http://proxy.example.com:8080/" \
  4. --build-arg "NO_PROXY=localhost,127.0.0.1,.example.com" \
  5. -t your/image:tag

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