# 407 Proxy Authentication Required：意味と解決方法

> HTTP 407 Proxy Authentication Requiredは、プロキシが認証情報を拒否したか受け取れなかったことを意味します。Python、curl、Nodeでの正確なエラーメッセージと解決方法。

- URL: https://crawlrelay.com/ja/docs/errors/407-proxy-authentication-required/
- 最終更新: 2026-10-13
- Publisher: CrawlRelay (https://crawlrelay.com)

HTTPステータスコード（4xx、クライアントエラー）：各ツールでの正確なメッセージ、考えられる原因の順序、効果的な修正方法。

**クイックアンサー — プロキシでの407 Proxy Authentication Requiredとは何を意味していますか？**

**407 Proxy Authentication Required** は、認証情報がないか誤っているため、プロキシがリクエストを拒否したことを示します。ターゲットウェブサイトには一切接触していません。CrawlRelayの住宅用プロキシでは、ユーザー名がダッシュボードの表示通りか、パスワードが一致するか、どちらかに特殊文字がある場合はURLエンコードされているかの三点を確認してください。同じリクエストの再試行は407を解決しません。

## 407 Proxy Authentication Requiredを一目で理解する

| 属性 | 値 |
| --- | --- |
| エラー | 407 Proxy Authentication Required |
| タイプ | HTTPステータスコード（4xx、クライアントエラー） |
| 送信元 | プロキシゲートウェイであり、ターゲットのウェブサイトではありません |
| 定義されている場所 | RFC 9110, section 15.5.8 (headers: Proxy-Authenticate 11.7.1, Proxy-Authorization 11.7.2) |
| 再試行しますか？ | いいえ。同じ認証情報では再度失敗します。まずそれらを修正してください |
| まず確認すること | 以下のcurlテストを、ベアユーザー名でターゲット指定パラメータなしで実行してください |

## 407 Proxy Authentication Requiredとは何ですか？

407はプロキシから返されるもので、アクセスしたいサイトからではありません。RFC 9110では、これはプロキシ版の401であり、クライアントはまずプロキシで認証が必要であると説明されています。プロキシは`Proxy-Authenticate`ヘッダーを返し、その方式を示しますが、ほぼ常に`Basic`です。クライアントは`Proxy-Authorization`ヘッダーでBase64エンコードされた`username:password`を返信します。

HTTPSターゲットの場合、407はトンネルを開く`CONNECT`リクエストに対して返ります。そのため、多くのライブラリがこれをトンネルや接続のエラーと報告し、HTTPステータスとは扱いません。ウェブサイトとのTLSセッションは開始されていません。

## a 407はPython、curl、Node.js、ブラウザではどのように表示されますか？

同じ失敗でもツールごとに異なる表示になります。ログ検索用のメッセージは以下の通りです：

- **Python requests:** `ProxyError('Unable to connect to proxy', OSError('Tunnel connection failed: 407 Proxy Authentication Required'))`
- **curl:** `curl: (56) CONNECT tunnel failed, response 407`
- **Scrapy:** `TunnelError: Could not open CONNECT tunnel with proxy ... [{'status': 407, 'reason': b'Proxy Authentication Required'}]`
- **Chrome、Playwright、Puppeteer:** `net::ERR_TUNNEL_CONNECTION_FAILED`、または可視ブラウザのログインポップアップ
- **http://ターゲットでのNode.jsクライアント:** `Request failed with status code 407`

## a 407の原因は何ですか？

最も可能性が高いのは次の通りです：

- **ユーザー名またはパスワードの誤り。** タイプミス、リセット後の古いパスワード、別のサブユーザーの認証情報。
- **エンコードされていない特殊文字。** パスワードに`@`、`:`、`/`、`#`が含まれている場合、`user:pass@host` URLが壊れます。パーセントエンコードしてください：`@`は`%40`に、`:`は`%3A`になります。
- **ターゲティングサフィックスが破損。** ユーザー名でターゲティングを読むゲートウェイは、長い一つのユーザー名として認識します。キーや国コードのタイプミスがあると、プロキシが認識しないユーザー名になります。
- **コードから出ない認証情報。** Chromeは`--proxy-server`内部のユーザー名とパスワードを無視します。Puppeteerには`page.authenticate()`が必要で、Seleniumにはローカルフォワーダーが必要です。
- **残高不足。** トラフィックがまだ残っているか確認してください、コードのデバッグ前に。

## a 407を段階的に診断するには？

1. curlで認証情報をターゲティングなしでテスト（下記コマンド）。詳細出力に`HTTP/1.1 407`行があれば認証情報の問題です。
2. ターゲティングパラメータを一つずつ戻し、それぞれテストを再実行します。
3. プログラムが実際に構築したプロキシURLをパスワードを隠してログに取り、ダッシュボードのものと文字単位で比較します。
4. curlは成功しプログラムが失敗する場合、ライブラリが認証情報を送れていません。以下のツール別対処を参照ください。

*curlで失敗したURLをテストする（HTTPポート、詳細表示）*

```bash
# Use the URL that fails; with https://api.ipify.org instead, you test the gateway alone.
# "HTTP/1.1 200 Connection established" first, then the site's own status: the site answered.
curl -v -x http://USERNAME:PASSWORD@gw.crawlrelay.com:7777 https://TARGET_URL

# Same test through the SOCKS5 port, with DNS resolved at the exit
curl -v --socks5-hostname gw.crawlrelay.com:7778 --proxy-user USERNAME:PASSWORD https://TARGET_URL
```

## a 407をどう修正しますか？

- Pythonでは`urllib.parse.quote(value, safe='')`、JavaScriptでは`encodeURIComponent()`で認証情報をエンコードしてURLを作成してください。
- ブラウザでは、Playwrightの`proxy`オプションに`username`と`password`を渡し、Puppeteerで`page.authenticate()`を呼び出し、Seleniumにはローカルフォワーダーを使います。[Playwright](https://crawlrelay.com/ja/docs/playwright/)とPuppeteer](https://crawlrelay.com/ja/docs/puppeteer/)のガイドもご覧ください。
- 環境変数に`HTTPS_PROXY`を設定する場合は、シェルで全体を引用符で囲み、`@`と`$`が残るようにしてください。
- 漏洩が疑われる場合はダッシュボードでパスワードをローテーションし、関連するすべてのスクレイパーを更新してください。

*Python：エンコードされた認証情報を使ってプロキシURLを作成する*

```python
from urllib.parse import quote

import requests

user = "USERNAME-country-us"
password = "p@ss:word/1"  # example containing special characters

# safe="" also encodes "/", "@" and ":" inside the credentials
proxy = "http://{}:{}@gw.crawlrelay.com:7777".format(
    quote(user, safe=""), quote(password, safe="")
)
proxies = {"http": proxy, "https": proxy}  # http:// for both keys

r = requests.get("https://api.ipify.org", proxies=proxies, timeout=(10, 30))
print(r.status_code, r.text)
```

*Playwright（Python）：認証情報を別々のフィールドにする*

```python
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        "server": "http://gw.crawlrelay.com:7777",
        "username": "USERNAME-country-us",
        "password": "PASSWORD",
    })
    page = browser.new_page()
    response = page.goto("https://api.ipify.org")
    print(response.status, page.inner_text("body"))
    browser.close()
```

## a 407の後に再試行すべきですか？

407を自動で再試行しないでください。認証情報が同じであれば同じ答えが返り、連続したループはログを埋めるだけです。407は設定エラーとして扱い、ジョブを停止して認証情報を修正の上再起動してください。数日間正常だったジョブで突然407が出た場合、パスワードが変わったかサブユーザーが無効化されています。

## 407 Proxy Authentication RequiredはCrawlRelayにどう関係しますか？

CrawlRelayのゲートウェイは新規コネクションごとにユーザー名とパスワードを読み取ります。ターゲティングとセッション設定はユーザー名に存在するため、有効なパスワードでもサフィックスが壊れていると失敗します。ユーザー名はヘルパー関数一つで構築し、起動時に一度出力ログを取ってください。[クイックスタートページ](https://crawlrelay.com/ja/docs/)には正確な書式があります。

ゲートウェイ：`gw.crawlrelay.com`、ポート7777（HTTP、HTTPSはCONNECT経由）、ポート7778（SOCKS5）。ユーザー名形式：`USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}`。関連情報：[401 vs 407](https://crawlrelay.com/ja/docs/errors/401-unauthorized/) · [ERR_TUNNEL_CONNECTION_FAILED](https://crawlrelay.com/ja/docs/errors/err-tunnel-connection-failed/) · [プロキシに接続できません](https://crawlrelay.com/ja/docs/errors/cannot-connect-to-proxy/)。

## 407 Proxy Authentication Required：開発者がよく尋ねる質問

### 407は私がスクレイピングしているウェブサイトから送信されますか？

いいえ。407は常にあなたとウェブサイトの間に介在するプロキシから送信されます。リクエストはウェブサイトに到達していないため、トラフィックを検知したりカウントしたり遮断したりすることはありません。ウェブサイトがログインを望む場合は401を返します。プロキシの認証情報を修正すれば407は消えます。

### curlが同じプロキシで動くのに私のコードはなぜ407になるの？

あなたのライブラリが認証情報を送信していないか、異なる形式で送っています。主な原因は、ブラウザのフラグにタイプされた認証情報が無視されている、特殊文字が失われた環境変数、URLエンコードされていないパスワードです。実際にコードが作成するプロキシURL（パスワードは伏せる）を表示し、curlコマンドと比較してください。

### 407は私のプランのトラフィックを使いますか？

407応答は数百バイトで、リクエストはターゲットに到達しないためページはダウンロードされません。コストがかかるのは別の部分で、407のリトライループに陥ったスクレイパーが時間を浪費しログを埋めます。エラー処理では407を停止点にしてください。

## 他のプロキシエラーのリファレンス

- [401 Unauthorized vs 407](https://crawlrelay.com/ja/docs/errors/401-unauthorized/)
- [403 Forbidden](https://crawlrelay.com/ja/docs/errors/403-forbidden/)
- [407 Proxy Authentication Required](https://crawlrelay.com/ja/docs/errors/407-proxy-authentication-required/)
- [429 Too Many Requests](https://crawlrelay.com/ja/docs/errors/429-too-many-requests/)
- [502 Bad Gateway](https://crawlrelay.com/ja/docs/errors/502-bad-gateway/)
- [503 Service Unavailable](https://crawlrelay.com/ja/docs/errors/503-service-unavailable/)
- [504 Gateway Timeout](https://crawlrelay.com/ja/docs/errors/504-gateway-timeout/)
- [Cannot connect to proxy (ProxyError)](https://crawlrelay.com/ja/docs/errors/cannot-connect-to-proxy/)
- [Connection reset by peer (ECONNRESET)](https://crawlrelay.com/ja/docs/errors/connection-reset/)
- [ERR_PROXY_CONNECTION_FAILED](https://crawlrelay.com/ja/docs/errors/err-proxy-connection-failed/)
- [ERR_TUNNEL_CONNECTION_FAILED](https://crawlrelay.com/ja/docs/errors/err-tunnel-connection-failed/)
- [Read timed out (ReadTimeout)](https://crawlrelay.com/ja/docs/errors/read-timeout/)
- [SOCKS5 proxy errors](https://crawlrelay.com/ja/docs/errors/socks5-proxy-errors/)
- [SSL: CERTIFICATE_VERIFY_FAILED](https://crawlrelay.com/ja/docs/errors/ssl-certificate-verify-failed/)
- [SSL: WRONG_VERSION_NUMBER](https://crawlrelay.com/ja/docs/errors/ssl-wrong-version-number/)

**失敗ケースを網羅したドキュメント付きレジデンシャルプロキシ** $0.50/GB発のCrawlRelayレジデンシャルプロキシ、期限切れがないトラフィック。 [料金を見る](https://crawlrelay.com/ja/pricing/) · [クイックスタート](https://crawlrelay.com/ja/docs/)

---

CrawlRelay: CrawlRelayは開発者第一のレジデンシャルプロキシおよび4G/5Gモバイルプロキシの回転型サービスです：有効期限なしの使った分だけ支払うトラフィックを$0.50/GBから暗号通貨で購入、IDアップロード不要。KYC不要 — IDもセルフィーも書類も不要。暗号通貨で支払い可能。