desktop client / configuration guide

V2Ray for Linux v2rayNクライアントのダウンロードと設定

まずサブスクリプションを追加し、順にシステムプロキシとルーティングを設定します。

protocols
  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
カーネル
Xray / V2Fly
クライアント
3
プラットフォーム
4

download

プラットフォームを選択、クライアントをダウンロード

デスクトップではv2rayN、Androidではv2rayNGが基本の選択肢です。まずOSとCPUアーキテクチャを確認し、ダウンロードページで対応するインストーラーを選びましょう。クライアント名が似ていても、パッケージ形式やカーネルの対応機能は同じとは限りません。

Windows

v2rayN / Desktop · WPF

デスクトップ版にはクロスプラットフォームのUIがあり、従来のWPF版では使い慣れたWindowsデスクトップの操作感を維持できます。どちらもサブスクリプションの管理、使用ノードの選択、プロキシ設定に使えます。OSの要件や画面の使い勝手に合わせて選べばよく、同じサブスクリプションを追加するために両方をインストールする必要はありません。

初回起動後は、ノード一覧とログに問題がないことを確認してからシステムプロキシを有効にします。ブラウザーでは接続できるのに開発ツールで失敗する場合は、ツール側のプロキシ設定を確認してください。アプリの起動、カーネルの動作、アプリの通信がプロキシを経由することは、それぞれ別に確認が必要です。

ダウンロードへ →

macOS

v2rayN / Apple Silicon · Intel

まず「このMacについて」でチップ情報を確認します。Apple Siliconはarm64、Intelはx64に対応します。外観だけで判断せず、プロセッサに合ったディスクイメージを選びましょう。インストール後はアプリケーションフォルダから起動し、初回起動に必要な権限をシステムの案内に従って許可してください。

サブスクリプションを追加したら、まずシステムプロキシを使ってブラウザーで接続を確認し、ほかの通信制御方法はその後に検討します。ターミナルのツールはデスクトップのネットワークプロキシ設定を参照しない場合があるため、プロキシアドレスを個別に指定してください。システムのネットワーク設定を変更する前に元の値を控え、クライアント終了時には設定が元に戻っているか確認しましょう。

ダウンロードへ →

Android

v2rayNG / Xray · v2flyNG / V2Fly

Androidではv2rayNGが基本の選択肢で、V2Flyカーネルが必要な設定にはv2flyNGを使います。新しいスマートフォンの多くはarm64を選べます。端末のアーキテクチャがわからない場合は、ダウンロードページのパッケージ説明を確認してください。両アプリはカーネルや設定項目が完全に同じではないため、共有リンクを読み込めるかどうかだけで互換性を判断しないでください。

初回接続時には、システムのVPN権限を許可する必要があります。ノード設定は接続パラメーターを指定し、アプリごとのルーティング設定は通信をプロキシに通すアプリを決めるもので、別々の設定です。バックグラウンドにすると接続が切れる場合は、バッテリー最適化とバックグラウンド動作の制限を確認し、ログで実際の接続エラーがないか調べましょう。

ダウンロードへ →

Linux

v2rayN / deb · rpm

DebianやUbuntuなどでは通常deb、Fedoraなどでは通常rpmを選び、x64とarm64も確認します。パッケージ形式を合わせるだけでなく、ディストリビューションのデスクトップ環境と実行に必要な依存関係も確認してください。GUIクライアントは、利用可能なデスクトップセッションで起動する必要があります。

Linuxデスクトップのシステムプロキシ設定と、ターミナルの環境変数は別々に管理されています。まずローカルSOCKSポートで接続を確認してから、デスクトップのネットワークプロキシを設定しましょう。TUNを使う場合は、権限、ルーティング、DNSも確認します。段階ごとに検証すれば、デスクトップ設定の問題をノードの障害と誤認しにくくなります。

ダウンロードへ →

