クライアントのダウンロード・設定ガイド

V2Rayドキュメントv2rayN 設定ガイド

まずサブスクリプションを追加し、OSに合ったクライアントを選びます。続いてルーティングとDNS設定を確認しましょう。

OS別ダウンロード

サブスクリプション → ルール → アウトバウンド

サブスクリプション管理とルーティング設定

クライアントは設定を管理し、コアは接続を処理します。まず接続を1つ正常に動かし、ルールを少しずつ追加しましょう。変更の影響範囲が明確になり、問題の切り分けも容易になります。

サブスクリプション管理 · 構成イメージ
  • サブスクリプション管理
    • 普段使い 更新を有効化
    • 予備設定 個別に管理
サーバーの絞り込み備考のキーワードで検索

グループ分けしてから更新

複数のサブスクリプションを同じリストで管理すると、サーバーの提供元が分かりにくくなります。v2rayNで提供元ごとにグループを作成し、サブスクリプションURLを登録してから更新しましょう。リストを絞り込むには、備考のキーワードで検索します。フィルターは表示範囲を変えるだけで、配信元のサブスクリプション内容は変更しません。更新前にグループと選択中の項目を確認し、更新後はログをチェックして、リストが空になった状態を接続エラーと取り違えないようにしましょう。共有リンクを1件ずつ貼り付けるより、グループ管理のほうがまとめて更新・復元しやすくなります。

サブスクリプションURLは設定を取得するための情報です。機密情報として取り扱ってください。 マニュアルの該当箇所を見る →

OSに合ったインストーラーを選ぶ

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

デスクトップではv2rayN、Androidではv2rayNGをまず確認しましょう。インストーラーのCPUアーキテクチャは、デバイスに合わせて選んでください。同じクライアントでも画面やパッケージ形式が異なるだけで、サブスクリプションを買い直したり変更したりする必要はありません。

Windows

v2rayN(おすすめ)

v2rayNにはデスクトップ版と従来のWPF版があります。デスクトップ版はクロスプラットフォーム対応のUIを採用し、WPF版はおなじみの操作画面を引き継いでいます。使い慣れた操作方法を基準に選び、それぞれの動作要件を確認してください。

更新前にサブスクリプションのグループとカスタムルーティングを保存してください。起動時に問題が起きた場合は、実行環境と展開先を先に確認し、設定ファイルを何度も上書きしないようにしましょう。

macOS

v2rayN

まずシステムの「このMacについて」でチップ情報を確認し、Apple SiliconまたはIntelに対応するv2rayNのインストーラーを選びます。どちらのアーキテクチャでも設定手順はほぼ同じで、主な違いは実行環境です。

インストール後、システムが求めるアクセス許可を設定してから、システムプロキシをテストしましょう。ほかのプロキシツールを使っている場合は、設定が競合しないよう先に終了してください。

Android

v2rayNG(おすすめ)

v2rayNGはXrayコアを採用しており、Android向けの第一候補として使えます。V2Flyコアが必要な場合はv2flyNGを確認してください。近年の多くの端末ではarm64を選べます。アーキテクチャが分からない場合は、汎用版も検討しましょう。

初回接続時にVPNの使用許可が必要です。クライアントを切り替える前に現在の接続を切り、システムのバックグラウンド制限も確認してください。アクセス許可やスリープの問題をサーバー障害と取り違えないようにしましょう。

Linux

v2rayN

ディストリビューションに合わせてdebまたはrpmを選び、x64またはarm64のアーキテクチャを確認してください。まずデスクトップ画面でサブスクリプションを追加して接続テストを行い、基本設定が有効だと確認してから仮想ネットワークインターフェースの設定を検討しましょう。

デスクトップのシステムプロキシと、ターミナルの環境変数は別々の接続経路です。ブラウザーでは正常でもコマンドラインで問題が起きる場合は、それぞれ個別に確認しましょう。クライアントの再インストールやサブスクリプションの変更を急ぐ必要はありません。

初期設定の手順

v2rayNでサブスクリプションを追加して接続

まずは、確認しやすい基本状態を3つの手順で作ります。デスクトップではv2rayN、Androidではv2rayNGを使います。メニュー名が異なる場合でも、設定を追加し、接続経路を選び、結果を確認する順序は同じです。

  1. グループを作成してサブスクリプションを追加

    サブスクリプション設定でグループを追加し、提供元が分かる名前を付けて、サブスクリプションURLを省略せずに貼り付けてから更新します。共有リンクは通常、単一サーバーの設定を表しますが、サブスクリプションURLは複数の設定をまとめて取得するためのものです。URLの長さだけで形式を判断しないでください。追加後はサーバー一覧と更新ログを確認し、余分な空白やURLの欠落がないか、WebページのURLをサブスクリプションURLと取り違えていないかを確かめましょう。

    サブスクリプションには通常、接続情報が含まれます。問題を相談するときは、機密情報を削除したエラーメッセージだけを共有し、URL全体やQRコードを公開しないでください。

  2. サーバーを選び、接続経路を有効にする

    サーバー設定を1つ選び、まずは分かりやすい基本ルーティングを使います。v2rayNではシステムプロキシを有効にして、その設定に従うブラウザーをクライアント経由にします。v2rayNGでは接続を開始し、システムの許可を確認してください。複数のプロキシツールを同時に有効にしたり、TUN、DNS、ルーティングを一度に変更したりするのは避けましょう。問題が起きたときに原因を特定しにくくなります。

    「クライアントが起動中」は、プログラムが実行されていることを示すだけです。すべてのアプリがプロキシを使っているとは限らないため、接続経路の設定を別途確認してください。

  3. Webページ、ログ、直接接続を確認

    まず普段使うWebサイトにアクセスし、クライアントのログで接続エラーや名前解決エラーがないか確認します。LAN内のデバイスにアクセスできることも確かめましょう。特定のアプリだけで問題が起きる場合は、そのアプリがシステムプロキシに従うかを確認します。すべてのリクエストが失敗する場合は、サブスクリプションの有効性、サーバー設定、ネットワーク状態を順に見直してください。接続テストに成功してから、ルーティングルールを1つずつ追加し、変更内容を記録しましょう。

    使い終わったら、不要になったシステムプロキシ設定を元に戻しましょう。クライアント終了後もアプリが停止済みのローカルポートへ接続し続けるのを防げます。

