配置 2026年10月31日

工程師必看:用 Clash 設定 Git、SSH 與 Homebrew 代理工作流

整理工程師常用的 Git、SSH 與 Homebrew 代理設定,帶你檢查 Clash 模式、終端機連線和工具各自的代理行為。無論是拉取程式碼、連回遠端環境,或安裝套件,都能依照工作情境找出較合適的設定與排錯方向。

跨境電商 Amazon 賣家 Shopify

一、先拆開看:Git、SSH 與 Homebrew 不一定走同一條代理

工程師常把「Clash 已啟用」理解成終端機裡的所有程式都會自動走代理,但實際情況取決於應用程式使用的網路方式。瀏覽器通常會讀取系統代理,命令列工具則可能讀環境變數、自己的設定檔,或直接建立網路連線。即使在同一個終端機視窗執行,Git 透過 HTTPS 連線、Git 透過 SSH 連線,以及 Homebrew 下載公式或執行安裝腳本,也可能使用不同的代理設定。

排查時先記下失敗的具體操作,例如 git clone 卡在解析主機、SSH 顯示 Connection timed out,或 brew install 下載途中失敗。接著確認是哪個程序發起連線、目的主機是什麼,以及目前 Clash 使用的是規則模式還是全域模式。這樣才能分辨問題出在規則未命中、終端機未讀到代理、SSH 沒有代理命令,還是遠端服務本身回傳了權限錯誤。

下列埠號與規則名稱皆為範例,請依你的 Clash 設定檔、實際監聽埠和公司政策調整。設定代理不會取代 GitHub、Git 伺服器或內部主機的帳號授權;請勿將存取權杖、私鑰或密碼貼入公開日誌。

二、先確認 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 設定,成功或失敗都很難說明是哪個變更造成。

  1. 確認連線類型:查看 Git 遠端網址是 HTTPS 還是 SSH,並記下 Homebrew 錯誤訊息指出的下載或更新階段。
  2. 確認代理端點:核對本機監聽位址、埠號與協定,避免把 HTTP 埠當成 SOCKS 埠,或在容器內誤用主機的 localhost。
  3. 檢查終端機環境:用 env 查看代理變數是否存在;檢查時避免將含有帳密的完整代理網址貼到公開紀錄。
  4. 查 Clash 紀錄:在原命令執行的同一時間尋找目的主機,確認規則命中與出站策略是否符合預期。
  5. 辨認服務端回應:逾時、拒絕連線、TLS 錯誤、SSH 認證失敗與 HTTP 權限錯誤各有不同根因,不要用一種修法處理所有症狀。

若需要在團隊中維護設定,建議記錄作業系統、Clash 核心與用戶端版本、代理類型、Git 遠端協定、測試指令,以及已確認的目的主機;不要記錄私鑰、存取權杖或完整帳密。這份出站檢查表比一份未經驗證、越寫越長的網域清單更有用:工具或服務更新時,只需重新驗證有變動的步驟,也能讓同事依照同樣順序重現問題。

有些只針對瀏覽器的代理工具,能讓網頁看似正常,卻無法替 Git 的 SSH 傳輸或 Homebrew 子程序提供一致的出口;單靠修改作業系統代理,也可能漏掉不讀系統設定的命令列工具。Clash 的優勢在於可將終端機代理變數、Git HTTPS 設定、SSH ProxyCommand 與核心規則分開管理,再透過連線紀錄逐項驗證。若你希望依自己的開發環境整理這套工作流,可先選擇相容用戶端,再從最常遇到的 Git 操作開始測試。

前往下載 Clash,開始整理工程師代理工作流 →

準備好開始了嗎?

下載相容用戶端,逐步驗證 Git、SSH 與 Homebrew 的代理設定。