使い方ガイド · インストールからトラブル対処まで

V2Rayの使い方ガイド

まず接続を試したい場合は、クイックスタートガイドの手順に沿って進めてください。設定の仕組みを理解したい場合や、通信の対象範囲を調整したい場合、トラブルの原因を調べたい場合は、このガイドの該当章をご覧ください。初めて設定する場合は順番に読み進め、設定済みの場合は確認したい項目から参照できます。

基本概念:アプリ・クライアント・コア

リクエストの経路から設定を理解する

画面上の設定項目を覚える前に、リクエストの経路を整理しましょう。アプリがリクエストを発行すると、直接ネットワークに接続する場合と、端末上のプロキシに渡す場合があります。デスクトップでは通常、コアがループバックアドレスで待ち受けます。Androidでは、クライアントがシステムのVPNインターフェースを通じて通信を受け取ることもできます。リクエストがコアに届くと、ルーティング設定に従って接続先が選ばれ、宛先へ直接接続するか、選択したプロキシサーバーに接続します。アプリから見えるのは最終結果だけです。タイムアウトの表示だけでは、途中のどの段階で失敗したのか判断できません。

GUIクライアントはノードの管理、サブスクリプションの取得、設定の生成や読み込み、コアの起動・停止を担います。コアは待ち受け、ルーティング、転送を担当します。ウィンドウやタスクトレイが表示されていても、コアが動作中とは限りません。ノードを選択しても、ブラウザーの通信がコアに送られているとは限りません。トラブル対処では、コアが正常に起動したか、アプリが想定した入口を使っているか、リクエストがコアに届いた後に想定した出口へ進んだか、という3点に分けて確認します。それぞれ独立した証拠で判断し、同じ接続テストの結果だけで済ませないようにしましょう。

プロトコル・トランスポート・セキュリティ層を区別する

ノード設定のプロトコルは、クライアントとサーバーがプロキシリクエストをどのようにやり取りするかを定めます。トランスポートはデータを運ぶ接続方式、セキュリティ層は双方の設定に従って接続の保護や認証を行う仕組みです。これらは同じ項目の別名ではありません。たとえば、どちらもVLESSのノードでも、トランスポートやセキュリティの設定が異なることがあります。プロトコル名だけを見て設定を置き換えられると判断しないでください。クライアントを変えてノードが表示されても、そのクライアントのコアがすべての設定項目に対応しているとは限りません。

ノードを比較するときは、まずサーバーアドレス、ポート、プロトコルを確認し、次にトランスポート、セキュリティ層と関連項目を確認します。接続後のネゴシエーション失敗と、ドメイン名を解決できない状態や接続自体が確立していない状態は、発生段階が異なる問題です。エラーを消すためにセキュリティ検証を無効にしないでください。サーバー名、証明書、端末の時刻が一致しない場合は、該当する設定を修正します。見慣れない項目は用語早見表で確認したうえで、提供元の設定と照合してください。他のノードから設定値を寄せ集めないようにしましょう。

サブスクリプションの更新と接続を分けて考える

サブスクリプションは設定元からノード情報を取得する仕組みであり、プロキシプロトコルではありません。更新に成功したということは、クライアントが内容を取得して処理できたことを示しますが、含まれるすべてのノードに接続できるとは限りません。逆に、既存のノードを使えていても、サブスクリプションの配信元に一時的にアクセスできない場合があります。通常、更新先とノードの接続先は異なります。トラブル対処では、更新リクエストとアプリの通信リクエストのどちらが失敗したのかを先に確認し、タイムアウトが起きるたびにサブスクリプションを変更するのは避けてください。

ドメイン名の解決は一度だけとは限りません。プロキシサーバーに接続する前に、そのサーバーのドメイン名を解決する必要がある場合があります。アプリがアクセスするWebサイトのドメイン名は、アプリ、OS、コアのいずれかが処理することがあります。IPアドレスで接続できても、すべてのドメイン名が正常とは判断できません。Webサービスでは正しいホスト名も必要になることが多いためです。テスト時は、エラーの対象がサブスクリプションのドメイン名、プロキシサーバーのドメイン名、アクセス先のドメイン名のどれなのかを明確にしてください。確認すべきログが分かりやすくなります。

クライアント選び:OS・アーキテクチャ・コア

デスクトップでは v2rayN が第一候補

実際にクライアントを動かすOSとCPUアーキテクチャを確認し、クライアントのダウンロードページから適切なパッケージを選びます。仮想マシン上で動かす場合は、ホストではなくゲストOSが報告するOSとアーキテクチャを基準にしてください。業務用端末の場合は、クライアントのインストール、システムプロキシの変更、仮想ネットワークインターフェースの作成が許可されているかも先に確認します。ファイルをダウンロードできても、インストール権限があるとは限らず、TUNを有効にできるとも限りません。

