公式マニュアルSettingsガイド

Shadowrocket 設定ガイド

自分のサブスクリプションやサーバー情報を読み込んだ後、設定項目の影響を確認したい場合は、このページで項目ごとに調べられます。現在の値を維持する場合や変更する場合、変更後の確認方法を説明します。初回接続がまだの場合は、使い方の読み込み、モード選択、接続手順を先に進めてから、該当する項目をご覧ください。

主にiPhone / iPad版の画面表示をもとに説明します。Mac、Windows、Android、Linuxでは画面の項目や選択肢が異なる場合があるため、実際のクライアントの表示をご確認ください。問題がどの段階にあるかを先に調べる場合は、Logを使った調査手順をご覧ください。

01 設定の基本

SettingsとGlobal Routing

設定が保存される場所を見分ける

「変更したのに接続が変わらない」ときは、まず4つの状態を切り分けます。Settingsはクライアントやシステム連携に関する設定を管理します。Homeには接続状態、選択中のサーバー、Global Routingのモードが表示されます。Config内のファイルでは、ルール、ポリシー、名前解決の設定を定義できます。システムのVPN構成は、接続に必要な許可に関係します。ファイルの編集画面を開いただけでは、そのファイルが現在の設定になったとは限りません。サーバー項目を変更しても、Homeでそのサーバーが選択されているとは限りません。

「デフォルト値」を調べるときは、インストール直後の初期状態、読み込みや復元後に実際に適用されている値、このマニュアルで推奨する開始値を区別してください。以前の設定、同期からの復元、現在の構成によって、実際の動作は変わります。クライアントにデフォルト値が明記されていない場合、別の端末の画面から推測する必要はありません。確認のために既存の設定を消す必要もありません。画面に表示されている値、現在のネットワーク、モード、構成名を記録しておきましょう。この基準があれば、変更ごとの結果を比較できます。

検証目的に合わせて3つのモードを使い分ける

画面表示モード確認できること
Config設定現在のルールがどのように一致し、一致後にどのポリシーへ渡されるか。
Proxyプロキシルール選択に依存せず、現在のプロキシ経路でリクエストを処理できるか。
Direct直結プロキシを経由せず、現在のネットワークから同じ宛先へアクセスできるか。

日常的に通信を振り分ける場合は、Configを使い、まず現在のファイルを確認することをおすすめします。他の2つのモードは比較用に使えますが、互いの代わりとなる修正方法ではありません。Directにしても、システムVPNがオフになるわけではありません。接続を切ると、ほかの条件も変わります。比較には、直結が許可されていると確認できるテスト先だけを使い、特定の経路が必要な業務リクエストで試さないでください。同じネットワーク、端末、宛先で一連の確認を行ってから元のモードに戻します。モードの切り替えと同時にネットワークやサーバーを変更しないでください。詳しくはプロキシモードをご覧ください。

設定ファイルのルール適用順を理解する

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

これは読み方を説明するための.confの例で、既存の設定を置き換える完全なファイルではありません。1行目のルールはexample.comとそのサブドメインに一致します。2行目は宛先IPを地理情報データベースで判定するもので、サイトの言語やドメインの末尾で判定するルールではありません。最後の行は、それまでのルールに一致しなかったリクエストを処理します。実際の設定では、PROXYに対応する利用可能なプロキシポリシーが必要です。広い範囲に一致するルールを例外より先に置くと、後続の例外が適用されない場合があります。フォールバックを先に置いた場合も、後続のルールが機能しなくなることがあります。

特定のサイトの問題を調べるときは、Logで実際のリクエスト先のホスト名を確認してからルールと照合してください。ブラウザーのアドレスバーだけでは判断できません。1つのページからログイン、メディア、静的ファイル用の複数のドメインへリクエストが送られる場合があります。メインのページが想定どおりのポリシーに一致していても、関連するリクエストも同じとは限りません。外部から提供された設定ファイルを使っている場合は、更新時にローカルの変更が上書きされるか先に確認してください。試す場合は元のファイルを残し、復元できる複製で1つのルールだけ変更します。選択し直したファイルが元のファイルではなく複製であることも確認してください。

再現できるように記録を残す

「変更前の結果、変更した項目、変更後の結果、元に戻す方法」を記録します。1つのテストを終えてから次へ進めば、どの変更で改善したかを切り分けられます。

たとえば、ウェブページは開くのにログインできない場合、現在のサーバーとネットワークを維持してConfigモードで再現し、失敗したおおよその時刻とポリシーを記録します。次に、直結が許可されているテスト先で現在のネットワークを確認します。ルールの不一致だと分かってからファイルを編集してください。接続スイッチをオンのままにできない場合は、FINALを変更せず、接続の許可を先に確認します。Homeが接続中と表示していても、ネットワークを切り替えた後だけ問題が起きる場合は、設定を維持したまま、このページのOn Demandで発動条件を確認してください。

