一、先拆開看:Git、SSH 與 Homebrew 不一定走同一條代理
工程師常把「Clash 已啟用」理解成終端機裡的所有程式都會自動走代理,但實際情況取決於應用程式使用的網路方式。瀏覽器通常會讀取系統代理,命令列工具則可能讀環境變數、自己的設定檔,或直接建立網路連線。即使在同一個終端機視窗執行,Git 透過 HTTPS 連線、Git 透過 SSH 連線,以及 Homebrew 下載公式或執行安裝腳本,也可能使用不同的代理設定。
排查時先記下失敗的具體操作,例如 git clone 卡在解析主機、SSH 顯示 Connection timed out,或 brew install 下載途中失敗。接著確認是哪個程序發起連線、目的主機是什麼,以及目前 Clash 使用的是規則模式還是全域模式。這樣才能分辨問題出在規則未命中、終端機未讀到代理、SSH 沒有代理命令,還是遠端服務本身回傳了權限錯誤。
二、先確認 Clash 模式、監聽埠與規則命中
開始改終端機設定前,先在 Clash Verge、Clash Verge Rev 或其他 Mihomo 相容用戶端確認核心正在執行,並檢查設定檔提供的 HTTP、SOCKS 或混合代理埠。常見範例是本機的 127.0.0.1:7890,但實際值可能不同;不要只因別人的指令使用 7890,就假設自己的電腦也是如此。若使用遠端開發容器、虛擬機或容器化工作環境,該環境中的 127.0.0.1 通常指向容器本身,而不是執行 Clash 的主機。
切換到全域模式可以作為短時間的診斷手段:若原本失敗的請求立刻恢復,代表問題可能與規則選擇或目標主機的路由有關;但全域模式不適合當成未經審視的長期修正,因為公司內網、套件鏡像與區域服務也可能因此改走不合適的出口。較穩妥的做法是在規則模式下,從 Clash 連線紀錄確認請求是否出現、命中了哪條規則,以及最後選到哪個策略群組。
GitHub 相關操作可能連到 github.com、api.github.com、codeload.github.com 或發佈檔案使用的其他主機。Git 伺服器、企業代管服務與套件下載來源則各有不同,網域清單只能作為檢查起點,不應視為固定且完整的清單。若日誌只看到 IP 位址,還要核對 DNS 解析與連線紀錄;不建議為了「讓它通」就把所有流量無差別導向代理。
| 操作方式 | 常見連線方式 | 優先檢查項目 |
|---|---|---|
| Git 使用 HTTPS | HTTP(S) 用戶端請求 | http.proxy、代理環境變數、規則命中 |
| Git 使用 SSH | SSH 連到伺服器的 22 埠或自訂埠 | ~/.ssh/config、ProxyCommand、SSH 詳細輸出 |
| Homebrew 安裝套件 | 下載 API、公式、原始碼或二進位檔 | 終端機環境變數、Git 設定、下載主機與 Clash 紀錄 |
三、Git 使用 HTTPS 時,設定代理並避免洩漏憑證
如果遠端網址是 https://github.com/組織/專案.git 這類形式,Git 使用的是 HTTP(S) 傳輸。可先用環境變數進行單次驗證,讓目前終端機啟動的支援這些變數的程序嘗試透過本機 HTTP 代理連線:
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export http_proxy="$HTTP_PROXY"
export https_proxy="$HTTPS_PROXY"
git ls-remote https://github.com/OWNER/REPOSITORY.git
這段設定僅在目前的 shell 工作階段有效,關閉視窗或取消變數後便不再生效。若要確認環境變數是否是原因,可以在尚未設定時執行一次,再設定代理後重試;同時查看 Clash 紀錄有沒有出現對應連線。部分工具不讀取環境變數,或只接受特定代理格式,因此「變數已匯出」不等於「請求必然走代理」。另外,HTTP 代理網址使用 http:// 並不代表目標網站以明文傳輸;HTTPS 連線通常會透過代理建立隧道。
若確認 Git 的 HTTPS 傳輸確實需要固定走某個本機代理,可用 Git 設定保存代理位址:
git config --global http.proxy http://127.0.0.1:7890
git config --global --get http.proxy
全域設定會影響此使用者的 Git HTTP(S) 請求,包括不一定需要代理的內部服務。若只有特定伺服器需要代理,應考慮按網址範圍設定,並在完成後用 git config --show-origin --get-regexp 'http\..*proxy' 查出設定來源,避免系統設定、全域設定與專案設定彼此覆蓋。代理網址若包含使用者名稱或密碼,不要直接提交到專案的 .gitconfig、程式碼倉庫或除錯截圖中;也不要把存取權杖放進 Git 遠端網址,因為它可能留在 shell 歷史與日誌裡。
常見錯誤要分開判斷:Could not resolve proxy 通常表示代理主機名稱或位址無法解析;Failed to connect 可能是埠號錯誤、Clash 未啟動或本機連線被拒絕;若已連上遠端並收到 401 或 403,則優先檢查登入狀態、憑證與倉庫權限,而不是不斷更換代理節點。
四、Git 使用 SSH 時,為 SSH 指定可用的代理路徑
Git 遠端若使用 [email protected]:OWNER/REPOSITORY.git,Git 會啟動 SSH 用戶端。此時 Git 的 http.proxy 對這條 SSH 連線沒有作用;設定了 HTTPS 代理,並不會自動讓 SSH 改走同一個出口。你需要先確認本機的 OpenSSH 是否支援透過代理命令連線,再選擇與 Clash 監聽類型相符的方式。
若本機安裝的 nc 支援 SOCKS5 代理選項,可在 ~/.ssh/config 為特定主機加入以下設定。範例中的埠號要替換為實際 SOCKS 或 mixed 監聽埠;不同作業系統附帶的 nc 版本,選項可能不完全相同,執行前請先查看 man nc。
Host github.com
HostName github.com
User git
ProxyCommand nc -X 5 -x 127.0.0.1:7891 %h %p
若你的代理只提供 HTTP CONNECT,便不能直接把 HTTP 埠當成 SOCKS5 埠交給 nc。應改用支援 HTTP CONNECT 的代理工具或符合該用戶端語法的設定;不要只更換數字而忽略協定類型。不同 Clash 用戶端可能以 HTTP、SOCKS 或 mixed-port 提供連線,請先在用戶端設定與核心紀錄中核實,並確認代理工具本身能在相同埠上完成連線。
設定後先測試 SSH 握手,不必馬上執行完整的複製操作:
ssh -Tv [email protected]
git ls-remote [email protected]:OWNER/REPOSITORY.git
ssh -T 的成功訊息通常表示 SSH 已能連到 GitHub,但不代表你對每個倉庫都有讀取權限;若要查傳輸過程,可用 -v 或 -vv 查看 SSH 實際採用的設定與 ProxyCommand。排錯輸出可能包含使用者名稱、主機資訊或本機路徑,分享前應先檢查並遮蔽敏感內容。若企業 Git 伺服器使用非標準埠、跳板主機或內部 DNS,應為該主機建立獨立的 Host 區塊,不要把適用於 GitHub 的代理規則直接套用到所有 SSH 連線。
五、Homebrew 安裝失敗時,分辨下載、Git 與公式來源
Homebrew 的一次安裝操作可能包含多個步驟:查詢公式資料、更新本機資訊、透過 Git 取得原始碼,或從發佈服務與鏡像下載預編譯套件。因此,瀏覽器能開啟下載頁,不代表終端機裡的 brew install 一定能完成;同樣地,Git 能透過 SSH 拉取程式碼,也不能證明 Homebrew 的其他下載請求已使用代理。先從錯誤訊息辨認目前停在更新、Git 傳輸、解析網址,還是實際下載階段。
可在目前終端機工作階段設定常見代理環境變數,再執行最小化測試。下面仍以 HTTP 代理埠為例,請依 Clash 實際設定替換:
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
export http_proxy="$HTTP_PROXY"
export https_proxy="$HTTPS_PROXY"
export all_proxy="$ALL_PROXY"
brew --version
brew info FORMULA
ALL_PROXY 是否被某個程式採用,取決於該程式的實作;不要假設設定它就能涵蓋所有下載步驟。使用 SOCKS 時,socks5h 通常表示由代理端解析目標名稱,而 socks5 可能由本機先解析;若遇到 DNS 解析差異,可將解析路徑列入測試,但仍須以工具支援的格式為準。也不建議同時留下互相矛盾的大小寫變數,例如大寫指向 HTTP、小寫卻指向另一個不可用的 SOCKS 埠,因為不同程式對變數名稱的處理可能不同。
若錯誤明確發生在 Git 更新或從 Git 遠端取得原始碼,回頭檢查 Git 使用的是 HTTPS 還是 SSH,並依前兩節分別驗證。若錯誤出在下載檔案,請檢查錯誤中顯示的實際主機,並在 Clash 連線紀錄中尋找同一筆請求。Homebrew 公式、版本與下載來源會變動,某個舊版教學列出的域名不一定涵蓋目前操作;不要未經核對就把整個套件供應鏈的網域都設定成同一條代理路由。
當內部網路要求套件下載必須經核准出口,或公司提供專用鏡像時,優先採用組織維護的來源與憑證政策。把所有下載流量導向個人節點,可能影響來源驗證、稽核紀錄或建置可重現性。安裝後也可在不變更全域設定的情況下,開啟新終端機重試一次;若只有特定 shell 或 IDE 內建終端機失敗,就應檢查它啟動時是否繼承到正確的環境變數。
六、把故障收斂成可重現檢查,而不是反覆換節點
最有效率的排錯方式,是每次只改一個變因,並保留操作前後的結果。先確認 Clash 是否啟動、本機代理埠是否可用,再用相同的目的主機測試直連與代理連線;接著以 Git、SSH 或 Homebrew 的最小指令重現原始問題,最後對照 Clash 紀錄中的命中規則、策略群組與連線結果。若一開始同時切換模式、改 DNS、換節點、重設 Git 設定,成功或失敗都很難說明是哪個變更造成。
- 確認連線類型:查看 Git 遠端網址是 HTTPS 還是 SSH,並記下 Homebrew 錯誤訊息指出的下載或更新階段。
- 確認代理端點:核對本機監聽位址、埠號與協定,避免把 HTTP 埠當成 SOCKS 埠,或在容器內誤用主機的 localhost。
- 檢查終端機環境:用
env查看代理變數是否存在;檢查時避免將含有帳密的完整代理網址貼到公開紀錄。 - 查 Clash 紀錄:在原命令執行的同一時間尋找目的主機,確認規則命中與出站策略是否符合預期。
- 辨認服務端回應:逾時、拒絕連線、TLS 錯誤、SSH 認證失敗與 HTTP 權限錯誤各有不同根因,不要用一種修法處理所有症狀。
若需要在團隊中維護設定,建議記錄作業系統、Clash 核心與用戶端版本、代理類型、Git 遠端協定、測試指令,以及已確認的目的主機;不要記錄私鑰、存取權杖或完整帳密。這份出站檢查表比一份未經驗證、越寫越長的網域清單更有用:工具或服務更新時,只需重新驗證有變動的步驟,也能讓同事依照同樣順序重現問題。
有些只針對瀏覽器的代理工具,能讓網頁看似正常,卻無法替 Git 的 SSH 傳輸或 Homebrew 子程序提供一致的出口;單靠修改作業系統代理,也可能漏掉不讀系統設定的命令列工具。Clash 的優勢在於可將終端機代理變數、Git HTTPS 設定、SSH ProxyCommand 與核心規則分開管理,再透過連線紀錄逐項驗證。若你希望依自己的開發環境整理這套工作流,可先選擇相容用戶端,再從最常遇到的 Git 操作開始測試。