クライアント導入ガイド

V2Rayのインストール・設定ガイド

OS別のインストール方法と、接続の仕組みを解説します。インストーラーの選び方、サブスクリプションの追加、システムプロキシ、TUNモードを網羅。

初めて設定する場合は、まずクイックスタートガイドに沿って、インポート、モード選択、接続確認を進めてください。このページはリファレンスです。インストーラーの選び方がわからない場合は該当OSの章へ、ノードに接続できてもアプリがプロキシを使わない場合は、接続確認またはトラブルシューティングから確認しましょう。

01共通の準備

インストール前の準備:クライアント、インストーラー、サブスクリプション

クライアント、コア、ノードの違い

クライアントは、サブスクリプションの保存、ノードの選択、プロキシモードの切り替えを行う日常操作用のGUIです。コアはバックグラウンドで設定を読み込み、接続を確立してルーティングルールを適用します。ノードは接続先の設定で、通常はサーバーアドレス、ポート、認証情報、通信方式などが含まれます。クライアントをダウンロードして起動しただけでは、利用可能なノードを取得したことにはなりません。ノードをインポートできても、アプリがプロキシ経由で通信しているとは限りません。

Project Vは、このツール群を理解するための出発点です。V2FlyはV2Rayのコミュニティ開発を引き継ぎ、Xrayは関連するエコシステムから派生した別のコアです。同じプロトコルでも、コアによって対応する通信方式やセキュリティ設定が異なる場合があります。移行時は、元の設定で使っているコアと通信方式の組み合わせを確認し、移行先のクライアントが認識できるか確認してください。ノード名が同じだからといって、設定内容まで同一とは限りません。

まずOSを確認してからインストーラーを選ぶ

デスクトップではv2rayNがおすすめです。AndroidではXrayコアを使うv2rayNGを優先し、設定でV2Flyコアが必要な場合はv2flyNGを検討してください。ダウンロードページを開く前に、端末のOSとプロセッサー情報を確認しましょう。外見が似たPCでもアーキテクチャが異なることがあります。また、同じアーキテクチャでも、OSやディストリビューションによって必要なパッケージ形式は異なります。

4つのプラットフォームで確認する項目
プラットフォームクライアント確認項目
Windowsv2rayNシステムアーキテクチャ、DesktopまたはWPFのUI
macOSv2rayNAppleシリコンまたはIntelプロセッサー
Linuxv2rayNディストリビューションのパッケージ形式、x64またはarm64
Androidv2rayNG、代替候補はv2flyNG必要なコア、arm64または汎用パッケージ

アーキテクチャの表示は、ソフトウェアパッケージが動作するシステム環境を示すもので、速度のランクではありません。スマートフォンのプロセッサーが64ビット対応でも、OSがアプリに対応する実行環境を提供しているとは限りません。デスクトップでは、インストーラーとポータブル版のアーカイブも区別しましょう。インストーラーは通常、アプリ用フォルダーやショートカットを作成します。ポータブル版では、展開後のフォルダー構成を保つ必要があります。別のパッケージに切り替える前に元の形式を確認し、旧フォルダーから実行ファイルだけを新しいフォルダーにコピーしないでください。

サブスクリプションURLと単一ノードの共有リンクを見分ける

サブスクリプションURLは通常、Web形式のアドレスで、クライアントがノード一覧を取得するために使います。URLを追加しただけではサブスクリプショングループが作成されるだけで、ノードを取得するには更新が必要です。vless://やvmess://で始まる共有リンクは、通常は単一ノードの情報です。クリップボードからノードをインポートする機能を使ってください。Webアドレスがログインページやヘルプページの場合もあります。URLの用途を確認し、見た目だけでサブスクリプションだと判断しないようにしましょう。

QRコードを読み取る場合も、単一ノードかサブスクリプションかを先に確認してください。読み取り後、クライアントに表示されるのがサブスクリプション追加フォームか、ノードのプレビューかを見ます。同じ名前の項目がすでに一覧にある場合は、グループやノードの種類を確認すれば十分です。インポート結果を確かめるために一覧を消去する必要はありません。リンクごとの更新方法については、共有リンクとサブスクリプションURLの違いをご覧ください。

元に戻せる状態を保つ

インストール前に、システムプロキシが有効か、ほかのVPNを使用しているか、職場のネットワークで固定プロキシが必要かを記録してください。組織が管理している設定は、許可なく上書きしないでください。既存のクライアントを使っている場合は、バックアップまたはエクスポート機能で設定を保存します。サブスクリプショングループ、手動で追加したノード、カスタムルーティングを残してから、クライアント間の移行を検討してください。エクスポートしたファイルも機密情報として扱い、共用PCの公開ダウンロードフォルダーに放置しないでください。

