公式マニュアル・システム別ガイド
Shadowrocket トラブルシューティングガイド
症状からシステム接続、サーバー、サブスクリプション、ルール、DNSの問題を切り分けます。まず現状を記録し、一度に一項目ずつ確認してください。
初めて設定する場合は、まず使い方ガイドでインポート、Global Routingの選択、初回接続までの流れを確認してください。このページは、利用中のサブスクリプションやサーバー情報があり、手順の途中で問題が起きた場合に使います。一度に変更するのは一項目だけにし、結果を確認してから次へ進んでください。最初から再インポートやアプリの再インストールを行うのは避けましょう。
01 / システム接続
スイッチが入らない、すぐに戻る、接続を繰り返す
未接続と、接続済みだが使えない状態を切り分ける
Homeで接続をオンにし、スイッチがオンのままか、システムにVPNの状態が表示されるか、アプリにすぐエラーが出るかを確認します。スイッチが戻る場合は、まずシステムの許可、接続設定、拡張機能の起動を確認してください。スイッチがオンのままなのにWebページを開けない場合は、次の章に進みます。VPNの表示は、システム上で該当するネットワークトンネルが確立したことを示すだけです。接続先サーバーへの到達、ルール、DNS、接続先サービスの正常性までは保証しません。この2種類の症状を混同すると、サーバー設定ばかり変更してシステム側の問題を見落とすことがあります。
初回接続時、iPhone / iPadではVPN構成の追加を求めるシステムダイアログが表示されることがあります。デバイスの所有者が確認し、システムの案内に従って認証してください。以前に要求をキャンセルした場合は、アプリに戻って再度接続し、別の操作でシステムのダイアログが閉じられていないか確認します。管理対象デバイスでは、組織のポリシーによりVPNの追加や変更が制限されることがあります。システムに管理上の制限が表示されていないか確認し、必要に応じて管理者に権限を問い合わせてください。確認のために管理プロファイルを削除したり、組織で保持が必要な接続設定を個人用の設定で上書きしたりしないでください。
設定と接続の競合を最小限の条件で確認する
現在の接続を停止し、選択中のサーバー、Configファイル、Global Routingの状態を記録します。そのうえで、システムのネットワークを制御しているほかのVPN接続を終了してください。システムのVPN設定で古い接続がまだ有効になっていないか確認し、用途が分かる項目だけを切断します。まとめて削除しないでください。次にShadowrocketへ戻り、設定がすべてそろった既存のサーバーを1つ選んで接続します。特定のConfigだけで起動に失敗し、別の保存済みConfigでは正常に起動する場合は、前者の書式、参照関係、最近の変更を優先して確認します。
スイッチが一瞬オンになった後すぐにオフになる場合は、アプリ内で確認できるエラーやログを見て、発生時刻と関連する最新のメッセージを記録してください。Configの解析エラー、認証エラー、ネットワーク切り替えによる再接続では対処方法が異なります。解析エラーの場合は、最近追加した箇所を戻し、区切り文字、空行、途中で切れたテキストを確認します。認証エラーの場合は、サーバー設定の確認に進んでください。ログの古いエラーが今回の原因とは限りません。接続を停止して確認対象を絞り、再現させてから調べることで、過去の記録による誤判定を防げます。
On Demandによる自動動作を確認する
手動でオフにした後、自動的にオンに戻る場合は、On Demandが有効か、現在のネットワークに関係する条件が設定されているかを確認してください。切り分けのため、一時的にOn Demandを無効にし、同じネットワークで手動接続と手動切断を試します。手動操作が正常なら、確認すべきなのはサーバーのパスワードではなく、発動条件です。調査後は必要な条件を戻し、Wi-Fiへの接続、Wi-Fiからの切断、デバイスのスリープ解除をそれぞれ確認します。On Demandによる再接続をスイッチの異常と混同せず、アプリの強制終了でシステム接続を管理しないでください。
アクセス許可、Config、発動条件をすべて確認してから、デバイスの再起動を検討してください。再起動前にエラー情報を保存し、再起動後はネットワーク、サーバー、Configを変えずに確認します。ネットワークも同時に変更すると比較できなくなります。システムのVPN設定が破損していることが明らかな場合は、アプリの設定をバックアップしたうえで、Shadowrocketに属すると確認できた項目だけを削除し、アプリから再作成を要求します。この操作では再度許可が必要です。デバイス管理の制限は再作成しても解除されません。また、保存していない接続情報がシステムによって復元されるとは限りません。
02 / アクセス経路
接続中と表示されるのに、インターネットにつながらない・一部のアプリが使えない
まず接続をオフにした状態のネットワークを確認する
Shadowrocketの接続を停止し、現在のネットワークで普段使うWebサイトを開けるか確認します。基本的なアクセスもできない場合は、Wi-FiでWeb認証が必要か、モバイルデータ通信が使えるか、システムでアプリのネットワーク利用が制限されていないかを確認してください。公衆Wi-Fiの認証ページは接続を切った状態で完了してから、アプリで再テストします。この段階でDNSを変更したり、ルール全体を入れ替えたりしないでください。基本ネットワークが使えないと、上位の問題も同じ原因で起きている可能性があります。変更を重ねるほど、復旧後にどの設定が必要なのか分かりにくくなります。
基本ネットワークが正常なら、既存のサーバーを1つ選び、普段アクセスできて用途の異なるテストページを2つ用意します。接続を切った状態と接続中の状態で、それぞれの結果を記録してください。同じサービスのトップページと画像ドメインだけを試すのは避けましょう。バックエンドを共有している場合があります。また、VPNの表示が出るかどうかを成功の基準にしないでください。すべてのアプリで失敗する場合は、サーバーへの接続とDNSを重点的に確認します。特定のアプリだけが失敗する場合は、そのアプリに関連するドメイン、UDPの利用、システム権限、適用されるルールを調べてください。テスト中は大容量の転送を停止し、症状を明確に保ちます。
Global Routingで条件を限定して比較する
Global RoutingのConfigは設定されたルールに基づいてポリシーを選びます。Proxyは該当する通信を選択中のプロキシ経路へ送り、Directは直接接続の比較に使います。切り分けのために一時的に切り替えても構いませんが、元の設定を記録し、テスト後に戻してください。Proxyは自動修復のボタンではありません。接続先の設定が誤っていれば失敗します。Directでアクセスできても、プロキシ経路自体の異常とは限りません。接続元のネットワークによって接続先サービスの要件が異なる場合もあります。同じ接続先を異なる経路で比較し、どれか一つを常用の正解と決めつけないでください。
| 比較した症状 | 優先して確認する項目 | 次の手順 |
|---|---|---|
| Directは正常、Proxyは失敗 | サーバー、トランスポート、接続先での名前解決 | サーバー設定を変えずにパラメータとログを確認 |
| Proxyは正常、Configは失敗 | ルールの順序とポリシー参照 | 接続先に実際に適用されたルールを特定 |
| どちらも失敗 | 基本ネットワーク、接続先サービス、DNS | 別の接続先で試し、名前解決の段階を確認 |
ルールに戻り、最初に一致した項目を特定
ProxyでアクセスできるのにConfigで失敗する場合は、より前にあるDIRECTやREJECTのルールが接続先に適用されていないか確認してください。ルールは上から順に照合され、最初に一致した時点で後続のルールには進みません。末尾のFINALは、それ以前のルールに一致しなかったリクエストに適用されます。追加したルールがあるかだけでなく、その前に広い範囲を対象とするDOMAIN-SUFFIX、DOMAIN-KEYWORD、IPルールがないかも確認してください。独自のポリシー名を使っている場合は、正しく参照されているか確認します。名前の入力違いをサーバー障害と混同しないようにしてください。
[Rule]
DOMAIN-SUFFIX,ad.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY
この例はルールの順序を示すものであり、利用環境に合った完全なConfigの代わりにはなりません。より具体的な広告サブドメインのルールは、広いドメインサフィックスのルールより前に置き、LANのIP範囲は別途Directにします。FINALは末尾に配置してください。実際のアプリは認証、メディア、APIなど複数のドメインへアクセスする場合があるため、トップページが開いてもすべての依存先が復旧したとは限りません。リクエスト記録を使って失敗した項目を確認し、対象を絞ってルールを修正してください。単一ページの問題を直すためにConfig全体を別のモードに固定するのは避けましょう。詳しくはカスタムルールとFINALの解説をご覧ください。
03 / サーバーとトランスポート
サーバーのタイムアウト、認証失敗、TLSエラー
まずテストで確認できた段階を把握する
Connectivity Testの結果は、選択したテスト方式と合わせて解釈してください。TCP接続が確立できても、その時点で該当のアドレスとポートに到達できたことしか分かりません。認証、TLS、上位層のトランスポート、接続先へのリクエストが成功した証明にはなりません。アプリケーション層のテストが失敗しても、ポートにまったく到達できないとは限りません。テスト方式、使用中のネットワーク、対象サーバーを記録し、実際のWebアクセスと比較してください。異なるテスト方式の数値を単純に並べてサーバーの良し悪しを判断したり、1回のタイムアウトで未検証のサブスクリプション全体を削除したりしないでください。
サーバーを1つ選び、利用中のサービス提供元から案内された情報と順に照合します。プロトコルの種類、アドレス、ポート、認証情報、トランスポート方式、TLSの順に確認してください。コピー時には全角の句読点、前後の空白、改行で途切れた内容に注意します。通常、アドレス欄にサブスクリプションURLのパスやクエリパラメータを混ぜてはいけません。ポートをサーバー名から推測することもできません。同じサブスクリプション内の複数の記録が同じ接続先を使い、すべて失敗する場合は、個別にパスワードを変えるのではなく、共通の接続先とネットワーク条件を先に確認します。1件だけ失敗する場合は、正常な記録を比較用に残してください。
| 項目グループ | 確認する内容 | よくある誤認 |
|---|---|---|
| Shadowsocks | 暗号化方式、パスワード、プラグイン関連の設定 | アドレスとポートが合っていれば設定も完全だと思い込む |
| VMess / VLESS | ユーザー識別情報、トランスポート方式、サーバー側の要件 | 異なるプロトコルの設定を入れ替えて使う |
| Trojan / TLS | 認証情報、Server Name、証明書の有効性 | 接続先アドレスと証明書名を同じ項目だと考える |
| Hysteria2 | 認証、TLS、UDPのネットワーク条件 | TCPで到達できるためQUICも使えると判断する |
証明書名、接続先アドレス、システム時刻を区別する
TLSを使う場合、サーバーの接続先アドレスとServer Nameが異なることがあります。具体的な値は利用中のサーバー設定に基づいて確認し、同じドメインを適当に入力しないでください。WebSocketなどのトランスポートでは、HostやPathもそれぞれ別の役割を持つ場合があります。パスの大文字・小文字、先頭のスラッシュ、サーバー側で指定された値を一致させてください。証明書エラーが出たら、まずシステム時刻が自動設定か、証明書が有効期限内か、名前が一致しているか、現在のネットワークで認証が必要かを確認します。証明書の検証を無効にして名前の不一致を隠さないでください。接続相手の確認が弱まり、根本原因も解決しません。
あるWi-Fiではタイムアウトし、モバイルネットワークでは正常な場合は、サーバー設定を一切変えずに、両ネットワークでポート、UDP、長時間接続がどのように扱われるかを比較します。Hysteria2はQUICをベースとしており、UDPの利用条件に依存します。現在のネットワークでUDPが制限されていると失敗する一方、同じネットワークで通常のWebページは表示できることがあります。その場合は利用中のサービス提供元に接続先のトランスポート要件を確認するか、すでに設定済みの別トランスポートと比較します。プロトコル名だけを別の選択肢に変えても、互換性が得られるわけではありません。
接続先の障害と端末側の誤りを切り分ける
異なるネットワークで同じサーバーの記録が失敗し、同じデバイスの別の既存記録は正常な場合は、そのサーバーのメンテナンス状況、認証情報の有効性、接続先の変更を確認します。クライアントでは、サーバー側で待ち受けていない、証明書設定が誤っている、アカウント権限が変更されたといった問題は修正できません。利用中のサービス提供元に問い合わせる際は、プロトコル、発生時刻、ネットワークの種類、機密情報を伏せたエラー内容を伝えてください。サブスクリプションの完全なURL、パスワード、ユーザー識別情報は送らないでください。「つながらない」だけでは認証とネットワークのどちらに問題があるか判断しにくいため、失敗した段階を記録しておくと、同じリンクを何度もインポートするより役立ちます。
項目を1つ修正したら、再接続して同じ接続先をもう一度テストします。テスト表示の色が変わっただけで完了と判断しないでください。エラーがタイムアウトから認証失敗に変わった場合は、異なる段階まで到達できたことを示します。修正が無効だと決めつけず、新しい情報に基づいて確認を続けてください。手順の詳細はサーバーのタイムアウト、プロトコル設定、システム時刻の確認をご覧ください。
04 / インポートと更新
サブスクリプションをインポートできない・更新に失敗する・内容が不完全
取得に失敗した場合と、内容を解析できない場合を分ける
サブスクリプションのインポートは、応答を取得する段階と内容を認識する段階に分けられます。リクエストのタイムアウト、ドメインの名前解決失敗、証明書エラーは取得段階の問題です。内容を受信できているのに形式を認識しない、記録が空、項目が欠けている場合は、応答内容と形式を確認してください。まず、問題が起きた場所を記録します。Config内のSubscribe、クリップボードからのインポート、Scan QR Codeのどれでしょうか。各方法が対象とするデータは同じではありません。サーバーの共有情報、サーバー一覧のサブスクリプション、完全なConfigファイルは、見た目がリンクに似ていても相互に置き換えられません。
利用中のサービス提供元からサブスクリプションURLをコピーし直し、先頭のスキーム、ホスト名、パス、クエリパラメータがすべて含まれているか確認します。チャットアプリによる改行、末尾の句点、コピー時に抜けた文字にも注意してください。サブスクリプション内のtokenはアクセス認証情報です。完全なURLを公開の質問、スクリーンショット、検索欄に貼り付けないでください。以下は形式を示すだけの例であり、インポートして使うことはできません。利用可能なサービスにも接続されません。QRコードにサブスクリプションではなくアカウントページのURLが含まれている場合、スキャンできてもテキストを読み取っただけで、サーバー設定を取得できたとは限りません。情報の提供元に用途を確認してください。
https://example.com/sub?token=xxxx
ネットワーク経路と応答内容を確認する
手動更新がタイムアウトする場合は、まず基本ネットワークを確認し、現在のネットワークでサブスクリプションのドメインを解決できるか調べます。更新リクエストが通る経路は、アプリの関連設定と実際のログで確認してください。Global Routingの名前だけを見て経路を決めつけてはいけません。「接続には更新が必要だが、更新には接続が必要」という状況でも、リストを消去する前に、以前から使えている記録を残して更新結果を比較します。サービス提供元から明確な更新手順が案内されている場合は、有効な既存の接続先を使って指示に従ってください。認証を壊すおそれがあるため、ドメインを独自に変更したり、クエリパラメータを削除したりしないでください。
応答を受信しても内容を認識できない場合、ログインページ、期限切れの通知、認証ページ、エラーテキストなどが返され、期待したConfigではない可能性があります。ブラウザーでURLを開けても、その内容をインポートできるとは限りません。応答内容を調べる必要がある場合は、自分が信頼できる環境でのみ確認し、認証情報を含む内容をオンライン変換・検査ツールへアップロードしないでください。完全なConfigファイルとして明記されたURLは、Configの管理手順に従って処理します。エラーを消すために、内容が分からないテキストをサーバー一覧として手動で組み立てないでください。
更新後に記録が減る・カスタム設定が消える場合
サブスクリプションの更新では通常、リモート側の内容が基準になります。サービス提供元が削除した項目は残らないことがあり、手動で変更した一部の項目も更新時に上書きされる場合があります。更新前に現在の選択項目、グループ、カスタム項目を記録し、長期保存する手動設定とリモート管理の内容を区別してください。更新後に選択中の記録が消えた場合は、引き続き有効な記録を選び直して接続を確認します。選択先が無効になったための接続失敗を、サブスクリプション全体の破損と判断しないでください。名前が同じでも、アドレス、ポート、トランスポート設定が変わっていることがあります。必要に応じて重要な項目を比較します。
自動更新は失敗するが手動更新は成功する場合は、両方の操作を行ったときのネットワークが同じか確認します。アプリの起動直後、デバイスのスリープ解除直後、Wi-Fiの認証前などは特に注意してください。自動更新は操作の手間を減らすための機能であり、非常に短い間隔で更新して接続を維持するものではありません。サービス提供元からリクエスト頻度の制限が示された場合は、連続操作をやめ、案内に従って時間を置いてください。同じURLを何度もインポートしても、グループや調査時のノイズが増えるだけです。認証情報の期限は延びず、リモート側の応答エラーも修正されません。
05 / パフォーマンスと通信経路
接続できるが遅い・Webページが止まる・動画がバッファリングする
読み込み待ち、転送速度、安定性を分けて確認する
「速度が遅い」には少なくとも3つの症状があります。クリックしてから読み込みが始まるまで時間がかかる、読み込み開始後の転送が遅い、転送中に何度も停止する、の3つです。最初の症状はDNS、接続確立、TLSが関係することが多く、2つ目は利用可能な帯域幅やサーバー負荷を確認します。3つ目はパケットロス、無線ネットワーク、ネットワーク切り替えが原因の可能性があります。まず具体的な症状を一文で記録し、繰り返しテストできるページやファイルを選んでください。1回の遅延テストをスループットと混同したり、小さなリクエストの応答が速いだけで大容量通信も安定していると判断したりしないでください。
比較の前に、システム更新、クラウド同期、ほかのデバイスによる大容量ダウンロードを一時停止し、デバイスの位置とネットワークを変えずにテストします。まず接続を停止した状態で基本ネットワークを確認し、次にサーバーとGlobal Routingの設定を固定して同じ接続先へアクセスしてください。サービスが画質やダウンロード元を動的に変更する場合は、その変化も記録します。短時間に速度テストを繰り返すと通信量が増えるだけでなく、輻輳制御、キャッシュ、接続先のレート制限が後の結果に影響します。適度に間隔を空けて傾向を見れば、最良または最悪の1回だけを選ぶより有意な比較ができます。
変数を一つずつ変えてボトルネックを特定する
接続を切っても遅い場合は、端末のWi-Fi電波、ルーターの負荷、モバイル通信の電波、接続先サービスの状態を優先して確認します。アクセスポイントの近くに移動して改善するなら、無線通信を優先して調べてください。ほかのデバイスも遅い場合は、現在の端末のアプリ設定だけを変更するべきではありません。基本ネットワークが正常で、特定の既存サーバーだけが遅い場合は、同じネットワークで別の既存サーバーと比較し、接続先は変えないでください。比較から分かるのは経路やサーバー間の違いです。1回の結果だけでプロトコル全体の性能を判断することはできません。
同じサーバーでもネットワークによって結果が大きく異なる場合は、ネットワークの種類、発生時間帯、UDP制限の有無を記録します。Hysteria2などのトランスポートにはそれぞれネットワーク上の要件があり、設定が正しくても、すべてのネットワークに適するとは限りません。TCP系のトランスポートも、パケットロス、往復時間、輻輳の影響を受けます。接続数、バッファー、帯域幅の値を根拠なく極端に大きくしないでください。見積もりが誤っていると、キューの増加や通信の不安定化を招く場合があります。設定はサーバー側の案内に基づいて調整し、改善しなかった場合に戻せるよう変更前の値を残してください。
根拠のある問題だけ設定を変更する
Webページの読み込み開始前に止まり、読み込み後の速度は正常な場合は、DNSの章に進んでください。名前解決の失敗後の再試行や、複数の名前解決経路で待ち時間が発生していないか確認します。一部のリソースだけが遅い場合は、それらに実際に適用されたポリシーを調べてください。トップページはプロキシ経由でも、画像やAPIはDirect経由、またはその逆になっている可能性があります。ルールを変更した直後なら、DNSやサーバーも同時に変更せず、最近の変更を一つずつ元に戻して再テストします。ルールの数より、範囲が広すぎて不適切な経路になるルールを優先して確認し、実際に適用された記録に基づいて判断してください。
接続は確立するのに、大きなリクエストが頻繁に止まる場合は、MTUや経路上のフラグメンテーションを次の仮説として検討できます。ただし「Webページが固まる」という症状だけで原因を断定しないでください。まずネットワークを変えても、接続先を変えても再現するか確認し、アプリで選べる設定とサーバー側の要件に従って小さく調整します。ネット上で共有されている固定値を何度も入力しないでください。トンネル、トランスポート、アクセスネットワークによって追加のオーバーヘッドは異なります。変更後に特定の接続先だけが偶然改善し、ほかの接続先で悪化した場合は元に戻し、テスト記録を残して調査を続けます。一時的な結果を恒久設定にしないでください。
接続先の負荷や利用中のサービスの速度制限が原因と考えられる場合、端末側で再接続を繰り返しても通常は解決しません。サービス提供元には、発生時刻、接続先の名称、ネットワークの種類、機密情報を伏せた比較結果を伝えてください。Config全体を送る必要はありません。プロトコルの背景はHysteria2とQUICの解説をご覧ください。技術的な仕組みを確認した後も、調整方針は現在のネットワークでの実測結果に基づいて決めてください。
06 / 名前解決
DNSエラー、ドメインにアクセスできない、ルールの適用先が違う
Webページのエラー表示だけでなく、名前解決の段階を確認する
DNSはドメイン名をIPアドレスに変換しますが、名前解決の後にも接続、TLS、アプリケーションのリクエストなどの段階があります。そのため「ドメインを開けない」からといって、必ずDNSの問題とは限りません。存在しない名前、クエリのタイムアウト、応答されたIPアドレスへの到達不能、証明書名の不一致はいずれもページの表示失敗につながります。まず対象ドメインに対応するリクエストやログを確認し、名前解決の結果が得られているかを見てから、DNS設定を変更してください。ブラウザーの一般的なネットワークエラーだけで、すべてのアクセス失敗をDNSのせいにしないでください。サブスクリプションのドメインとアクセス先のドメインも別々の問題として扱います。
正常に動作することが分かっているドメインと、問題のあるドメインを1つずつ選び、同じネットワークとサーバーで比較します。発生時刻と名前解決段階のメッセージを記録してください。ブラウザーにIPアドレスを直接入力しても、ドメイン名でのアクセスを完全には再現できません。HTTPS証明書、Server Name、Host、コンテンツ配信がドメイン名に依存することがあります。あるIPアドレスから応答があっても、そのネットワーク経路が一部つながることしか分からず、元のドメインのDNS設定に問題がある証明にはなりません。ログインが必要なサービスでは、ログインAPIの名前解決失敗と認証情報の失効も区別してください。
端末、Config、接続先のそれぞれで使われる名前解決経路を確認する
現在のConfigにあるDNS設定を確認し、システムのWi-FiでDNSサーバーが手動指定されているか記録します。組織から提供されたDNS設定や別のネットワーク拡張機能が有効な場合、実際の経路は一つの設定だけで決まるとは限りません。調査のためにシステム設定を一度にすべて削除しないでください。各項目の管理者を確認し、自分で管理できるテストネットワークを使って比較します。アプリ内でDNSを変更した後は、その設定が現在選択中のConfigで有効か確認してください。選択されていないファイルを編集しただけでは反映されません。
暗号化DNSのサービスアドレスにドメイン名が使われている場合、DNSサービスへ接続するための名前解決が先に必要になることがあります。これは確認時に見落としやすい依存関係です。ブートストラップ用の名前解決やアクセス経路が使えない状態では、見た目が長い別のアドレスに変更するだけで解決するとは限りません。設定の提供元の案内に従い、ブートストラップ経路、サービスのエンドポイント、ルーティング要件を確認してください。ログを見て、DNSサービスへの接続前と接続後のどちらで失敗しているかを特定します。サンプルや記事に記載されたアドレスは項目の理解に役立つだけであり、現在のネットワークで使える設定の代わりにはなりません。
ドメインルールとIPルールを合わせて確認する
ドメインルールはリクエストに含まれる、または識別されたドメインと照合します。一方、一部のIPルールは接続先のIPアドレスがすでに分かっている必要があります。IP-CIDRを追加・変更する場合は、追加の名前解決が発生するか、関連する設定が何を意味するかを確認してください。LANへの接続では内部ドメインを使うことがあります。こうした名前はパブリックDNSでは正しく解決できない場合があります。接続後にプリンターや内部サイトが使えなくなった場合は、元々それらが必要としていたLAN内の名前解決とアクセス経路を確認します。対象にパブリックドメインのルールを一つ追加するだけでは解決しません。
[Rule]
DOMAIN,printer.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR6,fc00::/7,DIRECT
FINAL,PROXY
例にあるprinter.example.comは、より具体的なDOMAINルールを広いサフィックスルールより前に置くことを示すためのものです。実際の内部機器のアドレスではありません。IP-CIDR6はIPv6アドレス範囲に対応しており、IPv4のネットワーク範囲で代用できません。ネットワークがIPv4とIPv6の両方を提供している場合、一方のアドレスファミリーで経路に問題があると、別の経路に切り替わるまでリクエストが待たされることがあります。ログに記録されたアドレスファミリーと失敗の順序を確認し、制御できる環境で検証してください。DNSの問題すべてに対して、IPv6全体を恒久的に無効化する方法を使わないでください。
設定を変更したら、再接続してリクエストをもう一度実行します。アプリやシステムのキャッシュにより、古い結果が一時的に残ることがあります。問題のあるドメイン、正常な比較用ドメイン、LAN内の利用先のすべてで確認し、期待どおりに動作した場合のみ変更を維持してください。名前解決が復旧してもアクセスできない場合は、サーバーまたはルールの章に戻って確認し、根拠のないDNS設定を重ねないでください。よく使われる用語は用語集で確認できます。
07 / バックグラウンド動作
バッテリー消費の増加、端末の発熱、接続による頻繁なスリープ解除
実際のバッテリー残量を確認してから、統計の割合を読む
システムのバッテリー統計に表示されるアプリの割合は、選択した期間における電力消費の相対的な内訳です。アプリ単体でバッテリー全体の同じ割合を消費したという意味ではありません。端末全体の消費電力が少ないと、特定項目の割合が高く見えることもあります。観察期間、開始時と終了時の残量、画面の使用状況、ネットワークの種類、充電の有無を記録し、前面での操作と待機中を区別してください。Shadowrocketがシステムのネットワーク経路にあるとき、ほかのアプリによる継続的な通信で関連するネットワーク処理が続くことがあります。一覧にアプリ名があるだけで、異常の原因と断定しないでください。
条件を比較できる待機テストを行います。同じ場所、近い電波強度、同じバックグラウンドタスクを保ち、接続オンとオフの実際の変化を記録してください。モバイル通信の電波が弱い夜間と、安定したWi-Fiでの短時間の待機を直接比較してはいけません。クラウドバックアップ、写真の同期、システム更新、メディアのアップロードはいずれもネットワーク負荷を変えます。一方のテストだけでこうしたタスクが実行されていた場合、その結果からアプリの問題を判断することはできません。極端に長いテストは必要ありません。条件を明確にし、近い条件で再現できることが重要です。
再接続の繰り返しやバックグラウンド処理の頻度を確認する
アプリのログや接続記録で、短時間に切断、再ハンドシェイク、名前解決が繰り返されていないか確認します。電波が弱い、Wi-Fiとモバイル通信が頻繁に切り替わる、接続先から切断される、On Demandの条件が繰り返し成立する、といった状況ではスリープ解除が増えることがあります。まず安定したネットワークで手動接続をテストしてください。再接続が明らかに減る場合は、すべてのセキュリティ確認を弱めるのではなく、ネットワークや発動条件を優先して調整します。Wi-Fiから離れた後にモバイルデータ通信を使用する設定も、意図した状態か確認してください。使えない経路で再試行が続いている可能性があります。
サブスクリプションの自動更新、自動テスト、その他の定期処理を確認し、同じ接続先へのアクセスが短い間隔で繰り返されないようにします。すべての記録を自動テストする場合と、選択中の1件だけをテストする場合では負荷が異なります。特に記録が多く、到達できない接続先が含まれると、待ち時間と再試行が積み重なります。日常的に必要な確認だけを残し、広範囲のテストは調査時に行ってください。サービス提供元が定期更新を求めている場合は、妥当な指示に従います。頻繁に更新しても既存の接続が速くなるわけではなく、オンライン状態の維持にも使えません。
ログ、プロトコル、バックグラウンド通信をそれぞれ確認する
詳細ログは障害を短時間で再現するときに役立ちますが、原因を特定した後も長期間、最大の記録レベルを維持する必要はありません。調査が終わったら通常のレベルに戻し、アプリで提供される方法で古い記録を整理します。問題が起きているときに、証拠をすべて先に消さないでください。今回の問題に関連する少量の情報を保存してから整理します。特定のアプリが通信を続けている疑いがある場合は、プロキシのプロトコルを変更する前に、そのアプリの同期を一時停止して比較します。これにより、クライアントが通信を処理する負荷と、通信元アプリの活動を切り分けられます。
特定のサーバーを使ったときだけ発熱やバッテリー消費が増える場合は、同じネットワークで接続の安定性、再送、トランスポート要件を比較します。ネットワークによってはUDPの処理が原因で再試行が増えることがありますが、特定のプロトコル全体がバッテリーを消費すると決めつけないでください。設定が完了している別の既存記録を使い、同じタスクを維持して比較します。Keep-aliveの値を極端に変更しないでください。間隔が短すぎると通信が増え、長すぎるとネットワーク機器によって接続が切られ、結果として接続の再確立が増えることがあります。
端末が明らかに発熱している場合は、不要な大容量タスクを一時停止し、端末の温度が通常に戻ってから比較を続けてください。充電しながらの操作、ダウンロード、高輝度の画面表示も結果に影響します。接続を停止してもバッテリー消費が異常な場合は、システムのバッテリー統計でほかの動作を確認します。接続をオンにしたときだけ問題を安定して再現できる場合は、最小限のConfig、ネットワークの種類、観察時間、機密情報を伏せたログをまとめ、接続異常の章に沿って確認してください。割合のスクリーンショットより、再現できる条件のほうが診断に役立ち、その後の設定変更が有効かどうかも判断しやすくなります。
08 / 復旧とデバイスごとの違い
アップデート後の異常、機種変更後の復元、iPad固有の確認
アプリの更新とConfigの更新を分けて確認する
「更新後に発生した」というだけでは、アプリの更新が原因とは限りません。まず、同時期に何が変わったかを確認します。アプリの更新、システム更新、サブスクリプションの更新、Configの差し替え、ネットワーク環境の変更などです。現在のConfigを保存して以前のものと比較してください。以前のConfigでは正常で、新しいConfigで異常が起きる場合は、ルール、DNS、ポリシー参照の違いを優先して調べます。以前のConfigでも失敗する場合は、ネットワークとサーバーを比較します。最初にアプリを削除すると、端末内の状態も同時に失われます。項目ごとに比較できた問題が、環境全体を復元する問題に変わるため避けてください。
iPhone / iPadのアプリはApp Storeで管理します。システム要件はApp Storeの掲載内容を確認してください。Mac、Windows、Android、Linuxではダウンロードページから、サイト内の/dl/にあるインストーラーを入手します。Macでは「このMacについて」でAppleシリコンかIntelかを確認してください。初回起動時にシステムが実行をブロックした場合は、WindowsではSmartScreenの「詳細情報 → 実行」を選んで確認後に許可します。Macでは「プライバシーとセキュリティ」で「このまま開く」を選択します。Androidでは配布元を確認してから該当アプリのインストールを許可し、Linuxではパッケージ形式に応じて実行権限を設定します。詳しい手順はインストール時の許可設定をご覧ください。
バックアップの復元時に認証情報や不具合まで引き継がない
再インストールや機種変更の前に、アプリが実際に提供するエクスポート方法でConfig、カスタムルール、必要なサーバー記録を保存します。リストのスクリーンショットだけで済ませず、バックアップを読み取れることも確認してください。バックアップにはパスワード、ユーザー識別情報、サブスクリプションのtokenが含まれる場合があります。自分で管理できる安全な場所に保存し、公開の質問には使わないでください。復元するときは必要最小限の内容からインポートし、既存サーバーを1つ選んで接続を確認してから、ルール、DNS、On Demandを順に戻します。設定を一度にすべて復元して問題が再発すると、原因の特定が難しくなります。
iPhone / iPadで購入済みのユーザーは、購入時のアカウントで購入済み項目を開き、アプリを確認できます。アカウントの地域と購入履歴は、実際のApp Storeの表示を確認してください。正規アプリかどうかは、公式アイコン、開発者名のShadow Launch Technology Limited、アプリID 932747118で判断し、似た名前だけで判断しないでください。価格はiPhone / iPad版がApp Storeで$2.99の買い切り、Mac / Windows / Android / Linux版は無料です。アプリの購入に、利用中のサービス提供元の接続サービスは含まれません。アプリを復元しても、期限切れのサブスクリプション認証情報は自動的に復旧しません。
iPad:同じConfigでもネットワーク環境をあらためて確認
iPhoneでは正常でiPadでは失敗する場合も、タブレット版の違いだと決めつけないでください。2台が本当に同じWi-Fi、同じサーバー、同じConfig、同じGlobal Routingを使っているか確認します。名前が同じ記録でも、最後の更新後に設定が変わっていないか確認してください。モバイル通信機能がないiPadでは、スマートフォンで使ったネットワーク切り替えの比較をそのまま行えません。自分で管理できる別のネットワークや個人用ホットスポットを使ってテストします。公衆Wi-Fiでは2台の認証状態が個別に管理される場合があります。iPhoneで認証済みでも、iPadでの認証が完了したとは限りません。
iPadでは、Split View、アプリの切り替え、画面ロックの後も、システムの接続状態と実際のリクエスト結果で判断してください。Shadowrocketが前面に表示されているかどうかで接続状態を推測しないでください。スリープ解除後にだけ失敗する場合は、解除からネットワーク復旧までの順序を記録し、Wi-Fiが再接続するか、On Demandが発動するか、サーバーが再ハンドシェイクを必要とするかを確認します。まず手動で切断してから再接続してください。復旧する場合は、On Demandの条件とネットワーク切り替えを調べます。画面を点灯し続けたり、アプリを常に前面に表示したりして解決しようとしないでください。
調査後は、日常の利用に必要なGlobal Routing、On Demand、ログレベルに戻し、有効なConfigのバックアップを残してください。同じ症状が再発したら、検証済みの比較条件を再利用してから、次の要因を確認します。
ページ上部の目次に戻る ↑