プラットフォーム間で設定を移すときは、ボタンの位置をそろえるのではなく、同じ機能を見つけることを目指してください。iPhone / iPad版はApp Store製品ページから入手できます。価格は$2.99の買い切りで、システム要件はApp Storeの表示をご確認ください。Mac(Appleシリコン / Intel)、Windows、Android、Linux版は無料で、インストーラーは当サイトの全プラットフォーム向けダウンロードページから入手できます。クライアントの買い切り料金は、接続サービスの料金とは別です。当サイトではサーバーやサブスクリプションを提供、販売、推奨していません。以降の説明は、ご自身の接続情報をお持ちであることを前提としています。

02 名前解決

DNS:名前解決の方式と問題の切り分け

まず、どの名前を解決する必要があるか確認する

1回のアクセスでは、少なくとも2種類の名前が関係することがあります。既存サーバー自体のホスト名と、ウェブサイトやアプリが接続する宛先ドメインです。前者の名前解決に失敗すると、プロキシ経路を確立できない場合があります。後者に失敗した場合は、既存サーバーのテストには成功しても、特定のサービスにアクセスできないことがあります。宛先の名前解決を端末側と上流側のどちらが行うかは、選択した経路、プロトコル、設定によって異なります。DNSの項目1つだけでは判断できません。どの名前の、どの段階で失敗したかを確認してから、サーバーアドレス、名前解決元、ルールのどれを調べるか決めましょう。

まずは現在安定して動作している名前解決方式を維持してください。独自の要件がなければ、入力欄を埋めるためだけに設定を追加する必要はありません。既存の設定ファイルに名前解決の指定がある場合は、その内容とシステムのネットワーク設定を分けて記録してください。「現在のネットワークに従う」「設定ファイルで明示的に指定する」「選択した経路に応じて上流で処理する」は、それぞれ異なる状態です。空欄でも、特定の固定アドレスを使うとは限りません。端末間で比較する場合は、見た目が似た入力欄だけでなく、両方の端末で同じ設定ファイルと同種のネットワークを使っているか確認してください。

公開ドメインと内部ドメインを分けて考える

家庭用ルーターが割り当てるローカルドメイン、組織内の内部ドメイン、公開ドメインは、それぞれ異なるDNSサーバーから応答を受ける場合があります。既存の名前解決設定をすべて公開DNSサービスに置き換えると、公開サイトにはアクセスできても、プリンターや内部サイトが見つからなくなることがあります。元のネットワークで内部リソースへのアクセスが必要なら、ネットワーク管理者が指定した宛先で確認し、元の設定を維持してください。名前を解決できても、宛先が利用できるとは限りません。同じ内部名でもネットワークによって異なるアドレスが返ることがあり、外部DNSが返したアドレスが内部サービスに適しているとも限りません。

既存の設定でDoHやDoTが必要な場合は、その設定に合った形式を使い、エンドポイント、プロトコル、ネットワークからの到達性を確認してください。暗号化DNSのエンドポイント自体がドメイン名を使う場合、接続前にその名前を解決する必要があることがあります。最初の名前解決経路が利用できなければ、暗号化エンドポイントに切り替えても自動的に解決できるようにはなりません。証明書エラーを検証の緩和で回避するのも適切ではありません。まずシステムの日付と時刻、エンドポイントの入力、接続中のネットワークを確認し、その後で設定要件と照合してください。元に戻すときは、名前解決方式とアドレスの両方を元の値に戻し、片方だけを戻し忘れないようにしてください。

タイムアウト、応答なし、アドレスへの到達不可を切り分ける

状況優先して確認することすぐに決めつけないこと
クエリがタイムアウトする現在のネットワークからDNSサーバーに到達できるか、エンドポイント名を解決できるか。宛先ドメインが存在しない。
必要なレコードが見つからないホスト名の入力、公開・内部の名前解決元、要求したレコードタイプ。接続スイッチの不具合。
アドレスが返っても接続できないアドレスへの到達性、ルールの選択、後続の接続エラー。DNSサーバーを変えれば必ず直る。

AレコードとAAAAレコードは、それぞれIPv4アドレスとIPv6アドレスを返します。片方が見つかっても、もう片方の経路が正常とは限りません。特定の種類のネットワークだけで問題が起きる場合は、失敗した接続で実際に使われたアドレスファミリーを記録してください。最初からアドレスファミリー全体を無効にするのではなく、レコードが存在しないのか、返されたアドレスへの経路が使えないのか、アプリがアドレスを切り替える際に待ちすぎているのかを確認します。比較時に宛先名は変えないでください。ウェブアドレスをIPアドレスに直接書き換えると、TLS証明書の検証やサーバーによる識別方法が変わり、同じ条件でのテストではなくなります。

変更は1か所ずつ行い、キャッシュの影響を考慮する

操作の前に元の名前解決方式を記録し、同じネットワークで安定した公開サイトと実際に失敗する宛先にそれぞれリクエストを送ります。確認したい項目だけを変更し、新しい接続で再試行してください。クライアントで設定の再適用が必要な場合は、先に適用します。古い接続が再利用されている場合は、該当するページを閉じて開き直してください。システム、クライアント、アプリのいずれも以前の結果を保持することがあります。設定を保存した直後も古いアドレスが使われているだけでは、新しい設定が無効とは判断できません。設定をすばやく何度も切り替えるより、新しいリクエストの時刻と確認できる名前解決結果を比べるほうが確実です。

