本文へ移動
デスクトップクライアント設定ガイドインストールからルーティングまで

V2Ray Macクライアント v2rayN macOS版のダウンロードと設定

チップに合ったインストーラーを選び、サブスクリプションを追加してシステムプロキシとルーティングを設定。DNSとTUNは必要に応じて調整します。

PROTOCOLS VMessVLESSTrojanShadowsocks
DESKTOPv2rayNデスクトップ設定
ANDROIDv2rayNG / v2flyNG必要なコアに応じて選択
CORE FAMILYXray · V2Fly対応プロトコルは選択したコアによって異なります

クライアントをダウンロード

OSとチップに合ったインストーラーを選択

クライアント一覧を見る →

デスクトップではv2rayN、Androidではv2rayNGから確認しましょう。まずOSを確認し、次にプロセッサのアーキテクチャを確認してください。arm64とx64はパソコンの見た目だけでは判断できません。ダウンロードページに各プラットフォームへのリンクをまとめています。バージョン情報は各クライアントのカードで確認できます。

Windows

v2rayN · Desktop / WPF

デスクトップ版にはクロスプラットフォームのUI版と、従来の操作画面を備えたWPF版があります。設定済みの場合は先にバックアップし、使い方に合った版を選んでください。初めてインストールする場合は、ダウンロードページでシステム要件を確認しましょう。2つの版を同時にシステムプロキシとして使わないでください。

ダウンロードへ Windows クライアント→

macOS

v2rayN · Appleシリコン / Intel

Appleメニューから「このMacについて」を開きます。「Appleシリコン」と表示される場合はarm64、「Intel」と表示される場合はx64を選択してください。ディスクイメージをダウンロードしたら、アプリを「アプリケーション」フォルダに移してから起動します。マウントしたイメージから実行し続けないようにしましょう。

初回起動時にセキュリティ警告が表示された場合は、配布元とアプリ名を確認してから、「プライバシーとセキュリティ」で該当する案内を確認します。まずシステムプロキシでブラウザーの接続をテストし、サブスクリプションとノードの設定が正しいことを確認してから、追加の権限が必要なTUNを検討してください。

ダウンロードへ macOS クライアント→

Android

v2rayNG · v2flyNG

一般的なスマートフォンでは、まずarm64版を確認してください。アーキテクチャが不明な場合は汎用版を選べます。v2rayNGはXrayコア、v2flyNGはV2Flyコアを使う選択肢です。接続前にシステムのVPN許可を確認し、バックグラウンド動作に影響する省電力設定にも注意してください。

ダウンロードへ Android クライアント→

Linux

v2rayN · deb / rpm

ディストリビューションのパッケージ形式に合わせてdebまたはrpmを選び、x64とarm64も確認してください。デスクトップ環境がシステムプロキシを参照するかどうかで、アプリがプロキシ経由になる範囲は変わります。インストール後も、プロキシ設定、ローカルの待ち受けポート、アプリ独自のネットワーク設定を確認しましょう。

ダウンロードへ Linux クライアント→

クライアントはローカル設定を管理するもので、利用可能なサブスクリプションは付属しません。インストール前に、利用権限のあるサブスクリプションURLまたはノード設定一式を用意し、入手元の情報も保管してください。サブスクリプションURLには認証情報が含まれることがあるため、公開コメントやスクリーンショットに貼り付けないでください。

v2rayN 設定ガイド

システムプロキシ、ルーティング、サブスクリプション管理

「通信をどうクライアントに取り込むか」と「取り込んだ通信をどの経路へ送るか」は分けて考えましょう。システムプロキシとTUNは通信を取り込み、ルールは接続先を選び、DNSはドメインの名前解決に影響します。下記の順に設定を確認すると、すべての機能を同時に有効にするより原因を特定しやすくなります。

システムプロキシ:まずブラウザーを接続

システムプロキシを使うと、OSのネットワーク設定に従うアプリの通信をクライアントのローカルポートへ送れます。サブスクリプションを追加してノードを選んだら、ステータスバーで「システムプロキシを自動設定」を選び、ブラウザーで接続を確認してください。「システムプロキシを解除」は設定を元に戻す操作です。「システムプロキシを変更しない」は現在の設定を変更しないだけで、すでに設定されたプロキシを無効にするものではありません。アプリごとにポートを入力するより手軽ですが、すべてのアプリが自動的に対象になるわけではありません。特定のアプリが直接接続する場合は、システムプロキシを参照するアプリか確認し、個別設定またはTUNの利用を検討しましょう。

  • クライアントのコアが起動していること、ローカルポートが他のプロセスに使われていないことを確認します。
  • 終了する前にシステムプロキシを解除し、接続できないローカル設定が残らないようにします。
  • ブラウザーのプロキシ拡張機能がシステム設定を上書きする場合があります。問題の切り分けでは、競合する拡張機能をいったん無効にしてください。

