初めてならv2rayNのデスクトップ版、従来の画面を使う手順書があるならWPF版を選びます。ダウンロード前にWindowsの「バージョン情報」で「システムの種類」を確認します。
ウィンドウが表示される前にアプリが終了する場合は、配布元のリリースノートに記載されたデスクトップ実行環境を確認してください。この段階ではサブスクリプションや接続の処理は始まっていないため、ノードのパラメーターを変更しても起動失敗は解決しません。
ダウンロードページへオープンソースクライアントAndroid・デスクトップ
デスクトップでは v2rayN、Androidでは v2rayNGがおすすめです。パッケージを選び、サブスクリプションの追加とルーティング設定を順に進めましょう。
まず、どの段階で問題が起きているかを切り分けます。サブスクリプションの更新は設定の取得、システムプロキシの有効化は一部アプリの接続経路の変更、ルーティングルールはクライアントに入った通信の振り分けを行います。それぞれ役割が異なり、互いに代用できません。確認時は一度に一つだけ設定を変え、同じアプリで再試行すると、どの設定が影響したか判断しやすくなります。
ルーティングルールの例:宛先がプライベートアドレスのリストに一致した場合、directと指定されたアウトバウンドから送信します。この指定は、既存のアウトバウンド名と一致させる必要があります。
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
サブスクリプショングループは、変更される接続設定をまとめて管理するのに便利です。リンクを1件だけ追加する場合は、個別にインポートできます。デスクトップ版v2rayNでは「サブスクリプショングループ」にURLを保存し、現在のグループを更新します。Android版v2rayNGでは、サイドメニューからサブスクリプション設定を開いて保存し、メインリストに戻って更新します。新しい項目が正しいグループに表示されたら、接続設定を一つ選びます。更新後に手動で追加した項目が上書きされる場合は、サブスクリプショングループ内で編集を繰り返すのではなく、別のグループに保存してください。
ルーティング設定では、コアに届いたリクエストを処理します。ドメイン名や宛先アドレスに応じて、直接接続するかプロキシのアウトバウンドに渡すかを決めます。システムプロキシの有効・無効とは別の設定です。まず既存のプリセットで、直接接続が必要なリクエストを一つ試し、「ルーティング設定」で該当ルールを確認します。通常、ルールは上から順に評価されるため、対象範囲が狭い例外ルールを広範囲のルールより上に配置します。ドメインルールが適用されない場合は、クライアントがドメイン名とIPアドレスのどちらを受け取っているかを確認し、名前解決の挙動かマッチ条件を見直してください。
v2rayNの「システムプロキシを自動設定」は、OSのプロキシ設定を行います。この設定に従うデスクトップアプリで利用できます。AndroidのようにシステムVPNサービスを通じてアプリの通信を取り込む方式とは異なり、すべてのデスクトッププロセスが同じ経路を使うとは限りません。動作を確認するには、ブラウザーから新しいリクエストを送信し、クライアントのログに記録されるか確認します。アプリに独自のネットワーク設定がある場合は、そこでプロキシの設定元も確認してください。一時的なテストが終わったら、「システムプロキシを解除」でクライアントが設定したプロキシを元に戻せます。
v2rayNGのVPNモードでは、「アプリ別プロキシ」でVPNに接続するアプリを指定できます。有効にしたら、チェックしたアプリが対象に含まれるのか、除外されるのかを確認してください。「バイパスモード」を有効にすると、チェックしたアプリはこのVPNを経由しません。保存後に接続を切って再接続し、選択したアプリと選択していないアプリの両方から新しいリクエストを送って確認します。アプリの選択はVPNに接続するかどうかを決めるだけで、接続後のアウトバウンドはルーティングルールで決まります。同じアプリでも、ドメインによって異なるアウトバウンドを使う場合があります。
コアは接続設定を解釈してセッションを確立し、クライアントは画面表示とシステムへの接続を担います。デスクトップ版v2rayNでは、対応する設定で適切なコアを選択できます。AndroidでXray系からV2Fly系に切り替える場合は、通常、対応するクライアントを選び直します。インポート前に、リンクを認識できるかだけでなく、サーバー側のプロトコル、トランスポート、安全性に関する設定も確認してください。REALITYを使う設定では、この機能に対応するコアを選びます。切り替え後にフィールドのエラーが出た場合は、元の設定と照合してください。フィールドを一つずつ削除して無理に起動させないでください。
画面イメージは、分散した設定を比較しやすいようにまとめたもので、実際のメニュー順とは異なります。使用中のクライアントで名称が異なる場合は、まず用語一覧で、変更したいのが通信の入口、宛先の照合条件、接続設定のどれかを確認してから、該当するメニューを開いてください。
まずインストールするデバイスを確認し、OSの種類とCPUアーキテクチャに合ったものを選びます。同じアーキテクチャでもOSが異なれば、インストーラーは共用できません。インストール済みのデバイスを更新する場合は、現在使っているクライアントと配布形式も確認してください。
初めてならv2rayNのデスクトップ版、従来の画面を使う手順書があるならWPF版を選びます。ダウンロード前にWindowsの「バージョン情報」で「システムの種類」を確認します。
ウィンドウが表示される前にアプリが終了する場合は、配布元のリリースノートに記載されたデスクトップ実行環境を確認してください。この段階ではサブスクリプションや接続の処理は始まっていないため、ノードのパラメーターを変更しても起動失敗は解決しません。
ダウンロードページへ「このMacについて」で「チップ」または「プロセッサ」を確認します。Appleチップと表示されるモデルではApple Silicon版、Intelプロセッサと表示されるモデルではIntel版を選びます。購入年だけで判断しないでください。同じ時期に異なるアーキテクチャのモデルが販売されている場合があります。
ディスクイメージを開き、付属の手順に従ってアプリを「アプリケーション」にインストールします。イメージ内から直接アプリを起動していた場合は、一度終了し、実際のインストール先から起動してください。インストール時とテスト時に別のコピーを開いてしまうのを防げます。
ダウンロードページへまずXrayベースのv2rayNGを検討してください。V2Flyの設定が必要だと分かっている場合は、v2flyNGと比較します。近年の端末の多くはarm64版を選べます。対応アーキテクチャが不明な場合は、汎用版を確認し、最低システム要件もチェックしてください。
アプリの競合が表示されたら、まず更新に失敗していないか確認します。アンインストールする前に、サブスクリプションや手動で追加した項目をバックアップしてください。
ダウンロードページへDebianやUbuntuではdeb、Fedoraではrpmを選びます。ARMなど、端末のCPUアーキテクチャに合うパッケージを確認してください。
クライアントが起動しても、デスクトップアプリがシステムプロキシを使うとは限りません。インストール後、現在のデスクトップ環境のネットワークプロキシ設定を確認し、その設定を参照するアプリで動作を確かめてください。アプリによっては、独自の設定で接続方法を指定する必要があります。
ダウンロードページへ初回接続では、まず既定の設定を維持し、動作確認済みの接続設定を一つ使って基準となる状態を確認します。接続できたことを確認してから、ルーティング、アプリ別の対象リスト、バックグラウンド設定を変更しましょう。後で問題が起きても、直前の状態に戻して再確認できます。
サブスクリプションURLがある場合は、クライアントでグループを新規作成し、分かりやすい名前とURLを入力して保存後に更新します。共有リンクが1件だけの場合は、クリップボードからインポートする機能を使えば、サブスクリプションを作成する必要はありません。インポート後、メインリストに目的の項目が表示されていることを確認し、テストする接続設定を一つ選びます。設定が見つからないと表示された場合は、コピーした内容が完全なURLまたは共有リンクであり、QRコードの横にある説明文ではないことを確認してください。サブスクリプションURLにはアクセス情報が含まれることがあります。URL全体を公開スクリーンショットや問い合わせに掲載しないでください。
デスクトップではv2rayNで接続設定を選び、「システムプロキシを自動設定」を選択してから、システムプロキシを使うブラウザーを開きます。Androidではv2rayNGで接続をタップします。初回にシステムVPNの許可確認が表示されたら、どのアプリが要求しているかを確かめてから許可してください。テスト中はアプリ別の対象リストを変更せず、必要に応じて他のVPNがシステム接続を使用していないことも確認します。プロキシの有効化やシステムの許可より前にエラーが出る場合は、ルーティングルールを変更せず、クライアントの起動、実行環境、権限の問題を先に解決してください。
普段使うページを開いて新しいリクエストを送り、時刻を記録してからクライアントに戻り、その時刻の実行ログを確認します。該当する記録がない場合は、テスト対象のアプリが接続されているかを確認してください。直接接続と記録されているのにプロキシを通る想定だった場合は、ルールの一致状況を確認します。接続を試みてもタイムアウトする場合は、ローカルネットワーク、接続設定、サーバーの状態を順に確認します。テスト後はシステムプロキシを元に戻すかAndroidのVPNを切断し、同じアプリで再試行して設定の変更が接続状態に反映されることを確認してください。
プロジェクト、コア、クライアントはそれぞれ異なる層です。文書がどの層を扱っているかを把握すると、機能が接続プロトコル、コアの実装、クライアントの設定のどれに属するか判断できます。
Project Vは、初期のV2Rayが属していたプロジェクトのエコシステムです。V2Rayコアはインバウンド、アウトバウンド、ルーティングを処理します。V2FlyコミュニティはV2Rayコアのメンテナンスを引き継ぎ、Xrayは同じコードの系譜から分岐して独自に開発されています。一般的な会話で「V2Ray」は、コアを指す場合もあれば、この種のツール全般を指す場合もあります。「V2Ray対応」と書かれた手順を見たら、特定の共有形式をインポートできるという意味なのか、使用するプロトコルやトランスポート設定で実際に接続できるという意味なのか確認してください。
どちらのコアにも共通する設定概念はありますが、プロトコル名が同じでも、すべてのトランスポートやセキュリティ設定に互換性があるとは限りません。プロトコルと追加フィールドは分けて確認してください。VLESSを使う設定でも、特定のトランスポートやセキュリティ設定が必要な場合があります。コアを切り替えた後、項目が表示されても起動やハンドシェイクに失敗する場合は、元の設定と対応フィールドを照合し、サーバー側の要件も確認してください。「インポート済み」であることを「互換性がある」と判断しないでください。
v2rayNはデスクトップ向けで、サブスクリプション、各種設定、システムプロキシを管理できます。v2rayNGはXrayベースの接続をAndroidのシステムVPNサービスに接続します。v2flyNGはV2Flyコアを採用し、対応する設定が必要なAndroid端末向けの選択肢です。3つのGUIクライアントはいずれもGPL-3.0ライセンスで公開されており、無料で利用できます。クライアントのライセンスはコアやその他のコンポーネントのライセンスとは異なり、利用可能なサーバーやサブスクリプションサービスも含まれません。手元の設定に合わせてクライアントを選んでください。
クライアント、コア、ルーティング用ルールデータは、それぞれ別に更新されることがあります。クライアントの更新では画面表示やシステム連携が、コアの更新では設定の解析や接続動作が変わる場合があります。一部のドメインでアウトバウンドが想定と異なるだけなら、クライアントとコアを同時に入れ替えるのではなく、現在使っているルーティングルールやデータを先に確認してください。更新前に有効なグループ、ルーティングプリセット、アプリの対象範囲を記録します。更新後は、以前接続できた設定を再確認してから新しい設定を試すと、移行時の問題と元からあった問題を切り分けやすくなります。
ウィンドウが開かない、特定の接続がタイムアウトする、ログにハンドシェイクエラーが表示されるといった症状は、それぞれ確認の起点が異なります。現在の状況に近い記事を選んでください。複数のアプリで同時に問題が起きている場合は、トラブル診断で症状を一つずつ確認するのがおすすめです。
クライアントが起動直後にクラッシュまたは終了する場合に、.NETデスクトップランタイム、展開先のパスとフォルダー権限、セキュリティソフトによるブロック、破損した設定ファイルを順に確認します。Android版のクラッシュ対処法も解説します。
PCのシステム時刻、ポートの使用状況、システムプロキシモード、サブスクリプション設定、トランスポート層、TLS設定の順に確認し、ノードのタイムアウトや接続不能の原因を段階的に切り分けます。各手順の確認方法も紹介します。
ログレベルの設定とログの構成を解説し、connection refused、i/o timeout、tls handshake failureなどのよくあるエラーを一つずつ説明します。エラーごとの調査方法も紹介します。