ドメインルールの確認では、リクエストがどのポリシーに渡されたかを調べます。DNSの確認では、名前からどのアドレスが得られたかを調べます。互いに影響することはありますが、同じ検証ではありません。

公開ドメインへのアクセスが改善する一方で内部アクセスが悪化するなら、新しい名前解決方式を全体に適用するのは適切ではありません。複数のサイトに問題がなく特定のアプリだけ失敗する場合は、Logでそのアプリが実際に要求した名前を確認し、独自の名前解決処理を使っていないか検討してください。問題を記録するときは、現象、ネットワークの種類、名前解決方式、個人情報を除いたエラーだけを残し、内部ドメインの一覧は公開しないでください。テストで再現可能な改善が得られなければ、偶然の成功を恒久的な設定にしないよう、元の値に戻します。

03 システムによる接続

On Demand:発動条件、例外、バッテリー消費

接続を試みるタイミングを決める機能で、リクエストの転送先は決めない

On Demandは、条件を満たしたときにシステムが接続を試みるかどうかを制御します。Global Routingは、接続後にリクエストをどのように振り分けるかを制御します。両者は置き換えられません。DOMAIN-SUFFIXを変更してもシステムの発動条件は変わりません。On Demandを有効にしても、業務通信を誤ったポリシーに送るルールは修正されません。Homeから手動接続しても宛先にアクセスできない場合は、自動接続を設定する前に手動接続を正常にしてください。そうしないと、異なる2つの問題が重なってしまいます。

初めて設定するときは、まず手動接続を維持し、元のスイッチの状態を記録してからOn Demandが必要か判断してください。マニュアルの「一時的にオフにする」という推奨を、すべての端末でのインストール時の初期値と取り違えないでください。別の端末から設定を移行した場合や、システムにVPN構成が残っている場合は特に注意が必要です。有効にした後は、アプリとシステムの両方で状態を確認し、同じ接続の項目を見ていることを確かめてください。システムからVPN構成の許可を求められたら、直前の操作が要求を発生させたか確認してください。詳しくはVPN構成の許可についてをご覧ください。

条件を1つ設定し、該当する場合としない場合を試す

まず、よく使うWi-Fiからモバイルネットワークに切り替えてアクセスしたときなど、接続を発動させたい状況を記録します。同時に、指定したローカルネットワークに接続中など、発動させたくない状況も記録してください。現在の画面で明確に設定できる条件だけを使い、別の端末やプラットフォームの条件をそのまま持ち込まないでください。設定後、まず条件に一致しない状況で確認し、次に一致する状況で同じ機密情報を含まないテスト先を開き、最後に最初のネットワークへ戻します。接続が開始されたか、実際に接続できたか、条件から外れた後の状態を毎回記録してください。

自動接続を有効にしても、画面が点灯したりネットワークが切り替わったりするたびに、システムが即座に応答するとは限りません。システムは実際のリクエストが発生するまで条件を適用しない場合があり、ネットワークの認証や切り替えがまだ完了していないこともあります。画面ロック中に状態を確認できない場合は、ロック解除後にHomeの状態、ネットワークの種類、リクエストの記録を照合してください。システムのステータスバーの表示だけで、秒単位の順序を判断しないでください。ロック中の動作を調べる場合は、まず画面を表示した状態で比較を完了し、正常時の結果を記録してから、ロックの有無が重要な違いか判断します。

ホットスポット認証、再接続の繰り返し、手動切断への対処

認証ページを開く必要のある公衆Wi-Fiでは、認証が済むまで通常のアクセスが制限されることがあります。接続を何度も試みて認証ページも開けない場合は、一時的にOn Demandを無効にし、現在の接続を切ってから、そのネットワークの通常の手順で認証を完了し、手動接続を確認してください。ネットワークから離れたら元の設定に戻します。1回のホットスポット接続のために、例外を恒久的に広げないでください。この問題はサーバー自体の障害と似て見えますが、ホットスポットから離れた直後に同じ設定で復旧する場合は、認証を先に調べてください。

手動で切断してすぐ再接続する場合は、切断時も発動条件を満たしていたか、ちょうど新しいリクエストが発生していたかを確認してください。自動接続を一時的に止めたいだけなら、何度も切断を繰り返すより、該当条件を変更するか機能を無効にするほうが効果的です。反対に、自動接続がまったく発動しない場合は、システムの許可、安定したネットワーク、条件との一致を確認してから、制御できるリクエストを送ります。確認中にシステム構成の再作成とサーバー変更を同時に行わないでください。復旧しても、許可、条件、ネットワークのどれが変わったのか特定しにくくなります。

機能名ではなく、条件をそろえてバッテリー消費を比較する

On Demand接続が、あらゆる使い方で省電力になるとは限りません。ネットワークの切り替えが多い、接続を何度も確立し直す、テストを頻繁に行うといった場合、接続を常時維持しない利点が相殺されることがあります。まずシステムのバッテリー使用量でフォアグラウンドとバックグラウンドの動作を確認します。次に、近い時間帯に2回比較します。1回目は手動状態を維持し、2回目はOn Demandだけを変更します。測定頻度、ネットワークの種類、日常的に使うアプリをできるだけそろえ、接続を再確立した回数と時刻を記録してください。短時間の測定や電波の弱い場所で一度起きた異常だけで、長期的な効果を判断することはできません。