ダウンロードページでは、プラットフォーム別にパッケージ形式と対象環境をまとめています。インストーラーを選んだら、クイックスタートに戻って設定を追加しましょう。トップページで個別ファイルを探す必要はありません。

すべてのクライアントを見る →

features

設定の入口、5つの基本項目

サブスクリプションは設定の入手元、プロキシモードは通信の入口、ルーティングは出口の選択を担います。まずこの3つを区別し、必要に応じてTUNを有効にしたりカーネルを切り替えたりしましょう。以下は設定項目の例です。実際の名称や利用できる機能は、使用するクライアントによって異なります。

サブスクリプションのグループ管理とノード更新

サブスクリプションリンクを使うと、ノード設定をまとめて取得できます。接続パラメーターを定期的に同期したい場合に便利です。v2rayNでは、まずサブスクリプショングループを作成し、URLを入力して保存してから更新し、使用するノードを選択します。共有リンクを1件ずつ貼り付ける方法と比べ、グループなら配信元を分けて管理でき、個別に更新・無効化しやすくなります。更新されるのは通常ノード一覧で、ローカルのルーティングルールすべてが同期されるわけではありません。削除や上書きの前に必要な設定を保存してください。サブスクリプションURLにはアクセス権限に関する情報が含まれる場合があるため、公開スクリーンショットやログ、共有ドキュメントに載せないようにしましょう。

  • サブスクリプショングループ:名前とURL
  • サブスクリプションを更新:一覧の更新を確認
  • 使用ノード:接続前に選択
サブスクリプションの追加手順を見る →
v2rayNのサブスクリプショングループ設定
サブスクリプショングループ基本設定
名前普段使い
自動更新の間隔必要に応じて設定
自動更新を有効化
キャンセルOK

設定例:グループを保存してから、サブスクリプションメニューで更新します。

quickstart

初回接続、3つの操作ステップ

インストールが終わっても、設定が完了したとは限りません。「設定を追加」「接続先を選択」「接続を確認」の順に進め、各ステップで扱う問題を分けましょう。途中で失敗しても、正常だと確認できた段階を維持できます。

01 / import

サブスクリプションを追加して使用ノードを確認

有効なサブスクリプションリンクまたは共有リンクを用意します。v2rayNではサブスクリプショングループを作成し、URLを保存してから更新します。v2rayNGではサブスクリプション設定に配信元を追加し、設定を更新します。入力欄にURLを貼り付けただけでは追加完了ではありません。一覧に設定が表示されたことを確認し、使用するノードを手動で選択してください。

プロトコルの種類、サーバーポート、トランスポート方式、安全レイヤーが設定元の説明と一致しているか確認します。ウェブページのURLをサブスクリプションURLとして使ったり、更新に失敗したからといってグループをすべて削除したりしないでください。まず、URLにアクセスできないのか、内容を解析できないのか、追加後の一覧が空なのかを確認し、更新方法を変えるか設定元を確認するか判断しましょう。

サブスクリプションと単一ノードの共有リンクの違いは管理範囲です。サブスクリプションは通常、複数ノードの一括更新に使い、共有リンクは1件の設定を追加するために使います。クライアントがリモートサーバーのアカウントを提供するわけではなく、アプリをインストールしただけで接続先が生成されることもありません。次の作業には、利用可能な設定が必要です。

サブスクリプションの追加手順 →

02 / connect

プロキシの入口を設定してからルーティングモードを選ぶ

デスクトップではまずシステムプロキシを有効にし、システム設定に従うアプリの通信をローカルの待ち受けポートに送ります。Androidでは接続を開始するときに、システムの案内に従ってVPN権限を許可してください。その後、用途に合ったルーティングプリセットを選びます。ルーティングプリセットが変えるのは出口の選択方法であり、アプリをプロキシに接続する手順の代わりにはなりません。

