docker build的proxy，容器的proxy ,image的Proxy 三個的區別

Docker Daemon 代理 (守護進程代理) 容器運行時代理鏡像構建代理 (Build Proxy)

作用對象 Docker 守護進程 (dockerd) docker run 后運行的容器 docker build 過程

主要影響范圍全局性配置，影響所有通過 dockerd 的網絡操作配置后啟動的特定容器或所有新容器（取決于配置方式）僅本次構建過程

典型用途 docker pull, docker push 容器內應用程序訪問外部網絡構建時下載軟件包（如 apt, pip, npm）

配置方式 1. Systemd 配置文件 (/etc/systemd/system/docker.service.d/)
2. daemon.json (部分系統) 1. ~/.docker/config.json (全局)
2. docker run -e (單次)
3. Docker Compose 文件 1. --build-arg 傳遞參數
2. Dockerfile 中 ARG 指令

配置示例 Environment=“HTTP_PROXY=http://proxy.example.com:8080” docker run -e http_proxy=http://proxy.example.com:8080 image_name 或 ~/.docker/config.json docker build --build-arg http_proxy=http://proxy.example.com:8080 .

?? 配置注意事項與技巧

配置 Docker 代理時，有幾個通用但非常重要的點需要注意：

? 協議支持：Docker Daemon 代理目前主要支持 HTTP、HTTPS 和 FTP 代理協議，不支持直接的 Socks5 代理。如果只有 Socks5 代理，需要使用工具（如 polipo）將其轉換為 HTTP 代理。

? 地址問題：在配置代理地址時，需要注意：

?   如果 Docker 守護進程或容器使用默認的 bridge 網絡模式，要訪問宿主機上的代理服務，不能使用 127.0.0.1 或 localhost，因為這對容器來說是它自己。通常需要指定宿主機的 Docker 網橋 IP（如 172.17.0.1） 或宿主機的真實 IP 地址 。

?   若在 docker build 或 docker run 時添加了 --network=host 參數，容器會與宿主機共享網絡命名空間，這時就可以直接使用 127.0.0.1 來指向宿主機上的代理服務 。

? no_proxy 設置：為了避免對內部地址的請求也走代理，通常需要配置 no_proxy 或 NO_PROXY 環境變量來列出直連的地址，如 localhost, 127.0.0.1, 內部域名或局域網網段。

??? 各代理的詳細配置方法

Docker Daemon 代理 (用于 docker pull/push)

這是影響最廣的代理配置，決定了 Docker 守護進程本身如何訪問網絡，主要用于鏡像的拉取和推送。

? 通過 Systemd 配置（Linux 常見）：

1.  創建或編輯配置文件：/etc/systemd/system/docker.service.d/http-proxy.conf
2.  加入以下內容（替換為你實際的代理地址和端口）：
    [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,.internal.example.com"
    
3.  保存后，重新加載配置并重啟 Docker 服務：
    sudo systemctl daemon-reload
    sudo systemctl restart docker

? 通過 daemon.json 配置（部分系統）：

編輯 /etc/docker/daemon.json 文件（如果不存在則創建），添加：
{
  "proxies": {
    "default": {
      "httpProxy": "http://proxy.example.com:8080",
      "httpsProxy": "http://proxy.example.com:8080",
      "noProxy": "localhost,127.0.0.1,.internal.example.com"
    }
  }
}

同樣，修改后需要重啟 Docker 服務 。

容器運行時代理 (用于 docker run)

此配置影響容器運行后其內部應用程序訪問外部網絡的方式。

? 全局配置（影響所有新容器）：

編輯 ~/.docker/config.json 文件（位于用戶家目錄下），添加：
{
  "proxies": {
    "default": {
      "httpProxy": "http://proxy.example.com:8080",
      "httpsProxy": "http://proxy.example.com:8080",
      "noProxy": "localhost,127.0.0.1"
    }
  }
}

此配置無需重啟 Docker，對之后新建的所有容器生效 。

? 單次配置（僅影響本次運行的容器）：

在 docker run 命令中直接通過 -e 選項設置環境變量：
docker run -e http_proxy=http://proxy.example.com:8080 -e https_proxy=http://proxy.example.com:8080 your-image

? Docker Compose 配置：

在 docker-compose.yml 文件中的服務定義下添加 environment 部分：
services:
  your-service:
    image: your-image
    environment:
      - http_proxy=http://proxy.example.com:8080
      - https_proxy=http://proxy.example.com:8080

鏡像構建代理 (用于 docker build)

這是最容易混淆的地方。Docker Daemon 代理僅負責拉取構建時的基礎鏡像（FROM 語句），而構建過程中執行指令（如 RUN apt-get update）的網絡請求需要單獨配置。

? 通過 --build-arg 傳遞（推薦）：

在構建命令中明確指定代理參數：
docker build \
  --build-arg HTTP_PROXY=http://proxy.example.com:8080 \
  --build-arg HTTPS_PROXY=http://proxy.example.com:8080 \
  -t your-image-name .

對應的 Dockerfile 中最好提前聲明這些參數：
ARG HTTP_PROXY
ARG HTTPS_PROXY
# 后續的 RUN 命令或其它指令就可以利用這些變量了

? 在 Dockerfile 中硬編碼（不推薦）：

直接在 Dockerfile 中設置環境變量，但注意這可能會將代理信息保留在最終鏡像中，存在安全風險。通常建議在構建結束后取消設置：
ENV http_proxy=http://proxy.example.com:8080
ENV https_proxy=http://proxy.example.com:8080
# ...你的構建步驟...
RUN unset http_proxy https_proxy  # 構建后取消設置

?? 如何選擇配置方式

? 臨時或特定需求：對于一次性的構建或容器運行，使用 --build-arg 或 docker run -e 附加環境變量最靈活。

? 個人開發環境（希望一勞永逸）：

?   為所有新構建的容器自動設置代理：配置 ~/.docker/config.json 。

?   為 docker pull/push 設置代理：配置 Docker Daemon 的代理 。

? 企業或生產環境：通常推薦通過 Systemd 配置 Docker Daemon 的代理，并在 CI/CD 流水線中明確使用 --build-arg 來傳遞代理參數，這樣更清晰、易于管理。

?? 常見問題排查 (Troubleshooting)

配置了代理但無效：
? 確認代理地址和端口是否正確，代理服務是否正常運行。

? 對于 Docker Daemon 代理，確認是否執行了 systemctl daemon-reload 和 restart docker。

? 檢查防火墻規則是否允許 Docker 守護進程或容器訪問代理服務器。
構建時某些指令不走代理：
? 確保在 docker build 時正確傳遞了 --build-arg。

? 注意：docker build 過程中，只有 FROM 指令拉取基礎鏡像受 Docker Daemon 代理影響，其他指令（如 RUN）需要靠構建參數傳遞代理。
容器無法訪問某些內網地址：
? 檢查 no_proxy 或 NO_PROXY 環境變量是否正確設置，是否包含了需要直連的內部域名或 IP 段。

希望以上的解釋和對比能幫助你更好地理解 Docker 中不同層次代理配置的區別和用途。

posted @ 2025-09-02 23:33 行路客閱讀(16) 評論(0) 收藏舉報來源

刷新頁面返回頂部

xingluke

docker build的proxy，容器的proxy ,image的Proxy 三個的區別

公告