解決使用 Proxy 導致 Docker 無法拉取 Image 的問題

程式技術

•

2024-01-22

•

更新於 2025-10-24

•

3 分鐘

•

Docker

某天在公司內部申請一個 VM (Virtual machine) 來做 PoC (Proof of concept)。一開始拿到 VM 發現無法上網，原來我們公司對內部網路的控管較為嚴謹，內部的 VM 會要求使用 proxy 來對外連線。

使用 proxy 還有一個好處是可以減少公共 IP 的使用，因為有時候無法給所有 VM 一個可以連上網的 IP，因此統一透過 proxy 對外連線是一種很常見的操作。

我們可以在 .bashrc 或是 /etc/environment 中設定環境變數來修改 proxy，例如：

修改 .bashrc 只會在單一用戶底下生效，/etc/environment 為全域生效。

export HTTP_PROXY=http://proxy.example.com:8888
export HTTPS_PROXY=https://proxy.example.com:8889

Proxy 設定生效後，發現雖然可以正常上網，但 Docker 的拉取 image 操作還是會失敗，詢問一下前輩公司內部是否有阻擋 Docker？(我個人感覺也不太可能) 前輩說到可能是 proxy 的問題，因為 Docker 的 daemon 並不會去讀取系統的環境變數。

前輩點了一下後，我大概知道問題出在哪邊，Docker 官方文件中有兩種修改 daemon 內 proxy 的方式。

設定 Daemon 啟動後的環境變數

我們需要在 /etc/systemd/system/docker.service.d/ 中建立一個 http-proxy.conf 檔案，內容如下：

[Service]
Environment="HTTP_PROXY=http://proxy.example.com:8888"
Environment="HTTPS_PROXY=https://proxy.example.com:8889"

接著重新啟動 Docker daemon：

sudo systemctl daemon-reload
sudo systemctl restart docker

Daemon 重新啟動後，就能執行指令 docker pull 拉取 image 了。

在 Docker 23.0 之後的版本，都可以透過修改 daemon.json 來修改 proxy 的設定。

首先建立一個 daemon.json 檔案：

sudo touch /etc/docker/daemon.json

並在 daemon.json 檔案中寫入以下的內容：

{
  "proxies": {
    "http-proxy": "http://proxy.example.com:8888",
    "https-proxy": "https://proxy.example.com:8889",
    "no-proxy": ""
  }
}

上述兩種做法都可以修改 docker daemon 的 proxy。

另外別忘記啟動的 container 也要使用 --env 參數來設定環境變數，否則 container 內也無法對外連線：

docker run \
    --env HTTP_PROXY=http://proxy.example.com:8888 \
    --env HTTPS_PROXY=http://proxy.example.com:8888 \
    -it ubuntu:20.04 bash