ネットワークのデバッグ

Chute はプロキシですが、自分のデバイスでプロキシを動かす理由はたいてい経路選択ではありません。すべてのリクエストが、自分の制御下にある場所を通るようになる — それが理由です。だからアプリが実際に何を送っているのかを観察でき、ボディを保存してあとから読み、転送中のリクエストやレスポンスを書き換え、正常なバックエンドを壊れたように見せてアプリの振る舞いを確かめられます。

それぞれの仕組みのリファレンスは本マニュアルの別の場所にあります：HTTPS 復号、モックレスポンス、URL 書き換え、JS スクリプト。このセクションはそれらを実際に使う順に並べ、プラットフォームごとに何が変わるかを示します。

同じカーネルを見る 4 つの窓

動いている Chute は 1 つ、見方は 4 つ。窓を間違えるのが「そこに無い」の典型的な原因です。

コンソールと Dashboard は大きく重なりますが、入り口が違います — コンソールはカーネルが提供しブラウザで開くもの、Dashboard はバイナリチャネルで話す Mac アプリです。どちらも他方の上位互換ではありません。違いは Dashboard が届かないものにあります。

まず 4 つのスイッチを正しく

「接続は見えるのにリクエストが見えない」は、ほぼ必ずこの 4 つのどれかに行き着きます。この順で確認してください：

1. そもそもトラフィックが Chute に届いている。 トラフィックビューに行があることが証拠です。何も無いならデバッグではなく横取りの問題です — トラブルシューティングを参照。
2. CA がインストールされ、かつ信頼されている。 iOS では 2 ステップ、macOS では 1 ステップ、tvOS ではそのどちらもアプリ内では行いません — CA 証明書のインストールと信頼を参照。
3. ホストが MitM リストにある。 Chute は宣言されたホストだけを復号します。メソッドもステータスも無く CONNECT と表示される行は、一度も復号されていません。
4. 記録がオンになっている。 replica = true、またはスイッチ（Mac では Traffic Capture、iOS と tvOS では データダンプ）。オフでも各行はルール・ポリシー・タイミングを持ちます — 欠けるのはペイロードだけです。[Replica] がさらに何を残すかを絞ります。

3 と 4 はコンソールからも Dashboard からも API からも実行時に切り替えられますが、いずれも設定ファイルには書き戻されません。再起動すればファイルの内容が優先されます。

プラットフォームごとにできること

次に読むもの

• Mac から iPhone をデバッグ — まっさらなスマートフォンから Mac 画面上の復号済みボディまで、全行程。
• Mac でのデバッグ — Mac 自身のトラフィック。ターミナルツールやプロセス単位の切り分けを含みます。
• Apple TV のデバッグ — ブラウザも共有シートも無く、自分では証明書もインストールできないデバイス。
• レプリカ — どの接続がボディを保持するか、そして何でもかんでも取得するのをやめる方法。
• モックと障害注入 — 固定レスポンス、エラーステータス、遅延の注入、そして Chute には本当にできないこと。

「何をしているのか」ではなく「動かない」が問いなら、代わりにトラブルシューティングから始めてください。とくに書き換えが効かないのはなぜ？ — このセクションが最も多く生む問いがこれです。