オープンソースクライアントProject V

V2Ray中文版 ダウンロード

OSに合ったGUIクライアントを選び、サブスクリプションの追加から設定を始めます。接続に問題があれば、症状別のトラブル対処を確認してください。

V2Rayクライアントの主な設定

ノードが表示されても、設定の読み込みが完了しただけです。アプリがプロキシを使うか、コアがノードとハンドシェイクできるか、通信がルールどおりに振り分けられるかは、それぞれ別の設定で決まります。下の目盛りを症状に合わせて切り替え、確認すべき階層を絞り込みましょう。

プロトコル・トランスポート・セキュリティ設定

ノードを追加できてもハンドシェイクに失敗する場合は、まずプロトコル、トランスポート方式、セキュリティ層がサーバー側と一致しているか確認します。VMess、VLESS、Trojan、Shadowsocksの設定値は互換ではなく、同じプロトコルでもトランスポート方式が異なる場合があります。複数のコアに対応したデスクトップクライアントでは、ノードの編集画面で設定値を確認し、実際に有効なコアも確かめてください。単一プロトコルのツールより一元管理しやすい一方、コアを切り替えても既存の設定値は自動で変更されません。不一致が確認できた項目だけを修正し、実際に接続してテストしましょう。

関連する対処方法:インターネットに接続できない →
ノード編集 · 確認する順序
  • プロトコルの種類
  • トランスポートプロトコル(network)
  • トランスポート層のセキュリティ(security)
  • サーバー名(serverName)

OSに合ったインストールパッケージを選ぶ

アプリが起動しない場合は、ノードを変更する前にOS、CPUアーキテクチャ、パッケージ形式を確認します。インストールと接続は別の段階です。まずクライアントが正常に起動して設定画面を開ける状態にし、その後で設定を読み込んでネットワークの問題を調べましょう。

Windows

v2rayNのデスクトップ版または従来のWPF版を選べます。デスクトップ版はクロスプラットフォーム対応のインターフェースです。従来版の操作に慣れている方や、旧版のメニューを参照している方はWPF版も確認してください。まずシステム情報でx64かどうかを確認します。

配布パッケージを展開する必要がある場合は、書き込み権限のあるフォルダーにすべて展開してから起動してください。ランタイムに関する警告が表示されたら、不足しているコンポーネント名を控え、ダウンロードページの説明に従って追加してから再度お試しください。

ダウンロードページへ

macOS

v2rayNのCPUに合ったパッケージを選びます。「このMacについて」でチップまたはプロセッサを確認してください。Appleシリコンはarm64、Intelプロセッサはx64に対応します。OSのバージョン番号だけではアーキテクチャを判別できません。

ディスクイメージからインストールしたら、「アプリケーション」からクライアントを起動してください。システムの警告が表示された場合は、アーキテクチャの不一致、OSのバージョン要件、アクセス権の警告を区別して確認します。それぞれ対処方法が異なります。

ダウンロードページへ

Android

一般的な選択肢はXrayベースのv2rayNGです。V2Flyの設定が必要な場合は、v2flyNGを確認してください。まず端末が対応するアプリのアーキテクチャを確認します。arm64に対応していれば該当パッケージを選び、判断できない場合は汎用パッケージを確認してください。

インストール後、まずアプリを開いた状態で初回のVPN接続許可を完了します。ネットワークの切り替えや画面ロック後に接続が切れる場合は、同じノードで再テストし、ほかのVPN接続とバックグラウンド時のバッテリー制限を順に確認します。

ダウンロードページへ

Linux

まず、ディストリビューションが対応するパッケージ形式を確認します。Debian系・Ubuntu系では通常deb、Fedora系では通常rpmを選びます。次にシステム情報でx64かarm64かを調べます。パッケージ名に含まれるアーキテクチャは相互に置き換えられません。

このリンク先はGUIクライアントです。インストールできても、使用中のデスクトップ環境がすべてのアプリにプロキシ設定を適用するとは限りません。設定後、ブラウザーで比較テストを行い、問題があるアプリがデスクトップのプロキシ設定を引き継いでいるか確認してください。

ダウンロードページへ
すべてのクライアントを見る →

