キャプティブポータルは、空港、カフェ、ホテルなどの公衆 Wi-Fi で使われます。インターネット利用の前に、利用規約への同意や支払いを求めます。ユーザーが Wi-Fi に接続すると、ブラウザーでキャプティブポータルのログインを完了するまで、すべての HTTPS トラフィックがブロックされます。このため、Cloudflare One Client(旧 WARP)は Cloudflare に接続できません。同時に、Cloudflare One Client はデバイス上に ファイアウォールルール を作成し、すべてのトラフィックを Cloudflare へ送ります。そのため、Cloudflare One Client を一時的に切断しないと、キャプティブポータルのログイン画面にアクセスできません。
ユーザーがキャプティブポータル経由で接続できるようにするには、管理者が次のデバイスクライアント設定を構成できます。
- Captive portal detection を有効にします。ネットワーク上のキャプティブポータルを検出すると、Cloudflare One Client が一時的に切断されます。詳細は、キャプティブポータル検出の仕組み と 制限事項 を参照してください。
- Device tunnel protocol を MASQUE に設定します。MASQUE を使うと、クライアントトラフィックは通常の HTTPS トラフィックに見えるため、キャプティブポータルにブロックされにくくなります。
- Lock device client switch を有効にし、Allow admin override codes も有効にします。ユーザーは IT 管理者に連絡し、ワンタイムコードで Cloudflare One Client を手動切断してポータルに接続できます。
- 出張する従業員向けには、Lock device client switch を無効にし、Auto connect の時間を設定します。IT に連絡せずに、ユーザーが Cloudflare One Client を手動切断できます。
Cloudflare One Client が Cloudflare への接続を確立できない場合、次の動作をします。
-
キャプティブポータルタイマーを開始します。
-
Cloudflare のキャプティブポータル URL と、OS およびブラウザー固有のキャプティブポータル URL へ、一連のリクエストを送信します。これらのリクエストは WARP トンネルの外で送信されます。
-
リクエストが傍受されると、Cloudflare One Client はネットワークがキャプティブポータル背後にあると判断し、システムファイアウォール を完全に開きます。ファイアウォールが開いているあいだ、デバイスのトラフィックはすべて Cloudflare One Client をバイパスします。
-
ユーザーがポータルへの接続に成功したあと、またはタイムアウト期間が過ぎたあと、ファイアウォールを再度有効にします。
- キャプティブポータル検出の仕組み のため、従業員がキャプティブポータルを偽装して Cloudflare One Client を切断できる可能性があります。
- 一部のキャプティブポータル、とくに航空会社のものは応答が遅く、キャプティブポータル検出のタイムアウトを超えることがあります。ユーザーが接続しようとすると、CF_CAPTIVE_PORTAL_TIMED_OUT エラーが表示される可能性が高いです。これらのエラーに至る手順の背景は、接続ステータス を参照してください。
- ログイン過程でユーザーを別のネットワークへリダイレクトする多段階キャプティブポータルは、Cloudflare One Client が検出できないことがあります。ユーザーはキャプティブポータルを通過するために、Cloudflare One Client を手動で切断する必要があります。
- 一部の公衆 Wi-Fi は、Cloudflare One Client の実行と互換性がありません。
- すべての DNS トラフィックを傍受するキャプティブポータルは、Cloudflare One Client の DoH 接続 をブロックします。キャプティブポータルへログインしたあと、CF_NO_NETWORK エラーが表示される可能性が高いです。
- HTTPS トラフィックだけを許可するキャプティブポータルは、Cloudflare One Client の WireGuard UDP 接続 をブロックします。キャプティブポータルへログインしたあと、CF_HAPPY_EYEBALLS_MITM_FAILURE エラーが表示される可能性が高いです。
機能の可用性
| クライアントモード | Zero Trust プラン ↗ |
|---|---|
| すべてのモード | すべてのプラン |
| システム | 可用性 | 最低クライアントバージョン |
|---|---|---|
| Windows | ✅ | 2025.4.589.1 |
| macOS | ✅ | 2025.4.589.1 |
| Linux | ❌ | |
| iOS | ❌ | |
| Android | ❌ | |
| ChromeOS | ❌ |
キャプティブポータルログは、Cloudflare Support が Cloudflare One Client のキャプティブポータル問題を調査するために使います。エンドユーザーがキャプティブポータルの問題を報告したら、IT 管理者はユーザーにデバイス上でキャプティブポータルログを収集してもらえます。管理者はそのログを Cloudflare Support のチケットに添付できます。
キャプティブポータルログを取得するには、次の手順に従います。
-
ターミナルウィンドウを開きます。
-
次のコマンドを実行します。
warp-diag captive-portal -
You're currently connected via interface '<INTERFACE>' (<SSID>). Is this interface connected to the network causing issues?と表示されたら、Yes を選んで確認します。
- Cloudflare One Client を開きます。
- Settings(歯車アイコン)> Preferences > Advanced を開きます。
- Collect Captive Portal Diag を選びます。
- Cloudflare One Client は、問題の原因となっている Wi-Fi ネットワークにデバイスが接続している(または接続しようとしている)かを確認します。Yes を選んで確認します。
診断が完了すると、Cloudflare One Client はユーザーのデスクトップに warp-captive-portal-diag-<date>-<time>.zip ファイルを置きます。エンドユーザーはこのファイルを IT 管理者と共有できます。
- 接続ステータス — Cloudflare One Client が接続過程で表示するステータスメッセージと、Cloudflare への安全なトンネルを確立する各段階を確認します。