[Settings]公式マニュアル · 設定ガイド
Settings 設定ガイド
設定項目の対象範囲を確認し、DNS、On Demand、接続テスト、ログ、同期、ローカルポートを順に見直します。
既存のサブスクリプションやサーバー情報を読み込み、接続方法を選んでアクセスを確認する手順は、まずクイックスタートをご覧ください。このページでは、設定が反映される仕組みや変更が必要な場面、変更後の戻し方を説明します。以下はiPhone / iPadで一般的な画面表示をもとにしています。ほかのプラットフォームでは、実際の画面に表示される設定場所や項目をご確認ください。
[General]
1. 設定の階層と初期状態
まずSettings、Config、サーバー設定を区別する
Shadowrocketの接続結果は、ひとつのスイッチだけで決まるものではありません。Settingsのアプリ全体に関わる設定、Configで選択中の設定ファイル、Homeで選択中のサーバー、システムから許可されたネットワーク権限が、リクエストの処理に影響します。トラブルを調べる前に、この4つの状態を記録しましょう。たとえば、ConfigのDNS項目を変更してもサーバーのアドレスは変わりません。Add Serverのポートを変更しても、端末上のProxy待ち受けポートは変わりません。各項目がどの階層に属するかを見極めると、関係のない場所で試行錯誤せずに済みます。
サーバー設定は、プロトコル、アドレス、ポート、認証、通信条件など、既存のサーバーへの接続方法を定めます。設定ファイルは主にDNS、ルール、ポリシーなど、リクエストの処理方法を記述します。アプリの設定には、テスト、表示、接続のトリガー、同期、ログなどが含まれます。項目の場所はシステムによって異なる場合があり、名前が似ているからといって相互に上書きされるわけではありません。変更が反映されないように見える場合は、設定が無効だと決めつける前に、現在有効な設定ファイルとサーバーを確認してください。
初期値の考え方
このガイドでは、あるインストール時に表示された状態を、すべての端末に共通する初期値とはみなしません。新規インストール、バックアップからの復元、リモート設定の読み込み、以前の設定の引き継ぎによって、初期状態は異なります。同じ名前の項目でも、システム権限や設定内容によって動作が変わることがあります。表に記載した推奨事項は、トラブルシューティングの基準となるもので、すべてのユーザーに設定変更を求めるものではありません。画面に初期設定が示されており、変更する明確な理由がなければ、まずそのままにしてください。設定ファイルに項目がない場合も、「未記入」をそのまま「無効」と解釈しないでください。
確認時は、項目名、画面の場所、現在値、変更理由を文章で記録します。スイッチはオン/オフ、選択式の項目は実際に選ばれている値、設定については元のファイルを残してください。初期状態を確かめるために、使用中のデータを削除しないでください。また、バックアップなしで全設定をリセットするのも避けましょう。比較が必要な場合は、独立したテスト用設定を作成し、元の設定を復元用として保管します。テスト後は、どの設定に戻したかを明確にし、テスト用ファイルを日常的に使い続けないようにしてください。
| 階層 | 主な影響 | 変更前に記録する項目 |
|---|---|---|
| Settings | アプリ設定、テスト、接続トリガー、補助機能 | 各項目の名称と現在の状態 |
| Config | DNS、ルールの照合、ポリシーの参照 | 現在のファイルとその元の内容 |
| Add Server | 既存サーバーへの接続パラメーター | プロトコル、アドレス、ポート、通信条件 |
| システム設定 | ネットワーク権限、バックグラウンド動作、クラウドアカウントの条件 | 権限の状態と現在のネットワーク |
元に戻せる変更手順を整える
作業前に、既存のサブスクリプションやサーバー情報を引き続き確認できることを確かめ、現在の設定をバックアップします。次に、繰り返しアクセスできるテスト先を選び、同じネットワーク、同じサーバー、同じGlobal Routingの状態にそろえます。設定を一度にひとつだけ変更し、必要に応じて再接続して、同じテスト先で確認してください。結果が安定して再現して初めて、その変化を設定変更と関連づけられます。DNS、サーバー、ルールを同時に変更すると、成功しても失敗しても、どの変更が影響したのか判断できません。
このマニュアルを読むために、別途接続サービスを用意する必要はありません。Shadowrocketはクローズドソースの商用アプリです。クライアントの買い切り購入と接続サービスの契約は別です。当サイトはノードやサブスクリプションを提供、販売、推奨していません。入手方法はダウンロードページをご覧ください。iPhone / iPad版はApp Storeで$2.99の買い切りです。Mac(Appleシリコン/Intel)、Windows、Android、Linux版は無料です。iPhone / iPadのシステム要件はApp Storeの記載をご確認ください。ほかのプラットフォームのインストーラーは、ダウンロードページから当サイトの/dl/shadowrocket/へご案内します。
以降の章では、「役割、確認方法、推奨事項、検証」の順に説明します。画面に記載の項目が見当たらない場合は、まず現在のプラットフォームや設定が対象かを確認してください。名前の似た項目を無理に代用する必要はありません。明確なエラーメッセージが表示された場合は原文を控え、症状に応じてよくある質問を確認してください。未確認の設定変更で問題の範囲を広げないようにしましょう。
[DNS]
2. DNSと名前解決
DNSが解決するのはアドレスの検索です
DNSはドメイン名を接続先のアドレスに変換しますが、名前解決に成功しても接続が成功するとは限りません。ドメインにアクセスすると、まずアドレスを検索し、設定に基づいてルールを照合した後、接続先またはプロキシサーバーへの接続を開始する場合があります。処理経路によって、名前解決がローカルまたはリモートで行われることもあります。そのため、ひとつの検索結果だけで全トラフィックの経路を判断することはできません。「名前解決が応答したか」「どのポリシーが選ばれたか」「接続が完了したか」を分けて記録してください。
ドメイン名ではアクセスできず、あるアドレスには接続できる場合、名前解決の経路を確認する必要があると考えられます。ただし、それだけで特定のDNSサービスが利用できないと断定することはできません。アドレスを直接指定すると、TLS証明書の検証、サーバーの仮想ホスト選択、アプリの動作が変わる可能性があり、両者は同じテストではありません。同じアプリとリクエスト経路でエラーを確認するほうが確実です。名前解決のタイムアウト、サーバーへの接続タイムアウト、証明書のホスト名不一致は、それぞれ別の問題として扱い、すべてDNS障害にまとめないでください。
dns-serverとsystemを確認する
現在のConfigにある[General]セクションでdns-serverを探します。明示的な設定がある場合は、内容全体とその設定元を記録してください。項目がなければ、特定のパブリックアドレスを使っていると決めつけないでください。以下の例は、システムが提供する名前解決設定を使う場合の最小限の例です。設定ファイル全体を置き換えるためのものではありません。システムのリゾルバーが実際に参照する情報は、現在のネットワーク、デバイス管理、その他のシステム設定によって異なる場合があります。
[General]
dns-server = system
まず現在動作しているシステム設定を基準にすることをおすすめします。特に、オフィスや学校のネットワーク、社内ドメインへのアクセスが必要な環境では重要です。内部ドメインは外部のリゾルバーで解決できるとは限りません。安易に置き換えると、インターネットにはアクセスできても、ファイルサービス、ログインページ、社内アプリが利用できなくなる場合があります。別の名前解決方法が必要な場合は、自分のネットワーク要件に基づいて設定し、名前や公表されている性能を比較するだけでなく、現在の接続経路からそのリゾルバーに到達できるか確認してください。
キャッシュ、ネットワーク切り替え、アドレスファミリー
DNSを変更した直後にページを再読み込みしても、アプリの接続プールや既存のキャッシュが使われることがあります。そのため、一度の再読み込みだけでは新しい設定が使われたとは限りません。関連するテストリクエストを終了し、必要に応じてShadowrocketを切断して再接続し、同じ条件で再テストします。複数のリゾルバーを短時間に何度も切り替えないでください。ネットワーク切り替え、キャッシュ更新、サーバー応答の違いが同時に加わり、原因を特定しにくくなります。アドレスを次々に試すより、変更前後の状況を記録するほうが有効です。
同じドメインからIPv4とIPv6のアドレスが返されることがあります。一方のアドレスファミリーの経路が不完全だと、一部のアプリは正常でも、別のアプリでは読み込みに時間がかかる場合があります。その際は接続ログで実際に試行されたアドレスを確認し、IPv6が表示されたというだけで機能をすぐに無効にしないでください。アドレスファミリーを無効にすると、一時的に経路の問題を回避できる可能性はありますが、そのネットワーク環境に依存するサービスへ影響することもあります。まずネットワークごとの結果を比較し、必要に応じて個別に調整してください。
| 確認された現象 | まず確認する項目 | 避けたい誤判断 |
|---|---|---|
| 名前解決の応答がない | リゾルバーへの到達性、現在のネットワーク、接続状態 | サーバーの認証エラーだと決めつける |
| アドレスは取得できるが接続がタイムアウトする | ルーティングポリシー、接続先ポート、実際の接続経路 | DNSを次々と無計画に変更する |
| 社内ドメインだけ解決できない | 内部リゾルバーと社内ネットワークへのアクセス条件 | 外部の名前解決結果で内部レコードを置き換える |
安全に変更し、元に戻せる範囲
暗号化DNSは問い合わせの通信方法を変えますが、サーバー設定、ルールの順序、接続先サイトの障害を自動的に解決するものではありません。ホスト名を使う名前解決エンドポイントでは、そのホスト名を最初にどう解決するか、リクエストがどの経路を通るかも考慮が必要です。依存関係を説明できない場合は、まず元の設定に戻し、通常のアクセスが復旧することを確認してから、名前解決方法を個別に検討してください。理解していないDNS項目を一度に複数追加したり、異なる設定から矛盾する項目を組み合わせたりしないでください。
検証では、テストボタンが成功を示すかではなく、実際の接続先が想定したポリシーで安定して利用できるかを確認します。日常的に使うインターネット上の接続先、実際に必要な社内接続先、ネットワーク切り替え後の動作を少なくとも確認してください。元に戻すときはDNS設定を元の状態に戻し、同じ手順で再接続します。設定を戻しても現象が変わらない場合は、ほかの階層を調べてください。DNSに関係するルールの動作は次の章で説明します。両者には関連がありますが、同じスイッチではありません。
[Rule]
3. Global Routingと設定ルール
Config、Proxy、Directの適用範囲
Global Routingは、設定が処理に使われているかを確認する最初のポイントです。画面上のConfig、Proxy、Directは、それぞれ設定、プロキシ、直接接続を表します。Configは現在の設定ファイルのルールに従ってポリシーを選択し、Proxyはプロキシ経由で処理できるリクエストを扱い、Directは直接接続で処理します。これらはクライアント側の処理方法を示すもので、接続先への到達を保証するものではありません。また、端末上のあらゆる特殊なトラフィックやシステム制限を上書きするものでもありません。
日常的にルールで通信を振り分ける場合は、設定内容を確認したうえでConfigを使うのがおすすめです。ProxyやDirectは、同じ接続先を別の経路で比較するなど、問題の範囲を絞るために使えますが、ルールを理解する代わりにはなりません。Proxyでは正常でConfigでは失敗する場合は、Configで照合されたルール、ポリシーの参照先、最終ポリシーを確認してください。3つの状態すべてで失敗する場合は、ルールだけを疑わず、現在のネットワーク、サーバー、接続先サービスを優先して確認します。
| 画面の状態 | 主な用途 | 確認するポイント |
|---|---|---|
| Config | 設定に基づくルール振り分け | 現在のファイル、照合されたルール、ポリシー |
| Proxy | プロキシ経由の結果を比較 | 既存サーバーで実際のリクエストを完了できるか |
| Direct | 直接接続の結果を比較 | ローカルネットワークから接続先に到達できるか |
ルールは件数より順序が重要
Configでは、通常はルールの順番に照合され、最初に一致した項目のポリシーが適用されます。そのため、詳細な例外ルールは広範囲に一致するルールより前に配置し、FINALはルールの末尾に置くのが一般的です。広範囲のルールを先に置くと、後ろにある詳細なルールが照合されないことがあります。ルールを増やしても自動的に精度が上がるわけではなく、条件の重複で問題の切り分けが難しくなる場合もあります。変更前に、現在のルールがなぜ想定どおりに動作していないのか確認してください。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY
この例は構文と順序を示すもので、すべてのネットワークで使える完全な設定ではありません。DOMAIN-SUFFIXは指定ドメインとそのサブドメインに一致し、DOMAIN-KEYWORDはドメイン名に含まれるキーワードで照合します。後者は想定より広い範囲に一致する場合があります。IP-CIDRはIPアドレスの範囲を対象とし、GEOIPはIPアドレスの地理情報データベースを参照します。FINALは、前のルールに一致しなかったリクエストに最終ポリシーを適用します。例にあるexample.comは説明用であり、読み込み可能なサービス情報ではありません。
ポリシー、名前解決、ネットワークの境界
PROXY、DIRECT、REJECTは、それぞれ異なる処理ポリシーです。PROXYには利用可能なプロキシ経路が必要です。DIRECTは現在のローカルネットワークに依存し、REJECTは一致したリクエストを明示的にブロックします。カスタムポリシー名を使う場合は、設定内に対応する定義が必要です。名前の表記が異なると参照エラーになることがあります。トラブルシューティングでは、まず意味を理解できる基本的なポリシーで動作を確認し、その後で複雑なポリシー選択を調べてください。名前だけから、実際にどのサーバーを指すのか判断しないでください。
ドメインルールとアドレスルールの動作も異なります。リクエストにドメイン名が保持されていれば、ドメインルールで直接照合できます。アドレスで判定する場合は、名前解決の結果やアドレス範囲が関係することがあります。同じサービスが複数のドメインや動的なアドレスを使う場合、ひとつのアドレスだけにルールを設定してもすべてのリクエストをカバーできるとは限りません。ページの一部が読み込めない場合は、ブラウザーのアドレスバーに表示されるメインドメインだけでなく、失敗している接続先を調べてください。ログイン、画像、APIで異なるホスト名が使われることがあります。
設定ファイルの管理に関する推奨事項
リモート設定とローカルでの変更は分けて管理してください。更新によって置き換えられるファイルを直接編集すると、次回の更新で変更が失われることがあります。一方、ローカルコピーだけを使い続けると、元の設定に必要な更新が反映されない場合があります。ファイルの入手元、更新方法、自分が変更した箇所を明確にしておきましょう。例外ルールには用途を書き、元のファイルを保管し、少数の実際の接続先で動作を検証します。基本的な手順はクイックスタートのConfigと接続の手順をご覧ください。
設定を更新した後は、ファイルが保存できるかだけでなく、Global Routing、選択中のファイル、テスト先も改めて確認してください。ルールの動作が突然変わった場合は、まず変更内容を比較し、その後にサーバーを調べます。Settings全体をすぐにリセットする必要はありません。ルールキーワードの意味は用語集をご覧ください。この章の推奨事項は、固定のルール一式を提示するものではありません。Configを実際の目的に合わせ、例外ごとに検証可能な理由を持たせ、変更をいつでも元に戻せるようにすることが大切です。
[On Demand]
4. On Demandによるオンデマンド接続
オンデマンド接続はサーバーの常時利用を保証しない
On Demandは、システムがサポートする条件に応じて接続を開始する機能です。「いつ接続を試みるか」を扱うものであり、サーバー認証の問題を修復したり、既存のサブスクリプションを更新したり、接続先へのアクセスを保証したりする機能ではありません。有効にしても、利用可能な設定、サーバー、ネットワーク権限が必要です。接続と切断が繰り返される場合は、条件が何度も一致しているのか、接続自体に失敗しているのかを切り分けてください。再接続をすべてスイッチの不具合とみなすと、実際のネットワークや設定の問題を見落とします。
オンデマンド接続の対応状況や表示方法は、システムによって異なる場合があります。この章では主にiPhone / iPadの設定確認方法を説明します。具体的な条件は現在の画面に従ってください。ほかのプラットフォームで完全に同じスイッチを探す必要はありません。初期状態は端末の現在の設定を確認してください。古い端末から移行した場合も、新規インストール時の状態だと決めつけないようにしましょう。まず自動接続の影響を受けない状態で手動接続を検証し、その後でOn Demandを有効にするか判断することをおすすめします。
手動接続の基準からオンデマンド条件へ
まずHomeで選択中のサーバーを確認し、Global RoutingとConfigを確認してから、手動で接続して実際の接続先にアクセスします。この一連の手順が安定してから、On Demandの条件を確認してください。現在の画面でネットワークの種類や名前に応じた動作を設定できる場合は、信頼できるネットワークで接続が必要か、モバイルネットワークで接続を開始するかなど、意図を項目ごとに記録します。自分のネットワーク環境に当てはまらない条件をそのまま使ったり、識別できないネットワーク名だけを判断材料にしたりしないでください。
Wi-Fiネットワーク名だけでは、そのネットワークが信頼できることを証明できません。同じ名前のネットワークが別の場所に存在することもあります。ネットワーク条件に基づいて接続する場合は、実際の環境と利用要件を考慮してください。名前の一致を本人確認の代わりにしないでください。職場の端末や管理対象の端末では、管理者が設定したネットワーク構成や権限も考慮する必要があります。端末に別のネットワーク管理ポリシーがある場合は、その影響を確認してからShadowrocketを変更してください。複数のポリシーが互いに上書きし、最終状態が分からなくなるのを防げます。
ネットワーク切り替え後の確認手順
実際に起こりうる状態変化をテストします。Wi-Fiからモバイルネットワークへの切り替え、元のネットワークへの復帰、一時的な切断後の再接続を確認してください。切り替えのたびに、まず端末が通常どおりインターネットに接続できる状態かを確かめ、次にShadowrocketが想定どおりに接続を開始するかを確認し、最後に接続先へのアクセスを検証します。ネットワーク側でログインが必要な状態や、利用可能なアドレスがまだ割り当てられていない状態では、接続に失敗してもOn Demandの条件が誤っているとは限りません。早まって何度も切り替えると、原因を特定しにくくなります。
Web認証が必要なネットワークでは、特に手順を分けてください。まずネットワーク自体へのログインを完了し、その後でプロキシ接続をテストします。ログイン前に接続を繰り返し開始すると、接続状態は変わってもページが開かないことがあります。テスト中はサブスクリプションの更新、設定の切り替え、サーバーの変更を同時に行わないでください。切り替えの前後関係と時刻を記録しておくと、ネットワークの準備が整っていないのか、条件に一致しないのか、接続は始まったもののリモート側が応答していないのかを判断しやすくなります。
バックグラウンド動作、バッテリー消費、復旧方法
On Demandを有効にしても、アプリ画面が常に前面に表示されるわけではなく、すべてのバックグラウンドタスクをクライアントが維持するわけでもありません。システムのスケジュール、ネットワークの変化、アプリの動作、接続失敗後の再試行などが、バッテリー消費の見え方に影響します。有効にしてから消費量が明らかに変わった場合は、同程度の使用状況で接続回数、ネットワーク切り替えの頻度、失敗の状況を比較してください。ある時点のバッテリー残量だけで判断しないようにしましょう。長時間の診断記録もテスト終了後は日常の状態に戻してください。
用途を明確に説明できる条件だけを設定し、無効にした後も手動で接続できるようにしておくことをおすすめします。理由の分からない接続が繰り返される場合は、まずOn Demandを一時停止し、手動接続が正常か確認してください。手動でも失敗するなら、サーバー、DNS、ルールを調べます。手動接続が正常で自動接続だけに問題がある場合は、条件をひとつずつ戻し、再現に必要な最小限の組み合わせを特定します。判断材料を失うおそれがあるため、ネットワークデータをすべて削除して代用しないでください。
最終確認では、手動切断後に想定した動作をするか、ネットワーク変化後に接続が開始されるか、実際のリクエストに正しいポリシーが適用されるかを確認します。接続をすばやく操作したいだけであれば、自動接続は不要かもしれません。その場合は後述のWidgetをご覧ください。接続先ごとにリクエストを振り分けたい場合は、On Demandの条件を増やすのではなくConfigを調整します。「いつ接続するか」と「接続後にリクエストをどう処理するか」を分けると設定を管理しやすくなり、ルールの問題を接続トリガーの問題と取り違えにくくなります。
[Connectivity Test]
5. Pingと接続テスト
テストで何を確認したかを把握する
Ping、Connectivity Test、実際のWebサイトへのアクセスは、それぞれ異なるテストです。テスト方法によって、ホストの応答、特定ポートへの接続、指定経路を通じたリクエストの完了など、確認する範囲が異なります。短い応答時間が表示されても、それはそのテストが対象とした処理の応答が速かったことを示すだけで、すべてのWebサイトの表示速度を表すわけではありません。トラブルシューティングの前に、選択中のテスト方法、接続先、選択中のサーバーを経由するかを確認してください。リストの数値だけで比較しないようにしましょう。
ネットワークによっては特定のプローブに応答しなくても、実際のアプリのリクエストは完了する場合があります。サーバーアドレスへの接続が成立しても、認証やその後の通信に失敗することもあります。そのため、単一のテスト失敗だけを理由にサーバーを削除しないでください。単一のテストに成功しても、実際のアクセス確認の代わりにはなりません。テストは、基礎となるネットワークが使えるか、サーバーへの接続が成立するか、接続先アプリへのリクエストが完了するか、という3段階に分けて結果を記録します。ひとつの「タイムアウト」で全ての現象をまとめないでください。
テスト方法、接続先、待ち時間
現在の画面でPingなどのテスト方法を選べる場合は、まず現在の選択または初期値を基準として残し、説明を確認します。変更が必要な場合は、接続先を固定し、テストの意味を理解したうえで行ってください。テスト先には、安定していてアクセスが許可され、利用状況に関係するものを選びます。ログインが必要なページ、頻繁にリダイレクトするページ、プローブを制限する可能性があるページを、すべてのサーバーに共通する基準として使わないでください。特定の接続先に届かないのは、その接続先の応答ポリシーや一時的な状態が原因かもしれません。
タイムアウトのしきい値は、むやみに短くせず実際のネットワークに合わせてください。短すぎると、遅くても利用できる接続を失敗と判定することがあります。長すぎると問題の検出が遅れます。明確な必要性がない場合は現在の初期値を保ち、根拠のない共通の数値を入力しないことをおすすめします。変更が必要なら元の値を記録し、複数回のテスト結果の分布を確認してください。一度だけ極端に速い、または遅い結果が出ても、Wi-Fiの電波、モバイルネットワークの切り替え、同時実行中のタスクが影響した可能性があり、長期的な結論にはなりません。
| テストの段階 | 判断材料になること | 直接は判断できないこと |
|---|---|---|
| ホストまたはポートの応答 | 基礎となる経路のひとつが現在応答している | 認証が正しいこと、接続先Webサイトが利用可能であること |
| サーバー経由でリクエストを完了 | そのサーバーと接続先の組み合わせが利用可能である | すべての接続先とプロトコルが正常である |
| 実際のアプリ操作 | 現在の利用状況におけるアクセス結果 | ほかのネットワークでも同じ結果になる |
有効な比較テストの方法
既存サーバーを比較するときは、端末、ネットワーク、テスト先、テスト方法を固定し、不要な大容量通信を止めてから、間隔を空けて複数回テストします。Wi-Fiを切り替えながら比較しないでください。また、異なるテスト方法で得た数値を同じ基準で並べないようにしましょう。ポリシーを自動選択する設定では、各テストが同じ経路を実際に使っていることも確認してください。同じ項目を比較しているように見えても、処理経路が変わっている可能性があります。
テストに成功してもアプリにアクセスできない場合、速度測定を繰り返すのではなく、アプリの接続先と照合されたルールを確認します。特定のプロトコル設定だけ失敗する場合は、そのプロトコルの認証、通信方式、TLS条件を確認してください。プロトコル名が同じでも、設定項目をそのまま入れ替えられるとは限りません。たとえば、サーバーのホスト名、TLSで使う名前、実際の接続先アドレスは、それぞれ異なる役割を持つ場合があります。既存の設定タイプを確認するには、Shadowrocketの対応プロトコル解説をご覧ください。
テスト結果を実際の利用に結びつける
一括テストは追加のリクエストを発生させるため、頻繁に行っても判断の質が上がるとは限りません。通常は問題が起きたときに関連する項目を少数選んでテストし、ログと合わせて原因を調べます。テスト先自体に障害がある場合は、別の接続先で比較し直してください。サブスクリプションの更新に成功したということは、設定情報を取得できたことを示すだけで、含まれるすべてのサーバーが現在のネットワークで動作する保証にはなりません。更新と接続確認は別々に行ってください。
テスト後は日常的に使うサーバーとGlobal Routingに戻し、一時的な比較状態を残さないようにしてください。長期間繰り返す問題については、遅延時間だけの画像を保存するより、発生時のネットワーク、テスト方法、エラーの種類、失敗した操作を記録するほうが役立ちます。最後に、同じページを開いて必要な操作を完了するなど、繰り返し実行できる実際の操作で確認します。テストボタンだけが成功し、利用目的の操作が失敗する場合は、Logとルールを調べ、問題が解決したと判断しないでください。
[Log]
6. Log、Data、トラブルシューティング
ログでリクエストの処理過程をたどる
Logは記録を増やすためではなく、失敗がどの段階で起きたかを特定するために役立ちます。診断を始める前に、再現手順を明確にします。現在のネットワーク、選択中の設定、サーバー、Global Routing、アクセスできない接続先を記録してください。その後、現在の画面で利用できるログの表示または記録開始機能を使い、関連する操作を一度実行します。関係のないリクエストが大量に発生している中から失敗記録を探さないでください。特に複数のアプリを同時に開き、背景の動作を見分けにくくすることは避けましょう。
ログの項目は記録の種類やプラットフォームによって異なります。接続先の名前とアドレス、照合されたポリシー、接続状態、エラーメッセージを中心に確認してください。内容を解釈する前に、その記録が現在のテストに対応しているか確かめます。時刻が近いからといって、同じリクエストとは限りません。ページが複数のAPIを同時に呼び出すこともあります。ひとつの失敗記録がページ全体の失敗につながるとは限らず、ひとつの成功記録もすべてのリソースの読み込み完了を示すわけではありません。実際に見えている現象と合わせて判断してください。
キーワードから推測せず、発生した段階ごとに確認する
名前解決に関するエラーでは、まずDNSとネットワーク条件を確認します。接続タイムアウトでは、接続先アドレス、ポート、処理経路を確認してください。認証エラーは既存のサーバー情報に戻って確認し、TLSエラーではシステム時刻、名前、証明書の条件を確認します。エラーメッセージは手がかりですが、原因をひとつに断定できるものではありません。たとえばタイムアウトは、端末からサーバーまでの間でも、その後の接続先への通信でも発生します。前後の記録から発生箇所を判断し、「タイムアウト」という表示だけで設定をすべて変更しないでください。
TrojanなどTLS条件を含む設定では、ユーザーが持っているサーバー情報をもとに、パスワード、SNI、関連項目を確認してください。Allow Insecureを汎用的な修復スイッチとして使わないでください。検証を省略すると接続のセキュリティ境界が変わり、ホスト名の誤りやサーバー側の設定問題を見逃すこともあります。各項目の役割はTrojanの設定項目解説をご覧ください。ログは正しい項目を確認するために使い、問題と関係のない設定を緩める根拠にしないでください。
| 手がかり | 次の手順 | 記録する情報 |
|---|---|---|
| 名前解決に失敗 | DNSと現在のネットワークを確認 | 検索した接続先とエラーの原文 |
| ルールの結果が想定と異なる | Configとルールの順番を確認 | 一致したルールと実際のポリシー |
| 認証またはTLSに失敗 | サーバー情報を項目ごとに確認 | プロトコルの種類と関連エラー |
| 接続が途中で切れる | ネットワーク切り替えと切断のタイミングを比較 | 発生条件と再現手順 |
Dataの統計は接続サービスの課金情報ではない
Dataに表示される通信量や接続の統計は、現在の画面に示された範囲に従って解釈してください。統計が特定の期間、接続、アプリの記録に対応している場合があり、サービス提供者のアカウントに表示される使用量と直接一致するとは限りません。トンネルのオーバーヘッド、再試行、集計の開始・終了時刻、サーバー側の集計方法などによって差が生じることがあります。数値が不自然に見える場合は、まず集計範囲とリセット履歴を確認し、その後にバックグラウンド動作を調べてください。累計値ひとつだけで、特定の接続先が通信量全体を発生させたと判断しないでください。
変更前後を比較するには、まず初期値を記録し、ひとつの操作だけを実行して変化を確認します。ローカル統計を消去する場合は、診断に必要な情報が失われないことを確認してください。数値を正常に見せるために何度もリセットしないでください。トラブルの調査に必要な時間的な関係が分からなくなります。リクエストが継続して発生していると思われる場合は、ほかのアプリの動作を一時的に減らし、接続を停止する前後の変化を比較できます。ただし、発生元の特定には実際のリクエスト記録も必要です。
診断記録のプライバシーと保存
ログには、アクセスしたドメイン、サーバーアドレス、ローカルネットワークのアドレス、サブスクリプション情報、リクエストパラメーターなどが含まれることがあります。共有前に必要な部分だけを抜き出し、認証情報、サブスクリプションURL全体、個人のアカウントを特定できる情報を削除してください。その際、エラーの種類と必要な前後関係は残します。機密情報を一部だけ塗りつぶしても、構造から復元できる場合があります。明確なサンプル値に置き換え、置換済みであることを明記すると、例を実際の接続情報と誤解されにくくなります。
診断が終わったら、ログの詳細度を日常的に必要な状態へ戻し、必要に応じてローカルの記録を整理してください。詳細なログを長期間保存するとストレージを消費するだけでなく、保護すべき情報の範囲も広がります。問題が解決しない場合は、変更前後の状態、1回の操作、対応するエラー、確認済みの原因候補をまとめた最小限の再現手順を作成し、よくある質問と照らし合わせてください。選別されていない記録一式をそのまま渡すより、重要な条件を見落としにくく、内容も確認しやすくなります。
[iCloud]
7. iCloud、バックアップ、Widget
同期、バックアップ、エクスポートの役割
iCloud同期は、条件を満たす端末間でアプリが対応するデータを転送する機能です。バックアップは復元可能な状態を保ち、エクスポートは明示的なファイルのコピーを作成します。これらは相互に置き換えられるものではありません。同期中の削除や変更がほかの端末にも反映されることがあるため、別の端末から見えるだけでは、独立した履歴バックアップが保存されたとはいえません。重要な変更の前に、内容を識別できるローカルコピーを保管し、何が含まれているか確認してください。同期スイッチがオンかどうかだけで判断しないようにしましょう。
この章のiCloudに関する説明は、該当機能とシステム要件を満たす端末を対象としています。すべてのプラットフォームで同じ同期方式が使われるという意味ではありません。初回設定時は、システムアカウント、iCloudの利用状況、ネットワーク、空き容量を確認し、その後アプリが実際に提供する同期項目を確認してください。有効かどうかは端末の現在の状態に従います。特に古い端末からの移行後や、アカウントへの再ログイン後は注意してください。同期するデータの範囲を確認してから有効にし、識別可能で機密性のない変更をひとつ試して、転送を確認することをおすすめします。
別途保管が必要なデータ
設定ファイルには通常ルールや関連設定が含まれますが、エクスポートしたファイルにサーバー、サブスクリプション、アプリ設定、システム権限がすべて含まれるとは限りません。エクスポート前に現在の画面の説明を確認し、エクスポート後は実際の内容を確かめてください。認証情報を含むファイルは安全に保管し、公開ディレクトリに置いたり公開共有したりしないでください。ファイルにルールしか含まれない場合、新しい端末ではユーザー自身が持つサブスクリプションやサーバー情報を改めて取得する必要があるかもしれません。読み込みに成功しただけで、すべての復元が完了したと判断しないでください。
既存のサブスクリプションの更新URLも適切に保護してください。アカウントを識別する情報が含まれていることがあり、そのURLにアクセスできる人が関連設定を取得できる可能性があります。バックアップ時は、設定ファイルのコピーとサブスクリプションの入手元を明確に分け、実際のURLを公開の問い合わせに貼り付けないようにしましょう。書式の説明にはサンプル値を使い、復元時は自分で安全に保管した記録から実際の内容を取得してください。当サイトでは読み込みと保存の方法のみを案内し、サブスクリプションやサーバー情報は提供していません。
複数端末での変更と復元確認
2台の端末で同じ設定を同時に編集すると、内容の上書き、反映の時間差、競合コピーが発生することがあります。その場合は並行編集をいったん停止し、両方の端末の現在の内容をそれぞれ保存してから、基準にする一方を選び、項目ごとに統合します。ファイル名が同じだから内容も一致していると決めつけたり、同期のオン・オフを繰り返せば競合が自動修復されると考えたりしないでください。必要なルール、サーバー参照、メモを先に確認すると、上書き後に復元できなくなるリスクを減らせます。
端末を買い替える際は、まず旧端末で独立したエクスポートを行い、新端末で同期または読み込みの結果を確認してから接続を検証してください。サーバー一覧、サブスクリプションの更新、現在のConfig、Global Routing、On Demand、必要なシステム権限を順番に確認します。新しい端末でシステム権限の再確認が必要な場合もあり、ファイルのコピーでは代用できません。詳しい手順は設定のバックアップと端末移行後の復元をご覧ください。確認が完了するまでは、旧端末のデータを急いで消去しないでください。
Widgetの状態と操作範囲
Widgetは、システムで許可された場所に、アプリが対応する項目を表示したり、すばやく操作したりするためのものです。補助的な入口であり、独立した接続エンジンではありません。また、Homeでのサーバー選択やConfigの確認に代わるものでもありません。表示内容、更新タイミング、操作機能は、システムや現在の画面が対応する範囲によって異なります。状態がすぐに変わらない場合は、Shadowrocketを開いて実際の接続状態を確認し、Widgetの表示更新が遅れているだけか判断してください。ホーム画面の表示だけから接続が停止したと決めつけないでください。
Widgetを追加したら、制御した状態で一度検証します。アプリ内の状態を記録し、Widgetから操作した後、アプリに戻って結果を確認し、テスト先へアクセスしてください。On Demandも有効な場合は、手動で切断しても条件が再び満たされ、接続が再開することがあります。そのため、Widgetの操作が維持されなかったように見えて、実際には自動接続が再度有効になっている可能性があります。この場合はWidgetを何度も削除して追加するのではなく、まずオンデマンド条件を確認してください。Widgetはすばやい操作、On Demandは条件に応じた接続開始を担い、役割は異なります。
ショートカットが不要であればWidgetを追加しなくてもかまいません。ルール自体には影響しません。ほかの人に見られたくないサーバー名や状態が表示される場合は、表示内容や配置場所を変更してください。日常の管理では、自動化された入口を増やしすぎず、接続の操作方法を分かりやすく保つことをおすすめします。アプリ内の操作は状態確認、Widgetは手軽な操作、On Demandは条件に応じた接続に使います。それぞれの役割を明確にし、複数の操作方法が重なって最終状態を判断しにくくならないようにしてください。
[Proxy]
8. Proxyポートとローカルネットワークの境界
ローカルポートとサーバーポートは別のもの
Proxy関連のポートは、ほかのアプリにプロキシ接続を提供する際に端末上で待ち受ける入口です。Add Serverにあるリモートサーバーへの接続ポートとは別の概念です。ローカルポートを変更しても、リモート側の認証や通信設定は修復されません。リモートポートを変更しても、端末上のアプリのプロキシ設定は自動的に変わりません。トラブルを調べる前に、リクエストの発信元、接続するアドレスとポート、その入口が受け付けるプロトコルを確認してください。ひとつのポート番号だけを記録するより、この3点をすべて書き留めるほうが確実です。
すべてのプラットフォームで同じローカル待ち受け項目が使えるとは限りません。名称や場所は実際の画面で確認してください。HTTPとSOCKS5の入口は、ポート番号が近いからといって相互に置き換えられるわけではありません。利用側に設定するプロキシの種類は、待ち受け側と一致させる必要があります。初期ポートは現在のSettingsで確認してください。このページでは、すべての端末に共通する数値を指定しません。通常は端末内で接続し、ほかのアプリに明示的なプロキシ設定を使う必要がない場合、関連設定はそのままにし、トラブルシューティングのためだけに新たなネットワーク入口を有効にしないことをおすすめします。
アドレス範囲でアクセス可能な相手が決まる
端末内だけで使う場合と、ローカルネットワーク上の端末から使えるようにする場合では、セキュリティ上の範囲が異なります。ループバックアドレスは端末内の通信に使われ、ローカルネットワークのアドレスはネットワーク上の端末との通信に使われます。より広いアドレス範囲で待ち受けると、同じネットワーク上のほかの端末からサービスに接続される可能性があります。ローカルネットワークからのアクセスを許可する項目がある場合は、有効にする前に利用者とネットワーク環境を確認し、システムのファイアウォールやアプリのアクセス制御を確認してください。同じWi-Fiにつながっているからといって、すべての端末にアクセスを許可する必要はありません。
実際に必要な最小範囲にアクセスを制限することをおすすめします。自分の別の端末から使う必要がある場合は、双方が通信できるネットワークに接続していることを確認し、サービスを提供する端末の現在のローカルネットワークアドレスを記録してから、利用側に正しいプロトコルとポートを設定してください。そのアドレスをリモートサーバーのアドレスと取り違えたり、ループバックアドレスを別の端末に設定したりしないでください。別の端末から見たループバックアドレスはその端末自身を指すため、Shadowrocketを実行している端末には接続されません。
ポートの競合とプロキシループ
待ち受けを開始できない場合は、ポートがほかのプロセスに使われている、アドレスが利用できない、システム権限が不足しているなどの原因が考えられます。まず現在のエラーと端末上で動作しているサービスを確認し、そのうえでポートの変更が必要か判断してください。変更した場合は、その入口を使うすべてのアプリの設定も更新する必要があります。ポートを手当たり次第に変更しても、原因の特定にはなりません。用途の分からないシステムサービスを停止することも避けてください。競合している対象とその用途を確認すれば、ほかの機能への影響を防げます。
明示的なプロキシ設定によって、接続がループすることもあります。リクエストがローカルの入口に送られ、その入口に関連する接続も同じ処理経路へ戻される場合です。接続が繰り返し表示される、リクエストが完了しない、リソース使用量が異常に増えるといった現象が起こることがあります。この場合は、まず最近追加した利用側のプロキシ設定を取り消し、接続経路をひとつに戻してから、必要な要素を段階的に追加します。システムのプロキシ、アプリのプロキシ、ローカルネットワーク転送を複数同時に有効にしてから、リクエストの経路を推測しようとしないでください。
| 確認項目 | 推奨基準 | 失敗した場合に優先する対応 |
|---|---|---|
| 待ち受けアドレス | 必要な範囲だけを公開する | 端末内アドレスとローカルネットワークアドレスを区別する |
| プロキシの種類 | 利用側の設定を待ち受け側に合わせる | HTTPまたはSOCKS5を確認する |
| 待ち受けポート | 競合を避け、利用可能な現在値を維持する | ポートの使用状況と利用側の設定値を確認する |
| 接続経路 | 各階層の接続先を明確にする | 追加した設定を取り消し、ループを確認する |
リモート名前解決と利用側の違い
あるアプリがプロキシ経由でドメインを名前解決するかどうかは、利用側の実装とプロキシの種類にもよります。ShadowrocketでDNSを変更しただけで、明示的なプロキシを使うすべてのアプリが同じ経路で名前解決するとは限りません。端末上のアプリでは正常なのに、ローカルネットワーク上の利用側で失敗する場合は、利用側が先に独自の名前解決をしていないか、ネットワーク上で端末間通信が許可されているか、待ち受けが起動しているか、対象のリクエストがログに記録されているかを個別に確認してください。対応するリクエストがログにまったくない場合は、リモートサーバーではなく、まず入口までの経路を調べます。
モバイル端末のネットワークアドレス、バックグラウンド条件、接続状態は変化することがあります。一時的に使えるローカルネットワークの入口を、恒久的なサービスとして扱わないでください。ネットワークを切り替えた後は、新しいアドレスと現在の接続状態を確認してから利用側でテストします。一時的な作業が終わったら、不要になったローカルネットワークへのアクセスを無効にし、利用側に残ったプロキシ設定も削除してください。存在しない入口への接続を防げます。信頼できないネットワークでは、必要以上のアクセス範囲を許可しないでください。
設定全体を確認する順序
最後は依存関係に沿って確認します。まず基礎となるネットワークと既存のサーバー情報を確認し、次にConfig、Global Routing、DNSを見直します。その後On Demandを確認し、最後にWidgetやローカルProxyなどの補助的な入口を検証してください。各段階で同じ接続先を使って結果を記録し、失敗した場合は直近の正常な状態まで戻します。クライアントを再入手する場合や、システムの許可手順を確認する場合は、ダウンロードページのインストールガイドをご覧ください。日常的な操作に慣れていない場合は、クイックスタートをご覧ください。すべての設定をリセットする必要はありません。