クライアントガイド / インストール・設定

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

初めて設定する場合は、まず入門ガイドに沿って、設定の登録、接続、動作確認まで進めてください。このページは手順を確認するためのリファレンスです。端末を替えるときは該当するプラットフォームへ、トラブルが起きたときは症状から確認できます。問題の切り分けのために、最初から再インストールする必要はありません。

事前準備:パッケージ選び・サブスクリプション・権限

OS・プロセッサ・パッケージ形式を確認する

パッケージを選ぶときは、まず端末のOS、次にOSが認識しているプロセッサのアーキテクチャ、最後にパッケージ形式を確認します。デスクトップではv2rayNが第一候補です。AndroidではXrayコアを使うv2rayNGを優先し、V2Flyコアが必要な場合はv2flyNGを検討してください。クライアント名が似ていても、パッケージを相互に使えるとは限りません。また、サブスクリプションを登録すれば、含まれるすべての設定が必ず動作するわけでもありません。選定に迷ったらクライアント比較を、OSとアーキテクチャが分かっている場合はダウンロードページでパッケージを確認してください。

OSクライアントパッケージの選び方初回の動作確認方法
Windowsv2rayNx64デスクトップ版または従来のWPF版システムプロキシとブラウザー
macOSv2rayNApple SiliconまたはIntel向けDMG現在使用中のネットワークサービスのプロキシ設定
Linuxv2rayNx64またはarm64。ディストリビューションに合わせてDEBまたはRPMを選択ローカルプロキシのポートを指定したリクエスト
Androidv2rayNG、v2flyNGarm64またはユニバーサルAPKシステムのVPN状態とアプリのアクセス結果

OSが64ビットでも、プロセッサがx64とは限りません。arm64も64ビットですが、命令セットは異なります。パッケージ形式も、拡張子を変えれば解決するものではありません。たとえばDEBとRPMは別々のパッケージ管理ツールで扱われ、依存関係やインストール情報の管理方法も異なります。ダウンロードページに端末に合うアーキテクチャや形式がない場合は、まずクライアントの対応範囲を確認してください。名前を何度も変更したり、別の解凍ツールを試したり、強制インストールしたりするのは避けましょう。

サブスクリプションURL・個別設定・使用中のノードを区別する

サブスクリプションURLは複数の設定を取得するためのものです。一方、共有リンク1件には接続設定が1つだけ含まれます。それぞれ対応するメニューから登録してください。デスクトップ版では通常、「サブスクリプショングループ設定」にURLを保存してから、メイン画面の「サブスクリプショングループ」で更新します。クリップボードから個別の共有リンクを読み込んでも、この手順の代わりにはなりません。リストに設定が表示されたら、使用するものを選んで有効にします。グループ名は用途別など、見分けやすい名前にできます。ただし、URL、アカウント識別情報、ノードのパスワードは名前に含めないでください。

サブスクリプションURLにはアクセス情報が含まれている場合があります。機密リンクと同様に扱い、公開メモやオンライン変換ツール、質問掲示板に貼り付けないでください。サポートを求めるときは、どの手順でエラーが起きたかを説明し、URL、認証情報、端末を特定できる情報を取り除いたログだけを添えてください。旧端末から移行する場合は、クライアントが対応するエクスポート・インポート機能を優先してください。保存した設定ファイルに元の認証情報が含まれることもあります。旧端末のフォルダー全体を新しいバージョンに上書きする移行は避け、特に古いコアやキャッシュは移さないでください。

初回テストの基準を決める

始める前に、プロキシを有効にしていない状態で通常のWebページが開けるか、端末の日付・時刻・タイムゾーンが正しいか、ほかのプロキシ、ネットワークフィルター、VPNが動作していないかを確認します。組織管理端末には、固定プロキシや管理対象のネットワークポリシーが設定されている場合があります。許可された範囲でのみ変更し、元の設定を記録してください。初回接続では、テスト条件がネットワーク切り替えや再起動で変わらないよう、このクライアントの自動更新とスタートアップ起動をいったん無効にするのがおすすめです。使用中のネットワーク、試すアプリ、期待する結果をあらかじめ記録しておくと、比較しやすくなります。

デスクトップのシステムプロキシは、その設定に従うアプリに対し、リクエストをクライアントのローカル接続先へ送るよう指示します。TUNは仮想ネットワークインターフェースを通じて、該当するルートの通信を受け取る仕組みで、一般により広い範囲を扱います。AndroidではシステムのVPNインターフェースを使うため、デスクトップ用のプロキシアドレスをWi-Fi設定に手動入力する必要はありません。どちらの方法も、有効にすればすべてのアプリやリクエストを処理できるわけではありません。初回設定では「ブラウザーでテストページを開く」のように対象を具体的に決めると、「端末全体がプロキシ経由になった」と漠然と判断するより役立ちます。

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

