認証付きプロキシでcURLを使う:動作確認に役立つコマンド集
執筆: ProxyV4 エンジニアリングチーム · Updated:
cURLをプロキシ経由で実行するには、-xでプロキシのアドレスを、-Uでログイン情報を指定するか、http://user:pass@ip:portのように1つのURLにまとめて指定します。スクレイパーやブラウザプロファイル、cronジョブにProxyV4のIPを組み込む前に、同じマシンからcURLを1度実行するだけで、認証情報が有効か、出口IPが購入したものであるか、往復レイテンシが適切かの3点を素早く確認できます。
curl -x http://user:pass@ip:port https://proxyv4.com/api/my-ip- 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
ダッシュボードの表示からcURLの引数への変換
購入したプロキシ情報は通常ip:port:user:passの形式で提供されます。cURLはこの形式を直接読み込めないため分割が必要です。最初の2項目を-x http://ip:portに、残りの2項目を-U user:passに渡します。http://user:pass@ip:portのように1つのURLにまとめる記法も使えますが、パスワード内に@、:、#などが含まれる場合はパーセントエンコードが必要になるため、スクリプトでは引数を分割する形式の方が安全なデフォルト設定となります。
アクセス先のWebサイトがhttps://であっても、プロキシのスキームにはhttp://のまま指定してください。cURLはプロキシとプレーンなHTTPで通信してCONNECTによるトンネル開設を要求し、そのトンネル経由でターゲットサイトとのTLS通信を行うため、サイト間の通信自体はエンドツーエンドで暗号化が維持されます。
コマンドリファレンス
| 目的 | コマンド | 結果の確認方法 |
|---|---|---|
| 外部から認識されるIPの確認 | curl -x http://user:pass@ip:port https://proxyv4.com/api/my-ip | 出力されたアドレスが自身のIPではなく、プロキシのIPと一致しているか確認 |
| ログイン情報を分けて指定 | curl -x http://ip:port -U "user:pass" https://proxyv4.com/api/my-ip | 同様の結果を出力。特殊文字を含むパスワードでもURLエンコードが不要 |
| ステータス行とヘッダーのみを取得 | curl -I -x http://user:pass@ip:port https://example.com | 2xxまたは3xxの行が返れば、ターゲットがプロキシ経由で応答したことを意味します |
| 接続時間とTTFB(最初の1バイトまでの時間)の計測 | curl -s -o /dev/null -w "Connect:%{time_connect}s TTFB:%{time_starttransfer}s\n" -x http://user:pass@ip:port https://example.com | 秒単位の2つの数値。プロキシ間やロケーション間での比較に利用 |
-vを使ったリクエスト失敗時のデバッグ
-v を追加し、> や < で始まる行を確認してください。正常に実行されると、cURL が Proxy-Authorization ヘッダーを付けて CONNECT を送信し、プロキシが HTTP/1.1 200 Connection established と応答した後に、ターゲットとの TLS ハンドシェイクが行われます。
応答が HTTP/1.1 407 Proxy Authentication Required の場合、プロキシへの接続自体は成功しており、ユーザー名またはパスワードのみが間違っています。407エラーガイドで主な原因を解説しています。cURL が応答をまったく受け取れない場合は到達性に問題があるため、まずはポートチェッカーで IP とポートを確認してください。
curl の終了コードと原因の対応表、および Docker、Selenium、Puppeteer における同様の確認手順については、プロキシが動作しない場合をご覧ください。
Windows、スクリプト、デフォルト設定
- WindowsのPowerShellでは
curlがInvoke-WebRequestのエイリアスとなっており、-xを認識できません。実際のバイナリを呼び出すにはcurl.exeと入力してください - Windows環境では、時間計測コマンドの
-o /dev/nullを-o NULに置き換えてください - cronジョブやシェルスクリプトでは
--connect-timeout 5 --max-time 15を追加し、応答の遅い1つの接続先によって全体の処理が停止しないようにしてください - すべてのcURL呼び出しを同じプロキシ経由にルーティングするには、
~/.curlrcにproxy = "http://user:pass@ip:port"を記述し、テスト完了後に削除してください
設定手順
- 1
シェルを開く
macOSまたはLinuxではターミナル、WindowsではコマンドプロンプトまたはPowerShell(コマンドは
curl.exeを使用)を開きます。 - 2
プロキシ経由で出口IPを確認する
ProxyV4の注文情報に応じた値を指定して
curl.exe -x http://user:pass@ip:port https://proxyv4.com/api/my-ipを実行し、出力されたアドレスがプロキシのIPと一致しているか確認します。 - 3
失敗時はハンドシェイクを確認する
-vを追加して再実行し、CONNECTに対するプロキシの返答を確認します。200はトンネル確立、407は認証拒否を示します。 - 4
自動化向けにコマンドを最適化する
スクリプトに組み込む前に、
--connect-timeout 5 --max-time 15を追加します。
よくある質問
PowerShellでcurl -xを実行するとパラメータエラーになるのはなぜですか?
PowerShellのcurlはInvoke-WebRequestのエイリアスであり、-xオプションが存在しないためです。curl.exe -x http://user:pass@ip:port ...のように実行すれば、Windows標準のcURLが呼び出されます。
cURLで407 Proxy Authentication Requiredと表示されます。プロキシが停止していますか?
停止していません。407はプロキシ自身からの応答であるため、IPとポートには到達できています。-xまたは-Uに指定したユーザー名かパスワードが一致していません。注文内容から再度コピーし、パスワード内の特殊文字に注意して設定してください。
プロキシリスト全体のテストにはcURLをループ実行する必要がありますか?
簡単な死活確認であれば不要です。Webブラウザで使えるプロキシチェッカーなら最大100件のプロキシをパスワード保存なしで一括テストでき、プロキシスピードテストならスクリプト不要でレイテンシを比較できます。
情報源
cURLテストをクリアする専用IPv4プロキシ
1IPにつき1ユーザー限定、帯域制限なし、ユーザー名・パスワード認証対応のHTTP(S)プロキシを7カ国で提供。最新の料金をご確認ください。
プロキシの最新料金を見る