Windows
デスクトップではまずv2rayNを選びます。新しいデスクトップ版は標準的なインストールに適し、クラシックなWPF版は従来の操作レイアウトを好むユーザー向けです。どちらもサブスクリプション、ルーティング、システムプロキシを管理できます。
ダウンロードページへクライアントと設定ドキュメント · Project V エコシステムガイド
クライアント選びから始め、サブスクリプション導入、ルーティング、設定トラブル対処の順に進めます。デスクトップとAndroidのクライアントを扱い、XrayとV2Flyという2つのコア系列の使い分けも説明します。
サブスクリプションURLを貼り付け、v2rayNにワンクリックで導入CLIENT WORKBENCH
よく使う操作は、サブスクリプショングループ、ルーティングモード、システムプロキシ、コア選択、ログウィンドウの5か所に集約されています。まず設定の階層を見分けてから具体的なパラメーターを変更すると、設定を何度も導入し直すより原因を特定しやすくなります。
サブスクリプションは、サーバー側で管理される設定の入口です。クライアントで更新して初めて、そこに含まれるノード、プロトコル、トランスポート設定がローカルへ書き込まれます。実際に使うときは、まず分かりやすい名前のグループを作成し、完全なサブスクリプションURLを貼り付けて更新します。更新に失敗しても連続してクリックせず、ネットワークアクセスの失敗なのか、返却内容の形式が不正なのか、URLが無効になったのかを確認してください。グループ管理の利点は、取得元を分けて保持できることです。複数のサブスクリプションが互いに上書きせず、1つのグループを無効にしても他の設定には影響しません。手動で追加した単一ノードは一時的なテストに向いているため、長期運用するサブスクリプションと同じグループに混在させないようにします。
ルーティングは単純なオン・オフではなく、順番に照合されるルールの集合です。クライアントはドメイン、IP、ポート、プロトコル種別に応じて、プロキシ、直接接続、遮断のいずれかの出口へリクエストを振り分けます。具体性の高いルールほどリストの前方に置き、範囲の広いフォールバックルールは末尾に置きます。変更後は名前解決の方法も確認してください。IPルールだけを記述して適切なドメインポリシーがないと、ルールに一度も一致しないことがあります。日常の設定では、まずクライアント内蔵の安定したルールセットを使い、本当に必要な項目だけを順番に追加するほうが、出所の不明なルールを大量に一度で導入するより保守とトラブル対処が容易です。
コアが正常に起動したということは、ローカルのプロキシポートがリッスン状態になったことを示すだけです。システム上のアプリがそのポートを使うかどうかは、システムプロキシの設定またはアプリ自身のプロキシ設定に左右されます。ブラウザーは接続できるのに特定のプログラムだけ接続できない場合は、そのプログラムがシステムプロキシを読み取るか確認してください。すべてのプログラムが接続できない場合は、コアのログ、ローカルポート、現在のノードを確認します。LAN接続を許可するとリッスン範囲が変わるため、同じネットワーク上の他の端末から接続する必要がある場合だけ有効にし、OSのファイアウォールルールも確認してください。この2つの階層を理解すれば、システムプロキシが無効な状態をノードやプロトコル設定の誤りと取り違えずに済みます。
v2rayN、v2rayNG、v2flyNGは、サブスクリプション、ノード、システムプロキシなどをGUIで操作しますが、設定を実際に読み込み接続を確立するのは基盤となるコアです。XrayとV2Flyは共通するエコシステムを持つ一方、保守方針、プロトコル拡張、対応フィールドは完全には同じではありません。コアは名前だけで比較せず、ノード設定の要件に合わせて選びます。設定に特定のフロー制御、トランスポート、セキュリティ関連フィールドが含まれる場合は、それらをサポートするコアが必要です。一般的な設定では、クライアントとコアの組み合わせが安定しているかを重視してください。コアを切り替えた後は接続を再起動し、起動ログで対象のコアが実際に読み込まれたことを確認します。
loading config: config.json
routing: domainStrategy=IPIfNonMatch
inbound: socks / http
outbound: proxy / direct
設定の解析失敗、ポート競合、ドメイン名解決の異常、TLSハンドシェイクの失敗は、それぞれ異なるログの手がかりを残します。トラブル対処では、完全に新しい起動から始め、最初に現れたerrorまたはfailedの行を探し、その前後の設定フィールドと照らして原因を判断します。JSON構文エラーは行や列の位置を示すことが多く、ポート競合ではリッスン失敗が表示されます。証明書やハンドシェイクの問題では、システム時刻、serverName、SNI、トランスポート設定を確認してください。その後に大量に繰り返されるログは、最初の障害が引き起こした連鎖結果にすぎない場合があります。元のエラー文を保存し、項目を1つずつ変更するほうが、ノード、DNS、ルーティング、コアを同時に変更するより、どの操作で接続が復旧したかを確認しやすくなります。
PLATFORM ENTRY
プラットフォーム別ページで、対応クライアント、インストール形式、アーキテクチャの選択肢をまとめて紹介します。ホームページではファイルを直接配布せず、対象プラットフォームのページで端末に合ったインストールパッケージを選びます。
デスクトップではまずv2rayNを選びます。新しいデスクトップ版は標準的なインストールに適し、クラシックなWPF版は従来の操作レイアウトを好むユーザー向けです。どちらもサブスクリプション、ルーティング、システムプロキシを管理できます。
ダウンロードページへmacOSではv2rayNデスクトップクライアントを使用します。ダウンロード前にシステム情報でプロセッサーの種類を確認し、Apple SiliconまたはIntel対応のパッケージを選んで、インストール形式と端末のアーキテクチャが合わない事態を避けてください。
ダウンロードページへAndroidではv2rayNGとv2flyNGから選べます。前者はXrayコア系列、後者はV2Flyコア系列を採用しています。近年の端末の多くはarm64を選択でき、アーキテクチャが分からない場合は汎用パッケージを使用します。
ダウンロードページへLinuxデスクトップではv2rayNを使用します。ディストリビューションのパッケージ体系に合わせてdebまたはrpmを選び、プロセッサーのアーキテクチャに応じてx64またはarm64を選択してください。インストール後も、デスクトップセッションでシステムプロキシを設定する必要があります。
ダウンロードページへOPEN SOURCE ECOSYSTEM
クライアント、コア、プロトコル、サブスクリプションは同じ階層ではありません。それぞれの役割を理解して初めて、障害時にGUI、設定ファイル、基盤となるプロトコル実装のどこを確認すべきか判断できます。
Project Vは、設定を中心に動作するネットワークツールのエコシステムを形成しました。初期のV2Rayプロジェクトは、インバウンド、アウトバウンド、ルーティング、DNS、ポリシー、トランスポート層などの基本的な設定構造を確立し、その後コミュニティの保守によってV2FlyとXrayという代表的な2つのコア系列が発展しました。両者は多くの基本概念を共有しており、JSON設定でリッスン入口、リモート出口、照合ルールを記述しますが、新しいプロトコル、トランスポート機能、フィールド拡張、バージョンの進み方にはそれぞれ特徴があります。
そのため、「V2Rayクライアント」は通常、この種のコアと設定を管理するGUIツールを指し、単一のプログラム名ではありません。v2rayNはデスクトップでサブスクリプション、ノード、ルーティング、システムプロキシ、コアの起動を管理し、v2rayNGとv2flyNGはAndroidで設定を管理します。GUIクライアントはユーザーの操作をコアが読み込める設定へ変換し、ローカルのリッスンポートを起動します。接続の成否は最終的に、サブスクリプションの内容、プロトコルパラメーター、トランスポート設定、ドメイン名解決、システム時刻、ローカルネットワーク環境が複合的に影響して決まります。
ソースコードが公開されていることで、プロトコル実装、設定構造、クライアントの動作を公開の場で議論し、継続的に改善できます。ただし、プロジェクトごとにリリースのペースは異なります。クライアントの更新で新しい画面や設定生成ロジックが導入されることがあり、コアの更新ではプロトコルフィールドの追加、互換性問題の修正、デフォルト動作の変更が行われる場合があります。更新前に変更内容を読み、利用可能な設定を保存し、現在のサブスクリプションが特定のコア機能に依存していないか確認してください。安定して使うことは毎回の更新を追いかけることではありません。明確な互換性要件、バグ修正、システム対応の変化があるときに更新するほうが、通常は条件を管理しやすくなります。
オープンソースライセンスは、コードの複製、改変、再配布の範囲も定めています。一般ユーザーが重視すべきなのは、プロジェクト名とインストールパッケージの出所が一致しているか、クライアントが実際にどのコアを呼び出しているか、設定にそのコアが対応するフィールドが含まれているかです。このサイトでは、クライアント操作とコアの概念を分けて解説します。入門手順では目に見える画面に焦点を当て、設定大全ではJSON各セクションの意味を説明し、用語集ではプロトコルとネットワークの基礎概念を調べられます。トラブル記事ではログの状況から具体的な設定をたどります。
Windows、macOS、Linuxに対応し、サブスクリプショングループ、ノード選択、システムプロキシ、ルーティングルール、コア管理をまとめて扱えます。複数の設定をGUIで管理したいデスクトップ環境に適しています。
Xrayコア系列を採用し、サブスクリプション更新、設定導入、ルーティング設定、接続ログを提供します。Xray固有の拡張フィールドを含む設定では、通常この組み合わせを優先します。
V2Flyコア系列を採用し、画面操作は一般的なサブスクリプション手順とよく似ています。設定要件とコアの互換範囲を基準に選べばよく、2種類のクライアントを同時にインストールする必要はありません。
まずURLが完全で、現在もアクセスできることを確認し、返却内容がクライアントで認識できるサブスクリプション形式か確認します。ネットワークエラー、URLの無効化、形式エラーはそれぞれ分けて対処し、ローカル設定をすべて削除しないでください。
サブスクリプション導入の手順を見る →ドメインルールに一致するかどうかは、名前解決の場所やドメインポリシーの影響を受けることがあります。DNSだけ、またはルーティングだけを変更すると本当の原因を隠す可能性があるため、リクエストのドメイン、名前解決の結果、最終的な出口の3段階を確認します。
DNSとroutingの設定を見る →まずサブスクリプションまたは手動設定で使われているプロトコル、フロー制御、トランスポートのフィールドを確認し、それらを正しく解析できるコアを選びます。基本設定はどちらも理解できることが多い一方、拡張機能は項目ごとの確認が必要です。
コアとプロトコルの用語を見る →ログから、設定解析、ポートのリッスン、DNS、接続タイムアウト、ハンドシェイクのどこで問題が起きたかを切り分けられます。一度に変更する変数を1つにし、新しく起動して最初のエラーを記録すると、対処の道筋が明確になります。
設定トラブル対処ガイドを見る →LATEST NOTES
コアの起動、プロトコルの仕組み、TLSエラーを中心に、再利用しやすい確認手順をまとめています。記事中の設定例はフィールド間の関係を説明するためのもので、実際のパラメーターは使用中のサブスクリプションまたはサービス設定に合わせてください。
クライアントのログウィンドウから始め、JSON構文エラー、ポート競合、フィールド名の誤記、プロトコルパラメーター不足という4つの代表的な原因別に、典型的なエラー行を読み解きます。項目ごとの修正方法と、再起動後に確認すべき基準も紹介します。
記事を読む →REALITYのハンドシェイク特性と、XTLS Visionが重複する暗号化コストを抑えるフロー制御の考え方を解説し、クライアント、コア、ノード設定で一致させるべき主要フィールドを説明します。
記事を読む →certificate invalid、handshake failedなどのよくある表示を対象に、システム時刻のずれ、serverNameの不一致、証明書チェーンの問題を確認する順序を整理します。
記事を読む →