HOWTO · Git
配置代理以使用 Git
在本文中,我們將討論配置 Git 以使用不同代理的過程。
本頁內容
公司防火牆封鎖 Git 流量時,可設定 Git,讓請求透過組織的代理伺服器送出。你可以只為單一命令套用代理、將設定儲存在目前的儲存庫,或為自己的帳戶全域儲存設定。範例使用僅供文件說明的主機名稱和認證資訊;請替換為網路管理員提供的值。
選擇代理協定與設定範圍
HTTP、HTTPS、SOCKS4 和 SOCKS5 代表代理 URL 配置或代理協定選項。目的地 URL 和代理 URL 描述的是不同連線;例如,Git 可以透過 http:// 代理存取 https:// 目的地,兩者不必使用相同協定。
使用 git -c http.proxy=PROXY_URL COMMAND,即可只為單一 Git 命令設定代理。儲存庫本機設定只適用於目前的儲存庫;--global 則會將設定儲存在使用者層級的 Git 設定中,並套用至你的儲存庫。管理員也可能提供系統層級的設定。適用範圍較明確的設定可能會覆蓋較廣泛的設定,因此如果實際行為與預期不同,請檢查目前生效的值。
代理 URL 若含有使用者名稱或密碼,其中的保留字元可能需要進行 URL 編碼。避免在共用命令、指令碼或 shell 歷史記錄中放入實際認證資訊。若有核准的認證輔助程式或組織指定的秘密管理方式,請使用該方式。
設定 HTTP 代理
若只需套用於單次操作,可使用 Git 的 -c 選項加入代理。例如,內嵌命令 git -c http.proxy=http://proxy.example:8080 clone https://git.example/team/project.git 只會對該次 clone 套用代理。請將代理主機和連接埠替換為管理員提供的值。
你也可以使用 URL 專屬索引鍵 http.https://git.example.proxy,只為符合條件的目的地 URL 設定代理。若其他 Git 主機應直接連線或使用不同的代理,這種設定就很實用。URL 模式會依照 Git 的 URL 設定比對規則進行比對,因此請使用你實際存取的目的地協定和主機。
請使用暫存的 Git 設定檔執行此範例。它會儲存一個示範用的 HTTP 代理值,然後讀取該值;不會修改你的儲存庫或使用者設定。
本節中的程式碼以及顯示的標籤或輸出仍為英文。
set -eu
config_file="$(mktemp)"
trap 'rm -f "$config_file"' EXIT
git config --file "$config_file" http.proxy http://proxy.example:8080
git config --file "$config_file" --get http.proxy
為 Git 流量設定 HTTPS 代理
若目的地使用 HTTPS,請針對該目的地設定代理,例如 http.https://git.example.proxy。代理本身仍可使用 http:// URL;這描述的是 Git 到代理的連線,而 HTTPS 描述目的地連線。若代理端點支援 TLS,請使用管理員指定的 HTTPS 代理協定。
若出現 unable to access 'https://...': Unknown SSL protocol error in connection to ...:443 之類的錯誤,這表示代理與目的地連線可能未按預期協商。請先檢查代理協定、主機、連接埠和防火牆政策。若代理會攔截 TLS,請依照環境的文件設定,讓 Git 信任組織提供的憑證授權單位。不要把關閉憑證驗證當成例行修正方式,因為這會失去防範不受信任或遭攔截連線的保護。如果管理員要求你暫時覆寫驗證設定以進行診斷,請將覆寫限制在單一命令,並立即恢復正常驗證。
在 Git 設定中儲存代理設定
若要為目前的儲存庫儲存代理,請在該儲存庫中執行 git config http.proxy http://proxy.example:8080。若要將相同設定儲存為使用者層級設定,並套用至多個儲存庫,請使用 git config --global http.proxy http://proxy.example:8080。這些已儲存的設定會持續生效,直到變更或移除為止。你也可以使用 git config --global http.https://git.example.proxy http://proxy.example:8080 儲存目的地專屬的值。
http.proxy 是 Git 設定索引鍵;--global 則是用來選擇使用者層級範圍的命令列選項。只有單一工作副本需要代理時,請使用儲存庫本機設定;若一般的 Git 工作都需要經由相同網路路由,則可使用全域設定。設定認證資訊前請先詢問管理員,因為設定檔可能會被複製或備份。
檢查及移除代理設定
使用 git config --show-origin --get-regexp '^http\.' 列出與 HTTP 相關的設定及其來源。命令 git config --get http.proxy 只會檢查通用的 http.proxy 值。若要檢查適用於某個 HTTPS 目的地的有效代理設定,請使用 git config --get-urlmatch http.proxy https://git.example,並將 URL 換成你要連線的目的地。若沒有結果,表示這次查詢沒有找到相符的值;其他設定範圍仍可能提供設定。
使用 git config --unset-all http.proxy 移除儲存庫本機代理;使用 git config --global --unset-all http.proxy 移除全域代理。若要移除目的地專屬項目,請將索引鍵替換成實際設定的索引鍵,例如 http.https://git.example.proxy。若你曾加入 SSL 驗證覆寫,也請在相同範圍移除該索引鍵,例如執行 git config --unset-all http.sslVerify 或 git config --global --unset-all http.sslVerify。
移除一個索引鍵不會清除所有代理設定。請再次檢查儲存庫本機和全域範圍,並分別移除任何 URL 專屬項目。--unset-all 會在所選範圍移除該索引鍵的所有值;它不會變更範圍較廣、較窄或系統層級的設定。
在 Git 中設定 SOCKS 代理
若代理服務支援,Git 代理 URL 可使用 socks4:// 或 socks5://。若只需套用於單次操作,可使用類似 git -c http.proxy=socks5://proxy.example:1080 fetch 的命令。若要為使用者儲存通用的 SOCKS5 代理,請執行 git config --global http.proxy socks5://proxy.example:1080;若要針對特定 HTTPS 目的地設定,請使用 git config --global http.https://git.example.proxy socks5://proxy.example:1080。
請根據組織設定的服務和驗證支援情況,選擇 SOCKS4 或 SOCKS5。協定名稱拼法須完全正確,並使用指定的連接埠。如果請求仍繞過代理或無法連線,請檢查產生的 Git 設定。