Shadowrocket公式 · 公式マニュアル

Shadowrocket
Settingsの設定ガイド

設定項目の用途、値を設定する条件、トラブル対処の順序を確認します。まずConfigの参照元を確認し、DNS、接続トリガー、ローカルProxyを調整してください。

このページは設定項目を調べるためのリファレンスです。初回接続の手順は扱いません。自分のサブスクリプションやサーバー情報をまだ読み込んでいない場合は、使い方ガイドをご覧ください。接続できていて、特定の設定項目を確認したい場合は、以下の目次から該当箇所を参照してください。ガイド内の設定説明も本ページを基準にしています。

ShadowrocketはiPhone、iPad、Mac(Appleシリコン/Intel)、Windows、Android、Linuxに対応しています。iPhone/iPad版はApp Storeで2.99米ドルの買い切り、Mac/Windows/Android/Linux版は無料です。入手先とシステムによる許可設定は全プラットフォームのダウンロードページをご確認ください。iPhone/iPadのシステム要件はApp Storeの掲載内容をご確認ください。

確認手順:現在値を記録 → 一度に1項目だけ変更 → 接続を再確立 → 同じ対象で検証 → 維持または元に戻す。

01 / SETTINGS & CONFIG

Settings、Config、接続状態を区別する

設定の参照元は一つではありません

項目を探すときは、アプリ全体の動作、Configの動作、個別サーバーのどれを管理する設定なのかを先に確認してください。Settingsにはテスト、記録、同期、ローカルサービスなどの環境設定があります。Configは設定ファイルを管理し、サーバー編集画面ではアドレス、ポート、認証、転送パラメーターを設定します。これらは接続に影響しますが、互いに置き換えられるものではありません。たとえば、ローカルProxyのポートを変えてもリモートサーバーのポートは変わりません。テスト方法を変えても、認証情報の誤りは解消されません。

Homeの接続スイッチは、システムのネットワークトンネルを確立しようとしているかを示すもので、すべてのリクエストが目的のサーバーを経由していることを意味しません。Global Routingでは、Configに従って処理するか、ProxyまたはDirectを使うかを選択します。選択中のサーバーは、プロキシ対象の通信に使われる出口です。トラブル対処では、この3つの状態を記録してください。スイッチがオンというだけで、Config、名前解決、リモート接続まで正常だと判断しないようにしましょう。

初期値・現在値・推奨値の考え方

このガイドでいう「初期値」は、現在のインストール環境で確認できる初期状態に限ります。ネット上のスクリーンショットを、すべての端末に共通する初期値として扱いません。Configの読み込み、バックアップの復元、OSのアップデート、ネットワークの変更で実際の動作が変わることがあります。画面が空欄でも、システムやConfigの設定を引き継いでいる場合があり、必ずしも無効とは限りません。項目の説明と現在のConfigを確認してから入力の要否を判断してください。特に、確認できていない数値をポート、タイムアウト、間隔に転記しないでください。

推奨値にも前提条件があります。ローカルでテストする場合は、まず現在正常に動作している方法を維持してください。ドメインごとに通信を振り分ける場合は、ルールと名前解決の経路を先に検証します。複数端末で使う必要がなければ、設定を「完成」させるためだけに同期を有効にする必要はありません。解決したい問題と変更後の見込みを明確に説明でき、元に戻す方法もある場合に限り、該当項目を調整してください。設定を増やしても接続が安定するとは限りません。複数の条件を一度に変えると、原因の特定が難しくなります。

元に戻せる変更の基準を作る

変更前に、現在のConfig名、Global Routingのモード、選択中のサーバー、ネットワークの種類、変更予定の項目と現在値を記録してください。Configを変更する場合は、個別に復元できるコピーを保存し、見分けやすい名前を付けます。バックアップには認証情報が含まれる場合があるため、自分だけが管理できる場所に保管してください。問題を他の人に見せる際は、必要なフィールド名と認証情報を伏せた構成だけを共有し、サブスクリプションURL全体は公開しないでください。

変更は毎回1項目だけにし、いったん切断してから接続を再確立し、新しいセッションに設定を反映させてください。確立済みの長時間接続では、以前の経路が使われ続けることがあります。ブラウザーやアプリのキャッシュに古い結果が残る場合もあります。同じ対象に同じ操作を行い、近いネットワーク条件で検証してください。想定した変化がない場合は、変更したConfigが実際に適用されているかを先に確認してから、次の項目を検討します。すぐに設定を追加しないでください。

場所主な役割トラブル対処で最初に確認する点
Settingsアプリの環境設定と利用可能な補助機能現在のプラットフォームで利用できる項目か
Config名前解決、振り分け、Config内の設定意図したファイルが選択されているか
サーバー編集画面リモートアドレス、ポート、認証、転送自分のサービス情報と一致しているか
Home接続操作、選択中のサーバー、実行状態接続後に目的のリクエストが発生しているか

プラットフォームをまたいで参照する際の注意点