x64を確認し、デスクトップ版またはWPF版を選ぶ

Windowsの「設定 → システム → バージョン情報」を開き、「デバイスの仕様」の「システムの種類」を確認します。スタートメニューで「PCについて」と検索しても確認できます。x64ベースのプロセッサと表示されていることを確認してから、Windowsのダウンロードオプションでv2rayNを選びます。デスクトップ版はクロスプラットフォームのUIを採用し、従来のWPF版はWindowsでおなじみの画面構成を維持しています。接続プロトコルが異なるわけではありません。初めて使う場合はどちらか一方を選べば十分です。旧版から移行する場合は、デスクトップ版とWPF版の比較を確認してから、旧版を残すか決めてください。

ダウンロードが完了したら、インストーラーの案内に従ってください。初回起動時は、インストールしたばかりのアプリを開いているか確認しましょう。特に、タスクバーに古いショートカットを登録している場合は注意が必要です。起動時にランタイムの不足が表示されたら、選択したバージョンの要件に従って追加し、再起動してください。不足分を別バージョンのプログラムファイルで補わないでください。アプリが通知領域にしか表示されない場合は、タスクバー右側の隠れているアイコンを開いてメインウィンドウを探します。起動していないと思い、何度もダブルクリックしないようにしましょう。バージョンを切り替える際は、同じ待ち受けポートを複数のプロセスが使わないよう、古いインスタンスを終了してから行います。

サブスクリプションを登録し、まずブラウザーだけで確認する

メインウィンドウで「サブスクリプショングループ → サブスクリプショングループ設定」を開き、グループを追加してURLを入力します。保存したら「サブスクリプショングループ」に戻り、まず「すべてのサブスクリプションを更新(プロキシを使用しない)」または同等の項目を選びます。使える接続がまだない状態でプロキシ経由の更新を先に行うと、設定を取得するために、まだ使える状態にない接続が必要になることがあります。更新後、想定したグループにノードが表示されたことを確認します。ノードを右クリックして「アクティブサーバーに設定」を選び、ステータスバーまたはログで切り替えを確認してください。バージョンによってメニュー名は短縮される場合がありますが、「URLの保存」「リストの更新」「使用項目の指定」は別々の操作です。

通知領域のアイコンメニューで「システムプロキシ」から「システムプロキシを自動設定」を選び、システム設定を使用するブラウザーでテストページを開きます。必要に応じてWindowsの「設定 → ネットワークとインターネット → プロキシ」でシステムプロキシの設定を確認し、クライアントに表示されるローカル接続先と照らし合わせてください。Windowsの「設定を自動的に検出する」は、v2rayNメニューの「システムプロキシを自動設定」とは別の機能です。前者はシステムがネットワークのプロキシ設定を検出する仕組みです。テスト中にブラウザー独自のプロキシ拡張機能やポリシーを使っている場合は、システム設定を上書きしていないか確認し、上書きのないブラウザーウィンドウでもう一度試してください。

対象範囲を広げる必要がある場合にTUNを有効にする

ブラウザーは接続できるのに、システムプロキシを使わないデスクトップアプリがある場合は、まずアプリ独自のプロキシ設定を確認し、TUNが必要か判断します。先にv2rayNのシステムプロキシメニューで「システムプロキシを解除」を選び、クライアントの案内に従って必要な権限を用意してから、メイン画面で「Tunを有効にする」を選びます。インターフェースを作成できない、権限が不足している、ルートを追加できないといったエラーが出た場合は、ログを保存し、別のVPNや仮想ネットワークツールが設定を使用していないか確認してください。組織のネットワークでは、テストのためにエンドポイント保護を無効にしたり、管理ポリシーを変更したりせず、許可されている使い方を確認してください。

TUNが不要であれば、システムプロキシは比較的元に戻しやすい日常的な選択肢です。バックグラウンドサービスやコマンドラインツールの中には、独自のプロキシ設定を使うものがあります。ブラウザーが正常でも、それらが同じ経路を使っているとは限りません。クライアント起動時にアドレスの競合が表示された場合は、ログで競合しているローカルポートを確認し、古いインスタンスが残っていないか調べます。ポートを変更した場合は、手動設定したアプリのポートも忘れずに更新してください。終了前に「システムプロキシを解除」を選び、通知領域からクライアントを完全に終了します。ネットワークに組織や個人のプロキシ設定が元からあった場合は、事前に記録した内容に戻してください。システム設定を空欄にすればよいとは限りません。