プラットフォームクライアント選び方
Windowsv2rayNダウンロードページの要件で x64 と実行環境を確認し、デスクトップ版または WPF 版を選びます。
macOSv2rayNApple Silicon または Intel に合わせて、対応するディスクイメージを選びます。
Androidv2rayNG を第一候補、v2flyNG を代替候補にまず必要なコアに対応したアプリを選び、次にOSで利用できるアプリのアーキテクチャに合わせて arm64 またはユニバーサル版を選びます。
Linuxv2rayNディストリビューションのパッケージ形式とアーキテクチャを確認し、deb または rpm を選びます。

Windowsデスクトップ版はクロスプラットフォームのUIフレームワークを使用し、WPF版は従来のWindows向けUIフレームワークを使用します。初めてインストールする場合はデスクトップ版から試せます。既存のWPF環境を引き継ぐ場合は、これまでの操作方法、設定ファイルの保存先、実行環境の要件を優先して選びましょう。両者の違いだけで通信速度に差があるとは判断できません。比較する場合は、同じノード、ネットワーク、リクエスト方法を使い、2つのインスタンスが同じローカル入口を同時に使用していないことを確認します。画面、タスクトレイ、パッケージ名の違いはデスクトップ版とWPF版の選び方をご覧ください。

macOSでは、システムのデバイス情報でチップまたはプロセッサを確認します。「Appleチップ」と表示される場合は対応するネイティブ版、Intelプロセッサの場合はx64版を選びます。Linuxではパッケージ管理方式とハードウェアアーキテクチャをそれぞれ確認します。たとえば、Debian系やUbuntu系では通常deb、Fedora系では通常rpmを選びます。端末に表示される x86_64 と aarch64 は、ダウンロードページのx64とarm64にそれぞれ対応します。パッケージ形式が合っていても、依存関係が満たされるとは限りません。インストール前にディストリビューションの対応範囲を確認してください。

Androidではコアに合わせてアプリを選び、次にアーキテクチャを確認

Androidでは、まずXrayコアを使用するv2rayNGを試してください。設定元がV2Flyコアを明示的に要求する場合は、v2flyNGを検討します。提供されたものが通常のノード情報、サブスクリプション、特定のコアで読み込む完全な設定ファイルのどれなのかを確認してください。通常のノード情報は画面上でコア向けの設定に変換されますが、完全な設定ファイルには特定のコア専用の項目が含まれることがあります。名前が似ていることだけを互換性の根拠にせず、クライアントを変えても独自の設定項目をそのまま移行できると思い込まないでください。

Androidアプリのパッケージは、CPUの製品情報に64ビット対応と書かれているかだけでなく、OSがサポートするアプリのアーキテクチャに合わせて選びます。システムがarm64アプリに対応していると確認できたら、対応パッケージを選びます。分からない場合は先に端末の仕様を確認し、そのうえでダウンロードページにユニバーサル版があれば検討してください。ユニバーサル版にもシステム要件があり、すべての端末で使えるわけではありません。アプリに互換性がないと表示された場合は、同じファイルを何度もダウンロードするのではなく、OSのバージョンと対応アーキテクチャを確認します。

古い端末から移行する場合は、使用中のコア、サブスクリプショングループ、カスタムルーティングを記録し、アプリが対応する方法で設定をバックアップします。新しい端末では、まずグループを1つ復元し、ノードを1つずつ確認してから、ほかの設定を順に戻します。古い端末のローカルポート、起動パス、システムプロキシの状態は環境固有なので、そのまま一括コピーしないでください。同じ端末でビルドを切り替える場合は、先に古いインスタンスを終了し、復元できる設定を保管してから、新しいビルド単独で起動できるかを確認します。

インストールと初回起動:まずコアの動作を確認

デスクトップOSにインストールする

まずダウンロードページの説明とOSの案内に従ってインストールし、設定一式のインポートは後にします。Windowsでインストーラーを取得した場合は、インストーラーで指定先にインストールします。アーカイブを取得した場合は完全に展開してから起動し、圧縮ファイルのプレビュー画面から直接起動しないでください。必要なランタイムは、選択したビルドの要件と実際のエラーに基づいて判断します。デスクトップランタイムが見つからないという表示が出た場合は、デスクトップランタイムと通常のランタイムを区別し、アーキテクチャも確認してください。プログラムを何度起動しても依存関係は追加されません。

初回起動は通常のユーザー権限で行います。展開して使うビルドの場合は、現在のユーザーが管理でき、同期サービスに繰り返し書き換えられない場所を選びます。画面は表示されても設定を保存できない場合は、クライアント全体を常に管理者として実行するのではなく、設定ディレクトリへの書き込み権限を確認してください。アップデート後に起動直後に終了する場合は、エラーと旧設定を保管し、起動時のクラッシュのトラブル対処を参考に、ランタイム、ディレクトリ権限、設定の解析の問題を切り分けます。

