V2RAYN · V2RAYNG · V2FLYNG

V2Ray for Macv2rayN のダウンロードと設定

デバイスに合ったオープンソースクライアントを選び、日本語ガイドを見ながらサブスクリプションをインポートしてルーティングを設定できます。

Xray V2Fly JSON 設定
クライアント一覧OSから探す

V2Ray クライアントのインストーラー

まずデバイスのOSを確認し、CPUアーキテクチャとパッケージ形式を照らし合わせます。アプリをインストールできるかどうかと、コアがサブスクリプション内の設定を実行できるかどうかは別の問題です。初回インストールでは前者を解決し、ノードをインポートしてからプロトコルと通信パラメーターを確認しましょう。

初回インストールと移行

古いデバイスから移行する場合、すべてのカスタムルールを最初にコピーする必要はありません。まず、使用中のクライアント、サブスクリプションの入手元、コアの種類、有効なルーティングポリシーを記録します。新しいデバイスにノードを1つのグループとしてインポートし、動作確認済みのノードで基準を作ってから、ほかのルールを戻しましょう。旧デバイスのシステムプロキシのアドレスやポート、LANアクセス設定が、新しいデバイスに適しているとは限りません。

インストールに失敗したら、まずどの段階でエラーが発生したかを確認します。インストーラーが開かない場合はCPUとパッケージ形式を確認し、アプリは開くのにコアが起動しない場合は起動ログを確認します。特定のノードだけ接続できない場合は、そのノードのプロトコルとパラメーターを調べます。こうすればインストールの問題をサブスクリプションの期限切れと取り違えたり、1つのノードを直すためにクライアント全体を再インストールしたりせずに済みます。

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

設定の手順

サブスクリプションのインポートからプロキシの有効化まで

まずコアでノードを1つ動かし、次にどのアプリの通信がクライアントに渡るかを確認します。以下の5項目は個別に参照できます。右側はフィールドや設定項目の例です。画面やログとの照合用であり、そのまま実行できる完全な設定ではありません。

サブスクリプショングループを保持

サブスクリプションURLを専用のグループに登録し、手動で一度更新します。更新後、ノードが一覧に表示されるか、プロトコルと名前が正しいかを確認してください。クリップボードからノードを1つインポートする方法とは異なり、サブスクリプショングループには次回以降の更新元が記録されます。これにより、プロバイダー側の変更とローカルで記録した内容を分けて管理できます。一覧が空なら、まずURLや有効期限、クライアントが認識できる応答形式を確認しましょう。システムプロキシを先に変更する必要はありません。サブスクリプションURLにはアクセス情報が含まれる場合があるため、スクリーンショットや問い合わせに掲載する際はURL全体を隠してください。

サブスクリプションのインポート手順を見る

サブスクリプショングループの設定
現在のサブスクリプションを更新
クリップボードから複数のURLをインポート

プロジェクトとメンテナンス

Project V、V2Fly、Xrayの関係

ダウンロードページのアプリ名、サブスクリプション内のプロトコル名、ログに出るコア名は、それぞれ異なる層を指します。アプリ、コア、プロトコルの違いを把握すれば、インストーラーを変えるべきか、コアを変えるべきか、パラメーターだけを修正すべきか判断できます。このハンドブックではクライアントの入手先と設定方法をまとめています。クライアントとコアの開発・リリースは、それぞれのプロジェクトのメンテナーが担当します。

Project VとV2Rayの成り立ち

Project Vはプロキシツールのエコシステムを指すプロジェクト名で、V2Rayはその中で接続の処理と転送を担うコアプログラムです。設定はインバウンド、アウトバウンド、ルーティングの各セクションに分かれています。インバウンドは接続を受け入れ、アウトバウンドは接続の送信方法を決め、ルーティングはその間で経路を選択します。GUIクライアントでは、よく使う項目をフォームにまとめ、現在のノードやルールに応じて設定を生成することもできます。そのため、画面に表示される内容と実際に実行される設定が、一字一句同じとは限りません。

以前のガイドを読むときは、説明されているのが画面操作かコアのフィールドかをまず見分けましょう。たとえば「システムプロキシ」を有効にする操作は、アプリの通信をローカルの入口へ送るためのものです。一方、設定にあるrouting.rulesは、コアが通信を受け取った後に使うルールです。システム設定を変更しただけでは、特定のルーティングルールが適用された証拠にはなりません。逆に、ルールが正しくても、プロキシを経由しないアプリの通信は受け取れません。古いスクリーンショットを見ながら項目を一つずつ選ぶより、この境界を基準に問題を切り分けるほうが確実です。

V2FlyとXrayの分岐

V2FlyコミュニティはV2Rayのメンテナンスを継続しています。XrayはV2Rayからコードをフォークして独自に開発され、REALITYやXTLS Visionなどの機能を追加しました。両者には似た設定構造が一部残っていますが、同じ名前のフィールド、プロトコル、通信方式が必ず相互運用できるとは限りません。移行する際は、サーバーの情報やサブスクリプションの説明で必要なプロトコル、通信方式、安全レイヤーを確認し、クライアントの起動ログでその組み合わせに対応したコアが実際に動いているか確かめましょう。

