如何優(yōu)雅的給Docker配置網(wǎng)絡(luò)代理
有時(shí)因?yàn)榫W(wǎng)絡(luò)原因,比如公司 NAT,或其它啥的,需要使用代理。Docker 的代理配置,略顯復(fù)雜,因?yàn)橛腥N場(chǎng)景。但基本原理都是一致的,都是利用 Linux 的 http_proxy 等環(huán)境變量。
Dockerd 代理
在執(zhí)行docker pull時(shí),是由守護(hù)進(jìn)程dockerd來(lái)執(zhí)行。因此,代理需要配在dockerd的環(huán)境中。而這個(gè)環(huán)境,則是受systemd所管控,因此實(shí)際是systemd的配置。
- sudo mkdir -p /etc/systemd/system/docker.service.d
- sudo touch /etc/systemd/system/docker.service.d/proxy.conf
在這個(gè)proxy.conf文件(可以是任意*.conf的形式)中,添加以下內(nèi)容:
- [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 在本機(jī)自建免密代理,去對(duì)接公司的代理??蓞⒖肌禠inux下安裝配置Cntlm 代理》。
Container 代理
在容器運(yùn)行階段,如果需要代理上網(wǎng),則需要配置 ~/.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"
- }
- }
- }
這個(gè)是用戶級(jí)的配置,除了 proxies,docker login 等相關(guān)信息也會(huì)在其中。而且還可以配置信息展示的格式、插件參數(shù)等。
此外,容器的網(wǎng)絡(luò)代理,也可以直接在其運(yùn)行時(shí)通過(guò) -e 注入 http_proxy 等環(huán)境變量。這兩種方法分別適合不同場(chǎng)景。config.json 非常方便,默認(rèn)在所有配置修改后啟動(dòng)的容器生效,適合個(gè)人開(kāi)發(fā)環(huán)境。在CI/CD的自動(dòng)構(gòu)建環(huán)境、或者實(shí)際上線運(yùn)行的環(huán)境中,這種方法就不太合適,用 -e 注入這種顯式配置會(huì)更好,減輕對(duì)構(gòu)建、部署環(huán)境的依賴。當(dāng)然,在這些環(huán)境中,最好用良好的設(shè)計(jì)避免配置代理上網(wǎng)。
Docker Build 代理
雖然 docker build 的本質(zhì),也是啟動(dòng)一個(gè)容器,但是環(huán)境會(huì)略有不同,用戶級(jí)配置無(wú)效。在構(gòu)建時(shí),需要注入 http_proxy 等參數(shù)。
- 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
注意:無(wú)論是 docker run 還是 docker build,默認(rèn)是網(wǎng)絡(luò)隔絕的。如果代理使用的是 localhost:3128 這類,則會(huì)無(wú)效。這類僅限本地的代理,必須加上 --network host 才能正常使用。而一般則需要配置代理的外部IP,而且代理本身要開(kāi)啟 Gateway 模式。
重啟生效
代理配置完成后,reboot 重啟當(dāng)然可以生效,但不重啟也行。
docker build 代理是在執(zhí)行前設(shè)置的,所以修改后,下次執(zhí)行立即生效。Container 代理的修改也是立即生效的,但是只針對(duì)以后啟動(dòng)的 Container,對(duì)已經(jīng)啟動(dòng)的 Container 無(wú)效。
dockerd 代理的修改比較特殊,它實(shí)際上是改 systemd 的配置,因此需要重載 systemd 并重啟 dockerd 才能生效。
- sudo systemctl daemon-reload
- sudo systemctl restart docker