トラブルシューティング

どんな問題も、まず2つの問いに分割してください: トラフィックはそもそもChuteに届いているのか（トラフィック捕捉の問題）、そしてChuteはそれを転送できているのか（転送の問題）。ライブトラフィックビューがこれに答えてくれます — ダッシュボード（iOS）またはメインウィンドウのトラフィックタブ（Mac）を開いてブラウズしてみてください: 何も表示されなければ、Chuteはトラフィックを受け取っていません。接続は表示されるが失敗する場合、Chuteはそれを転送できていません。この2つの問題では修正方法が全く異なります。

何も表示されない: トラフィック捕捉の問題

Chute iOS

• スイッチがオンにならず、設定バーが揺れる — 設定が選択されていません。設定バーをタップし、設定をタップしてチェックマークを付けてから完了をタップしてください（「最初に設定を選択してください」）。
• VPN許可ダイアログを拒否してしまった — もう一度スイッチを切り替えて承認してください。VPNプロファイルが動かなくなった場合（スイッチがすぐに戻ってしまう場合）は、アプリの設定にあるVPN設定をリセットを使ってください。次回の開始時にプロファイルが再作成され、再度許可を求められます。
• 別のVPNアプリが接続中 — iOSは同時に1つのVPNトンネルしか実行しません。もう一方のアプリを切断してください（そのオンデマンドルールも無効にしてください。気づかないうちにトンネルを取り戻すことがあります）。

Chute Mac

• システムプロキシはオンなのに、あるアプリがそれを無視する — 多くのツール（特にターミナルプログラム）はシステムプロキシに従いません。Chuteのリスナーを明示的に指定するか（メニューのCopy Shell Export Commandがシェル用のコマンドを用意してくれます）、ネットワーク層でトラフィックをキャプチャする拡張モードを使ってください。
• 拡張モードが開始できない — ネットワーク拡張またはヘルパーの承認が必要です。正確なシステム設定のパス、「システム拡張がブロックされました」のケース、古くなったVPN構成のリセットについては拡張モードのトラブルシューティングを参照してください。
• LANアドレス宛のトラフィックは設計上Chuteをバイパスします — 捕捉が壊れていると判断する前に、その他オプションのskip-proxyとtun-excluded-routesを確認してください。

接続は表示されるが失敗する: 転送の問題

• 経路を切り分ける。 ポリシーグループをDIRECTに切り替えます: 直接接続ではページが開くのにプロキシ経由では失敗する場合、問題はプロキシサーバーにあります — ホスト/ポート/資格情報/暗号方式の誤り、またはサーバーのダウンです。グループに対してレイテンシテストを実行してください。他のポリシーはテストを通過するのに、あるポリシーだけが一度も通過しないなら、それが原因です。
• 意図しないルールにマッチしている。 ライブトラフィックビューで失敗した接続がマッチしたルールを確認し、ルールの評価順序を読み直してください: ルールは2パスで評価されるため、ホスト名ベースのリクエストでは、後の方にある非IPルールが前の方にあるIPルールより先にマッチすることがあります。no-resolveとFINALの配置が典型的な原因です。
• DNSの応答がおかしい。 DNSセクションを確認してください: 暗号化DNSを使う場合は、DoH/DoTサーバー自体にプロキシなしで到達できることを確認します。サーバーを変更したらDNSキャッシュを消去してください（iOSのコントロールパネルのスイッチ、スクリプトからのflushDNS、またはHTTPコントロールAPIのDELETE /api/dns/cache）。
• UDPに依存するアプリの不調 — 選択したポリシーがUDPリレーをサポートしていることを確認してください（プロキシポリシーの機能マトリクスを参照）。また、TailscaleはICMPを転送しないことも思い出してください。出口ノード経由のpingは応答が返りません。

HTTPS復号が復号してくれない

• CAはインストールされ、かつ信頼されている必要があります — iOSではこれは2つの別々のステップで、2つ目（設定 → 一般 → 情報 → 証明書信頼設定）が最も見落とされがちです。CA証明書のインストールと信頼を参照してください。
• ホストが[MITM]のhostnameリストにマッチしている必要があります — 宣言されたホストだけが復号され、:port/:0サフィックスで指定しない限りポート443のみが対象です。
• 一部のアプリは証明書をピン留めしており、復号されると失敗します — 対抗するのではなく、-プレフィックスでそれらのホストを除外してください。
• QUIC/HTTP-3は復号できません — 互換性のあるクライアントをTCPに戻す方法はblock-quicを参照してください。

ログを読む

上記のセクションで解決しない場合、たいていはログが答えを教えてくれます:

• ログレベルを一時的に上げます: loglevel = verbose（verboseは遅いので、使い終わったら元に戻してください）。
• Chute Mac: メインウィンドウのログタブ。Chute iOS: ダッシュボード、またはHTTPコントロールAPIのGET /api/logs。
• 注目すべきは警告行です: 未知のポリシー、拒否されたオプション、パースできないルールは、設定の読み込み時に全て警告としてログに記録されます。