01 / SETTINGS
Settingsの適用範囲と現在値の確認
サーバー、設定ファイル、アプリ設定を区別する
Shadowrocketの動作は、ひとつのスイッチだけで決まるわけではありません。Homeにはサーバー情報やSubscribeから読み込んだ情報が保存され、Configではルールと関連設定を管理します。Settingsにはアプリ全体の動作やツールの設定があります。さらに、システムのVPN・ネットワーク権限や、接続中のWi-Fi・モバイルネットワークも影響します。問題を調べる際は、変更がどの層に関わるかを最初に確認してください。サーバーアドレスの誤りは情報を、ドメインの接続先が想定と異なる場合はルールを、再接続の自動化はOn Demandを確認します。すべての問題をSettingsのせいにしないようにしましょう。
同じ項目がアプリ設定と設定ファイルの両方に存在することもあります。たとえばDNSは、現在のConfigの設定とシステムのネットワーク環境の両方から影響を受ける可能性があります。Settingsに表示された値だけが、実際の接続で使われているとは限りません。まず現在のGlobal Routing、選択中のサーバー、使用中のConfigを記録し、設定ファイルに関連項目があるか確認してから、アプリ設定を見ます。有効な設定の参照元を特定してはじめて、変更前後を正しく比較できます。
「初期値」と現在画面に表示されている値は別
特定の端末での初期状態を、すべての端末に共通する固定の初期値として扱うことはできません。アプリの更新、以前の設定の移行、サブスクリプションに含まれる設定、バックアップからの復元によって、現在値が異なる場合があります。項目名や選択肢もプラットフォームによって変わることがあります。共通の数値を確認できない項目について、このページでは架空の初期値を示さず、「現在正常に使えている状態を維持する」ことを基本方針とします。画面にリセット項目がある場合は、先にバックアップを取り、リセット前後の違いを記録してください。
基本状態を記録する際は、ネットワークの種類、Global Routing、使用中のConfig名、サーバーのメモ、本来変更する項目をローカルの記録に残すことをおすすめします。共有用の記録には、パスワード、完全なサブスクリプションURL、PrivateKeyなどを書かないでください。テスト前に、もともとアクセスできていた対象をひとつ決め、変更後も同じ対象を使います。ウェブサイト、ネットワーク、サーバーを同時に変更すると、結果が改善しても原因を特定できません。
| 範囲 | 主な内容 | 基本方針 |
|---|---|---|
| Home | サーバー、Subscribe、選択中の項目 | 動作確認済みの情報をひとつ残す |
| Config | ルール、DNS、設定の参照先 | 動作中のファイルを直接上書きせず、複製を編集する |
| Settings | テスト、ログ、同期、ローカルの動作 | 現在の問題に関係する項目だけを変更する |
| システム設定 | VPN、ネットワーク権限、バックグラウンドの条件 | 画面の案内に従って必要な権限を許可する |
変更をいつでも元に戻せるようにする
編集を始める前に、現在のConfigをエクスポートするか複製してください。サーバー情報を変更する場合は、元の情報から復元できることも確認します。Homeの一覧画面を撮影するだけでは、通常すべてのパラメーターを保存できません。続いて変更する項目は一度にひとつに絞り、必要に応じて接続を切ってから再接続し、新しい設定が実際に使われているか確認します。ファイルを編集しても、そのファイルを選択していないと反映されません。ファイル名だけでなく、内容も確認してください。
変更後に問題が起きたら、ほかの設定を次々に追加するのではなく、まず直前に変更した値だけを元に戻します。再テストし、設定を戻したことで問題が解消するか確認できて、はじめて関連性を判断できます。該当する項目が見つからなくても、名前が似た設定を代わりに使えると推測しないでください。まず用語集で意味を確認しましょう。共有端末を管理する場合は、今回の変更がどの接続に影響するかを周囲に伝え、テスト中にほかの人がサーバーや設定を変更しないようにしてください。
02 / ROUTING
Global RoutingとConfigのルールの優先順位
Config・Proxy・Directで変わること
Global Routingは、リクエストを全体としてどう処理するかを決めます。Configでは現在の設定ファイルのルールに従って接続先を決定します。Proxyは、選択中のプロキシ経由でリクエストを処理できるかを一時的に確認する場合に適しています。Directでは、現在のネットワークから直接アクセスした結果を比較できます。この3つは速度の段階ではなく、「グローバル」が最も高機能という意味でもありません。普段ルールで振り分ける場合は通常Configを使い、トラブルの比較時に限りほかの設定へ一時的に切り替えます。テスト後は元の設定に戻してください。
Global RoutingのConfigと、画面下部のConfigページは区別してください。前者はルールに従って処理するかを決め、後者は個々のファイルを管理します。設定ファイルを編集して選択済みでも、Global RoutingがProxyなら、ドメインルールが正しく適用されたかは判断できません。反対にConfigでアクセスできない場合も、すぐにサーバーの問題と決めつけないでください。前にあるDIRECTやREJECTのルールで処理され、想定したProxy経由になっていない可能性があります。
| 説明 / 画面上の表記 | 確認できること | これだけでは確認できないこと |
|---|---|---|
| 設定 / Config | 現在の設定でルールがどう適用されるか確認する | すべてのリクエストが選択中のサーバーを経由する |
| プロキシ / Proxy | 選択中のプロキシ経路が使えるか比較する | Configのすべてのルールが正しい |
| 直接接続 / Direct | 現在のネットワークから直接アクセスした結果を比較する | すべての接続先に直接アクセスするのが適切 |
名前で用途を推測せず、ルールを順番に確認する
ルールは通常、設定ファイルに記載された順序で照合され、最初に一致したルールがリクエストの処理方法を決めます。DOMAINは完全一致のドメイン、DOMAIN-SUFFIXはドメインの末尾、IP-CIDRとIP-CIDR6はアドレス範囲、GEOIPはIPの地理情報データベースによる分類に使われます。FINALは、それまでのルールに一致しなかったリクエストを処理します。DOMAIN-SUFFIXにはプロトコル部分を含む完全なURLや、パス・クエリを含めて指定しないでください。メインドメインとサブドメインを区別するには、まず対象範囲を決めてからキーワードを選びます。
以下は構文と順序の例です。最初のドメインサフィックスに一致したリクエストはPROXYへ、その後GEOIPの条件に一致したリクエストはDIRECTへ、それ以外はFINALで指定されたPROXYへ送られます。すべての利用者に適した完全な設定ではなく、サーバーの認証情報も含みません。GEOIPルールは、名前解決後のアドレスとデータベースの結果に左右されるため、個別のドメインを明示的に判定する用途の代わりにはなりません。リクエストが前のドメインルールと後のアドレスルールの両方に該当する場合、後の方だけを見て順序を無視してはいけません。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
実際のリクエストでルールの適用を確認する
ドメインを調べるときは、まず現在の設定ファイル内で完全なドメイン、上位のサフィックス、関連するルールの参照先を検索し、先に一致する項目がないか確認します。次にテストの条件を整えます。対象のページを閉じてリクエストをやり直し、必要なら切断して再接続し、以前の接続が残っていない状態にしてください。ブラウザーでひとつのページを開いても複数のドメインへリクエストすることがあります。本文が表示されて画像が失敗した場合も、サイト全体にひとつのルールしか適用されていないとは限りません。Logで実際に失敗したホスト名を探し、それぞれ確認してください。
まずは設定ファイルの複製に対象範囲を明確にしたテストルールを追加し、適用を確認してから正式なファイルに反映するか決めてください。ひとつのドメインを直すためにFINALを別の処理方法へ安易に変更すると、ほかのすべての未一致リクエストに影響します。既定の処理方法は現在の設定の用途に照らして確認してください。どんな場合にも正しい汎用の値はありません。ProxyではアクセスできてConfigでは失敗する場合、まず適用ルール、DNS、処理先を比較します。両方で失敗する場合は、サーバー、認証情報、ネットワークを確認してください。
ルールを更新した後は、リモートリソースを取得できたか、設定が再読み込みされたかも確認してください。Subscribeの更新はサーバー一覧の更新であり、Configの更新によるルールの更新とは別です。一覧の更新に成功しても、ルールが反映された証明にはなりません。まず基本的な接続を確認してからルールを調べる場合は、チュートリアルのGlobal Routing手順で基本状態を整えてください。専門的なキーワードは用語集で確認し、日本語のメモからルールの意味を推測しないようにしましょう。
03 / DNS
DNSの名前解決、キャッシュ、リクエスト経路
DNSは名前を解決するもので、すべての通信を直接決めるものではない
DNSはドメイン名を接続可能なアドレスに変換し、接続経路の一部を担います。名前解決に成功しても、接続先ポートへの接続、TLSハンドシェイク、ウェブページの読み込みまで成功したとは限りません。逆に、ページが開かない原因がDNSとは限らず、サーバー認証、誤ったルール、接続先サービスの障害なども考えられます。設定を変更する前に、問題がどの段階で起きているかを確認してください。どんな失敗もDNSサーバーの変更で解決しようとしないようにしましょう。
まず現在のConfigにDNSが明示的に設定されているか確認し、次にSettingsの該当項目を見ます。明確な理由がなければ、現在正常に使えている設定を維持し、特定のパブリックDNSをすべてのネットワークに共通する正解と考えないでください。システムのDNS、手動で指定したDNS、暗号化されたDNSにはそれぞれ利用条件があり、DNSサーバー自体も現在のネットワーク経路から接続できる必要があります。接続できないアドレスを追加すると、もともとひとつのサイトだけだった問題が複数のドメインに広がることがあります。
初期状態と推奨設定を記録する
DNSの初期状態は、現在のインストール環境、Config、システムネットワークに表示されている内容を基準にしてください。記録する際はアドレスだけでなく、システム、アプリ設定、設定ファイルのどこから指定されているかも書きます。複数のアドレスを設定している場合は、順序と関連項目もすべて記録してください。以下の system はシステムDNSを使う設定の書き方を示すもので、すべての端末の初期ファイルにこの行があるという意味ではありません。この例を既存の完全な設定ファイルにそのまま上書きしないでください。特にサーバー情報やルールを削除しないように注意してください。
[General]
dns-server = system
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
トラブルシューティングの基本方針として、まず到達できることを確認済みのDNS設定をひとつ残し、DNS関連の項目を複数同時に変更しないでください。システムDNSから手動設定に切り替える場合は、同じドメイン、ネットワーク、サーバーで再テストし、返されたアドレスが変わったか確認します。アドレスが変わっただけで問題とは限りません。同じサービスでも、場所や負荷に応じて異なる結果を返すことがあります。応答、後続の接続、実際のアクセス結果を合わせて比較して、変更の効果を判断してください。
キャッシュ、IPv6、LAN内の名前
DNSキャッシュは、アプリ、システム、アクセスに使うツールなど、複数の階層に存在する場合があります。設定変更後も古いアドレスが表示されるのは、設定が反映されていないからとは限りません。既存の接続が残っていたり、キャッシュが有効だったりする可能性があります。現在の画面にキャッシュ削除機能がある場合は、古い結果を記録してから使い、再接続して新しいリクエストを送ってください。該当する項目がなければ、隠れた操作を推測しないでください。ページを再読み込みしても以前の接続が再利用される場合があるため、新しい名前解決と接続が行われたかLogで確認しましょう。
IPv4とIPv6の両方のアドレスが返される接続先では、片方にアクセスできただけで全体が正常とは判断できません。ネットワークからIPv6アドレスが返されても接続を安定して確立できない場合や、特定のアドレスファミリーだけが制限される場合があります。実際に接続したアドレスと種類を記録し、同じ条件で比較してください。最初からどちらかのアドレスファミリーを無効にすることを恒久的な対策にしないでください。LAN内のホスト名、ルーターの管理アドレス、組織内のドメインでは、現在のネットワーク専用のDNSが必要かどうかも確認します。
外部DNSに切り替えると、LAN内の名前が正しく解決されないことがあります。これは遠隔サーバーの情報が無効になったことを意味しません。まず元のネットワークに直接接続して名前を確認し、内部向けの通信に適さない経路をルールが選んでいないか調べます。ネットワークのログインページも、システムの名前解決やリダイレクトの条件に依存することがあります。ネットワーク認証が済む前にDNSを大幅に変更しないでください。ネットワークへの接続を完了してからShadowrocketでテストすると、環境の問題と設定の問題を区別しやすくなります。
04 / ON DEMAND
On Demandと接続のライフサイクル
自動接続とルールによる振り分けを分けて考える
On Demandは指定条件に応じて接続を開始する機能で、接続のライフサイクルを管理します。Global Routingは接続後にリクエストをどう処理するかを決めます。両者は別の設定です。On Demandを有効にしても、サーバー情報の誤りは修正されず、ルールによる振り分けも自動作成されません。使い始める前に、手動接続でサーバー、Config、対象へのアクセスが正常に動作することを確認してください。そうしないと、同じ失敗を自動で繰り返すだけになり、原因の特定が難しくなります。
有効かどうかは、現在の端末の画面とシステムのVPN設定で確認してください。特にバックアップから復元した場合や端末を変更した場合は注意が必要です。トラブルの調査中は一時的に手動接続にし、元のOn Demandの状態と条件を記録してから、ネットワークを切り替えてテストすることをおすすめします。手動接続が安定してから、必要な自動接続条件をひとつずつ戻してください。「常に接続中」に見せるためだけに、検証せずすべての条件を有効にしないでください。条件が増えるほど、それぞれの一致関係を把握する必要があります。
ネットワーク切り替え後に再接続することがある理由
Wi-Fiからモバイルネットワークに切り替えると、ローカルアドレス、ルート、利用できるDNSが変わり、既存の接続を再確立する場合があります。接続状態が一時的に変化しても、設定が壊れたとは限りません。まず接続処理が終わるのを待ってから、実際のリクエストを確認してください。ネットワークを切り替えるたびに失敗し、元のネットワークでは安定して使える場合は、自動接続のスイッチだけを変更するのではなく、両方のネットワークからサーバーアドレス、ポート、名前解決の経路に到達できるか比較します。自動接続で試行はできますが、ネットワークの条件自体は変えられません。
ネットワーク名や種類によって接続条件を分けている場合、現在の接続が条件に一致しているか確認してください。名前が似たWi-Fiでも、同じルール範囲とは限りません。また、システムがネットワーク情報をアプリに提供するかどうかは、権限やシステムの動作にも左右されます。テストでは、まず現在のWi-Fiだけで一度確認するなど、対象を明確にしてください。その後、別の既知のネットワークへ切り替えます。各段階で、接続が開始されたか、確立したか、失敗後も再試行されたかを記録しましょう。
- 自動接続を一時的に無効にし、手動接続と実際のアクセスができることを確認します。
- 元の条件を記録し、今回確認するOn Demandの条件だけをひとつ残します。
- ネットワークを一度切り替え、状態が安定してから新しいリクエストを確認します。
- テスト後は元の値に戻し、一時的な条件を普段の設定として残さないようにします。
手動で切断してもすぐ再接続される場合
手動で切断した直後に再接続する場合は、まずOn Demandが有効なままか、システムのVPN設定に対応するオンデマンド動作が残っているか確認します。接続を呼び出す別の許可済み自動化機能がないかも調べてください。再接続を止めようとスイッチを連打すると、短時間に接続と切断の記録が増え、Logを読み取りにくくなります。まず自動接続の原因を止め、それから手動操作を一度だけ行うと、結果を判断しやすくなります。
システムに表示されるVPNの状態は手掛かりになりますが、対象の通信にどのルールが適用されたか、手元のサービス情報が現在も有効かを単独で証明するものではありません。Shadowrocketの接続状態と実際のリクエストも合わせて確認してください。端末のロック、ネットワークの一時的な不通、システムのリソース管理などが接続の状態に影響することがあります。どんな状況でも同じセッションを維持できるとは限りません。長時間の通信が必要な作業では、ページを開いた瞬間だけでなく、ネットワーク切り替え後に復旧するかも確認してください。
ネットワークへのログインが必要なWi-Fiで自動接続に失敗し続ける場合は、まずOn Demandを停止し、システムが求めるネットワーク認証を済ませてから手動接続を確認してください。そのネットワークを離れた後は元の設定に戻します。特定のネットワークだけで問題が起きる場合は、種類と発生した順序を記録するだけで十分です。ネットワーク名や個人の位置情報を公開する必要はありません。普段使いでは用途が明確な最小限の接続条件を残し、端末の変更やConfigの編集後に目的と合っているか定期的に見直してください。
05 / CONNECTIVITY TEST
Ping、Connectivity Test、タイムアウトの判断
似た名前のテストでも、測定対象は異なる
日常会話ではPingを遅延テスト全般の意味で使うことがありますが、アプリ内のテスト内容はそれぞれ異なる場合があります。ネットワーク層の応答確認、サーバーポートへの接続、プロキシ経由でテスト先にアクセスする処理を混同しないでください。Connectivity Testを使う前に、現在の画面でテスト方法と対象の説明を確認します。リストに時間が表示されたからといって、認証、DNS、ルール、ウェブページの読み込みまで確認できたとは限りません。どの層までテストしたかが重要です。
テスト方法、対象、タイムアウトの設定は現在の画面で確認してください。このページでは、未確認の初期値を示しません。現在正常に使えている値を維持し、テスト先に接続できない、応答が遅い、または現在のネットワークに適さないことが明らかな場合にのみ変更してください。テスト先を自分で入力する場合は、自分で検証でき、安定して応答し、ログインが不要な対象を選びます。テストがProxy経由かどうかも確認してください。個人用パラメーター、アクセストークン、一時的な認証情報を含むURLを共通のテスト先にしないでください。
応答時間、通信速度、実際の利用可否を分けて見る
一度の応答が短時間だったからといって、大容量ファイルの転送も必ず速くなるとは限りません。実効速度は回線帯域、混雑、サーバーの制限、接続先の負荷にも左右されます。ページの読み込みには複数のドメインへのリクエストが含まれる場合があります。すでに登録済みのサーバーを選ぶ際は、まず目的のサービスを利用できるか確認し、同じ条件で複数回テストして安定性を比較してください。一度の最小値だけを見て選択を変えたり、テスト結果を長期的な保証とみなしたりしないでください。
| 結果 | 優先して確認する項目 | 次に行う確認 |
|---|---|---|
| テストはタイムアウトするが、実際のアクセスは正常 | テスト先、方法、タイムアウトの設定 | 実際のリクエストは変えずに、別のテスト方法と比較する |
| テストには応答するが、ウェブページは失敗する | 認証、DNS、ルール、接続先サービス | Logで具体的に失敗した接続段階を確認する |
| 特定のネットワークだけで失敗する | サーバーポートとネットワーク経路 | 既知の別ネットワークで同じテストを繰り返す |
| 結果が時々変動する | ネットワーク切り替え、同時通信、接続先の負荷 | 時間を空けて、同じ条件で繰り返し測定する |
タイムアウトしても、サーバーがすでに使えなくなったとは限りません。テスト先が想定どおり応答していない、現在のネットワークからサーバーポートに到達できない、設定したタイムアウトが実際の処理時間より短い、といった可能性があります。まずほかのアクセスも同時に失敗しているか確認し、問題の範囲を特定します。ひとつのテスト方法だけが失敗する場合は、まずテストの仕組みを確認します。すべてのリクエストが失敗する場合は、サーバーアドレス、ポート、パスワードやキー、および端末で接続が確立しているかを確認してください。
再現できる比較テストを行う
一括テストの前に大容量ファイルの転送を停止し、できるだけ同じネットワークに接続した状態で、登録済みの項目を少数選んで確認してください。同時に多数のテストを行うと接続リソースを消費し、端末やネットワークの負荷が結果に影響します。異なるテスト回の結果をそのまま順位付けしないでください。同じ項目を数回続けてテストし、毎回完了するか観察します。最初だけ遅い場合は、接続確立、名前解決、キャッシュが関係している可能性があります。Logで確認してから判断し、すぐにプロトコル設定を変更しないでください。
設定をふたつ比較する場合は、変更前の方法、対象、結果を記録し、一度に変える値をひとつだけにします。テスト中にSubscribeを更新したり、Global Routingを切り替えたり、DNSを変更したりしないでください。テストの後には、同じページを再度開いて主要なリソースの読み込みを待つなど、実際の利用も確認します。テストと実際のアクセスが同じ傾向を示した場合に、日常の選択に役立てられます。結果が食い違う場合は、実際の作業を完了できる設定を維持し、違いの原因を引き続き調べてください。
複数のSubscribeを使っている場合、同じメモが付いた項目でも接続パラメーターが同じとは限りません。テスト前に、対象の項目がどの情報源に属するか確認してください。更新後に項目が重複すると、別のサーバーを比較していると誤解する場合もあります。グループ分け、並べ替え、重複項目の管理については複数のサブスクリプションを管理する方法をご覧ください。このセクションではテスト方法のみを説明しており、数値に基づいてサービスの提供元を評価・推奨したり、テスト一覧をサービス品質の証明として扱ったりするものではありません。
06 / LOG
Log、Data、段階別のトラブルシューティング
対象時間を絞ってからエラーを読む
Logでは接続の過程を確認でき、Dataの通信記録はデータが転送されたかを調べる手掛かりになります。ただし、どちらも合計値だけで特定の接続先へのアクセス成功を証明することはできません。Logの場所や表示項目は現在の画面で確認してください。調べる前に問題が再現した時刻を記録し、テスト操作は一度だけ行います。大量の過去ログが混在すると、バックグラウンドのリクエストのエラーを現在のページの失敗原因と誤認しやすくなります。最初からすべての行を読むのではなく、確認する時間範囲を絞りましょう。
ログの詳細度の初期設定は、現在の画面で確認してください。普段は基本的な診断に必要な設定を維持し、複雑な問題を再現する場合に限って一時的に詳細度を上げることをおすすめします。画面にログレベルの設定がない場合は、説明に合わせて存在しないスイッチを推測しないでください。詳細なログはストレージや処理に負荷をかけるほか、アクセスの状況をより詳しく記録する可能性があります。問題を調べ終えたら元の設定に戻し、プライバシーに配慮して記録を管理してください。実際に必要な範囲を超えて長期間ログを収集しないようにしましょう。
名前解決、接続、認証、アプリの応答を順に確認
まずリクエストが記録されているか確認します。対象の記録が見つからない場合は、アプリが接続中か、対象が既存のセッションを再利用していないか、通信が現在の処理対象になっているかを調べます。続いて対象アドレスを取得できたか、サーバーや対象ポートへの接続が確立したかを確認してください。名前解決の失敗とポート接続の失敗は別の段階であり、対処方法も異なります。timeoutと表示されただけでパスワードの誤りと判断しないでください。接続経路の複数の段階でタイムアウトする可能性があります。
認証に失敗した場合は、手元にあるサーバー情報に戻り、プロトコル、ポート、パスワードまたはキー、暗号化パラメーター、必要に応じてTLSと転送の設定を確認してください。あるプロトコルの項目を別のプロトコルにそのまま流用しないでください。接続は確立しているのにTLSで失敗する場合は、サーバーが要求する名前、証明書の有効性、端末の時刻を確認します。検証を無効にすることを汎用の修正方法にしないでください。接続先のアプリケーション層からエラー応答が返っている場合は、接続先の権限やサービスの状態をさらに確認します。
[Rule]
DOMAIN,example.com,PROXY
FINAL,DIRECT
上記の範囲を限定したルールは、設定ファイルの複製で比較するためのものです。完全一致のドメインだけをPROXYに送り、それ以外はFINALで処理します。このルールは、対象サイトが利用する可能性のあるサブドメインを含まず、完全なトラブルシューティング用設定でもありません。メインページと静的リソースで接続先が異なる場合、Logには複数のホスト名が表示されるため、それぞれ確認してください。調査後は一時ルールを削除するか元のファイルに戻し、テスト用のFINALが普段のリクエスト経路を変えないようにします。設定を保存するだけでなく、その設定を実際に使用していることも確認してください。
Logを共有・相談に使える再現情報にする
問題の記録には、端末のプラットフォーム、ネットワークの種類、Global Routing、現在のConfigの用途、失敗した操作、実施済みの比較テストを含めます。バージョンはアプリ内で確認し、実際に表示された値を使って報告してください。古い記事から転記しないでください。エラー文は可能なら原文と前後の情報を残しますが、共有前に完全なサブスクリプションURL、認証項目、個人のドメイン、ネットワーク名などの機密情報を削除してください。パスワードを隠しても、トークン付きのリンクが残っていればアクセス権が漏れる可能性があります。
Configで一部の接続先にアクセスできる場合は、成功したリクエストと失敗したリクエストのルール適用結果やアドレスの種類を比較します。特定のサーバーだけが失敗する場合は、元の情報と一致しているか確認してください。ひとつのネットワークですべての項目が失敗し、別のネットワークでは正常な場合は、ネットワーク経路を優先して調べます。このように切り分ければ原因を絞り込めます。一方、何度も再インストールしたり、すべての設定を削除したり、複数の項目を同時にリセットしたりすると、有用な手掛かりが失われ、元に戻せる状態まで復元できなくなる場合があります。
トラブルシューティングの最後に回帰テストを行います。ログレベルと一時ルールを元に戻し、以前正常に使えていた接続先にアクセスできること、On Demandにテスト条件が残っていないこと、異常な再接続が続いていないことを確認します。原因の説明は、「ネットワークを切り替えるとポート接続が復旧した」のように観察した事実に基づけてください。「設定を直した」とだけ説明しないようにしましょう。根拠が足りない場合は不確実性を残し、再現時の記録を追加してください。一度だけ偶然成功した結果を、いつでも使える解決策として記載しないでください。
07 / BACKUP
iCloud同期、Configのバックアップ、端末間の移行
同期は過去の状態を個別に保存するバックアップではない
iCloud同期を使うと、条件を満たす端末間でアプリが対応するデータを転送できます。ただし、対応するデータは現在の画面と実際の復元結果で確認してください。サーバー、ルール、ログ、システム権限がすべて同期されるとは限りません。また、同期は任意の過去の状態にいつでも戻せる機能でもありません。削除や誤った変更が同期を通じて反映されることがあります。Configを大きく整理する場合、項目をまとめて削除する場合、端末を変更する場合は、別途エクスポートして独立して保存し、ファイルを読み取れることも確認してください。
同期の状態はアプリ内の設定、システムのiCloud権限、アカウントの状態を個別に確認してください。端末でアカウントにサインインしていても、Shadowrocketの同期が完了しているとは限りません。まず正常に使えている端末には手を加えず、別の端末で期待したデータが表示されるか確認してから設定を変更します。特定の機能が一部のプラットフォームでしか使えない場合は、そのプラットフォーム上の実際の操作方法に従ってください。特にプラットフォーム間の移行では、あるシステムのクラウド同期をすべてのプラットフォームで使えるファイル転送方法とみなさないでください。
ルール、サーバー情報、設定の記録を分けてバックアップ
Configファイルには主に設定内容が保存されますが、サーバー情報やリモートリソースを参照しているだけで、必要な情報がすべて含まれていない場合があります。エクスポート前にファイルを開き、ルール、DNSパラメーター、リソース参照、認証情報のどれが含まれるか確認してください。ファイルをひとつ保存しただけではバックアップが完全とは限りません。SubscribeのURLだけを保存しても、後から必ず内容を取得できるとは限りません。元の情報はご自身で安全に保管し、実際の認証情報を公開メモや共有フォルダーに書かないようにしてください。
端末の移行準備は3つに分けることをおすすめします。1つ目は現在使えるConfigの複製、2つ目はすでに登録したサーバー情報を再登録するための資料、3つ目はGlobal Routing、On Demand、テスト方法、ローカルポートの用途などアプリ設定の記録です。エクスポートしたファイルは管理された場所に保存し、ファイル名には用途を書いても、パスワードやサブスクリプショントークンは含めないでください。機密情報を含むバックアップを不用意にほかの人へ送ったり、公開クラウドストレージのリンクを長期保管に使ったりしないでください。
- 旧端末で接続が使えることを確認してからConfigをエクスポートし、ファイルの内容を確認します。
- すでに登録したサーバーとSubscribeを復元できる元の情報があるか、別途確認します。
- 新しい端末に読み込んだ後、Config、Global Routing、使用するサーバーを選び直します。
- 実際のアクセスと自動接続をテストしてから、旧端末と重複ファイルを整理します。
同期の競合と新しい端末での復元確認
2台の端末で同じ設定ファイルを同時に編集すると、変更が上書きされたり、どちらが新しい複製か分かりにくくなったりする場合があります。作業を始める前に両方のファイルを保存し、ルール、リソースの参照先、重要な設定を比較して、どちらを元にするか決めてください。ファイル名が同じだけで内容まで同じと判断せず、同期が完了する前に削除と再作成を繰り返さないようにしましょう。まず一方の端末だけを編集用にし、もう一方では一時的に変更を止めます。結果を確認してから再開すれば、変更元を追跡しやすくなります。
復元後はOn Demandを急いで有効にせず、まず手動で接続します。新しい端末では通常、システムのVPN許可を再確認する必要があります。LANへのアクセスなど、ほかのシステム権限も画面の案内に従って確認してください。次に、Global Routingが元の用途に合っているか、正しいConfigが選ばれているか、サーバーが有効な情報を参照しているかを確認します。ルールがリモートリソースを参照している場合は、リソースを取得できることも確認してください。ファイルが一覧に表示されても、外部の参照先を含むすべての要件が整ったとは限りません。
旧端末では使えて新しい端末では失敗する場合、同期の破損とすぐに決めつけず、項目をひとつずつ比較してください。端末によって接続するネットワークや名前解決の条件が異なったり、同じメモでも異なるパラメーターの項目が選ばれていたりする可能性があります。まず比較できる環境を整え、設定内容と選択状態を確認します。利用中のサービスによっては、同時接続が制限されている場合もあります。これは利用者が持つサービス側の条件であり、クライアントの表示名を変えても解決しません。テストのためにアカウントの認証情報を公開しないでください。
移行手順の詳細は設定のバックアップと新端末への移行方法をご覧ください。古いデータを削除する前に、アプリを再起動した後のアクセスを一度確認し、バックアップを単独で取得できることも確かめてください。新しい端末へのインストールが済んでいない場合は、先にダウンロードページで入手方法とシステムの案内を確認してから設定を復元します。アプリのインストール、情報の復元、接続の確認は別々の段階です。分けて作業すると、入手、同期、ネットワークの問題を混同せずに済みます。
08 / LOCAL ACCESS
Proxyポート、Widget、日常の基本設定
ローカルProxyポートとサーバーポートは別のもの
ローカルProxyポートは、条件を満たすプログラムが指定したプロトコルでクライアントに接続するために使います。一方、Homeにあるサーバーポートは遠隔サーバーへの接続パラメーターです。偶然同じ番号になることはありますが、同じにする必要はありません。プログラムからHTTPまたはSOCKS5プロキシの入力を求められたら、まず現在のプラットフォーム版のShadowrocketに対応する待ち受け機能があり、有効になっているか確認してください。もともと利用中のサービスでその方式が求められている場合を除き、遠隔サーバーのアドレスやポートをローカルProxyの設定に入力しないでください。
ポートの現在値、待ち受けアドレス、初期状態のスイッチは実際のSettings画面で確認してください。このページでは、すべての端末に共通する数値を指定しません。明示的にプロキシを必要とするプログラムがなければ、LAN共有を追加で有効にしないことを基本方針とします。端末上のプログラムだけで使う場合は、アクセス範囲を端末内に制限してください。待ち受けポートを変更する前に元の値を記録し、新しいポートがほかのプログラムに使われていないことを確認してから、利用するプログラム側も更新します。片方だけ変更すると、もう一方は古いポートを参照したままになり、接続拒否やタイムアウトが起きます。
| 項目 | 意味 | 確認するポイント |
|---|---|---|
| 待ち受けアドレス | どのローカルネットワークインターフェースで接続を受け付けるか | 端末内からのアクセスとLANからのアクセスでは範囲が異なる |
| ローカルポート | クライアントがプロキシリクエストを受け付けるポート | 呼び出し元のプログラムに同じポートを設定する |
| プロキシプロトコル | 呼び出し元のプログラムとローカルの待ち受けで使う方式 | HTTPとSOCKS5は任意に入れ替えられない |
| サーバーポート | 既存の遠隔サービスへの接続パラメーター | ご自身が持つサーバー情報に従う |
LAN共有の注意点と確認手順
LAN上の端末から接続できるようにすると、アクセスできる範囲が広がります。明確な必要性があり、ネットワークを管理できる場合にのみ使用してください。まず接続する端末とShadowrocketを実行中の端末が互いに通信できることを確認し、次にシステムのファイアウォール、待ち受けアドレス、ポートを調べます。同じWi-Fi名でも端末同士が通信できるとは限りません。ゲストネットワークでは端末間の通信が制限されることがあります。ひとつのプログラムを確認するためにシステムの保護全体を緩めたり、ローカルの待ち受けを不要な外部ネットワークに公開したりしないでください。
プロキシアドレスを入力する際、端末上のプログラムと別の端末から見た「ローカル」は同じではありません。呼び出し元のプログラムで使うループバックアドレスは、そのプログラムが動作している端末を指し、Shadowrocketを動かしている別の端末を自動的に指すわけではありません。端末間で接続する場合は、実際に到達できるLANアドレスを使い、ネットワーク再接続後にアドレスが変わる可能性も考慮してください。テストが終わって共有が不要になったら、該当する待ち受けを無効にし、元の範囲に戻して、呼び出し元のプログラムに残ったプロキシ設定も削除します。
Widgetは操作への入口であり、接続確認の代わりにはならない
Widgetは状態の確認や操作への簡易な入口を提供します。実際に使える操作は、現在のシステムとアプリが提供するコンポーネントによって異なります。追加する前にアプリ内で接続を確認し、システムの手順に従ってWidgetを追加してください。システムのスケジュールにより表示の更新が遅れる場合があるため、一時点の文字やアイコンをリアルタイムのネットワーク監視結果とみなさないでください。表示と実際のアクセス結果が異なる場合は、Shadowrocketを開いて接続状態とサーバーを確認し、リクエストを一度送ります。Widgetからスイッチを何度も切り替えないでください。
Widgetを追加するかどうかはシステムのレイアウトと利用者の選択で決まり、Config共通の設定値ではありません。用途が明確な入口だけを残し、特にロック画面や共有画面にサーバーのメモなどが表示されていないか確認してください。端末の変更やバックアップからの復元後は、Widgetの配置や許可を再確認する必要がある場合があります。Widgetが復元されても、Config、Global Routing、選択中のサーバーは別途確認してください。Widgetから操作できても、以前のサーバー情報やシステム権限がすべて復元されたとは限りません。
日常のメンテナンスでは、まず手元のサーバー情報が有効か確認し、現在の設定とルールの参照先をチェックします。次にDNS、自動接続、テストの設定を見直し、最後にローカルポートとWidgetを確認してください。毎回、現在の問題に関係する層だけを変更し、動作中の複製と復元手順を残します。アプリを入手し直す場合は全プラットフォームのダウンロードページへ、初期設定を終えたばかりの場合はクイックスタートガイドに戻って接続を確認してください。設定を次々に追加するより、安定した基本状態を保つ方が、その後の変化を調べやすくなります。