初回は、できるだけ手順を絞って接続を確認しましょう。ノードまたはサブスクリプションを1つだけインポートし、ノードを1つ選び、通信の取り込み方法を1つだけ有効にして、あらかじめ決めたテスト先にアクセスします。最初からDNS、ルーティングルール、自動起動を同時に変更するのは避けてください。接続を確認してから必要な設定を追加すれば、初回に失敗しても、インストール、インポート、コアの起動、アプリの通信取り込みのどこに問題があるか判断しやすくなります。

02デスクトップ設定

Windows:v2rayNのインストールとシステムプロキシ

Desktop版またはWPF版を選ぶ

「設定」から「システム → バージョン情報」を開き、システムの種類を確認します。Windowsダウンロードで、インストーラーの表記を確認してください。Desktop版はクロスプラットフォームのUIを採用し、従来のWPF版は使い慣れたWindowsの画面構成です。選ぶ基準はシステムとの互換性や使い勝手であり、ノードのプロトコルではありません。ダウンロードページのx64版はx64環境向けです。ほかのアーキテクチャの端末では、システムが対応する実行方法を提供しているか確認してください。パッケージ名のビット数だけで対応状況を判断しないようにしましょう。

トレイに残っているインスタンスも含め、旧クライアントを終了してからインストーラーを実行してください。セットアップウィザードを完了したら、新しいショートカットから起動します。実行環境が不足しているというメッセージが表示された場合は、まず必要なコンポーネント名とアーキテクチャを記録し、パッケージの案内に従って対応してください。アプリの実行が制限される場合は、インストール元、システムの警告、端末の管理ポリシーを確認します。起動のためにシステムの保護機能全体を無効にしたり、システムフォルダーに設定を保存したりしないでください。

サブスクリプションを追加して現在のノードを選ぶ

サブスクリプショングループのメニューからグループを追加し、識別しやすい名前とサブスクリプションURL全体を入力して更新します。PCでまだプロキシを使えない場合は、プロキシを経由せずに更新できますが、現在のネットワークからサブスクリプションサービスに直接アクセスできることが条件です。既存の接続を経由しないとURLにアクセスできない場合は、まずその接続を使える状態にしてから、プロキシ経由で更新してください。「更新成功」という表示だけでノードが使えると判断せず、該当グループを開いてノードが表示されたか確認しましょう。

共有リンクだけがある場合は、リンク全体をコピーし、クリップボードからノードをインポートします。インポート後に項目を選択し、現在のサーバーまたは有効なノードとして設定してください。具体的な項目名はクライアントのUIによって異なります。一覧でハイライトされている行が、実際に使用中とは限りません。クライアントの状態表示や今回の接続ログで、選択中のノードを確認しましょう。同じ名前で複数回インポートされた項目を順番に試す必要はありません。

ブラウザーにはシステムプロキシ、ほかのアプリには必要に応じてTUN

まずトレイメニューでシステムプロキシを「システムプロキシを自動設定」または同等の項目に切り替え、システムプロキシを参照するブラウザーから新しいリクエストを送ります。システムプロキシはローカルプロキシのアドレスをアプリに伝える設定で、すべてのプロセスを直接取り込むものではありません。独自のネットワーク設定を持つツールは、引き続き直接接続することがあります。ブラウザーも既存の拡張機能、管理ポリシー、個別のプロキシ設定の影響を受ける場合があります。対象アプリに手動でプロキシを指定できるなら、PC全体の通信方式をすぐに変更せず、まずそのアプリだけで確認できます。

仮想ネットワークインターフェースで通信を取り込む必要があるアプリについては、TUNを個別にテストしてください。元のモードを記録し、テスト対象アプリの手動プロキシを無効にして、クライアントの画面に従って権限を設定します。有効にしたら、仮想インターフェースと関連ルートが作成されたことを確認し、通常のWebアクセス、LANアクセス、維持する必要がある仕事用の接続をそれぞれテストします。TUNがオンと表示されても、ルートの設定に成功したとは限りません。失敗したらモードをオフにして起動エラーを確認し、何度も権限を付与したり再起動したりしないでください。

トレイに残ったプロセスとポートの競合を確認する