次回のログイン後にローカルアドレスを指すプロキシが再び設定される場合は、スタートアップアプリに旧版と新版の両方が登録されていないか確認してください。組織のポリシーによって設定が自動的に再適用される場合もあります。再テストではインスタンスを1つだけ起動し、ブラウザーを開く前にローカルの待ち受けが確立していることを確認しましょう。クライアントを終了すると通常のWebページが開けるのに、起動中は失敗する場合は、設定の登録、アクティブな設定、ハンドシェイクのログを確認します。終了後も失敗する場合は、Windowsの現在のプロキシ状態とネットワーク接続を確認してください。

macOS:v2rayNのインストールとネットワークサービスの切り替え

チップに合うDMGをダウンロードしてアプリケーションに移動する

Appleメニューから「このMacについて」を開きます。「チップ」にApple Siliconと表示されている場合は、Apple Silicon向けのarm64パッケージを選びます。「プロセッサ」にIntelと表示されている場合は、Intel向けのx64パッケージを選んでください。macOSのダウンロードオプションから該当するDMGを入手します。ディスクイメージを開き、ウィンドウの案内に従ってアプリを「アプリケーション」に移動し、イメージを取り出してから「アプリケーション」内のアプリを起動します。マウント中のウィンドウから直接起動すると、イメージを取り出した後に起動場所が見つからなくなることがあります。

初回起動時にシステムの警告が表示されたら、ダウンロード元についての説明、起動の拒否、システムとの非互換性のどれに当たるかを確認します。提供元の信頼性を確認し、端末のポリシーで許可されている場合に限り、そのアプリに対するシステムの確認手順を進めてください。1つのアプリのためにシステム保護を全体的に無効にしないでください。現在のシステムでは実行できないという警告が表示されたら、権限を上げて何度も開こうとせず、チップの種類とアプリの要件を確認します。更新する際は古いインスタンスを終了してからアプリを置き換え、設定を別途バックアップしてください。アプリ本体と個人設定は別のものとして扱いましょう。

サブスクリプションを登録し、現在のネットワークサービスを確認する

v2rayNのメインウィンドウで「サブスクリプショングループ設定」を開き、URLを追加します。「サブスクリプショングループ」に戻り、まずプロキシを使用しない更新を実行してください。リストが表示されたら、使用する設定を選びます。次に、メニューバーのクライアントアイコンから「システムプロキシ」を開き、「システムプロキシを自動設定」を選びます。「システム設定 → ネットワーク」で現在使用中のネットワークサービスを開きます。Wi-Fiの場合は「Wi-Fi → 詳細 → プロキシ」に進み、該当するプロキシ項目のサーバーとポートがクライアントの表示と一致するか確認してください。システムのバージョンによって「Wi-Fi」の表記が異なる場合もありますが、確認するのは現在のサービスの詳細です。

システムプロキシの設定はネットワークサービスごとに異なります。Wi-Fiから有線LANに切り替えたり、ドッキングステーションを接続したりすると、以前のサービスの設定が新しい接続に適用されない場合があります。メニューバーにクライアントの動作中と表示されていても、ブラウザーが使う設定は変わっている可能性があります。まず通信に使われているサービスを確認してから、そのサービスのプロキシ設定を調べてください。以前のWi-Fi設定だけを何度も切り替えないようにしましょう。端末に自動プロキシ設定スクリプトのURLが登録されている場合は、用途を記録してください。手動プロキシと自動設定が同時にあると、アプリがシステム設定をどう読み込むかによって結果が変わることがあります。

TUNとスリープ復帰後の接続

システムプロキシを使わないアプリを経由させる必要がある場合に限り、クライアントの「Tunを有効にする」を試します。今回設定したシステムプロキシを解除し、クライアントの案内に従って必要な権限を許可してから、ログで仮想インターフェースとルートが実際に有効になったことを確認してください。ボタンの状態から分かるのは切り替え操作をクライアントが受け取ったことまでで、成功ログの代わりにはなりません。使用中のビルドに該当機能がない場合や、端末管理ポリシーでルート変更が制限されている場合は、システムプロキシまたはアプリ独自のプロキシ設定を使ってください。システムコマンドでデフォルトルートをむやみに変更しないでください。