プロトコルは接続する双方がデータをやり取りする方法を定め、通信方式はプロトコルのメッセージをどのように運ぶかを決めます。安全レイヤーには独自のハンドシェイクと認証要件があります。たとえば、ノードがVLESSを使っていることだけでは、どのクライアントを選ぶべきか判断できません。特定の安全レイヤーやフロー制御が必要かも確認してください。起動前に設定が拒否された場合は、認識されないフィールドを確認します。設定が読み込まれた後にハンドシェイクが失敗する場合は、サーバーから提供されたパラメーターを一つずつ照合します。どちらも接続失敗として現れますが、対処方法は異なります。

3つのオープンソースクライアントの役割

v2rayNは、サブスクリプション管理、ノード選択、ローカルプロキシ設定を1つの画面にまとめたオープンソースのデスクトップクライアントです。v2rayNGはXrayコアを使うオープンソースのモバイルクライアントです。v2flyNGもオープンソースで、V2Flyコアが必要な設定を対象としています。オープンソースライセンスには、コードの利用、変更、配布に関する条件が定められています。該当プロジェクトとリリース資料に記載されたライセンスを確認し、クライアントの利用条件をコアやほかの依存関係の条件と混同しないようにしてください。

アプリを切り替える前に、問題が本当にコアの違いによるものか確認しましょう。たとえば、パソコンでは接続できるのにスマートフォンではアプリを前面に表示している間しか動かない場合は、まずシステムのVPN許可とバックグラウンド動作の制限を確認します。同じデバイスで一部のドメインだけ失敗する場合は、名前解決とルーティングを調べます。アプリを変更すると、デフォルトのルーティングやポート、通信の取り込み方法も変わることがあります。再現できるテスト条件を保たなければ、接続が回復した理由がコアの変更なのか、以前のシステム設定がリセットされたためなのか判断できません。

クライアント、コア、ルールの更新

クライアントの更新では、画面やパッケージ方法、設定の生成ロジックが変わることがあります。コアの更新では、対応フィールドやデフォルトの動作、ログの内容が変わる可能性があります。地理データやサイトルールの更新では、ルーティングルールが一致する範囲が変わる場合があります。この3つが同時にリリースされるとは限りません。問題を報告するときは、アプリ、コア、サブスクリプション、ルールデータのどれを変更したかを記録し、新たな症状と該当する変更を照らし合わせられるようにしましょう。

カスタムインバウンドやルーティングに依存した設定を使っている場合は、更新前にローカルバックアップを取り、普段の接続確認に使う項目も記録してください。更新後は、まず起動できるかを確認し、次にローカルの待ち受け、ハンドシェイク、ドメイン名の解決、ルーティングが想定どおりかを確認します。特に社内ネットワークのドメインや直接接続が必要なサービスは、ノードの速度テストを1回行うだけでは十分に検証できません。フィールドの階層を確認するにはJSONハンドブックを参照してください。

インストールと接続に関するよくある質問

初回設定では、まず問題がどの層で起きているか確認しましょう。以下のQ&Aを確認の順序として活用できます。

サブスクリプションをインポートできれば、すぐ使えますか?

ノードが一覧に表示されるのは、クライアントがサブスクリプションの内容を読み込めたということです。ノードを選んだ後、コアが正常に起動したか確認し、ローカルプロキシを使うアプリからリクエストを送ってください。クライアントの速度テストは成功するのにブラウザーの通信がログに出ない場合は、ブラウザーが現在のシステムプロキシを使っているか確認しましょう。サブスクリプションを再設定する必要はありません。ノード一覧に内容があり、起動時にフィールドエラーが出る場合は、DNSではなくコアの互換性を確認します。インポートと動作確認の手順を見る。

システムプロキシとV2Rayのグローバルプロキシは同じ設定ですか?

いいえ。システムプロキシは、それに従うアプリが接続するローカルアドレスを決めます。グローバルルーティングは通常、コアに届いた通信をどのアウトバウンドポリシーで処理するかを決めます。アプリが直接接続すると、その通信はコアのグローバルルールに届きません。プロキシへの接続方法を見る。

接続できるのに一部のドメインが開けないのはなぜですか?

同じアプリで、アクセスできるドメインと失敗するドメインを比較します。それぞれ名前解決できているか、想定したルールが適用されているか、選択されたアウトバウンドが目的に合っているかを確認してください。テスト中はノードとネットワーク環境を変えず、設定を一度に1つだけ変更します。ガイドに沿って順番に確認。

古いデバイスの設定をそのままコピーできますか?

まずサブスクリプションと必要なルールを移行し、新しい環境に合わせてコア、待ち受けアドレス、ポート、システムプロキシを確認してください。古いデバイスのネットワークアダプター、LANアドレス、例外リストを一般的な初期設定として扱わないようにしましょう。クライアント設定の手順を見る。

使い方とトラブル解決

コア選びと接続トラブルの調べ方

症状から確認できます。ノード起動直後にエラーが出る場合は、まずコアとフィールドを確認します。コアは動作しているのにノードの速度テストがタイムアウトする場合は、接続条件を調べます。速度テストは成功するのにWebページが開かない場合は、アプリのリクエストがローカルプロキシに届いているかを優先して確認してください。