メインウィンドウを閉じても、v2rayNがトレイに常駐することがあります。アップグレードやDesktop版・WPF版の切り替え前に、旧インスタンスのメニューから終了してから新しいバージョンを開いてください。ログにローカルポートのバインド失敗が表示されたら、設定から該当ポートを確認し、旧クライアントやほかのローカルサービスが待ち受けていないか調べます。正体のわからないプロセスを終了しないでください。ポートを変更する場合は、ブラウザーやツールに保存した手動プロキシのアドレスも更新します。

クライアントを終了した後に突然ネットワークへ接続できなくなった場合は、まずシステムプロキシがローカルアドレスを指したままか確認し、そのポートで待ち受けているプログラムがあるか調べます。PC全体がオフラインになったように見えても、実際には終了済みのローカルプロキシへアプリが接続し続けているだけかもしれません。特定のアプリだけ復旧しない場合は、アプリを再起動してもう一度試します。古い接続を使い続けている可能性があります。ローカル設定が復旧したことを確認してから、リモートノードやネットワークに別の問題がないか判断してください。

03デスクトップ設定

macOS:チップ別のパッケージ選び、インストール、プロキシ

「このMacについて」でディスクイメージを選ぶ

Appleメニューから「このMacについて」を開きます。デバイス情報にAppleシリコンと表示される場合は、macOSダウンロードからApple Silicon向けのarm64版を選びます。Intelプロセッサーと表示される場合はx64版を選んでください。チップの判定には、エミュレーション環境のターミナル出力ではなくシステム情報を使いましょう。判断できない場合も、異なるパッケージを続けてインストールするのは避けてください。同じ名前のアプリが複数あると、その後の起動経路やプロキシ状態を特定しにくくなります。

ダウンロードしたディスクイメージを開き、ウィンドウの案内に従ってアプリを「アプリケーション」フォルダーへドラッグします。移動先から起動した後、ディスクイメージを取り出してください。イメージ内から長期間起動したり、同名のアプリをダウンロードフォルダーと「アプリケーション」フォルダーに別々に置いたりしないでください。旧アプリを置き換える前に、メニューバーまたはアプリメニューから完全に終了します。システムが起動を拒否した場合は、アーキテクチャ、OSバージョン、管理上の制限のどれが原因か、表示内容を確認してください。アプリ保護をまとめて無効にしないでください。

グループでサブスクリプションを管理し、ローカル権限の範囲を確認する

v2rayNを起動し、サブスクリプション機能でグループを追加します。URLを欄にすべて貼り付け、識別しやすい名前を付けてから手動で更新してください。複数のデスクトップやアプリウィンドウを使っている場合は、現在のウィンドウに新しいグループが表示されているか確認します。全ノードの一覧を表示しているだけの場合もあります。共有リンクが1つだけある場合は、クリップボードから明確なローカルグループにインポートすると、自動更新される項目と手動管理が必要な項目を後で見分けやすくなります。

旧PCのサブスクリプションを移行する場合は、まず元のURLからグループを作り直し、残す必要がある手動ノードだけをインポートしてください。アプリの設定フォルダー全体をそのまま置き換えるのは避けましょう。旧OSのローカルパス、ポート、権限、コアの設定が新しい端末に適合するとは限りません。初回起動時に操作の許可を求められたら、ネットワークの取り込みかローカルファイルへのアクセスかを確認し、必要な機能だけに権限を付与します。許可後の変化も記録してください。

ネットワークサービスごとにシステムプロキシを確認する

クライアントでシステムプロキシを有効にしたら、「システム設定 → ネットワーク」で現在使用中のネットワークサービスを開き、詳細情報にあるプロキシ設定を確認できます。Wi-Fiと有線ネットワークを切り替える場合は、サービスが異なることがあり、プロキシの状態も引き継がれるとは限りません。ループバックアドレスが設定されている場合は、ポートがクライアントの現在のローカル待ち受けポートと一致するかも確認してください。古いポートがシステム設定に残っていても、新しいプロセスはリクエストを受け取れません。

特定のアプリだけ接続に失敗する場合は、まずシステムプロキシを参照するアプリかどうかを確認し、そのうえでTUNの使用を検討します。現在のビルドで利用でき、対応しているTUN機能は画面の手順に従って有効にしてください。競合する可能性があるローカルプロキシを停止してから、通常のWebページ、イントラネット、スリープ復帰後の状態を確認します。権限またはルート設定の失敗が表示された場合は、システムプロキシに戻して基本接続を確認しましょう。スイッチを何度も切り替えても、エラーの原因は特定できません。

スリープ復帰、ネットワーク切り替え、プロキシ設定の残留に対処する

