ルーティングルールのメモ
  • geosite:cn → direct
  • geoip:private → direct
  • geosite:category-ads-all → block
  • final → proxy
ルーティングルールの書き方 →
GUIクライアント・設定ガイド

V2Ray公式サイト v2rayNをダウンロード

サブスクリプションの取り込みからルーティングまで、デバイスに合ったクライアントを選び、システムプロキシとDNSの設定を順に進めます。

プロトコル一覧 VMess VLESS Trojan Shadowsocks
ダウンロード

OSに合ったV2Rayクライアントを選ぶ

デスクトップではv2rayN、Androidではまずv2rayNGを確認しましょう。OSとCPUアーキテクチャを確認してから、ダウンロードセンターで対応するパッケージを選びます。クライアントのインストールと接続設定は別の手順です。サブスクリプションやサーバー情報があっても、別途取り込む必要があります。

Windows

v2rayN

デスクトップ版はクロスプラットフォームのUIを採用し、従来のWPF版ではおなじみのデスクトップ操作を利用できます。新規インストールの場合は、まずデスクトップ版の説明を確認してください。既存の設定を引き継ぐ場合は、サブスクリプションとルールをバックアップしてから、UIの種類を切り替えるか判断しましょう。ランタイム要件とインストール手順はダウンロードページで個別に案内しています。異なる版を同じフォルダーに上書きしないでください。

ダウンロードページへ →

macOS

v2rayN

「このMacについて」でチップの種類を確認し、Apple SiliconまたはIntel向けのダウンロードを選びます。初回起動時は、システムの案内に従ってアプリの実行許可とネットワーク権限を設定してください。メイン画面が開いても、プロキシが通信を処理しているとは限りません。サブスクリプションの取り込み、サーバーの選択、システムプロキシの設定も必要です。

ダウンロードページへ →

Android

v2rayNG / v2flyNG

まずXrayコアを使用するv2rayNGを選び、V2Flyコアが必要な場合はv2flyNGを検討してください。デバイスのアーキテクチャに合わせてarm64または汎用パッケージを選びます。初回接続時は、システムのVPN接続許可を確認してください。バックグラウンドに移ると接続が切れる場合は、サブスクリプションを何度も取り込み直すのではなく、バッテリー最適化とバックグラウンド実行の権限を確認しましょう。

ダウンロードページへ →

Linux

v2rayN

ディストリビューションのパッケージ形式に合わせてdebまたはrpmを選び、x64とarm64も確認してください。インストール後は、まず通常のシステムプロキシで接続を確認し、必要に応じてTUNを設定します。デスクトップ環境や権限設定、アプリ側のプロキシ対応状況によって、通信を処理できる範囲は異なります。パッケージ形式だけではネットワーク設定は完了しません。

ダウンロードページへ →

3種類のクライアントの違いが分からない場合は、まずデバイスに合わせて候補を絞り、コアと設定方法を比較しましょう。デスクトップ用とAndroid用のパッケージを互換品として扱わないことが大切です。

設定ガイド

サブスクリプション、ルーティング、通信の処理

GUIクライアントでは、サーバー情報、コアの設定、システムネットワークとの連携をまとめて管理できますが、それぞれの役割は異なります。以下のテーマごとに、設定の適用範囲を確認しましょう。まず設定の取得元を整え、次にどの通信をコアへ渡すかを決め、最後に通信がどのアウトバウンドから出るかを確認します。

サブスクリプションの取り込み:設定の取得元とサーバー一覧を分けて考える

サブスクリプションはサーバー設定をまとめて取得するためのもので、接続成功を保証するものではありません。v2rayNの「サブスクリプショングループ設定」でURLを追加・保存して更新したら、一覧からサーバーを選んで有効にします。Androidでも、まずサブスクリプショングループを作成してください。サーバー情報を一つずつ手入力する方法と比べ、グループにまとめると更新や取得元の管理がしやすくなりますが、更新によって一覧の内容が置き換わる場合があります。サブスクリプションURLには認証情報が含まれることがあるため、スクリーンショットを共有する際はURL全体を隠してください。一覧が空の場合は、ルーティングやDNSをすぐ変更せず、更新結果とURLの有効性を確認しましょう。