Project V · V2Fly · Xray

V2Rayのコアとオープンソースクライアント

クライアントを選ぶ際は、3つの層を区別しましょう。プロトコルは通信方式を定義し、コアは接続とルーティングを処理し、GUIクライアントはそれらを操作しやすい画面にまとめます。名称が似ていても、機能や設定形式が同じとは限りません。

プロジェクトの背景

Project V

V2Rayのプロジェクト構成とモジュール設計

V2Fly

コミュニティがメンテナンスするV2Rayコア

v2flyNG

Xray

V2Rayから派生した独立系コア

v2rayNG

v2rayNでは複数のコアを管理できます。実際の対応範囲は、選択したコアと設定によって異なります。

Project Vのモジュール設計の背景

V2RayはProject Vのネットワークプロキシツールで、設定ではインバウンド、アウトバウンド、ルーティング、DNSなどの機能を分けて構成します。GUIクライアントではよく使う設定がメニューにまとめられていますが、各機能の役割は変わりません。この構造を理解すれば、「アプリがローカルの接続口に到達していない」のか、「コアに届いたリクエストが誤ったアウトバウンドに振り分けられた」のかを区別できます。接続の問題をすべてサーバー障害と決めつけずに済みます。

V2FlyとXrayの関係

V2FlyはV2Rayのコミュニティによるメンテナンスを引き継ぎ、XrayはV2Rayから派生して独自の方向へ発展しました。共通の概念や歴史的な背景はありますが、対応プロトコル、設定項目、既定の動作は異なる場合があります。プロトコル名だけで判断せず、通信方式やセキュリティ設定、コアの対応状況も確認してください。一方のコア向けの完全な設定が、もう一方でもそのまま使えるとは限りません。

3つのクライアントのオープンソース性

v2rayN、v2rayNG、v2flyNGはいずれもオープンソースのGUIクライアントです。v2rayNはデスクトップでの利用と設定管理を想定し、v2rayNGとv2flyNGはAndroid向けで、それぞれ異なるコアを採用しています。ソフトウェアの利用、改変、再配布の条件は各プロジェクトのライセンスで確認してください。クライアントのソースコードが公開されていても、サーバー運営者、サブスクリプションサービス、クライアントの開発プロジェクトが同じ運営元とは限りません。

クライアントの更新とサブスクリプションの更新

クライアントの更新はプログラムを新しくすること、サブスクリプションの更新はサーバー設定を再取得することです。それぞれ解決する問題が異なります。プロトコルへの対応状況に問題がある場合は、クライアントとコアを確認しましょう。サブスクリプションの項目に変更がある場合は、まず更新履歴を確認します。更新前にカスタムルールを保存し、更新後はシステムプロキシとアクセス許可を見直してください。画面に新しい項目が表示されたからといって、すべて有効にする必要はありません。安定した設定には、各スイッチの用途を説明できることが大切です。

クライアントにサーバーは付属していません。インストール後、利用権限のある設定を追加する必要があります。サブスクリプションの有効期限やサービス内容、アカウントの状態は、提供元によって異なります。当サイトではクライアントの操作方法や設定の考え方を解説しています。選ぶ前に3つのクライアントを比較し、用語が分からない場合は用語集をご覧ください。

設定ガイドとトラブル対処

V2Rayクライアントの使い方

基本設定が済んだら、具体的な症状に合った記事を確認しましょう。起動エラー、システムプロキシの不具合、コアの選び方は、それぞれ別の問題です。まず問題がどの層で起きているかを確認し、該当する手順で切り分けましょう。設定を一度にすべて変更するより、原因を特定しやすくなります。

トラブル対処

v2rayN・v2rayNGが起動時にクラッシュする場合の対処法:ランタイム不足と権限の確認

デスクトップ版のクラッシュは、.NETランタイムや展開先のパス、管理者権限が原因の場合があります。Android版ではVPNの使用許可やバックグラウンド制限を確認してください。OSごとに起動環境をチェックし、必要に応じて権限を調整しましょう。原因が分からないまま何度も再インストールするのは避けてください。

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

v2rayNのシステムプロキシが機能しないときの対処法:ブラウザーとターミナルを分けて確認

接続済みなのにWebページを開けない場合は、ブラウザーの拡張機能とシステムプロキシ、ターミナルの環境変数を分けて確認しましょう。PACモード、例外リスト、ポートの競合を調べる順序を解説し、アプリの接続経路の問題と接続自体の問題を切り分けます。

記事を読む →