オープンソースクライアントと設定ガイド

V2Fly公式サイトv2rayN クライアント

OSに合ったオープンソースクライアントを選び、まずサブスクリプションをインポートします。次にルーティングを設定し、接続を確認しましょう。

プロトコル
  • VMess
  • VLESS
  • Trojan
  • Shadowsocks

デバイスに合ったパッケージを選ぶ

デスクトップではv2rayN、スマートフォンやタブレットではv2rayNGまたはv2flyNGを選びます。まずOSを確認し、次にプロセッサのアーキテクチャを確かめてください。同じクライアントでも、OSによってインストール方法は異なります。別のデバイスに移行する場合は、元のサブスクリプションURLを使って再インポートできます。旧デバイスのポートやプロキシモード、ルールをそのまま引き継ぐ必要はありません。

Windows

v2rayNのインストール時は、デスクトップ版と従来のWPF版から選べます。デスクトップ版はクロスプラットフォームのUIを採用しています。古いガイドを見ながら操作する場合は、スクリーンショットがどちらのUIか確認してから、サブスクリプショングループやシステムプロキシの設定場所を探してください。

ポータブル版から移行する前に、起動中のインスタンスを終了し、設定をバックアップして、元のローカル待ち受けポートを控えておきます。新旧のインスタンスを同時に起動すると、2つ目が同じポートを使用できないことがあります。バージョンを切り替える前に、ポートの競合がないか確認してください。

ダウンロードへ

macOS

「このMacについて」でチップを確認し、Apple Silicon版かIntel版を選びます。インストール後はディスクイメージではなく「アプリケーション」フォルダからv2rayNを起動してください。

ブラウザがクライアントを経由しないときは、ネットワークサービスとブラウザのプロキシ設定を確認します。終了後につながらなければ、元のネットワーク設定に戻して再試行してください。

ダウンロードへ

Android

まずXrayコアを採用したv2rayNGを確認してください。設定でv2flyコアが明示的に求められている場合は、v2flyNGを検討します。近年のスマートフォンの多くはarm64パッケージに対応しています。デバイスのアーキテクチャが不明な場合は、汎用パッケージとシステム要件を確認してください。

初回接続時は、システムに表示されるVPNの許可を確認してください。同じユーザー環境では、既存のVPNアプリと新しい接続が切り替わる場合があります。画面消灯後に切断されるだけなら、バックグラウンド動作とバッテリー最適化を先に確認し、それから設定の変更を検討しましょう。

ダウンロードへ

Linux

ディストリビューションに合ったv2rayNのパッケージ形式を選びます。DebianやUbuntu系では通常deb、Fedoraなどでは通常rpmを選択します。形式とアーキテクチャは別々に確認してください。同じ形式でもx64版とarm64版が用意されている場合があります。

インストールしても、すべてのアプリがデスクトップのプロキシ設定を参照するとは限りません。GUIアプリとターミナルから起動するツールで設定が異なることがあります。特定のアプリだけ接続できない場合は、まずそのアプリのプロキシ設定を確認し、すぐにクライアントを再インストールしないでください。

ダウンロードへ

v2rayNの設定項目

サブスクリプションは設定リストの更新、ルーティングはリクエストの経路選択、システムプロキシとTUNはクライアントに取り込む通信の範囲を決めます。それぞれを分けて確認すれば、複数の設定を一度に変更するより原因を見つけやすくなります。

サブスクリプションの配信元ごとにグループを作成し、配信元が分かるエイリアスを付けて保存します。URLを貼り付けたら、まず現在のグループを手動で更新し、リストに反映されたことを確認してから自動更新を設定しましょう。リンクを1つずつインポートするより、グループ単位で更新したほうが、どの配信元に変更があったか確認しやすくなります。ただし、更新に成功しても、クライアントが設定を読み込めたことを示すだけで、リスト内のすべての項目に接続できるとは限りません。リストが空の場合は、選択中のグループを確認してから、サブスクリプションURLの有効期限と、返された内容がクライアントで認識できるかを確認してください。スクリーンショットを共有するときは、URL全体を隠してください。

