オープンソースクライアント · ダウンロードと設定

V2Ray入門ガイドv2rayNのダウンロードと設定

サブスクリプションの追加からルーティングまで、実際の設定項目に沿ってPC・Android向けクライアントの設定を解説します。

  • VMess
  • VLESS
  • Trojan
  • REALITY
  • Shadowsocks

v2rayNの基本設定

まずサブスクリプションを整理し、次に通信の経路を決めます。一度に変更する設定は一種類に絞り、元に戻せる状態を保ちましょう。

Subscription / Filter

登録元ごとにまとめ、名前で絞り込む

香港|日本
(?i)hongkong|japan
^(?!.*テスト).*$

サブスクリプショングループは登録元の整理に、サーバーの絞り込みは表示中のリストを絞るのに使います。まず見分けやすいメモをグループに付けてから、サブスクリプションURLを追加します。更新できたら「香港|日本」で、名前にどちらかのキーワードを含むサーバーを抽出できます。英字の大文字・小文字を区別しない設定はインラインの指定で行えますが、対応状況は使用中のクライアントで確認してください。検索結果が空になった場合は、サブスクリプションを削除する前に式を消してみましょう。サーバーを1件ずつ手動で追加するより、グループで管理すれば登録元が分かり、更新やトラブルの確認も簡単です。サブスクリプションURLにはアクセス情報が含まれる場合があるため、スクリーンショットやログを共有する前にURL全体を隠してください。

Client / Platform

プラットフォームに合わせてクライアントを選ぶ

PCではv2rayN、Androidではv2rayNGが有力な選択肢です。インストーラーの形式とCPUアーキテクチャはダウンロードページで確認できます。

Windows

v2rayN · デスクトップ向け

サブスクリプショングループ、システムプロキシ、細かなルーティングを管理したいデスクトップユーザーに適しています。ダウンロードページでは、新世代のクロスプラットフォームUI版と、従来のUIを引き継ぐWPF版を選べます。同じクライアントの異なるUIであり、プロキシを使うために両方をインストールする必要はありません。

まずシステム設定でCPUアーキテクチャを確認し、対応するダウンロード先を選びます。初回起動後はサブスクリプションを追加してサーバーを選び、通常のシステムプロキシが使えることを確認してからTUNを検討してください。アプリは起動するのにブラウザーが接続できない場合は、システムプロキシの接続先がクライアントの実際の待ち受けアドレスとポートになっているか確認しましょう。同じサブスクリプションを何度も追加するだけでは解決しません。

UIの異なるバージョンに切り替える前に、サブスクリプショングループとルーティング設定をバックアップし、現在の設定を記録してください。複数のクライアントで同時にシステムプロキシを変更しないようにしましょう。トラブル対応後や終了時には、プロキシ設定が意図した状態に戻っていることも確認してください。停止したローカルポートへの接続をアプリが続ける事態を防げます。

ダウンロードページへ

macOS

v2rayN · チップ別パッケージ

サブスクリプション、ルーティング、プロキシモードをデスクトップでまとめて管理したい場合に適しています。まず「このMacについて」でチップを確認してください。Apple Siliconならarm64、Intelならx64のダウンロード先を選びます。外観や購入年からアーキテクチャを推測せず、実際のハードウェアに合ったパッケージを選んでください。

初回起動時にシステムのセキュリティ警告が表示されたら、まずインストールファイルの入手元を確認し、「プライバシーとセキュリティ」に表示される案内に従ってください。ネットワークアクセス、システムプロキシ、仮想ネットワークインターフェースは、それぞれ異なる権限が関係します。通常のプロキシで接続できても、TUNに必要な権限が設定済みとは限りません。画面の案内に従って個別に許可するほうが、何度も再インストールするより効果的です。

別のPCから設定を移行する場合は、まずサブスクリプションを追加し、ローカルポート、ルールファイル、パスの設定を確認します。旧端末の絶対パスが新しい端末でも使えるとは限りません。初回起動時のブロックに対処する際は、プラットフォーム別の記事を参考に、セキュリティ警告とネットワーク権限を順に確認してください。システム全体のセキュリティ設定をすぐに変更する必要はありません。

ダウンロードページへ

Android

v2rayNGを優先 · v2flyNGも選択肢

v2rayNGはXrayカーネル、v2flyNGはV2Flyカーネルを採用しています。どちらもオープンソースのGUIクライアントです。選ぶ際は、サブスクリプションで使われているプロトコルやパラメーターとの互換性、必要なアプリ設定を確認しましょう。名前が似ていても、同じ機能とは限りません。比較的新しい一般的なスマートフォンではarm64が主流です。アーキテクチャが分からない場合は、端末情報を確認してから汎用パッケージを検討してください。

初回接続時に、システムからVPN接続の許可を求められます。ここではAndroidのVpnService APIを使用するため、OS標準のVPN設定を別途入力する必要はありません。ネットワークを取り込むアプリは一度に一つだけ起動してください。しばらくバックグラウンドで動かした後に切断される場合は、バッテリー最適化、バックグラウンド動作の制限、メーカー独自の自動起動管理を確認しましょう。

