オープンソースクライアントAndroid・デスクトップ

V2Ray Android版ダウンロード

デスクトップでは v2rayN、Androidでは v2rayNGがおすすめです。パッケージを選び、サブスクリプションの追加とルーティング設定を順に進めましょう。

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks

接続トラブルと設定の確認

まず、どの段階で問題が起きているかを切り分けます。サブスクリプションの更新は設定の取得、システムプロキシの有効化は一部アプリの接続経路の変更、ルーティングルールはクライアントに入った通信の振り分けを行います。それぞれ役割が異なり、互いに代用できません。確認時は一度に一つだけ設定を変え、同じアプリで再試行すると、どの設定が影響したか判断しやすくなります。

よくあるつまずき

  • システムプロキシを有効にしても、ブラウザーが直接接続する。 ブラウザー独自のプロキシ設定を確認したうえで、リクエストがクライアントに届いていないのか、届いた後に直接接続のルールに一致したのかを切り分けます。
  • サブスクリプション更新後、リストが空のまま。 URLを保存しただけではグループ項目が作成されるだけです。更新に失敗したか、別のグループに登録された可能性があります。
  • Androidで画面をロックすると、しばらくして接続が切れる。 アプリに戻ると復旧する場合は、接続設定を変える前に、システムのバックグラウンド制限を確認してください。

確認する設定

  • v2rayNで「システムプロキシを自動設定」を選び、ブラウザーがシステム設定を使っていることを確認します。続いて「ルーティング設定」で、対象が直接接続のルールに一致していないか確認してください。
  • 「サブスクリプショングループ」を開き、保存したグループを選択して現在のサブスクリプションを更新します。解析エラーが表示された場合は、取得したものがサブスクリプションURLであり、アカウントのログインページではないことを確認してください。
  • Androidのv2rayNGアプリ情報でバッテリー設定を確認します。「制限なし」が選べる場合は、一時的に設定して画面ロック時の状態を比較し、改善を確認できたらそのままにしてください。

ルーティングルールの例:宛先がプライベートアドレスのリストに一致した場合、directと指定されたアウトバウンドから送信します。この指定は、既存のアウトバウンド名と一致させる必要があります。

{
  "type": "field",
  "ip": ["geoip:private"],
  "outboundTag": "direct"
}

5つのクライアント設定

サブスクリプショングループとリストの更新

サブスクリプショングループは、変更される接続設定をまとめて管理するのに便利です。リンクを1件だけ追加する場合は、個別にインポートできます。デスクトップ版v2rayNでは「サブスクリプショングループ」にURLを保存し、現在のグループを更新します。Android版v2rayNGでは、サイドメニューからサブスクリプション設定を開いて保存し、メインリストに戻って更新します。新しい項目が正しいグループに表示されたら、接続設定を一つ選びます。更新後に手動で追加した項目が上書きされる場合は、サブスクリプショングループ内で編集を繰り返すのではなく、別のグループに保存してください。

サブスクリプショングループ現在のサブスクリプションを更新

画面イメージは、分散した設定を比較しやすいようにまとめたもので、実際のメニュー順とは異なります。使用中のクライアントで名称が異なる場合は、まず用語一覧で、変更したいのが通信の入口、宛先の照合条件、接続設定のどれかを確認してから、該当するメニューを開いてください。

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

まずインストールするデバイスを確認し、OSの種類とCPUアーキテクチャに合ったものを選びます。同じアーキテクチャでもOSが異なれば、インストーラーは共用できません。インストール済みのデバイスを更新する場合は、現在使っているクライアントと配布形式も確認してください。

初めてならv2rayNのデスクトップ版、従来の画面を使う手順書があるならWPF版を選びます。ダウンロード前にWindowsの「バージョン情報」で「システムの種類」を確認します。

ウィンドウが表示される前にアプリが終了する場合は、配布元のリリースノートに記載されたデスクトップ実行環境を確認してください。この段階ではサブスクリプションや接続の処理は始まっていないため、ノードのパラメーターを変更しても起動失敗は解決しません。

ダウンロードページへ

「このMacについて」で「チップ」または「プロセッサ」を確認します。Appleチップと表示されるモデルではApple Silicon版、Intelプロセッサと表示されるモデルではIntel版を選びます。購入年だけで判断しないでください。同じ時期に異なるアーキテクチャのモデルが販売されている場合があります。

ディスクイメージを開き、付属の手順に従ってアプリを「アプリケーション」にインストールします。イメージ内から直接アプリを起動していた場合は、一度終了し、実際のインストール先から起動してください。インストール時とテスト時に別のコピーを開いてしまうのを防げます。

ダウンロードページへ

まずXrayベースのv2rayNGを検討してください。V2Flyの設定が必要だと分かっている場合は、v2flyNGと比較します。近年の端末の多くはarm64版を選べます。対応アーキテクチャが不明な場合は、汎用版を確認し、最低システム要件もチェックしてください。

アプリの競合が表示されたら、まず更新に失敗していないか確認します。アンインストールする前に、サブスクリプションや手動で追加した項目をバックアップしてください。

ダウンロードページへ

DebianやUbuntuではdeb、Fedoraではrpmを選びます。ARMなど、端末のCPUアーキテクチャに合うパッケージを確認してください。

クライアントが起動しても、デスクトップアプリがシステムプロキシを使うとは限りません。インストール後、現在のデスクトップ環境のネットワークプロキシ設定を確認し、その設定を参照するアプリで動作を確かめてください。アプリによっては、独自の設定で接続方法を指定する必要があります。

