設定入門デスクトップ・Androidクライアントガイド

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

サブスクリプションの追加からシステムプロキシ、ルーティングまで、順番に設定します。

オープンソース複数コアに対応日本語の操作ガイド

クライアントの5つの設定項目

まず接続情報を追加し、どのアプリの通信をプロキシ経由にするか決めます。以下の設定画面は各項目の説明用で、Webページ上で操作できるクライアントではありません。

サブスクリプションURLは一度保存してから更新

サブスクリプションは、変更される可能性がある複数の接続設定をまとめて管理するのに便利です。v2rayNのサブスクリプショングループ設定でメモと完全なURLを入力して保存し、サブスクリプションを更新します。クライアントがURLから取得した内容を読み込み、サーバー項目を作成します。共有リンクを1件ずつ貼り付ける方法と異なり、サブスクリプションなら後から更新できます。ただし、URL自体は接続パラメーターではないため、保存しただけでは接続できません。更新後、グループに有効な項目が追加されたことを確認し、使用する設定を選択してください。何も表示されない場合は、URLの有効期限、返された内容が設定データかどうか、更新リクエストが現在のプロキシ設定の影響を受けていないかを確認します。

  • メモは登録元を区別するために使います。用途がわかる名前を付けましょう。
  • スクリーンショットを共有したり相談したりする前に、URL全体と認証情報を隠してください。
  • 更新に失敗した場合は、元の設定を残してからリクエストの経路を確認します。
サブスクリプショングループの設定
メモ普段使い
URLhttps://example.com/your-sub

URLは形式を示す例です。有効なサブスクリプションを使用してください。

サブスクリプションを更新(プロキシを使用しない)

5つの設定項目はそれぞれ役割が異なります。サブスクリプションと共有リンクは設定を取り込み、システムプロキシとTUNはアプリの通信をクライアントに渡し、ルーティングは出力先を選び、コアは実際の接続を処理します。この順に確認すれば、複数のスイッチを同時に切り替えるより原因を特定しやすくなります。インポートに成功したのはクライアントが設定を読み取れたという意味で、サーバーに接続できるとは限りません。ブラウザーでWebページを開けても、ほかのアプリが同じ経路を使っているとは限りません。

用語に慣れていない場合は、まず初期設定を保ったまま、最小限の構成で接続を確認しましょう。接続が安定して再現できてから、ドメインの例外や別の接続方法を追加します。一度に変更するのは1項目だけにし、変更前後の状態を記録してください。用語を確認する場合は用語解説を、プラットフォームごとの権限やインストール方法を確認する場合は使い方ガイドをご覧ください。初回起動時にすべての項目を読む必要はありません。

OSに合わせてクライアントを選択

デスクトップではv2rayN、Androidではまずv2rayNGを検討してください。ダウンロードページでは、CPUアーキテクチャとインストーラーの種類も確認できます。

Windows

v2rayN · デスクトップ版 / WPF版

デスクトップ版はクロスプラットフォームのGUIを採用し、WPF版は従来型のデスクトップ操作に対応しています。初めてインストールする場合は、画面の違いとシステム要件を確認しましょう。同じサブスクリプションを使うために両方をインストールする必要はありません。設定項目の場所は画面ごとに異なる場合があるため、機能名を手がかりに探してください。

ダウンロード前にシステム情報でCPUの種類を確認し、インストール後は書き込み権限があり管理しやすい場所に設定を保存してください。実行環境が不足していると表示された場合は、インストールガイドに従って必要なコンポーネントを追加してから、サブスクリプションを登録します。

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

macOS

v2rayN · デスクトップ版

「このMacについて」でチップ情報を確認し、Apple SiliconまたはIntelに合ったインストーラーを選んでください。アーキテクチャの選択はプログラムを実行できるかどうかに関わるもので、サブスクリプションのプロトコルとは別の問題です。

初回起動時は、システムの案内に従ってアプリの権限を設定してください。システムプロキシが使えることを確認してから、必要に応じてTUNを検討します。ネットワーク拡張や管理者の許可が必要な場合は、他のデスクトップOSの手順をそのまま使わず、プラットフォーム別の説明を確認してください。

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

Android

v2rayNGを優先 · v2flyNGは代替候補

v2rayNGはXrayコアを使用し、v2flyNGではV2Flyコアを選べます。一般的な端末ではarm64版を選べます。アーキテクチャが不明な場合は、ダウンロードページの説明を確認してから汎用版を選ぶか判断してください。インストーラーのアーキテクチャとコアの種類は、それぞれ別に検討します。

サブスクリプションを追加したら、使用する設定を選び、接続時にシステムのVPN許可を確認してください。バックグラウンドに移ると接続が切れる場合は、バッテリー管理とバックグラウンド実行の制限を確認します。別のネットワークツールが接続中の場合は、システムの接続競合を先に解消してください。

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

Linux