画面を閉じてスリープから復帰した後、システムが先にWi-Fiへ再接続し、その後アプリの接続が復旧することがあります。一時的に通信が途切れた場合は、まずネットワークサービスが復旧したことを確認してから、新しいWebページを開いてください。ネットワークがIPアドレスを取得する前に、サブスクリプションの更新を何度も実行しないでください。接続が復旧しない場合は、スリープの前後でアクセスポイントが切り替わっていないか記録し、クライアントのローカル待ち受けが維持されているかを確認します。その後、使用中のモードに応じてシステムプロキシを設定し直すか、TUNを再度有効にしてください。接続先のWi-Fiで認証ページへのログインが必要な場合は、今回設定したプロキシを一時的に無効にして認証し、通常のアクセスが戻ったことを確認してから再接続します。

使用を終えるときは、メニューバーからシステムプロキシを解除するか、有効にしたTUNを無効にしてからクライアントを終了し、現在のサービスの設定をもう一度確認してください。ネットワークサービスに独自のプロキシ設定があった場合は、事前に記録した値だけを復元し、ほかのサービスの設定を誤って削除しないでください。スリープ復帰時にだけ起きる問題では、特定のサービスでのみ発生するのか、毎回の復帰で発生するのかを記録すると役立ちます。この違いから、ネットワークの切り替えが原因なのか、クライアントやアプリの接続がシステムとともに復旧していないのかを判断できます。

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

アーキテクチャとディストリビューションに合わせてDEBまたはRPMを選ぶ

まずターミナルでuname -mを実行します。一般的に、出力がx86_64ならダウンロードページのx64、aarch64ならarm64に該当します。次に/etc/os-releaseを確認し、ディストリビューションと標準のパッケージ管理ツールを特定します。通常、DebianやUbuntu系ではDEB、FedoraなどDNFを使うディストリビューションではRPMを選びます。同じデスクトップ環境を複数のディストリビューションで使えるため、画面の見た目だけでパッケージ形式を判断しないでください。Linuxのダウンロードオプションからv2rayNを選び、アーキテクチャと形式を確認してからパッケージ管理ツールで開きます。

グラフィカルな操作に慣れている場合は、ディストリビューションのソフトウェアインストーラーでダウンロードしたパッケージを開けます。依存関係を解決できないというエラーが出た場合は、システムのソフトウェアリポジトリが使用可能か、パッケージがディストリビューションに合っているかを確認し、不足している依存関係を調べます。依存関係を無視して強制インストールする方法は使わないでください。不足したコンポーネントの問題は、起動時には現れず、通知領域への表示、設定の保存、プロキシの切り替え時に発生することもあります。インストール後はデスクトップのアプリメニューから起動し、通常のユーザーでサブスクリプションとプロキシを設定してください。管理者権限での起動を通常の方法にしないでください。

デスクトップ環境によっては、従来の通知領域アイコンがパネルに表示されません。閉じるボタンを押した後にクライアントが見えなくなった場合は、まず通知領域に最小化されていないか確認し、アプリメニューから再表示を試してください。複数のユーザーセッションがある場合は、操作中のセッションでプログラムが動作しているかも確認します。以前に管理者として起動したことが原因で、通常ユーザーでは保存できなくなった場合も、同じ方法を繰り返して問題を隠さないでください。設定をバックアップし、クライアント自身のディレクトリでエラーが起きていることを確認してから、ディストリビューションの方法で所有者を修正します。ホームディレクトリ全体を再帰的に変更しないでください。

サブスクリプションを登録し、デスクトップとターミナルのプロキシを分けて確認する

「サブスクリプショングループ設定」でグループを追加してURLを保存し、「すべてのサブスクリプションを更新(プロキシを使用しない)」を実行します。リストが表示されたら、使用する設定を選びます。クライアントの「システムプロキシを自動設定」でデスクトップのプロキシを変更できるかどうかは、デスクトップ環境とクライアントの連携方法によります。デスクトップ設定の「ネットワーク → ネットワークプロキシ」で実際の値を確認してください。環境によっては「システム設定 → ネットワーク → プロキシ」にあります。デスクトップのプロキシが有効でも、ターミナルのツールが独自のオプションや環境変数しか使わない場合があります。それぞれ個別にテストしてください。

以下のコマンドは、このリクエストだけにローカルHTTPプロキシを使います。デスクトップやターミナルの恒久的な設定は変更しません。実行前に、例にあるポートをv2rayNに表示されたHTTPポートへ変更するか、HTTPに対応した混合ポートであることを確認してください。SOCKS専用ポートをhttp://アドレスに指定しないでください。コマンドの実行にはcurlが必要です。末尾のURLは、テストに使用できるWebページに変更してもかまいません。

