言語を変更
日本語 English Русский Deutsch Español Français Italiano Українська Tiếng Việt Türkçe Bahasa Indonesia हिन्दी Português 中文
メニュー
料金
プロキシ
プロキシの種類
ソリューション
リソース

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プロキシのページにあります。

Git とプロキシのよくある質問

プロキシは git@ のリモートにも効きますか?

いいえ。http.proxy が効くのは http と https のリモートです。git@ のリモートは SSH で通信するため、プロキシの設定も SSH 側に別にあります。

特定のホストだけにプロキシを使うにはどうしますか?

キーにホストを含めます。git config --global http.https://example.com.proxy http://HOST:PORT のように指定し、example.com の部分はご自身のホストに置き換えてください。

Git が何を送っているかを確認するにはどうしますか?

コマンドの前に GIT_CURL_VERBOSE=1 を付けて実行します。出力に、プロキシへの CONNECT リクエストが表示されます。

関連ページ