デスクトップ・Android · 初期設定

v2rayNのダウンロードとサブスクリプション設定

サブスクリプション設定、システムプロキシ、ルーティングの順に進めます。クライアントのインストールから始め、接続設定を一つずつ確認しましょう。

オープンソースクライアント GUIで設定 日本語の操作ガイド
OSを選んでダウンロード先を確認
クライアントのダウンロード

OSに合わせてインストーラーを選ぶ

OSとプロセッサーのアーキテクチャを確認してから、適切な形式を選びましょう。デスクトップではv2rayN、Androidではv2rayNGが主な選択肢です。V2Flyコアが必要な場合は、v2flyNGも検討してください。

Windows

v2rayN · デスクトップ向け

デスクトップ版にはクロスプラットフォームのGUIがあり、従来のWPF版ではおなじみのWindows操作を利用できます。どちらもサーバー設定、サブスクリプショングループ、ルーティングルールを管理できます。両方を同時にインストールする必要はありません。初めて設定する場合は、まず一方を選んで接続を確認し、必要に応じて移行を検討しましょう。

インストール前にシステム要件を確認してください。クライアントが起動直後に終了する場合は、対象ビルドの実行環境と、インストール先への書き込み権限を確認します。設定を失わないよう、一時的な展開先に設定フォルダーを置かないでください。アップデートやファイルの整理で設定が消えるおそれがあります。既存の設定はバックアップしてから更新しましょう。

ダウンロードページへ

macOS

v2rayN · チップに合うパッケージを選択

「このMacについて」でチップを確認します。Apple Siliconならarm64、Intelプロセッサーならx64を選択してください。パッケージはアーキテクチャごとに異なりますが、サブスクリプション設定の基本手順は同じです。インストール後にクライアントを起動してからサブスクリプションを追加します。インストールが完了しただけでは、接続は確立されません。

初回起動時はシステムの警告を確認し、アプリの入手元を確かめたうえで、macOSの案内に従って許可してください。ブラウザーが従来の接続を使い続ける場合は、現在のネットワークサービスのプロキシ設定とブラウザー拡張機能を確認します。システムプロキシ、クライアントのルーティング、アプリ独自のプロキシ設定は別々に確認が必要です。

ダウンロードページへ

Android

v2rayNG · Xrayコア

Androidではv2rayNGが主な選択肢です。V2Flyコアが必要な場合は、代替クライアントのv2flyNGを確認してください。比較的新しい一般的なスマートフォンはarm64を使います。アーキテクチャがわからない場合は端末情報を確認するか、ダウンロードページの汎用パッケージを選びましょう。アプリ名だけで両クライアントのプロトコル対応が同じだと判断しないでください。

サブスクリプションをインポートした後は、グループを更新し、設定を選んでサービスを起動します。初回起動時には、システムVPNの使用許可が必要です。この許可は端末上の通信をクライアント経由にするためのもので、接続先サーバーを提供するものではありません。バックグラウンドで接続が切れる場合は、プロトコルの設定を何度も変える前に、バッテリー最適化とバックグラウンド実行の制限を確認してください。

ダウンロードページへ

Linux

v2rayN · ディストリビューションに合わせて選ぶ

ディストリビューションのパッケージ形式に合わせてdebまたはrpmを選び、デバイスのアーキテクチャがx64かarm64かも確認してください。パッケージ形式とプロセッサーのアーキテクチャの両方を合わせる必要があります。デスクトップ環境によってシステムプロキシの設定場所も異なります。インストール後は、クライアントが正常に起動し、設定を読み込めることを確認しましょう。

ブラウザーは通常、デスクトップ環境のプロキシ設定を利用できますが、ターミナルのプログラムが自動的に従うとは限りません。ブラウザーではアクセスできるのにコマンドラインでは失敗する場合は、サーバーを切り替える前に、プログラムのプロキシ対応と環境変数を確認してください。より多くのアプリの通信を制御する必要がある場合は、TUNモードの権限とルーティングについて確認しましょう。

ダウンロードページへ

クライアントのダウンロード、リモートサーバー、サブスクリプションはそれぞれ別のものです。インストーラーが提供するのは端末上で使うツールのみです。接続に必要なサーバーアドレス、認証情報、通信パラメーターは、利用者が適法に入手し、安全に管理してください。

クライアント一覧を見る
設定手順と主な機能

サブスクリプション管理からルーティングまで

まず一つの設定で正常に接続できることを確認し、その後プロキシの適用範囲を調整しましょう。以下は設定画面の例です。メニュー名や項目の位置はクライアントやコアによって異なる場合があるため、実際の画面を確認してください。

サブスクリプショングループの設定 · 画面例
グループ名
日常の設定
サブスクリプションURL
サービス提供元の完全なURLを貼り付け
更新方法
現在のサブスクリプションを更新(プロキシを経由しない)
URLを保存した後、サブスクリプションの更新が必要です