サブスクリプションの追加・接続・確認

初回設定では、1台の端末、1つのネットワーク、1つのノードだけを使って接続経路を確認します。各手順の結果を記録しておけば、後で端末を変えても、成功した条件を再現したり失敗箇所を特定したりできます。

  1. サブスクリプションを追加してノードを確認

    デスクトップ版v2rayNでは、新しいサブスクリプショングループを追加してURLを保存し、そのグループを手動で更新します。v2rayNGでは、サブスクリプショングループ管理から追加した後に更新を実行します。ノード一覧に項目が表示されたら、直前に更新したグループのノードであることを確認し、古いノードを新しいサブスクリプションの結果と取り違えないようにしてください。

    ノード数が変わらない場合は、更新時に表示されたメッセージを確認します。タイムアウトなら取得経路を調べ、形式に対応していないというメッセージならサブスクリプションの種類を確認してください。サブスクリプションURLにアクセス認証情報が含まれる場合があるため、トラブル時のスクリーンショットではURL全体を隠しましょう。

  2. ノードを選択して接続を開始

    追加したばかりのグループから、クライアントのコアに対応するノードを選びます。デスクトップでは選択したノードが有効な設定になっていることを確認してから、システムプロキシを有効にします。モバイルでは接続を開始し、システムのVPN接続許可を完了します。初回テストではデフォルトのルールを使い、カスタムルーティングやDNS設定は追加しないでください。

    接続ボタンを押してすぐ未接続に戻る場合は、まずログの最初のエラーを確認します。ポートの競合、設定を認識できない問題、ハンドシェイクの失敗はそれぞれ異なる原因です。まず起動時のエラーを解消してから、アクセスをテストしてください。

  3. 同じアプリで通信経路を確認

    システムプロキシを参照するブラウザーから新しいリクエストを送り、接続の前後でアクセス結果を記録します。必要に応じて外部から見えるIPアドレスやクライアントログも確認してください。ノードの遅延を測定できても、ブラウザーのリクエストが同じ経路を通っているとは限りません。

    特定のサイトだけ開けない場合は、同じブラウザーで、同じアウトバウンドを通る想定の別の宛先にもアクセスし、ルールの適用状況とドメイン名の解決を確認します。プロキシを無効にしてもアクセスできない場合は、まず通常のネットワーク接続を復旧してください。複数のノードやルールを同時に変更するのは避けましょう。

詳しい手順を見る →

Project V・V2Fly・Xrayの関係

プロジェクト、コア、クライアント、ノードのプロトコルは、それぞれ異なる階層の名称です。ガイドを読んだり問題を報告したりする前に、どの階層について話しているか確認してください。特に起動時のエラーでは、画面に表示される製品名だけでなく、実際に動作しているコアを確認する必要があります。