Project V、コア、クライアント

設定ガイドでは、クライアント、コア、プロトコルをまとめてV2Rayと呼ぶことがあります。トラブルシューティングでは、この3つを分けて考えましょう。画面は設定を管理し、コアは設定を読み込んで接続を確立し、プロトコルは通信する両端でデータをやり取りする方法を定めます。まず問題がどの層にあるかを特定してから、変更する内容を決めてください。

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

Project VとV2Fly

Project Vは、このエコシステムを理解するための出発点です。V2Rayはその中でプロキシ接続とルーティングを処理するコアプログラムです。V2Flyコミュニティは関連するコアやドキュメントの保守を引き継いでおり、デスクトップやモバイル向けのGUIクライアントはそれぞれのプロジェクトが保守しています。コア向けの説明を読むとき、GUI上で同じ名前の項目をそのまま探す必要はありません。同じ設定がクライアントではサブスクリプション、ルーティング、トランスポートの各設定に含まれている場合や、独立した項目がない場合もあります。

ドキュメントが使えるか判断するには、まずGUIの説明かコア設定の説明かを確認し、次にOSとコアの系統が一致しているかを見ます。たとえば、コアのドキュメントにあるインバウンドポートは、クライアントがローカルでリクエストを受け付ける入口です。サブスクリプション設定にあるリモートサーバーのポートとは異なります。どちらを間違えてもウェブページを開けないように見えることがありますが、ログの場所は異なります。前者はローカルの待ち受けを、後者は接続パラメーターを確認してください。

V2FlyとXrayの互換性

XrayはV2Rayのエコシステムから派生し、その後独自の方向で開発が続いています。両方のコアで共通して使えるプロトコルや設定概念がある一方、それぞれ独自のトランスポートやセキュリティ機能もあります。設定名だけでは互換性を判断できません。同じプロトコル名でも、異なるトランスポートを使っていたり、異なるセキュリティ層のフィールドが必要だったりします。サブスクリプションで配信されたパラメーターをそのまま使い、提供元が指定する組み合わせに合ったコアを選びましょう。別の接続のパラメーターを混ぜないでください。

コアを切り替えた後、アプリが通信を始めない場合は、起動ログに最初に表示された異常を確認します。フィールドが認識されない場合は互換性を、ローカルアドレスをバインドできない場合はポートの使用状況を優先して調べてください。コアが正常に起動し、リクエストが実際にコアを経由していると確認できてから、リモート接続やハンドシェイクを調べます。異なる段階の問題をすべてサブスクリプションの無効化と判断せずに済みます。

プロトコル名と実際の接続条件

オープンソースのクライアントやコアでは、設定フィールドやプロトコルの実装を公開情報から確認できます。VMess、VLESS、Trojan、Shadowsocksはプロトコル名であり、どの設定でも自由に置き換えられる選択肢ではありません。接続できるかどうかは、通信する両端でプロトコル、トランスポート、必要なセキュリティパラメーターが一致しているかで決まります。特に、VLESSという名前だけで暗号化方式まで判断しないでください。実際のセキュリティ層は個々の設定を確認する必要があります。

初回接続では、設定の提供元が指定する組み合わせを基準にします。ハンドシェイクエラーが発生した場合は、まずアドレス、ポート、トランスポート、セキュリティパラメーターを確認し、次にデバイスの時刻を確認してください。プロトコルを切り替えるには、接続先にも対応する設定が必要です。クライアント側で1つの項目を変更しても、既存の接続を別のプロトコルに変換することはできません。現在のデバイスに合う組み合わせを知りたい場合は、まずコアの対応範囲を比較し、その後にネットワークやデバイスの条件を検討しましょう。

3つのオープンソースクライアントの使い分け