サブスクリプションを使うと、サーバー設定をまとめて取得・更新できます。パラメーターを定期的に同期する場合に便利です。v2rayNではサブスクリプショングループを追加し、名前と完全なURLを入力して保存した後、現在のサブスクリプションを更新します。Androidでも、サブスクリプショングループと個別リンクのインポートは別の操作です。グループのURLを登録しただけでは、利用可能なサーバーにはなりません。内容を正常に取得する必要があります。初回設定では、まずプロキシを経由せずに更新してみてください。失敗した場合は、URL、ネットワーク、ログを確認します。更新前に手動設定を残し、画面を共有する際はURLに含まれる認証情報を隠してください。

サブスクリプションの設定手順を見る

接続確認:設定は一度に一つだけ変更

サブスクリプションを更新したら、まず設定を一つ選んでコアを起動します。ログに設定の解析エラーやポートの競合がないことを確認してから、システムプロキシを有効にします。プロキシに対応したブラウザーで、接続先を明確にしたテストを行い、直接接続できるサイトやローカルネットワークの機器も確認してください。テスト結果は何を検証したかに応じて判断します。サブスクリプションを更新できても、確認できるのはURLにアクセスできることだけです。コアが起動しても、確認できるのは設定を読み込めたことだけです。ブラウザーでアクセスできても、すべてのアプリがプロキシを使っているとは限りません。

失敗した場合は、直前に変更した項目とエラーを記録し、まず最後の変更を元に戻してください。コアの切り替え、TUNの有効化、DNSの変更、ルーティングの書き換えを一度に行うと、どの変更が影響したのか判断しにくくなります。システムプロキシを使わないプログラムの通信も制御したい場合は、詳しいガイドでTUNの使い方を確認しましょう。一般的なブラウザーの利用なら、まずシステムプロキシから試せます。

段階別に詳しいガイドを読む
Project Vのエコシステムとメンテナンス

クライアント・コア・サービスの違い

ソフトウェア名を一つ覚えるより、この三つの関係を理解するほうが役立ちます。クライアントのダウンロードで端末上の操作環境を用意し、コアの選択で設定との互換性を確かめます。接続先のサービスによって、接続パラメーターの入手元が決まります。

Project V V2Fly Xray

Project V:まずエコシステムを知る

Project Vは、ネットワークプロキシツールを中心とするオープンソースのエコシステムで、V2Rayはその中でも広く知られたプロジェクトです。検索で使われる「V2Ray」は、コアを指す場合もあれば、互換性のある設定や一連の利用方法を指す場合もあります。その言葉だけで、どのインストーラーをダウンロードすべきか判断することはできません。GUIクライアントを使うと、低レベルの設定をメニューやグループ、スイッチで管理できます。ただし、プロトコル、通信方式、認証情報は接続先に合わせて正しく設定する必要があります。

本サイトでは、インストールと接続を分けて解説します。まずデバイスに合ったGUIクライアントを選び、次にサブスクリプションから取得できるパラメーターを説明し、最後にシステムプロキシとルーティングがアプリの通信に与える影響を紹介します。この順番なら問題の箇所を特定しやすく、「クライアントが起動している」ことを「すべての通信が想定どおりに転送されている」ことと取り違えずに済みます。

V2FlyとXray:関連するプロジェクト、それぞれの特徴

V2FlyコミュニティはV2Rayの保守と開発を引き継いでいます。Xrayは関連コードをもとに開発され、独自の機能を継続的に追加しています。技術的な背景の一部は共通していますが、プロトコル拡張、設定項目、更新のペースには違いがあります。VMess、VLESS、Trojanはそれぞれ異なるプロトコルです。REALITYは接続のセキュリティ層に関わる仕組みであり、これらを自由に置き換えられるスイッチのように考えてはいけません。

設定を選ぶときは、提供元が指定するプロトコル、通信方式、コアの対応状況を確認し、TLSのサーバー名などの項目も確認します。あるコアで使える機能が、別のコアでも自動的に使えるとは限りません。古いガイドに記載された初期値が、現在のビルドに適しているとも限りません。見慣れないパラメーターがある場合は、名前が似ているからといって書き換えず、元の設定を保管して対応する説明を確認してください。

3つのオープンソースクライアント:それぞれの特徴

v2rayNはデスクトップ向けで、サーバー管理、サブスクリプショングループ、システムプロキシ、ルーティングなどをGUIから設定できます。クロスプラットフォーム版と従来のインターフェースでは操作場所が異なる場合がありますが、まず設定をインポートし、次にコアとプロキシの適用範囲を確認する流れは共通です。デスクトップではローカルの待受ポートと終了後のシステムプロキシの状態に注意してください。ポートを変更した場合は、そのポートを利用するアプリの設定も変更します。