PCがスリープ中に、ネットワーク機器が以前の接続を切断していることがあります。復帰後に別のネットワークサービスへ接続している場合もあります。ページの読み込みが長時間続く場合は、まず現在のネットワークが正常に接続できるか確認し、クライアントで接続を再確立してから新しいリクエストを送ってください。古いタブ、長時間のダウンロード、バックグラウンド同期が旧接続を使い続けていても、新しいリクエストも失敗するとは限りません。繰り返し発生する場合は、ネットワーク切り替え後またはスリープ復帰後に限って起きるか記録しましょう。

クライアントのシステムプロキシを解除してもLANに接続できない場合は、ネットワークサービスにプロキシ自動設定スクリプト、手動プロキシ、特殊な除外設定がないか確認し、ほかのネットワークツールが動作していないか調べてください。会社や学校が設定した項目はそのまま残します。今回のインストールで追加された項目だけを、記録に沿って元に戻してください。復旧後はまずローカルサービス、次にインターネットをテストします。ローカルサービスに接続できない場合は、LAN内の経路を調べましょう。リモートノードの変更では解決しません。

04デスクトップ設定

Linux:パッケージ形式、デスクトッププロキシ、TUN

ディストリビューションとアーキテクチャの両方を確認する

Linuxダウンロードからv2rayNを選びます。Debian系ディストリビューションでは通常deb、Fedoraなどrpm系のパッケージ管理を使うディストリビューションではrpmを選びます。形式が合っていることは最初の確認項目です。ディストリビューションのバージョン、依存関係、デスクトップ環境も確認してください。2種類の形式を単なる拡張子の違いと考えたり、無理にインストールするために変換ツールでパッケージを書き換えたりしないでください。ターミナルしか使えない場合は、次の読み取り専用コマンドでシステム情報を確認できます。

cat /etc/os-release
uname -m

/etc/os-releaseにはディストリビューション情報が記載され、uname -mは現在のカーネルから見えるマシンのアーキテクチャを表示します。一般的に、x86_64はx64、aarch64はarm64に対応します。コンテナや仮想マシン、異なるアーキテクチャが混在する環境では、実際のインストール対象であるソフトウェアパッケージ管理システムのアーキテクチャも確認してください。たとえばDebian系ではdpkg --print-architectureで確認できます。ホスト側の結果をゲストOSの結果と取り違えないようにしましょう。

現在のデスクトップセッションから起動し、サブスクリプションを追加する

システムのソフトウェアインストーラーで対応するローカルパッケージを開き、依存関係の案内を確認してインストールします。失敗した場合は、不足パッケージ名、アーキテクチャの競合、ディストリビューションのバージョン制限を確認してください。「インストールは完了したがウィンドウが見つからない」場合は、アプリメニューから起動し、利用可能なGUIセッションにログインしているか確認します。リモート端末からGUIアプリを起動する場合と、ログイン中のユーザーのデスクトップから起動する場合では、画面やプロキシ設定が同じになるとは限りません。

正常に起動したら、サブスクリプションメニューでグループを作成して更新し、ノード一覧に項目が表示されることを確認します。単一の共有リンクはクリップボードからインポートしてください。普段デスクトップにログインしているユーザーでアプリを実行します。画面を開くためだけに管理者権限で起動すると、別のユーザーフォルダーに設定が保存され、後から通常アカウントで開いたときにデータが消えたように見えることがあります。ネットワーク機能に権限昇格が必要な場合は、クライアントが対応する方法で許可してください。GUIアプリ全体を常に管理者権限で実行しないでください。

デスクトッププロキシとターミナルプロキシの違いを確認する

デスクトップ環境のシステムプロキシはアプリが参照する設定ですが、すべてのデスクトップ環境やプログラムが同じインターフェースを使うわけではありません。ブラウザーはデスクトップの設定に従う場合がありますが、ターミナルのコマンドは独自の引数や環境変数しか参照しないことがあります。まずクライアントのローカルHTTPまたは混合プロキシが待ち受けていることを確認し、1回だけ実行するコマンドにプロキシを明示します。接続を1回試すために、ターミナルの起動ファイルへプロキシ設定を書き込む必要はありません。次の例では、クライアントの設定に表示されるローカルHTTPまたは混合プロキシのポート番号を入力します。

printf 'ローカルHTTPまたは混合プロキシのポート:'
read -r proxy_port
curl --noproxy '' --proxy "http://127.0.0.1:${proxy_port}" \
  --max-time 15 --head https://example.com/