推奨設定は利用状況に合わせてください。たまに使う場合は手動接続を維持します。発動条件が明確に必要な場合は、検証できた最小限の条件だけを残します。ネットワークの切り替えが続く場合は、条件を増やして試すのではなく、認証や再接続の原因を先に解決してください。元に戻しても消費電力が変わらない場合は、Pingテストやほかのバックグラウンド動作も確認します。より詳しい比較手順は、On Demand接続とバックグラウンドのバッテリー消費を調べるをご覧ください。

04 接続テスト

PingとConnectivity Test:結果の読み方

応答、ハンドシェイク、実際のリクエストのどれを測るか確認する

Pingは遅延テストの総称として使われることがありますが、画面に表示される時間は実際のテスト方法に応じて解釈してください。現在の項目がホストの応答を測る場合は、プローブが相手に到達して戻るまでの時間を示します。接続の確立や指定アドレスへのアクセスを測る場合、結果には名前解決、ハンドシェイク、アプリケーション側の処理が含まれることもあります。名称だけで、すべての結果がICMPによるものだと決めつけないでください。また、1回のプローブのミリ秒数をダウンロード速度とみなさないでください。端末間で比較する前に、同じ種類のテスト、同じ宛先、同じ計測範囲を使っていることを確認してください。

Connectivity Testは、現在のテスト経路で制御可能なリクエストを完了できるか確認するのに適しています。まずは既定のテスト先、または正常に動作すると分かっている現在のテスト先を使います。クライアントで変更できる場合は、安定して応答し、内容が小さく、ログインを必要とせず、認証ページへリダイレクトしないアドレスを選んでください。自分のサブスクリプションURLや業務用の管理画面はテスト先にしないでください。初回の記録には、宛先、ネットワーク、サーバー、時刻を残します。後で宛先を変更した場合は、それぞれの記録は各時点での結果を示すだけで、遅延の増減を直接比較することはできません。

条件をそろえて再テストする

まず同じネットワークで、既存の同じサーバー情報を使い、少数回テストして成功 여부とおおよその変動を記録します。最も低い値だけを選ばないでください。初回はコールドスタートの影響が大きく、直後のテストでは名前解決の結果や接続が再利用されることがあります。ネットワークを切り替えたばかりの場合は、システムの接続が完了してから測定し、接続の再確立にかかる時間を安定した遅延に含めないようにします。端末で大容量ファイルをバックグラウンド転送している場合は、ローカルの待ち行列による変動を相手側の問題と誤認しないよう、余裕のあるときに再測定してください。

Wi-Fiとモバイルネットワークを比較する場合は、サーバー、モード、テスト先を固定します。既存の2つのサーバーを比較する場合は、ネットワークとテスト先を固定します。この2種類のテストを同じ回で混在させないでください。一度タイムアウトしたら、その場限りの現象か繰り返し起きるかを確認します。再現する場合は、同じネットワークで通常のアクセスができるか、テスト先自体に到達できるかを調べてください。短時間の障害では、十数ミリ秒の数値差より、成功率やエラーがどの段階で発生したかのほうが原因の判断に役立ちます。

テスト結果と実際のアクセスを合わせて判断する

結果の組み合わせ判断できる範囲次の手順
テストは成功、サービスへのアクセスは失敗今回のテストで使った経路ではプローブが成功した。サービスのドメイン名の解決、適用されたポリシー、接続エラーを確認する。
テストはタイムアウト、サービスは正常テスト先やプローブ方法がサービスへのアクセスとは異なる。テスト先と、その種類のプローブに応答するかを確認する。
どちらもタイムアウトが続く共通の問題が考えられるが、発生箇所はまだ特定できない。現在のネットワーク、サーバー名の解決、接続の許可の順に確認する。

テスト先にはアクセスできても、サービスが遅い場合は、ページからのリクエスト数、宛先の応答時間、実際のルールで同じ経路が選択されているかを確認してください。小さな応答を使うプローブで検証できるのは接続の一部です。継続的な転送速度、アップロードの安定性、長時間接続の状態は判断できません。逆に、あるホストが特定のプローブに応答しなくても、アプリのサービスは正常に動作する場合があります。最も有効なのは、現在のモードと選択中の項目を明確にしてから、実際の使い方に近く、機密情報を含まないアクセスを1回行うことです。

テスト頻度とタイムアウト:診断用と日常用を分ける

日常利用では現在のテスト先とタイムアウト設定を維持し、状態を確認したいときに手動でテストすることをおすすめします。画面に定期テストの項目がある場合も、明確な必要がなければ間隔を短くしないでください。複数の既存サーバーを頻繁にテストするとリクエストが増え、電波の弱い場所やネットワークの切り替え時には接続動作も増える場合があります。タイムアウトが短すぎると、混雑時にまだ使える経路を早い段階で失敗と判定し、長すぎると比較に時間がかかります。変更前に元の値を記録し、まず問題のある宛先を再確認してから、診断中だけ待ち時間を延ばすか判断してください。