v2rayNGはAndroid向けで、Xrayコアを採用しています。クリップボード、QRコード、サブスクリプショングループなどから設定をインポートできます。AndroidではシステムVPNを通じて通信を制御するため、許可の確認、アプリごとのプロキシ設定、バックグラウンド実行の設定が動作に影響する場合があります。QRコードは設定情報を受け渡す方法の一つです。読み取りに成功しても、接続先の設定が有効とは限らず、サブスクリプションの更新が完了したとも限りません。

v2flyNGはV2Flyコアを採用したAndroid向けの代替クライアントです。対応するコアの挙動や設定との互換性が必要な場合に適しています。複数のクライアントを同時に起動して問題を調べるのではなく、実際の設定要件に基づいて選んでください。通常、システムで同時に有効にできるVPNサービスは一つです。クライアントを切り替える前に現在の接続を停止し、新しいクライアントでインポート内容とプロキシの適用範囲を確認しましょう。

オープンソースライセンス:コードと利用条件

3つのクライアントはいずれもオープンソースとしてコードを公開しています。v2rayNはGPL-3.0、v2rayNGとv2flyNGはGPL-3.0系のライセンスを採用しています。V2FlyとXrayのコアはMPL-2.0を採用しています。利用、改変、再配布に伴う義務は、使用するビルドに含まれるライセンスと依存関係の説明を確認してください。クライアント、コア、同梱コンポーネントをすべて同一のライセンスとして扱うことはできません。

ソースコードが公開されているということは、実装を読んで検討できるという意味であり、すべての接続先サービスが信頼できるという意味ではありません。サブスクリプションURLに認証情報が含まれている場合があり、ログからサーバー情報がわかることもあります。相談時は必要なエラー情報だけを残し、認証情報、サブスクリプションURL、個人情報を隠してください。クライアントがオープンソースであることと、サービス提供元の事業内容は別々に判断する必要があります。

更新の進め方:バックアップしてから確認

クライアント、コア、ルーティング用リソース、サブスクリプションには、それぞれ異なる更新元と更新ペースがあります。サブスクリプションの更新は接続先の設定を同期するもので、クライアントのアップデートに代わるものではありません。クライアントを更新しても、サブスクリプションURLが引き続き有効とは限りません。接続に問題が起きたら、まず最近どの層が変わったかを確認してから、更新するか判断します。アップグレード前には、現在のプロキシモード、ルーティング、独自のポートを記録して設定をバックアップし、多数の設定変更とアップグレードを同時に行わないようにしましょう。

コミュニティによるメンテナンスでは、機能の変更や不具合の修正に加え、メニュー名や初期動作が変わることもあります。そのため、このガイドではボタンの固定位置ではなく、操作の目的を中心に説明します。更新後はまず正常に起動するかを確認し、普段使うアプリと直接接続先の両方をテストしてください。新しい設定が安定したことを確かめてから、古いバックアップを整理します。問題が続く場合は、ログを設定解析、DNS、接続確立、TLSのエラーに分けて調べましょう。

サイトの掲載内容について
技術ノート · 最近の更新

症状から対処手順を探す

基本設定を終えた後に具体的な問題が起きた場合は、該当する症状からノートを確認してください。まずエラーメッセージを保存し、端末側から接続先に向かって範囲を絞ります。あらゆる接続失敗を一つの設定のせいにしないようにしましょう。

システムプロキシを設定しても効かない:ブラウザー拡張機能とターミナルの環境変数を個別に確認

ブラウザーではプロキシ拡張機能とシステムプロキシを確認し、ターミナルではhttp_proxy、https_proxy環境変数を確認します。コマンドラインのプログラムが標準ではシステムプロキシを使わない理由も解説します。

ブラウザーとコマンドラインでアクセス結果が異なる場合に役立ちます。まずプログラムがどのプロキシ設定を読み込むか確認し、次にローカルポートを調べることで、不要なサーバーの切り替えを減らせます。

ノートを読む

FakeDNSの仕組み:仮想IPとドメイン振り分けの連携、利用に適したケース

FakeDNSが予約済みアドレスを返してドメインとの対応を保持する仕組みを解説します。TUNモードやドメインルーティングでの役割、直接接続するアプリと競合した場合の選び方も紹介します。

まず名前解決と接続の二つの段階を理解してから、有効にする必要があるか判断してください。基本設定で正常に動作している場合は、アドレス対応の仕組みを理解したうえで、一つずつテストできます。

ノートを読む

v2rayNの起動直後のクラッシュ・v2rayNGがすぐ終了する問題:ランタイム、権限、設定のリセット方法

デスクトップでは.NET Desktop Runtime、フォルダーへの書き込み権限、破損した設定ファイルを確認します。AndroidではVPNの許可とアプリデータを確認し、順番に試せる対処手順を紹介します。

まずクライアントのプロセスが終了する問題と、サービスの起動に失敗する問題を区別してください。設定をバックアップしてから、実行環境やアプリデータを順に確認します。リセットで手動入力した情報を失わないよう注意しましょう。

ノートを読む