共通の準備
OS・アーキテクチャ・パッケージを確認する
デスクトップではv2rayN、AndroidではXrayコアを使うv2rayNGが第一候補です。v2flyコアが必要な場合に限り、v2flyNGを選びます。まず端末で稼働中のOSを確認し、次にアーキテクチャを確認してください。製品名、購入年、プロセッサのメーカー、システムアーキテクチャはそれぞれ別の情報です。同じメーカーの製品でもアーキテクチャが異なることがあり、同じ端末上の仮想マシンでもOSが異なる場合があります。仮想マシンにインストールするときは、ホストマシンではなく仮想マシン内のシステム情報を確認してください。
インストールパッケージページから対象プラットフォームを選び、カードに記載されたパッケージ形式を確認します。動作条件はページの記載を優先してください。アーキテクチャが一致していても、OSやランタイム、デスクトップ環境の要件を満たすとは限りません。初回インストールでは、ローカルリスニングの初期設定を維持し、LANアクセスや起動時の通信取り込みは有効にしないでください。初回の読み込みに失敗しても、クライアントの起動不具合とネットワーク取り込みの問題を切り分けやすくなります。
| プラットフォーム | クライアント | パッケージの選び方 | 通信の取り込み方法 |
|---|---|---|---|
| Windows | v2rayN | x64デスクトップ版またはWPF版 | システムプロキシ。必要に応じてTUNを有効化 |
| macOS | v2rayN | Apple SiliconまたはIntel | ネットワークサービスのプロキシ設定。必要に応じてTUNを有効化 |
| Linux | v2rayN | ディストリビューションのパッケージ形式とプロセッサアーキテクチャ | デスクトップまたはアプリのプロキシ。必要に応じてTUNを有効化 |
| Android | v2rayNG、v2flyNG | arm64または汎用版 | クライアントがシステムのVPNインターフェース経由で通信を取り込む |
購読URL・ノード・ローカル設定を区別する
購読URLは複数のノードを取得するためのもので、購読管理の画面に入力します。単一の共有リンクやQRコードは1つのノードを表すため、クリップボードやQRコード読み取りなど、単一ノード用の読み込み機能を使います。入力先を取り違えると、購読の更新時に形式エラーが繰り返し表示されたり、URLを保存できたように見えても一覧に項目が追加されなかったりします。受け取った内容がどちらに当たるかを確認し、選択したクライアントが解析できる形式かどうかも確かめてください。他のソフト向けの完全な設定ファイルは、通常の購読として読み込めません。
購読URLにはアクセス認証情報が含まれる場合があるため、パスワードと同様に扱ってください。オンライン変換サイトや公開スクリーンショット、掲示板への投稿は避けましょう。購読変換とは、ノード情報を別の形式に変換することです。変換しても、移行先のコアが未対応のプロトコルや通信パラメータを使えるようにはなりません。形式が合わない場合は、まず設定の提供元にクライアント対応の購読を依頼し、必要に応じて移行を検討してください。バックアップをエクスポートする際も、購読URL、ローカルノード、アクセス認証情報が含まれていないか確認し、公開共有せず保護されたローカルストレージを利用してください。
接続前後の状態を記録する
接続前に、端末が通常どおりインターネットに接続できることと、日付・時刻・タイムゾーンが正しいことを確認します。ネットワークへの接続にWebログインが必要な場合は、先に認証を済ませてください。続いて、既存のシステムプロキシ、自動プロキシ設定スクリプト、業務用VPN、アプリごとのプロキシ設定を記録します。設定をすべて消すためではなく、テスト後に元の状態へ戻すための記録です。管理対象端末では管理ポリシーを維持してください。設定の管理者が分からない場合は、上書きしないでください。
許可されたアクセス先のうち、繰り返し開けるHTTPSアドレスをテスト対象に選び、通常は直接接続するLAN上のサービスも比較用に選びます。初回接続では、ノード1つ、アプリ1つ、通信の取り込み方法1つに絞ってください。クライアントのログでローカルの受信と送信先を確認し、アプリの実際の応答でサービスが利用できるかを確認します。ノードが一覧にあること、コアが起動したこと、接続先から応答があったことは、それぞれ別の結果です。問題が起きた段階を記録し、「プロキシが使えない」とだけ記載しないでください。
接続できている端末は比較用に残しておくと便利です。新しい端末に同じ購読を読み込んだら、ノードグループとテスト対象が同じであることを確認してから、通信の取り込み方法を比較してください。両方の端末で購読を更新できない場合は、購読サービスにアクセスできるか確認します。新しい端末だけ失敗する場合は、システム権限、アプリ設定、ローカルネットワークを優先して調べてください。正常に使えている端末を先に上書きすると、問題が起きた箇所を特定しにくくなります。
Windows:v2rayNのインストールと通信の取り込み
デスクトップ版とWPF版を選ぶ
「設定 → システム → バージョン情報」でシステムの種類を確認し、x64ベースであることを確かめてから、Windows用インストールパッケージを開きます。デスクトップ版はクロスプラットフォームのUIを採用し、WPF版は従来型のWindows UIを採用しています。メニューの配置は異なる場合があります。他方の画面のスクリーンショットと同じボタンが見つからない場合は、購読管理、ノード選択、システムプロキシの各機能から入口を探してください。普段はクライアントを1つだけ起動します。複数のインスタンスを同時に動かすと、ローカルポートを奪い合ったり、プロキシ設定を書き換え合ったりすることがあります。
ダウンロードページに記載されたパッケージ形式に応じてインストーラーを起動するか、圧縮ファイルをすべて展開して、中のクライアントを実行します。メインプログラムだけを圧縮ファイルから取り出して実行しないでください。コアや関連リソースを参照できなくなります。初回は普段使っているアカウントで起動し、常に管理者として実行することを通常のインストール手順にしないでください。メイン画面が表示される前に終了する場合は、システムの通知とダウンロードページに記載されたランタイム要件を確認します。画面は表示されるもののコアの起動に失敗する場合は、リソース不足、アクセス拒否、ポート競合のどれに該当するかログを確認してください。
購読を更新してアプリ1つで接続を確認する
購読グループの管理画面を開き、識別しやすい名前を付けてグループを追加し、アドレス欄に購読URLを入力して保存します。追加したグループに切り替え、現在の購読を更新して、新しい項目がそのグループに追加されたことを確認してください。保存時にエラーが出なかったことは、ローカルへの書き込みが成功したことを示すだけです。更新が成功して初めて、クライアントが内容を取得して解析できたと分かります。ノードを1つ選んで現在の接続先に設定し、起動エラーがないかログを確認します。以前のグループの項目が残っていても、今回の更新結果と混同しないでください。
まずトレイメニューから「システムプロキシを設定」を選び、システムプロキシを参照する標準設定のブラウザーでテスト対象にアクセスします。Windowsの「ネットワークとインターネット → プロキシ」を開き、設定が実際に変わったかを確認して、クライアントに表示されたローカルプロキシのアドレスとポートを照合してください。システムプロキシを有効にしても、すべてのプログラムが同じ経路を使うとは限りません。ターミナル、サービス、一部のダウンロードツール、独自プロキシを設定したブラウザーは、それぞれの設定で接続する場合があります。ブラウザーは使えるのに別のアプリが失敗する場合は、ノードが使えないと判断する前に、そのアプリのプロキシ設定を確認してください。
TUNに切り替える前に、重複する接続経路を整理する
対象のプログラムがシステムプロキシに従わない場合や、仮想ネットワークインターフェースで通信を取り込む必要がある場合に限り、v2rayNのTUNモードを試してください。デフォルトルートを変更する他のプロキシツールを終了し、テスト前のシステムプロキシ設定に戻してから、新しいモードを1つだけ有効にします。仮想ネットワークインターフェースの有効化に必要な権限は、クライアントの案内に従って許可してください。確認時はログとアプリの結果を併せて見ます。有効ボタンがオンになっても、ルートが適用されたとは限りません。スリープからの復帰後、Wi-Fiと有線ネットワークの切り替え時、または他の仮想インターフェースが残っている場合は特に注意してください。
TUNを有効にした後、インターネットは使えてもプリンター、ファイル共有、イントラネットのサービスに接続できなくなった場合は、まずTUNを無効にし、すぐに復旧するか確認してください。復旧する場合は、LANのプレフィックス、ドメイン名、ルールの優先順位を調べます。すぐに通信の取り込み範囲を広げないでください。無効にしてもネットワークが正常に戻らない場合は、システムプロキシの画面にローカルポートやスクリプトが残っていないか確認します。手動で元に戻すときは、テスト前に記録した状態を基準にしてください。業務用プロキシを使っていた端末ですべての設定を一律にオフにしないでください。
リスニング状態からポート競合を特定する
ログにアドレスの使用中というエラーが出た場合は、PowerShellでローカルのリスニングソケットを確認できます。以下の例では、状態がリスニングの接続を一覧表示します。出力されたローカルポートを、v2rayNの設定画面に実際に表示されているポートと比較してください。デフォルトのポートを推測して判断しないでください。プロセスIDは使用中のプロセスを特定する手がかりですが、そのプロセスが異常とは限りません。同じプログラムが異なるアドレスで複数のポートをリスニングしている場合もあります。
Get-NetTCPConnection -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess |
Sort-Object LocalPort
ポートを使用しているのが動作中の古いインスタンスだと分かったら、そのインスタンスのトレイメニューから通常の方法で終了します。停止できないアプリがポートを使用している場合は、未使用のローカルポートに変更し、プロキシを手動設定したプログラムも更新してください。変更後に接続を再起動し、リスニング項目が表示されるか確認してから、アプリ1つで再テストします。リスニングが正常でもアクセスできない場合は、ポートを何度も変更せず、通信の取り込み方法と送信ログを確認してください。
macOS:v2rayNのインストールとネットワークサービス
チップに合ったディスクイメージを選ぶ
Appleメニューから「このMacについて」を開きます。Appleチップと表示される場合は、macOS用インストールパッケージのApple Silicon版を選択し、Intelプロセッサと表示される場合はIntel版を選択します。ターミナルの動作だけで端末全体のアーキテクチャを判断することはできません。ターミナルのプロセスが互換環境で実行されている場合があるためです。該当するディスクイメージを開き、ウインドウの案内に従ってクライアントをアプリケーションフォルダにコピーします。マウントしたイメージから実行し続けず、コピーしたアプリを起動してください。起動を確認してからイメージを取り出します。
システムが起動を阻止した場合は、表示された内容がセキュリティポリシー、OSのバージョン不一致、アプリの異常終了のどれに当たるか確認します。提供元が確認でき、端末の管理要件にも合うアプリに限り、システムの案内に従ってください。組織のポリシーで起動が許可されていない場合は管理者に相談し、システム全体の保護機能を無効にしないでください。アプリのウインドウが表示されてから、アプリのログを確認します。アプリの読み込み段階で起きる問題なら、購読、プロキシ、DNSを変更する必要はありません。設定を変えてもバイナリの互換性問題は解決しません。
現在のネットワークサービスでシステムプロキシを確認する
購読管理でグループを追加して更新し、ノードを1つ選びます。クライアントのシステムプロキシを有効にしてから、「システム設定 → ネットワーク」で現在接続しているサービスを開き、詳細情報からプロキシ設定を確認してください。Wi-Fiと有線LANは別々のネットワークサービスであり、以前の設定がそれぞれに残っていることがあります。外付けネットワークアダプターを使う場合、ドッキングステーションを外した場合、会社から自宅へ移動した場合は、以前のサービスのプロキシ状態から現在の経路を判断できません。現在のサービスとその時点のログを照らし合わせてください。
ターミナルで以下の読み取り専用コマンドを実行し、システムが認識している現在のプロキシ設定とネットワークサービスの順序を確認する方法もあります。出力から、プロキシが有効か、ポートがローカルを指しているかを特定でき、自動設定に関する項目が表示される場合もあります。ただし、すべてのアプリがその設定を使うとは限りません。ブラウザーのプロファイルに独自のプロキシが設定されている場合や、ターミナルが環境変数だけを参照する場合は、それぞれの実際の通信経路を確認してください。
scutil --proxy
networksetup -listnetworkserviceorder
クライアントのログに対象アプリからの受信リクエストが記録されない場合は、そのアプリを完全に終了してから再起動してください。起動時にプロキシ設定を読み込むプログラムでは、起動したままのプロセスが古い設定を使い続けることがあります。プロキシを停止するときも、ウインドウを切り替えるだけでは確認になりません。クライアントのシステムプロキシを無効にし、必要に応じてプロセスを終了してから、現在のネットワークサービスが元の状態に戻ったか確認します。組織が設定した自動プロキシのアドレスが表示された場合は、比較のために削除せず、そのまま維持してください。
TUNの起動とスリープ復帰を確認する
システムプロキシで対象アプリを利用できるなら、画面の表示を揃えるためだけにTUNを有効にする必要はありません。プロキシ設定を読み込まないアプリの通信を取り込む必要がある場合は、システムプロキシを無効にしてから、v2rayNの案内に従って仮想ネットワークインターフェースを有効にします。まずドメイン名でのアクセスを確認し、次にLAN上のサービスを確認して、最後にクライアントを通常の方法で終了した後、両方をもう一度テストしてください。外部サイトを開けるかだけを調べると、仮想インターフェースによるデフォルトルートの変更で起きるLANの問題を見落としがちです。
スリープ前は正常で復帰後に失敗する場合は、まずWi-Fiが再接続されたか、クライアントのログにリクエストが届いているか確認します。Wi-Fiが復旧していない場合は、ネットワークへの接続とアドレスの割り当てを先に調べます。Wi-Fiは復旧しているのにアプリからの受信がない場合は、システムプロキシや仮想ルートが有効なままか確認してください。以前のセッションが無効だと確認できた場合に限り、該当モードをいったん無効にして再度有効にし、安定して再現するかを確認します。これにより、スリープ復帰の問題と購読内のノード切り替えを切り分けられます。
名前解決・DNS・サービス接続を切り分ける
LANに接続できない場合も、段階を分けて確認してください。まずアクセスできることが分かっている端末のアドレスでサービスを試し、次に端末名でアクセスできるかを確認します。アドレスでは接続できて名前ではできない場合は、名前解決やローカルサービスの検出を調べます。すぐにリモート側のノードを変更しないでください。既知の端末のアドレスにも接続できない場合は、通信の取り込み前後でネットワークインターフェースとルールを比較します。リモートのDNSサーバーは通常、ローカルネットワーク内の端末名を解決できません。外部のHTTPS接続が正常でも、LAN内の名前解決が正常とは限りません。
特定のドッキングステーションやネットワークでだけ問題が起きる場合は、ネットワークサービス名、通信の取り込みモード、テスト対象の種類を記録します。今回変更した設定を無効にして確認済みの状態に戻し、順番に再テストしてください。ネットワークサービスとクライアント設定を一度にすべて削除しないでください。症状が解消しても、プロキシが復旧したのか、システムが利用可能な別のネットワークに切り替わったのか分からなくなります。
Linux:v2rayNのインストールとデスクトッププロキシ
ディストリビューションのパッケージ形式とアーキテクチャ
まずディストリビューションのパッケージ管理方式を確認し、次にマシンのアーキテクチャを確認します。Debian、Ubuntu、および同じパッケージ体系を使うデスクトップディストリビューションでは、通常debを選びます。Fedoraと同じ体系のディストリビューションではrpmを選びます。インストールツールが別形式のファイルを読み込めても、debとrpmを互換形式として扱わないでください。Linux用インストールパッケージの主な選択肢はx64で、arm64版もあります。ディストリビューションがページの対応範囲に含まれない場合、形式が同じというだけでインストールできるとは判断できません。
uname -m
cat /etc/os-release
uname -mがx86_64を返す場合は通常x64版、aarch64を返す場合はarm64版が対応します。コンテナや特殊な互換環境では、カーネルが示すアーキテクチャとユーザー空間のパッケージアーキテクチャが異なることがあります。対象システムのパッケージマネージャーの情報でも確認してください。ディストリビューション情報を確認するのは、対象端末のパッケージ形式を選ぶためです。項目を書き換えたり、インストールのためだけにソフトウェアリポジトリを変更したりする必要はありません。
デスクトップに付属するパッケージインストーラーを使う方法があります。コマンドラインを使う場合は、実際のファイルがあるディレクトリで、ディストリビューションに適したインストールコマンドを実行してください。以下の例では、選んだパッケージのファイル名をローカルでv2rayn.debまたはv2rayn.rpmに変更したものとします。実行するコマンドはどちらか一方だけです。パッケージマネージャーは依存関係を処理しようとします。依存関係を解決できないというエラーが出たら、システムのバージョンと既存のソフトウェアリポジトリを確認し、依存関係を無視する強制インストールは避けてください。
# Debian / Ubuntu
sudo apt install ./v2rayn.deb
# Fedora
sudo dnf install ./v2rayn.rpm
現在のデスクトップユーザーで購読を読み込む
インストール時に昇格した権限が必要でも、クライアントを普段から昇格した権限で実行する必要はありません。現在のユーザーのデスクトップセッションから初回起動し、購読グループを追加して更新した後、ノードを選択してください。以前に昇格した権限で起動した場合、別の設定を読み書きしている可能性があり、通常のユーザーでは異なる一覧が表示されることがあります。設定ディレクトリの権限エラーが出たら、ディレクトリの場所と所有者を確認し、ホームディレクトリ全体の権限を再帰的に緩めないでください。コアの読み込みに失敗した場合は、最初のエラーを残し、その後に繰り返される再試行メッセージだけを切り取らないでください。
デスクトッププロキシが使えるかどうかは、現在のセッションにも左右されます。クライアントがデスクトップ設定を書き込んでも、その設定を読み取るアプリだけがプロキシを使用します。別のデスクトップ環境、独立したサンドボックスで動くアプリ、別ユーザーで起動したプログラム、すでに開いているターミナルには、同じプロキシ設定が適用されない場合があります。まず一般的なデスクトップブラウザーで確認し、次に対象プログラムを個別にテストしてください。後者だけ失敗する場合は、デスクトップ全体のプロキシ設定が無効だと判断せず、対象プログラム独自のプロキシ設定を検討します。
ローカルプロキシを明示してテストする
デスクトップアプリとターミナルで動作が異なる場合は、ターミナルからクライアントのHTTPまたは混合プロキシポートを明示的に指定して接続できます。以下のコマンドは入力を読み取るだけで、システムやシェルの永続設定は変更しません。入力するのはクライアントに実際に表示されているローカルポートであり、ノードのリモートポートではありません。テスト対象には、アクセスできることを確認済みのアドレスを指定してください。SOCKSの受信だけを有効にしている場合、このHTTPのテストは使えません。テスト先がHEADリクエストに応答しない場合は、通常のGETに切り替えてください。
printf 'ローカルHTTPまたは混合プロキシのポート:'
IFS= read -r proxy_port
printf 'HTTPSテスト用URL:'
IFS= read -r test_url
curl --noproxy '' --proxy "http://127.0.0.1:$proxy_port" \
--head --max-time 15 -- "$test_url"
ローカル端末への接続が拒否された場合は、ポートがリスニング状態か、ポートの種類が合っているかを確認します。HTTP応答を受け取った後、クライアントのログと照合し、リクエストがプロキシ経由、直接接続、拒否のどれになったかを確認してください。ステータスコードだけでは、どの送信先経由で接続したかは分かりません。テストに成功してもターミナルの通常のツールが動かない場合は、ツール独自のネットワーク設定を確認します。今回のように明示したパラメータが、すべてのコマンドで使われると考えないでください。
仮想インターフェース、デフォルトルート、設定の取り消し
TUNを試す前に、カーネルが仮想ネットワークインターフェースを提供していること、デスクトップセッションにクライアントが必要とする権限があることを確認し、通常時のデフォルトルートとLANへの到達性を記録します。コンテナ、リモートデスクトップ、管理対象システムでは、必要なインターフェースを作成できない場合があります。インターフェースを作成するために、GUIセッション全体を特権ユーザーで起動しないでください。有効にした後、別の業務用ネットワークに接続できなくなった場合は、今回追加した通信の取り込みモードを停止してからルートを比較します。リモートセッションでルートテーブルを直接消去しないでください。
ネットワークマネージャーは再接続時にデバイス設定を再適用することがあります。初回の有効化と通常の再接続を分けてテストしてください。再接続後だけ失敗する場合は、インターフェース、ネットワーク環境、エラー発生時刻を記録します。まずデフォルトルートが失われていないか確認し、その後でクライアントの状態を調べてください。通常の方法で終了した後は、デスクトッププロキシ、アプリごとのプロキシ、仮想インターフェースをそれぞれ確認します。1か所を元に戻しても、他の設定は自動的に元に戻りません。
Android:v2rayNGとv2flyNG
クライアントとパッケージのアーキテクチャ
Android用インストールパッケージには、最初にv2rayNG、続いてv2flyNGが掲載されています。v2rayNGはXrayコアを使用するため、まずはこちらを選びます。購読がv2flyコアを明確に必要とする場合に限り、v2flyNGを選んでください。両者の画面操作は似ていますが、対応プロトコル、通信方式の組み合わせ、読み込み手順が同じとは限りません。端末のOSがarm64アプリに対応していると確認できた場合はarm64を選びます。不明な場合は端末の仕様を確認してから汎用版を選んでください。64ビットプロセッサを搭載していても、同じアプリのアーキテクチャに対応するOSがメーカーによってインストールされているとは限りません。
ファイルマネージャーからインストールパッケージを開きます。現在の提供元からのアプリのインストールを許可するよう求められたら、実際にファイルを開いたアプリに必要な権限だけを許可し、完了後はシステム設定から取り消せます。上書きインストールできない場合は、アーキテクチャの不一致、OSバージョンの要件、端末管理の制限、既存アプリと新しいパッケージの互換性を切り分けてください。使用中のアプリをすぐにアンインストールしないでください。ローカルノード、アプリごとの一覧、設定が引き継がれない場合があります。移行が必要だと確認してから、バックアップを作成してください。
購読の更新と初回VPN許可
購読グループの設定を開き、購読URLと識別しやすい名前を追加します。ノード画面に戻って購読を更新し、今回取得したノードを1つ選んで接続を開始してください。クリップボードからの読み込みは単一の共有リンクに使います。購読の更新に失敗したからといって、同じURLをクリップボードから読み込む必要はありません。取得段階でログに失敗が記録された場合は、現在のネットワークから購読サービスにアクセスできるか確認します。内容を取得できているのに利用可能な項目がない場合は、購読形式とコアの対応状況を確認してください。
通常、初回起動時にシステムのVPN許可画面が表示されます。接続を作成しようとしているアプリが、選択したクライアントであることを確認してから許可してください。ここではシステム提供の仮想ネットワークインターフェースを使用します。同じユーザー環境でこのインターフェースを使う別の業務用VPN、ローカルファイアウォール、フィルターと競合することがあります。常時接続VPNを以前に設定していた場合は、どのアプリに対する設定か確認してください。デスクトップの「システムプロキシを設定」をスマートフォンの手順として使わず、複数のクライアントを同時に起動してノードを比較しないでください。
アプリごとの通信取り込みとネットワーク切り替え
初回確認では、通常の通信取り込み範囲でブラウザーをテストし、すぐにアプリごとの条件を追加しないでください。動作を確認できてから、アプリごとのプロキシ設定を開き、「選択したアプリのみを取り込む」設定なのか、「選択したアプリを除外する」設定なのか確認します。取り込むアプリと取り込まないアプリを1つずつ選んで再テストしてください。ブラウザーは使えるのにアプリ内のページが失敗する場合は、ネットワークリクエストを開始したのがメインアプリ、システムコンポーネント、外部ブラウザーのどれかを確認します。アイコンだけで通信元を判断すると、アプリの一覧を誤って選ぶことがあります。
Wi-Fiでは正常でもモバイルデータ通信で失敗する場合は、まずクライアントを停止した状態で、切り替え後の通常のWebページにアクセスできるか確認します。その後、接続が再確立されたかを確認してください。モバイルデータの権限、データセーバーの設定、現在のネットワークの接続条件が結果に影響することがあります。システムのVPNアイコンだけで判断しないでください。インターフェースが残っていても、以前のリモート接続が新しいネットワークに引き継がれたとは限りません。再接続を何度も押すより、切り替え前後の最初のエラーを記録するほうが原因を特定しやすくなります。
バックグラウンド制限と常時接続の設定
画面ロック後に停止し、画面を点灯すると復帰する場合は、まずシステムのバッテリー設定とバックグラウンド実行の設定を確認します。再現性がある場合は、対象クライアントだけのバッテリー制限を調整し、同じネットワークとロック時間で再テストしてください。すべてのアプリの制限を解除する必要はありません。VPNの常時接続は接続方式の設定であり、VPNを経由しない通信を制限する設定とは別のものです。後者を有効にすると、クライアント停止中の通常の通信も遮断され、直接接続が必要なアプリに影響することがあります。有効にする前に端末のポリシーと用途を確認し、バックグラウンドで終了する原因を隠すために使わないでください。
電池の消費を調べる際は、クライアントによる継続的な転送、アプリからの頻繁なリクエスト、不安定なネットワークによる再接続の繰り返しを区別してください。バッテリー使用量の画面で、同じ使用時間を比較します。テスト中はネットワークとアプリの範囲を固定してください。バッテリー最適化、メーカー独自のバックグラウンド管理、アプリごとの設定を詳しく確認する場合は、v2rayNGの電池消費とバックグラウンド動作のトラブル対処を参照してください。
端末変更後にシステム側の設定をやり直す
購読を再読み込みすると、主にノード一覧が復元されます。新しい端末のシステムVPN許可、データ使用権限、アプリごとの一覧は設定されません。機種変更後は、まず最小限の接続を確認し、その後でバックグラウンド実行や常時接続の条件を追加します。最後に2台の端末でアプリへのアクセス結果を比較してください。自分で設定した少数のノードだけを移行する場合は、必要に応じて単一リンクを共有できます。ルーティングや設定も引き継ぐ場合は、バックアップから復元できる項目を確認してから、複数端末間の設定同期を参照してください。
ルーティングとDNS
通信の取り込み、ルールの照合、送信先
まず、「アプリのリクエストがクライアントに渡っているか」と「クライアントが受け取った後、どこへ送るか」を区別します。システムプロキシやTUNは前者、ルーティングルールは後者を制御します。アプリのリクエストがクライアントに届いていない場合、ルールを変更しても影響しません。反対に、リクエストが受信されているのに誤った送信先へ向かう場合は、別の通信取り込みモードを有効にせず、ルールの順序、条件、デフォルトの動作を確認してください。
通常のルーティングルールは順番に評価され、一般に最初に一致したルールで送信先が決まります。特定ドメイン向けのルールは、先に一致する可能性のある広範なルールより前に配置してください。ルール内のoutboundTagは設定に存在する送信先タグを参照します。任意の名前を指定できるわけではありません。direct、proxy、blockは一般的な例示名であり、すべての設定で同じタグが使われるとは限りません。一致するルールがない場合、通常はコアが最初の送信先を使いますが、GUIクライアントがフォールバックルールを追加することもあります。画面上のモード名から推測せず、実際の設定とログを確認してください。
具体的なルールを確認してからデフォルト経路を変更する
以下はXrayで使えるドメインルールの一部です。完全一致するドメインexample.orgを、既存のdirect送信先に割り当てます。これはrouting.rules配列に含める単一のオブジェクトであり、完全な設定ではありません。ルールの順序を確認するには、対応する送信先が存在することを確かめたうえで、テスト用設定の広範なルールより前に配置し、このドメインと別のテスト対象の送信ログを比較します。GUIクライアントにルーティング編集画面がある場合は、該当する項目に入力してください。ドメインだけを受け付ける入力欄にオブジェクト全体を貼り付けないでください。
{
"type": "field",
"domain": ["full:example.org"],
"outboundTag": "direct"
}
ドメインルールで照合できるのは、コアが取得したドメイン名だけです。IPアドレスを直接指定してアクセスする場合、アプリが独自に名前解決してから接続する場合、仮想インターフェースから宛先IPしか見えない場合は、ドメインルールが適用されないことがあります。一部の設定ではトラフィックのスニッフィングでドメイン情報を補えますが、認識できるかどうかは通信内容と設定によります。LAN上の端末に直接接続する必要がある場合は、アプリがローカル名と具体的なアドレスのどちらを使っているかを確認してから、ドメイン条件か範囲を適切に絞ったIP条件を選んでください。無関係なアドレス範囲までまとめて除外しないようにします。
どこでドメイン名を解決しているか
V2RayのDNS設定には複数の要素があります。OSが先に名前解決する場合、ブラウザーが独自のセキュアDNSを使う場合、コアがルーティング判断や送信接続のために名前解決する場合があります。リモートDNSを有効にしても、すべての問い合わせがそこに送られるわけではありません。TUNも、各アプリ内蔵のリゾルバーを自動的に制御するものではありません。トラブル対処では、まず確認したい問い合わせの種類を明確にし、ログ、アプリの設定、システムの名前解決結果を照合してください。外部ドメインとLAN内だけで使う名前では、通常必要な名前解決経路が異なります。同じDNSサーバーを使うと、問題の原因が分かりにくくなることがあります。
ドメイン名でしかアクセスできないサイトでは、IPアドレスへの直接アクセスをHTTPS接続の成功基準にしないでください。証明書、仮想ホスト、TLSハンドシェイクで使われるサーバー名がドメイン名に依存することがあります。ドメインの名前解決に成功したか、アプリが接続できたか、コアが最終的にどの送信先を選んだかを分けて記録するほうが確実です。アプリのキャッシュが影響する場合は、対象アプリを終了して再起動します。設定を切り替えた直後に表示された古いキャッシュを、新しい設定が有効になった証拠と見なさないでください。問い合わせ経路を体系的に確認するには、DNSリークの検査と設定を参照してください。
ドメインルーティングとFakeDNSの適用範囲
コアのルーティング用ドメイン戦略は、IPルールの評価時に名前解決を行うかどうかに影響します。Xrayの場合、AsIsはルーティング照合のためにドメイン名をIPアドレスへ積極的に変換しません。IPIfNonMatchはドメイン名で一致しなかった場合に、IPルールの照合を試みるために名前解決します。ルーティング照合用の名前解決と、最終的な接続先アドレスの選択は別の設定です。戦略を切り替えると、名前解決のタイミングとルールの適用結果が変わることがあります。変更後は、直接接続するはずの対象とプロキシ経由にするはずの対象の両方を確認してください。
FakeDNSは合成アドレスを使って名前との対応関係を作り、通信を取り込むコアがそのアドレスを元のドメイン名に戻します。名前解決の結果と、その後の接続が連携した経路を通る必要があります。端末が合成アドレスを取得しても、通信を取り込んでいない経路からアクセスすると、名前解決には成功するのに接続できないことがあります。初回設定では通常の名前解決とルーティングを先に安定させてください。ドメインのマッピングが必要だと明確な場合に限り、FakeDNSの仕組みと利用シーンを読み、個別に検証します。設定を戻す際はマッピング関連の項目も元に戻し、テスト対象アプリの接続を再確立してください。
設定に関するよくある質問
購読を保存したのにノード一覧が空なのはなぜですか?
取得段階と解析段階を切り分ける
現在選択中のグループと更新対象が一致しているか確認します。更新ログにドメインを解決できない、接続がタイムアウトする、サービスから異常な応答が返るといったエラーがある場合は、取得段階で問題が起きています。端末で利用している、許可済みのネットワークから購読サービスにアクセスできることを確認して、もう一度試してください。購読は、まだ読み込まれていないノードへの接続を提供できません。取得に成功して形式が未対応と表示される場合は、クライアントが解析できる購読が返されているか、ログイン画面やエラーメッセージ、他のソフト向けの完全な設定ファイルではないかを提供元に確認してください。応答内容や元のURLを公開せず、エラーの種類と発生時刻だけを記録します。
以前は正常だった一覧から一部の項目が消えた場合は、まず選択中のグループが切り替わっていないか確認し、次にサーバー側でノードが置き換えられた、または一部の項目が削除されたかを確認します。購読の更新によって、グループ内の既存ノードが置き換えられる場合があります。個別に管理する手動設定は別のグループに保存し、購読の変更とローカルの変更を分けて確認できるようにしてください。
ノードのテストは成功するのにアプリが接続できないのはなぜですか?
テストの種類に応じて結果を判断する
V2Rayのノードテストでは、サーバーまでの通信接続だけを確認する場合も、ノード経由でクライアントに設定されたテスト先へ接続する場合もあります。テストに成功しても、別のドメイン、別のアプリ、別のDNS設定が使えるとは限りません。まず、テストしたノードが現在選択されているか確認します。続いて対象アプリから新しいリクエストを発行し、時刻を記録してコアのログを確認してください。受信ログがない場合は、システムプロキシ、仮想インターフェース、対象アプリの範囲を調べます。受信があり、送信先も想定どおりなら、リモート接続と接続先サービスの応答を確認してください。
テスト先、ネットワーク、テスト方式が異なる結果を直接比較することはできません。1回のタイムアウトだけで購読全体が使えないとは判断できません。同じネットワークで同じテスト先を選んで繰り返し確認し、どの段階で毎回失敗するかを記録してから、既知の正常なノードと比較してください。
TUNを有効にしたら、すべてのサイトにアクセスできなくなった場合は?
利用できる状態に戻してから、通信の取り込みだけを再テストする
まず今回有効にしたTUNを停止し、以前の直接接続またはシステムプロキシ設定に戻して、基本のネットワーク接続が使えることを確認します。復旧しない場合は、現在のネットワークでログインが完了しているか、クライアント終了後にローカルプロキシのポートが残っていないか、常時接続VPNのポリシーがまだ適用されていないか確認してください。復旧時にも既存の業務用ネットワーク設定は維持します。TUNを無効にした直後に復旧する場合は、仮想インターフェースの権限、他のネットワークツールとのルーティング競合、名前解決に使うアドレスへの到達性を確認してください。
再テストではTUNだけを有効にし、ノードとテスト先は変えずに、ドメイン名でのアクセスと、通常は直接接続するローカルアドレスへのアクセスを確認してからログを調べます。「有効」と表示されても、クライアントが操作を受け付けたことを示すだけです。ルート、インターフェース、名前解決、送信先をそれぞれ確認してください。
同じ購読を2台で使っても動作が異なる場合、まず何を比較しますか?
クライアント、コア、検証条件を揃える
まず、実際に選択したノード、コアの種類、ネットワーク、接続先アドレス、テスト時刻を比較します。スマートフォンはシステムVPNインターフェースを使い、デスクトップはシステムプロキシだけを設定している場合があります。同じノードが使えても、アプリの通信を取り込む範囲は異なります。読み込み後は項目が表示されるのに、接続時にパラメータエラーが出る場合は、現在のコアがプロトコルと通信設定に対応しているか確認してください。クライアントを変更する前に、クライアント比較で違いを確認し、まず1台で変更項目を1つずつ試します。
2つのアプリで接続できていてもルールを移行する場合は、システム関連の設定一式をそのままコピーしないでください。同じルーティングの目的をそれぞれの端末で実現できても、ローカルアドレス、プロキシポート、対象アプリの一覧、権限の対象は改めて確認する必要があります。設定項目を完全に一致させるより、直接接続と通信の取り込みが必要なサービスで期待どおりに動作するかを検証してください。
証明書やハンドシェイクのエラーが出る場合、どの設定を確認しますか?
証明書の検証は維持し、エラーの発生箇所を特定する
システムの日付と時刻が正しいことを確認し、エラーがブラウザーで開いた接続先から出ているのか、クライアントとノード間のハンドシェイクで発生しているのかを切り分けます。クライアントのログにエラーがある場合は、読み込んだノードのアドレス、通信パラメータ、サーバー名が提供元の説明と一致しているか確認してください。ブラウザーに警告が表示される場合は、テスト用アドレスの入力ミス、ネットワークのWebログイン要求、システムに残ったプロキシ設定の誤用を確認します。証明書の検証を無効にして対処しないでください。接続先や設定情報の不一致が隠れてしまいます。
問い合わせの際は、OS、クライアント名、接続モード、再現手順、認証情報を伏せた最初のエラーだけを共有してください。購読全体、ノードの共有リンク、認証情報を含む設定のエクスポートは添付しないでください。どの段階から失敗したか判断できない場合は、クイックスタートガイドに戻って最小限の手順をやり直し、その後、このガイドの該当章を参照して設定を追加してください。