同じ機能でも、OSによって必要な権限や実装が異なる場合があります。iCloudとWidgetは対応するシステム機能に依存し、ローカルポートは待ち受けアドレス、ファイアウォール、プロセスの使用状況に影響されます。ある端末に表示される項目や画面配置が、別の端末にも同じようにあるとは限りません。設定を移行するときは、画面の位置をそのままなぞるのではなく、目的やルールの意図を移したうえで、利用可能な項目を一つずつ確認してください。

このページでは、自分がすでに持っているサブスクリプションやサーバー情報の使い方だけを説明します。ノードやサブスクリプションの提供、販売、推奨は行いません。アプリの買い切り料金と接続サービスの料金は別です。初回の読み込みがまだの場合は、クイックスタートに戻り、最小限の接続を確立してから、必要な項目を調整してください。今回の作業に関係のない設定は、そのままにしておけます。

02 / DNS

DNS:ドメイン名を解決している場所を確認

DNSとプロキシ接続は別の段階です

ドメインにアクセスする際、通常はまず接続先のアドレスを取得し、その後に接続します。DNSは名前解決を担い、プロキシサーバーは該当リクエストを転送します。両者は関係していますが、同じテストではありません。サーバーの遅延が正常でも、それは何らかの探査に応答があったことを示すだけです。ドメイン名を解決できなければ、Webページは開けないことがあります。反対に、名前解決ができても、リモートサービス、証明書の検証、プロキシ経由の通信が正常とは限りません。

DNSを確認するときは、システムの名前解決、Configで指定したDNS、アプリ独自の名前解決のどれを使っているかを把握してください。Wi-Fiとモバイル通信では、システムが提供するDNSが異なる場合があります。アプリ側にキャッシュがあることもあります。ShadowrocketのDNS項目を変更しても、確認対象が以前のキャッシュを使っていれば、結果がすぐには変わらないことがあります。「設定が保存されたこと」と「新しいリクエストが新しい経路を使ったこと」を分けて検証してください。

空欄、system、明示的なアドレス

Configに dns-server = system とある場合、その項目はシステムが提供する名前解決サービスを使います。これは、どのネットワークでも正常に利用できるという保証ではありません。システムのDNSを使い続けるかは、現在のネットワークと接続先での結果を見て判断してください。名前解決に問題がなければ、まず現在の設定を維持しましょう。他の人のConfigに複数のアドレスがあるという理由だけで置き換える必要はありません。DNSを明示的に指定する前に、アドレスに到達できること、用途が明確であること、リクエストの送信先を把握していることを確認してください。

画面が空欄でも、必ず system を意味するとは限りません。Configによる上書きがない状態なども考えられるため、その項目の説明を確認してください。暗号化DNSの完全なURLを、通常のアドレスだけを受け付ける入力欄に入れないでください。プロトコル形式と入力形式が、その項目の対応範囲に合っている必要があります。画面に対応の記載がない場合、特定の形式が使えると推測しないでください。形式の誤りは、保存時にエラーが出ず、名前解決の異常として現れることがあります。

[General]
dns-server = system

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

上の例は、Config内でDNSとルールを同時に記述できることを示すものです。すべてのネットワークに適した完全な設定ではありません。example.com は説明用のドメインです。ルール内の PROXY を使うには、有効なプロキシの選択も必要です。この例の要点は役割を区別することです。[General] 内のDNS項目は名前解決に影響し、[Rule] 内のルールはリクエストの処理方法を決めます。名称が似ていても、片方からもう片方の動作を推測することはできません。

遅延は正常なのにWebページが開かない場合の確認手順

まず、問題が一つのドメインだけで起きるかを確認し、普段アクセスできる別の対象でも試してください。Logに名前解決の失敗が出ているかも確認します。一つのドメインだけで問題が起きる場合は、ローカルマッピング、キャッシュ、ドメイン自体を調べます。複数のドメインで同時に起きる場合は、異なるネットワークでの結果を比較してください。検証中にサーバー、DNS、Global Routingを同時に変更すると、復旧しても原因を特定できません。

ドメイン名からアドレスを取得できた後の接続段階で失敗する場合は、サーバーの設定、ルールのマッチ状況、接続先ポートを確認します。接続後に証明書エラーが出る場合は、システム時刻、接続先のホスト名、関連するTLS設定も確認してください。接続先のIPアドレスを直接使う方法は、常に有効な検証とは限りません。接続先のサービスがホスト名、SNI、証明書との一致を必要とする場合があり、テスト条件を変えると結果を単純比較できなくなります。

IPv6、キャッシュ、ローカルマッピングの影響

同じドメインからIPv4とIPv6の両方のアドレスが返されることがあります。一方の経路だけに問題があると、一部のアプリは使えるのに、別のアプリは長時間待たされる場合があります。IPv6が見えたからといって、すぐに無効にしないでください。システムネットワークが該当する接続に対応しているか、ログの接続先がどの種類のアドレスかを確認してから、一項目ずつ比較してください。関連項目を無効にして改善した場合は、その結果とネットワーク条件を記録し、すべてのネットワークに共通する設定として扱わないでください。

