Windows
v2rayN · Desktop / WPF
デスクトップ版にはクロスプラットフォームのUI版と、従来の操作画面を備えたWPF版があります。設定済みの場合は先にバックアップし、使い方に合った版を選んでください。初めてインストールする場合は、ダウンロードページでシステム要件を確認しましょう。2つの版を同時にシステムプロキシとして使わないでください。
ダウンロードへ Windows クライアント→チップに合ったインストーラーを選び、サブスクリプションを追加してシステムプロキシとルーティングを設定。DNSとTUNは必要に応じて調整します。
クライアントをダウンロード
デスクトップではv2rayN、Androidではv2rayNGから確認しましょう。まずOSを確認し、次にプロセッサのアーキテクチャを確認してください。arm64とx64はパソコンの見た目だけでは判断できません。ダウンロードページに各プラットフォームへのリンクをまとめています。バージョン情報は各クライアントのカードで確認できます。
v2rayN · Desktop / WPF
デスクトップ版にはクロスプラットフォームのUI版と、従来の操作画面を備えたWPF版があります。設定済みの場合は先にバックアップし、使い方に合った版を選んでください。初めてインストールする場合は、ダウンロードページでシステム要件を確認しましょう。2つの版を同時にシステムプロキシとして使わないでください。
ダウンロードへ Windows クライアント→v2rayN · Appleシリコン / Intel
Appleメニューから「このMacについて」を開きます。「Appleシリコン」と表示される場合はarm64、「Intel」と表示される場合はx64を選択してください。ディスクイメージをダウンロードしたら、アプリを「アプリケーション」フォルダに移してから起動します。マウントしたイメージから実行し続けないようにしましょう。
初回起動時にセキュリティ警告が表示された場合は、配布元とアプリ名を確認してから、「プライバシーとセキュリティ」で該当する案内を確認します。まずシステムプロキシでブラウザーの接続をテストし、サブスクリプションとノードの設定が正しいことを確認してから、追加の権限が必要なTUNを検討してください。
ダウンロードへ macOS クライアント→v2rayNG · v2flyNG
一般的なスマートフォンでは、まずarm64版を確認してください。アーキテクチャが不明な場合は汎用版を選べます。v2rayNGはXrayコア、v2flyNGはV2Flyコアを使う選択肢です。接続前にシステムのVPN許可を確認し、バックグラウンド動作に影響する省電力設定にも注意してください。
ダウンロードへ Android クライアント→v2rayN · deb / rpm
ディストリビューションのパッケージ形式に合わせてdebまたはrpmを選び、x64とarm64も確認してください。デスクトップ環境がシステムプロキシを参照するかどうかで、アプリがプロキシ経由になる範囲は変わります。インストール後も、プロキシ設定、ローカルの待ち受けポート、アプリ独自のネットワーク設定を確認しましょう。
ダウンロードへ Linux クライアント→クライアントはローカル設定を管理するもので、利用可能なサブスクリプションは付属しません。インストール前に、利用権限のあるサブスクリプションURLまたはノード設定一式を用意し、入手元の情報も保管してください。サブスクリプションURLには認証情報が含まれることがあるため、公開コメントやスクリーンショットに貼り付けないでください。
v2rayN 設定ガイド
「通信をどうクライアントに取り込むか」と「取り込んだ通信をどの経路へ送るか」は分けて考えましょう。システムプロキシとTUNは通信を取り込み、ルールは接続先を選び、DNSはドメインの名前解決に影響します。下記の順に設定を確認すると、すべての機能を同時に有効にするより原因を特定しやすくなります。
システムプロキシを使うと、OSのネットワーク設定に従うアプリの通信をクライアントのローカルポートへ送れます。サブスクリプションを追加してノードを選んだら、ステータスバーで「システムプロキシを自動設定」を選び、ブラウザーで接続を確認してください。「システムプロキシを解除」は設定を元に戻す操作です。「システムプロキシを変更しない」は現在の設定を変更しないだけで、すでに設定されたプロキシを無効にするものではありません。アプリごとにポートを入力するより手軽ですが、すべてのアプリが自動的に対象になるわけではありません。特定のアプリが直接接続する場合は、システムプロキシを参照するアプリか確認し、個別設定またはTUNの利用を検討しましょう。
システムプロキシ · ステータスバーの設定
ルーティングは、通信がコアに取り込まれた後で、直接接続・プロキシ経由・ブロックのいずれにするかを判断します。アプリの通信をクライアントに取り込む機能ではありません。普段は「中国本土を迂回」のルールを確認し、実際の利用状況に合わせてドメインルールを追加します。「グローバル」はルーティングが接続に影響しているか一時的に調べるための設定で、あらゆる不具合を解決するものではありません。ノードを1つ切り替えるだけの場合と異なり、ルールを使えば接続先ごとに異なる経路を選べます。ルールを追加する前に、照合順、ドメインの分類、デフォルトの送信先を確認してください。保存後に設定を再読み込みし、同じ接続先で再テストすると、複数の変更で原因が分からなくなるのを防げます。
ルーティングモード · イメージ
TUNは仮想ネットワークインターフェースを通じて通信を取り込むため、システムプロキシ設定を参照しないアプリに適しています。有効にする前に、システムプロキシでノードの接続を確認し、使用中のプラットフォームで必要な権限とコアの対応状況を確認してください。システムプロキシより広い範囲の通信を扱える一方、ルーティング、DNS、仮想アダプターの設定にも左右されます。ほかのVPN、仮想マシン、ネットワークフィルターが通信経路を変えることもあるため、初回テストではネットワーク関連ツールの同時使用を控えましょう。有効化後にローカルサービスへ接続できなくなった場合は、まずTUNを無効にして元の状態に戻し、プライベートネットワークを迂回するルールを確認します。ノードを次々に入れ替える必要はありません。
TUN · 有効化前の確認
サブスクリプショングループは、配布元のURLとノード一覧をひも付け、更新時に同じ配布元から内容を取得します。見分けやすいグループを作成し、サブスクリプションURL全体を貼り付けてから更新してください。URLの登録に成功しても、一覧が更新済みとは限りません。ノードをすべて手動で追加する場合と比べ、グループを使うと配布元の変更や無効になった設定を管理しやすくなります。自動更新間隔は配布元の指定に合わせ、頻繁に更新する必要はありません。現在のプロキシが使えない場合は「サブスクリプションを更新(プロキシを使用しない)」を試せますが、直接接続できるかはネットワーク環境によります。サブスクリプションには認証情報が含まれるため、個人用の設定として保管してください。
サブスクリプショングループ · 設定画面
DNSはドメイン名をIPアドレスに変換します。名前解決のリクエスト自体にも、到達可能な通信経路が必要です。直接接続用とリモート用のDNSを設定する際は、ルーティングの送信先も確認し、まだ確立していないプロキシにリモート名前解決が依存しないようにしてください。OSのDNSだけを変更する場合と異なり、コア側の設定ではドメインルールに応じて名前解決方法を選べますが、項目や動作はコアと設定形式によって異なります。ドメイン名では接続できずIPアドレスなら接続できる場合は、まずDNSログ、キャッシュ、ルールの適用状況を確認し、その後DoHやFakeDNSを検討します。関連する項目を一度に1つだけ変更し、設定を再読み込みしたら同じドメインで結果を確認してください。
DNS · 設定項目の概要
クライアントはGUI操作を担い、コアはプロトコル、通信方式、実際の接続先を処理します。両者は異なる役割です。v2rayNは複数のコアを設定できますが、選択肢はプラットフォームや配布パッケージによって異なります。クライアント名だけで判断せず、ノードに必要なプロトコル、通信方式、セキュリティ設定を確認して、現在のコアが対応しているか判断しましょう。コアを切り替える前に設定を保存し、カスタムルーティングやDNSの形式も調整が必要か確認してください。起動に失敗した場合は、まず設定の解析エラーを調べ、すべてのエラーをノードの故障と決めつけないでください。更新後はウィンドウが開くかだけでなく、よく使うルールも再確認しましょう。
クライアントと実行レイヤー
メインウィンドウを閉じる、最小化する、クライアントを終了する操作は、それぞれ異なる場合があります。メニューバーやトレイからシステムプロキシと実行状態を確認し、ウィンドウが消えただけでプロキシも停止したと思い込まないようにしてください。毎回メイン画面に戻る代わりに、トレイメニューやショートカットを使うと、よく行う操作を手早く実行できます。ただし、利用できる操作や名称はプラットフォームによって異なります。ショートカットを設定する際は、OSやほかのアプリと競合しない組み合わせを選び、現在のデスクトップ環境で動作を確認してください。終了やネットワークツールの切り替え前に、システムプロキシを解除し、通信の取り込みを停止してからクライアントを終了すると、設定が残って後の接続に影響するのを防げます。
日常操作の確認
クライアントの更新、PCの移行、複雑なルールの変更前には、現在使えている設定を保存してください。バックアップにはサブスクリプショングループ、カスタムノード、ルーティング、DNS設定を含めます。実際にエクスポートできる範囲は、クライアントの画面で確認してください。サブスクリプションURLだけを保存する場合と比べ、設定一式のバックアップなら手動で調整した内容も残せますが、認証情報が含まれることがあります。バックアップはアクセス制限された場所に保管し、問題の相談に使う資料は別途、機密情報を削除したものを作成してください。別のプラットフォームに復元した後は、ローカルパス、待ち受けポート、システム権限を再確認します。すべての環境設定がそのまま引き継がれるとは限りません。まず基本接続を確認してから、高度な機能を1つずつ戻してください。
バックアップ対象 · 操作チェックリスト
画面上の項目名は、クライアントの更新によって変わることがあります。名称が異なる場合は、「システムプロキシ」「ルーティング」「サブスクリプション」「コア」の機能から該当する設定を探してください。ほかのプラットフォームのスクリーンショットにあるボタン位置をそのまま当てはめないでください。画面イメージは設定の関係を示すもので、インストール後に利用可能な設定が自動で用意されるわけではありません。
全プラットフォームのインストール・設定ガイドを見る →クイックスタート
初めて設定するときは、サブスクリプションを用意し、ノードを選び、システムプロキシを有効にしてブラウザーで接続を確認する、という最短の手順から始めましょう。基本接続が使えるようになってからカスタムルールやTUNを追加します。再現可能な初期状態を作れるため、後の変更で問題が起きても、動作が確認できた状態に戻しやすくなります。
「サブスクリプショングループ」で新しいグループを作成し、見分けやすい別名とサブスクリプションURL全体を入力します。保存後に更新し、設定が一覧に表示されたことを確認してから、使用するノードを選択してください。共有リンクを持っている場合はクライアントの該当するインポート機能を使います。共有リンクをサブスクリプションURL欄に入力しないでください。
一覧が空のままなら、まず更新結果を確認してください。URLの失効、互換性のない応答、接続タイムアウトでは、それぞれ対処方法が異なります。PCの日時が正しいこと、URLのコピー時に引用符や空白、チャットアプリ由来の改行が混ざっていないことも確認しましょう。配布元に接続できない場合は、直接更新とプロキシ経由の更新を比較します。グループ全体を何度も削除する必要はありません。
ノードを選択したら、コアが起動していることを確認し、システムプロキシを「システムプロキシを自動設定」にします。ルーティングは、現在の利用目的に合うプリセットから始めてください。ルールが接続に影響しているか判断できない場合は、一時的にグローバルへ切り替えて比較できます。グローバルルーティングでも、すべてのアプリの通信が取り込まれるわけではありません。アプリの通信がクライアントの取り込み口に届く必要があります。
この段階ではTUNを無効のままにし、権限、仮想アダプター、ほかのVPNによる影響を減らします。ブラウザーのプロキシ拡張機能を使っている場合は、いったん無効にするか、システムプロキシと同じ接続先を指定していることを確認してください。職場や学校のネットワークで専用プロキシを使っている場合は、元の設定を記録してから変更し、復元できるようにします。Androidでは、システムの案内に従ってVPN接続を許可してください。
ブラウザーで確認したいサイトを開き、クライアントのログも確認します。テストには、直接接続する想定のサイトとプロキシ経由の想定のサイトを含め、ルールが設定どおりに適用されるかを見てください。単一の接続テストや遅延測定で分かるのは、テスト対象についての結果だけです。実際のウェブページ、ログイン、アプリの動作確認に代わるものではありません。
接続済みなのにウェブページが開かない場合は、再インストールする前に、システムプロキシ、ローカルの待ち受けポート、ルーティング、DNSの順に確認してください。特定のアプリだけで失敗する場合は、そのアプリ独自のプロキシ設定も調べます。接続を確認できたら設定を保存し、終了前にシステムプロキシを解除して通信の取り込みを停止してください。詳しい操作と復元手順は、クイックスタートガイドで確認できます。
Project Vのエコシステム
Project Vは、V2Rayの技術エコシステムを理解するための出発点です。GUIクライアントはサブスクリプション、ノード、ルールを操作しやすい画面にまとめます。コアは設定を読み込んで接続を実行し、VMess、VLESS、Trojan、Shadowsocksなどのプロトコルは通信方式を定義します。それぞれのレイヤーが異なる役割を担うため、「V2Rayクライアントをインストールした」だけでは特定のプロトコル機能が使えるとは限りません。コア、通信方式、サーバー側の設定も確認してください。
V2FlyコミュニティはV2Ray関連プロジェクトのメンテナンスを続けており、Xrayは関連技術を基盤に独自のコア機能と設定体系を発展させています。共通する技術用語はありますが、機能の進化は完全には一致しません。ガイドを読む際は、まず対象のコアを確認し、現在のクライアント画面と照らし合わせてください。特にDNS、ルーティング、通信のセキュリティ設定は、項目名が似ていてもそのまま流用できるとは限りません。未知の項目や未対応の組み合わせは、コアの起動時にエラーを引き起こすことがあります。
v2rayNはGPL-3.0ライセンスのオープンソースデスクトップクライアントで、設定管理と複数コアの利用に対応しています。デスクトップでは、ウィンドウ、コア、システムプロキシの各状態を区別することが大切です。メイン画面が開いても、コアが設定を正常に読み込んだとは限りません。ノードを選択しても、システムプロキシがローカルの待ち受けポートを参照しているとは限りません。
別のPCに移行する場合は、サブスクリプションやルーティング設定を保存できますが、アプリのパス、権限、プラットフォームのネットワーク設定は改めて確認が必要です。まず基本設定で動作を確認し、その後カスタムルールを戻すほうが、すべての設定を一度に移すより問題を特定しやすくなります。
v2rayNGはGPL-3.0ライセンスのオープンソースAndroidクライアントで、Xrayコアを使用します。AndroidではシステムVPNインターフェースを通じてアプリの通信を取り込むため、デスクトップのシステムプロキシとは操作方法が異なります。接続の許可、バックグラウンド動作の制限、アプリごとの設定、ほかのVPNとの競合が利用状況に影響することがあります。
同じサブスクリプションがデスクトップでは使えてスマートフォンでは失敗する場合は、まずスマートフォンの日時、接続中のネットワーク、コアの対応状況を確認し、その後に通信設定を調べてください。クライアント名が似ているだけで、異なる端末でもプロトコル対応や初期設定が完全に同じだと判断しないでください。
v2flyNGはGPL-3.0ライセンスのオープンソースAndroidクライアントで、V2Flyコアによる別の設定方法を提供します。V2Flyの動作を比較したい場合や、対応する設定を使う場合に適しています。クライアントを選ぶ際は、プロトコルの互換性と設定要件を基準にしてください。両方をインストールして接続を何度も切り替えることが目的ではありません。
比較する際は、同じネットワークと同じ設定を使い、VPN接続が1つだけ動作していることを確認してください。クライアントによってサブスクリプションの変換方法が異なることがあります。インポート後も、サーバーが必要とする重要な項目がノードの詳細に残っているか確認しましょう。
オープンソースライセンスには、コードの利用、配布、変更に関する条件が定められています。適用範囲は各プロジェクトと含まれるコンポーネントのライセンスを確認してください。クライアント、コア、同梱コンポーネントでライセンスが異なる場合があります。オープンソースでもライセンス条件を無視できるわけではなく、サードパーティのサブスクリプションサービスがクライアントプロジェクトから提供されるわけでもありません。このサイトはダウンロードと設定の情報をまとめていますが、クライアントのプロジェクト、サブスクリプションの配布元、接続先のウェブサイトはそれぞれ別の役割を担います。
更新も対象ごとに分けて考えましょう。クライアントの更新では画面や設定管理の仕組みが変わり、コアの更新ではプロトコル対応が変わることがあります。サブスクリプションの更新は配布元のノード情報を再取得し、ルーティングルールの更新は照合結果に影響します。問題が起きたら、どのレイヤーを変更したか記録し、使えるバックアップを残してから対象を絞って復元してください。「サブスクリプションを更新」はクライアントのアップグレードではありません。1つのノードの問題を直すために、すべてのコンポーネントを同時に入れ替えないでください。
複数プラットフォームでの操作は全プラットフォームガイドを参照し、ダウンロード、インストール、追加、接続確認の順に設定してください。トラブル時はエラーの種類と発生手順を記録します。公開の場で相談する前に、サブスクリプションURL、認証情報、ノードに含まれる個人情報を削除し、再利用できる接続情報を共有しないようにしてください。
設定とトラブル対処のメモ
まず症状に合った記事を選んでください。ノードのタイムアウトは接続設定とログ、ブラウザーでページが開かない場合は通信の取り込みとDNS、サブスクリプションの更新失敗は配布元と接続経路を確認します。問題を分けて対処すれば、関係のない設定を何度も変更せずに済みます。
端末の時刻、通信設定、TLSとSNI、コアのバージョン、出力ログまで、ノードのタイムアウトを段階的に調べる手順を紹介します。
ノードの確認手順を読む →システムプロキシの状態、ローカルポート、ルーティングモード、DNS、ブラウザー拡張機能との競合を順番に確認し、接続済みなのにインターネットを利用できない原因を特定します。
ウェブ閲覧の確認リストを読む →サブスクリプションURLの失効、プロキシ経由の更新ループ、証明書や時刻の不一致など、よくある原因を整理し、自動更新間隔の設定例も紹介します。
サブスクリプション更新の解説を読む →