v2rayNは、デスクトップでサブスクリプション、ルーティング、プロキシ設定をGUIからまとめて管理できます。v2rayNGはXrayを主に採用したモバイル向けクライアントで、システムのVPNインターフェースから通信を取り込みます。v2flyNGは、v2flyコアを明示的に使う設定向けのオープンソースGUIクライアントです。まずデバイスで動作するクライアントを確認し、次に設定が求めるコアを確かめてください。アイコンや名前が似ているからといって、複数をインストールする必要はありません。

同じサブスクリプションを複数のデバイスで使う場合は、再インポートしてから、各プラットフォームのプロキシ接続方法を確認してください。デスクトップのシステムプロキシ設定はスマートフォンに引き継がれず、スマートフォンのVPN許可やアプリ別設定もデスクトップには反映されません。一方のデバイスだけ接続できない場合は、両方で同じ設定を選び、使用中のコアとネットワーク環境を比較しましょう。グループ名が同じでも、両方で同じ接続を使っているとは限りません。

クライアント、コア、サブスクリプションは別々に更新

GUIのリリース、コアの更新、サブスクリプションの更新はそれぞれ別の作業です。GUIの更新ではメニューの場所やインストール要件が変わることがあり、コアの更新では認識できるフィールドが変わる場合があります。サブスクリプションの更新は、元のURLから設定リストを再取得する操作です。インストールパッケージを変更する前に、グループ、ルーティング、追加設定をバックアップしてください。更新後は変更点を1つずつ確認します。まずプログラムが起動するかを確認し、次に動作確認済みの設定でテストしてから、カスタムルーティングを戻しましょう。

更新直後に問題が発生した場合は、変更日時、使用中のプラットフォーム、異常が起きた操作を記録し、関連するログを集めてください。ログを抜粋するときは、最初のエラーと前後数行を残し、サブスクリプションURL、認証情報、公開したくない接続先アドレスは削除します。影響があるのが1つのサブスクリプショングループだけなら、そのグループの更新結果を先に確認してください。正常に使えるほかのグループまで削除する必要はありません。ヘルプセンターを見る →

技術ノート

クライアント選び、トラブルシューティング、インストールでは、確認する順序が異なります。接続は確立しているのに特定のアプリだけ異常がある場合は、まずログを確認してください。クライアントをまだインストールしていない場合は、初回インストールのチェックリストから始めます。設定とクライアントが同じプロトコルパラメーターに対応していると確認できてから、プロトコルを比較しましょう。

選び方

VMess・VLESS・Trojan・Shadowsocksの違いを比較|用途別の選び方

暗号化方式、ハンドシェイクの負荷、トランスポートとの組み合わせ、クライアントの互換性という4つの観点から、4種類のプロキシプロトコルを比較。普段のウェブ閲覧、モバイル回線、低スペック端末など、用途に応じた選び方を紹介します。

記事のポイント:利用できるクライアントとサーバーの組み合わせから候補を絞り、ネットワークが変化したときの接続状況を確認します。

トラブル対処

V2Rayの実行ログの見方|よくあるエラーの意味と原因の調べ方

クライアントログの開き方やログレベルの変更方法に加え、ハンドシェイク失敗、接続タイムアウト、ポートの競合、時刻のずれなど、よくあるエラーを順に解説。原因を近いところから切り分ける手順も紹介します。

記事のポイント:時系列で最初の失敗を見つけ、起動・名前解決・ハンドシェイクのどの段階かを切り分けます。最後のエラーだけで判断しないことが大切です。

入門ガイド

v2rayNの初回インストール設定チェックリスト|Windows・macOS共通の手順と注意点

展開先フォルダ、実行環境、コアの種類、ローカルポート、システムプロキシ、初回のサブスクリプションインポートまで、v2rayNの初期設定を順に解説。初心者がつまずきやすいポイントも紹介します。

記事のポイント:最初は1つの接続を確立し、実際に使うポートとプロキシモードを確認してから、カスタムルールを追加します。