uname -m
cat /etc/os-release
curl --max-time 15 --noproxy '' \
  --proxy http://127.0.0.1:10809 \
  --head https://example.com/

ループバックアドレスに接続できないというエラーがすぐに出た場合は、クライアントが起動して待ち受けているか、ポート番号に誤りがないか確認します。ローカルポートには接続できるのに、その後タイムアウト、プロキシエラー、TLSエラーが発生する場合は、アクティブな設定とログを確認してください。サイトによってはコマンドのHEADリクエストを受け付けません。メソッド非対応の応答が返った場合は、--headを削除して通常のリクエストで再試行します。1回成功しても、そのリクエストが通ったことしか確認できません。すべてのターミナルプロセスがデスクトップのプロキシを引き継ぐことや、すべてのドメインが同じルートを使うことを示すものではありません。

TUNを有効にする前に、端末を復旧できる手段を確保する

システムがTUNに対応し、クライアントに必要なネットワーク操作を許可できることを確認してから、v2rayNで「Tunを有効にする」を選びます。まずデスクトッププロキシを解除し、通信の扱い方だけを切り替えてください。初回テストは、直接操作できるセッションで行います。唯一のリモート管理接続でルートを変更しないでください。ログにデバイスが使用できない、権限が不足している、ルートの追加に失敗したなどと表示されたら、システム、コンテナー、権限のどこに原因があるか確認します。ネットワークデバイスをすべてのユーザーから操作できるように変更しないでください。有効化後にイントラネットへアクセスできなくなった場合は、まずTUNを無効にして元の状態に戻し、ネットワーク範囲の競合かルールの適用範囲かを調べます。

ターミナル用にプロキシ環境変数を個別設定している場合、クライアントを終了してもデスクトップの設定と連動して自動的に消えることはありません。新しいターミナルでは正常なのに、以前から開いているターミナルで失敗する場合は、古いセッションのhttp_proxy、https_proxy、all_proxyが以前のポートを指していないか確認してください。大文字の変数やツール独自の設定ファイルにも注意が必要です。組織のネットワークに必要なプロキシまで削除しないよう、今回一時的に追加した設定だけを解除します。復旧後にデスクトップアプリとターミナルのリクエストを1つずつテストすると、両方の接続先が想定どおりに戻ったか確認できます。

Android:v2rayNG・v2flyNGのインストールとVPN接続

クライアントを選んでからarm64またはユニバーサルパッケージを選ぶ

Androidのダウンロードオプションでは、まずv2rayNGを確認してください。設定の提供元からV2Flyコアが必要と明示されている場合は、v2flyNGを選びます。比較的新しい端末ではarm64パッケージが使えることが多いものの、インストールできるかどうかはAndroidがアプリにそのアーキテクチャを提供するかで決まり、プロセッサのハードウェアだけでは判断できません。分からない場合は、該当するクライアントのユニバーサルパッケージを選べます。ユニバーサルパッケージには通常、複数のアーキテクチャ向けコンポーネントが含まれますが、解決できるのはアーキテクチャの選択だけです。OSバージョンの不一致、空き容量不足、端末管理による制限は解決できません。

APKをダウンロードしたら、システムのダウンロード一覧またはファイルマネージャーから開きます。提供元不明のアプリのインストール許可を求められた場合は、入手元の信頼性と端末のポリシーを確認したうえで、実際にインストールを開始するアプリに限って一時的に許可してください。インストール後は許可を取り消せます。更新できないと表示されたら、既存のアプリが同じクライアントか、インストール元が同じかを確認し、署名の違いによって上書きできない可能性を調べます。インストールに失敗したからといって、すぐに旧アプリをアンインストールしないでください。サブスクリプションやローカル設定も削除される場合があるため、既存のエクスポート機能で先にバックアップしてください。

サブスクリプションの更新だけでは接続されない

クライアントのサイドバーまたはメインメニューから「サブスクリプショングループ設定」を開きます。画面によっては「サブスクリプション設定」と表示されます。項目を追加し、識別しやすい名前とURLを入力します。グループが有効になっていることを確認して保存してください。メイン画面に戻り、右上のメニューから「サブスクリプションを更新」を選びます。現在のグループとすべてのグループを選べる場合、初回は新しく作ったグループだけを更新できます。個別の共有リンクを登録する場合は、遠隔サブスクリプションのURLとして扱わず、メイン画面のプラスメニューにあるクリップボードからのインポートを使ってください。リストが読み込まれたら、設定を1つ選び、メイン画面の接続ボタンをタップします。

