認証付きHTTPプロキシ配下でのDockerコンテナ運用
執筆: ProxyV4 エンジニアリングチーム · Updated:
Dockerのプロキシ設定は、どのトラフィックをプロキシ経由にするかという点から始まります。Dockerには3つの独立した経路(実行中のアプリ、docker build、イメージを取得するデーモン)があり、それぞれプロキシの設定場所が異なります。これを適切に設定すれば、ホストのルーティングテーブルを変更することなく、1台のホスト上の各コンテナがそれぞれ独自のProxyV4 IPv4アドレス経由で通信できるようになります。
ENV 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
Dockerがプロキシを読み取る3つの場所
あるスコープで変数を設定しても、他の2つには反映されません。よくあるトラブルとして、docker pullは機能するのにコンテナ内のアプリがホスト自身のIPで通信してしまう、あるいはその逆のケースが挙げられます。
| トラフィック | 設定場所 | 主な用途 |
|---|---|---|
| 実行中コンテナ内のアプリケーション | docker run -e HTTP_PROXY=... またはComposeの environment: ブロック | スクレイピングのリクエスト、API呼び出し、自動化ジョブ |
docker build 実行中のコマンド | --build-arg HTTP_PROXY=http://user:pass@ip:port | RUN ステップでの apt、pip、npm のダウンロード |
| Dockerデーモン自体 | /etc/systemd/system/docker.service.d/http-proxy.conf | レジストリに対する docker pull および docker push |
コンテナごとに異なるIPを割り当て
ランタイム変数は各コンテナの環境に保持されるため、1台のVPSでそれぞれ異なる http://user:pass@ip:port を持つ10個のワーカーを実行することも可能です。これにより、各ワーカーはアクセス先のサイトに対して独自の送信元アドレスを提示でき、ProxyV4の専用IPv4は1社のみに割り当てられるため、他者のトラフィックとアドレスを共有することはありません。
サービスごとに1つの .env ファイル、またはプロキシごとに1つのComposeサービスを用意しておけば、どのIPがどのジョブに属しているかが一目で分かります。更新時も同じアドレスを維持できるため、これらのファイルを変更する必要はありません。
スタックの正常な動作を維持する変数
これらの変更後もdocker pullが直接接続してしまう場合や、コンテナが自身のデータベースにアクセスできない場合は、プロキシが動作しないのページで各Dockerレイヤーを順番に確認できます。
- 大文字の名前(
HTTP_PROXY、HTTPS_PROXY、NO_PROXY)と小文字の名前(http_proxy、https_proxy、no_proxy)の両方を定義してください。ツールやランタイムによって参照する表記が異なります - アプリが呼び出す各Composeサービス名を
NO_PROXYに指定してください(例:NO_PROXY=localhost,127.0.0.1,redis,postgres)。これにより、データベースやキャッシュのトラフィックがプロキシに送信されず、ブリッジネットワーク内にとどまります HTTPS_PROXYにもhttp://スキームを使用してください。クライアントがCONNECTトンネルを開くため、HTTPSサイトの暗号化は維持されますENVを使用してプロキシのパスワードをDockerfileに書き込まないでください。イメージレイヤーに残ってしまいます。実行時に.envやComposeファイルから注入してください
設定手順
- 1
注文情報をプロキシURLに変換する
ProxyV4の注文情報に記載されている
ip:port:user:passを、手動またはproxy format converterを使ってhttp://user:pass@ip:portに書き換えます。 - 2
サービスに環境変数を追加する
docker-compose.yml内のサービスのenvironment:配下に、HTTP_PROXY、HTTPS_PROXY、http_proxy、https_proxy、およびNO_PROXY=localhost,127.0.0.1,redis,dbを設定します。 - 3
コンテナを再作成する
環境変数の変更は新しいコンテナにのみ適用されるため、
docker compose up -dを実行してサービスを再作成します。 - 4
内部からの送信元IPを確認する
docker exec -it <container> curl -s https://proxyv4.com/api/my-ipを実行します。返されるアドレスがホストのものではなく、プロキシのIPになっていることを確認してください。
よくある質問
HTTP_PROXYを追加した後、アプリがRedisやPostgresに接続できなくなりました。なぜですか?
HTTPクライアントが redis や db へのリクエストを外部プロキシに送信してしまい、プロキシ側でそれら内部名を解決できないためです。NO_PROXY(および no_proxy)に NO_PROXY=localhost,127.0.0.1,redis,db のように記載し、コンテナを再作成してください。
1台のサーバー上の各コンテナで異なるプロキシを使用できますか?
はい、可能です。各サービスまたは各 .env ファイルに固有の http://user:pass@ip:port を設定してください。コンテナはホストを共有しながら、個別のIPでインターネットと通信します。
プロキシ変数を大文字と小文字の両方で設定する理由は何ですか?
単一の標準仕様が存在しないためです。libcurl ベースのツールは小文字の http_proxy や https_proxy を読み取り、多くのGoやNodeのツールは大文字の名前を読み取ります。両方を設定しておくことで、イメージ内のあらゆるツールに対応できます。
docker pull はComposeで設定した環境変数を使用しますか?
いいえ、使用しません。イメージの取得はデーモンが行うため、プロキシはコンテナの環境変数からではなく、systemdのドロップインファイル /etc/systemd/system/docker.service.d/http-proxy.conf から読み取られます。
情報源
コンテナごとに独立した専用IPv4を
7か国の容量無制限専用IPv4に加え、米国とベトナムの静的ISPプロキシをご用意。決済完了後に自動発行されます。最低注文数の制限はありません。
シンガポールの最新価格を確認