v2rayN · deb / rpm

ディストリビューションのパッケージ管理方式に合わせてdebまたはrpmを選び、デバイスがx64かarm64か確認してください。GUIが似ていても、デスクトップ環境が同じとは限りません。システムプロキシがアプリに反映されるかどうかは、アプリ自体とデスクトップセッションの実装にも左右されます。

まず通常ユーザーの環境で起動とサブスクリプションの追加を確認し、その後、TUNに必要な追加権限を設定します。ブラウザーとほかのプログラムの動作が異なる場合は、それぞれのプロキシ設定を確認してください。デスクトップのプロキシ設定がすべてのプロセスに共通するとは限りません。

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

クライアントをダウンロードしても、接続設定が自動で追加されるわけではありません。事前に有効なサブスクリプションURLまたは共有リンクを用意し、配布元と利用条件を確認してください。別のデバイスに設定を移行した場合も、プロキシの状態、システムの許可、バックグラウンド実行の権限は改めて確認が必要です。

すべてのクライアントを見る →

初回設定の3ステップ

設定の読み込みを確認し、次にアプリがプロキシを使うか確認して、最後にルーティングを検証します。各段階で確認できる結果を一つずつ残しましょう。

  1. サブスクリプションまたは共有リンクを追加

    まず、受け取ったテキストの種類を確認してください。サブスクリプションURLは通常、サブスクリプショングループに登録してから更新します。個別の共有リンクはクリップボードまたはQRコードから追加します。Webページの説明用URLをサブスクリプションとして登録したり、チャットの文章全体をURL欄に貼り付けたりしないでください。

    更新後、グループに設定が追加されたか、メモが想定どおりかを確認し、使用する項目を選択します。トランスポートやセキュリティの設定は変更せず、配布元の設定をそのまま保ってください。項目が追加されない場合は、プロキシのスイッチを増やす前に、URLと内容の形式を確認します。

  2. 接続方法を選択

    デスクトップではシステムプロキシの自動設定を使ってブラウザーで確認します。Androidでは接続開始時にシステムの許可を確認してください。対象のアプリに独自のプロキシ設定がある場合は、システム設定に従うのか、手動設定を使うのか、システムプロキシを無視するのかを個別に確認します。

    TUNは必要性が明確な場合に次の手順として検討し、サブスクリプション追加後に必ず有効にするものではありません。有効にする前に権限を確認し、通信を制御する可能性のあるほかのツールを停止してください。LAN共有は独立した機能です。個人の端末で利用するだけなら、接続のために有効にする必要は通常ありません。

  3. 接続とルーティングを確認

    まず、普段使うブラウザーで到達可能とわかっているWebサイトを開き、次にプロキシが必要なアプリを確認してください。結果が異なる場合は、アプリの接続方法を確認します。どちらも失敗する場合は、使用中の設定、システム時刻、クライアントログに表示されたエラーの種類を確認してください。

    接続を確認できてからルーティングのプリセットを使い、例外ルールを一つずつ追加します。問題が起きたら最後に変更した項目を元に戻してください。サブスクリプション、コア、ルーティングを同時に変更しないでください。使用を終えたら不要なシステムプロキシ設定を解除し、クライアント終了後もアプリがローカルポートを参照し続けないようにします。

途中で止まったら、最小限の設定を保ってください。「サブスクリプションを更新できる」「コアが起動する」「ブラウザーでアクセスできる」は、それぞれ別の確認結果です。問題がどの段階で起きているかを記録しておけば、以降のトラブルシューティングがスムーズになります。ログを共有する前に、サーバーのアドレス、ユーザー識別情報、サブスクリプションの情報を隠し、必要なエラー情報だけを残してください。

詳しいガイドを見る →

Project Vとオープンソースのコアエコシステム

プロジェクト、コア、GUIクライアントを区別してから、更新と互換性を確認しましょう。名前が似ていても、担う役割は同じではありません。

Project V:ツール群からクライアントエコシステムへ

Project Vは、V2Rayの背景を理解するための出発点の一つです。中心となるのはモジュール式のネットワークプロキシ機能で、インバウンドが通信を受け取り、アウトバウンドが接続を確立し、ルーティングルールが通信をどのアウトバウンドに渡すかを決めます。一般に「V2Rayクライアント」と呼ばれるものは、特定の実行コアそのものではなく、GUIを備えた管理プログラムを指すことが多いです。GUIは手動編集が必要だった項目をフォームやメニュー、サブスクリプショングループにまとめ、日常的な設定を簡単にします。

この階層構造を知っておくと、同じ接続情報を複数のクライアントで使える理由もわかります。共有形式は設定の受け渡しを担い、コアは接続を実行し、GUIは設定を管理します。ただし、パラメーターが共有できるかどうかは、双方がプロトコルや拡張フィールドに対応しているかによります。この関係を理解しておけば、インポートに失敗した場合は形式を、起動に失敗した場合はコアのパラメーターを確認でき、クライアント名だけで原因を判断せずに済みます。