このコマンドは、ループバックアドレスでHTTP接続を提供するローカルプロキシ向けです。設定がSOCKSのみの待ち受けを示している場合は、ポートをこのコマンドにそのまま入れず、対応するプロトコル用のオプションを使ってください。明示的なプロキシ経由のリクエストは成功するのに通常のプログラムが失敗する場合は、そのプログラムの通信取り込み方法と独自のプロキシ設定を確認します。コマンドが応答を返しても、確認できるのはそのリクエストに通信経路があったことだけです。リモートノードを経由したかどうかは、クライアントログのルーティング結果と照合してください。

TUNを使う前に権限、インターフェース、既存の設定を確認する

TUNを有効にする前に、実行環境が仮想ネットワークインターフェースに対応し、現在のビルドがこのモードをサポートしているか確認してください。クライアントを起動できても、コンテナや管理対象の環境ではインターフェースの作成やルートの変更が許可されない場合があります。クライアントで権限またはインターフェースのエラーが表示されたら、確認済みのシステムプロキシに戻し、実行環境で許可されている権限を調べます。システム機能を変更するコマンドを安易にコピーしたり、ファイアウォールを無効にして最初の原因調査をしたりしないでください。

有効化後も特定のターミナルやサービスだけ挙動がおかしい場合は、古いプロキシ環境変数が残っていないか、独自のネットワーク名前空間で動いていないか確認してください。TUNをオフにした後、新しいターミナルと新しいブラウザーウィンドウでそれぞれ再テストします。新しいセッションは使えるのに古いセッションが使えない場合は、プロセスが引き継いだ環境が原因かもしれません。同じデスクトップ上のアプリ全体が使えなくなった場合は、現在のインターフェース、ルート、名前解決設定が想定どおりに復元されたか調べます。

05モバイル設定

Android:v2rayNGのインストールとVPNによる通信の取り込み

用途に合わせてクライアントとパッケージを選ぶ

Androidダウンロードを開きます。通常はXrayコアを使うv2rayNGがおすすめです。V2Flyコアが必要な設定の場合は、v2flyNGを検討してください。arm64アプリに対応する端末ではarm64版を選びます。システムが対応するアプリのアーキテクチャを確認できない場合は、同じクライアントの汎用パッケージも選択肢になります。汎用パッケージはより多くのアーキテクチャに対応しますが、OSバージョンの制限を解消するものではなく、既存アプリとの署名の競合も解決できません。

ダウンロード後、ファイルマネージャーまたはブラウザーからインストーラーを開き、システムの案内に従って今回のインストール元に必要な権限だけを付与します。権限は後から取り消せます。更新時は、既存アプリと同じ配布元のパッケージを優先してください。上書きできない場合は、署名の違い、上書きできないバージョン、ストレージ不足、端末の管理ポリシーを確認します。すぐに旧アプリをアンインストールしないでください。サブスクリプション、手動で追加したノード、アプリごとの設定も削除されることがあるため、必要なデータを先にバックアップしましょう。

サブスクリプションを追加するか、単一ノードのQRコードを読み取る

クライアントを開き、サブスクリプショングループ設定で項目を追加します。名前とURLを入力して保存したら、ノード一覧に戻ってサブスクリプションを更新してください。更新後は対象のグループを表示しているか確認し、別のグループにある古いノードと取り違えないようにします。初回インポートでは設定を変えず、テストの基準としてノードを1つだけ選びます。デスクトップでは更新できるのにスマートフォンではできない場合は、スマートフォンがWi-Fiとモバイルデータのどちらを使っているか記録してください。デスクトップで正常に追加できたサブスクリプションは削除しないでください。

単一ノードのリンクを受け取ったらコピーしてクリップボードからインポートします。QRコードを受け取った場合は、クライアントで利用できるスキャンまたは画像インポート機能を使ってください。QRコードには設定テキストと同様に認証情報が含まれる場合があるため、共有アルバムに残さないようにしましょう。認識されない場合は、画像の切り抜き、圧縮、反射の有無を確認してから、QRコードの用途を確認します。サブスクリプショングループの更新とQRコードからのインポートは別の操作です。ノードを1つ読み込んでも、自動的にサブスクリプションにはなりません。

システムのVPN許可とアプリごとの対象範囲を理解する

ノードを選択して接続を開始すると、通常はシステムからVPN接続の確認が表示されます。これはクライアントが指定された通信を取り込むための許可で、PCでシステムプロキシのアドレスを入力するのとは異なります。許可後はクライアントの状態とシステムのVPNアイコンを確認してから、ブラウザーで新しいリクエストを送ってください。システムのアイコンは通信取り込みサービスが起動したことを示すだけで、リモート接続の成功やすべてのアプリの通信が取り込まれたことを保証しません。アイコンがすぐ消える場合は、ほかのVPNやシステムポリシーによってサービスが置き換わっていないか確認します。