初回接続時、AndroidからVPN接続の許可を求められます。表示されたアプリ名が起動したクライアントと一致することを確認してから許可し、クライアントの状態とシステムのVPN表示を確認してください。許可していなくてもメインリストは表示されることがありますが、通信がクライアントを通っているとは限りません。システムにVPNが表示されていればインターフェースは確立していますが、選択したノードに接続できるとは限りません。続いてブラウザーでテストページを開き、実際に使うアプリも個別に開いてください。結果が異なる場合は、そのアプリがアプリ別ルールで除外されていないか確認します。

アプリ別設定・バックグラウンド制限・ネットワーク切り替え

Androidでは通常、Wi-Fiの手動プロキシを別途設定する必要はありません。クライアントはシステムのVPNインターフェースを通じ、ルートと対象アプリに応じて通信を受け取ります。これは仮想インターフェースによる通信の振り分けに似た仕組みです。クライアント設定で「アプリ別プロキシ」または同様の機能を有効にしている場合は、対象アプリのリストが許可リストか除外リストかを先に確認してください。同じアプリにチェックを付けても、リストの種類によって意味が逆になる場合があります。まずアプリ別ルールを無効にして基本接続を確認し、その後で対象アプリを1つだけ追加または除外します。変更後に再接続を求められた場合は、指示に従って接続し直してから結果を判断してください。

同じユーザー環境でシステムのVPNインターフェースを使う別のアプリが、現在の接続と競合することがあります。ローカルフィルターアプリなどがその例です。接続直後に切断される場合は、「設定 → ネットワークとインターネット → VPN」などの画面で、どのアプリがVPNを使用中か、「常時接続」や「VPNなしの接続をブロック」が有効かを確認してください。機種によっては「その他の接続設定」にあります。設定内検索も利用できます。業務用VPNは独断で置き換えないでください。競合を調べる場合は、変更権限がある環境で行います。

画面消灯後に切断され、点灯中は正常な場合は、クライアントの通知とログを確認します。サービスが停止しているなら、システムのバッテリー設定でアプリのバックグラウンド制限を調べてください。サービスが動作中なのにリクエストがタイムアウトする場合は、Wi-Fiとモバイルネットワークを分けて再テストします。接続ネットワークを切り替えると既存の接続は無効になることがあり、システムのVPN表示が残っていても同様です。ネットワーク自体が復旧するのを待ってから、一度切断して再接続し、新しく開いたページで確認してください。自動更新だけが失敗する場合は、サブスクリプション設定の更新スイッチと間隔、バックグラウンド実行の条件を確認します。自動更新の頻度は、現在のノードに接続できるかどうかとは別の問題です。

短時間のテストを終えたら、クライアントのボタンから切断し、システムVPNを別のアプリが引き続き使用していないか確認します。「VPNなしの接続をブロック」が有効な端末では、クライアントを終了しても通信できないことがあります。システム設定が引き続き適用されている可能性があるため、まず制限の目的を理解し、変更権限のある人が調整するか判断してください。あらゆるトラブルに対する一般的な解決策として、この制限を無効にしないでください。

接続確認:段階的なテストと設定の復元

ローカル接続先から確認し、次に使用中の設定を調べる

動作確認では、次の3点を確認します。アプリのリクエストがクライアントに届いているか、クライアントが想定した設定を使用しているか、接続先から正常な応答が返るか、です。デスクトップでは、まずメイン画面に表示される使用中の設定を確認し、ログでローカル接続先が起動しているか調べます。ローカルポートへの接続に失敗する場合、通常はまだリモート側まで到達していません。ローカル接続先がリクエストを受け取るのにリモートハンドシェイクで失敗する場合は、アクティブなノードの設定、端末の時刻、現在のネットワーク、設定の提供元の情報を確認してください。Androidでは、この確認のためにLANへの待ち受けを有効にする必要はありません。アプリのアクセス時刻とクライアントログを照らし合わせてください。

比較するときは、同じアプリで同じWebページを開いてから、2つ目のページを試して特定サイトだけの問題か切り分けます。2つ目のアプリを試すときも、ノードとルーティングは変えないでください。新しいウィンドウを開いてページを再読み込みするなど、新しい接続を発生させてテストします。すでに読み込み済みで、キャッシュから表示できるページだけを確認しても不十分です。クライアントログでリクエストを確認できる場合は、操作時刻、宛先ドメイン、適用されたアウトバウンドを照合します。ログのフィルター設定によって接続の詳細が隠れる場合があるため、「ログに何も表示されない」ことだけで通信が経由していないとは判断できません。ログ、クライアントの状態、実際のアクセス結果を合わせて確認しましょう。