[Host] のローカルマッピングも名前解決の結果を変えることがあります。トラブル対処では、現在のConfigに接続先の固定アドレスが設定されていないか、そのマッピングが今も必要かを確認してください。DNSを変更してもローカルマッピングは迂回できない場合があります。アプリのキャッシュを消してもConfigの設定は解除されません。元に戻せるように変更前の行を記録し、問題の対象に関係する項目だけを一時的に無効にしてください。正常に動作している他のマッピングまで削除しないようにしましょう。

03 / GLOBAL ROUTING

Global Routing:Config、プロキシ、直接接続

処理モードを選んでから個別ルールを確認

Global Routing の代表的なモードは、Config・Proxy・Direct の3種類です。画面上の表記も Config、Proxy、Direct です。Config は現在の設定に従ってリクエストを処理するため、ルールによる振り分けに適しています。Proxy はクライアントで処理されるリクエストをプロキシ経由にし、Direct は直接接続との比較に使います。いずれも全体の処理方法を選ぶもので、3台のサーバーや Subscribe のインポート形式ではありません。

特定のルールが有効か確認するには、Global RoutingがConfigであり、そのルールを含むファイルが選択されていることを先に確かめてください。ProxyまたはDirectの状態では、リクエストの出口だけを見ても、Config内のルールが適用されたとは判断できません。よくある誤りは、ルールを編集した後もProxyのままにして、すべての対象がプロキシ経由になることをルールの順序の問題だと考えることです。ルールの内容を変える前に、全体の処理モードを確認してください。

モード主な用途この結果だけでは確認できないこと
Config有効なConfigに従って通信を振り分けるすべてのリクエストがプロキシ経由になること
Proxyプロキシ経由の通信を比較するConfig内の特定のルールが適用されたこと
Direct直接接続を比較するリモートのプロキシサーバーが正常であること

ルールは上から順に評価し、具体的な条件を先に記述

DOMAIN は完全一致するドメイン名、DOMAIN-SUFFIX はドメインのサフィックス、DOMAIN-KEYWORD はドメイン名に含まれるキーワードにマッチします。それぞれ対象範囲が異なるため、行数を減らす目的で置き換えないでください。特定のドメインだけを対象にする場合は、明確な条件を優先します。サフィックスルールはサブドメインにも一致し、キーワードルールはさらに範囲が広いため、無関係なドメインに誤って一致しないか、追加前に確認してください。

GEOIP と IP-CIDR はIPアドレスに関する条件、IP-CIDR6 はIPv6のネットワーク範囲に使います。FINAL は前の条件に一致しなかったリクエストを処理するため、末尾に置きます。ドメインルールとアドレスルールを併用すると、名前解決の結果とルールの順序の両方が検証結果に影響します。リストにドメイン名があるだけで、そのリクエストが想定どおり処理されるとは限りません。

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

この例では、完全一致する example.com が先にDIRECTに一致します。サブドメインは後続のサフィックスルールに一致し、PROXY経由になります。その後にGEOIPとFINALで、まだ一致していないリクエストを処理します。これは順序の説明であり、現在のConfigをそのまま置き換えるための推奨設定ではありません。PROXY、DIRECT、REJECTは処理アクションです。REJECTは該当リクエストを拒否するため、一般的な接続修復の手段として使わないでください。

Configファイルの各セクションの役割

[General] は全体の動作、[Rule] は通信の振り分け条件、[Host] はローカルの名前解決、[URL Rewrite] はリクエストの書き換えを設定します。ルールのように見える行でも、誤ったセクションに書けば自動で分類されるわけではありません。編集時はセクション名を残し、前後の行が同じ種類の設定か確認してください。数行だけをコピーして、元の設定が依存するコンテキストを欠落させないようにしましょう。

サブスクリプションは、自分がすでに持っているサーバー情報の読み込みや更新に使います。Configにはルールや動作設定も含まれる場合があり、両者は同じものではありません。サーバーリストの更新に成功しても、現在のConfigが置き換わるとは限りません。Configを切り替えても、選択中のサーバーが必ず変わるわけではありません。更新後に通信の動作が変わった場合は、この2種類の設定対象をそれぞれ確認してください。ルールの問題を直そうとしてSubscribeの更新を繰り返さないようにしましょう。

推奨する検証方法と変更を元に戻す範囲

明確な対象に新しいリクエストを送り、実際のドメイン名、接続先アドレス、処理アクション、選択中のサーバーが想定どおりか確認してください。Webページは複数のドメインからリソースを読み込むことがあるため、対象をできるだけ絞ります。あるリクエストがDIRECTになっていても、ページ内のすべての接続が同じ処理とは限りません。実際に失敗しているリソースを特定してから、該当ルールを変更してください。範囲の広すぎるルールで別の問題を覆い隠さないようにしましょう。

ルールを変更したら、どの行を変え、どのリクエストが変わると期待し、実際にどの条件に一致したかを記録してください。根拠がないまま、ルール全体の順序を変えることはおすすめしません。書式を詳しく確認する場合はルールキーワードとマッチ範囲、各セクションの役割を確認する場合はConfigファイルの構成ガイドをご覧ください。元に戻すときは、保存済みのConfigに戻してから接続を再確立し、検証してください。

04 / ON DEMAND

On Demand:システムが接続を開始するタイミング