クライアントにアプリごとのプロキシ設定がある場合は、ノード選択ではなく通信を取り込むアプリの範囲を設定するものとして扱ってください。画面の設定が「選択したアプリのみ」か「選択したアプリを除外」かを確認してから設定します。ブラウザーを一覧に入れても、ダウンロード管理アプリや別プロセスで動くアプリまで対象になるとは限りません。トラブルシューティングでは対象範囲を明確にし、ブラウザー1つだけで確認します。設定に問題がないことを確認してから、元のアプリ一覧に戻してください。常時接続VPNやVPNを経由しない通信を禁止する設定は、復旧テストに影響する場合があります。変更前に元の設定を記録しましょう。

ネットワーク切り替え、バックグラウンド制限、端末ポリシーを見分ける

画面を消した後にだけ接続が切れる場合は、画面を再点灯したときにVPNサービスが動作しているか確認し、システムのバックグラウンド制限や省電力設定が有効か振り返ってください。問題が繰り返し起き、実際に利用に支障がある場合に限り、端末の設定でこのクライアントに必要な権限を付与します。端末全体の省電力保護を無効にする必要はありません。接続中にモバイルデータへ切り替えられない場合は、古い接続を切って再接続し、新しいリクエストで接続の復旧に問題があるのか、現在のネットワークに接続できないのかを確認しましょう。

学校、職場、管理対象の端末では、アプリのインストール、バックグラウンド起動、VPNの利用が制限されている場合があります。これらの制限はサブスクリプションの有効性とは関係ありません。端末の管理ルールに従ってください。Wi-Fiとモバイルデータを切り替えても特定のアプリだけ失敗する場合は、アプリごとの対象リスト、アプリ独自のプロキシ設定、ルーティングルールを確認します。VPNサービス自体を確立できない場合は、ノードを調べる前にローカルの許可設定や競合するVPNを確認してください。

06設定の確認

接続確認:ローカル待ち受けからルーティングまで

ネットワーク接続を4段階に分けて確認する

最初に、コアが起動できるか確認します。デスクトップではローカルプロキシのポートが待ち受けを開始したか、モバイルではシステムの通信取り込みサービスが確立したかを見ます。次に、テストするアプリのリクエストがクライアントに届いているか確認します。新しいリクエストを送ってログを確認してください。画面の接続ボタンやノード一覧のテスト結果だけでは判断できません。クライアントにリクエストが届いていない場合、リモートノードを変えても結果は変わらないことがあります。まずアプリの通信取り込み設定を見直しましょう。

3段階目は、リクエストがどのルーティングルールに一致し、プロキシ、直接接続、ブロックのどれが適用されたか確認します。4段階目で初めて、接続先が応答するかを確認します。Webページは複数のドメインを読み込むことがあり、メインのHTML、画像、スクリプト、ログインAPIで異なるルールが適用される場合があります。まず、リクエストの発生元が明確で、複数の外部サイトに依存しない接続先でテストし、その後、元のアプリに戻ってください。テスト先は通常の利用環境と比較できるものを選びますが、自分のアカウントページや実際のサブスクリプションURLを使う必要はありません。

確認できた事実から問題の範囲を絞る
確認するレイヤー確認できる症状優先して確認する項目
起動コアが終了する、またはインターフェースが作成されない設定エラー、ポート、権限
通信の取り込みテスト対象アプリのリクエストがログに残らないログレベル、プロキシモード、対象アプリの範囲
ルーティングリクエストは届いているが、出口が想定と異なる一致条件、ルールの順序、デフォルトの出口
アウトバウンド出口は想定どおりだが、応答がないノードへの接続、名前解決、通信方式、セキュリティ設定

システムプロキシ、グローバルルーティング、TUNの違い

「システムプロキシ」は、アプリがローカルプロキシを見つける方法を指します。「グローバル」は通常、クライアントに取り込まれた通信がどの出口を使うかを示します。この2つは同じ設定ではありません。グローバルルーティングを選んでも、システムプロキシを参照しないプロセスはクライアントに取り込まれない場合があります。TUNはシステムの仮想ネットワークインターフェースを通じて、ルーティング条件に合う通信を受け取ります。通常はより広い範囲をカバーしますが、除外ルール、システムの機能、ほかのネットワークサービスの制約を受けることがあります。

