Linuxサーバーやコンテナ内にはシステムプロキシ設定ダイアログはありません。3つのメカニズムがあり、どれが必要かはソフトウェアの動作次第です。 環境変数(http_proxy、https_proxy、no_proxy)は、curl、wget、pip、apt、git、ほとんどの言語のHTTPライブラリ、そしてDocker自体が尊重しますが、一部のツールは静かに無視します。プロセス単位ラッパー(proxychainsなど)は、ライブラリレベルで単一のプログラムをプロキシ経由に強制します。透過的リダイレクト(iptablesとredsocksなどのヘルパーを使用)は、プログラムが何をしているかに関係なく、ホストまたはコンテナからのすべての送信TCP接続をキャプチャします。このガイドでは、これら3つすべてと、それぞれの落とし穴、結果の確認方法について説明します。

レベル1:環境変数

Linuxより古い慣習:http_proxy / https_proxyが設定されている場合はそれを使用し、no_proxyにリストされているホストはスキップします。

export http_proxy="http://user:pass@proxy.example.com:8080"
export https_proxy="http://user:pass@proxy.example.com:8080"
export no_proxy="localhost,127.0.0.1,::1,.internal,10.0.0.0/8"

curl https://api.ipify.org          # プロキシ経由で送信
curl http://localhost:9000/health   # no_proxyにより直接接続

時間を費やすポイント:

  • 大文字小文字。小文字と大文字(HTTP_PROXY、HTTPS_PROXY、NO_PROXY)の両方を設定します。ツールによって読み取る方が異なります。https_proxyはhttp:// URLを受け取ることに注意してください。これはHTTPS ターゲットのプロキシを指定するもので、プロキシ自体は通常、CONNECTを使用するプレーンなHTTPです。
  • パスワードの特殊文字はパーセントエンコードする必要があります。
  • スコープ。変数は、設定された後にそのシェルで起動されたプロセスに適用されます。systemdで起動されたサービスはシェルの変数を見ません。ユニットのEnvironment=またはEnvironmentFileに配置してください。cronジョブも同様に環境が空です。
  • sudoはデフォルトで環境を削除します。sudo -Eを使用するか、env_keepを設定してください。
  • 無視するもの。Goプログラムは尊重します(net/httpのProxyFromEnvironment経由)。Pythonのrequestsは尊重します。Nodeの組み込みfetchや多くのNode HTTPクライアントは、ヘルパーを使用しない限り尊重しません。Javaは-Dhttp.proxyHost JVMフラグが必要です。データベースやカスタムTCPプロトコルは決して見ません。変数を設定してもプログラムのトラフィックが実際のIPを表示する場合、それはこれらのいずれかです。レベル2または3に移行してください。

パッケージマネージャーには独自の設定がある

# apt
echo 'Acquire::http::Proxy "http://user:pass@proxy.example.com:8080";'  | sudo tee /etc/apt/apt.conf.d/95proxy
echo 'Acquire::https::Proxy "http://user:pass@proxy.example.com:8080";' | sudo tee -a /etc/apt/apt.conf.d/95proxy
# pip
pip config set global.proxy http://user:pass@proxy.example.com:8080
# git
git config --global http.proxy http://user:pass@proxy.example.com:8080
# npm
npm config set proxy http://user:pass@proxy.example.com:8080
npm config set https-proxy http://user:pass@proxy.example.com:8080

レベル1b:Docker固有

Dockerには2つの独立したプロキシスコープがあり、混同するのは典型的なコンテナの間違いです。

デーモン(イメージのプル)

イメージのプルはDockerデーモン(systemdサービス)が行います。シェルの変数は見えません。ドロップインで設定します:

sudo mkdir -p /etc/systemd/system/docker.service.d
cat <<'EOF' | sudo tee /etc/systemd/system/docker.service.d/http-proxy.conf
[Service]
Environment="HTTP_PROXY=http://user:pass@proxy.example.com:8080"
Environment="HTTPS_PROXY=http://user:pass@proxy.example.com:8080"
Environment="NO_PROXY=localhost,127.0.0.1,registry.internal"
EOF
sudo systemctl daemon-reload && sudo systemctl restart docker

コンテナ(アプリケーションからのトラフィック)

コンテナ内のプロセスには独自の環境があります。実行時に変数を渡すか:

docker run -e HTTP_PROXY=http://user:pass@proxy.example.com:8080 \
           -e HTTPS_PROXY=http://user:pass@proxy.example.com:8080 \
           -e NO_PROXY=localhost,127.0.0.1 myimage