サブスクリプショングループ設定 · 更新 · 使用するサーバーを選択

設定項目の名称は、クライアントのUI更新に伴って変わることがあります。通信の入口、ルール、アウトバウンドの関係を理解してから、現在の画面に合わせて操作してください。独自ルールの追加や名前解決経路の調整が必要な場合は、設定の詳細ガイドを章ごとに確認できます。

設定の詳細ガイドを読む →
クイックスタート

インストール後に行う3つの設定

初めて使うときは、すべてのオプションを有効にする前に、まず基本的な接続を一つ確立しましょう。以下では設定の取得元、通信の入口、接続の確認の順に進めます。各手順で変更する設定を一種類に絞ると、問題が起きても確認する箇所を特定しやすくなります。

  1. サブスクリプションを取り込み、使用するサーバーを選ぶ

    サブスクリプションURLまたはサーバー共有情報を用意します。デスクトップではサブスクリプショングループにURLを保存して更新します。Androidでもサブスクリプショングループ設定から同じ操作を行います。一覧に設定が表示されたら、その中から現在使用するサーバーを選びます。共有リンクを手動で取り込む場合は、プロトコル、アドレス、ポート、通信パラメーターがそろっていることを確認してください。名前が表示されるかどうかだけでは判断できません。

    サブスクリプションの更新は設定の取得、接続ボタンは現在の設定の起動を行います。別々に確認してください。更新に失敗した場合は、URLの期限が切れていないか、余分な空白が入っていないか、現在のネットワークから取得元へアクセスできるかを確認します。何度も取り込みを繰り返すより、具体的なエラーメッセージを記録するほうが原因の特定に役立ちます。認証情報を含むサブスクリプションURLを公開ページに投稿しないでください。

  2. ルーティング方式を選び、通信の入口を有効にする

    デスクトップでは、まずコアが起動することを確認し、必要に応じてシステムプロキシの自動設定を有効にします。Androidでは接続開始時に表示されるダイアログでVPN接続を許可してください。その後、用途に合ったルーティングモードを選びます。「全般」では通常、コアに渡された通信をプロキシ経由で送ります。「中国本土を迂回」では、対応するルールに従って一部の通信を直接接続します。実際の動作は現在のルールセットで確認してください。

    「全般」を選んでも、デバイス上のすべてのアプリが自動的にクライアント経由になるわけではありません。システムプロキシを使わないアプリには、別のプロキシ入口を設定するか、権限とルーティングへの影響を理解したうえでTUNを使う必要があります。初回テストでは、システムプロキシの設定が何度も書き換わるのを防ぐため、ほかのプロキシアプリを同時に使わないでください。LAN上のデバイスにアクセスできない場合は、まずプライベートアドレスが直接接続されるルールになっているか確認しましょう。

  3. 通信経路を確認し、動作する設定を保存する

    起動後、直接接続する想定の宛先とプロキシ経由の宛先にそれぞれアクセスし、ブラウザーや普段使うアプリの動作を確認します。接続アイコンの表示やポートテストの成功だけでは、一部の設定が正常だと分かるにすぎず、実際のアクセス確認の代わりにはなりません。特定のアプリだけが失敗する場合は、システムプロキシを使っているか確認してください。すべてのアクセスに失敗する場合は、使用中のサーバー、ログのエラー、DNSの名前解決経路を調べます。

    トラブルシューティングでは、一度に変更する項目を一つに絞り、変更前後の結果を記録してください。証明書エラーが出た場合は、検証を無効にせず、デバイスの時刻とサーバー名を確認します。ポートが使用中の場合は、別のクライアントが起動していないか確認しましょう。基本接続が安定したら設定をバックアップし、その後ルーティング、DNS、TUNを少しずつ追加します。問題が起きても、元に戻す地点が明確になります。

