有時因為網絡原因,比如公司 NAT,或其它啥的,需要使用代理。Docker
的代理配置,略顯復雜,因為有三種場景。但基本原理都是一致的,都是利用 Linux
的 http_proxy
等環境變量。
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=http://proxy.example.com:8080/"
Environment="HTTPS_PROXY=http://proxy.example.com:8080/"
Environment="NO_PROXY=localhost,127.0.0.1,.example.com"
其中,proxy.example.com:8080
要換成可用的免密代理。通常使用 cntlm
在本機自建免密代理,去對接公司的代理。可參考《Linux下安裝配置Cntlm 代理》。
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 模式