Git でプロキシを設定する方法
要点: HTTPプロキシ経由にするには git config –global http.proxy http://LOGIN:PASSWORD@HOST:PORT を実行し、SOCKS5なら socks5h://HOST:PORT を使います。対象は http と https のリモートだけで、SSH のリモートには効きません。解除は git config –global –unset http.proxy です。ログイン情報は Git の設定ファイルに平文で保存されます。
Git は http と https のリモートに libcurl で接続するため、プロキシについては curl と同じルールが適用されます。ホスト、ポート、ログイン、パスワードは、ダッシュボードの「マイプロキシ」にある1行の値を使ってください。
すべてのリポジトリに設定する
git config --global http.proxy http://LOGIN:PASSWORD@HOST:PORT
このコマンドは ~/.gitconfig に1行を書き込みます。1つの設定で、http と https の両方のリモートに効きます。設定は git config --get http.proxy で確認できます。
SOCKS5の注文では、まず「プロトコルを変更」で切り替え、あらためて情報をコピーしたうえで、次のように設定します。
git config --global http.proxy socks5h://LOGIN:PASSWORD@HOST:PORT
h を付けると、ホスト名の名前解決をプロキシ側で行います。プロトコルの仕組みは、SOCKS5プロキシのページで説明しています。
特殊文字をエンコードする
ログイン情報はURLの中に書くため、@ は %40、: は %3A、/ は %2F、# は %23、% は %25 と書く必要があります。エンコードしていないパスワードは途中で切れてしまい、プロキシは407を返します。
1つのリポジトリ、または1つのホストだけに設定する
リポジトリの中で --global を外して実行すると、そのリポジトリだけに設定できます。
git config http.proxy http://LOGIN:PASSWORD@HOST:PORT
プロキシを特定のホストに限定するには、キーにホストを含めます。
git config --global http.https://example.com.proxy http://LOGIN:PASSWORD@HOST:PORT
環境変数
Git は、シェルの http_proxy、https_proxy、all_proxy も読み取ります。プロキシを通さないホストの一覧を指定する no_proxy にも対応しています。設定キーがある場合は、そちらが環境変数より優先されます。
どの範囲に設定するか
グローバル設定がいちばん簡単ですが、すべての http と https のリモートがプロキシを経由するため、プロキシから届かない社内サーバーも対象になります。そうなった場合は、プロキシをホスト単位かリポジトリ単位に絞るか、社内ホストを no_proxy に追加してください。プロキシが必要なリモートが1つだけなら、ホスト単位のキーがもっとも安全です。
設定を解除する
git config --global --unset http.proxy
知っておきたいこと
- パスワードは Git の設定ファイルに平文で保存されます。そのファイルは他人に見せず、コミットしないでください。
- SSH のリモート(
git@host:...)ではhttp.proxyは無視されます。 git cloneで407が返ってきた場合は、プロキシがログイン情報を拒否しています。確認項目はプロキシエラー407にまとめてあり、許可リスト方式についてはプロキシ認証に失敗するで説明しています。- プロキシは、適正利用ポリシーで求められているとおり、アクセスする権限のあるリポジトリに対してだけ使ってください。料金プランはISPプロキシのページにあります。
