在已驗證的 HTTP 代理後端執行 Docker 容器
由 ProxyV4 工程團隊撰寫 · Updated:
設定 Docker 代理時,首先要釐清一個問題:哪些流量需要經由代理送出?Docker 包含三條獨立路徑(執行階段的應用程式、docker build 以及拉取映像檔的 Daemon),且各自從不同位置讀取代理設定。只要配置正確,同一台主機上的每個容器都能使用專屬的 ProxyV4 IPv4 位址對外連線,同時完全不影響主機本身的路由表。
ENV HTTP_PROXY=http://user:pass@ip:port HTTPS_PROXY=http://user:pass@ip:port- 1 個 IPUS$1.85
- 3+ 個 IPUS$1.70
- 10+ 個 IPUS$1.60
- 25+ 個 IPUS$1.50
- 50+ 個 IPUS$1.40
- 100+ 個 IPUS$1.30
- 200+ 個 IPUS$1.20
- 500+ 個 IPUS$1.10
- 1 個 IPUS$1.85
- 3+ 個 IPUS$1.70
- 10+ 個 IPUS$1.60
- 25+ 個 IPUS$1.50
- 50+ 個 IPUS$1.40
- 100+ 個 IPUS$1.30
- 200+ 個 IPUS$1.20
- 500+ 個 IPUS$1.10
Docker 讀取代理設定的三個位置
在其中一個作用域設定變數,並不會套用到另外兩個。最常見的情況就是 docker pull 正常運作,但容器內的應用程式卻仍使用主機本身的 IP 連出,反之亦然。
| 流量類型 | 設定位置 | 典型內容 |
|---|---|---|
| 執行中容器內的應用程式 | docker run -e HTTP_PROXY=... 或 Compose 中的 environment: 區塊 | 爬蟲請求、API 呼叫、自動化作業 |
docker build 期間執行的指令 | --build-arg HTTP_PROXY=http://user:pass@ip:port | RUN 步驟中的 apt、pip 與 npm 下載 |
| Docker Daemon 本身 | /etc/systemd/system/docker.service.d/http-proxy.conf | 針對 Registry 執行的 docker pull 與 docker push |
每個容器享有獨立 IP
由於執行階段變數獨立存在於各容器的環境中,一台 VPS 就能執行例如十個 Worker,且每個 Worker 各自配置不同的 http://user:pass@ip:port 數值。如此一來,每個 Worker 造訪目標網站時都會顯示專屬的出口位址;由於 ProxyV4 專用 IPv4 僅租賃給單一客戶,絕無其他人的流量會共用該位址。
建議為每個服務維護一個 .env 檔案,或讓每個 Compose 服務對應一個代理,以便一目了然各任務所屬的 IP。續約時可保留相同位址,這些檔案內容完全無需更動。
確保服務堆疊正常運作的變數
如果在完成這些變更後,docker pull 依然直接連線,或者容器無法連線到本身的資料庫,Proxy 無法運作 頁面會依序逐一引導檢查 Docker 的每一層。
- 同時定義大寫名稱(
HTTP_PROXY、HTTPS_PROXY、NO_PROXY)與小寫名稱(http_proxy、https_proxy、no_proxy);不同的工具與執行環境支援的拼寫規則各有不同 - 將應用程式呼叫的所有 Compose 服務名稱都加入
NO_PROXY,例如NO_PROXY=localhost,127.0.0.1,redis,postgres,確保資料庫與快取的流量留在 bridge 網路中,而不是被轉發到 Proxy HTTPS_PROXY同樣請使用http://協定;客戶端會建立 CONNECT 通道,造訪 HTTPS 網站依然全程保持加密- 請勿在
Dockerfile中使用ENV寫入 Proxy 密碼:密碼會殘留在映像檔層中。請改在執行時透過.env或 Compose 檔案注入
步驟說明
- 1
將訂單資訊轉換為代理 URL
您的 ProxyV4 訂單會顯示
ip:port:user:pass;請手動將其改寫為http://user:pass@ip:port,或使用 代理格式轉換器 轉換。 - 2
將環境變數加入服務
在
docker-compose.yml中該服務的environment:區塊下,設定HTTP_PROXY、HTTPS_PROXY、http_proxy、https_proxy以及NO_PROXY=localhost,127.0.0.1,redis,db。 - 3
重新建立容器
環境變數變更僅適用於新容器,因此請執行
docker compose up -d重新建立該服務。 - 4
從內部檢查出口 IP
執行
docker exec -it <container> curl -s https://proxyv4.com/api/my-ip。回傳的位址應為代理 IP,而非主機本身的 IP。
常見問題
加入 HTTP_PROXY 後應用程式無法連線至 Redis 或 Postgres,為什麼?
因為 HTTP 客戶端此時將 redis 或 db 的請求送往外部代理,而外部代理無法解析這些內部名稱。請將它們列入 NO_PROXY(及 no_proxy),例如 NO_PROXY=localhost,127.0.0.1,redis,db,接著重新建立容器。
同一台伺服器上的各個容器可以使用不同的代理嗎?
可以。只要為每個服務或各個 .env 檔案指定專屬的 http://user:pass@ip:port 數值即可。所有容器共用同一台主機,但連線至網際網路時會使用各自獨立的 IP。
為什麼代理環境變數需要同時設定大寫與小寫兩次?
因為業界並無單一標準。基於 libcurl 開發的工具會讀取小寫的 http_proxy 與 https_proxy,而許多 Go 和 Node 工具則讀取大寫名稱。兩者皆設定即可全面支援映像檔內的所有工具。
Does docker pull 會使用我在 Compose 中設定的變數嗎?
不會。拉取映像檔是由 Daemon 執行,其代理設定是讀取自 systemd drop-in 配置檔 /etc/systemd/system/docker.service.d/http-proxy.conf,而非來自容器的環境變數。
資料來源
為每個容器配置獨立的專屬 IPv4
提供 7 個國家的無限流量專用 IPv4,以及美國與越南的靜態 ISP 代理,付款完成後自動交付。無最低訂購數量限制。
查看新加坡即時價格