チュートリアルをすべて見る →

チュートリアルでは、デスクトップとAndroidの操作の違いを説明しています。用語が分からない場合は、まず用語早見表でサブスクリプション、ノード、インバウンド、アウトバウンドを確認してから設定を進めてください。

オープンソース・エコシステム

Project V、コア、GUIクライアント

V2Ray関連の名称は、ダウンロードや設定の説明で同時に登場することがよくあります。プロジェクトの背景、通信を処理するコア、操作を担うクライアントを区別すると、同じサブスクリプションでもデバイスごとに設定確認が必要な理由が分かります。

Project V:エコシステムの名称とプロジェクトの沿革

Project Vは、ネットワーク通信ツールを中心に形成されたオープンソース・エコシステムの背景を指し、V2Rayはその中で広く使われている主要プロジェクトの名称です。V2FlyコミュニティはV2Rayの開発と保守を引き継ぎ、Xrayは関連するコードや技術を基に発展した別系統のコアです。歴史や設定の考え方に共通点はありますが、その後の機能開発はそれぞれ異なるため、名称が似ているからといってすべての設定項目に互換性があるとは限りません。

実際には、ユーザーはすべてのコア設定を直接編集するのではなく、通常GUIクライアントでサブスクリプション、サーバー、ルーティングを管理します。そのため「V2Rayをダウンロード」という表現は、GUIクライアントを指す場合も、コアそのものを指す場合もあります。このサイトではv2rayN、v2rayNG、v2flyNGを中心にダウンロード先を案内しています。まずデバイスに合ったクライアントを選び、その後サーバーのパラメーターに応じて必要なコアを確認すると、手順が分かりやすくなります。

コアの系統:設定が似ていても対応機能の確認が必要

コアは設定の読み込み、接続の確立、ルーティング、関連する名前解決の処理を担当し、クライアントのUIはユーザーの選択を実行可能な設定に変換します。XrayとV2Flyはいずれもこの実行層に属しますが、プロトコル拡張、通信パラメーター、各設定項目は、それぞれの対応範囲に沿って確認する必要があります。共有リンクを取り込めても、現在のコアが必要な機能をすべて備えているとは限りません。判断の際は起動ログも重要です。

v2rayNGはXrayコアをベースとし、v2flyNGはV2Flyコアを使用します。デスクトップ版v2rayNでは、対応するコアの設定と管理ができます。選択時は特定のコアをあらゆる用途に使える固定の答えと考えず、既存サーバーのプロトコル、通信方式、安全性に関するパラメーターを基準にしてください。コアを切り替える前に動作中の設定を保存し、切り替え後は起動結果と実際のアクセスを確認してから、ルーティングやDNSを調整しましょう。

オープンソースライセンス:コードと利用条件を確認する

v2rayN、v2rayNG、v2flyNGはいずれもオープンソースのGUIクライアントです。オープンソースとは、各ライセンスの条件に従ってソースコードを閲覧、研究、変更できることを意味し、異なるプロジェクトのコードを無条件に流用できるという意味ではありません。クライアント、コア、依存コンポーネントでは、異なるライセンスが適用される場合があります。再配布、変更、組み込みを行う際は、「オープンソース」という一言で利用条件を判断せず、各プロジェクトに付属するライセンスと著作権表示を個別に確認してください。

一般ユーザーにとって、オープンソース・エコシステムの大きな利点は、設定の仕組みを議論できること、ログや具体的な手順を使って問題を再現できること、実際の設定項目に沿ってドキュメントを改善できることです。クライアント自体に、そのまま使えるサーバー情報は含まれていません。インストール後は、既存のサブスクリプションまたはサーバー設定が必要です。ソフトウェアのライセンス、接続サービスの提供元、ネットワークの利用権限はそれぞれ別の問題です。個別に確認し、利用が許可されたネットワーク環境で適切に使用してください。