または、このクライアントから起動するすべてのコンテナのデフォルトを~/.docker/config.jsonで設定します:

{ "proxies": { "default": {
    "httpProxy":  "http://user:pass@proxy.example.com:8080",
    "httpsProxy": "http://user:pass@proxy.example.com:8080",
    "noProxy":    "localhost,127.0.0.1" } } }

クライアントはこれらをすべてのコンテナの環境(およびビルド)に注入します。コンテナ内でも同じ注意点が適用されます:アプリケーションが変数を尊重するものでなければなりません。Composeでは、サービスごとにenvironment:ブロックを使用し、サービス名で相互に通信するサービスはNO_PROXYに含める必要があります。そうしないと、内部呼び出しがすべてプロキシ経由で外部に出ようとして失敗します。

ビルド

docker buildは~/.docker/config.jsonまたは--build-arg HTTP_PROXY=…からプロキシを取得します。ENVでイメージに資格情報を焼き込まないでください。レイヤー履歴に残り、誰でもプルできます。

レベル2:プロセス単位ラッパー

環境を無視するプログラムには、proxychains(メンテナンス版はproxychains-ng、パッケージはproxychains4)が共有ライブラリをプリロードして、プログラムのソケット呼び出しをインターセプトし、定義したプロキシチェーン経由でルーティングします:

sudo apt install proxychains4
# /etc/proxychains4.conf、末尾に:
#   [ProxyList]
#   http  proxy.example.com 8080 user pass
#   または: socks5 proxy.example.com 1080 user pass
proxychains4 -q ./my-binary --that-ignores-env

設定でproxy_dnsを設定して、ホスト名の解決もプロキシ経由にします(プロキシのテスト方法のDNSリーク問題)。制限:動的リンクされた標準ソケットライブラリを使用するバイナリでのみ機能します。静的にリンクされたGoプログラムや生のソケットを使用するものはすり抜けます。これは一度に1つのプロセス用のツールであり、テストや特定の不正なバイナリに理想的で、ホスト全体には向きません。

同じクラスの代替:tsocks、graftcp(ptraceを使用するため、静的バイナリもキャッチしますが、パフォーマンスコストがかかります)、およびコンテナでこれらのいずれかをエントリポイントとして実行する方法です。

レベル3:iptablesとredsocksによる透過的リダイレクト

ホストまたはコンテナからすべてをプロキシ経由で送信する必要がある場合(設定できないソフトウェアも含む)、カーネルレベルでリダイレクトします。iptablesは送信TCP接続をローカルポートに書き換えることができます。そこに待ち受ける小さなデーモンが各接続をプロキシプロトコルでラップして転送します。redsocksは標準的なデーモンです。

sudo apt install redsocks
# /etc/redsocks.conf
base { log_debug = off; log_info = on; daemon = on; redirector = iptables; }
redsocks {
    local_ip = 127.0.0.1; local_port = 12345;
    ip = PROXY_IP; port = 8080;
    type = http-connect;          # または socks5
    login = "user"; password = "pass";
}
sudo systemctl restart redsocks

# プロキシ自体とローカル/プライベート範囲を除くすべての送信TCPをリダイレクト
sudo iptables -t nat -N REDSOCKS
sudo iptables -t nat -A REDSOCKS -d PROXY_IP -j RETURN
sudo iptables -t nat -A REDSOCKS -d 127.0.0.0/8 -j RETURN
sudo iptables -t nat -A REDSOCKS -d 10.0.0.0/8 -j RETURN
sudo iptables -t nat -A REDSOCKS -d 172.16.0.0/12 -j RETURN
sudo iptables -t nat -A REDSOCKS -d 192.168.0.0/16 -j RETURN
sudo iptables -t nat -A REDSOCKS -p tcp -j REDIRECT --to-ports 12345
sudo iptables -t nat -A OUTPUT -p tcp -j REDSOCKS        # このホスト自身のトラフィック
# このボックスを経由するコンテナ/他のホストからのトラフィックには、PREROUTINGを使用

これを行う前に知っておくべき3つのこと。プロキシ自身のIPのRETURNルールは必須です。これがないと、redsocksのプロキシへの接続自体がredsocksにリダイレクトされ、ボックスがループします。UDPはリダイレクトされません:DNSは、ポート53を信頼できるリゾルバにリダイレクトするか、redsocksのredudpセクションを使用しない限り、直接送信されます。また、QUIC/HTTP/3はプロキシ経由では機能しません(HTTP/3とプロキシを参照)。ただし、クライアントはTCPにフォールバックするため問題ありません。ルールをタイムアウト付きでテストしてください(sudo timeout 60 iptables …は存在しませんが、別のSSHセッションを開いてiptables -t nat -Fを実行できるように準備してください)。間違ったルールはリモートサーバーから切断される可能性があります。