macOSでは対応するディスクイメージを開き、イメージ内の案内に従ってアプリを配置したら、実際のインストール先から起動します。マウント中のイメージを常用の実行場所にしないでください。アーキテクチャの不一致、ファイルの破損、デバイスのポリシーによる制限が表示された場合は、まずメッセージ全体を記録し、原因に応じて対処します。業務用端末では承認済みの手順に従い、1つのアプリを起動するためにシステム全体の保護を無効にしないでください。アプリ終了後もプロキシの問題が残る場合は、アプリを何度もコピーするのではなく、システムのネットワーク設定を個別に確認します。

Linuxでは、ディストリビューションのパッケージ管理ツールを使い、適合するパッケージをインストールする方法がおすすめです。依存関係や競合はツールの報告を確認してください。インストール後はデスクトップのアプリ一覧から起動するか、現在のデスクトップセッションで起動エラーを調べます。コマンドラインプログラムが動いても、GUIウィンドウやタスクトレイが正常に表示されるとは限りません。同様に、タスクトレイにアイコンが見えないからといって、プロセスが動いていないとは断定できません。アプリを起動してもウィンドウが表示されない場合は、プロセス、アプリのログ、デスクトップセッションの状態を確認し、何度も起動して複数のインスタンスが残るのを避けます。

Androidではインストールとネットワークの権限設定を分けて行う

Androidではダウンロードページから対応するインストールパッケージを取得し、システムのインストーラーで開きます。ダウンロード元に対するインストール許可が必要な場合は、端末のルールに従い、実際に使う配布元だけに許可してください。アップデートに失敗したら、まずシステムの表示を確認します。OSのバージョンやアーキテクチャが要件を満たさない場合と、既存アプリへの上書きが許可されない場合では、対処方法が異なります。先に旧アプリをアンインストールする必要がある場合は、復元できるサブスクリプションと必要な設定をバックアップしてください。アンインストールすると、通常はアプリ内のデータが削除されます。

インストール後は、一覧が正常に開き、設定を保存できることを確認します。初回接続時にシステムのVPN許可ダイアログが表示されるのは、該当する通信をシステム経由でクライアントに渡すよう要求しているためです。サブスクリプションが更新済み、またはリモートサーバーに到達可能という意味ではありません。すでにVPN接続を使用中の場合は、切り替えによって業務上の接続に影響がないか確認してください。システム管理下の接続は、許可なく停止しないでください。接続を有効にしたら、実際のアプリで動作を確認し、テスト後に正常に切断できることも確認します。

初回起動の合格条件を決める

まず画面を操作できること、設定を保存できること、プロセスを正常に終了できることを確認します。デスクトップでは、対応する設定を1つインポートしてから、コアが起動し、想定したアドレスとポートで待ち受けることを確認します。ポートが使われていると分かった場合も、OSのプロセス情報でどのプロセスが所有しているかを確認してください。Androidではシステムの許可を確認し、接続状態とアプリの設定が一致していることを確かめます。これらを確認するまでは、グループをまとめてインポートしたり、スタートアップを有効にしたり、複数のネットワーク設定を変更したりしないでください。インストールだけの問題が、再現しにくい起動順序の問題に変わるおそれがあります。

サブスクリプションの追加:グループ・更新・確認

まず設定の種類を確認する

サブスクリプションURLは、ノードのグループを取得するための入口です。共有用の単一リンクは1つのノードを表し、完全な設定ファイルにはインバウンド、アウトバウンド、名前解決、ルーティングなどが含まれる場合があります。どれもテキストで提供されることがありますが、同じ入力欄に貼り付けられるとは限りません。設定元の形式と対応コアに関する説明を確認し、サブスクリプション管理、クリップボードからのノードインポート、アプリが対応する設定インポートのどれを使うか決めてください。ブラウザーでURLを開けても、それがサブスクリプションとは限りません。アカウントページの場合もあります。

サブスクリプションURLにはアクセス用の認証情報が含まれることが多いため、アカウント情報と同様に管理してください。実際のURLを公開掲示板、オンライン変換サイト、共有スクリーンショットに載せないでください。コピーする前に、余分な空白、改行、説明文が混ざっていないか確認します。特にクエリパラメーターをむやみに削除・変更しないでください。トラブルを記録するときはエラーの種類と発生時刻だけで十分です。URLの形式は https://example.com/sub?token=xxxx のような例で示せますが、これは構造を表すだけで、更新に使えるサブスクリプションではありません。

まず1つのグループを手動更新する

v2rayNでサブスクリプショングループの設定を開き、グループを追加します。用途を区別できる名前を付け、完全なサブスクリプションURLをアドレス欄に入力して保存し、そのグループを手動更新します。グループ名は画面上で識別するためのもので、接続先サーバーを決めるものではありません。更新後は該当グループに切り替え、取得した内容が妥当か確認して、対応するノードを1つ選んでテストします。別の配信元を追加する場合はグループを分け、利用できているURLを誤って別のサブスクリプションに書き換えないようにしてください。