診断が終わったら、テスト頻度と一時的に使った宛先を元に戻します。残すのは診断状態ではなく、得られた結論です。定期テストだけでバックグラウンド動作が増える場合は、追加テストを無効にするだけでよく、ルールのポリシーを変更する必要はありません。テスト先が復旧してもサービスに問題が残る場合、遅延順の確認を続けるのではなく、Logで同じ時刻に発生した実際のリクエストを確認してください。「テストは成功したがサービスへのアクセスは失敗」のように結果の組み合わせを記録しておくと、「遅延は正常」とだけ書くより後から確認しやすくなります。

05 問題の切り分け

LogとData:1回の再現で問題を特定する

時刻が分かるリクエストから確認する

Logには、クライアントが記録できる接続やエラーが表示されます。項目はシステム、設定、接続段階によって異なります。再現前に現在のモード、ネットワーク、選択中のサーバー、開く予定の宛先を記録し、リクエストを開始した時刻も控えてください。調べるページを1回だけ開き、成功、タイムアウト、エラーを確認したら操作を止めます。ログではその時刻の関連項目を探し、事前の自動更新、事前接続、ほかのアプリの操作による記録を今回の問題と取り違えないでください。フィルターが使える場合は、時刻と宛先で範囲を絞ります。

通常はクライアントの現在の記録レベルを維持してください。より詳細な診断が必要で、画面に関連する設定がある場合は、短時間だけ変更し、確認後に元に戻します。初回の接続失敗がログに記録されていないからといって、問題がないとは限りません。システムがまだ接続を許可していない、アプリが既存の接続を再利用している、宛先へのリクエスト自体が発生していない可能性があります。まずHomeの接続状態と直前に行った操作を確認してください。スイッチをオンにしても接続できない場合は、ログレベルを上げ続けず、システムの許可を確認します。

最後に成功した段階を境界にする

まずサーバー名を解決して接続を確立できるかを確認し、次に宛先名とルールの一致、続いてプロキシのハンドシェイク、宛先への接続、アプリからの応答を調べます。画面にこれらの段階が個別に表示されるとは限らないため、見える証拠の範囲で判断してください。たとえば、ルールに一致した記録があっても、その段階まで処理されたことを示すだけで、宛先から応答があったことまでは証明しません。接続タイムアウトも、認証失敗とは限りません。成功と失敗の両方が記録されている場合は、ページの読み込み時に並行して発生した別々のリクエストではなく、同じホストに関する記録か確認してください。

認証またはTLSの段階でエラーが集中する場合は、既存の接続情報をもとにサーバーアドレス、ポート、プロトコルのパラメーター、システムの日付と時刻を確認してください。ログに単に失敗と表示されているだけで検証を無効にしないでください。また、アクセス先とサーバーアドレスを入れ替えないでください。モードと名前解決で同じ結果を再現できるのにサーバーへの接続が失敗する場合は、エラーの概要を最小限にまとめて、ご自身の接続情報の提供元に確認します。Configモードだけで失敗し、比較用のモードでは正常な場合は、すぐにサーバーを変更するのではなく、ルールの順序、依存するドメイン、宛先のポリシーを調べてください。

Dataとシステムの通信量統計は別の集計

Dataに表示される通信量カウンターは、クライアントが記録した通信量を確認するためのものです。数値を見る前に、表示対象の期間、集計対象、単位を確認してください。別の端末、別のネットワーク、別の集計期間の数値を直接引き算しても意味はありません。システムはアプリごとやモバイルネットワークの利用時間ごとに集計する場合があり、サービスの提供元が別の基準で集計していることもあります。数値の不一致だけでルールの誤りとは判断できません。同じ期間、同じ経路を比較していることを確認し、ほかのリクエストや再試行が含まれていないか調べてください。

アクセスによってクライアント上で確認できる通信が発生したか調べる場合、先に履歴を消す必要はありません。現在のカウンターを記録し、影響しそうなダウンロードを一時停止してから、容量の小さいページに1回アクセスし、増分を確認してください。目立った増分がない場合は、キャッシュが使われた、ページが実際にはリクエストを送信していないといった可能性があります。増分があっても、ページ内のすべてのリソースの読み込みが完了したとは限りません。通信量が急増した原因を調べる場合は、該当する時間帯のバックグラウンド同期、メディアのリクエスト、接続の再試行を確認し、Logで実際の操作と照合してください。

必要最小限の記録を残し、共有前に個人情報を除く

通常はネットワークの種類、モード、時間帯、失敗した段階、エラーの概要を記録すれば十分です。サブスクリプション、設定ファイル、未加工のログを丸ごと貼り付けないでください。

問題を外部に説明するときは、自分のドメイン、サーバーアドレス、端末のアドレスを実在の機器と関連しない例に置き換え、サブスクリプションのクエリパラメーター、アカウント名、パスワード、キーを削除してください。本文だけでなく、スクリーンショットの端、通知、設定名、共有リンクにもネットワークやアカウント情報が含まれていないか確認します。複数のリクエストを比較する場合は、宛先を「宛先A」「宛先B」のように示しつつ、元の記録での順序は維持してください。詳細な通信記録を公開せずに問題を説明できます。