普段のブラウジングでは、まず一般的なルーティングプリセットを使い、ローカルリソースとリモートサイトの両方にアクセスして通信が正常か確認します。開発ツール、ターミナル、一部の独立したアプリはシステムプロキシを参照しない場合があるため、それぞれの設定でプロキシの種類、アドレス、ポートを指定してください。必要性が明確でなければ、最初からTUNを有効にしたり、複数のカスタムルールを重ねたりする必要はありません。

ローカルの待ち受けアドレスには通常、ループバックアドレスを使います。同じLAN内の機器にプロキシを提供する必要がある場合に限り、待ち受け範囲の公開やファイアウォール設定を検討してください。「LANからの接続を許可」は、通常のローカル利用に必須の設定ではありません。

モードの選び方を見る →

03 / verify

ウェブサイト、DNS、アプリの通信を確認

まずブラウザーでテスト用のウェブサイトを開き、クライアントのログに該当する接続が記録されているか確認します。接続テスト機能があれば参考にできますが、テストの成功はすべてのアプリがプロキシを使っていることを意味しません。実際のサービスへのアクセス、ドメイン名の解決、システムによる通信の取り込み範囲は、それぞれ確認が必要です。

ウェブページを開けない場合は、まずシステム時刻、ノード設定、ローカルポートを確認し、次にシステムプロキシ、DNS、ルーティングを調べます。ブラウザーは使えてターミナルだけ失敗する場合は、ターミナル側のプロキシ設定を優先して確認してください。ドメイン名では失敗するのにIPアドレスへの接続テストが成功する場合は、名前解決の経路を重点的に調べます。設定は一度に1つだけ変更し、結果を記録してから次に進みましょう。まとめて変更すると、原因を特定しにくくなります。

動作確認が終わったら、普段使う設定を整理します。利用できるサブスクリプショングループを残し、よく使うルーティングモードを記録し、クライアント終了後のシステムネットワークの状態も把握しておきましょう。今後、更新やネットワークの変更があったときも、最初から再インストールせず、同じ手順で確認できます。

トラブル対処へ →

ecosystem

オープンソースのエコシステム、クライアントとカーネルの役割

V2Rayは単一のGUIアプリの名称ではありません。Project V、V2Fly、Xrayと3つのクライアントの関係を理解すると、設定をどのアプリに読み込むべきか、問題がどの層で発生しているかを判断しやすくなります。

Project V:プロキシカーネルからGUIクライアントまで

Project Vを中心にモジュール型のプロキシツール群が形成され、V2Rayはその中で広く使われる主要プロジェクトです。カーネルはインバウンド、アウトバウンド、ルーティング、プロトコル処理を組み合わせます。GUIクライアントはそれらの機能を、サブスクリプショングループ、ノード一覧、設定画面として扱いやすく整理します。接続をクリックした後、実際にネットワークリクエストを処理するのは通常、画面ではなくクライアントが起動または組み込んだカーネルです。

同じV2Ray向けの設定でも、クライアントによって動作が異なる場合があるのはこのためです。インポート時の解析方法、設定の生成方法、カーネルが対応するパラメーターはいずれも結果に影響します。問題を調べるときは、「リンクを追加できるか」「カーネルが起動するか」「目的の通信が完了するか」を分けて確認し、ひとつの接続状態としてまとめないようにしましょう。

V2FlyとXray:関連するが異なる実装

V2FlyはV2Rayのコミュニティ開発を引き継ぎ、Xrayは関連技術を基盤に発展したカーネルプロジェクトです。技術的なルーツを共有しつつ、それぞれ異なるプロトコル機能や設定動作を発展させています。VMess、VLESS、Trojanなどはプロトコル名、WebSocketなどはトランスポート方式、TLSやREALITYなどは安全レイヤーに関わる名称です。これらを同じものとして扱うことはできません。