v2rayNGまたはv2flyNGでサブスクリプショングループの管理画面を開き、名前とURLを追加して保存します。リストに戻って更新を実行してください。メニューの表記はビルドによって異なることがあります。重要なのは、配信元を保存してから内容を取得し、最後に使うノードを選択することです。サブスクリプション管理と接続の開始は別の操作です。ノードが一覧に表示されても、システムVPNが有効とは限りません。逆にVPNが接続済みでも、直前の更新内容が現在の選択に反映されたとは限りません。

初回の更新に成功してから自動更新を設定します。更新間隔は配信元の更新案内と端末の使い方に合わせて決め、短ければよいと考えないでください。トラブル対処中は、そのグループの自動更新を無効にするか、更新時間を避けてテストします。テスト中にノード情報が置き換わるのを防げます。クライアントによっては、新しいサブスクリプション内容に合わせてグループを再構築し、手動編集したノードが上書きされることがあります。長期間使うテスト用ノードは手動グループに分け、サブスクリプション由来のノードと区別して記録してください。

失敗した段階に応じて対処する

ログに名前解決または接続の失敗が記録されている場合は、まず現在のネットワークからサブスクリプションの接続先に到達できるか確認し、更新リクエストの経路を選ぶ機能がアプリにあるかを調べます。まだ検証していない出口に更新通信を固定しないでください。ノードが使えなくなったときに更新も失敗するおそれがあります。認証が必要、またはアクセス拒否の応答がある場合は、URLの有効期限とアカウントの利用権限を確認します。何度も更新を試しても解決しません。サーバーが応答しているのにクライアントがノードを1件もインポートしない場合は、応答形式、クライアントのプロトコル対応状況、返された内容がログイン画面ではないかを確認してください。

インポート後は、利用できると確認済みの宛先を1つテストし、ほかの条件は変えないでください。ノードのテスト結果が示すのは、テスト方法で確認できる範囲だけです。特定のアプリのリクエストを検証する代わりにはなりません。1つのノードだけ失敗する場合は、同じグループ内のほかのノードと比較します。グループ全体で失敗する場合は、コアが起動しているか、ローカルの入口が正しいか、ネットワークに変化がないかを確認してください。画面の操作手順を確認するには、クイックスタートのサブスクリプション追加手順に戻ります。グループを変えても接続できない場合は、接続トラブルの対処をご覧ください。

プロキシモード:ローカルポートとシステムプロキシ

まず最小限の範囲でローカルの入口を確認する

デスクトップで初めて動作を確認するときは、単一のアプリからローカルプロキシへ明示的に接続する方法が手軽です。設定を開き、実際の待ち受けアドレス、ポート、プロトコルを確認します。HTTPプロキシとSOCKSのポートは別々の場合も、混合待ち受けポートで共用する場合もあります。ポート番号だけで種類を判断しないでください。端末内だけで使う場合は、ループバックでの待ち受けを維持します。端末内の設定ミスを解決するために、LANからの接続を許可しないでください。ループバックアドレスで待ち受ける通信は、リモートノードを選択しただけで他の端末から利用できるようにはなりません。

以下は、これらのパラメーターに対応するcurlで使える例です。v2rayNのローカルHTTPまたは混合待ち受けが、実際に例のポートを使用していることを確認してください。異なる場合は設定画面に表示された値に置き換えます。WindowsのPowerShellでは curl.exe を明示して実行できます。この例は公開されたサンプルドメインに1回リクエストを送るだけで、システム設定は変更しません。そのドメインに現在のネットワークからアクセスできない場合は、アクセス可能と確認済みのテスト先に置き換えてください。

curl --noproxy "" --proxy http://127.0.0.1:10809 --max-time 15 -I https://example.com/

ここで指定したプロキシは、このコマンドの実行中だけ有効です。除外リストを空にすることで、既存のプロキシ除外設定によって宛先へ直接接続されるのを防ぎます。ローカルポートへの接続が拒否される場合は、待ち受けの有無とアドレスファミリーが一致しているか確認してください。たとえばIPv4のループバックだけで待ち受けているのに、別のアドレスへ接続している場合があります。ローカルプロキシからエラーが返された場合は、接続先またはリモート側のログを確認します。宛先から応答があれば、このリクエストが設定済みのローカル入口を経由したことは分かります。ただし、コアが最終的に直接接続したかプロキシを使ったかは、ルーティング結果を別途確認してください。

システムプロキシが適用される範囲を理解する

システムプロキシの設定は、その設定に従うアプリに指定した入口を使わせるものです。OSがすべてのパケットを代わりに処理するわけではありません。ブラウザーは通常システム設定を読み取りますが、設定ファイル、ブラウザー拡張機能、端末のポリシーによって実際の動作が変わることもあります。ターミナルのプログラムがシステム設定や環境変数を参照するかどうかは、それぞれの実装によります。2つのコマンドから同じWebサイトにアクセスできても、同じプロキシを使っているとは限りません。ブラウザーとコマンドラインで結果が異なる場合は、それぞれの有効な設定を確認してください。