On Demandと手動接続の違い

On Demandは、条件に応じてシステムがVPN接続を開始するための設定です。「いつ接続を試みるか」を決めるもので、「接続後にどのドメインをプロキシ経由にするか」を決めるものではありません。後者はGlobal RoutingとConfigで確認します。この2つを混同すると、特定のWi-Fiを条件に設定したのに、そのネットワーク上のドメインルールまで変わると誤解することがあります。実際には、それぞれ別の設定が担う役割です。

有効にする前に、手動接続が正常に動作することを確認してください。サーバーアドレス、認証、DNSに誤りがある場合、On Demandは同じ失敗を条件に応じて繰り返すだけで、不足している情報を補うことはありません。まず安定したネットワークで手動接続し、目的のアクセスとログを確認してから、接続条件を追加してください。そうすれば、問題が起きたときに、自動接続の失敗か、元の接続自体の問題かを切り分けやすくなります。

Wi-Fiとモバイル通信の条件を選ぶ

ネットワーク条件を設定する前に、要件を具体化してください。特定のWi-Fiで接続するのか、そのネットワークから離れたときに接続するのか、モバイル通信では別の動作にするのかを決めます。互いに上書きする複数の条件を同時に追加しないでください。Wi-Fi名で条件を分けられる場合は、実際のネットワーク名を確認します。同じ名前でも物理的に同じネットワークとは限りません。公共の場所では同じ名前のネットワークが使われることがあるため、ネットワーク名を本人確認の代わりにしないでください。

モバイル通信とWi-Fiの切り替えでは、一時的な切断、アドレスの変更、セッションの再確立が発生することがあります。On Demandを確認する際は、切り替え直後のアイコンだけを見るのではなく、システムの切り替えが完了してから新しいアクセスを試してください。既存の長時間接続が切れることがあり、バックグラウンドのアプリがすぐに再試行するとも限りません。繰り返し操作できるフォアグラウンドの対象でトリガーの動作を確認し、切り替え前後のネットワーク種別を記録してください。

手動で切断しても再接続する場合

手動で切断した後、新しいリクエストをきっかけにシステムが再接続を試みる場合は、On Demandの条件がまだ満たされているかを確認してください。該当するトリガー条件をいったん無効にしてから、手動の接続スイッチをテストします。すべてのVPN設定をすぐに削除しないでください。端末管理の要件や他のネットワーク設定が関係している場合があります。削除する前に対象と用途を確認し、管理対象端末では組織のネットワークポリシーに従ってください。

「自動接続が繰り返される」問題を調べるときは、ユーザーが切断した時刻、ネットワークが変化した時刻、アプリが次のリクエストを送信した時刻を記録してください。毎回同じ条件の後に接続が始まるなら、その条件を確認します。明確なパターンがない場合は、ログとシステムの状態を調べてください。アイコンが消えた後に再表示されるだけでは、On Demand、適用中のConfigの変更、切断状態の表示遅延のどれかは判断できません。操作を再現し、記録と合わせて確認してください。

初期値と推奨設定:動作を把握してから自動化

このガイドでは、On Demandの初期スイッチ状態を固定していません。初回設定、データの復元、システムのVPN設定によって現在の状態が変わるため、端末の実際の画面を確認してください。まず手動接続が動作する状態を基準にし、本当に必要な条件を一つだけ追加してテストします。条件の関係を把握していない場合は、説明できない自動ルールを並べるより、手動で接続と切断を確実に行える状態をトラブル対処の出発点にしてください。

自動接続をテストするときは、接続してはいけない状況も検証してください。「接続するはずのときに成功した」だけでは、設定が正しいとは限りません。接続しない想定のネットワークに移動し、手動で切断してから、新しいリクエストで再接続するか観察します。想定と異なる場合は、まず条件を一つに絞って確認してください。接続トリガーの制御を、ルール末尾に拒否アクションを追加して代替しないでください。異なる層の問題が重なってしまいます。

スリープ、バックグラウンド、バッテリーの確認

システムのバックグラウンド処理、ネットワークリクエストの頻度、サーバー側の再接続方針は、接続の動作に影響します。On Demandを有効にしてバッテリー消費が増えたと感じる場合は、まず同じ使用時間で実際のリクエスト数と再接続の記録を比較してください。スイッチの状態だけで判断しないようにしましょう。失敗と再試行が繰り返される場合は、無効な設定値や到達できないネットワークが原因の可能性があります。不要な再試行を減らす前に、接続失敗の原因を解消してください。

復帰後は、まずフォアグラウンドでアクセスを確認し、次に画面ロック、復帰、ネットワーク切り替えを一通り試してください。システムは、スリープ解除の直後にすべてのアプリのセッションが再開することを保証していません。トンネルの復旧と、接続先アプリによる再試行を区別してください。手動接続は常に正常で、特定のトリガーだけが失敗する場合は、ネットワーク条件、トリガー操作、ログの概要を整理して、よくある質問とトラブル対処を参照してください。

05 / PING & CONNECTIVITY TEST

PingとConnectivity Test:テスト範囲を理解する

遅延時間が表示されても、通信全体の成功を意味しません