システムプロキシ · ステータスバーの設定

システムプロキシを解除
システムプロキシを自動設定
システムプロキシを変更しない

画面上の項目名は、クライアントの更新によって変わることがあります。名称が異なる場合は、「システムプロキシ」「ルーティング」「サブスクリプション」「コア」の機能から該当する設定を探してください。ほかのプラットフォームのスクリーンショットにあるボタン位置をそのまま当てはめないでください。画面イメージは設定の関係を示すもので、インストール後に利用可能な設定が自動で用意されるわけではありません。

全プラットフォームのインストール・設定ガイドを見る →

クイックスタート

サブスクリプションの追加から接続確認まで

詳しいガイドを見る →

初めて設定するときは、サブスクリプションを用意し、ノードを選び、システムプロキシを有効にしてブラウザーで接続を確認する、という最短の手順から始めましょう。基本接続が使えるようになってからカスタムルールやTUNを追加します。再現可能な初期状態を作れるため、後の変更で問題が起きても、動作が確認できた状態に戻しやすくなります。

  1. 01 / IMPORT

    サブスクリプションを追加して一覧を更新

    「サブスクリプショングループ」で新しいグループを作成し、見分けやすい別名とサブスクリプションURL全体を入力します。保存後に更新し、設定が一覧に表示されたことを確認してから、使用するノードを選択してください。共有リンクを持っている場合はクライアントの該当するインポート機能を使います。共有リンクをサブスクリプションURL欄に入力しないでください。

    一覧が空のままなら、まず更新結果を確認してください。URLの失効、互換性のない応答、接続タイムアウトでは、それぞれ対処方法が異なります。PCの日時が正しいこと、URLのコピー時に引用符や空白、チャットアプリ由来の改行が混ざっていないことも確認しましょう。配布元に接続できない場合は、直接更新とプロキシ経由の更新を比較します。グループ全体を何度も削除する必要はありません。

  2. 02 / ROUTE

    システムプロキシと基本ルーティングを有効化

    ノードを選択したら、コアが起動していることを確認し、システムプロキシを「システムプロキシを自動設定」にします。ルーティングは、現在の利用目的に合うプリセットから始めてください。ルールが接続に影響しているか判断できない場合は、一時的にグローバルへ切り替えて比較できます。グローバルルーティングでも、すべてのアプリの通信が取り込まれるわけではありません。アプリの通信がクライアントの取り込み口に届く必要があります。

    この段階ではTUNを無効のままにし、権限、仮想アダプター、ほかのVPNによる影響を減らします。ブラウザーのプロキシ拡張機能を使っている場合は、いったん無効にするか、システムプロキシと同じ接続先を指定していることを確認してください。職場や学校のネットワークで専用プロキシを使っている場合は、元の設定を記録してから変更し、復元できるようにします。Androidでは、システムの案内に従ってVPN接続を許可してください。

  3. 03 / VERIFY

    接続を確認し、利用できる設定を保存

    ブラウザーで確認したいサイトを開き、クライアントのログも確認します。テストには、直接接続する想定のサイトとプロキシ経由の想定のサイトを含め、ルールが設定どおりに適用されるかを見てください。単一の接続テストや遅延測定で分かるのは、テスト対象についての結果だけです。実際のウェブページ、ログイン、アプリの動作確認に代わるものではありません。

    接続済みなのにウェブページが開かない場合は、再インストールする前に、システムプロキシ、ローカルの待ち受けポート、ルーティング、DNSの順に確認してください。特定のアプリだけで失敗する場合は、そのアプリ独自のプロキシ設定も調べます。接続を確認できたら設定を保存し、終了前にシステムプロキシを解除して通信の取り込みを停止してください。詳しい操作と復元手順は、クイックスタートガイドで確認できます。

Project Vのエコシステム

クライアント、コア、プロトコルの役割

Project Vは、V2Rayの技術エコシステムを理解するための出発点です。GUIクライアントはサブスクリプション、ノード、ルールを操作しやすい画面にまとめます。コアは設定を読み込んで接続を実行し、VMess、VLESS、Trojan、Shadowsocksなどのプロトコルは通信方式を定義します。それぞれのレイヤーが異なる役割を担うため、「V2Rayクライアントをインストールした」だけでは特定のプロトコル機能が使えるとは限りません。コア、通信方式、サーバー側の設定も確認してください。