一部のアプリだけをプロキシ経由にする場合は、アプリ別の一覧が「含める」方式か「除外する」方式かを確認してから、対象アプリを選んで接続し直してください。アプリが通信の取り込み対象かどうかと、その通信が最終的にどのアウトバウンドを使うかは別の問題です。前者は取り込み範囲、後者はルーティングルールによって決まります。詳しい手順はAndroid向けの記事をご覧ください。

ダウンロードページへ

Linux

v2rayN · ディストリビューションに合う形式を選ぶ

GUIでサブスクリプションやルーティングを管理したいデスクトップ環境に適しています。ダウンロードページではdebとrpmのパッケージを用意し、x64とarm64を選べます。まずディストリビューションに合うパッケージ形式を確認し、次にCPUアーキテクチャを確認してください。パッケージ形式とカーネルのプロトコル対応は別の問題です。拡張子を変えても設定の互換性は解決しません。

インストール後はクライアントの画面からサブスクリプションを追加し、カーネルが正常に起動することを確認してください。システムプロキシの動作はデスクトップ環境やアプリによって異なり、個別設定が必要なプログラムもあります。TUNを有効にする場合は、仮想ネットワークインターフェースの権限、既存のルート、ほかのネットワーク制御ツールを確認し、元のネットワーク状態に戻せるようにしておきましょう。

ブラウザーは使えるのにほかのプログラムが接続できない場合は、そのプログラムがデスクトップのプロキシ設定を参照するか確認してから、アプリ側でプロキシを設定するかTUNを使うか決めてください。クライアントが起動しない場合は、ログに表示される権限、依存関係、設定項目のエラーを優先して確認しましょう。GUIが起動しない問題と、リモートサーバーに到達できない問題を混同しないでください。ディストリビューション固有の要件は、ダウンロードページの説明と実際のシステムの案内に従ってください。

ダウンロードページへ

すべてのクライアントを見る →どれを選べばよいか迷ったら、まず選び方ガイドをご覧ください。

Project V・V2Fly・Xray

プロジェクト、カーネル、クライアントを区別して、設定を変更する場所を見極めましょう。

エコシステムの構成

Project V
プロジェクトとツール群
V2Fly / Xray
カーネルの実装とそれぞれの進化
v2rayN / v2rayNG / v2flyNG
ユーザー向けGUIクライアント
クライアントとカーネルを比較 →

V2Rayプロジェクトから広がるカーネル群

Project Vは、プロキシ通信を中心に構成されたプロジェクト群で、V2Rayはその中でも広く知られるツールです。コミュニティの発展に伴い、V2FlyコミュニティがV2Rayの保守と開発を引き継ぎました。一方、Xrayは関連するコードを基盤に独立したフォークとして発展し、独自の機能や設定への対応を進めています。この関係を知っておけば、3つの名称を同じソフトウェアの別名と誤解せずに済みます。技術的な背景には共通点がありますが、現在の対応機能はそれぞれ確認が必要です。あるフォークで追加された機能を、別のフォークでも使えると決めつけないでください。

「V2Rayサブスクリプション」は、日常的なやりとりではプロキシサーバー設定の集合を指す言葉として使われますが、その名称だけで、すべてのクライアントが内容を解析できるとは限りません。サブスクリプションには複数のプロトコル、トランスポート方式、セキュリティパラメーターが含まれる場合があります。クライアント側では、それらを使用するカーネルが認識できる設定に変換する必要があります。インポートに成功しても、それで完了ではありません。選択したサーバーのパラメーターが揃っていること、カーネルが正常に起動すること、実際の接続が想定したアウトバウンドを通ることも確認しましょう。

クライアントは管理、カーネルは通信処理を担当

v2rayNはデスクトップ向けGUIを提供し、サブスクリプショングループの整理、サーバーの選択、ルーティングの管理、プロキシモードの変更に使えます。実際のネットワーク機能は使用するカーネルや関連コンポーネントによって異なるため、選択肢は現在の配布パッケージと画面で確認してください。v2rayNGはXrayカーネルを採用したAndroid向けオープンソースクライアント、v2flyNGはV2Flyカーネルを採用したAndroid向けの選択肢です。いずれもGUIを主な操作手段としますが、メニューの位置、インポート形式、詳細設定は同じではありません。記事で説明されている設定名を、実際の画面と照らし合わせてください。

REALITY関連の設定では、プロトコル、トランスポート層、セキュリティ機能を区別する必要があります。REALITYは、任意のサーバーでボタンを押すだけで有効にできる汎用の高速化機能ではありません。接続する双方で、互換性のある設定と実装が必要です。サブスクリプションに含まれる重要なパラメーターを、経験だけを頼りに変更しないでください。必要な情報が不足している場合は、まず設定の入手元を確認しましょう。クライアントのアイコンを変えたり、UIのバージョンを切り替えたりしても、リモート側の設定が補われるわけではなく、サーバーのプロトコル対応も変わりません。