Ping、接続確認、Webページへのアクセスでは、テストしている段階が異なる場合があります。ホストまたはポートへの到達だけを確認するテストもあれば、ハンドシェイクや指定先へのリクエストまで行うテストもあります。具体的な内容は現在の画面に表示される説明を確認してください。結果の時間はテスト方式に応じて読み取り、異なる方式の数値を単純に比較して、すべてのアプリの使用感を判断しないでください。

一般的なPingはICMPによる探査を指すことがありますが、サーバーがICMPに応答しなくても、プロキシのポートに到達できないとは限りません。同様に、ポートに接続できても、プロトコルの認証が正しいとは限りません。画面でテスト方式を選べる場合は、ホスト、ポート、プロキシ経由のリクエストのどれを検証するか明確にし、同じ方法で比較してください。timeoutと表示されたすべてのケースを、サーバー停止と判断しないようにしましょう。

テスト先、タイムアウト、同時実行数の選び方

テスト先が必要な場合は、用途が明確で繰り返し安定してアクセスでき、入力形式にも合う対象を選んでください。完全なURLを指定する場合とホスト名だけを入力する場合では、テスト内容が異なることがあります。経験だけで置き換えないでください。対象のサービスがリクエストを制限したり、応答内容を変えたり、一時的に利用できなくなる場合もあります。一つのテスト先で失敗しただけでは、判断材料の一つにとどめ、別の方法でも確認してください。対象自体の障害を、すべてのサーバーの問題と見なさないようにしましょう。

タイムアウトが短すぎると、時間をかければ完了するリクエストも失敗と判定されることがあります。長すぎると、明らかに到達できない状態の検出が遅れます。すべてのネットワークに共通する固定値はありません。まず現在正常に動作している値を維持し、同じネットワーク、同じテスト方式で繰り返し確認してください。通常の完了時間と実際の待ち時間に応じて調整します。結果が大きく変動する場合は、タイムアウトをむやみに延長して問題を隠すのではなく、ネットワークの変化を先に調べてください。

一括テストの結果は、同時実行数、端末の負荷、ネットワークリソースの競合にも影響されます。多数の項目を同時にテストした場合、一つだけテストした結果と異なることがあります。現在のサーバーが使えるかだけを確認するなら、まず単独でテストしてから実際のアクセスを試してください。一括テストでは異常が出ても単独テストが正常なら、テストによる負荷を下げて再確認します。すぐにすべてのサーバーのプロトコル設定を変えないでください。

確認結果考えられること次に確認すること
ホストへの探査に失敗探査で想定した応答を得られなかったポートと実際のプロトコル接続を確認
ポートには到達するが認証に失敗何らかの待ち受けサービスに到達したプロトコル、認証、転送パラメーターを確認
テストは正常だがWebページが開かないテストの経路とWebページ全体の通信経路は異なるDNS、ルール、対象リクエストを確認
ネットワーク切り替え後だけ失敗セッションまたはネットワーク条件が変化した接続を再確立し、トリガーの状態を確認

プロトコル設定は名称から推測せず、項目ごとに確認

自分がすでに持っているサーバー情報には、Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard、HTTP、SOCKS5などのプロトコルが使われている場合があります。プロトコルごとに必要な項目は異なるため、アドレスとポートが同じでも別の種類に置き換えないでください。まずプロトコルを確認し、そのプロトコルに必要な認証情報を確認した後、転送方式、TLS、ホスト名などの追加項目を調べます。不足している情報は、自分のサービス情報で確認してください。

UDPまたはQUICを使う場合は、ネットワークが該当する通信を許可しているかも結果に影響します。TCPポートのテストが正常でも、UDPの経路が正常とは限りません。特定のプロトコルだけが特定のネットワークで失敗する場合は、同じConfigでネットワークを切り替えた結果を比べ、ログに該当するハンドシェイクやタイムアウトの情報があるか確認してください。転送方式の仕組みはHysteria2とQUICの解説をご覧ください。ただし、どのネットワークでも速くなると推測しないでください。

システム時刻と再現可能なテスト

システム時刻に大きなずれがあると、証明書の有効期間の判定や、時刻の一致が必要な認証処理に影響することがあります。システムの時刻とタイムゾーンが実際に合っているか、自動時刻設定が動作しているかを確認してください。証明書エラーを、検証を無効にして回避しないでください。接続先のホスト名、TLS設定、時刻を確認して、エラーの原因を特定します。検証を省略して接続できても、元の設定が正しかったことにはなりません。

テスト記録には、ネットワークの種類、テスト方式、対象、結果、変更した項目だけを残し、認証情報は記録しないでください。同じサーバーで少数回テストを繰り返し、実際に使うアプリでも確認します。timeoutが続く場合はノードのタイムアウトを確認する手順に沿って項目ごとに調べてください。遅延が最も短いことだけを選択基準にせず、一度の失敗を恒常的な問題と決めつけないでください。

06 / LOG & DATA

LogとData:問題が起きた段階を特定する

まず一度再現し、該当する記録を確認