初回の確認では、この3つを同時に変更しないでください。まずシステムプロキシの設定手順に沿って、プロキシを参照することが明確なアプリでテストします。その後、実際の用途に合わせてTUNへ切り替えるか判断してください。切り替えるときは、先に以前の通信取り込み方式を想定どおりの状態に戻します。TUNを有効にした後も、アプリが古いポートへ手動で接続し続ける状況を避けられます。違いを明確にするには、同じノード、同じ接続先、同じネットワークを使い、通信取り込み方式だけを変えて比較してください。

ルールの順序、ドメイン、IPアドレスを確認する

画面の機能を使ってルーティングルールとデフォルトの出口を確認します。順序のあるルール一覧では、通常、最初に一致したルールが適用されます。範囲の広い条件が前にあると、後の具体的なルールに適用されるはずのリクエストを先に処理してしまうことがあります。ルールで直接接続とプロキシのどちらが選ばれるかは、紐付けられた出口にも左右されます。トラブルシューティングでは、まず全ルールを削除せず、条件が明確なテストリクエストで一致内容を確認し、その通信に影響するルールだけを変更してください。

ドメインルールはホスト名単位の通信整理に、アドレスルールは特定のIPアドレスやネットワーク範囲の指定に使います。ドメインを取得できるか、先にIPアドレスへ名前解決するかは、アプリが指定した接続先やコアの動作に左右されます。同じサービスでも、ドメイン名でのアクセスとIPアドレスへの直接接続では、別のルールに一致する場合があります。一部のサイトだけで問題が起きる場合は、実際のリクエスト先を確認してください。ブラウザーのタブに表示されるタイトルだけを見ても判断できません。ルールを変更する前に現在のルーティングをエクスポートしておけば、元の順序に戻せます。

データベース、名前解決、ノード更新を切り分ける

GeoSiteはドメインの分類データ、GeoIPはIPアドレスの分類データです。これらの分類を使うルールは、コアが実際に読み込んでいるデータベースと既存の項目に依存します。データベースの更新とサブスクリプションの更新は別の操作です。前者はルールの照合に使うデータを更新し、後者はノード一覧を更新します。ルールが残っているのに分類項目が見つからない場合は、正しいデータベースが読み込まれているか、現在のコアが読み取れるかを確認してください。更新したデータファイルを、旧ディレクトリのどこかへ無造作に置かないでください。

ドメインを名前解決できなくても、すべてのDNS設定をすぐ変更する必要はありません。まず失敗しているのがサブスクリプションサービス、ノードサーバー、テスト先のどれかを判断し、アプリ、システム、コアのどこで起きているか確認します。独自の名前解決方法を使うアプリもあるため、システムで名前解決できるからといって、そのアプリも正常とは限りません。現象を記録してから、一度に1項目だけ変更して再テストしてください。ルーティング用データの形式については、GeoIP・GeoSiteデータベースの更新方法をご覧ください。

07トラブルシューティング

設定でよくある問題と復旧方法

直近に変更した項目を確認する

最後に正常に使えた時点からさかのぼって確認します。クライアントをアップデートしたか、コアを入れ替えたか、サブスクリプションを変更したか、Wi-Fiを切り替えたか、システムプロキシを変更したかを見直してください。最後の変更時刻と、最初に失敗した時刻を分けて記録します。元に戻せる場合は、直近の変更を1つだけ取り消し、同じノードとテスト先で再確認してください。アンインストール、名前解決の変更、ルーティングの再設定を同時に行うと、たまたま復旧しても、次回に同じ問題が起きたときの対処方法がわからなくなります。

症状に合わせて確認を始める

サブスクリプションを更新できない場合、URLとノードのどちらを先に確認する?

まずサブスクリプションURLと取得経路を確認します。元のURLがすべて含まれているか、コピー時に空白、改行、末尾の句読点が入っていないかを見直してください。ログインページ、エラーページ、空のレスポンスでもダウンロード自体は成功し、設定として解析できない場合があります。クライアントに表示されるエラーから、リクエストが届いていないのか、サーバーに拒否されたのか、内容の形式が合わないのかを切り分けてから、取得経路の変更を検討します。

古いグループにノードが残っている場合は、そのまま保管してください。古いノードに接続できてもサブスクリプションを更新できるとは限りません。更新に失敗しても、古いノードがすべて使えなくなったわけではありません。プロキシを使わない更新が有効なのは、現在のネットワークからサブスクリプションサービスへ直接アクセスできる場合だけです。既存の接続を使う必要がある場合は、利用可能なノードを残してプロキシを復旧してから更新してください。どちらの経路でも拒否される場合は、URLの有効期限とアクセス条件を確認します。URLを何度も貼り直したり、公開して助けを求めたりしないでください。