同じパターンは、コンテナ内でiptablesルールを実行する(--cap-add=NET_ADMINが必要)か、よりクリーンに、ホスト上でコンテナのトラフィックを専用のネットワーク名前空間にルーティングすることで機能します。Kubernetesユーザーは、これがサービスメッシュサイドカーがトラフィックをキャプチャする方法とまったく同じであると認識するでしょう。

どのレベルをどの状況で使うか

状況使用理由
スクリプト、CLIツール、パッケージマネージャー、行儀の良いサービス環境変数(+ツール固有の設定)シンプル、元に戻せる、プロセス単位のスコープ
Dockerイメージのプルデーモンのドロップインデーモンには独自の環境がある
コンテナ内のアプリケーション~/.docker/config.jsonまたは-eコンテナの環境に注入される
環境を無視する単一のバイナリproxychains / graftcpソケットレベルでインターセプト。ホスト全体に影響なし
ホストまたは名前空間からのすべてを無条件にiptables + redsocksカーネルレベル。オプトアウト不可
宛先ごとに異なるプロキシPACのようなロジック:env no_proxy、または宛先範囲ごとのiptablesルールターゲットでルーティング

常に検証する

curl -s https://api.ipify.org          # envを尊重:プロキシIPが表示されるはず
curl -s --noproxy '*' https://api.ipify.org   # envをバイパス:レベル3が有効な場合のみプロキシIPが表示される
python3 -c "import urllib.request;print(urllib.request.urlopen('https://api.ipify.org').read())"
dig +short myip.opendns.com @resolver1.opendns.com   # DNSから見たIPは?

2行目が便利なトリックです:--noproxy '*'でcurlは環境を無視するため、それでもプロキシのIPが表示される場合は透過的リダイレクトが機能しています。実際のIPが表示される場合は、環境レベルだけが有効で、非準拠のソフトウェアはリークします。また、DNSを別途確認してください。リゾルバはシステム全体で設定され、上記の3つのレベルではUDPをリダイレクトしないため、サーバーで最も一般的なリークです。

この背後でプロキシタイプを選択するには(サーバー作業にはデータセンター、安定したIDにはISP、ターゲットが要求する場合は住宅用)プロキシタイプの比較を参照してください。Linuxワークロードのプロバイダー側の注意点はLinuxプロキシランキングにあります。

よくある質問

Linuxサーバー全体にプロキシを設定するには?

準拠したソフトウェアには、http_proxy/https_proxy/no_proxyをシステム全体にエクスポートし(例:/etc/environment)、systemdのEnvironment=でサービスを設定します。本当にすべてを対象にするには、iptablesリダイレクトをredsocksに使用します。

Dockerにプロキシを使用させるには?

2か所:デーモン(プル用)はsystemdドロップインでHTTP_PROXYを設定、コンテナは~/.docker/config.jsonのproxiesまたは-e変数で設定します。これらは独立しているため、両方必要な場合は両方設定してください。

プログラムがhttp_proxyを無視するのはなぜ?

すべてのソフトウェアが読み取るわけではありません。Nodeのfetch、Java、データベース、カスタムプロトコルは読み取りません。ツール固有の設定、proxychainsなどのラッパー、または透過的リダイレクトを使用してください。

redsocksとは?

iptablesによってリダイレクトされたTCP接続を受け入れ、HTTP CONNECTまたはSOCKSプロキシ経由で転送するデーモンです。アプリケーションを設定せずに任意のアプリケーションに透過的プロキシを提供します。

透過的リダイレクトはDNSとUDPを処理しますか?

基本的なレシピでは処理しません。TCPのみリダイレクトします。DNSを明示的にリダイレクトするか(またはリゾルバを信頼できるサーバーに向ける)、QUICなどのUDPベースのプロトコルはTCPにフォールバックすることを期待してください。

コンテナはSOCKS5とHTTPプロキシのどちらを使うべきですか?

CONNECT付きのHTTPはHTTPSターゲットをカバーし、環境変数が期待するものです。SOCKS5は非HTTP TCPトラフィックにのみ必要で、その場合はproxychainsまたはredsocksのsocks5モードを使用します。