Node.jsでの認証付きプロキシ利用:Axios・ネイティブfetch・Got
執筆: ProxyV4 エンジニアリングチーム · Updated:
AxiosでNode.jsプロキシを確実に利用するには、proxy: falseとともにHttpsProxyAgentをhttpsAgentとして渡します。Axios標準のproxy: { host, port }設定はHTTP CONNECTトンネルを開かないため、https://のURLで失敗します。またネイティブのfetch()にはundiciのProxyAgentが必要です。このページでは、各クライアントでProxyV4のhttp://user:pass@ip:port URLを使用する方法と、出口IPの確認手順を解説します。
new HttpsProxyAgent('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
利用するHTTPクライアントのスニペットを選択
3つのクライアントはいずれも同一のプロキシURLを使用します。ご注文内容にあるip:port:user:passの文字列からURLを作成してください。クライアントはプロキシとHTTPで通信し、その中でTLSをトンネリングするため、スキームはhttp://のままとなります。
| クライアント | インストール | プロキシ設定コード |
|---|---|---|
| Axios | npm i https-proxy-agent | axios.get(url, { httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port'), proxy: false }) |
ネイティブfetch(Node 18+) | npm i undici | fetch(url, { dispatcher: new ProxyAgent('http://user:pass@ip:port') }) |
| Got | npm i hpagent | got(url, { agent: { https: new HttpsProxyAgent({ proxy: 'http://user:pass@ip:port' }) } }) |
Axiosで`proxy: false`が必要な理由
Axiosは独自にHTTP_PROXYやHTTPS_PROXY環境変数をチェックします。マシン上でこれらが設定されている場合(CIランナーやコンテナで一般的)、エージェントを渡すと2つの設定が競合します。proxy: falseを指定することで、環境変数や組み込みのプロキシ処理を無視するようAxiosに指示し、エージェントのみがリクエストの送信先を制御するようになります。
多数のリクエストでエージェントを再利用する
- リクエストループの外側でプロキシIPごとに1つのエージェントを作成してください。エージェントはkeep-aliveソケットを維持しますが、リクエストごとに新規作成するとそれらが破棄されてしまいます
- 複数のプロキシを使用する場合は、都度エージェントを生成するのではなく、IPからエージェントへの
Mapを保持してそこから取得します - 応答が途絶えたターゲットによってワーカーが無期限に停止しないよう、すべての呼び出しに
timeout(例:Axiosではtimeout: 10000)を設定してください - プロキシリストをデータとして扱いたいですか?プロキシ形式変換ツールを使えば、
ip:port:user:passの行をrequireやimport可能なJSON配列に変換できます
安定したIPがNode.jsジョブにもたらすメリット
ProxyV4の専用IPv4は利用期間全体を通じて1人のお客様にのみ割り当てられ、更新時も同一アドレスを維持します。そのため、そのIPに紐づく許可リスト登録済みAPI、ログインセッション、レート制限枠がデプロイをまたいでも有効に保たれます。帯域幅は無制限であり、長時間のワーカージョブを予測通りに実行できます。クローリングパターンやアクセス間隔の調整については、ウェブスクレイピング活用例をご覧ください。
設定手順
- 1
クライアントとエージェントのインストール
プロジェクト内で
npm install axios https-proxy-agentを実行します(ネイティブfetchを使用する場合はnpm install undici)。 - 2
エージェントを一度作成する
ProxyV4のご注文情報の値を使用して、
const agent = new HttpsProxyAgent('http://user:pass@ip:port');を作成します。 - 3
エージェント経由でリクエストを送信
const res = await axios.get('https://proxyv4.com/api/my-ip', { httpsAgent: agent, proxy: false, timeout: 10000 });を呼び出します。 - 4
IPを確認・比較する
console.log(res.data)にプロキシIPが出力されるはずです。サーバー自体のIPアドレスが出力される場合は、エージェントが適用されていません。
よくある質問
なぜAxiosのproxy: { host, port, auth }はHTTPSサイトで失敗するのですか?
その設定は、最初にHTTP CONNECTトンネルを要求する代わりに通常のHTTPリクエストをプロキシに送信するため、ターゲットへのTLSが正常に確立されません。httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port')を使用し、proxy: falseを設定してください。
Node 18、20、22のネイティブfetch()でプロキシを設定するにはどうすればよいですか?
Nodeのfetchはundiciで動作しているため、undiciからProxyAgentをインポートし、fetch()のオプションの一部として{ dispatcher: new ProxyAgent('http://user:pass@ip:port') }を渡します。
パスワードに@や:が含まれています。URLで問題が発生しますか?
問題が発生する可能性があります。これらの文字はURL内で特別な意味を持つためです。http://user:pass@ip:portを組み立てる前に、encodeURIComponent(password)を使用してパスワードをパーセントエンコードしてください。
リクエストが407を返します。何が問題ですか?
プロキシは応答しましたが、ログインを拒否しました。ご注文情報のユーザー名とパスワードを再確認してください。主な原因については407トラブルシューティングページに記載されています。
情報源
Node.jsワーカー向け固定IPv4
7カ国の専用IPv4および米国・ベトナムの固定ISPを提供。帯域無制限、1つのIPを1人のお客様が専有。1個から複数個まで購入可能です。
米国の最新価格を確認