SETTINGS REFERENCE
Shadowrocket Settingsの設定項目ガイド
設定を変更する前に、どこに適用される項目なのかを確認しましょう。このページは問題から設定項目を探せる公式マニュアルです。既存のサブスクリプションの初回読み込み、ノードの選択、接続の確立については、先に使い方ガイドをご覧ください。基本の手順を終えたら、該当する章に戻って確認できます。
ShadowrocketはiPhone、iPad、Mac、Windows、Android、Linuxに対応しています。このページでは、iPhone / iPad版のSettings画面に表示される項目名を基準に解説します。他のプラットフォームでは、該当する項目が実際にある場合に限り参考にしてください。特定のOS専用機能を、すべてのプラットフォーム共通の機能として扱うことはありません。
iPhone / iPad版はApp Storeで2.99ドルの買い切りです。Mac(Appleシリコン・Intel)、Windows、Android、Linux版は無料です。入手先とOSによる許可の手順は全プラットフォームのダウンロードページをご覧ください。iPhone / iPadのシステム要件はApp Storeの掲載内容をご確認ください。アプリの買い切り料金と回線サービスの料金は別です。サブスクリプションやサーバー情報はご利用のサービス提供元から入手してください。本サイトではこれらのサービスを提供、販売、推奨していません。
初期値と推奨値は同じではありません
既存のインストール環境では、バックアップの復元や設定の読み込み、以前の設定の引き継ぎが行われている場合があります。確認できていないスイッチの初期値を一律に決めつけないでください。「初期状態を維持する」とは、現在のインストール環境で変更していない状態を保ち、画面に表示された内容を記録することです。一度に変更する項目は一つに絞り、検証してから適用するか判断しましょう。
01 / SCOPE
適用範囲、初期状態、変更の順序
まずSettings、Config、システム権限を区別する
設定を確認する前に、問題を3つの層に分けましょう。Settingsはテスト方法、ログ、アプリの設定など、クライアントの動作を管理します。Configで選択中の設定は、ルールや一部の通信処理を決めます。システム権限は、クライアントがシステムのネットワーク接続を確立したり、ローカルネットワークにアクセスしたり、クラウド機能を使ったりできるかを左右します。同じ現象でも原因は異なります。接続スイッチが維持できないからといって、DNSに問題があるとは限りません。Webページが開かない場合も、ルールが機能していないとすぐに判断することはできません。現在の画面、選択中の設定、表示されたメッセージを記録してから該当項目を確認すれば、何度も変更してどれが効いたのか分からなくなる事態を避けられます。
このページでいう「初期状態の確認」は操作手順であり、すべてのスイッチを決まった組み合わせに戻すことではありません。初めて確認するときは、各項目の現在の内容、空欄かどうか、Configから設定されているか、システム権限に関する表示があるかを記録してください。移行を経た端末の値は、新規インストール時の初期値とは限りません。クラウドから復元した内容も、現在のネットワークに適しているとは限りません。いわゆる標準値に合わせるために、使用中のConfigを削除したりアプリを再インストールしたりしないでください。複数の条件が同時に変わると、問題を再現しにくくなります。
Global Routingでルールを使うかどうかを決める
Global RoutingのConfig、Proxy、Directは、それぞれConfig、Proxy、Directの動作に対応します。Configは選択中の設定のルールに従ってリクエストを処理します。Proxyは対象の通信をプロキシ経由で処理し、Directは直接接続します。いずれもサーバー設定を修復する機能ではなく、接続先に必ず到達できることを意味しません。ルールを調べるときはConfigを使います。一時的に別の動作へ切り替えるのは、同じ接続先への経路による違いを比較するためです。テスト後は元の動作に戻してください。戻さないと、その後のルール変更が反映されていないように見えることがあります。
| 動作モード | 確認する項目 | 検証に適した内容 |
|---|---|---|
| Config | 現在の設定、ルールの順序、ポリシー | このリクエストはどのルールに一致したか |
| Proxy | 選択中のノードと接続パラメーター | プロキシ経由の接続は利用できるか |
| Direct | ローカルネットワークと接続先への到達性 | プロキシを経由しない場合に挙動が変わるか |
スイッチを続けて試すのではなく、元に戻せる記録を残す
まず、基本情報を4つ記録します。使用中のネットワークがWi-Fiかモバイル通信か、現在の設定とノード、Global Routingの動作モード、問題が接続前と接続後のどちらで発生するかです。次に、変更する項目を一つ決め、予想される変化を記録します。たとえばDNSを調整するなら、検証する内容を「同じドメイン名を名前解決して開けるか」と定めます。ネットワークが速くなったかのような漠然とした観察では不十分です。対象を固定すれば、結果と設定変更の関係を確認できます。
変更後は、まずリクエストを新しく送信します。トンネル確立時に適用される設定なら、いったん切断して再接続してから試してください。長時間接続するアプリは既存のセッションを再利用することがあるため、古いページにエラーが残っても、新しい設定が反映されていないとは限りません。何度も再読み込みするより、対象のページを閉じてから開き直すほうが判断しやすくなります。改善しない場合は、次の項目に進む前に、記録した値に戻してください。一度のテストでノードと設定を切り替え、DNSを変更し、On Demandも有効にすると、復旧しても原因を特定できません。
初期設定を決めるときの基本
正常に動作している項目は変更しないでください。サービス提供元から指定されたプロトコルパラメーターは、案内された内容どおりに入力します。自動再接続や外部からの待ち受けなどの追加機能は、基本の接続を検証してから有効にします。意味が分からない項目は現在の初期状態を保ち、名前だけで機能を推測しないでください。
原因を詳しく特定する必要がある場合は、試行ごとに「何を変更したか」「どうリクエストしたか」「結果はどうだったか」「元に戻したか」を一文で記録しましょう。サブスクリプションURLやパスワードを記録に含める必要はありません。端末ごとにシステム権限、ネットワーク、Configの複製が異なる可能性があるため、複数端末を比較するときも別々に記録してください。画面上の用語は用語集で確認できます。このページの各章では、同じ記録方法に沿って項目を説明します。
02 / DNS
DNS:名前解決の経路とWebページが開かない場合の切り分け
DNSは名前解決を担い、接続やルールの問題を解決するものではありません
DNSはドメイン名をIPアドレスに変換します。Webサイトにアクセスするときの一般的な処理の一つですが、実際のアクセスにはルールの照合、サーバーへの接続、TLSネゴシエーション、データ転送なども関わります。そのため「遅延は正常なのにWebページが開かない」という現象を、テストの数値だけでDNSの問題と判断することはできません。まず、ログに接続先のアドレスが記録されているか確認し、次に接続段階で失敗していないかを調べます。アドレスの名前解決に成功していて接続がタイムアウトする場合、DNSサーバーを次々に変えても、経路に到達できない問題やプロトコルパラメーターの誤りは解決しません。選択中のノードのサーバー名も解決できない場合は、プロキシ接続を確立する前の基本的な名前解決から確認してください。
DNSの動作は、選択中のConfigにある関連項目の影響を受ける場合があります。変更前にConfigも確認してください。Settingsで変更しても、別の設定が動作を決めていることがあります。空欄だからといって「DNSを使っていない」とは限りません。システムやConfigの設定を引き継いでいる場合もあります。初期状態は、現在のインストール環境の画面と選択中のConfigを基準にしてください。ネットワークが正常なら、現在の名前解決方法を維持するのがおすすめです。再現性のある名前解決エラーが起きた場合に限り、条件をそろえて比較・調整しましょう。
入力欄で求められる形式を確認する
入力欄が名前解決サーバーのアドレス、プロトコル付きのエンドポイント、Config内の設定行のどれを求めているのか確認してください。DNSという名称が含まれていても、異なる入力欄の内容をそのまま転記できるとは限りません。入力時は前後の空白、全角の記号、改行にも注意してください。暗号化された名前解決用のエンドポイントを使う場合は、現在の入力欄がその形式に対応していることと、エンドポイント自体に接続できることを確認します。アドレスの表記が正しいだけで、通信経路も利用できるとは限りません。名前解決サービスへの接続は、現在のネットワーク、証明書の検証、端末の時刻にも左右されます。
既存のConfigで明示的に指定され、現在のネットワークから到達できる名前解決方法を優先してください。変更する場合は、まず動作する基本経路を一つ確保し、出所の分からないアドレスをまとめて入力しないでください。DNSサーバーを増やしても安定性が高まるとは限りません。そのうち一つの応答に問題があれば、リクエストによって結果が変わる可能性があります。テスト中はネットワークとノードを固定し、以前エラーになったドメインと普段正常なドメインを一つずつ開き、どちらもアドレスを取得できるか記録してください。たまたまページが開いたかだけで判断しないでください。
| 観察された結果 | 優先して確認 | 次の手順 |
|---|---|---|
| ノードのドメイン名を解決できない | 接続前のシステムネットワークと基本的な名前解決 | 基本ネットワークを復旧してから接続する |
| 接続先のドメイン名を解決できない | 現在のDNS設定とConfig内の関連項目 | 名前解決方法だけを変更して再度リクエストする |
| アドレスは取得できるが接続がタイムアウトする | 選択中のポリシー、ノード、接続先への到達性 | 接続ログを確認し、DNSをむやみに変更しない |
| 一部のネットワークだけで失敗する | ネットワークの制限、アドレスファミリー、名前解決用エンドポイントへの到達性 | Wi-Fiとモバイル通信の結果を分けて記録する |
キャッシュ、アドレスファミリー、ルールの相互作用
システムやアプリが名前解決の結果を保持していることがあります。変更直後に古いページを再読み込みしても、以前のアドレスが使われる場合があります。まず接続を確立し直し、新しいアクセスを試してください。現在の画面にDNSキャッシュを削除する機能があれば、記録を取ってから使ってもかまいません。ただし、キャッシュの削除を恒久的な解決策と考えないでください。一時的に復旧して再発する場合は、上流からの応答やネットワークの変化も調べる必要があります。特定のアプリだけで問題が起きる場合は、そのアプリ独自の名前解決経路も考慮してください。ブラウザーで正常だからといって、すべてのアプリが同じ設定を使っているとは限りません。
ドメイン名からIPv4とIPv6の両方のアドレスが返される場合がありますが、現在のネットワークでの到達性は同じとは限りません。IPv6を見ただけで無効にしたり、一方のアドレスファミリーの問題をDNS全体の障害と判断したりしないでください。まずログで実際に接続したアドレスを確認し、ネットワークを切り替えた場合の結果と比較します。IP-CIDRまたはIP-CIDR6のルールを使っている場合は、名前解決で得られたアドレスがルールの一致先を変えていないかも確認してください。名前解決の成功と、想定したルールによる振り分けは、別々に検証する必要があります。
すべてのドメインの検証を固定IPアドレスで代用しない
サービスによっては、ドメイン名、TLSのホスト名、動的に変わるアドレスを前提としています。特定のIPアドレスへの直接アクセスに失敗しても、DNSの問題とは限りません。直接アクセスに成功しても、ドメイン名を使った一連のアクセスが正常とは証明できません。
調整後、正常なドメインと問題のあるドメインにそれぞれ再度アクセスし、ログで名前解決と接続の各段階を確認してください。特定のWebサイトだけで問題が起きる場合は、発生時刻と失敗した段階を記録し、変更範囲をむやみに広げないでください。「テストには応答があるのにページが開かない」場合の段階的な切り分けは、DNSの問題を切り分ける方法もご覧ください。
03 / ON DEMAND
On Demand:自動接続の条件と手動スイッチ
自動条件を設定する前に、手動接続を検証する
On Demandは条件に応じて接続を開始する機能であり、サーバーの稼働状態を修復するスイッチではありません。ノードを手動で選び、接続を開始し、接続先へのアクセスまで確認できてから自動条件を設定してください。そうでないと、自動再試行と元の問題が重なり、「切断してもすぐ再接続する」「ネットワークを切り替えると接続を繰り返し試みる」といった現象が起きます。初回のトラブル対処では、既存の条件を記録してからOn Demandを一時停止し、毎回手動で接続を開始してください。そうすれば、どの時点で失敗するかを正確に判断できます。
初期状態は、On Demandの画面で総合スイッチと各条件を確認してください。Configや端末バックアップを復元した場合、総合スイッチだけを見てすべての条件が初期状態に戻ったとは判断できません。必要なネットワーク状況だけに絞って有効にし、まず条件に該当したときと外れたときの両方をテストしてから、条件を追加する方法がおすすめです。他人のネットワーク名をそのまま使ったり、同じ名前のWi-Fiなら同じようにアクセスできると考えたりしないでください。
ネットワーク条件とシステム権限をあわせて確認する
現在の画面でネットワークの種類やWi-Fi名による条件を設定できる場合は、それぞれが接続時と切断時のどちらを表すのか、より広い範囲に適用される条件がないかを確認してください。ネットワーク名は端末で実際に認識されている文字列と照合します。空白、大文字・小文字、似た文字の違いが判定に影響することがあります。ネットワーク情報へのアクセスがシステム権限によって制限される場合もあります。条件との照合に必要な情報をアプリが取得できない場合は、同じ名前の条件を何度も追加せず、システム権限と画面の案内を確認してください。
まず、現在接続しているWi-Fiで試します。手動接続の状態を記録し、条件を一つ有効にして、そのネットワークから離れた後、再接続して期待どおりに動くか確認してください。次に、モバイル通信でも個別にテストします。ネットワークの切り替え時にはシステムが接続を再確立するため、短時間に何度も切り替えて最後のスイッチ状態だけを見るのは避けてください。各ステップでネットワークが安定するのを待ち、新しいリクエストを一度送信します。条件が一致しなかったのか、接続の確立に失敗したのかを区別するため、発動時刻と接続ログを照合してください。
手動で切断した後に再接続する場合は、発動条件を確認する
On Demandが有効なままでは、手動で切断しても自動接続が完全に停止するとは限りません。その後のネットワークイベントやリクエストに応じて、既存の条件が再び処理される場合があります。接続を継続的に停止する必要がある場合は、接続スイッチを何度も押すのではなく、On Demandの総合スイッチと関連条件を確認してください。変更後はシステムのVPN状態を確認し、ほかに有効な自動条件が残っていないか調べます。発動するかどうかは実際の条件とシステムの挙動で判断し、繰り返し接続される現象をすべて「スイッチの故障」と決めつけないでください。
また、システムに保存されたVPN設定と現在の接続状態は区別してください。設定の追加を許可したことは、システムに対応する接続設定があるという意味で、常に通信中であることを示すものではありません。以前に権限を拒否したり、システム設定を削除したりした場合、On Demandでもその前提を解消できません。まず手動で接続し、システムの案内に沿って許可を完了してから条件を設定してください。権限とシステム設定の関係については、VPN設定の追加を求める画面についてをご覧ください。
ネットワーク切り替えで問題が起きた場合の戻し方
条件を記録 → On Demandを一時停止 → 手動で再接続 → 安定したネットワークで検証 → 条件を一つずつ戻す。システム設定の削除とノードパラメーターの変更を同時に行うと、どちらが結果を変えたのか分からなくなるため避けてください。
自動接続は、利用可能な経路を自動で選ぶ機能ではありません
接続の発動、ノードの選択、接続先への到達性の確認は、それぞれ別の作業です。On Demandが正常に動いても、選択中のノードが期限切れだったり、パラメーターが合っていなかったりする場合があります。接続できても、すべての接続先が想定どおりに振り分けられるとは限りません。繰り返し検証できる対象を用意しましょう。ローカルネットワークの確認用、プロキシ経路の確認用の対象をそれぞれ一つ選び、現在一致しているルールも確認します。異常があれば、この3つの層に分けて調べてください。スイッチをオンのままにするために、自動条件を次々と緩めることは避けましょう。
公共ネットワークでログインや確認ページの表示が先に必要な場合は、まず基本ネットワークが利用できる状態にしてから自動接続を検証してください。基本的なアクセスができないネットワークは、前提条件を満たしていません。再接続条件を強めて問題を隠すのは適切ではありません。テスト後は、条件を設定した目的と対象ネットワークを自分用に記録してください。ネットワーク名、端末の権限、利用方法が変わったときは、設定一式を読み込み直すより、記録をもとに項目ごとに見直すほうが管理しやすくなります。
04 / PING
PingとConnectivity Test:テスト結果から分かること
テスト方法を確認してから遅延を読み取る
Pingは診断の手がかりですが、すべてのテストが同じ方法で通信を確認するわけではありません。結果は選択したテスト方式、接続先、現在のネットワークによって異なります。TCP接続、一般的なプローブ、プロキシ経由のアプリケーション層リクエストでは、確認できる通信経路が異なります。設定を開いたら、まず現在の方式を記録してからテストしてください。初期のテスト方式は現在の画面で確認し、未確認の方式を一律の初期値とみなさないでください。結果を比較するときは、方式と接続先を一致させる必要があります。そうしないと数値を直接比較できません。
ノードが応答した場合でも、通常は今回のプローブが対象とする段階で応答があったことしか分かりません。それだけで認証パラメーターが正しい、Webサイトにアクセスできる、通信が安定して続くことまで証明されるわけではありません。一方、タイムアウトもサーバーが完全に停止していることを示すとは限りません。テスト先に到達できない、同じ種類のプローブが制限されている、タイムアウト時間が短すぎるといった原因でも、同様の結果になる場合があります。テスト結果は原因を絞り込むための証拠として扱い、実際のリクエストでも確認してください。ノード一覧に表示された数値だけで最終判断しないでください。
テスト先、タイムアウト、試行回数の選び方
現在の画面でテストアドレスを指定できる場合は、自分に利用権限があり、安定してアクセスでき、応答の仕組みが単純な接続先を選びます。ログインが必要なテスト先、リダイレクトが発生する接続先、アクセスが制限された接続先は、余計な条件を加えます。数値を小さく見せるために、テスト先を頻繁に変えないでください。まず既存の接続先を基準として残し、失敗が再現することを確認してから、接続先だけを変えて比較します。変更後に復旧した場合は、接続先の違いによるものか、通信経路自体が復旧したのかを引き続き確認してください。
タイムアウト時間を設定できる場合は、まず初期値のまま使うのがおすすめです。短すぎると、正常でも時間のかかるリクエストをタイムアウトと判定する可能性があります。長すぎてもテストの待ち時間が増えるだけで、サーバーへの到達性は向上しません。現在のネットワークで接続確立に時間がかかることを確認できた場合に限り、少しずつ調整して再テストしてください。試行回数は、連続して高頻度で実行するより、間隔を空けた少数のテストのほうが結果を読み取りやすく、一時的なネットワークの揺らぎを長期的な状態と誤認しにくくなります。
| テストの段階 | 確認できること | それだけでは証明できないこと |
|---|---|---|
| サーバーのポートへの接続 | アドレスとポートに接続できるか | プロトコル認証と接続先へのアクセスが正常か |
| プロキシ経由のリクエスト | 今回のプロキシリクエストが完了したか | すべてのWebサイトとアプリが正常に動作すること |
| Connectivity Test | 今回のテスト条件での接続状況 | 今後ネットワークを切り替えても利用できること |
タイムアウトした場合の確認順序
まず端末の基本ネットワークが使えるか確認し、次にサーバーアドレスとポートを調べます。その後、プロトコルの種類と認証項目を確認してください。Shadowsocksの暗号方式とパスワード、VMessまたはVLESSのID関連項目、Trojanの認証とTLS関連設定は、提供元の資料と一つずつ照合します。WireGuardとHysteria2にもそれぞれのパラメーターがあります。項目名が似ているからといって、別のプロトコルの値を流用しないでください。サービス提供元の案内が不明確な場合は、正確な値を提供元から入手し、無作為に設定を変えて試さないでください。
端末の時刻も確認してください。時刻のずれは、証明書の検証や時刻に依存する接続処理に影響する場合がありますが、時刻合わせがすべてのタイムアウトを解決するわけではありません。まずシステムの時刻とタイムゾーンを正しく設定し、同じテストを繰り返します。特定のノードだけに問題がある場合は、ネットワークを変えずにそのノードを確認してください。すべてのノードで同時に問題が起きる場合は、ネットワーク、名前解決、テスト先など共通する条件を優先して調べ、正しいノード設定を一つずつ変更しないようにします。
テストが正常でも、実際のアクセスを確認する
使用するノードを選び、Global Routingの動作モードを確認して接続を確立した後、新しいリクエストを送信します。Logで想定したポリシーが適用されたか確認してください。バックグラウンドで確立済みの長時間接続だけを検証に使わないでください。新しく開いたページのほうが、該当するログと照合しやすくなります。アップロード、ストリーミング、長時間のセッションが必要な場合は、実際の用途でも検証してください。短時間のプローブでは、こうした使い方を代替できません。
トラブル対処の記録には、テスト方式、ネットワークの種類、失敗した段階、発生順序を残せば十分です。通常、ノード情報全体を公開する必要はありません。ノードのタイムアウトを一定の手順で切り分ける方法は、ノードのタイムアウトと接続失敗を調べる手順をご覧ください。テスト後は、普段の頻度に戻してください。数値を確認するためにプローブを大量に繰り返さないようにしましょう。設定を維持する根拠となるのは、必要なリクエストが安定して完了することです。
05 / LOG
LogとData:リクエストの流れから問題を読み解く
ログは結論の一覧ではなく、処理の記録として読む
Logを使うと、リクエストがどの段階を通ったかを確認できます。接続先の受信、名前解決、ポリシーの照合、接続の確立、完了または失敗といった流れです。プロトコルやログレベルによって表示される情報は異なるため、毎回同じ行がすべて記録されるとは限りません。まず直前の操作時刻に近い記録を探し、同じ接続先やセッションの後続イベントをたどってください。エラーの一行だけを切り取ると、前後の状況を見失うことがあります。たとえば、それ以前に名前解決が失敗していれば、その後の接続エラーは二次的な結果かもしれません。
ログを記録するかどうか、どの程度保存するか、どのレベルを選べるかは、現在のLog画面で確認してください。普段は基本的なトラブル対処に必要な範囲にとどめ、詳細なログを長期間有効にしないことをおすすめします。診断が必要な場合のみ一時的に詳細度を上げ、問題を一度再現したら元に戻してください。詳細なログにはアクセス先、ネットワーク情報、設定に関する手がかりが含まれる可能性があり、読み取りの負担も増えます。すべてを有効にしてから探すより、調べたい段階を先に決めるほうが効率的です。
一度の再現で時刻を照合する
始める前に、現在のネットワーク、Config、ノード、Global Routingの動作モードを記録してください。古いログを削除する場合は、役立つ調査記録を先に保存します。ログを消してもネットワークは修復されません。ほかのアプリの通信を減らし、問題が起きる対象だけを一つ開いて、操作した時刻を記録してからLogを確認します。システムのバックグラウンドでもリクエストが発生する可能性があるため、ログにその対象だけが記録されるとは限りません。最新の一行を問題のリクエストと決めつけず、接続先のドメイン、時刻、リクエストの順序を照らし合わせてください。
対象の記録を見つけたら、まずそのリクエストがクライアントの処理対象になっているか確認し、次にポリシーを調べます。ルール上はPROXYを使うはずなのに記録がDIRECTなら、ルールとGlobal Routingを優先して確認します。想定どおりのポリシーが適用されても認証に失敗する場合は、ノードのパラメーターを確認してください。接続が確立した後にアプリがエラーを表示する場合は、接続先からの応答、アプリのセッション、関連する別のリクエストも確認する必要があります。一つのWebページでも複数のドメインにアクセスすることがあります。メインページが開いても、画像、ログイン、APIのリクエストが成功したとは限りません。必要に応じてアクセスの流れに沿って追跡してください。
| ログの段階 | 優先して確認する項目 | 避けたい誤判断 |
|---|---|---|
| 名前解決段階の失敗 | DNSと基本ネットワーク | 認証情報をすべて入力し直す |
| 想定と異なるポリシーが適用される | Global Routing、現在のConfig、ルールの順序 | 振り分けの問題をサーバー停止とみなす |
| 認証またはTLS段階の失敗 | プロトコル項目、ホスト名、システム時刻 | ポートに接続できるだけで設定ミスを除外する |
| 接続確立後に切断される | ネットワーク切り替え、接続先の応答、セッションの継続性 | 一度の切断をすべてのリクエストの失敗とみなす |
Dataの統計情報は、個別のリクエストログの代わりになりません
Dataの統計情報は、一定の範囲における通信量を確認するためのもので、リクエストごとの成功率を示すものではありません。通信量があっても、データが動いたことしか分かりません。バックグラウンドの通信かもしれませんし、失敗する前に送受信されたデータかもしれません。累計値は集計期間やリセット操作にも左右されるため、二つの設定の効率をそのまま比較するのには適しません。特定のWebページにルールが適用されたか調べるには、総通信量の増減だけでなく、該当リクエストのLogを確認してください。
同様に、システムのステータスバーに接続が表示されていても、すべてのアプリのリクエストが成功しているとは限りません。トンネルの状態、ルールの一致、接続先からの応答はそれぞれ異なる層の情報です。まず状態表示で接続が確立したか確認し、Logでリクエストの経路を調べ、最後に実際のアプリで機能が戻ったかを確かめます。3つの結果が一致すれば、より確かな結論になります。統計値だけが変化して対象のログが見つからない場合は、問題の再現方法、ログの記録状態、現在の接続によるデータを見ているかを改めて確認してください。
トラブル対処の情報を共有する前に、機密情報を削除する
サブスクリプションURL、認証情報、完全なQRコード、クラウド上の設定URLを公開しないでください。失敗した段階、ポリシーの種類、必要最小限の前後情報だけを残します。ドメイン名やアドレスを明らかに例示と分かる文字列に置き換える場合は、どの項目を置き換えたかも記載してください。
トラブル対処が終わったら、一時的に変更したログレベルを元に戻し、「問題の再現方法」「結果を変えた項目」「最終的に採用した値」を簡潔に記録してください。変更して改善しなかった場合も、元に戻したことを記録すれば、次回同じテストを繰り返さずに済みます。整理されていない大量のログより、経緯が分かる記録のほうが管理しやすくなります。ルールの順序については、続けてカスタムルールとFINALについてをご覧ください。
06 / WIDGET
Widget:ショートカット、状態表示、システムの更新
Widgetは操作の入口であり、独立した接続機能ではありません
Widgetは、システムで利用できる場所にショートカットや状態情報を表示する機能です。実際に利用できる機能は、現在の端末で提供されるコンポーネントによって異なります。初回の権限設定、有効なConfig、利用可能なノードの代わりにはなりません。初めて使うときは、Shadowrocket内で手動接続を完了させてから、システムのコンポーネント追加画面で利用できるWidgetを追加し、アプリを正しく開くか、表示された操作を実行できるか確認してください。システムに特定のコンポーネントが表示されないからといって、Configファイルの行が欠けているとは限りません。システムコンポーネントに関係のない修正をネットワークルールで探さないでください。
Widgetの初期状態は、アプリ内の関連設定と、システムのホーム画面やコンポーネント画面に実際に追加されているかの2か所で確認します。アプリにWidgetの項目があっても、システムに追加されているとは限りません。追加済みでも、表示内容が常にリアルタイムで更新されるとは限りません。まずアプリの初期設定を維持し、普段必要な入口だけを追加することをおすすめします。コンポーネントの数やサイズは、操作内容を確認しやすくするために選んでください。接続の切り分けを目的に、すべての形式を一度に追加する必要はありません。
状態表示の更新は実際の接続状態より遅れることがあります
システムがWidgetを更新するタイミングを管理するため、Widgetの表示とアプリ内の現在の状態が一時的に異なる場合があります。接続操作後はアプリとシステムのVPN状態に戻って結果を確認し、新しいリクエストを送信してください。Widgetに古い状態が表示されているだけで何度もタップしないでください。操作を繰り返すと接続状態が切り替わり、どの操作が反映されたのか分かりにくくなります。一つ操作したら結果を確認し、その後に次の操作を行うのが基本です。
状態が長時間更新されない場合は、まずアプリを開いて現在の接続状態を確認し、システムのコンポーネント画面に戻って表示を確認してください。それでも一致しない場合は、アプリのConfigを残したままWidgetを削除し、再度追加してみてください。Widgetの再追加で作り直されるのは表示の入口であり、ノードやDNSの問題が修復されるわけではありません。アプリ内でも接続に失敗する場合は、Widgetの問題から離れ、基本ネットワーク、権限、ノードパラメーターを確認してください。表示の問題を特定する前にConfigをすべて削除すると、設定の復元という別の問題まで加わってしまいます。
ロック画面、システム権限、表示する情報
ロック画面などのシステム上の場所にコンポーネントを配置できるかどうかは、端末のOSと利用可能な形式によります。実際にシステムが提供する追加方法だけを使い、別バージョンのOSのレイアウトを自分の端末にも必要なものと考えないでください。操作を完了するためにアプリを開く必要がある場合は、システムの案内に従ってください。これは接続機能が故障していることを意味しません。ロック解除後でないと完了できない操作は、まずロックを解除してから検証し、システムのアクセス制限をアプリの無反応と誤認しないようにしましょう。
他の人から見える場所に表示してもよい情報かどうかも確認してください。ノードのメモに個人の端末、地域、用途に関する手がかりが含まれていたり、Config名から使い方が分かったりする場合があります。自分には分かりやすく、内容を特定されすぎない名前を付け、ロック画面には必要な情報だけを表示することをおすすめします。名前を変更した後はWidgetの表示も確認してください。名前は識別用のラベルです。表示を整えるためにサーバーアドレス、認証情報、サブスクリプションURLを変更しないでください。それぞれ別の目的を持つ項目です。
ショートカットの操作失敗と接続失敗を区別する
アプリ内では接続できるのにWidgetの操作だけ失敗する場合は、システムコンポーネントと更新を確認します。アプリ内でも接続できない場合は、権限、ネットワーク、ノードを確認します。両方の問題を同時に変更しないでください。
On Demandと連携する場合は、最終的な発動条件を確認する
Widgetから手動で切断した後に再接続する場合、Widgetが操作を繰り返したのではなく、On Demandの条件が有効なままになっている可能性があります。まずアプリで自動条件を確認し、一時停止してからWidgetをもう一度試してください。想定どおりに動作する場合は、Widgetを何度も削除するのではなく、自動接続条件を見直します。テスト中はネットワークを固定してください。Wi-Fiの切り替えと同時に観察すると、手動操作とシステムのネットワークイベントを区別しにくくなります。
メンテナンスでは、接続手順全体の最後にWidgetを確認するのがおすすめです。基本ネットワーク、アプリ内の接続、ルールの動作、自動条件の順に確認してから、ショートカットをテストします。Widgetが一時的に使えなくても、アプリ内から操作できます。初回接続とシステム権限の手順は、使い方ガイドをご覧ください。この章ではショートカット、状態表示、更新を扱い、ネットワーク性能を高める設定としてWidgetを扱うことはありません。
07 / ICLOUD
iCloud同期:同期対象、競合、復元
同期対象を確認し、接続に必須の機能と混同しない
iCloud関連機能は、システムとアプリが対応する範囲でデータを保存または同期するためのもので、プロキシ接続の確立に必須ではありません。まず現在の端末でConfigが利用できることを確認してから、別の端末との同期を検討してください。同期画面に実際に表示されている項目と操作をもとに、対象データを確認します。ノード、Config、環境設定、ログ、システム権限がすべて一括で複製されると決めつけないでください。特にシステムのVPN権限は、使用する端末ごとに確認が必要です。クラウドにConfigファイルが表示されても、別の端末ですぐに接続できるとは限りません。
初期状態も現在の端末で確認してください。アプリ内のスイッチ、システムのiCloud設定、使用中のアカウントは同期結果に影響するため、一つのスイッチがオンになっているだけで同期完了と判断できません。まず、現在使えるローカルのコピーを残し、見分けやすいConfigを一つ選んで小規模に検証することをおすすめします。画面にインポート、エクスポート、クラウドからファイルを選ぶ操作が複数ある場合は、内容を一度コピーする操作なのか、その後も同期関係を保つ操作なのかを確認してください。操作名が似ていても、以降の更新方法は異なる場合があります。
初回の有効化前に、復元できるローカルの基準を作る
操作前に、現在使用中のConfig名、入手元、最後に手動で変更した内容を記録してください。バックアップが必要な場合は、アプリが提供するエクスポート方法を使い、自分で管理できる場所にファイルを保存します。バックアップファイルにはサブスクリプションURLや認証情報が含まれる可能性があるため、機密情報として扱ってください。公開フォルダーや共有するスクリーンショットには保存しないでください。バックアップの内容と復元方法を確認してからクラウド上のコピーを扱います。誤った変更も別の端末へ同期される可能性があるため、同期は独立したバックアップの代わりにはなりません。
初回のテストでは、まず一台の端末で名前変更など接続に影響せず識別しやすい変更を行い、もう一台で期待した変化が確認できてから、逆方向でも検証します。実際の画面がファイルの読み込みだけに対応している場合は、自動更新を待つのではなく、一度限りのコピーと理解してください。同期を促そうとして、アカウントを何度も切り替えたり、同じファイルを続けて読み込んだり、ローカルのConfigを削除したりしないでください。コピーが増えて、どれが有効なConfigか分かりにくくなることがあります。
2台の端末で同時に変更した場合の対処
競合が起きた場合は、もう一台での編集をいったん止め、両方の内容をそれぞれ保存してください。ファイル名だけで新旧を判断しないでください。名前が同じでも内容は異なる場合があります。システムに表示された時刻も、各設定項目が変更された時刻と同じとは限りません。サーバーの項目、ルールの順序、ポリシー名、最近手を加えた箇所を中心に比較します。残す基準のコピーを決めてから、明示的な読み込みや保存の操作で内容をそろえてください。どちらを上書きするのか分からない状態で操作しないでください。
サブスクリプションの更新とクラウド同期は、別の仕組みです。Subscribeの更新では通常、既存のサービス提供元のURLから内容を取得します。クラウドでの操作は、端末間またはファイルの保存場所間でデータを扱います。ノードが更新されない場合は、iCloudを先に無効にするのではなく、サブスクリプションの更新結果を確認してください。ローカルルールが古い内容に戻った場合は、読み込み元と同期されたコピーを確認します。また、サブスクリプションの更新で自分の変更箇所が置き換わる可能性にも注意してください。重要なカスタム内容は、記憶に頼らず別途記録してください。
| 現象 | 最初に確認すること | 推奨する操作 |
|---|---|---|
| 別の端末に内容が表示されない | アカウント、システムのクラウド権限、実際の同期対象 | Configを一つだけ使って検証し、まとめて何度も読み込まない |
| 似たコピーが複数できる | 一度限りの読み込みを繰り返していないか | 利用できる基準を確認してから名前を整理する |
| ノードの内容が更新されない | Subscribeの更新結果 | まずサブスクリプションの経路を調べる |
| Configはあるが接続できない | 端末の権限、ネットワーク、サーバーパラメーター | 新しい端末での初回接続手順に沿って確認する |
復元後も実行環境を項目ごとに検証する
復元の成功は、ファイルが表示されたことだけでは判断できません。想定したConfigを選択できること、ノード情報を確認できること、接続を確立できること、正しいルールが適用されることを確認してください。端末ごとにネットワーク環境が異なるため、DNSやOn Demandの条件も個別に確認が必要な場合があります。一台で利用できても、別の端末に表示された権限の案内を不要と判断しないでください。その端末でシステムの案内に従って権限を許可し、このページの段階的な手順で検証します。
同期によって修正内容が上書きされるのが心配な場合は、まずコピーを2つ保存し、さらに編集するのを止めてください。現在の同期機能でどちらからどちらへ反映されるのか確認してから、通常の操作に戻します。サブスクリプションURLが必要な場合は、正確な情報をサービス提供元から入手し、リンクを公開して助けを求めないでください。Subscribe、手動入力、QRコード読み取りの違いは、サブスクリプションの読み込み方法をご覧ください。読み込み方法によって、その後の更新場所も変わります。
08 / PROXY AND CONFIG
Proxyポート、ルールとの連携、最後に元に戻す手順
ローカルの待ち受けポートとリモートサーバーのポートは別です
Proxy関連のポートは、まず接続の向きを区別してください。Add Serverに入力するポートはリモートサーバーへの接続パラメーターであり、サービス提供元の案内に合わせます。ローカルのプロキシ待ち受けポートは、ほかのプログラムが端末上の入口に接続するときに使うもので、両者を同じにする必要はありません。システムの接続機能だけを使う場合は、「設定をそろえる」ためにローカルの待ち受けを有効にする必要はありません。現在のプラットフォームと画面に該当する項目がある場合に限り、必要に応じて設定してください。あるプラットフォームの待ち受け機能がすべての端末にあるとは限りません。
初期ポート、待ち受けアドレス、ローカルネットワークからのアクセス許可は現在の画面で確認してください。このページでは、すべてのプラットフォームに共通する初期値を指定しません。明確な必要性がなければ、現在の値を維持するのがおすすめです。ほかのプログラムからローカルプロキシを使う場合は、まず端末内だけで検証し、プロキシの種類が利用するプログラムに対応していることを確認します。HTTPとSOCKS5は自由に入れ替えられる種類ではありません。利用側のプログラムで種類を間違えると、ポートに接続できてもリクエストを完了できない場合があります。
待ち受けアドレスとアクセス範囲を別々に確認する
ループバックアドレスで待ち受ける場合は、その端末だけが利用できます。別のアドレスで待ち受けると、アクセス可能な範囲が広がる可能性があります。ポートの問題を調べるために、ローカルネットワーク全体へ不用意に公開しないでください。まず、ポートを別のプロセスが使っていないか、利用するプログラムに正しいローカルアドレスを設定しているか、プロキシ機能が実際に起動しているかを確認します。ローカルネットワーク上の端末から使う必要がある場合は、システム権限、ファイアウォール、現在のネットワークの端末間通信制限、アプリのアクセス制御を調べてください。自分が管理するネットワーク内だけでテストし、制御できないネットワークに待ち受けポートを公開しないでください。
ポートが競合している場合は、現在のシステムで利用でき、ほかのプロセスが使っていないポートを選び、それを使うプログラム側も変更してください。片方だけを変更すると、別の問題が発生します。変更後は接続を再試行し、必要であれば関連する待ち受け機能を再起動します。検証が済んだら、一時的に広げたアクセス範囲を閉じてください。ローカルネットワークのアドレスはネットワークの切り替えで変わることがあります。別の端末に保存されている古いアドレスも無効になる場合があるため、端末間の接続に失敗したときは、リモートノードをすぐに変更せず、まず現在のアドレスを確認してください。
ルールが決めるのは通信経路であり、プロトコルの設定値ではありません
Configモードでは通常、ルールが上から順に照合され、一致したルールに応じてポリシーが適用されます。DOMAIN-SUFFIXはドメインのサフィックス、IP-CIDRとIP-CIDR6はアドレス範囲、GEOIPは対応するIPアドレスの地域情報をもとに照合します。FINALは最後に適用するルールです。PROXY、DIRECT、REJECTはそれぞれプロキシ、直接接続、拒否を表します。ルールが正しくても、パスワード、証明書のホスト名、サーバーポートの誤りは補えません。通信の振り分けと接続の成立は、分けて検証してください。
以下はルールの順序を理解するための例であり、完全なConfigではありません。例に含まれるドメインやアドレス範囲は一致の仕組みを説明するためのものです。確認せずに現在のファイルへ置き換えないでください。実際に使う前に、ポリシー名が利用できることを確認し、元のファイルをコピーして残します。特にFINALの設定は、ほかのリクエストの行き先を決めます。例にあるポリシーがすべてのネットワークに適しているとは限りません。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY
検証では、対象ルールに確実に一致するリクエストを選び、Logで実際に適用されたルールを確認します。ルールが反映されていないように見える場合は、Global RoutingがConfigになっているか、編集したConfigを選択しているか、上位により広い条件のルールがないか、既存の接続が再利用されていないかを順に確認してください。ドメインルールだけを変更した場合は、新しいドメインリクエストを送信します。確立済みのセッションだけを判断材料にしないでください。ルールの順序について詳しくは、ルールの優先順位とFINALをご覧ください。
変更を最小限にしてトラブル対処を終える
最後に、一時的なテスト設定を一つずつ元に戻します。不要になったローカル待ち受けを無効にし、一時的に上げたログレベルを戻し、Global Routingを普段の動作モードに戻し、On Demandには検証済みの条件だけを残します。その後、安定したネットワークで再接続し、問題が起きた接続先にアクセスして、ルールとログをもう一度確認してください。設定を戻した直後に問題が再発する場合、その変更が次に調べるべき項目になります。すべての設定をやり直す必要はありません。
確認完了の目安
接続を繰り返し確立できること、対象のリクエストに想定したポリシーが適用されること、ネットワーク切り替え後の挙動が設定どおりであること、復元できるConfigのコピーを保管していることを確認します。スイッチがオンになっていることや、一度テストに応答があったことだけでは、これらの検証の代わりになりません。
問題が解決しない場合は、最小限の再現記録をまとめます。プラットフォーム、ネットワークの種類、現在の動作モード、失敗した段階、試した後に元へ戻した項目を記載してください。サブスクリプション情報や認証情報をすべて添付しないでください。初回接続の問題は使い方ガイドに戻り、手順に沿って確認します。クライアントの再入手やシステムによる許可手順を確認する場合は、ダウンロードページのインストールガイドをご覧ください。結果を説明できる設定だけを残し、根拠のない変更を元に戻すことが、その後も安定して管理するための出発点です。