プロキシ経由のSSL WRONG_VERSION_NUMBER：解決策

SSL: WRONG_VERSION_NUMBERとは何ですか？

TLSはハンドシェイクレコードから始まります。返ってきたバイトがHTTP応答ならばTLSライブラリはバージョン番号が意味不明と判断し停止します。PythonはWRONG_VERSION_NUMBERを報告し、正確な文言はOpenSSLバージョンとクライアントで異なります。

プロキシURLのスキームはクライアントがプロキシとどう通信するかを決めます。http://はプロキシに対して平文HTTPで接続し、続けてCONNECTトンネルとウェブサイトとのTLSを行います。https://はプロキシ自体とTLS通信を行い、プロキシポートがTLSを期待する場合に機能します。

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

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

• Python requests / urllib3 2.x: SSLError(SSLError(1, '[SSL: WRONG_VERSION_NUMBER] wrong version number')) を ProxyError でラップしています
• httpx: httpx.ConnectError: [SSL: WRONG_VERSION_NUMBER] wrong version number
• curl: curl: (35) ... wrong version number （plain proxy用に-x https://を指定した場合）
• Node.js: エラーメッセージ内のEPROTO ... wrong version number

SSL: WRONG_VERSION_NUMBERの原因は何ですか？

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

• プロキシアドレスの前にhttps://を付け、plain HTTPのポートを使っている。これが最も多い原因です。
• TLSを期待するプロバイダからの設定のコピー&ペースト
• ポート80のhttps://やTLS期待ポートのhttp://などプロキシ以外のURLに使う
• コードが継承するHTTPS_PROXY=https://...のような環境変数

SSL: WRONG_VERSION_NUMBERを段階的に診断するには？

1. コードが使うプロキシURLを表示しスキームを確認してください。
2. 環境にあるHTTPS_PROXYとALL_PROXYを調べてください。
3. 下のcurlテストを-x http://で実行し機能するか確認してください。
4. curlは動くがコードが動かないなら、コードまたは環境がまだhttps://を使っています。

# 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:[email protected]: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

SSL: WRONG_VERSION_NUMBERをどう修正しますか？

• プロキシURLには必ずhttp://を使う： {"http": "http://...", "https": "http://..."}
• TLS検証をオンのままにしてください。修正はスキームでありverify=Falseではありません。
• 環境変数の修正をスクリプト内での上書きではなく行う。

SSL: WRONG_VERSION_NUMBERの後に再試行すべきですか？

このエラーは決して再試行しないでください。同じ方法で必ず失敗します。1文字の設定ミスの修正です。

SSL: WRONG_VERSION_NUMBERはCrawlRelayにどう関係しますか？

CrawlRelayのHTTPポートはHTTPSサイトをCONNECTトンネルで運ぶplain HTTPプロキシポートです。TLSはクライアントとサイト間のトンネル内で終端し、ゲートウェイはhttps://のプロキシURLを必要としません。

ゲートウェイ：gw.crawlrelay.com、ポート7777（HTTP、HTTPSはCONNECT経由）、ポート7778（SOCKS5）。ユーザー名形式：USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}。関連情報：SSL証明書検証失敗 · プロキシに接続できません · Pythonガイド。