調査が終わったら、一時的に変更したログレベルを元に戻し、元の設定に戻してから簡単に再確認します。特定のネットワークだけで問題が起きる場合は、そのネットワーク条件も結論に記載してください。1回だけの結果を、一般的な原因として断定しないでください。次回は同じ宛先、同じモードから確認すれば、毎回ログを最初から取り直す必要がありません。「接続を開始できない」場合は、無関係なリクエストを大量に調べるより、システムのVPN構成についてをご覧ください。

06 状態の確認

Widget:状態表示だけでは接続を確認できない

設定項目、システムのコンポーネント、実際の接続を区別する

Widgetはメインアプリ以外から状態を確認するための入口です。どの情報が表示され、どの操作を実行できるかは、システムが許可するコンポーネントの機能と、クライアントが提供する種類によって異なります。名称だけから、Homeと同じ操作ができると推測しないでください。クライアント内の関連設定と、システムが特定の画面にコンポーネントを追加しているかどうかも別のことです。アプリ設定を変更しても、システムが自動的にコンポーネントを追加するわけではありません。システム画面からコンポーネントを削除しても、接続が切断されたりシステムのVPN構成が削除されたりするわけではありません。

まずHomeで手動接続が安定することを確認し、コンポーネントを追加するか判断してください。表示内容と追加場所は、システムのコンポーネント一覧と実際のプレビューで確認します。同じ配置や表示項目がすべての端末の初期状態だとは考えないでください。システムに該当するコンポーネントが表示されない場合は、まずメインアプリが開けることを確認し、現在の端末で使える追加場所と種類を調べます。コンポーネントを表示するために自分の設定を削除しないでください。コンポーネントが表示されない問題と設定ファイルの読み込み失敗は別の問題です。

2回の比較で表示の更新遅れかどうか確認する

1回目は同じネットワークで手動接続し、Homeに接続状態が表示され、テストアクセスも完了することを確認します。使用した設定とサーバーを記録してください。アプリを離れてコンポーネントを確認し、システムが表示を更新する時間を置いてから、メインアプリに戻って状態を確認します。2回目は手動で操作できる状態で切断し、同じ3か所をもう一度比較します。Homeの表示と実際のアクセス結果が一致し、コンポーネントだけが更新されていない場合は、表示の問題として対処してください。この違いだけを理由にDNSやルールファイルを変更する必要はありません。

システムのコンポーネントに接続操作がある場合は、1回だけタップしてメインアプリに戻り、状態の変化を確認してください。表示が以前の状態のままだからといって、連続してタップしないでください。コンポーネントが状態表示だけを行う場合や、操作時にロック解除やメインアプリの起動が必要な場合、それだけで接続失敗とは判断できません。問題を再現したときは、直前に画面をロックしたか、アプリを前面に戻したか、ネットワークを切り替えたかを記録します。システムによる更新が遅れ、「古い状態が表示される」一方で「現在の接続は変わらない」こともあります。まず同じネットワークで比較を行い、その後ネットワーク切り替え時の状態を確認してください。

自動接続とコンポーネント表示の違いを調べる

コンポーネントには切断と表示されるのに、Homeでは再接続済みの場合、まずOn Demandの条件が現在の環境に引き続き一致していないか確認します。切断後にほかのアプリがリクエストを送ると、システムが再接続を試みることがあります。コンポーネントの表示だけを確認したい場合は、自動接続の条件を記録し、必要なアクセスに影響しない時間帯にOn Demandを一時的に無効にして、手動接続と切断をそれぞれ比較します。確認後は元の条件に戻してください。原因の切り分けを理由に、自動接続の動作を恒久的に変えないでください。

Homeでも接続できない場合は、実際の接続について許可、ネットワーク、サーバーの順に確認してください。コンポーネントの状態は補助情報として記録します。コンポーネントだけが古い状態を表示し続ける場合は、まずメインアプリを開いて状態を再確認します。システムで可能なら、そのコンポーネントを削除して追加し直し、同じネットワークで改善するか確認してください。追加し直すのはコンポーネントだけで、サブスクリプションやシステム構成をリセットする必要はありません。現在のシステムで該当する種類が提供されていない場合は、状態の確認にHomeを使ってください。

表示内容に合わせて配置場所を選ぶ

他人に見られる可能性のある場所にコンポーネントを配置する前に、実際の表示内容を確認してください。サーバーのメモ、設定名、通信量などには特に注意が必要です。内部用の名前も認証情報でなくても、使用中のネットワーク環境を明らかにすることがあります。表示する情報を少なくできる場合は、状態や入口だけにしてください。表示範囲を調整できない場合は、より適切な画面に配置するか、その場所から削除します。コンポーネントのスクリーンショットを共有する前にも、Logの章の手順に沿ってメモなどの情報を確認してください。

コンポーネントを日常的に使うかどうかは、確認の手間が減るかで判断してください。「今アクセスできるか」「どのルールが実際に一致したか」を確認するには、Homeに戻って状態を調べ、同じ宛先へアクセスし、必要に応じてLogを確認します。ネットワーク切り替え直後だけ短いずれが起きる場合は、接続失敗を示す別の証拠がない限り、表示の更新タイミングの問題として記録してください。古い状態カードを見て設定を何度も変えず、正常に見えるコンポーネント表示だけを接続成功の証拠としないための確認方法です。