Logは一度のアクセスを確認可能な段階に分けるためのもので、できるだけ多くのテキストを集めるためのものではありません。確認を始める前に時刻を記録し、関係のない操作を止めて、対象を一つに絞って問題を一度再現します。その後、該当する記録を確認してください。複数のアプリを同時に開くと、バックグラウンド同期、ページ内のリソース、再試行が混在し、関係のないエラーを今回の問題と誤認しやすくなります。記録を増やすより、テスト範囲を絞るほうが効果的です。

表示される項目は、プラットフォームや記録レベルによって異なる場合があります。現在の画面を基準にしてください。確認の順序は共通です。対象のリクエストがあるか、接続先の名前またはアドレスは何か、どの経路で処理されたか、名前解決、接続、認証、転送のどの段階で失敗したかを見ます。まず段階ごとに分類し、その後で詳細を確認してください。見慣れた英単語だけを検索し、前後の文脈を見落とさないようにしましょう。

リクエストの記録がない場合は、通信が入っているか確認

問題を再現しても該当するリクエストがまったく見つからない場合は、記録機能が有効か、表示範囲に今回の操作が含まれるか、時刻が一致するかを確認してください。次に、システムの接続状態と実際に使われているネットワークインターフェイスを調べます。キャッシュから応答が返されている場合や、現在の確認範囲外の経路を使う場合もあります。リクエストがその段階に到達した証拠がないため、リモートの認証情報を繰り返し変更しても通常は解決につながりません。

Webページは単一のリクエストではなく、複数のリクエストで構成されています。ページ本体は開くのに画像が読み込めない場合は、画像の接続先ドメインを調べてください。アドレスバーのメインドメインだけを確認しても十分ではありません。アプリのログインでも、トップページとは異なるAPIを呼び出す場合があります。ページを開いて一度ログインボタンを押すなど、目的の操作に必要な最小限の手順だけを記録し、時刻を手がかりに関連する接続を絞り込んでください。

名前解決、ハンドシェイク、リモート切断の違い

名前解決の失敗は、期待したアドレスを取得できていない状態です。まずDNSとローカルマッピングを確認してください。接続タイムアウトは、接続先に到達できない、ポートが閉じている、転送が制限されているなど、さまざまな段階で発生します。テスト方式と合わせて判断してください。認証エラーでは、プロトコルの種類と自分が持っている認証情報を確認します。リモート側から接続を閉じられた場合は、接続先のサービスやプロトコルの不一致などが考えられます。「切断」という表示だけで、どちら側の問題か決めつけないでください。

ログのエラーは、その後の再試行で解消した中間状態を示している場合があります。問題を判断するときは、目的の操作が最終的に完了したか、失敗が繰り返されるか、新しいリクエストも同じ段階で停止するかを確認してください。一時的なエラーと、安定して再現する失敗は別々に扱います。接続が実際には正常なら、すべてのログ表示を消すために動作中のConfigを変更する必要はありません。Logは警告が一切ないことを目指す成績表ではありません。

Dataの統計はリモートサービスの請求情報ではありません

Dataに表示される統計は、画面に表示された範囲に基づいて確認してください。現在のセッション、端末での記録、画面のフィルターなどが関係する場合があります。データ通信があったかを判断する材料にはなりますが、リモートサービス側の使用量記録の代わりにはなりません。クライアントとリモート側では、集計期間、プロトコルのオーバーヘッド、計測位置が異なることがあり、数値が一致しなくてもすぐに異常とは限りません。比較する場合は、集計開始時点と確認期間をそろえてください。

統計をリセットする前に、トラブル対処のため現在のデータを残す必要があるか確認してください。DataをリセットしてもDNSは修復されず、サーバーの状態が消去されるわけでもありません。Logの消去もConfigの取り消しではありません。「表示の消去」「接続の再確立」「設定の復元」を分けて操作し、その都度、対象の症状を確認してください。一度の消去だけでネットワークの問題が恒久的に解決したと誤認しにくくなります。

記録の詳細度と保存期間

詳細な記録は、ストレージや処理の負荷、プライバシー上のリスクを増やすことがあります。問題を再現する必要がある間だけ記録の詳細度を上げ、確認後は元の状態に戻してください。ログが多い場合は、長期間にわたり最も詳細な設定を維持するのではなく、再現手順を短くしてから、対象と時刻で絞り込みます。現在のバージョンに記録レベル、保存期間、削除機能があるかは画面で確認してください。存在しないキーを推測してConfigに追加しないでください。

問い合わせ用の情報は、プラットフォーム、ネットワークの種類、Global Routing、問題が起きる操作、失敗した段階、実施済みの単一項目テストをまとめてください。必要な箇所だけをマスキングして添えると、画面全体のスクリーンショットより判断しやすくなります。問題を分類できない場合はよくある質問とトラブル対処で似た症状を探してください。Configのセクションが関係する場合は、本ページのルールの章に戻り、実際に適用されている対象を確認します。

07 / ICLOUD & WIDGET

iCloud同期、バックアップ、Widget

同期、エクスポート、リモート更新を区別