プロジェクトの系譜
Project V
コアの系統
V2Fly / Xray
GUIクライアント
v2rayN / v2rayNG / v2flyNG
用語を確認 →
  1. Project Vから理解するモジュール型プロキシ

    V2RayはProject Vから生まれました。リクエストを受け取るインバウンド、転送を担うアウトバウンド、通信の経路を決めるルーティングを、独立した設定として扱います。インバウンドはブラウザーなどのアプリからのリクエストをコアに渡し、ルーティングは条件に応じてアウトバウンドを選択します。アウトバウンドが直接接続やプロキシなどの処理を担います。

    この3つの要素は、よくある症状の切り分けにも役立ちます。コアが接続を受け取っていないなら、ローカルの接続設定を確認します。リクエストがコアに届いているのに経路が違うなら、ルールの順序を調べます。想定したアウトバウンドまで届いて失敗するなら、サーバーの設定値とネットワークへの到達性を確認しましょう。「Webページが開かない」という症状だけで原因を決めるより、この3つの階層に分けて考えるほうが正確です。

  2. V2FlyとXrayには、それぞれ異なる互換範囲がある

    V2FlyコミュニティはV2Rayのコアプロジェクトを引き継いでいます。Xrayは同じコードの流れから派生した後、独自に開発が進み、それぞれのコミュニティが保守しています。設定の基本概念には共通点がありますが、対応するトランスポート方式、セキュリティ層、フィールドは異なる場合があります。同じプロトコル名が付いていても、すべての設定値が両方で使えるとは限りません。

    「項目は読み込めるのにコアが起動しない」場合は、まずログがどのフィールドを示しているか確認します。そのコアが該当オプションに対応していないのか、クライアントが設定を生成する際にその項目が欠落したのかを切り分けてください。コアを切り替える前に、現在の選択を記録しておきます。同じノードとネットワークを維持して再テストすれば、どの階層の違いが原因か判断しやすくなります。

  3. プロトコルが公開されていても、設定値が共通とは限らない

    VMess、VLESS、Trojan、Shadowsocksはいずれも、オープンソースのプロキシエコシステムで実装されています。プロトコルは通信する両端がデータを交換する方法を定め、トランスポート方式とセキュリティ層は、そのデータの運び方と保護方法を定めます。たとえばVLESSというプロトコル名だけでは、接続にTLSが設定されているか判断できません。また、TLSとトランスポート方式は別の設定項目です。

    設定例を読むときは、まずプロトコルを確認し、次にトランスポート方式とセキュリティ層をそれぞれのフィールドやサーバー側の設定と照合します。別のガイドから設定値を1つだけ転記すると、両端で一致していた設定が不一致になることがあります。プロトコルが公開されていれば実装の比較やトラブル対処に役立ちますが、個別のサブスクリプションや第三者サービスがクライアント開発プロジェクトの提供物という意味ではありません。

  4. 3つのオープンソースクライアントがGUI設定を担当

    v2rayNはデスクトップ向けのGUIクライアントで、ノード、サブスクリプション、ルーティングを管理し、設定に応じたコアを利用できます。v2rayNGはXrayをコアとするモバイルクライアントで、サブスクリプションとVPN接続に対応します。v2flyNGはV2Flyをコアとし、V2Flyとの互換性を確認したいモバイル環境に適しています。いずれもオープンソースクライアントです。画面は設定を管理し、実際の接続は基盤となるコアが確立します。

    サブスクリプションサービスとクライアントも別のものです。クライアントをインストールしてもノードは自動で利用できず、アプリが起動してもサブスクリプションが有効とは限りません。サーバーからのエラー、期限切れのノード、アプリの権限不足は、それぞれ配信元、ノードの設定、端末の設定を確認する必要があります。まずエラーがどこから発生したのかを把握してから、該当するガイドを確認しましょう。

  5. クライアント、コア、サブスクリプションは更新周期が異なる

    クライアントの更新では、画面、OS対応、パッケージ形式などが変更される場合があります。コアのリリースでは設定項目が追加されたり、接続動作が修正されたりします。サブスクリプションの更新で同期されるのは、配信元が提供するノード一覧です。サブスクリプションの更新に成功してもソフトウェアの更新にはならず、クライアントを再インストールしても無効になったサブスクリプションは復旧しません。

    アップグレード前にカスタムルーティングと設定をバックアップし、現在のコアと正常に動作している接続方式を記録してください。アップグレード後は、まず以前のノードで接続を確認してから、追加の設定を1つずつ戻します。更新後に問題が再発した場合は、発生時刻、プラットフォームとアーキテクチャ、選択したコア、再現手順、個人情報を伏せたログを記録すると、「接続できない」というスクリーンショットだけの場合より原因を特定しやすくなります。

サブスクリプション・接続・プロキシモード

問題が発生した段階に合わせて記事を選びましょう。サブスクリプションの更新に失敗する場合は取得と解析、ノードが表示された後の初回接続に失敗する場合はノードとアウトバウンドを確認します。一部のアプリだけ動作が異なる場合は、システムプロキシとルーティングを切り分けてください。

サブスクリプション管理

v2rayNのサブスクリプション更新に失敗する場合の対処法:タイムアウト・解析結果が空になる問題・自動更新間隔の設定

サブスクリプションの更新に失敗する主な原因を解説します。リンク切れ、更新リクエストがプロキシを経由しない問題、取得内容を解析しても空になる問題のほか、自動更新の間隔や更新時にプロキシを使う設定方法を紹介します。

すべての記事を見る →