教程 2026年10月9日

工程師必學:用 Clash TUN 模式讓 Git 與終端機指令穩定連線

Git clone 卡住、SSH 連不上,或 Homebrew 下載逾時?從工程師常用的命令列工具出發,說明如何設定 Clash TUN,讓流量自動分流代理,並維持內網與本機服務正常運作。

跨境電商 Amazon 賣家 Shopify

一、為什麼瀏覽器能連,Git 與終端機卻卡住?

工程師常遇到一種看似矛盾的狀況:瀏覽器可以開啟程式碼託管平台,git clone 卻停在連線階段;套件管理工具一直重試,或 ssh 等到逾時。原因通常不是「代理完全沒有作用」,而是不同程式採用的網路方式並不相同。瀏覽器可能遵循作業系統的系統代理設定;Git、SSH、curl、Homebrew 或自行建立 socket 的程式,則可能忽略該設定,直接連線。

另一個容易混淆的地方是,代理有沒有生效和目的端是否可用,是兩個不同問題。像是認證失敗、金鑰權限不足、遠端伺服器拒絕連線,通常不會因為切換代理而消失。開始調整前,先記錄失敗的命令、目標主機、錯誤訊息,以及同一命令在直連和代理環境下的差異;ETIMEDOUT、連線重置或長時間無回應,比明確的認證錯誤更值得先檢查路由與出口。

本篇以 Clash 相容核心(例如 Mihomo)搭配桌面客戶端為例。TUN 的用途,是讓符合條件的作業系統流量交給核心處理,再由規則選擇代理或直連;它不會替你修復錯誤的 Git 遠端網址,也不代表所有應用程式在任何作業系統上都會以完全相同的方式被接管。

請遵守所在地法規、公司網路政策與服務條款。若公司要求使用指定的 VPN、固定出口或企業代理,請先確認 TUN 是否獲准;避免在未授權的情況下改變工作流量的出口。

二、啟用 TUN 前,先確認權限、核心與復原方式

在 Clash Verge、Clash Verge Rev 或其他使用 Mihomo 核心的客戶端中,先確認目前選用的核心支援 TUN,並備妥可還原的設定檔。不同版本的介面名稱與權限提示可能不同;有些系統需要允許建立虛擬網路介面或授予管理員權限,有些則會在第一次啟動時要求安裝或核准相關元件。請依客戶端提示操作,不要為了排錯而長期以高權限執行所有終端機程式。

變更前記下目前的路由、系統代理狀態和公司 VPN 設定,並先確認可以從客戶端關閉 TUN。若啟用後無法連回內網或遠端管理介面,能否迅速停用並恢復原有連線,往往比一開始追求最複雜的設定更重要。尤其不要同時更換核心、修改 DNS、切換節點與啟用 TUN,否則結果變好或變壞時,很難判斷是哪項變更造成。

客戶端若提供圖形化開關,先在介面中啟用 TUN,並檢查狀態是否顯示已啟動;設定檔中的相應區塊則需依核心版本與客戶端的管理方式調整。以下只是 Mihomo 設定概念示例,不是能直接套用到每個訂閱或版本的完整設定;若客戶端會自動管理 tun 區塊,不要再用另一份設定與它互相覆蓋。

# Example only — confirm supported options in your client and core version.
tun:
  enable: true
  stack: mixed
  auto-route: true
  strict-route: true
  auto-detect-interface: true
  dns-hijack:
    - any:53

選項的實際效果受作業系統、核心版本與客戶端實作影響。auto-route 通常用於協助安裝路由,auto-detect-interface 則用於選擇合適的實體網路介面;兩者名稱相似,作用並不相同。strict-route 可能讓流量接管更嚴格,但也可能影響區域網路、虛擬機或其他網路軟體。若啟用後內網服務突然失聯,應先檢查路由與規則,而不是直接把所有區域網路目的地導向代理。

三、先安排規則順序:代理 Git,內網與本機服務直連

TUN 解決的是流量如何進入核心,最後走哪個出口仍由設定檔中的規則決定。實務上,先明確保留本機與私有網路的直連,再為需要穩定出口的程式碼託管服務指定代理群組,最後才安排兜底規則。若把廣泛的域名規則或 MATCH 放在前面,後續的內網例外可能永遠不會被命中。

下列規則只是示意。請將 DEV_PROXY 換成設定中確實存在的策略群組,並依工作情境調整程式碼託管平台的域名。若公司使用自架 Git 服務,優先使用管理者提供的實際主機名稱或網段,不要把整個公司網域一概送往公用代理。

# Example only — replace DEV_PROXY with an existing policy group.
rules:
  - DOMAIN-SUFFIX,github.com,DEV_PROXY
  - DOMAIN-SUFFIX,githubusercontent.com,DEV_PROXY
  - DOMAIN-SUFFIX,githubassets.com,DEV_PROXY

  # Keep private networks and local services direct.
  - IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
  - IP-CIDR,172.16.0.0/12,DIRECT,no-resolve
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - IP-CIDR,127.0.0.0/8,DIRECT,no-resolve

  # Add your company Git host before the final fallback.
  - MATCH,DIRECT

請特別留意規則的先後順序:同一條連線只會依核心的規則流程匹配,不會因為在檔案後段再加一條例外就自動覆蓋前面的匹配。若你使用規則集、覆寫設定或客戶端的自訂規則功能,也要確認它們實際插入的位置。設定套用後,可在連線紀錄中查看 Git 目的主機對應到哪個規則與策略群組;如果紀錄顯示直連,表示問題未必在節點,而可能是規則沒有匹配、規則順序不合預期,或應用程式使用了不同的目的主機。

