為什麼「宿主有開 Clash」,容器裡的程式仍像從不認識它?
在 macOS 或 Windows 上,很多人習慣一鍵開啟用戶端的系統代理,讓瀏覽器、部分桌面程式把流量送到 127.0.0.1:7890 這類本機位址。於是你會先在瀏覽器裡感到「有走 Clash」—這件事本身通常沒問題,只是不要把它當成 Docker 的預設行為。
在預設的 bridge 網路裡,每個容器的 127.0.0.1 都指向那個容器的內部迴圈,不是宿主(host)的作業系統。換句話說,把代理寫在宿主桌面環境,或是期待容器「像瀏覽器一樣讀到系統代理」,多半會失敗。除非你自己把代理 URL 帶進容器(或是另外做透明轉送),否則容器內的 curl、apt、套件管理與 docker pull 的連線,往往會變成不經 Clash 的直連,看起來就像「主機有代理、容器卻從不經過」。
另一件常被混淆的事,是 DNS 與 傳輸層轉送 的分工。就算你在某個層面把 Clash 配得很完整,如果容器內的程式仍讀到不同的解析途徑,或你用了 Fake-IP 模式卻在容器內用另一條名稱服務,外觀就會變成「有時連上、有時怪」。可以把這篇文章當成「先把容器與宿主之間的位址與橋畫清楚,再疊上 Proxy 變數」的實測筆記;更細的 Fake-IP 可搭配站內的Fake-IP 與 DNS 專文。
若你第一次打開專案中的說明文件總覽,能更快對 Clash 用戶端裡的埠位、TUN 與規則語意有共同語言。接下來我們從「宿主的 Clash 到底聽在誰的介面上、容器怎麼摸得到那個位址」開始,一路接到 HTTP_PROXY 與 docker compose 的實務寫法。
先決條件:讓宿主的 Clash 願意被「從虛擬橋上」的容器連上
在動任何 Docker 參數之前,請在宿主這邊自檢三件事,否則你怎麼寫 HTTP_PROXY 都白費。第一,Clash(或基於其核心的圖形用戶端)是否真的在你預期的那個 HTTP/mixed 埠上監聽。第二,是否啟用允許區網(常見寫在設定檔或介面中為 allow-lan: true),避免只綁在 127.0.0.1 而導致「只接受迴圈連入」。第三,在 macOS 或 Windows 的防火牆、企業防毒或 MDM 例外規則,是否沒有擋下由 docker0 或內部虛擬交換器來的連入。
關於「從內部網段連上 Clash」的安全意涵,可延伸閱讀站內的allow-lan 與防火牆,心裡有底再開。以下假設你使用的 HTTP 或 mixed 埠是 7890,請以你實際介面顯示為準替換,文中不再反覆贅述。
第一步:在容器內,應把代理指向哪一個「宿主位址」?
在 Linux 的預設 bridge 裡,宿主的內部閘道位址,經常(但不保證永遠)是 172.17.0.1 或其他由 Docker 劃出來的內部網段。你可以讓一個臨時容器印出 ip route,找預設閘道一列,以「實際可連到宿主」者為優先。
在 Docker Desktop(macOS/Windows),內建的主機位址 host.docker.internal 是官方提供的解析名稱,多數情況下能指到主機的某個內部介面。若你的 Compose 有啟用 extra_hosts 自訂,也請記得讓邏輯名稱與變數裡的 host 名稱一致。
綜合實務上,你可以先選一條可重現的寫法,然後在容器裡 實測能連上代理埠,而不是從一開始就背誦 172.17.0.1 到底對不對。比較穩的經驗是:以實測的連通性為聖經,教學裡的範例 IP 都當參考用。例如(請替換 HOST_ADDR 與埠):
docker run --rm -it --network bridge alpine:3.20 sh -c \
"apk add --no-cache curl && curl -I --connect-timeout 5 http://HOST_ADDR:7890 || true"
若此處就逾時,代表問題根本不在變數名稱,而在你根本還沒讓容器的封包,抵達正在聽的 Clash 介面。回頭看上一節的 allow-lan 與防火牆。若可連、但實際上網仍抽風,才進到規則、節點與 TUN 等話題,可參考規則分流與 TUN 專文。
第二步:用 HTTP_PROXY 家族把「從哪進 Clash」寫成環境變數
在 Unix 生態,大多數能尊重標準的 HTTP 客戶端,會讀 http_proxy/https_proxy,以及大寫版。為了讓在奇怪大小寫慣例裡的程式也吃到值,我們建議在容器或 Compose 的 environment 中兩邊都寫。下面示範用 host.docker.internal:7890 當作宿主上的 Clash(僅在 Docker Desktop 一類情境常用):
http_proxy="http://host.docker.internal:7890"
https_proxy="http://host.docker.internal:7890"
HTTP_PROXY="http://host.docker.internal:7890"
HTTPS_PROXY="http://host.docker.internal:7890"
no_proxy="localhost,127.0.0.1,::1"
NO_PROXY="localhost,127.0.0.1,::1"
若你要走 SOCKS,且用戶端有開對應埠,可再補上 all_proxy/ALL_PROXY 指向 socks5h://...;但許多 apt 或內部工具鏈僅讀 HTTP 形態的變數,實測上仍以 HTTP 欄位優先。另一方面,no_proxy/NO_PROXY 的語意是「內部服務、registry 的內部位址、或你刻意要直連的位址可以跳過代理」,不要讓內部命名空間或私有 registry 被硬塞到代理裡,否則會變成奇怪的超時。
第三步:在 docker run 與 docker compose 套用上列變數
對臨時除錯,docker run 可以直接帶 -e。對長期服務,docker compose 的 environment 或 env_file 更好維運。一個觀念必須先講完:變數在「執行中容器」的行程裡有沒有出現,與 docker 自己拉映像的網路行為是兩件事。也就是說,你在 compose 幫 app 服務寫的 HTTP_PROXY,未必會讓 docker pull 走同一條路,除非主機的 Docker daemon 或 Desktop 的設定,另外指定了與其一致的代理。這是很多人以為「我容器裡有 proxy,為什麼拉映像還是卡」的常見起點。
在 Docker Compose 中,一個實作上清楚可讀的寫法,是把變數抽成專用區塊,讓團隊成員在 .env 內以本機的宿主閘道名稱覆寫。例如以 YAML 的 environment 段落宣告(實際鍵名與縮排請依專案版本與風格):
services:
web:
image: your-image:tag
environment:
- HTTP_PROXY=http://host.docker.internal:7890
- HTTPS_PROXY=http://host.docker.internal:7890
- http_proxy=http://host.docker.internal:7890
- https_proxy=http://host.docker.internal:7890
- NO_PROXY=localhost,127.0.0.1,::1
- no_proxy=localhost,127.0.0.1,::1
在純 Linux 伺服器,若沒有 host.docker.internal 這顆內建名稱,你可以改寫實測出來的閘道 172.17.0.1 或其他值,或自行在 extra_hosts 把某個自訂名稱指到可連的那個內部 IP。寫在設定檔裡時,團隊應有共識:這個值是環境相依的參數,不是可以硬抄到生產機上的魔術數字。
第四步:建置階段 docker build 與執行階段要分開想
另一個讓人氣餒的癥結,是 RUN apt update 或 npm install 發生在 映像建置階段。僅在執行中容器有 HTTP_PROXY,不會自動幫你回溯到沒有匯出變數的 Dockerfile 的每一行。建置時有兩條常見實作:一條是在 docker build 時帶上 --build-arg 與在 Dockerfile 以 ARG 接收、必要時在單一 RUN 內匯出;一條是讓本機的 Docker 守護程序(或 BuildKit 的前端行為)走代理。後者牽涉面較大,牽到 Desktop 的偏好設定、服務的 systemd override、或 HTTP_PROXY 在 daemon 環境裡的落地方式;如果你遇到「執行容器有網、建置卻沒有」的現象,優先把這兩者拆開,不要同時大改兩層導致無法歸因。
一個保守且易於團隊溝通的原則是:執行期走代理的邏輯,寫在 compose;建置期需要代理的,用明確的 build arg 在 Dockerfile 單一 RUN 內匯出,或另外提供文件化的 daemon 層代理步驟。這能避免在社群貼的「一鍵腳本」讓 CI 和本機兩邊出現不對稱行為。
第五步:驗證——在容器內用最小指令自證有走 Clash 的路徑
你不需要一開始就觀測到完整路由表。先確認行程看得到變數、再 curl -I 一個能反映策略差異的 HTTPS 位址,觀察延遲與狀態碼。第二條是若有 Clash 的日誌或連線頁,能否看到從內部網段而來的連入嘗試。第三條是若你同時有 Fake-IP,請不要只看 getent 的輸出,而要看應用層的實際完成與失敗,必要時參考 Fake-IP 專文把預期說清。
一組容易複製的檢查序列如下(在已進入的容器內、或帶有 shell 的 docker exec 中執行):
printenv | grep -i proxy
curl -I --max-time 20 https://www.google.com
第一條若全空,卻在 compose 內有寫變數,就檢查是否套錯了服務名稱、是否用覆寫檔、或實際跑起來的容器不是你以為的那一個。第二條若明顯逾時,先回到本節前面「從橋上能不能摸到宿主上的代理埠」那一刀。
什麼時候該考慮在宿主上開 TUN,而不只在容器內寫變數?
在容器內寫 HTTP_PROXY 的好處是可理解、可寫進版本庫的宣告式設定、在開發與測試環境好還原。缺點是:尊重這組變數的才算數;不讀標準變數的程式、或自帶 HTTP 實作的小工具,仍可能讓你以為「我明明設了,怎麼還是直連」。
若你需要的不是「在容器內的少數明確行程」、而是讓某一大類流量在宿主就進入轉送核心,在充分了解風險與可還原性的前提下,可評估宿主的 TUN 模式。站內的TUN 模式詳解有獨立脈絡,與本文並讀時,請分清楚「誰的網路堆疊」在接手封包。對多數在 Docker 裡寫前後端分離專案的人,先把本文的變數與閘道講通,其實就解掉多數的「有代理卻不經 Clash」抱怨。
結語:把「橋接網路、宿主可達性、變數生命週期」分開,就不會在 Docker 上盲試
容器「繞開」宿主上 Clash 的表象,多半不是惡意,而是網路邊界與代理語意從一開始沒有對齊。你只要在記憶裡固定三句話,大多數實作就不會亂竄:第一,容器裡的 127.0.0.1 不是你的桌面 Clash。第二,代理 URL 的 host 必須是在容器內實測能連到、且已允許從內部網段入站的宿主或閘道位址。第三,HTTP_PROXY 是給行程吃的,docker pull 與 docker build 可能落在不同層級的網路路徑,要分開驗證。
相較到處收集片段指令,一個能講清埠位、能安全開關 allow-lan、在出問題時容易還原的 Clash 用戶端,能顯著降低你在容器與宿主兩層之間的試錯成本。你可以先從本站的用戶端下載頁取得與你平台相符的版本,接著以本文的順序自檢:可達性、變數、分階段建置。→ 立即免費下載 Clash,開啟流暢上網新體驗