OFFICIAL MANUAL / SETTINGS
Shadowrocket 設定ガイド
設定の適用範囲から、DNS、On Demand、Global Routing、接続テスト、ログ、同期、ローカルポートの順に確認します。
このページでは、Shadowrocketの公式マニュアルのうち、設定項目を確認する方法を解説します。自分のサブスクリプションやサーバー情報を追加済みで、設定項目を変更すべきか判断したい方に向けた内容です。初回接続の手順は、まずはじめにを読み、情報の追加、モードの選択、接続、動作確認の順に進めてください。個別の設定に疑問が生じたら、該当する章を参照してください。初めて使う前に、すべての設定を変更する必要はありません。
ShadowrocketはiPhone、iPad、Mac、Windows、Android、Linuxに対応しています。本記事ではiPhone / iPadで一般的な画面項目を中心に説明します。他のプラットフォームでは実際に表示される項目を確認し、特定のOSだけで使える機能を全プラットフォーム共通のものとして扱わないでください。iPhone / iPad版はApp Storeで2.99米ドルの買い切り、Mac / Windows / Android / Linux版は無料です。アプリの買い切り購入と接続サービスのプランは別です。当サイトでは接続先やサブスクリプションの提供・販売・推奨は行っていません。
SETTINGS / SCOPE
設定の適用範囲・初期状態・推奨設定
設定の保存先を確認する
接続結果には、Settings、現在のConfig、選択中のサーバー、システムのネットワーク状態が同時に影響することがあります。Settingsの設定はConfig内の指示と同じではなく、サブスクリプション項目のパラメーターもグローバル設定とは異なります。たとえば、サーバーアドレスや認証情報は接続項目、ルールのマッチングは現在のConfig、VPN接続の許可はシステム権限に関わります。トラブルシューティングの前に、どの階層を編集しているか記録しておきましょう。誤った箇所を繰り返し変更したり、情報を追加した際の変化をアプリがすべての設定を自動変更した結果と誤認したりするのを防げます。
ここでいう「初期状態」とは、初めて開いたとき、または自分で変更する前に実際に表示されている値です。推奨値を固定の出荷時設定として扱うものではありません。OS、読み込んだConfig、以前の同期データによって現在の状態は異なり、アップデート後も以前の選択が引き継がれる場合があります。初期値を確認できない場合は、まず端末に表示されている値をスクリーンショットなどで記録し、使用中のConfigに該当するパラメーターが指定されているか確認してください。名前が似ているだけで、画面の設定とConfigの間に共通の優先順位があると決めつけないでください。
元に戻せる最小限の基本設定を用意する
変更を始める前に、現在のConfigのコピーを保存し、Global Routing、選択中のサーバー、接続のオン/オフ、使用中のネットワークを記録します。サブスクリプションURL、パスワード、キーは自分で管理できる安全な場所に保管し、共有用のスクリーンショットには含めないでください。正常に接続できる項目は残し、新しいルールはコピー上で検証します。もともと接続できない場合は、比較できるように変更前の状態を保存します。バックアップの目的は具体的な入力内容を復元できるようにすることで、「以前はこのあたりをオンにしていた」という曖昧な記憶に頼ることではありません。
推奨する基本設定は、動作を確認済みのサーバー情報を使い、用途が分からない高度なパラメーターは追加せず、説明しやすいConfigを1つに絞り、安定したネットワークで手動接続することです。DNSはまずシステムの名前解決が正常か確認し、On Demandには複雑な条件を設定せず、ログはトラブルシューティングに必要な範囲でのみ有効にします。これらは問題の切り分けを容易にするための推奨手順です。すべての端末で初期値が同じだという意味でも、動作確認済みの機能を長期的に無効にするという意味でもありません。
| 設定の階層 | 主な内容 | 変更前に記録する項目 |
|---|---|---|
| 接続項目 | アドレス、ポート、プロトコル、認証パラメーター | 元の項目のコピーとサービス提供元の指定内容 |
| Config | General、Rule、Host | 現在有効なファイルとルールの順序 |
| Settings | テスト、ログ、同期などの設定 | 現在の設定と画面に表示される説明 |
| システム | VPN権限、ネットワーク、クラウドアカウント | ネットワークの種類と権限の状態 |
確認できる要素を1つずつ変更する
1回のテストで変更する変数は1つにし、成功条件を決めておきます。たとえばDNSを変更したら、接続スイッチがオンのままかだけでなく、以前名前解決できなかったドメインが解決できるかを確認します。毎回同じ対象、同じネットワーク、同じサーバーでテストし、結果を記録してから変更を残すか判断してください。サーバー、ルーティングモード、リゾルバーを同時に変えると、アクセスが戻っても何が効いたのか分かりません。その後、似た問題が起きたときに再現や検証が難しくなります。
画面の場所やシステム機能はプラットフォームによって異なる場合があります。説明にある設定が端末に見当たらなくても、名前の似た別の設定で代用したり、確認していないキーをConfigに追加したりしないでください。まず使用中のプラットフォームを確認し、サーバー編集画面ではなくSettingsを開いているか確認します。アプリのダウンロードとシステムでの許可手順は全プラットフォームのダウンロードページをご覧ください。設定の確認はインストールが完了し、アプリを正常に開ける状態になってから行います。ネットワーク設定でインストール権限の問題を解決することはできません。
SETTINGS / DNS
DNS:名前解決の経路とローカルマッピング
名前解決と接続のどちらで失敗したかを確認する
DNSはドメイン名をネットワークアドレスに変換しますが、アドレスを取得できても、その後の接続が成功するとは限りません。ドメインへのリクエストは、名前解決の段階で失敗することも、アドレス取得後に接続できず失敗することもあります。まずLogで名前解決の結果が記録されているか確認し、次に接続先のアドレス、宛先ポート、適用されたポリシーを確認します。タイムアウトをすべてDNSの問題と決めつけてリゾルバーを頻繁に変更すると、確認すべき要素が増えるだけです。サーバー認証の失敗、接続先サービスの応答停止、誤ったポリシーの選択は、リゾルバーを変更しても解決しません。
3種類の名前を区別してください。ブラウザーでアクセスする宛先ドメイン、Proxyサーバー自体のドメイン、サブスクリプションURLのドメインです。それぞれ異なる段階で異なるネットワーク経路を使う場合があります。特にサーバーアドレスがドメイン名の場合は、Proxy接続の確立前に名前解決が必要なことがあります。「接続後の名前解決はすべてProxy経由」と単純に考えないでください。サーバーのドメインだけ解決できない場合は、まず現在のネットワークとサービス提供元の情報を確認してから、対象サイトのDNS動作を調べます。
dns-serverとsystemを理解する
Configのdns-server = systemは、システムが提供する名前解決元を使うという意味です。特定のパブリックDNSサービスがあらかじめ指定されているわけでも、名前解決が必ず特定のサーバーを経由するわけでもありません。システムの結果は、Wi-Fi、モバイルネットワーク、ネットワーク管理ポリシーによって変わる場合があります。トラブルシューティングの出発点としてシステムの名前解決を使うと、現在のネットワークの動作を維持できます。Logでシステムの名前解決に問題があると確認できた場合は、必要に応じて信頼でき、現在のネットワークから到達可能な名前解決元を設定し、同じドメインで結果を比較してください。
[General]
dns-server = system
[Host]
localhost = 127.0.0.1
この例はセクション名とパラメーターを示すもので、ネットワーク設定一式ではありません。既存のConfigに追加する前に、同名のセクションや重複するキーがないか確認してください。ファイル末尾に重ねて追加すると、実際に有効な設定を誤認するおそれがあります。別の名前解決方式を設定する場合は、アプリが対応しているアドレス形式や通信方式、そのDNSサービスの説明を確認します。通常のドメイン名、完全なWebページのURL、DNSサーバーのアドレスを混同しないでください。試すためだけに多数の名前解決元を一度に設定する必要もありません。
Host、キャッシュ、IPv6の注意点
Hostマッピングは、名前に対応するアドレスを明示的に指定するものです。宛先サーバーの証明書を修正したり、アプリケーション層の認証を変更したりするものではありません。例のlocalhostはローカルループバック名であり、Proxyサーバーのアドレスに置き換えないでください。特定のドメインに固定マッピングを設定している場合、接続先が移転しても古いアドレスがアクセスに影響し続けることがあります。そのため、現在のConfigのHostセクションも確認してください。マッピングを削除する前にコピーを保存し、意図的に設定した内部ネットワーク名まで消さないようにします。
キャッシュの影響で、連続したテスト結果が矛盾して見えることがあります。アプリ、システム、接続先のプログラムが以前の結果を保持している場合があります。変更後は現在のプラットフォームで利用できる方法で関連キャッシュを更新するか、接続先のプログラムを終了して新しいリクエストを発生させ、記録を確認してください。同じページを何度も再読み込みするだけで、設定の効果を判断しないでください。IPv6を確認する場合は、ネットワークに実際のIPv6接続性があるかも確認します。IPv6アドレスを取得できることと、そのアドレスで接続を完了できることは別の条件です。
| 確認された現象 | 優先して確認する項目 | 次の手順 |
|---|---|---|
| 名前解決の結果がない | 名前解決元とネットワークへの到達性 | 同じネットワークで別のドメインを試す |
| アドレス取得後に接続がタイムアウトする | ポリシー、宛先ポート、アドレスファミリー | 該当する接続記録を確認する |
| 一部のドメインだけ異常 | Host、キャッシュ、ルールの一致条件 | 該当する変更だけを取り消す |
推奨値は、説明できて検証できることを基準にします。システムの名前解決が正常なら、まずその設定を維持し、必要がある場合にのみカスタムDNS設定を追加してください。初期値は端末の現在のConfigとSettingsで確認します。すべてのプラットフォームで同じとは限りません。検証時はドメイン、名前解決の結果、日時、ネットワーク環境を記録します。結果を共有する場合は、内部ドメインやサーバー情報を隠してください。名前解決に成功してもアクセスできない場合は、このページのルーティングとログの章を確認し、DNSパラメーターを追加し続けないでください。
SETTINGS / ON DEMAND
On Demand:条件に応じた接続と手動切断
On Demandの接続条件とルールによる振り分けは別の階層
On Demandは、システムが対応するネットワーク条件に応じて接続動作を開始する機能です。Ruleは接続中のリクエストにどのポリシーを適用するかを決めます。前者は「いつ接続を確立するか」、後者は「接続後にリクエストをどう処理するか」に関わります。そのため、On Demandを有効にしてもすべてのリクエストがProxy経由になるわけではなく、無効にしてもConfigのルールが削除されるわけではありません。トラブルシューティングでは接続状態とトラフィックのポリシーを分けて確認してください。そうしないと、条件による再接続をルールの不具合と誤認したり、DirectルールをVPN未接続と誤認したりするおそれがあります。
On Demandの条件、設定場所、利用できる範囲はプラットフォームによって異なります。本記事では主にiPhone / iPadでの使い方を説明し、特定のOSにある条件リストを全端末共通の機能として扱いません。初期状態は端末に表示される内容を確認してください。以前のシステムVPN設定、同期からの復元、過去の手動変更が現在の状態に影響している場合があります。初めて設定する際は自動接続をオフにし、手動接続、切断、対象へのアクセスが想定どおりに動作することを確認してから、条件を少しずつ追加します。
必要なネットワーク動作を言葉にする
設定前に、目的を一文で表してください。たとえば「指定したWi-Fiでは自動接続せず、他のネットワークに切り替わったら設定した条件で接続する」などです。次に、自宅のWi-Fi、職場のWi-Fi、モバイルネットワーク、Web認証が必要なネットワークを含め、実際に使うネットワークをリストにします。明確に識別でき、区別する必要がある条件だけ設定してください。名前が似たWi-Fiを同一のネットワークと決めつけたり、Wi-Fi名を信頼性の証明として扱ったりしないでください。
条件は1つずつ保存し、次の条件を追加する前にネットワーク切り替えをテストします。電波が安定していないうちに接続スイッチを連続で押すのではなく、システムのネットワーク切り替えが完了するまで待ってください。切り替え前後のネットワーク、アプリの接続状態、システムのVPN状態を記録します。ステータスバーのアイコンだけを見るより、3つを合わせて確認する方が確実です。条件が重なる可能性がある場合は、画面の説明で優先順位を確認してください。Ruleと同じ順序で判定されると決めつけないでください。
「切断してもすぐ再接続する」場合
手動で切断した直後に再接続する場合は、まずOn Demandの条件が引き続き満たされていないか確認します。条件に応じてシステムが接続を再確立する動作と、ボタンの故障は別の問題です。長時間切断する場合、別のVPNを確認する場合、ネットワーク認証を行う場合は、先にOn Demandを一時停止してから切断し、システムの状態が変わるか確認してください。作業後は必要に応じて元の条件に戻します。スイッチを何度も押すだけでは、再接続のたびに問題発生時の状況が変わり、原因を観察しにくくなります。
Web認証が必要なネットワークは、個別に確認してください。Wi-Fiに接続しただけでは通常のインターネットアクセスが可能とは限らず、システムに表示されるページで認証が必要な場合があります。認証前に自動接続すると接続に失敗したり、認証画面を見つけにくくなったりすることがあります。その場合は自動接続を一時停止し、必要な認証を完了して通常のネットワークアクセスを確認してから、手動で接続します。DNSやルールの変更、連続した再試行で、ネットワークが要求する認証を代用しないでください。
システム権限とスリープ復帰も確認する
システムからVPN接続の許可を得ていても、デバイス管理ポリシーや他のネットワークツールの影響を受ける場合があります。システムが接続を拒否する場合は、システムの通知とインストール済みのVPN設定を確認し、競合がないか調べてください。アプリに存在しないルール例外を探す必要はありません。管理対象端末の制限は管理者に相談し、内容が分からないシステム設定を削除して試さないでください。また、デスクトップOSのバックグラウンド実行設定をiPhone / iPadのOn Demandにそのまま当てはめないでください。
設定後、少なくとも一度は画面ロックと解除、Wi-Fiとモバイルネットワークの切り替え、手動切断、再接続を確認します。ネットワーク復帰時だけ問題が起きる場合は発生時刻を記録し、同じ時間帯のログから、ネットワークの準備未完了、名前解決の失敗、接続拒否を区別します。長期的に残すべきなのは条件の多さではなく、用途を説明でき、検証済みの条件です。基本操作をもう一度確認する場合ははじめにに戻り、手動接続の手順を確認してください。
CONFIG / GLOBAL ROUTING
Global RoutingとConfigの適用関係
現在のモードを確認してから、ルールの結果を判断する
Global Routingの主なモードはConfig、Proxy、Directの3つです。Configは現在のConfigに従ってリクエストを処理し、振り分けが必要な日常利用に適しています。Proxyは全体をProxy経由にする場合の比較に、Directは直接接続する場合の比較に使います。これらはルーティング動作の選択肢であり、サーバープロトコルや通信速度の段階ではありません。アクセス結果が想定と異なる場合は、Config内のルールだけを見るのではなく、まず現在のモードを確認してください。
| モード | 確認する項目 | 主な用途 |
|---|---|---|
| Config | 現在のファイル、ポリシー名、ルールの適用順 | ルールによる振り分けを確認する |
| Proxy | 選択中のサーバーとProxy経由の接続性 | 一部のルールの影響を切り分ける |
| Direct | 現在のネットワークで直接アクセスできるか | Direct接続の比較結果を得る |
初期モードを記憶だけで判断せず、特に端末の変更後やデータ復元後はHomeで現在の選択を確認してください。サーバーの動作を確認した後はConfigを使い、構成が分かりやすいConfigを1つ保つことをおすすめします。比較のために一時的にProxyやDirectを使った後は、日常利用のモードに戻します。画面にSceneなどの項目がある場合は、その機能を個別に確認し、ここで説明する3つのモードによるテストと同じスイッチとして扱わないでください。
Ruleは上から順に照合される
Configではルールが上から順に照合され、最初に一致したルールが該当リクエストのポリシーを決めます。そのため、精度の高いDOMAINやDOMAIN-SUFFIXは、範囲の広いフォールバックルールより前に置き、FINALは最後に配置するのが一般的です。ルールに記載するポリシー名は、現在のConfig内で有効なものでなければなりません。以下のPROXYは関連付けるProxyポリシーの例にすぎず、この単語をコピーしただけでサーバーに接続できるわけではありません。例を使う前に、自分のConfigの構造とポリシー名を確認してください。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,DIRECT
この例は、ドメインサフィックス、ドメインキーワード、アドレス範囲、地理的位置、最終ルールの並びを示すもので、すべての人に適した完全なConfigではありません。DOMAIN-SUFFIXは該当ドメインとそのサブドメインに適用されます。DOMAIN-KEYWORDはより広い範囲に適用され、名前に同じ文字列を含む別のドメインにも影響するおそれがあります。IP-CIDRはアドレス範囲に、GEOIPは利用可能な位置情報データに基づいて適用されます。これらは業務上のドメインを指定する精密なルールの単純な代替にはならず、特定サービスが常に同じアドレスを使うことも保証しません。
ルール変更後は新しいリクエストで確認する
Configを保存することと、そのConfigを選択することは別です。ファイルを編集したら、それが現在使用中のConfigか確認し、画面の指示に従って再読み込みまたは再接続してください。既存の長時間接続は、新しいルールにすぐ切り替わるとは限りません。検証時は対象アプリの既存接続を終了して新しいリクエストを発生させ、ログで宛先とポリシーを確認します。ページが引き続き表示されるだけでは、新しいルールに一致した証拠にはなりません。キャッシュや既存の接続が使われている可能性があります。
同じアプリで一部の内容だけ正常、他が異常な場合は、アプリ名に対する汎用ルールを想像で作るのではなく、リクエスト先のドメインを個別に確認します。ログイン、画像、API、メディアはそれぞれ異なる宛先から読み込まれる場合があります。まずログで失敗したリクエストを見つけ、十分に限定された条件で照合してください。1つのドメインを直すために、範囲の広いキーワードを追加しないでください。USER-AGENTなどのマッチングにも適用条件があります。すべての通信から同じ情報を取得でき、照合に使えるとは限りません。
元に戻すときは、ファイル末尾に反対のルールを追加するのではなく、保存済みのConfigに戻すことをおすすめします。General、Rule、Hostの全体構成を確認するには、Configの各セクションの解説をご覧ください。Proxyモードではアクセスでき、Configではできない場合は、まず適用されたポリシーを確認します。どちらでも失敗する場合は、サーバーとネットワークを確認してください。この順序で、ルールの問題と接続の問題を切り分けられ、不要な変更を減らせます。
TOOLS / CONNECTIVITY TEST
PingとConnectivity Testの結果の見方
テスト結果から分かるのは、そのテストで確認したことだけ
Pingが測定する対象は、テスト方法によって異なります。ホストやポートの応答だけを確認する方法もあれば、プロトコルのハンドシェイクやテストリクエストを含む方法もあります。数値や失敗状態を解釈する前に、現在のテスト方法の説明を確認してください。すべての結果をWebページへのアクセス全体にかかった時間として扱わないでください。ホストが応答しても認証情報が正しいとは限らず、Proxyのハンドシェイクが成功しても、特定の接続先のAPIが使えるとは限りません。
Connectivity Testは、指定したテスト条件で接続性を確認します。テスト先、タイムアウト時間、選択中のサーバー、DNS、現在のネットワークが結果に影響します。初期のテスト方法とアドレスは端末に表示される内容を確認してください。本記事では、確認していない共通の初期URLを指定しません。説明できる設定はひとまず維持し、安定して応答することを確認したテスト先を使うのがおすすめです。失敗時はエラーの種類を記録し、赤色や空欄の表示だけでサーバーが恒久的に使えないと判断しないでください。
遅延、転送量、安定性を分けて見る
遅延は往復または1回の処理にかかる時間、スループットは継続的なデータ転送能力、安定性は複数回の観察で判断します。1回の数値が低くてもダウンロードが速いとは限らず、1回タイムアウトしただけで以後すべてのリクエストが失敗するとも限りません。小さなリクエストは、一時的なネットワーク混雑、端末のスリープ復帰、ドメインキャッシュの影響を受けやすい場合があります。サーバーを比較するときは、可能な限り同じテスト方法、同じ接続先、近い時間帯で測定してください。条件の異なる結果を並べて順位付けし、長期的な結論を出さないでください。
タイムアウトが短すぎると、一時的に遅いだけの有効な接続を失敗と判定することがあります。長すぎると問題の切り分けが遅れます。まず現在の妥当な設定を維持し、ハンドシェイクが頻繁にタイムアウト直前までかかることをログで確認できた場合にのみ調整し、変更前後の完了率を記録してください。接続拒否や認証エラーを、タイムアウトを無制限に延ばして隠さないでください。テスト頻度も控えめにします。短時間に連続して測定すると端末やネットワークの負荷が変わり、サーバー側の制限が後続の結果に影響する場合があります。
| テストで確認された現象 | 考えられること | そこから直接は判断できないこと |
|---|---|---|
| ホストが応答した | 該当するテスト経路に到達できる | Proxyの認証と接続先へのアクセスが正常 |
| ハンドシェイクに失敗した | プロトコルまたは接続段階の異常 | DNSの障害が原因だと断定すること |
| テストリクエストが成功した | その時点ではテスト先に到達できた | すべてのWebサイトとアプリが正常 |
| 断続的にタイムアウトする | 一時的な失敗が発生している | サーバーが長期的に利用不能 |
問題の場所を特定できるよう、テストを段階に分ける
まず現在のネットワークが正常に使えるか確認し、次にサブスクリプション項目のアドレス、ポート、プロトコルがサービス提供元の情報と一致するか確認します。その後、サーバーのドメインを名前解決できるか、接続を確立できるか、認証に成功するかを確認し、最後に対象へのリクエストをテストします。各段階を対応する記録で確認し、認証の確認を飛ばしてルーティングルールを変更しないでください。追加の転送方式やセキュリティパラメーターが必要なプロトコルでは、サーバー側の要件を1つずつ確認し、別の接続項目の設定を流用しないでください。
「テストは成功するのにアプリが開けない」場合は、実際にアプリが発生させるリクエストを確認します。テスト先には別のルールが適用される場合があり、軽量なアドレスにはアクセスできても、実際のアプリでは複数のドメインが必要な場合があります。Global Routingと適用されたポリシーを確認し、Logで失敗した宛先を調べてください。反対にテスト先だけが到達不能でも、実際のサービスは正常な場合があります。その場合はテスト先を見直し、動作確認済みのサーバー情報を削除しないでください。
すべての接続項目で同時に失敗する場合は、共通する要因である現在のネットワーク、システムのVPN権限、テスト先、DNSを優先して確認します。1つの項目だけ失敗する場合は、その項目の入力情報とサーバーの状態を確認してください。リストの並べ替えで修復できると思い込んだり、結果が揺れているときに現状を記録せずサブスクリプションを何度も更新したりしないでください。よくあるエラーの簡潔なQ&Aはよくある質問をご覧ください。このページのログの章では、テスト結果と実際の接続過程を照らし合わせる方法を説明します。
SETTINGS / LOG AND DATA
LogとData:記録を増やすのではなく、リクエストを特定する
再現する前にログの範囲を決める
Logの役割は、失敗を具体的な時間の流れに沿って確認することです。記録量を増やすこと自体が目的ではありません。有効にする前に、「ドメインを名前解決できたか」「どのルールに一致したか」「ハンドシェイクのどの段階で失敗したか」など、確認したいことを書き出します。記録できるレベルはプラットフォームや画面によって異なる場合があるため、初期レベルは現在のSettingsで確認してください。まず目的を達成できる最低限のレベルを使い、通常の記録では情報が足りない場合だけ、一時的に詳細度を上げます。調査後は普段の設定に戻してください。
再現する前に、現在の時刻、ネットワークの種類、Global Routing、Config名、選択中のサーバーのローカルメモを記録します。ログが多すぎる場合は、保存が不要であることを確認してから削除し、失敗するページを1つ開くなど最小限の操作を行います。複数のアプリを同時に起動したり、速度テストを実行しながらサブスクリプションを更新したりしないでください。大量のリクエストが混在し、同じ秒に起きた失敗を特定しにくくなります。端末の時刻が正確でない場合は、ログを比較する前に時刻を修正します。
名前解決、ポリシー、接続の順に読む
まず対象のドメインまたはアドレスを見つけ、名前解決の結果を確認し、適用されたポリシー、接続、認証の順に確認します。対象がログにまったく表示されない場合は、リクエストが発生していない、対象アプリがキャッシュを使っている、現在の記録範囲が対象を含んでいない可能性があります。クライアントがリクエストを破棄したとすぐに判断しないでください。対象アプリを終了して接続を作り直し、もう一度再現してから、システムのVPN状態とアプリのスイッチが一致しているか確認します。
タイムアウトした場合は、名前解決、接続確立、接続先の応答待ちのどこで発生したかを特定します。接続拒否の場合は、宛先ポートとサーバー側の待ち受けを確認します。認証またはセキュリティハンドシェイクのエラーでは、プロトコルパラメーター、システム時刻、サーバー側の要件を確認してください。似たエラーメッセージでも原因が同じとは限りません。通知を消すためだけにセキュリティ検証を安易に弱めないでください。認証情報を含むログを外部に送信せず、まず失敗した段階を示す最小限の部分だけを抜き出します。
Dataの統計で分かることと限界
Dataの通信量統計は、データ転送が発生したかを確認する助けになりますが、特定の処理が正常に完了した証明にはなりません。接続確立、再試行、バックグラウンド更新、プロトコルのオーバーヘッドでも通信量が発生します。統計の範囲は画面の説明で確認してください。アプリ内の数値を通信事業者の請求額と見なしたり、1回のセッションの数値をインストール後の累計と見なしたりしないでください。統計をリセットする前に時刻を記録し、その後は同じ範囲の数値だけを比較します。
接続中なのにDataがほとんど増えない場合は、まず対象アプリが新しいリクエストを本当に発生させたか確認し、次にルーティングとログの範囲を確認します。Dataが増え続けてもページが開けない場合は、失敗したリクエストを特定してください。通信量だけを見て「接続は確実に正常」と判断できません。バックグラウンドアプリ、システムサービス、自動再試行が通信を発生させる場合もあります。無関係なアプリを閉じ、最小限の手順で再現する方が、通信量の合計を長時間眺めるより問題を特定しやすくなります。
| 記録する内容 | トラブルシューティングでの用途 | 共有前に行う処理 |
|---|---|---|
| 対象ドメインと時刻 | 実際に失敗した操作を特定する | 内部名とクエリパラメーターを隠す |
| ポリシーとエラーが発生した段階 | ルール、名前解決、接続の問題を切り分ける | 必要な背景情報を残す |
| サーバーと認証情報 | 入力内容をローカルで確認する | アドレス、パスワード、キーを隠す |
| Dataの統計の変化 | 同じ時間帯の通信を確認する | 統計の起点と範囲を説明する |
ログの書き出し・保管・調査の完了
ログにはアクセス先、サーバーアドレス、サブスクリプションのリクエスト、端末環境の情報が含まれる場合があります。書き出す前にローカルで内容を確認し、パスワード、キー、サブスクリプションURL全体とそのクエリパラメーターを隠してください。エラー前後の数行だけで足りる場合は、履歴全体を送信しないでください。スクリーンショットも、上部、サイドバー、共有画面にメモ名が表示されていないか確認します。有効な認証情報をすでに公開してしまった場合は、送信済みの画像を削除するだけでなく、サービス提供元に該当する認証情報の対応を相談してください。
調査後は、「どのネットワークで、どの設定がどの段階の失敗を起こし、取り消すと復旧したか」という形で結論を記録します。必要なログの一部と検証済みConfigを保存し、不要になった機密情報を含む書き出しデータを削除して、一時的に詳細度を上げたログを元に戻してください。次に似た現象が起きたとき、すべての設定を試し直すのではなく、確認済みの手順を使えます。結論が再現可能な結果と結びついて初めて、ログによる診断が完了します。
SETTINGS / WIDGET AND ICLOUD
Widget、iCloud同期、端末移行後の復元
Widgetはショートカットであり、独立したConfigではない
Widgetは、システムが許可する場所に状態表示やクイック操作を提供します。サイズ、ボタン、更新動作は端末で実際に利用できる内容を確認してください。別のサーバー設定ではなく、バックグラウンドで常に更新される完全な監視画面でもありません。初めて使うときは、まずアプリ内で接続設定を完了してから、システムが提供するWidgetを追加します。システムに該当するWidgetの追加画面がない場合は、他のプラットフォーム向けの手順をそのまま当てはめないでください。
Widgetの表示はシステムの更新タイミングに左右される場合があります。表示が想定と異なるときは、Shadowrocketを開いて実際の接続状態を確認し、次にシステムのVPN状態を確認してください。Widgetに表示された1行だけで切断状態を判断しないでください。Widgetから接続を切り替えた場合も、システムの処理が完了するまで待ってから状態を確認します。On Demandの条件が引き続き満たされている場合の再接続は、On Demandの章で確認してください。Widgetを削除して何度も追加する必要はありません。
同期するデータの範囲を確認する
iCloud同期はAppleデバイスで利用できる機能であり、該当するクラウドサービスをアプリが使用できるよう端末で許可する必要があります。すべてのプラットフォームで共通のアカウント同期として扱わないでください。スイッチの初期状態、同期できる項目、端末の条件は実際の画面で確認します。有効にする前に、システムのクラウドアカウントが正しいこと、ストレージの空きがあること、ネットワークが正常であることを確認してください。システムへのログインに成功しても、アプリのデータ転送が完了したとは限らず、すべてのローカルファイルが自動で同期対象になるわけでもありません。
サーバー項目、サブスクリプション、Config、設定の各項目が別の端末に反映されているか、それぞれ確認してください。どれか1つが表示されたからといって、移行がすべて完了したと判断しないでください。特に、書き出したConfigファイルとサーバー一覧は区別が必要です。ファイルからルールを復元できても、すべての認証情報が含まれるとは限りません。サブスクリプションURLから項目を再取得できても、ローカルで手動変更した設定まで復元されるとは限りません。まず保存したい内容を洗い出し、同期または書き出しの方法を選んでください。
同期は過去の状態を保つバックアップではない
同期によって削除や変更が他の端末にも反映される場合があるため、別途保存する復元用コピーの代わりにはなりません。複数の項目を整理する前に、大切なConfigを書き出し、サブスクリプション情報を自分で管理できる安全な場所に保存してください。2台の端末で同じ内容を同時に編集すると、上書きや重複が起きる場合があります。まず一方を編集元に決め、もう一方で内容を確認してから次の編集を行うことをおすすめします。同期状態を確認できる前に、同じ項目を交互に名前変更したり削除したりしないでください。
クラウドに想定したデータが見当たらない場合は、まず同じアカウントを使っているか、アプリのクラウド利用権限があるか、ネットワークが正常か確認します。その後、同期が完了するまでしばらく待ち、項目を1つずつ確認してください。同期を促すためにスイッチを何度も切り替えたり、アカウントからログアウトしたり、ローカルデータを削除したりしないでください。状態が変わってしまい、まだ送信されていない唯一のコピーを失うおそれがあります。競合が起きた場合は、先に両方の内容を保存して差分を比較し、端末の新旧だけで決めず、有効性を確認できた方を残します。
端末移行後の確認手順
新しい端末では、まずアプリを開けることを確認してからデータを復元し、現在のConfig、選択中のサーバー、Global Routingを確認します。サーバーのメモが同じでもパラメーターまで同じとは限りません。必要に応じてアドレス、ポート、プロトコルがサービス提供元の指定と一致するか確認してください。初回接続時はシステムの許可が必要な場合があります。画面の指示に従って操作してください。Configファイルを復元しても、この手順の代わりにはなりません。接続テストに成功する前に旧端末のコピーを削除しないでください。旧端末のシステム権限が通常の設定と同じように同期されるとも限りません。
最後に、手動接続、対象へのアクセス、切断、ネットワーク切り替えを確認してから、On DemandとWidgetを再設定します。項目が重複している場合は、手動で追加したものか、サブスクリプションの更新で作成されたものかを先に確認します。削除しても再作成されるおそれがあります。移行手順の詳細はバックアップと端末移行のガイドをご覧ください。検証済みのConfigを独立したコピーとして保存し、クラウド上の一覧がそろって見えるかどうかだけに頼らず、復元に必要な情報の種類を記録しておくことをおすすめします。
SETTINGS / LOCAL PROXY
Proxyポート、ローカルネットワーク接続、最終確認
ローカルの待ち受けポートとサーバー側のポートは別
Proxyのローカルポートは、端末自身や許可されたデバイスからのリクエストをクライアントに渡すためのものです。Add Serverに入力するポートは、リモートサーバーが接続を受け付けるポートです。役割が異なるため、数字をそろえる目的で変更しないでください。リモートポートはサービス提供元の情報に合わせ、ローカルの待ち受けポートは接続するアプリの設定に合わせます。初期ポートはプラットフォームに表示される値を確認してください。すべてのシステム共通の固定値は指定しません。また、この機能を使わない場合に有効にする必要もありません。
ローカルポートでは、受け付けるProxyの種類も区別します。HTTPとSOCKS5では接続方法が異なるため、接続元のアプリでは待ち受け方式と同じ種類を選択してください。一方のポートを別のプロトコル用の欄に入力すると、接続はできてもリクエストを完了できない場合があります。種類、待ち受けアドレス、ポートを確認してからテストし、設定名にProxyとあるだけであらゆるプロトコルを受け付けると思い込まないでください。端末上のアプリにProxy設定がない場合は、実際に対応している機能を確認し、Shadowrocketに存在しない連携設定を想定しないでください。
ループバックアドレスとローカルネットワークアドレスの違い
ループバックアドレスは、現在操作している端末自身を指します。別の端末で自身のループバックアドレスを使っても、Shadowrocketが動作している端末には接続できません。ローカルネットワークから接続する場合は、実行側端末の到達可能なローカルネットワークアドレスを使い、待ち受け範囲、システムファイアウォール、端末間通信がネットワークで許可されているか確認してください。対応機能はプラットフォームによって異なるため、デスクトップ版の待ち受け方法をモバイル端末にも適用できると推測しないでください。
日常利用では、本当に必要な範囲だけを公開してください。端末内のアプリだけで使う場合は、可能ならローカルに限定します。ローカルネットワークから接続する場合は、自分で理解し管理できるネットワークでのみ有効にし、利用できる設定でアクセスを制限してください。待ち受けサービスをパブリックネットワークに直接公開しないでください。一度の接続失敗を解消するためにシステムの保護機能全体を無効にするのも避けてください。Wi-Fiで端末間通信が制限されている場合は、2台が同じ名前のネットワークに接続していても互いにアクセスできないことがあります。
| パラメーターの種類 | 一致させる対象 | よくある誤り |
|---|---|---|
| リモートサーバーのポート | 自分が利用するサービス提供元の設定 | ローカルの待ち受けポートに誤って変更する |
| ローカルの待ち受けポート | 接続元アプリのProxy設定 | 他のアプリがポートを使用中 |
| 待ち受けアドレス | 端末内またはローカルネットワークの接続範囲 | ループバックアドレスで別の端末に接続する |
| Proxyの種類 | HTTPまたはSOCKS5の接続方式 | 種類を確認せず数字だけを見る |
端末内、ローカルネットワーク、接続先リクエストの順に確認する
ポートを使用できない場合は、まず待ち受け機能が有効か、設定が保存されているか、他のアプリがそのポートを使用していないか確認します。次に、対応するプロトコルで端末内からテストし、リクエストがLogに記録されるか確認してください。端末内で成功してから、別の端末でテストします。別端末からの接続だけが失敗し、端末内では正常な場合は、アドレス、待ち受け範囲、ファイアウォール、ネットワーク上の端末間通信制限を優先して確認します。この順序で調べると、ローカルネットワークの問題をProxyサーバーの障害と誤認しにくくなり、正常な接続項目を変更せずに済みます。
クライアントにリクエストが届いた後も失敗する場合は、ローカルポートを変更し続けず、Global Routing、適用されたルール、名前解決の結果、リモート接続を確認してください。ポートが担うのは接続の入口であり、その後の処理がすべて成功することを保証しません。特に、システムProxyの接続先がローカルの待ち受け先になっており、上流側の設定でも同じ入口にリクエストを戻すと、転送の繰り返しや失敗が起きる場合があります。システムレベルのProxyを追加する前に、リクエストの経路を書き出し、元に戻せるよう現在の設定を保存してください。
設定変更は一連の確認で締めくくる
変更後は決まった順に確認します。現在のネットワーク、サーバー情報、手動接続、DNSとルール、実際に発生させたリクエスト、LogとDataを確認してください。最後に必要なOn Demand、Widget、同期の設定を戻します。検証に成功した変更だけを残し、改善につながらなかった設定は取り消します。特定のアプリだけで問題が起きる場合は、宛先とエラーが起きた段階を記録し、局所的な現象を理由にConfig全体を書き換えないでください。
長期的に管理するには、スイッチの一覧だけでなく、設定の目的と検証方法を記録してください。なぜ特定の名前解決元を指定したのか、どのルールを優先するのか、どのローカルアプリが待ち受けポートを使うのか、端末移行後に何を確認するのかを残します。新しい問題が起きたら該当する階層から確認し、よくある質問または初心者向け10問10答も参照してください。このガイドの目的は、残す設定それぞれに明確な用途、確認できる結果、実行可能な復元手順を持たせることです。