オープンソースライセンスで確認すべきこと

オープンソースとは、それぞれのライセンス条件のもとでコードを閲覧、利用、変更、再配布できることを意味します。関連するすべてのプロジェクトが同じライセンスを採用しているという意味ではありません。V2FlyのV2RayコアはMITライセンス、XrayコアはMPL 2.0で公開されています。GUIクライアント、カーネル、同梱コンポーネントには、それぞれ異なる条件が適用される場合があります。通常のインストールではクライアントのプロジェクト情報で構成要素を確認できます。コードの変更やソフトウェアの再配布を行う場合は、カーネルのライセンスをパッケージ全体のライセンスとみなさず、各ライセンスを個別に確認してください。

コードが公開されていても、ローカルのアクセス権限管理は別途必要です。サブスクリプションURLにアカウント情報が含まれる場合があり、設定にはサーバーアドレスや認証情報、ログにはアクセス先が記録される可能性があります。スクリーンショットを共有する際は、エラーの種類と必要な項目だけを残し、機密情報を隠してください。「LANからの接続を許可」を有効にする前に、待ち受けアドレス、認証方式、ファイアウォールの範囲を確認しましょう。この設定はほかの端末からローカルのプロキシポートに接続できるようにするもので、現在のPCの接続を安定させるために必須ではありません。

クライアント更新時は設定とルールも確認

クライアント本体、プロキシカーネル、サブスクリプションの内容、geoip・geositeルールデータは、それぞれ別の更新対象です。クライアントを更新するとUIや設定の生成方法が変わることがあり、カーネルの更新では対応する設定項目が変わる場合があります。サブスクリプションの更新ではサーバーパラメーターを取得し、ルールデータベースの更新ではドメインやIPアドレスの分類が変わります。ウェブサイトが想定どおりにルーティングされないときは、まず適用されたルールと順序を確認し、データファイルを更新すべきか判断してください。すべてのコンポーネントを一度に入れ替える必要はありません。

更新前にカスタムルーティングとDNSの設定をバックアップし、現在のプロキシモードを記録してください。更新後は、まず以前の設定で基本的な接続を確認してから、新機能を一つずつ有効にします。変更後に問題が発生した場合、最後に加えた設定だけを元に戻すほうが、ポート、DNS、ルーティングを同時に変更するより原因を特定しやすくなります。GUIクライアントによっては実行用の設定ファイルを再生成するため、生成済みファイルを直接編集しても次回起動時に上書きされることがあります。長期的に保持する設定は、クライアントが用意するカスタム設定欄に追加してください。

接続の問題を切り分けて確認する

サブスクリプションの更新失敗とサーバーへの接続失敗は、別の問題です。前者ではURLが完全で有効か、更新リクエストがどの経路を通るかを確認します。後者では、選択中のサーバー、プロトコルパラメーター、システム時刻、カーネルログを確認してください。サーバー一覧が表示されても、システムプロキシが有効とは限りません。ブラウザーから接続できても、すべてのアプリが同じプロキシ設定を使うとは限りません。「インポート、起動、通信の取り込み、名前解決、ルーティング」の順に確認すると、根拠のない再インストールを減らせます。

日常的な設定はまずシステムプロキシから始め、基本の接続を確認してからルーティングを追加しましょう。アプリの通信を取り込む必要がある場合に、TUNを有効にします。DNSやFakeDNSなどの詳細設定は、カーネルやルーティング方針とあわせて理解する必要があり、スイッチ一つをコピーするだけでは不十分です。使い方ガイドではサブスクリプションの追加、モードの選択、接続の確認を順に解説します。詳細設定マニュアルでは、フィルタールール、カスタムアウトバウンド、複雑なDNS構成を個別に扱います。具体的なエラーが発生している場合は、まずよくある質問で該当する手順を確認してから、変更する設定を決めてください。

Notes / Configuration

設定ガイドとプラットフォーム別記事

権限やバックグラウンド動作などの具体的な問題から、日常設定の仕組みを解説します。

v2rayNGのアプリ別プロキシとバッテリー最適化の対象外設定:AndroidのVpnService利用ガイド

バックグラウンドでの切断と、一部アプリがプロキシを経由しない問題は、分けて対処する必要があります。この記事ではVpnServiceによる通信の取り込み範囲から説明し、アプリ別プロキシの一覧、バッテリー最適化の対象外設定、自動起動の確認手順を紹介します。アプリが通信の取り込み対象になっていない場合と、ルーティングによって異なる接続先が選ばれる場合を見分けられます。

記事を読む →

v2rayNをmacOSで開けず「開発元を検証できません」と表示される場合:権限の許可とネットワーク設定

初回起動時にシステムによってブロックされた場合は、まずファイルの入手元を確認し、「プライバシーとセキュリティ」に表示される許可の案内に従ってください。この記事では起動権限、ネットワークアクセス、プロキシ関連の許可を順に説明します。異なる種類の制限を混同したり、実際の権限問題を解決できないまま再インストールを繰り返したりするのを防ぎます。

記事を読む →

すべての記事を見る →