ダウンロードページへ

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

インポートから接続確認までの3ステップ

初回接続では、まず既定の設定を維持し、動作確認済みの接続設定を一つ使って基準となる状態を確認します。接続できたことを確認してから、ルーティング、アプリ別の対象リスト、バックグラウンド設定を変更しましょう。後で問題が起きても、直前の状態に戻して再確認できます。

  1. 設定をインポートして接続先を選ぶ

    サブスクリプションURLがある場合は、クライアントでグループを新規作成し、分かりやすい名前とURLを入力して保存後に更新します。共有リンクが1件だけの場合は、クリップボードからインポートする機能を使えば、サブスクリプションを作成する必要はありません。インポート後、メインリストに目的の項目が表示されていることを確認し、テストする接続設定を一つ選びます。設定が見つからないと表示された場合は、コピーした内容が完全なURLまたは共有リンクであり、QRコードの横にある説明文ではないことを確認してください。サブスクリプションURLにはアクセス情報が含まれることがあります。URL全体を公開スクリーンショットや問い合わせに掲載しないでください。

  2. テスト用アプリを一つ接続する

    デスクトップではv2rayNで接続設定を選び、「システムプロキシを自動設定」を選択してから、システムプロキシを使うブラウザーを開きます。Androidではv2rayNGで接続をタップします。初回にシステムVPNの許可確認が表示されたら、どのアプリが要求しているかを確かめてから許可してください。テスト中はアプリ別の対象リストを変更せず、必要に応じて他のVPNがシステム接続を使用していないことも確認します。プロキシの有効化やシステムの許可より前にエラーが出る場合は、ルーティングルールを変更せず、クライアントの起動、実行環境、権限の問題を先に解決してください。

  3. 実際のリクエストで問題の段階を特定する

    普段使うページを開いて新しいリクエストを送り、時刻を記録してからクライアントに戻り、その時刻の実行ログを確認します。該当する記録がない場合は、テスト対象のアプリが接続されているかを確認してください。直接接続と記録されているのにプロキシを通る想定だった場合は、ルールの一致状況を確認します。接続を試みてもタイムアウトする場合は、ローカルネットワーク、接続設定、サーバーの状態を順に確認します。テスト後はシステムプロキシを元に戻すかAndroidのVPNを切断し、同じアプリで再試行して設定の変更が接続状態に反映されることを確認してください。

詳しい手順を見る →

Project Vのエコシステムとクライアントのライセンス

プロジェクト、コア、クライアントはそれぞれ異なる層です。文書がどの層を扱っているかを把握すると、機能が接続プロトコル、コアの実装、クライアントの設定のどれに属するか判断できます。

Project Vとコミュニティによる開発

Project Vは、初期のV2Rayが属していたプロジェクトのエコシステムです。V2Rayコアはインバウンド、アウトバウンド、ルーティングを処理します。V2FlyコミュニティはV2Rayコアのメンテナンスを引き継ぎ、Xrayは同じコードの系譜から分岐して独自に開発されています。一般的な会話で「V2Ray」は、コアを指す場合もあれば、この種のツール全般を指す場合もあります。「V2Ray対応」と書かれた手順を見たら、特定の共有形式をインポートできるという意味なのか、使用するプロトコルやトランスポート設定で実際に接続できるという意味なのか確認してください。

XrayとV2Flyの互換性

どちらのコアにも共通する設定概念はありますが、プロトコル名が同じでも、すべてのトランスポートやセキュリティ設定に互換性があるとは限りません。プロトコルと追加フィールドは分けて確認してください。VLESSを使う設定でも、特定のトランスポートやセキュリティ設定が必要な場合があります。コアを切り替えた後、項目が表示されても起動やハンドシェイクに失敗する場合は、元の設定と対応フィールドを照合し、サーバー側の要件も確認してください。「インポート済み」であることを「互換性がある」と判断しないでください。

オープンソースのGUIクライアント3選

v2rayNはデスクトップ向けで、サブスクリプション、各種設定、システムプロキシを管理できます。v2rayNGはXrayベースの接続をAndroidのシステムVPNサービスに接続します。v2flyNGはV2Flyコアを採用し、対応する設定が必要なAndroid端末向けの選択肢です。3つのGUIクライアントはいずれもGPL-3.0ライセンスで公開されており、無料で利用できます。クライアントのライセンスはコアやその他のコンポーネントのライセンスとは異なり、利用可能なサーバーやサブスクリプションサービスも含まれません。手元の設定に合わせてクライアントを選んでください。

更新前後に確認すること

クライアント、コア、ルーティング用ルールデータは、それぞれ別に更新されることがあります。クライアントの更新では画面表示やシステム連携が、コアの更新では設定の解析や接続動作が変わる場合があります。一部のドメインでアウトバウンドが想定と異なるだけなら、クライアントとコアを同時に入れ替えるのではなく、現在使っているルーティングルールやデータを先に確認してください。更新前に有効なグループ、ルーティングプリセット、アプリの対象範囲を記録します。更新後は、以前接続できた設定を再確認してから新しい設定を試すと、移行時の問題と元からあった問題を切り分けやすくなります。

3つのクライアントの用途を比較 →

実行ログとトラブル対処

ウィンドウが開かない、特定の接続がタイムアウトする、ログにハンドシェイクエラーが表示されるといった症状は、それぞれ確認の起点が異なります。現在の状況に近い記事を選んでください。複数のアプリで同時に問題が起きている場合は、トラブル診断で症状を一つずつ確認するのがおすすめです。

すべての記事を見る →