カーネルはプロジェクト名の比較ではなく、実際の設定要件に基づいて選びましょう。特定の拡張パラメーターを使う場合は、そのカーネルが該当する組み合わせに対応しているか確認します。一般的な設定でも、カーネルを切り替えるためだけに安全関連のパラメーターをむやみに変更しないでください。プロトコルだけで通信速度が決まるわけではありません。ネットワーク経路、サーバーのリソース、トランスポート方式、クライアントの環境も使い勝手に影響します。

3つのクライアント:デスクトップ管理とAndroid利用

v2rayNは、本ページに掲載する3つのデスクトッププラットフォームで使えるGUI設定クライアントです。v2rayNGはAndroid向けでXrayカーネルを採用し、v2flyNGはV2Flyカーネルを使うAndroidクライアントです。いずれもオープンソースプロジェクトですが、画面構成、設定のインポート機能、カーネルの統合方法はそれぞれ異なります。あるクライアントのメニュー手順を、別のクライアントにそのまま当てはめないでください。

オープンソースとは、該当するライセンスに従ってソースコードを閲覧、利用、改善に参加できることを意味します。クライアントがリモートのプロキシサービスを提供するわけではなく、どの設定でも自由にインポートできるという意味でもありません。設定の入手元、アプリの権限、端末の動作環境は、それぞれ確認が必要です。一般的な利用では、複数のクライアントを同時にインストールして設定を混在させるより、プラットフォームとプロトコルに合うものを選ぶほうが管理しやすくなります。

ライセンスと更新:UI、カーネル、ルールを分けて確認

クライアント、カーネル、関連データには、それぞれ異なるオープンソースライセンスが適用される場合があります。利用、改変、再配布を行う際は、対象プロジェクトごとのライセンス説明を確認してください。「オープンソース」という一言で具体的な条件を置き換えることはできません。コミュニティによって修正や機能開発が続けられていますが、現在の端末に更新を適用するかどうかは、システム要件と変更内容を確認して判断しましょう。

日常のメンテナンスでは、何を更新するのかも区別してください。サブスクリプションの更新は通常、リモートから提供されるノード設定を変更します。クライアントの更新は画面や設定生成の仕組み、カーネルの更新はプロトコルの実装に影響する可能性があります。ドメインやIPの分類データはさらに別の層です。動作に変化があった場合は、どの部分を更新したかを確認してからログを見直すと、不要なロールバックや再インストールを減らせます。

目的に合わせて読む:ウェブページだけ開けない場合は、トラブル対処で入口、名前解決、出口を順に確認します。デスクトップとスマートフォンでノードの配信元を統一したい場合は、複数端末で設定を同期する方法を参照してください。ルーティングルールを手動で作成する場合は、ルーティングの章をご覧ください。問題に合わせて文書を選ぶと、高度な設定を一度にすべて開くより原因を特定しやすくなります。

journal

テーマ別に読む、設定とプロトコルの解説

基本的な接続ができたら、具体的な設定の問題に取り組みましょう。以下の記事では、プロトコルの仕組み、複数端末間の同期、カスタムルーティングをそれぞれ解説します。まず課題がどの層に関わるかを確認してから、該当する設定方法を選んでください。

REALITYとXTLS Visionの仕組み:VLESSの新しいトランスポート方式はなぜ高速なのか

TLSハンドシェイク、暗号化の重複、フロー制御の仕組みから、XTLS Visionが暗号化の重複を減らす考え方と、REALITYが独自証明書を不要にする仕組みを解説します。プロトコルの機能と実際の接続条件を分けて考え、仕組みを理解してからノードのパラメーターを確認しましょう。

記事を読む →

v2rayNとv2rayNGの複数端末設定同期:サブスクリプション配信、QRコード、インポート・エクスポート

サブスクリプションリンクの一括配信、共有リンクやQRコード、設定ファイルのインポート・エクスポートという3つの方法を比較し、デスクトップとAndroidでノードやルールを揃える手順を解説します。ノードとローカル設定では同期できる範囲が異なるため、移行前にそれぞれ保存が必要な内容を確認してください。

記事を読む →