Docker 配置网络代理的几种场景

docker  

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

一、 Dockerd 代理

  • 在执行docker pull时,是由守护进程dockerd来执行。因此,代理需要配在dockerd的环境中。而这个环境,则是受systemd所管控,因此实际是systemd的配置
mkdir -p /etc/systemd/system/docker.service.d  
touch /etc/systemd/system/docker.service.d/proxy.conf  
  • 在这个proxy.conf文件(可以是任意*.conf的形式)中,添加以下内容
[Service]
Environment="HTTP_PROXY=http://proxy.example.com:8080/"  
Environment="HTTPS_PROXY=http://proxy.example.com:8080/"  
Environment="NO_PROXY=localhost,127.0.0.1,.example.com"  
systemctl daemon-reload  
systemctl restart docker  
  • 如何查询是否生效
# 配置好proxy.conf即可以查询到环境变量
systemctl show --property=Environment docker  
# 重启docker后查看
docker info | grep Proxy  

二、Container 代理

  • 方法一: 在容器运行阶段,如果需要代理上网,则需要配置 ~/.docker/config.json。
{
 "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 等相关信息也会在其中。而且还可以配置信息展示的格式、插件参数等。config.json 非常方便,默认在所有配置修改后启动的容器生效,适合个人开发环境。

  • 方法二:容器启动加上 -e http_proxy=http://proxy.example.com:8080 -e https_proxy=http://proxy.example.com:8080
docker run -it --rm -e http_proxy=http://proxy.example.com:8080 -e https_proxy=http://proxy.example.com:8080 arunvelsriram/utils  

在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 模式。

四、docker-compose代理

  • 在配置文件docker-compose.yml,
version: '3'  
services:  
  your-service:
    image: your-image
    environment:
      - http_proxy=http://proxy.example.com:8080
      - https_proxy=https://proxy.example.com:8080