07 端末間の設定

iCloud同期:同期範囲と端末移行後の確認

同期データ、ファイルの読み込み、システムの許可を個別に確認する

iCloud同期が利用状況に合うか判断するには、まずクライアントが現在どのデータの同期を明示的にサポートしているか確認してください。設定ファイルがファイルの保存場所にあること、Configから読み込まれて選択されていること、アプリの同期によって別の端末に表示されることは、それぞれ異なる状態です。データの同期に成功しても、システムの接続許可、Widgetの配置場所、現在のネットワークまで移行済みとは限りません。別の端末に同じ名前のファイルが表示されたことだけを根拠に、内容や選択状態を確認済みとしないでください。

まずは1台の端末で現在の設定を維持してください。端末間で同期する必要がある場合は、その端末のiCloudへのサインイン状態と、システムでアプリに許可されているアクセスを確認し、次にクライアントで指定されている同期範囲を調べます。画面にデータの種類が示されていない場合は、同期範囲が確認できていないものとして扱い、サーバー、設定、ルール、ログのすべてが同期されると想定しないでください。初期状態のスイッチも、実際のクラウド上の状態を示す証拠ではありません。有効にすると関連機能が許可または開始されることを示すだけです。完了したかどうかは、もう一方の端末で結果を確認してください。

基準となる設定を決め、両方の端末で同時に編集しない

作業を始める前に、現在正しい設定を保持する端末を決めます。使用中のファイル名、主なルール、選択中のポリシー、ネットワーク条件を書き留め、自分で管理できる複製を保存してください。最初の確認には、接続情報を含まないテストファイルや、機密情報を含まない識別用のメモを使えます。クライアントがその種類の内容を明示的にサポートしている場合だけ、同期の確認に利用してください。もう一方の端末を通常のネットワークに接続した状態で結果を確認し、同名の古い複製ではなく、想定した項目が表示されていることを確かめます。

両方の端末で変更してしまった場合は、それ以上の編集をいったん止めます。2つの内容を別々に確認して、残す必要のあるルールを特定し、復元可能な複製を保存してから、基準とするファイルを1つ選びます。ファイル一覧で最後に表示された項目が最新だとは限りません。競合した変更が自動的に統合されるとも限りません。変更後は基準端末で1回だけ確認し、その後もう一方で照合します。どちらの版か分からない場合は、既存の複製に一時的に異なる名前を付けるほうが、同名の項目を何度も編集するより判別しやすくなります。

同期に時間がかかる場合は、対象範囲と状態を順に確認する

まず、すべてのデータが表示されないのか、特定のファイルだけがないのかを確認してください。すべての項目が見つからない場合は、システムアカウント、アプリのアクセス設定、ネットワーク、利用可能なストレージを確認します。1項目だけが見つからない場合は、その項目が同期対象か、端末内だけに保存されていないか、もう一方の端末で該当リストを開いているかを確認してください。待っている間は設定を維持し、スイッチをすばやく何度も切り替えないでください。切り替えを繰り返すと状態が増え、元の同期が未完了なのか、新しい操作で範囲が変わったのか判断しにくくなります。

現在の画面にImport from Cloud JSONがある場合は、その項目からデータを読み込む操作として扱ってください。その名称があるだけで、継続的な同期や自動更新が有効になっているとは判断できません。読み込み後は対象の項目、選択状態、現在のネットワークで接続を確立できるかを確認します。自分のサービス提供元から新しいサブスクリプション情報を取得した場合は、「サブスクリプションの内容が更新されたか」と「変更が別の端末に届いたか」を分けて確認してください。それぞれを検証すれば、更新と同期のどちらに問題があるか判断できます。

端末を移行したら新端末で確認し、削除前に対象範囲を確認する

端末を移行した後は、まずメインアプリを開き、必要な設定があることを確認します。サーバーのメモと現在選択されている項目を照合し、必要に応じてシステムの案内に沿って接続を許可してください。まずHomeから手動接続し、実際のアクセスをテストしてから、新しい端末に適したOn Demandとコンポーネントを設定します。旧端末のWi-Fi条件は新端末に当てはまらないことがあります。同じ設定が見えていても、両方の端末で同じルーティングモードを使っているとは限りません。新端末で実際の経路を検証できるまで、旧端末で使える複製を残してください。

同期を無効にしたり旧端末のデータを整理したりする前に、システムとクライアントの確認画面で影響範囲を読みます。本機での同期停止、ローカルの複製の削除、クラウド上のデータ削除のどれに当たるか確認してください。範囲が分からない場合は、同期中の端末で項目を削除して試さないでください。個人のサーバー情報を含むファイルは、信頼できるアカウントと保存場所だけに保管し、一時的な受け渡しに公開共有場所を使わないでください。同期は端末間でデータを取得する方法であり、独立したバックアップの代わりではありません。誤って削除したデータの復旧を保証するものでもありません。

08 ローカルの待ち受け