區域網路與本機服務也值得逐一測試。常見對象包括公司內部 Git、私有套件庫、開發伺服器、容器網路、虛擬機,以及 localhost 上的測試服務。不同網路的私有網段不一定都落在示例列出的範圍內;不要只因為一個網段看起來像內網就假設它已被直連規則涵蓋。若需要新增例外,先確認目的位址與管理政策,再用最小範圍的規則處理。

四、讓 Git、SSH、curl 與套件工具各走各的正確路徑

啟用 TUN 後,不讀取系統代理設定的程式通常也有機會透過核心的路由處理流量,但應逐一驗證,不要只看客戶端的總開關。先測試網域是否能解析,再用 curl 連到實際使用的主機,接著執行 Git 操作;這種由簡到繁的順序,能把 DNS、傳輸連線與 Git 認證分開檢查。

若你選擇使用傳統的本機 HTTP 代理,而不是依賴 TUN 接管,也可以只為目前的終端機工作階段設定代理環境變數。以下的連接埠僅為示例,請以客戶端實際監聽的埠號為準;不同工具對環境變數的支援程度不一,設定前應查看工具文件。

# Example for a shell session; use the actual local proxy port.
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export ALL_PROXY=socks5h://127.0.0.1:7891

# Clear these variables when you no longer need them.
unset HTTP_PROXY HTTPS_PROXY ALL_PROXY

使用環境變數時,socks5h 中的 h 表示將主機名稱解析交由代理端處理;是否適合你的工具與核心,仍需依實際支援情況驗證。也要注意代理變數可能被子行程繼承,包含建置腳本、套件安裝程式或編輯器啟動的工作。若公司內部套件庫不應經過外部節點,應使用工具本身支援的排除方式,或在代理規則中明確設定內網直連。

Git over HTTPS 與 Git over SSH 是不同的傳輸路徑。前者通常連至 HTTPS 服務主機,後者則可能連至標準 SSH 埠或服務商提供的替代埠。若 git clone 使用 SSH 位址,單獨設定 HTTP_PROXY 不保證 SSH 會使用該代理;此時可由 TUN 接管並在紀錄中確認連線,也可依組織核准的方式設定 SSH 專用跳板或代理命令。不要因為 HTTPS 克隆成功,就認定 SSH 的路徑也已正常。

對 Homebrew 或其他套件管理工具,先觀察錯誤中實際失敗的主機,而不是只為工具首頁加入規則。下載可能經過原始碼平台、釋出檔案儲存服務或套件鏡像站;同一個安裝流程也可能先連一個主機取得索引,再從另一個主機下載檔案。以客戶端連線紀錄和工具輸出確認目的地,逐項補規則,通常比加入過寬的關鍵字規則更容易維護。

五、分層驗證與常見失敗原因

設定完成後,先用一個可重現的測試流程確認每一層。第一步,在終端機檢查 Git 遠端網址與主機名稱是否正確;第二步,用系統提供的網路工具確認名稱解析結果;第三步,對該主機執行短時間的 curl 測試;第四步,查看 Clash 連線紀錄,核對目的主機、命中規則、策略群組與連線結果;最後再執行一次小型 git ls-remote 或克隆測試。每次只改一項設定,並保留失敗前後的輸出,才能知道修正是否真的有效。

如果 curl 成功、Git 仍失敗,先檢查兩者是否使用相同協定與目的主機,再查看 Git 的認證、憑證與遠端設定;不要把權限錯誤誤判為網路問題。如果名稱解析失敗或解析結果與預期不同,應檢查系統 DNS、核心的 DNS 模式及規則,而不是反覆切換節點。如果連線紀錄顯示已命中代理,但仍逾時,則進一步測試另一個可用策略,並留意目前網路是否限制了特定埠或長連線。

在 TUN 啟用後連不上公司內部服務,優先確認內網網段、公司 VPN 路由和規則順序。多個網路介面同時存在時,核心選錯出口也可能造成看似偶發的故障;切換實體網路或重新連接企業 VPN 後,請重新驗證,而不要假設原先選出的介面永遠正確。若系統代理與終端機環境變數同時指向不同埠號,也可能令不同程式表現不一致;確認目前採用的代理方式,避免多套設定互相干擾。

另一個常見誤區,是把所有故障都歸咎於節點。即使網路通道可用,錯誤的遠端網址、過期的存取權杖、SSH 金鑰未載入、伺服器端限流或 TLS 憑證問題,仍會導致操作失敗。當回應已明確指出認證或授權錯誤,先修復帳號與憑證;只有在握手、解析、連線逾時或重置等問題有明確網路跡象時,才繼續調整代理策略。

相較於只設定瀏覽器代理的做法,TUN 能讓多種終端機程式在不逐一配置代理變數的情況下,交由同一套規則處理;但它也比單一應用程式代理更需要留意路由、內網例外與企業網路政策。若你需要讓 git clone、SSH 和套件下載使用一致且可觀察的出站策略,同時保留本機服務與內網直連,Clash 的規則與連線紀錄能提供更清楚的排錯線索。確認適合你的作業系統與使用情境後,可從下載頁選擇相應客戶端。

前往下載 →

準備好開始了嗎?

選擇相容客戶端,依序設定 TUN、規則與終端機連線。