DNS名前解決・ルーティング・プロキシの適用範囲を分けて確認する

DNS名前解決は「この名前がどのアドレスに対応するか」を調べる処理で、ルーティングは「このリクエストをどの出口へ送るか」を決める処理です。名前解決に成功しても、ルートが正しいとは限りません。逆に、ルールにドメインが登録されていても、アプリがそのドメインをコアに渡しているとは限りません。アプリが先に名前解決し、IPアドレスだけを渡す場合があります。ブラウザーが独自の暗号化DNSを使うこともあります。特定のアプリでだけ同じドメインに問題が起きる場合は、まずアプリ独自の名前解決設定を確認してください。端末全体で名前解決に失敗する場合は、システム、クライアント、現在のネットワークそれぞれのDNS設定を比べ、どこで問題が起きているか調べます。

以下は、ルーティングポリシーのフィールドを確認するための、コア設定の最小限のJSON例です。IPIfNonMatchは、ドメイン名を含む宛先について、まず既存ルールへの一致を試し、該当しない場合はIPアドレスへの名前解決を試してIPルールとの照合を続ける、という意味です。直結・プロキシの出口を自動で定義したり、アプリのDNS設定を書き換えたりするものではありません。カスタム設定にすでにroutingオブジェクトがある場合は、コアの対応状況を確認してフィールドを統合し、既存ルールを残してください。この部分だけでファイル全体を置き換えないでください。GUIを使う場合は、v2rayNの「設定 → ルーティング設定」で該当するポリシーを確認できます。

{
  "routing": {
    "domainStrategy": "IPIfNonMatch"
  }
}

ポリシーのフィールドが正しくても、ルールが参照するドメインやアドレスのデータベースが古ければ、名前解決ポリシーを調整しても期待どおりにならないことがあります。まず、どのルールが適用されているか確認し、ルーティングルールファイルの更新方法を参照してください。DNSクエリが想定外の出口を通っている疑いがある場合は、DNSクエリの確認と設定を確認します。1つのテストサイトの結果だけで全体を判断したり、元に戻す記録がないままルールデータベース、DNSアドレス、ルーティングモードをまとめて変更したりしないでください。

有効にした順序と逆の順序で元に戻す

テストを終えるときは、最後に有効にした通信の取り込み方式を先に無効にし、次にアプリに一時入力したプロキシ設定を解除してから、クライアントを終了します。TUNを使った場合は、仮想インターフェースとルートの削除が完了してからネットワークを切り替えてください。システムプロキシを使った場合は、システム設定にループバックアドレスが残っていないか確認し、元の業務用設定があれば復元します。終了後もネットワークに接続できない場合は、サブスクリプションを何度も消去せず、まず基本接続を復旧します。端末がネットワークに接続されているか、認証ページへのログインが必要かを確認し、プロキシとVPNの状態を調べてから、もともと直接接続できていた宛先をテストしてください。

設定を元に戻した後も動作確認が必要です。プロキシを無効にした状態では、すべての宛先に同じ方法でアクセスできる必要はなく、テスト前の状態に戻っているかを確認します。独自DNS、組織の自動プロキシ設定スクリプト、アプリ別ルールを使っている場合は、今回の変更だけを戻し、関係のない設定を削除しないでください。テストごとに「システムプロキシだけ有効、ブラウザーは成功、アプリに変化なし」のように記録すると、次のテストに役立ちます。問題が起きたときは、クライアント全体を再インストールするより、最後に正常だった記録のほうが、どの設定変更が原因か判断する手がかりになります。

設定のよくある質問:症状から原因を確認

サブスクリプションを保存したのに、リストが空なのはなぜですか?

まずログを確認し、更新リクエストが実際に送信されているか調べます。リクエストがない場合は、保存しただけで更新していない、グループが無効、現在のグループだけを更新した、といった可能性があります。リクエストが送信されてもタイムアウトする場合は、端末の基本的なネットワーク接続を確認し、サブスクリプションURLに接続できないのか、設定内のリモート接続先に到達できないのかを切り分けます。通常、この2つは別のサーバーです。応答があるのにリストが空の場合は、リンクの期限切れ、ログインページの応答、形式の誤り、クライアントが認識できない設定の除外などが考えられます。空のリストを、すべてのノードが接続不能という意味に捉えず、サブスクリプションの提供元と案内を確認してください。