Proxyポート:ローカルの入口とリモートサーバーを区別する

似た名前の3つの項目と、それぞれの用途

Global RoutingのProxyはルーティングモードです。Add Serverのポートは、既存のリモートサーバーが提供するサービスのポートです。現在のプラットフォームにローカルProxyの待ち受け設定がある場合、そのポートは、プロキシを明示的に設定したプログラムが端末上のクライアントに接続するためのものです。プログラムがローカルの待ち受け先にリクエストを送った後、クライアントがリモートへの経路をどう選ぶかは、実際のモードと設定で決まります。いずれもプロキシに関係しますが、アドレスとポートを使い回すことはできません。

この端末で通常どおりShadowrocketを使い、別のプログラムからローカルプロキシへ明示的に接続する必要がなければ、現在の待ち受け状態を維持してください。リモート接続の問題を調べるためだけに、待ち受けを追加で有効にしないでください。ローカルアプリに明示的な接続先が必要な場合は、現在のプラットフォームが必要な種類の待ち受けとアドレスに対応しているかを先に確認します。既定のポートは画面の表示を確認し、別のプラットフォームや設定例から推測しないでください。同じ数字のポートが表示されても、システムが自動的にリクエストをShadowrocketへ転送するとは限りません。

通常はローカル端末だけで使う

同じ端末上のアプリだけで使う場合、画面で待ち受け範囲を選べるならIPv4の127.0.0.1など、ローカルのループバックアドレスを優先します。IPv6のループバックで待ち受けることが明示されている場合は::1を使います。呼び出し元のプログラムでは、アドレス、ポート、プロトコルの種類を一致させてください。別の端末でループバックアドレスを指定すると、その端末自身に接続し、こちらの端末には接続しません。この理由だけで、既存のローカル接続をLAN内の待ち受けに広げないでください。

ポートが使えるように見せるために、システムのファイアウォールを無効にしたり、ルーターのポート転送を変更したり、不要なネットワークにローカルサービスを公開したりしないでください。複数の人が使うネットワークで、必要以上に広い範囲で待ち受けると、別の端末からそのポートに接続されるおそれがあります。業務環境で端末間の接続が必要な場合は、許可される範囲とアクセス制御の方法をネットワーク管理者に確認してください。この章の推奨値と確認手順は、自分の端末上で使うアプリを対象としています。現在のプラットフォームがこの機能に対応していない場合は、入口を再現するためにシステムのネットワーク設定を変更する必要はありません。

待ち受け、プロトコル、上流の3段階で確認する

リモートサーバーの現在のパラメーターはそのままにし、呼び出し元のプログラムに設定したアドレスとポートが、起動中の待ち受け項目に一致するか確認します。クライアントがポートの競合を示す場合は、別のプログラムがそのポートを使用していないか調べてください。見覚えのないシステムプロセスを終了しないでください。システムで使用でき、競合しないポートを選んだら、呼び出し元のプログラムでも同じ値に変更し、制御できるアクセスを1回だけ試します。呼び出し元が古いプロキシアドレスを使い続けている場合、クライアント側を変更しても接続先は変わりません。

ローカル接続がすぐに拒否される場合は、待ち受けが起動しているか、アドレスファミリーが正しいか、呼び出し元が指定されたポートへ接続しているかを確認します。ローカルには接続できてもプロトコルエラーになる場合は、呼び出し元がHTTPプロキシとSOCKS5のどちらを使っているか確認してください。ポート番号だけを変えてもプロトコルは変わりません。ローカルのハンドシェイクに成功しているのに宛先へアクセスできない場合は、Logで上流への接続、名前解決、宛先のポリシーを確認します。これにより、「プログラムがローカルの入口に届いていない」状態と「入口の後でアクセスを完了できない」状態を区別でき、接続情報をすべて入れ直す必要がなくなります。

変更後は有効・無効の両方を確認し、一時設定を元に戻す

ローカルプロキシを設定したアプリから、機密情報を含まないリクエストを1回送信し、対応する時刻のリクエストがクライアントに記録されているか確認します。次に、そのアプリ内だけで一時的なプロキシ設定を解除するか、元の継承方法に戻し、同じ宛先へアクセスします。端末のVPNが有効なままなら、2回目のリクエストも現在のルーティングモードの影響を受ける場合があります。ウェブページを開けるかどうかだけで判断せず、今回設定した待ち受けを引き続き通っているか確認してください。必要に応じてアプリ自身のネットワーク表示を確認し、古い接続が再利用されていないか調べます。

元に戻すときは、呼び出し元のプログラム、Shadowrocketの待ち受け状態、システムのプロキシ設定をそれぞれ確認し、今回変更した項目だけを1つずつ戻します。既存のリモートポートや認証情報は変更しないでください。一時的な待ち受けを無効にした後で別のプログラムに問題が起きた場合は、どのプログラムがまだそのポートを参照しているか確認します。見かけ上の問題を解消するために、待ち受けを恒久的に残さないでください。次回の再確認に必要なメモは、アドレス範囲、プロトコルの種類、ポート、用途だけで十分です。基本的な接続がまだ使えない場合は、使い方に戻って基本手順を確認してから、ローカルの入口を検証してください。