システムやクライアントによっては、自動設定スクリプトを使い、アプリが対応していればリクエストごとにローカルプロキシへ送るか、アプリから直接接続するかを決められます。これはコアのルーティングとは別の判定です。アプリがリクエストをコアに渡していない場合、コアのルールでは振り分けられません。トラブル対処では、まず前述の明示的なプロキシ設定でローカルの入口を確認してから、通常のシステムプロキシの使い方に戻してください。明示的な接続は成功してシステムプロキシだけ失敗する場合は、ノードを変更する前にOSまたはアプリ側を調べます。

プロキシの解除とアプリの終了を別々に確認する

テスト後はクライアントの操作でシステムプロキシをクリアまたは復元してから、必要に応じて終了します。以前から業務用プロキシを使っていた場合は、すべてのプロキシを無効にするのではなく、元のアドレス、ポート、自動設定方式に戻してください。管理対象の端末では、システムポリシーを通じてのみ変更できる場合があります。解除後は、システムプロキシを使っていたアプリで再確認してください。必要に応じてアプリを再起動し、以前のリクエストセッションを再利用しないようにします。

Androidでは通常、システムVPNとアプリごとの対象範囲設定で通信を処理します。デスクトップのシステムプロキシの手順をそのまま適用しないでください。Androidアプリをテストするときは、対象範囲に含まれているか、クライアントにシステムの許可が付与されているかを確認します。デスクトップでターミナルのコマンドだけが失敗する場合は、ブラウザーとターミナルを分けて調べる方法をご覧ください。コアのログに待ち受けポートの競合が記録されている場合は、競合するプロセスを調べます。起動失敗を隠すために、アプリごとのプロキシプロトコルを変更しないでください。

ルーティング:条件・優先順・デフォルト出口

まず3つの実際の動作を決める

ルーティングで処理できるのは、すでにコアに届いたリクエストです。設定を始める前に、直接接続する宛先、選択中のプロキシを経由する宛先、ルールで遮断する宛先の3種類を決めてください。明示的なルールに一致しないリクエストのデフォルト出口も設定します。デフォルト出口は設定の一部であり、推測に頼るものではありません。画面に独立したフォールバック設定がない場合は、コアの動作を確認し、生成された設定内のアウトバウンドの順序とルールの参照先を調べてください。

プリセットのルーティングモードは出発点として使えますが、モード名だけでは実際のマッチ条件は分かりません。有効にした後、ルール一覧でドメイン名、宛先アドレス、分類データのどれに基づいて判定しているかを確認し、末尾でどのように処理されるかも記録します。地域やサイトの分類データは更新されることがあり、名前解決の結果によってテスト結果も変わります。動作する設定を基準として確保してからカスタムルールを追加してください。分類データ、名前解決の方針、デフォルトのアウトバウンドを一度に変えると、改善してもどの変更が有効だったのか分からなくなります。

ドメイン名ルールとアドレスルールの適用範囲

ドメイン名の条件は特定の名前を持つ宛先に、アドレス範囲の条件は明確なネットワーク範囲に適しています。ドメイン名ルールが一致するかどうかは、コアが判定する時点で宛先名を取得できているかによります。アプリが自ら名前解決し、IPアドレスだけを渡している場合、ドメイン名情報を利用できないことがあります。アドレス条件を使うルールで、コアがドメイン名しか把握していない場合は、ルーティング時の名前解決方針も確認が必要です。この2つの問題を、どちらも分類データの不具合と決めつけないでください。

Xrayのフィールドルールを例にすると、ルールは順番に評価され、最初に一致したルールのアウトバウンドが使われます。一般に、具体的な例外を広範囲なルールより前に置きます。1つのフィールドルールにドメイン名とアドレスの両条件を指定する場合は、コアにおける条件の組み合わせ方を確認してください。「ドメイン名またはアドレスのどちらかに一致したら直接接続」という意図なら、同じアウトバウンドを参照する2つのルールに分けると分かりやすくなります。以下はXrayの設定に使える routing オブジェクトの例で、完全な設定ファイルでもクライアント用のサブスクリプション情報でもありません。使用前に、direct が定義済みの直接接続用アウトバウンドタグであることを確認してください。

{
  "domainStrategy": "AsIs",
  "rules": [
    {
      "type": "field",
      "domain": ["full:example.com"],
      "outboundTag": "direct"
    },
    {
      "type": "field",
      "ip": ["192.168.50.0/24"],
      "outboundTag": "direct"
    }
  ]
}

1つ目のルールは完全一致の名前 example.com だけを対象とし、そのサブドメインは含みません。2つ目は例示用のネットワーク範囲に一致しますが、実際のLAN範囲を確認する代わりにはなりません。AsIs はこの段階のアドレスルールのためにドメイン名を積極的にアドレスへ解決しないため、ドメイン名で受け取ったリクエストが最終的にその範囲のIPアドレスになっただけで、2つ目のルールに一致するとは限りません。一致しないリクエストは、後続のルールまたはコアのデフォルトアウトバウンドで処理されます。通常はクライアントのルール編集画面で同等の条件を入力し、画面から再生成されるファイルを直接編集しないようにしましょう。