iCloud同期には、対応するAppleのシステム、アカウント、システム権限が必要です。すべてのプラットフォームで使える共通の同期方法ではありません。同期は対応データの状態を端末間でそろえる機能、エクスポートしたバックアップは特定時点のコピーを保存する機能、Subscribeの更新は自分が利用しているサブスクリプション元から情報を再取得する機能です。どれもデータを戻せるように見えても、対象が異なるため、同じ復元方法として扱わないでください。

同期を有効にする前に、現在の端末で復元可能なコピーを保存し、もう一方の端末で使用中のデータを確認してください。両端の内容がすでに異なる場合は、同期前にどちらを基準として残すか決めます。両方で大幅に編集してから同期を何度も切り替え、システムに正しい変更を判断させようとしないでください。競合、削除、上書きの具体的な動作は、画面の案内と実際の結果を確認してください。

同期範囲を推測で補わない

サーバー、Config、選択状態、環境設定のどれが同期されるかは、現在の画面に表示される説明を確認し、少数の判別しやすいテスト項目で検証してください。Config名が同期されたからといって、すべての認証情報、Log、ローカルポートも同期されたと判断しないでください。まず秘密情報を含まない名前変更で範囲を確認し、その後で本格的な移行を行います。端末内だけで使う設定は、各端末で個別に確認してください。

同期結果がすぐに表示されない場合は、両方の端末で想定したアカウントを使っているか、システムがアプリのiCloud利用を許可しているか、ネットワークが使えるか、クラウドの空き容量に問題がないかを確認してください。その後、両方のアプリが同期を完了できる状態にして、結果を確認します。アカウントから何度もサインアウトしたり、アプリを削除したりすると変数が増え、ローカルコピーに影響することもあります。最初の対処としては避けてください。完了通知がない場合、待ち時間だけで同期済みと判断しないようにしましょう。

バックアップの保存と復元

バックアップにはリモートサービスへのアクセスに使える情報が含まれる場合があるため、機密ファイルとして管理してください。自分で管理できる場所に保存し、どの端末、Config、用途に対応するファイルか分かるようにします。ファイル名に認証情報を書き込む必要はありません。自分の別の端末に転送するときは、送信先と保存場所を確認してください。必要に応じて作業用コピーを削除し、バックアップが複数の場所に長期間残らないようにしましょう。

復元する前に現在の状態を保存し、バックアップを読み込んだ後、サーバーリスト、現在のConfig、Global Routing、接続権限を一つずつ確認してください。復元完了の表示は、データの読み込みが終わったことを示すだけで、リモートサービス情報が今も有効とは限りません。既知の情報で利用できる項目を一つ選び、手動でテストしてからOn Demandなどの自動動作を戻してください。古い設定があった場合も、自動再試行によって問題が隠れにくくなります。

Widgetは操作用の入口であり、詳細な診断画面ではありません

Widgetの形式は、システムとアプリが実際に提供する機能によって異なります。対応する操作をすばやく確認または実行する用途に適していますが、表示はシステムの更新スケジュールに影響されることがあります。接続を変更した直後にWidgetの表示が一致しない場合は、Shadowrocketを開いてHomeと実際のリクエストを確認してください。ホーム画面の表示だけでトンネルの動作を判断したり、反対の操作を連続で行ったりしないでください。

Widgetを追加したら、まず手動で接続と切断を一度ずつ試し、何が表示され、タップでどの操作が実行されるか確認してください。ロック中とロック解除後では操作に制限がある場合があるため、システムの案内に従って許可してください。接続権限は、アプリまたはシステム側でも確認が必要です。Widgetでシステム権限を回避することはできません。想定したWidgetが表示されない場合は、その形式がOSでサポートされているか確認してください。

端末の移行後はリストだけでなく各項目を確認

端末を替えた後、リストが同じように見えても実行環境が同じとは限りません。新しい端末のネットワーク、システムのVPN権限、ローカルネットワークのアクセス権、バッテリー設定が接続動作に影響することがあります。次の順序で確認してください。手動接続、DNS、ルールのマッチ状況、テスト方式、ローカルポート、最後にOn DemandとWidgetです。iCloudを使える端末間でも同様です。データの移行だけでは機能の検証になりません。

同期後の問題が複数の端末で同時に起きた場合は、まず編集を止め、両端の現状をそれぞれ保存して、直近で変わった対象を特定してください。端末を復元するときは、同期によって復元結果がもう一方に再適用されないかも考慮します。端末間で共有する必要がない設定はローカルで管理してください。同期が必要なデータには個別のバックアップ習慣を設け、同期の利便性と復元手段の両方を確保します。

08 / LOCAL PROXY & RECOVERY

Proxyポート、ローカル接続、復元の順序

ローカルの待ち受けポートとサーバーポートは別のもの

サーバー編集画面のポートはリモートサービスの設定であり、自分が持っているサービス情報と一致させる必要があります。ローカルProxyのポートは、現在の端末で手動プロキシに対応するアプリが接続するための待ち受け先です。ローカルポートをリモートポートと同じ値にしても、両者が自動的に対応するわけではありません。ローカルの待ち受け設定を変更しても、リモートの認証エラーは解消されません。操作前に、どちらのポートを編集しているか確認してください。

