UbuntuとDebianのプロキシ設定ガイド:レイヤー別の完全解説
執筆: ProxyV4 エンジニアリングチーム · Updated:
Linuxにはシステム全体を一括で切り替える単一のプロキシ設定が存在しないため、Ubuntuのプロキシ設定は実質的に4つの設定に分かれます。シェルは環境変数を参照し、APTは専用の設定ディレクトリを読み込み、systemdサービスはユニットのドロップイン設定を使用し、GNOMEデスクトップはgsettingsを利用します。ご自身の環境で必要なレイヤーのみを設定してください。以下の設定例は、ユーザー名とパスワード認証を含むProxyV4のHTTP(S)プロキシを前提としています。
export http_proxy=http://user:pass@ip:port https_proxy=http://user:pass@ip:port- 1 IP$1.85
- 3個以上のIP$1.70
- 10個以上のIP$1.60
- 25個以上のIP$1.50
- 50個以上のIP$1.40
- 100個以上のIP$1.30
- 200個以上のIP$1.20
- 500個以上のIP$1.10
- 1 IP$1.85
- 3個以上のIP$1.70
- 10個以上のIP$1.60
- 25個以上のIP$1.50
- 50個以上のIP$1.40
- 100個以上のIP$1.30
- 200個以上のIP$1.20
- 500個以上のIP$1.10
ユーザー名とパスワードを使用したAPTプロキシ設定
aptで認証付きプロキシを利用するには、プロキシURL内にユーザー名とパスワードを含めた/etc/apt/apt.conf.d/80proxyを作成します。APTはsudoの有無に関わらず実行ごとにこのファイルを読み込み、シェルの環境変数は無視します:
sudo tee /etc/apt/apt.conf.d/80proxy > /dev/null << 'EOF'
Acquire::http::Proxy "http://USER:PASS@IP:PORT/";
Acquire::https::Proxy "http://USER:PASS@IP:PORT/";
EOF
sudo chmod 600 /etc/apt/apt.conf.d/80proxy
# check what APT will use, then try it
apt-config dump | grep -i proxy
sudo apt update各行の末尾にはセミコロンが必要であり、パスワードに@、:、#が含まれる場合はパーセントエンコードする必要があります(@は%40になります)。その後apt updateが407 Proxy Authentication Requiredで停止する場合、ファイル内のログイン情報が間違っています。407エラーのページを参照してください。
SOCKS5プロキシ経由のAPT
最近のAPTリリース(Ubuntu 18.04以降)では、同じキーでSOCKS5のURLも受け入れます(例: Acquire::http::Proxy "socks5h://USER:PASS@IP:PORT";)。注文はSOCKS5またはデュアルモードである必要があり、ベトナムIP(HTTPのみ)は対象外となります。お使いのAPTバージョンがこのスキームに対応していない場合は、上記のHTTP形式を使用してください。
単一コマンドのみでプロキシを適用
設定ファイルを変更せずにテストするには、コマンドラインでオプションを渡します: sudo apt -o Acquire::http::Proxy="http://USER:PASS@IP:PORT/" update。設定内容は保存されません。
どのファイルがどのプログラムを制御するか
Linuxで「プロキシが無視される」という報告の多くは、正しい値を誤った場所に設定していることが原因です。そのほぼすべてが2つのルールで説明できます。sudoはデフォルトでユーザーの環境変数を破棄すること、そしてsystemdサービスは~/.bashrcを一切読み込まないことです。
| レイヤー | 設定場所 | 読み取り対象 | 有効期間 |
|---|---|---|---|
| ログインシェル | ~/.bashrc または /etc/profile.d/proxy.sh | curl, wget, python, git, node | 新しいログインシェルごと |
| PAMセッション | /etc/environment | すべてのユーザーセッション | 再起動後も持続 |
| APT | /etc/apt/apt.conf.d/80proxy | apt update, apt install | APTに対して恒久的に有効 |
| systemdユニット | /etc/systemd/system/<svc>.service.d/proxy.conf | Dockerデーモン、独自のサービス | daemon-reloadおよび再起動後 |
curl、wget、スクリプト用のシェル環境変数
変数は小文字と大文字の両方で定義します。curlやwgetはhttp_proxyを参照しますが、他のランタイムはHTTP_PROXYのみをチェックします。no_proxyリストにより、ループバックやプライベートIPの範囲をプロキシ経由から除外します。
# /etc/profile.d/proxy.sh - shells and CLI tools
sudo tee /etc/profile.d/proxy.sh > /dev/null << 'EOF'
export http_proxy="http://USER:PASS@IP:PORT"
export https_proxy="http://USER:PASS@IP:PORT"
export HTTP_PROXY="http://USER:PASS@IP:PORT"
export HTTPS_PROXY="http://USER:PASS@IP:PORT"
export no_proxy="localhost,127.0.0.1,::1,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16"
export NO_PROXY="$no_proxy"
EOF
source /etc/profile.d/proxy.shここでもパスワード内の特殊文字をパーセントエンコードしてください。APTには上記で説明した専用ファイルがあります。
systemdで管理されるサービス
systemdによって起動されたデーモンは、自身のユニット内で宣言された変数のみを参照します。ドロップインファイルに環境変数を記述し、リロードしてサービスを再起動してください。Dockerガイドでは、Dockerデーモンとコンテナについて詳しく解説しています。
# /etc/systemd/system/<svc>.service.d/proxy.conf
[Service]
Environment="HTTP_PROXY=http://USER:PASS@IP:PORT"
Environment="HTTPS_PROXY=http://USER:PASS@IP:PORT"
Environment="NO_PROXY=localhost,127.0.0.1"
sudo systemctl daemon-reload
sudo systemctl restart <svc>sudo、共有サーバー、デスクトップ環境
- sudo: エクスポートした変数を維持するには
sudo -E curl ...を実行するか、sudo visudoでDefaults env_keep += "http_proxy https_proxy HTTP_PROXY HTTPS_PROXY no_proxy NO_PROXY"を追加して恒久化します。 - マルチユーザー環境での認証情報: これらのファイルにはプロキシのパスワードが平文で保存されます。
sudo chmod 600 /etc/apt/apt.conf.d/80proxyなどを実行してアクセス権限を制限してください。 - GNOMEデスクトップ: 設定 → ネットワーク → ネットワークプロキシ → 手動、または
gsettings set org.gnome.system.proxy mode 'manual'を実行し、さらにorg.gnome.system.proxy.http配下のホストとポートのキーを設定します。
テストとトラブルシューティング
プロファイルを読み込んだ後、curl -s https://api.ipify.orgを実行すると、サーバー自身のアドレスではなくプロキシIPが表示されるはずです。国や所有者の詳細なレポートを確認するには、そのIPをIPルックアップに貼り付けてください。シェル全体にプロキシを適用したくない場合向けに、curlおよびPython requestsのガイドでコマンドごとの代替手段を紹介しています。
- `407 Proxy Authentication Required`: 認証情報の間違い、またはパスワード内の特殊文字がエンコードされていません。407エラーのページを参照してください。
- sudo -Eでのみaptが機能する: 80proxyファイルが存在しないか、構文エラーがあります(各行の末尾はセミコロンで終わる必要があります)。
- 接続がハングする: プロキシポートへの送信アクセスがサーバーのファイアウォールによってブロックされている可能性があります。ファイアウォール関連の原因を確認してください。
設定手順
- 1
APT専用のプロキシファイルを作成する
sudo apt updateはシェルの環境変数を無視するため、Acquire::http::ProxyとAcquire::https::Proxyを設定した/etc/apt/apt.conf.d/80proxyを作成し、apt-config dumpで確認します。
- 2
/etc/profile.d/proxy.shを作成する
あらゆるCLIツールが検出できるように、小文字のhttp_proxy、https_proxy、no_proxyと、大文字のHTTP_PROXY、HTTPS_PROXY、NO_PROXYをエクスポートします。
- 3
必要に応じたsystemdドロップインの追加
プロキシを使用する必要がある各デーモンに対して、Environment行を記述したproxy.confドロップインを作成し、daemon-reloadを実行してサービスを再起動します。
- 4
出口IPアドレスの確認
source /etc/profile.d/proxy.shを実行した後にcurl -s https://api.ipify.orgを実行し、出力がプロキシのIPになっていることを確認します。
よくある質問
http_proxyとHTTP_PROXYの両方を設定する必要はありますか?
はい、必要です。curlやwgetのように小文字を参照するツールもあれば、大文字のみをチェックするツールもあります。両方を設定することで動作の不整合を防ぐことができます。
sudo apt updateでプロキシが適用されないのはなぜですか?
sudoは-Eオプションを付与しない限り環境変数を初期化します。/etc/apt/apt.conf.d/内に専用ファイルを配置することで、APTが環境変数に依存せずプロキシを使用するようになります。
UbuntuデスクトップのGUIでプロキシを設定するにはどうすればよいですか?
「設定」→「ネットワーク」→「ネットワークプロキシ」を開いて「手動」を選択するか、org.gnome.system.proxy配下のgsettingsコマンドを使用して設定します。
Linuxサーバーで固定IPプロキシを利用するメリットは何ですか?
接続先の外部APIや提携先サービスでIP許可リスト(ホワイトリスト)が設定されている場合に不可欠です。専用の固定IPv4であれば更新し続ける限り同一のアドレスが維持されるため、許可リストの再登録が不要になります。
情報源
サーバーおよび自動化スクリプト向け固定IPプロキシ
ユーザー名・パスワード認証対応のHTTP(S)、専用IPv4での無制限帯域、契約更新時も変わらない同一IPアドレスを提供します。
料金を比較する