ルールに一致する場合と一致しない場合の両方を確認する

ルールを追加するたびに、少なくとも2種類の宛先をテストします。ルールに一致する正例と、似た条件でも後続ルールに進むべき反例です。完全一致のドメイン名を例外にする場合は、そのドメイン名とサブドメインをテストできます。アドレス範囲の場合は、範囲内のアドレスと隣接範囲を確認します。コマンドが成功しても、宛先に到達できたことしか分からず、想定した出口を通った証拠にはなりません。コアのルーティング記録やアウトバウンド記録と照合してください。詳細ログが必要な場合は、診断ログを短時間だけ有効にし、テスト後に元のレベルへ戻します。

Webページは、リソース用ドメイン、ログインサービス、APIの宛先に同時にリクエストすることがあります。ページ本体は表示されるのに一部のコンテンツだけ失敗する場合は、すべてのアウトバウンドを切り替えて隠すのではなく、失敗したリクエストの宛先を特定してからルールが必要か判断します。ルール追加後にLAN内のリソース、共有サービス、デバイス管理ページに問題が出た場合は、まず追加したルールを元に戻し、条件が広すぎないか、先行するルールに上書きされていないか確認してください。各ルールの用途と確認方法を記録しておけば、後で整理するときに不要な項目を判断できます。

TUNモード:対象範囲・権限・DNS

必要な場合にのみ有効にする

TUNは、システムプロキシを読み取らないアプリの通信も処理したい場合に使います。デスクトップクライアントで関連するコア機能を起動すると、仮想ネットワークインターフェースとルーティングを通じて、条件に合う通信が処理経路に送られます。対象範囲が広がっても、すべてのリクエストが同じプロキシアウトバウンドに送られるわけではありません。また、すべてのインターフェースや種類の通信が対象になるとも限りません。どの通信を取り込むかはシステムのルートとクライアント設定で決まり、取り込んだ通信をどう送るかは引き続きコアのルーティングで決まります。

有効にする前に、通常のローカルプロキシ入口とノードが正常に使えることを確認し、端末の元のシステムプロキシ、ネットワークインターフェースの状態、よく使うLAN内サービスを記録します。今回TUNに取り込むアプリを決め、そのアプリだけを使ったテストを用意してください。リモート接続や管理対象VPNに依存している端末では、元に戻す方法を確保せずに通信の取り込み方法を変更しないでください。ルートの変更によって、画面上に異常が表示されなくても接続維持中の通信に影響することがあります。

デスクトップでの有効化手順とよくある競合

v2rayNでTunを有効にする項目または関連設定を探し、使用中のビルドとコアが機能要件を満たしていることを確認してから、OSの案内に従って必要な権限を許可します。Windows、macOS、Linuxでは、権限の付与方法やインターフェースの作成方法が異なります。権限不足と表示された場合は、補助コンポーネントの起動失敗、仮想インターフェースの作成失敗、ルート変更の失敗のどれなのか確認してください。端末のルールで許可され、ビルドが実際に必要とする場合に限って権限を付与します。インターフェースの権限問題に対処するために、すべてのアプリを高い権限で起動しないでください。

初回のテストでは、説明しやすい経路を1つだけ残します。システムプロキシを設定済みの場合は、元の値を記録してから一時的に元へ戻し、対象アプリの通信がTUNに取り込まれるか確認できます。そうしないと、TUNが有効でなくてもアプリがローカルプロキシに直接接続して通信できる場合があります。まず仮想インターフェースとクライアントの状態を確認し、通常のドメイン名へのアクセス、対象アプリからのアクセス、利用を維持するローカルサービスをテストします。条件は一度に1種類だけ追加し、基本動作を確認してからLAN向けの例外などを調整してください。

有効にした直後にすべての通信がタイムアウトする場合は、まずTUNを無効にして元の状態に戻るか確認します。インターフェースが正しく作成されていない、システムルートが想定どおりに設定されていない、コアとプロキシサーバー間の接続が再び自分自身の取り込み経路に戻されている、といった原因が考えられます。ログで失敗した段階を確認し、クライアントに現在のネットワークに合ったインターフェースの自動選択やアウトバウンドの除外設定があるか調べてください。推測でシステムのデフォルトルートを手動削除しないでください。画面上の詳しい説明はv2rayNのTUNモード設定をご覧ください。

DNSの問題と宛先への接続障害を見分ける