プラットフォームとコアで3つのクライアントを比較 →
クライアントと実行層を分けて理解する
GUIクライアント
サブスクリプション管理、設定編集、システム連携
コア
プロトコル処理、ルーティング、接続の確立
ライセンス
閲覧、変更、再配布の条件

名称が似ていても同じプロジェクトとは限らず、UIが似ていても設定が完全に互換とは限りません。

更新の仕組み:クライアント、コア、ルールを分けて管理

クライアントの更新は主にUI、設定管理、システム連携に影響します。コアの更新ではプロトコル対応やパラメーター処理が変わる可能性があり、ルールリソースの更新はドメインやアドレスの分類に影響します。サブスクリプションの更新は別の仕組みで、サーバー設定を取得するものです。問題を調べるときはこれらの更新を区別すると、変更がどの層に影響したかを判断できます。サブスクリプション一覧が正常に更新されても、ローカルのルールリソースやコア設定が同期されたとは限りません。

更新前にサブスクリプショングループ、カスタムルーティング、DNS設定をバックアップし、現在動作している通信の処理方法を記録しておきましょう。更新後はまず元の設定を検証し、それから新しい設定を試します。以前のルールが一致しなくなった場合は、UIの変化だけを見るのではなく、ルールリソース、照合順序、アウトバウンドのタグを確認してください。ダウンロードページにはインストール先とバージョン情報をまとめ、トップページからはプラットフォーム別に探せます。起動失敗、接続タイムアウト、ルール読み込みエラーが発生した場合は、ブログのログ解析記事を参考に原因を調べてください。

サブスクリプション、ルーティング、DNSの詳細設定を見る →
ブログ・トラブル対処

実行ログの確認からクライアント選びまで

基本チュートリアルでは初回接続を、個別記事では具体的な問題を扱います。異常が起きたら、OS、クライアント名、現在の通信処理方法、関連するログを一つ記録してから、問題の種類に応じた記事を確認しましょう。ログを共有する前に、サーバーアドレス、サブスクリプション情報、認証情報を隠してください。

トラブル対処

V2Rayの実行ログの読み方:よくあるエラーの意味と原因の調べ方

ログレベルとログ行の構成を解説し、接続タイムアウト、証明書検証の失敗、ポートの競合、ルールファイルの欠落など、よくあるエラーを読み解きます。エラーが発生した段階から、問題がローカルの起動、名前解決、リモート接続のどこにあるかを判断し、関係する設定を確認します。無関係な項目を繰り返し変更する必要はありません。

記事を読む →
トラブル対処

v2rayNが起動直後に落ちる・起動時にクラッシュする場合:.NETランタイム、フォルダーの権限、設定ファイルを確認

起動に失敗する主な原因を、発生頻度に沿って整理します。ランタイムの不足、展開先フォルダーの保護、設定ファイルの破損、Androidでシステムが権限を取り消すケースなどです。メイン画面が開かない場合とコアが起動しない場合を切り分け、インストール環境と接続設定のどちらを調べるか判断しましょう。元の設定を保存してから、一つずつ対応してください。

記事を読む →
エコシステム

Project Vのエコシステムを解説:V2Fly、Xrayコア、v2rayN・v2rayNGの関係と沿革

Project Vの起源、V2Flyコミュニティによる開発・保守の継続、Xray系統の発展を整理し、3つのGUIクライアントとコアの関係を解説します。プロジェクト名、プロトコル名、アプリ名を区別し、デバイスのプラットフォームと既存設定を踏まえて選びましょう。エコシステム内の関係をインストール手順と混同しないことが大切です。

記事を読む →
すべての記事を見る →

設定の問題をすぐに調べたい場合はよくある質問をご覧ください。サブスクリプショングループ、ルーティングルール、名前解決の設定を章ごとに見直す場合は、設定の詳細ガイドをお読みください。