Playwrightのプロキシ認証:コンテキストごとに1つの固定IPを設定
執筆: ProxyV4 エンジニアリングチーム · Updated:
Playwrightのプロキシは、server、username、passwordを含むproxyオブジェクトで設定します。Playwright自身がプロキシの407認証要求に応答するため、拡張機能やラッパーは不要です。ブラウザ全体に適用する場合はlaunch()で、単一のブラウザプロセス内で分離された各コンテキストに異なるProxyV4のIPを割り当てる場合はnewContext()で設定します。同じキー構成で、Node.jsやPythonからChromium、Firefox、WebKitのすべてに対応可能です。
proxy={ server: 'http://ip:port', username: 'user', password: 'pass' }- 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$2.25
- 3個以上のIP$2.10
- 10個以上のIP$2.00
- 25個以上のIP$1.90
- 50個以上のIP$1.80
- 100個以上のIP$1.70
- 200個以上のIP$1.60
- 500個以上のIP$1.50
proxyオブジェクトの各キー解説
| キー | 設定例 | 説明 |
|---|---|---|
server | 'http://ip:port' | アドレスとポートのみ。この文字列に認証情報を含めないでください |
username | 'user' | ProxyV4のご注文情報に記載されたユーザー名 |
password | 'pass' | プロキシが407を返した際に自動送信されます |
bypass | 'localhost,127.0.0.1' | プロキシを経由させないホストの任意のリスト |
ブラウザ全体とコンテキスト別の設定比較
chromium.launch()にproxyを渡すと、そのブラウザのすべてのページが単一のIPを経由します。これは単一アイデンティティでの単一タスクに適しています。一方、browser.newContext()に渡す方法はマルチアカウント運用の基本構成です。各コンテキストが独自のクッキー、ストレージ、プロキシを保持するため、1つのChromiumプロセス内でそれぞれ異なる出口アドレスを持つ複数のセッションを稼働できます。
ProxyV4の専用IPv4は1名のユーザーのみに割り当てられ、更新時も同じアドレスが維持されます。そのため設定ファイル内でコンテキスト名とIPを静的に紐付けて繰り返し再利用可能です。先週特定IPからアカウントAを認識したWebサイトは、今日も全く同じIPからのアクセスとして認識します。
コンテキストの一貫性を保つポイント
- WindowsやmacOSの一部のPlaywrightおよびChromium構成では、ブラウザ起動時にもプロキシが指定されていないとコンテキスト別プロキシが拒否される場合があります。プレースホルダーとして
proxy: { server: 'http://per-context' }で起動し、各コンテキスト側で上書きしてください newContext()でtimezoneIdとlocaleをプロキシの国に合わせて指定し(例:米国IPならAmerica/New_York、ベトナムならAsia/Ho_Chi_Minh)、時計の時刻やIntlの出力をIPの所在地と一致させます- テキストのみが必要な場合は
page.route()で画像やフォントをブロックすることで、ページの読み込みが高速化されタスクが短時間で完了します - 不要になったコンテキストは閉じます。各コンテキストは個別の接続を開いたまま保持するためです
設定手順
- 1
プロキシ情報の文字列を分割する
ProxyV4のご注文情報にある
ip:port:user:pass形式の行から、server用にip:portを、usernameとpassword用に後ろの2つのフィールドを取り出します。 - 2
プロキシを指定してコンテキストを作成する
const context = await browser.newContext({ proxy: { server: 'http://ip:port', username: 'user', password: 'pass' } })を実行します。 - 3
タイムゾーンと言語を一致させる
同じ
newContext()のオプションに、プロキシの所在地に応じたtimezoneIdとlocaleを追加します。 - 4
IP確認エンドポイントを読み込む
const page = await context.newPage()を開き、https://proxyv4.com/api/my-ipにアクセスして表示されるアドレスがプロキシのIPであることを確認します。同じコンテキストでWebRTCリークテストを実行することも有効な二次チェックです。
よくある質問
Playwrightで「Proxy is only supported when browser is launched with a proxy」というエラーが出ます。解決方法は?
WindowsおよびmacOSでは、Chromiumがコンテキスト別プロキシを受け入れる前に起動時のプロキシ指定を必須とする場合があります。chromium.launch({ proxy: { server: 'http://per-context' } })で起動し、その後各browser.newContext({ proxy })に実際のアドレスと認証情報を渡してください。
同じプロキシ設定はFirefoxやWebKitでも動作しますか?
はい、動作します。proxy: { server, username, password }の構成は3つのエンジンすべて、ならびにNode.jsとPythonの各APIで共通しているため、起動ランチャー(firefox、webkit)を変更するだけで利用できます。
ヘッドレスブラウザの利用で通信量の制限に達することはありますか?
ProxyV4の専用IPv4や固定ISPプランでは心配ありません。どちらのプランもデータ容量無制限のため、読み込み量の多いページでも追加費用は発生しません。
ページが読み込まれず、トンネルエラーで失敗します。どこを確認すべきですか?
serverにhttp://と正しいポートが指定されているか、またダッシュボード上でプロキシが有効状態のままであるかをご確認ください。その他の原因についてはトンネル接続ガイドで詳しく解説しています。
情報源
Playwrightの各コンテキストに専用IPを割り当て
7カ国対応のユーザー名・パスワード認証付きHTTP(S)プロキシ。データ容量無制限、更新時も同じアドレスを維持。
米国の最新価格を確認