IPアドレスには接続できるのに通常のドメイン名には広く接続できない場合は、名前解決の経路を優先的に調べます。ただし、IPアドレスでの直接アクセスに対応した宛先を比較に使ってください。WebサイトのURLをそのままIPアドレスに置き換えるのは、証明書やサイトの振り分けがドメイン名に依存するため、信頼できるテストではありません。コアがプロキシサーバーのドメイン名を解決できるか、通常のアプリの名前解決リクエストが想定した処理経路に入っているか、結果のアドレスがLAN内と外部の宛先に適しているかを確認します。

アプリによっては独自の暗号化DNSを使用するため、OSの名前解決結果とアプリが使う結果が異なることがあります。業務ネットワークの内部名は、指定されたDNSサーバーで解決する必要がある場合もあります。ドメイン名のタイムアウトが発生したからといって、ローカル、コア、アプリのDNS設定を一度に置き換えないでください。まず失敗している名前の種類を特定し、DNS問い合わせに応答があるか、返されたアドレスが想定範囲内か、その後アプリがどこに接続したかを確認します。変更前の設定を保存し、問題が起きた場合は変更と逆の順序で戻してください。

AndroidのVPN許可とデスクトップのTUNメニューは別の操作です。Androidでは、まずVPNが有効か確認し、アプリの対象範囲、システムの常時接続VPN設定、既存接続との競合を調べます。テスト後はクライアントの操作で通信の取り込みを停止し、対象アプリが元のネットワークで想定どおり動作することを確認してください。停止後も問題が残る場合は、スイッチを何度も切り替えるのではなく、システムのネットワーク設定とクライアントログで実際の状態を確認します。

日常のメンテナンス:更新・バックアップ・トラブル対処

3種類の更新を分けて考える

クライアントのアップデートは画面、設定の読み書き方法、パッケージ内容を変えることがあります。コアのアップデートはプロトコル、名前解決、ルーティングの動作を変え、サブスクリプションの更新はノード情報を変更します。1つのインストールパッケージでクライアントとコアの両方が更新される場合を除き、トラブル対処中に複数の層を同時に変更しないようにします。更新前に実行環境、使用するコア、現在有効な入口、テスト結果を記録してください。更新後はほかの設定を有効にする前に、同じ条件で再テストし、互換性の問題を見逃さないようにします。

バックアップでは、再インポートできる設定、ルーティングルール、必要な利用記録を優先して保存し、実行ディレクトリ全体を公開同期先にコピーするのは避けてください。バックアップにサブスクリプションの認証情報、サーバーアドレス、接続設定一式が含まれる場合があります。管理された場所に保存してください。復元方法と対応するクライアントを記録します。復元をまだ試していない場合でも、エクスポート内容を読み取れるか、必要な情報がそろっているかを確認し、日常の接続に影響しない範囲でグループを1つ復元してみてください。

クライアント間やプラットフォーム間で移行するときは、再利用できる設定と端末固有の状態を分けて考えます。ノードグループやルールの意図は対応形式で移行できることがありますが、作業ディレクトリ、待ち受けアドレス、システムプロキシの状態、仮想インターフェースの選択は新しい端末で確認し直す必要があります。アップデートに失敗した後、新旧の設定を同じディレクトリに混在させて何度も試さないでください。プロセスを終了し、問題が起きた設定を別に保管してから、書き込み可能な別の場所に正常動作が確認済みの設定を復元し、最小限の差分を比較します。

端末から宛先に向かって順に確認する

まず問題の範囲を確認します。すべての端末か1台だけか、すべてのアプリか1つだけか、すべての宛先か特定の種類の名前だけかを調べます。次にクライアントが起動しているか、コアが待ち受けているか、アプリが同じ入口を参照しているか確認します。これらを確認してから、ノードの設定、名前解決、ルーティングを調べてください。ネットワークを切り替えてから問題が起きた場合は、同じ設定のまま2つのネットワークを比較します。ノードを変えてから発生した場合は、同じ宛先で比較してください。

WindowsではPowerShellを使って、例示用のローカルポートで待ち受けがあるか、どのプロセス番号が使用しているかを確認できます。ポート番号を設定画面に表示された実際の値に置き換えてください。別のOSを使う場合は、ローカルポートの競合対処を参照し、OSに応じた方法で調べます。待ち受けが見つからない場合は、コアの起動ログを確認してください。待ち受けが見つかった場合も、所有者を確認し、ポート番号だけでv2rayNだと判断しないでください。

Get-NetTCPConnection -State Listen -LocalPort 10809 |
  Select-Object LocalAddress, LocalPort, OwningProcess

ポートを使用しているのが古いクライアントのインスタンスであれば、まず元のアプリから正常に終了します。必要な別のプログラムが使用している場合は、そのプログラムを残したまま、クライアントに空いているポートを割り当てます。その後、古いポートを明示的に参照しているブラウザー、ターミナル、アプリの設定もすべて変更してください。クライアント側だけポートを変えないようにします。変更後は新しいポートで待ち受けていることを確認し、最初に失敗したリクエストを再実行します。認証やネゴシエーションに関するエラーであれば、該当するプロトコル項目を確認し、ローカルポートだけを調べ続けないでください。