V2FlyとXray:関連しながら独立して発展

V2FlyコミュニティはV2Rayに関連する開発を引き継ぎ、Xrayは関連する技術を基盤に発展した別系統のコアです。共通する概念やプロトコルの基礎もありますが、それぞれの開発によって機能や互換性の範囲は異なります。サブスクリプションの配布元が示すプロトコル名は確認の出発点にすぎません。トランスポート方式やセキュリティ設定、実装上の要件も重要です。あるコアで有効なフィールドが、別のコアでもそのまま受け入れられるとは限りません。

選ぶ際は、まずサーバー側が求める設定を確認し、それに正しく対応するクライアントとコアの組み合わせを選びます。コアの名前だけで一律の性能順位を付けたり、タイムアウトを一度調べるためにツールを何度も入れ替えたりしないでください。まずシステム時刻、接続方法、使用中の設定を確認し、その後にプロトコルへの対応を調べると、比較に使える結果を残しやすくなります。

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

v2rayN、v2rayNG、v2flyNGはいずれもオープンソースのクライアントです。オープンソースとは、各プロジェクトのライセンス条件に従って、コードの閲覧、利用、改善への参加ができることを意味します。すべてのプロジェクトが同じライセンスを採用しているわけではありません。クライアント、利用するコア、同梱コンポーネントにはそれぞれ異なる条件が適用される場合があります。再配布や改変を行う際は、画面上の名称だけで判断せず、各プロジェクトに付属するライセンスを確認してください。

クライアントが無料でも、接続先のリソースが提供されるわけではありません。サブスクリプションURL、サーバー、アカウントはそれぞれの設定元から提供され、利用できるかどうかはクライアントのコードがオープンソースかどうかとは別の問題です。当サイトではダウンロード先の選び方と設定方法を紹介しており、公開共有できるサブスクリプション情報は提供していません。使用前に設定の配布元を確認し、利用地域の法令とネットワークサービスの利用規約を守ってください。

コミュニティによる開発:更新前に設定を保存

オープンソースのエコシステムでは、コミュニティが互換性の問題を修正し、画面を改善し、新機能を追加しています。クライアント、コア、ルール用リソースはそれぞれ別のタイミングで更新されることがあります。そのため、「更新完了」が何を指すのか確認が必要です。新しいGUIをインストールした後は、以前の設定を移行できるか、従来のコアが引き続き使われているか、ルール用リソースが適合しているかを、リリースノートに沿って確認してください。画面が同じように見えるからといって、移行の確認を省略しないでください。

更新前に現在の接続方法とルーティングを記録し、必要な設定をバックアップしてください。更新後は、以前正常に動作していた使い方を確認してから、新しい項目を有効にします。設定のバックアップにはサブスクリプションや認証情報が含まれることがあるため、機密ファイルとして保管してください。動作が変わった場合は、設定とエラー情報を比較してから元に戻すか判断します。プラットフォームごとの権限、設定の移行、よくある競合については、各プラットフォームの使い方ガイドをご覧ください。

最近の技術ノート

実際の設定で迷いやすい項目やバージョンの違い、エラーの症状を解説します。問題に合った記事を選び、クライアントで一つずつ確認してください。

V2Rayのサブスクリプション更新に失敗・解析結果が空になる場合:URL、エンコード、ネットワークを確認

サブスクリプションの更新失敗は、クライアントが接続できないことを意味するとは限りません。まずURLが有効か、返された内容が対応形式かを確認し、次にBase64エンコードと更新リクエストのネットワーク経路を調べます。「リクエスト失敗」と「解析結果が空」を分けて考えると、適切な対処を選べます。

記事を読む →

Windowsでv2rayNをインストール・設定する手順:展開、サブスクリプションの追加、システムプロキシでつまずきやすい点

デスクトップ版とWPF版の選択から、インストール先や実行環境の確認、サブスクリプションの追加、システムプロキシの設定まで解説します。起動・設定の追加・通信の取り込みの3段階でよくある問題を整理し、TUNを試すべき場面も紹介します。

記事を読む →

v2rayNのデスクトップ版とWPF版の違いは?OSと使い方に合わせて選ぶ

デスクトップ版はAvaloniaによるクロスプラットフォームのGUIを採用し、WPF版は従来のデスクトップ操作に適しています。動作環境、画面、依存関係を比較し、OSに合った選び方を紹介します。また、画面が異なってもサブスクリプションの仕組みは変わらない理由を解説します。

記事を読む →

どの問題を調べるべきか迷ったら、まず入門ガイドで設定手順を最初から確認してください。接続できていて、特定のドメインの経路だけを調整したい場合は、ルーティングの説明を読んでください。基本設定が確認できる前に、余計な条件を増やすのは避けましょう。

すべての記事を見る →