ノードをインポートしたのに接続できないのはなぜ?

まず、そのノードが現在のノードとして選択され、クライアントが接続を開始しているか確認します。コアの起動直後に終了する場合は、エラーから設定項目、ファイルパス、ローカルポートを調べます。リクエスト時にだけタイムアウトする場合は、ノードアドレスの名前解決、リモートポートへの接続、ハンドシェイクのどこで失敗しているか確認してください。ノード一覧のテストと実際のアプリのリクエストでは経路が異なることがあるため、テストアイコンだけで判断しないようにしましょう。

特定のノードだけでハンドシェイクエラーが起きる場合は、元の設定に記載されたプロトコル、通信方式、セキュリティ設定、サーバー名を確認し、システム時刻が正確かも調べてください。ポートの変更や証明書エラーの無視だけでは原因を特定できず、問題をさらに見つけにくくすることがあります。同じサブスクリプションの別ノードが同じネットワークとモードで動作するなら、その状態を比較対象として残し、問題のノードだけを確認してください。クライアントを再インストールする必要はありません。

ブラウザーは使えるのに、ほかのアプリが使えないのはなぜ?

まず、接続できないアプリがシステムプロキシに従うか、独自のプロキシ設定を持っているか確認します。デスクトップアプリには独自のネットワーク設定がある場合があり、ターミナルには前のセッションで設定した環境変数が残っていることもあります。モバイルでは、アプリが通信取り込みの対象から除外されていないか確認してください。アプリを完全に終了してから新しいリクエストを送り、クライアントが該当リクエストを受け取ったか確認します。

ログにリクエストが記録されている場合は、適用されたルーティングと接続先の応答を調べます。記録がない場合は、ログレベルを確認してから通信取り込みの対象範囲を確認してください。アプリごとにプロキシを設定できる場合は、元に戻せる形でローカルアドレスを指定してテストします。必要な場合に限りTUNへ切り替え、いつでも戻せる設定を残してください。特定のアプリの失敗がシステムプロキシ設定の誤りとは限りません。正常なアプリまでまとめて別のモードに切り替える必要はありません。

アップデートや端末の買い替え後に、グループとルーティングを復元するには?

まずバックアップを開き、内容を3種類に分けます。サブスクリプションから再取得できるノード、個別に保存した手動リンク、端末固有のインバウンドやルーティング設定です。新しい端末では最小限の設定で接続を確認してから、段階的に移行します。サブスクリプショングループは元のURLから作り直し、手動ノードは1つずつインポートします。ローカルポート、仮想インターフェース、特定のコアに依存するルーティングは、新しい端末に合わせて設定し直してください。

古い設定全体を別のクライアントにそのまま上書きしないでください。両方のクライアントで一部のノードを読み込めても、デフォルトの出口、アプリの対象リスト、データファイルのパスに対する仕様が異なる場合があります。複数のサブスクリプションを使っている場合は、配布元ごとに整理し、サブスクリプショングループとノードフィルタリングのガイドを参考に重複を整理してください。接続確認が完了したら、正常に起動できるバックアップを1つ残し、古い設定を削除します。

終了後にネットワークへ接続できない場合はローカル設定を復元する

クライアントを終了してもブラウザーがすべて使えない場合は、プロキシがまだローカルポートを指していないか確認します。今回変更したプロキシ設定だけを元に戻し、以前の手動プロキシ、自動設定スクリプト、直接接続の状態を復元してください。TUNを使った端末では、仮想インターフェースを旧プロセスが使用中かどうかも確認します。スマートフォンでは、システムVPNが接続中と表示されていないか、VPN以外の接続を禁止する設定が有効か、端末管理者がこれらを管理しているかを確認してください。

復旧後は、平常時に使えるローカルサービスと、安定したインターネット接続先の2つを個別にテストします。まずネットワーク層が復旧したことを確認してから、クライアントを再起動してください。複数の端末が同じネットワークで失敗し、別の正常なネットワークに切り替えると使える場合は、切り替え前後の結果を記録します。各端末のインストーラーを疑うのはその後です。サポートを求める際は、OSとアーキテクチャ、クライアントとUIの種類、通信取り込み方式、エラーの種類、試した比較条件を伝え、ログ全体を公開しないでください。

クライアントをダウンロード