診断情報は必要最小限に絞る

プラットフォーム、クライアント名、使用コア、テスト時刻とタイムゾーン、障害前の直近の変更、エラーが起きた段階、再現に必要な最短手順を記録します。ログを共有する前に、サブスクリプションURL、認証情報、アカウント情報、内部ドメイン名、不要な完全なアクセスパスを取り除いてください。エラーの種類と発生順序は残します。ログレベルを一時的に上げるのは、1回の再現に必要な証拠を集める間だけにし、終わったら通常の設定に戻してください。すぐに再現できない場合は発生条件を観察し、繰り返し再インストールしたり、システムのネットワーク全体をリセットしたりしないでください。

応用設定:再現可能な設定と変更のロールバック

小規模な検証マトリクスを作る

安定して動作してから設定を広げます。まずよく使うケースについて、入口、宛先、期待する結果を整理します。たとえば、ブラウザーはシステムプロキシを使う、指定したターミナルコマンドはローカル入口を使う、LAN管理ページは決めた経路でアクセスする、システムプロキシを読み取らないアプリはTUN有効時だけ対象にする、といった内容です。各テストでは「開ける」だけでなく、期待する結果を明記します。同じ宛先に接続できても、入口によって実際に使われるアウトバウンドが異なる場合があります。

テストを最小限の確認と利用シーンの確認に分けます。最小限の確認では、コアの起動、ポートの待ち受け、宛先1つへのアクセス、正常な終了を確認します。利用シーンの確認では、サブスクリプションの更新、ルーティング例外、対象ネットワークでのDNS、通信の取り込み方法を切り替えた後に元へ戻せることを確かめます。同じ宛先を使って変更前後を比較し、ネットワーク条件を記録します。たまに起きるタイムアウトをすぐ設定ミスと決めつけず、似た条件で再テストして一時的な変動か、安定して再現する問題かを区別してください。

互換性上の理由がある場合にのみコアを切り替える

コアは名前や画面の印象ではなく、設定の要件に基づいて選びます。デスクトップ版v2rayNで選べるコアや設定項目は、使用中のビルドとノードの種類によって異なります。Androidでv2rayNGとv2flyNGを選ぶ場合は、設定元が指定するコアを確認してください。切り替える前に元の設定を保存し、日常使用のグループを上書きせず、コピーでテストします。起動後はまず解析ログを確認し、項目が無視または拒否されていないことを確かめてから、宛先を1つ決めて接続を検証します。

同じノードの共有リンクを複数のアプリにインポートできても、カスタムルーティング、DNSポリシー、追加のトランスポート設定が同じ意味で使えるとは限りません。ルールを移行する前に、「業務用ドメインはシステム指定のDNS経路で解決し、それ以外は従来の条件でアウトバウンドを選ぶ」のように意図を書き出し、新しいコアで対応する方法に置き換えます。アウトバウンドのタグだけを変更して同じ意味になると決めつけないでください。特に未一致時の処理、ドメイン名を解決するタイミング、接続の再利用がテストに与える影響を確認します。

ルールの適用順と復元手順を記録する

GUIクライアントが生成する設定は、起動時や設定保存時に再構築されることがあります。カスタム設定を使う場合は、画面に独立したインポート機能があるか、画面上の項目とどのように組み合わせられるかを先に確認してください。一時生成ファイルだけを変更しても、次回起動時に同じ状態を再現できない場合があります。永続設定の保存先を明確にし、画面で管理する値とインポートファイルから読み込む値を記録します。認証情報は共有可能な設定説明とは分けて保管してください。

変更のたびに、理由、変更した項目、期待する結果、元に戻す方法を記録します。ルーティングを変更するときは、例外を1つだけ追加して正例・反例で確認します。DNSを変更するときは、公開ドメイン1つと維持が必要な内部ドメイン1つを比較します。通信の取り込み方法を変えるときは、無効にした後に復元できることを先に確認してください。復元方法は2通り用意します。1つは追加した項目だけを取り消す方法、もう1つは影響範囲が分からなくなったときに正常動作が確認済みの設定一式に戻す方法です。どちらもプロセスの再起動、システムプロキシの解除、旧アプリ対象範囲の復元が必要か明記してください。

次に問題が起きたときは、直近の変更に合わせて該当する章を確認できます。サブスクリプション更新後に一覧がおかしくなった場合は、サブスクリプションの追加で配信元とグループを確認します。一部の宛先だけ出口が異なる場合は、ルーティングで条件と順序を確認します。通信の取り込みを追加した後にLANへ接続できなくなった場合は、TUNのインターフェース、例外、名前解決を見直してください。操作手順を忘れた場合は、クイックスタートガイドで最小限の接続手順をやり直してから、応用設定に戻れます。設定を日常的に使えるかどうかは、リクエストがどの経路を通るか説明でき、障害時に検証済みの状態へ戻せるかで判断できます。