V2FlyコミュニティはV2Ray関連プロジェクトのメンテナンスを続けており、Xrayは関連技術を基盤に独自のコア機能と設定体系を発展させています。共通する技術用語はありますが、機能の進化は完全には一致しません。ガイドを読む際は、まず対象のコアを確認し、現在のクライアント画面と照らし合わせてください。特にDNS、ルーティング、通信のセキュリティ設定は、項目名が似ていてもそのまま流用できるとは限りません。未知の項目や未対応の組み合わせは、コアの起動時にエラーを引き起こすことがあります。

v2rayN:デスクトップのGUIクライアント

v2rayNはGPL-3.0ライセンスのオープンソースデスクトップクライアントで、設定管理と複数コアの利用に対応しています。デスクトップでは、ウィンドウ、コア、システムプロキシの各状態を区別することが大切です。メイン画面が開いても、コアが設定を正常に読み込んだとは限りません。ノードを選択しても、システムプロキシがローカルの待ち受けポートを参照しているとは限りません。

別のPCに移行する場合は、サブスクリプションやルーティング設定を保存できますが、アプリのパス、権限、プラットフォームのネットワーク設定は改めて確認が必要です。まず基本設定で動作を確認し、その後カスタムルールを戻すほうが、すべての設定を一度に移すより問題を特定しやすくなります。

v2rayNG:AndroidとXray

v2rayNGはGPL-3.0ライセンスのオープンソースAndroidクライアントで、Xrayコアを使用します。AndroidではシステムVPNインターフェースを通じてアプリの通信を取り込むため、デスクトップのシステムプロキシとは操作方法が異なります。接続の許可、バックグラウンド動作の制限、アプリごとの設定、ほかのVPNとの競合が利用状況に影響することがあります。

同じサブスクリプションがデスクトップでは使えてスマートフォンでは失敗する場合は、まずスマートフォンの日時、接続中のネットワーク、コアの対応状況を確認し、その後に通信設定を調べてください。クライアント名が似ているだけで、異なる端末でもプロトコル対応や初期設定が完全に同じだと判断しないでください。

v2flyNG:V2Flyコアを使う選択肢

v2flyNGはGPL-3.0ライセンスのオープンソースAndroidクライアントで、V2Flyコアによる別の設定方法を提供します。V2Flyの動作を比較したい場合や、対応する設定を使う場合に適しています。クライアントを選ぶ際は、プロトコルの互換性と設定要件を基準にしてください。両方をインストールして接続を何度も切り替えることが目的ではありません。

比較する際は、同じネットワークと同じ設定を使い、VPN接続が1つだけ動作していることを確認してください。クライアントによってサブスクリプションの変換方法が異なることがあります。インポート後も、サーバーが必要とする重要な項目がノードの詳細に残っているか確認しましょう。

オープンソースライセンスと日々の更新

オープンソースライセンスには、コードの利用、配布、変更に関する条件が定められています。適用範囲は各プロジェクトと含まれるコンポーネントのライセンスを確認してください。クライアント、コア、同梱コンポーネントでライセンスが異なる場合があります。オープンソースでもライセンス条件を無視できるわけではなく、サードパーティのサブスクリプションサービスがクライアントプロジェクトから提供されるわけでもありません。このサイトはダウンロードと設定の情報をまとめていますが、クライアントのプロジェクト、サブスクリプションの配布元、接続先のウェブサイトはそれぞれ別の役割を担います。

更新も対象ごとに分けて考えましょう。クライアントの更新では画面や設定管理の仕組みが変わり、コアの更新ではプロトコル対応が変わることがあります。サブスクリプションの更新は配布元のノード情報を再取得し、ルーティングルールの更新は照合結果に影響します。問題が起きたら、どのレイヤーを変更したか記録し、使えるバックアップを残してから対象を絞って復元してください。「サブスクリプションを更新」はクライアントのアップグレードではありません。1つのノードの問題を直すために、すべてのコンポーネントを同時に入れ替えないでください。

複数プラットフォームでの操作は全プラットフォームガイドを参照し、ダウンロード、インストール、追加、接続確認の順に設定してください。トラブル時はエラーの種類と発生手順を記録します。公開の場で相談する前に、サブスクリプションURL、認証情報、ノードに含まれる個人情報を削除し、再利用できる接続情報を共有しないようにしてください。

設定とトラブル対処のメモ

接続失敗、ウェブ閲覧、サブスクリプション更新

記事一覧を見る →

まず症状に合った記事を選んでください。ノードのタイムアウトは接続設定とログ、ブラウザーでページが開かない場合は通信の取り込みとDNS、サブスクリプションの更新失敗は配布元と接続経路を確認します。問題を分けて対処すれば、関係のない設定を何度も変更せずに済みます。

V2Rayクライアントをダウンロード