HTTPとSOCKS5は異なるプロキシ接続方式です。利用するアプリ側では、待ち受けサービスと一致する種類を選んでください。アドレスとポートが正しくても、種類を間違えると接続がすぐ切れたり、リクエストを処理できなかったりすることがあります。該当するプロキシ方式をアプリがサポートしているかは、アプリの設定説明で確認してください。手動プロキシに対応していないアプリは、システムにローカルポートが存在するだけでは、その経路を自動利用しません。

待ち受けアドレスで接続できる端末が決まる

ループバックアドレスは、たとえばIPv4の 127.0.0.1 のように、その端末自身からの接続に使うアドレスです。LAN内の別の端末のアドレスではありません。別の端末で自身のループバックアドレスを指定すると、リクエストはShadowrocketが動作している端末ではなく、その端末自身に送られます。ローカルアプリで使う場合は、まず端末内に範囲を限定し、不要なLAN共有機能は無効のままにしてください。

LAN経由の接続が必要な場合は、現在のプラットフォームが該当する待ち受け機能に対応しているかを確認し、待ち受けアドレス、端末のLANアドレス、ファイアウォール、ネットワーク分離の条件を確認してください。より広いインターフェイスで待ち受けると、接続可能な範囲が広がります。同じWi-Fiに接続していることは、アクセス制御の代わりにはなりません。一時的なテストのためにサービスを公衆ネットワークへ公開しないでください。テスト後は待ち受け範囲を元に戻し、そのポートを参照しているアプリを確認してください。

ポート値と使用中ポートの確認

このガイドでは、すべてのプラットフォームに共通する固定の初期ポートを指定しません。まず実際の待ち受けポートを確認し、呼び出し元のアプリにも同じ値を入力してください。変更が必要な場合は、有効範囲内で他のサービスが使用していないポートを選び、システム権限の要件も確認します。ポートを保存できても、待ち受けが開始されたとは限りません。サービスの状態またはLogを確認し、端末内から明確なリクエストを一つ送って検証してください。

ポートが使用中の場合は、終了させる前に何が使用しているか特定してください。不明なシステムプロセスをすぐに終了しないでください。不要な重複待ち受けを停止するか、どちらかのサービスに別のポートを割り当てます。その後、そのポートを参照するすべてのアプリも変更してください。Shadowrocketだけを変更して、ブラウザーの手動Proxy設定をそのままにすると、古い接続先が引き続き呼び出されます。クライアントが接続できないように見えても、実際には呼び出し元が以前の値を使っている場合があります。

症状優先して確認すること避けるべき操作
端末内のアプリから接続できない待ち受け状態、アドレス、ポート、プロキシ方式リモートの認証情報をむやみに書き換える
別の端末から接続できないプラットフォームの機能、インターフェイスの範囲、ファイアウォール、ネットワーク分離システムのセキュリティ機能をすべて無効にする
終了後にブラウザーでも接続できなくなった呼び出し元のアプリに手動Proxy設定が残っていないかサブスクリプションを繰り返し読み込む
一部の接続先にしかアクセスできない実際のルール、DNS、失敗したリクエストローカルの待ち受けポートを手当たり次第に変更する

最小限の変更から復元する

問題が明確な変更の後に発生した場合は、まずその項目だけを元に戻し、接続を再確立して確認してください。すべての設定をすぐにリセットしないでください。最近多くの変更をした場合は、関連する自動トリガーを一時停止し、保存済みのConfigに戻して現在のサーバーを確認してから、DNSを調べます。ローカルの待ち受け設定と呼び出し元アプリの設定は最後に確認してください。依存関係に沿って段階的に戻し、キャッシュ削除、データ削除、再インストールを一度に行わないようにしましょう。

リセットの前に、利用できるバックアップが保存されていること、自分が使っているサブスクリプションやサーバー情報を再取得できることを確認し、システム側の手動ProxyとVPN設定を記録してください。再インストールしても、システムのネットワーク状態がすべて消えるとは限らず、無効になったリモート情報が復旧するわけでもありません。アプリを再取得する場合は、ダウンロードページで現在のプラットフォームを選び、記載されたインストール許可の手順に従ってください。このページではインストーラの場所を推測しないでください。

復元後に確認する順序

まず対象を一つ決めてアクセスできることを確認します。次にConfigのルールが想定どおり適用されるかを確かめ、Wi-Fiとモバイル通信を比較し、最後にOn Demand、同期、Widgetを戻してください。各段階の結果を記録し、問題が出たら直近の正常な状態に戻します。こうすることで、基本の接続と自動化設定を分けて検証でき、すべてを一度に戻した後に原因が分からなくなるのを防げます。

まだ接続できない場合は、名前解決、接続、認証、ルール、呼び出し元の順に証拠を整理し、必要な項目をマスキングしてよくある質問とトラブル対処を確認してください。設定は、すべての入力欄を埋めることが目的ではありません。変更ごとに明確な用途があり、同じ条件で結果を再現でき、元に戻す記録があることが大切です。関係のない項目は、検証済みの現在の状態を維持し、新しい必要が生じたときに該当する章を参照してください。