更新先へのアクセスに、動作確認済みのプロキシが必要だと分かっている場合は、その設定を残したまま実際の接続を確認してから、「すべてのサブスクリプションを更新(プロキシを使用)」などの項目を選べます。動作する設定がない場合、「接続するには先に更新が必要、更新には先に接続が必要」という状態に陥らないようにしてください。タイムアウト、証明書エラー、空のリストの見方については、サブスクリプション更新に失敗したときの対処法を参照してください。証明書エラーが発生した場合は、システム時刻とサービスの証明書に関する説明を確認します。証明書エラーの無視を通常の設定にしないでください。

ブラウザーは正常なのに、ほかのアプリで変化がないのはなぜですか?

よくあるのは、ブラウザーはシステムプロキシを読み込む一方で、別のアプリは独自のネットワーク処理を使っているか、個別のプロキシ設定があるケースです。そのアプリのネットワーク設定や接続設定で、「システムプロキシを使用」「手動プロキシ」などの項目を確認してください。手動設定欄がある場合は、クライアントが実際に待ち受けているプロトコルとポートを指定して試します。TUNが必要であれば、元のシステムプロキシ設定を記録し、今回の設定を解除してからTUNだけを有効にしてください。Androidでは、システムVPNの状態とアプリ別リストを確認します。1台の端末にあるアプリの問題を解決するために、デスクトップクライアントのローカルネットワーク待ち受けをほかの端末に公開しないでください。

アプリのトップ画面は開けても、ログインや同期に失敗する場合、通信の対象範囲だけが原因とは限りません。ログインや同期では別のドメインに接続することが多く、以前に確立した接続を再利用することもあります。アプリを終了して再起動し、再現できる操作を1回行ってから、その時間帯の接続とルーティングのログを確認してください。同じ設定を使うほかのリクエストが正常で、特定のサービスだけに問題がある場合は、現在の動作中の設定を保ち、そのサービスの接続要件、名前解決結果、アクセス制限を優先して調べます。

TUNを有効にした後、イントラネットや一部のサイトに接続できないのはなぜですか?

まずTunを無効にし、同じ宛先に元のモードで接続できるか確認します。切り替えのたびに同じ問題が起きる場合は、クライアントのルーティングポリシーがローカルアドレスや内部ドメインを対象にしているか確認し、イントラネットの名前解決が現在のネットワークのDNSに依存していないか調べてください。ローカルゲートウェイのアドレスには接続できるのに、内部名では接続できない場合は、名前解決に問題がある可能性が高く、すべての振り分けルールを削除する必要はありません。アドレスでも名前でも接続できない場合は、ルートを変更する別のツールが同時に接続されていないか、無効化後に確実に復旧したかを確認します。組織管理の制限がある場合は、ネットワーク範囲とクライアントの対応状況を管理者に確認してください。

クライアント終了後にネットワークへ接続できません。再インストールが必要ですか?

まず再インストールは必要ありません。最初に、システムやアプリのプロキシ接続先がローカルポートのまま残っていないか確認してください。クライアントを終了すると、そのアドレスの接続先がなくなる可能性があります。デスクトップではクライアントを再度開き、「システムプロキシを解除」を選んでから通常どおり終了します。業務用プロキシを使っていた端末では、事前に記録した設定を復元してください。問題が特定のアプリだけで起きる場合は、そのアプリ独自の手動プロキシ設定や拡張機能を確認します。Androidクライアントを無効にした場合は、システムVPNの画面で「VPNなしの接続をブロック」が有効になっていないか確認し、端末管理者または本人が既定の利用方針に従って対処してください。

問い合わせる前に、どの情報を記録すればよいですか?

OS名とプロセッサのアーキテクチャ、クライアント名、使用した通信の取り込み方式、どの手順からエラーが起きたかを記録してください。ログは問題発生の前後に必要な数行だけにし、サブスクリプションURL、アカウント情報、接続認証情報、公開に適さない内部アドレスを削除します。クライアントを起動していない状態で接続できるか、特定のネットワークやアプリだけで問題が起きるか、どの操作で復旧できるかも記載してください。これらの情報があれば、ログを確認する人がインストール、サブスクリプション、接続先、ルーティング、リモート側のどこに問題があるか判断しやすくなります。用語を確認したい場合は用語集を、標準手順を最初からやり直す場合は入門ガイドを参照してください。正常と確認できた設定をすべてやり直す必要はありません。