Android・デスクトップ用クライアント/設定入門
v2rayNGのAndroid版をダウンロードする方法から、デスクトップ版v2rayNの設定まで解説。端末に合ったインストーラーを選び、サブスクリプションの追加とルーティングを進めます。
サブスクリプションURLは複数のノードを更新するための入口で、個別のノードリンクは1つの接続設定を表します。v2rayNでは「サブスクリプショングループの設定」を開き、URLを追加して保存した後、サブスクリプションを更新します。v2rayNGではサイドメニューからサブスクリプショングループの設定を開けます。後から必要なグループだけ更新できるよう、グループ名には接続元がわかる名称を付けておくと便利です。追加後、ノードが一覧に表示されることを確認し、1つ選んで接続テストを行います。ノードを1件ずつ手入力するより一括管理に向いていますが、更新が成功したかどうかはログで確認してください。一覧に以前のノードが残っているだけでは、更新成功とは限りません。
サブスクリプション追加の手順を見る →操作手順
サブスクリプションURLにはアクセス情報が含まれることがあります。スクリーンショットを共有する際は、URL全体が見えないようにしてください。
ルーティングは、コアに届いた通信をどのアウトバウンドへ送るかを決めます。すべてのアプリが自動的にプロキシを使うようにする機能ではありません。まずクライアントで適切なルーティングモードを選び、その後、個別ルールを追加します。ドメイン条件とIP条件は分けて記述し、ルール内のアウトバウンドタグはアウトバウンド設定と一致させてください。以下の例はプライベートIPアドレスを直接接続のアウトバウンドへ送るものです。完全な設定ではありません。すべての通信を同じ経路に送るより、宛先ごとに振り分けるとLANへのアクセスを維持しやすくなります。ルールが適用されない場合は、ノードを何度も変更するのではなく、DNSの解決方法、ルールデータベース、ルールの順序を確認してください。
routingフィールドの説明を見る →{
"routing": {
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}v2rayNのシステムプロキシはOSのプロキシ設定を変更しますが、その設定を参照しないアプリもあります。TUNモードは仮想ネットワークインターフェースを通じて、より多くのIP通信を取り込むため、そのような場合に役立ちます。有効にする前に通常の接続が動作することを確認し、権限、ルーティング、DNSの設定を調べてください。一度に複数の項目を変更すると、原因を特定しにくくなります。システムプロキシと比べてTUNは影響範囲が広いため、LAN、ほかの仮想ネットワークインターフェース、ネットワークツールとの競合にも注意が必要です。Android版v2rayNGはOSのVPNサービスを使って通信を取り込むため、デスクトップ版のメニュー手順をそのまま当てはめないでください。
接続モードと確認方法を見る →有効化前の確認項目
クライアントはサブスクリプションの管理、設定項目の表示、起動操作を担当し、コアはプロトコル処理、ルーティング、接続を担当します。v2rayNGはXrayを使用し、v2flyNGはV2Flyコアを採用したAndroid向けの選択肢です。v2rayNで利用できる機能は、使用中のコアによって異なります。見慣れない項目があれば、まずどのコアと設定形式に属するかを確認し、該当するドキュメントを参照してください。設定全体をコピーするより、ログと既存の項目を順に照合するほうが問題を見つけやすくなります。以下は一般的な構造名の例です。接続可能な完全な設定ファイルではなく、サーバー側のパラメーターも含まれていません。
JSON設定ガイドを開く →{
"log": {
"loglevel": "warning"
},
"inbounds": [],
"outbounds": [],
"routing": {
"rules": []
}
}設定名はクライアントの画面更新に伴って変わることがあります。同じ名前の項目が見つからない場合は、デスクトップ版v2rayNかAndroid版v2rayNGかをまず確認してください。どちらも似たノード情報を使えますが、メニュー、権限、通信を取り込む方法は異なります。サーバー側の通信パラメーターについては、サービス提供元の説明に従ってください。
端末に合わせて選ぶ
デスクトップではv2rayN、Androidではv2rayNGをまず確認してください。同じプラットフォームでもCPUアーキテクチャの確認が必要です。ファイル形式によってインストール方法が異なり、ノードのプロトコルが使えるかどうかはコアと設定に左右されます。インストーラー名だけでは判断できません。
デスクトップ版は新世代のクロスプラットフォームUIを採用し、従来のWPF版は使い慣れたレイアウトを維持しています。初めて使う場合はデスクトップ版の説明を確認し、現在の操作に慣れている場合は、必要に応じて切り替えを検討してください。どちらのUIでも有効なノード情報が必要で、インストールするだけで接続先が用意されるわけではありません。
インストール前に「設定 → システム → システム情報」を開き、システムの種類と端末のアーキテクチャを確認してください。移行する場合は、サブスクリプションURL、ルーティング設定、必要なカスタム設定を保存し、古いフォルダーで新しいフォルダーをそのまま上書きしないでください。初回起動後はノードを1つテストしてからシステムプロキシを設定します。ブラウザーで接続できることを確認した後、ほかのアプリも通信を取り込む必要があるか検討してTUNモードを設定してください。
システムメニューの「このMacについて」を開き、Appleチップ搭載機ならApple Silicon用のarm64インストーラーを選びます。Intelプロセッサと表示される場合はx64版を選択してください。まずチップを確認し、次にシステム要件を確認すると、ダウンロード後にアーキテクチャが合わないと気づく事態を避けられます。
インストール後、システムの案内に従ってアプリの起動許可を設定し、サブスクリプションを追加してください。システムプロキシ、ブラウザー拡張機能のプロキシ、ターミナルのプロキシはそれぞれ別の設定です。ブラウザーから接続できても、ターミナルのアプリが同じ経路を使うとは限りません。アプリごとに動作が異なる場合は、すぐにクライアントを再インストールせず、各アプリがどのプロキシ設定を参照しているか確認してください。ほかのネットワークツールを使っている場合は、システムプロキシを同時に変更しないようにしてください。
比較的新しいAndroidスマートフォンでは、通常arm64版を優先して確認します。端末のアーキテクチャがわからない場合は、汎用版の説明を確認してください。v2rayNGはXrayコア、v2flyNGはV2Flyコアを使用します。代替クライアントを選ぶ基準は設定との互換性です。両方を同時に起動する必要はありません。
初回接続時はOSのVPN接続許可を確認し、その後、アプリごとのプロキシ設定で対象アプリが除外されていないか確認してください。画面ロック後しばらくして接続が切れる場合は、バッテリー最適化やバックグラウンド実行の制限を確認します。まず初期設定のまま通信を取り込んで動作を確認し、必要に応じて対象アプリを絞り込んでください。ノードの問題とアプリ設定の問題を切り分けやすくなります。更新前にはサブスクリプションとカスタムルールも保存し、再インストールを通常のトラブル対処にしないようにしましょう。
まずディストリビューションが採用するパッケージ形式を確認し、次にCPUアーキテクチャを確認します。DebianやUbuntu系では通常deb、Fedoraなどでは通常rpmを選びます。一般的なデスクトップPCはx64が多く、ARM端末では対応するarm64ファイルを選んでください。ディストリビューション名だけで判断しないようにしましょう。
インストール後はまずGUIからサブスクリプションを追加し、コアが起動することを確認します。デスクトップ環境のプロキシ設定とターミナルの環境変数は連動しない場合があります。特定のプログラムがプロキシを使わないときは、そのプログラムが参照する設定を個別に確認してください。TUNを有効にしてLANやコンテナのネットワークに影響が出た場合は、まずTUNを無効にして元のネットワークへ戻し、ルーティングと権限を確認します。ダウンロードページではファイル形式とアーキテクチャを分けて掲載しているため、環境に合ったものを選べます。
基本操作ガイド
まず最短の手順で接続し、その後で詳細設定を調整します。以下の3ステップで問題切り分けの基準を作れます。一度に変更するのは1項目だけにして、変更前後の結果を記録しましょう。コア、DNS、ルーティングを同時に切り替えるより、原因を特定しやすくなります。
有効なサブスクリプションURLか、個別のノードリンクを用意します。サブスクリプションURLはサブスクリプショングループの設定に追加し、個別のリンクはクリップボードからのインポートなど、ノード追加のメニューから取り込みます。WebページのURL、サブスクリプションURL、ノードリンクを混同して貼り付けないでください。追加後、ノードが一覧に表示され、名前が適切であることを確認し、更新ログにエラーがないか確認します。
v2rayNとv2rayNGはクライアントツールであり、インストールしてもサーバーが自動的に用意されるわけではありません。サブスクリプションの更新に失敗した場合は、URLが完全か、有効期限が切れていないか、現在のネットワークから更新先にアクセスできるかを確認します。古いノードが一覧に残っているのは、ローカルデータが保持されていることを示すだけで、今回の更新成功を意味しません。問い合わせ用のスクリーンショットを共有する際は、URLに含まれる認証情報やノードの認証情報を隠してください。
まずノードを1つ選んで接続先に設定し、一度に複数の設定を変更しないでください。デスクトップ版v2rayNでは、システムプロキシと適切なルーティングモードから試せます。Android版v2rayNGの起動時には、OSのVPN接続リクエストを許可する必要があります。許可の確認はOSから表示されます。許可後、クライアントが正常に起動したことと、対象アプリが通信の取り込み範囲内にあることを確認してください。
ルーティングモードは、コアに届いた通信をどのように振り分けるかを決めます。システムプロキシやVPNサービスは、通信をクライアントに届ける役割を担います。両者は別の問題を解決するものです。ブラウザー拡張機能でプロキシを個別に指定している場合や、Androidでアプリごとの除外を有効にしている場合、対象のプログラムが現在の接続を迂回することがあります。まず基本設定に戻して動作を確認し、成功した後で特殊なルールを少しずつ追加してください。
実際に使うWebページやアプリを開き、正常に読み込めるか確認してからクライアントのログを確認します。接続スイッチがオンであることや、ノードテストに結果が出ることだけでは、実際に使えるとは限りません。ページを開けない場合は、まずシステム時刻を確認し、次にDNS、ノードのパラメーター、ルーティングを調べます。特定のアプリだけで問題が起きる場合は、そのアプリが独自のプロキシを使っていないか、アプリごとのルールで除外されていないかを確認してください。
テストに成功したら、現在のノード、ルーティングモード、DNS設定を記録し、次回の変更時に比較できるようにします。以降TUNを有効にしたりカスタムルールを追加したりする際は、項目を1つ変更するごとに再テストしてください。問題が起きても、すべての設定をリセットするのではなく、直前の正常な状態に戻せます。画面ごとの操作手順はガイドを、設定項目の関係はJSONガイドを参照してください。
クライアントとコアの関係
エコシステムの関係を理解すると、設定が適用される範囲を把握しやすくなります。製品名が似ていても、すべての設定を相互に使えるとは限りません。GUIクライアント、実行コア、プロトコルを区別しておくと、異なる層の操作を混同せずにガイドを読めます。
Project VはV2Rayのエコシステムを理解する出発点です。V2Rayはインバウンド、アウトバウンド、ルーティングなどの機能を、設定可能なネットワークツールとしてまとめています。V2FlyはV2Rayのコミュニティ開発を引き継ぎ、XrayはV2Ray関連のコードから発展して、独自の機能や設定の進化を続けています。これらは同じ製品の別テーマではありません。名前だけで新しいプロトコルや設定項目への対応を判断しないでください。
一般のユーザーが最もよく使うのはGUIクライアントです。クライアントはサブスクリプション、ノード一覧、システムプロキシ、ログへのアクセスを操作しやすい画面にまとめ、実際のデータ処理はその背後でコアが行います。そのため、画面に設定項目が表示されていても、どのコアでも同じパラメーターを受け付けるとは限りません。ガイドの手順を使う前に、対象のクライアントとコアの組み合わせを確認してください。
v2rayNGはXrayコアを使用するAndroid向けオープンソースクライアントで、v2flyNGはV2Flyコアを使用する代替候補です。v2rayNはデスクトップ向けで、実際に利用できるプロトコルは使用中のコアとその対応状況によって異なります。ノードリンクに記載されたプロトコル名は設定の一部にすぎません。通信方式、TLS、サーバー名などのパラメーターも接続の成否に影響します。
VMess、VLESS、TrojanはGUIの見た目を表すものではなく、単純に速度順に並べられるものでもありません。実際の通信速度や安定性は、サーバー側の実装、回線、通信設定、ローカル環境によって異なります。正常に使えている設定があるなら、名称が新しいという理由だけで移行する必要はありません。必要な機能がある場合に、クライアント、コア、サーバーがすべて対応しているか確認してください。
v2rayN、v2rayNG、v2flyNGはいずれもソースコードが公開され、コミュニティによる開発・保守が行われており、クライアントは無料で利用できます。コアのV2Fly V2Ray coreとXray coreはMPL 2.0ライセンスを採用しています。GUIクライアントにはそれぞれ別のライセンス条件があります。クライアントと利用するコアは別々のプロジェクトであり、1つのプロジェクトのライセンス説明でソフトウェア一式のすべての条件を代用することはできません。
日常的なインストール・利用と、コードを改変して再配布することは異なる状況です。二次開発や再パッケージを行う場合は、各プロジェクトのライセンスファイルを個別に読み、ソースコード、表示義務、配布に関する条件を確認してください。このサイトでは操作と設定を中心に解説しています。オープンソースに関する説明はプロジェクトの関係を理解するためのもので、具体的なソフトウェアのライセンス文書に代わるものではなく、当サイトが各プロジェクトの開発に参加していることを示すものでもありません。
クライアントの更新では、UIや依存コンポーネントが変更されることがあります。コアの更新ではプロトコルの挙動や設定項目への対応が変わることがあり、GeoIPやGeoSiteのデータ更新では、一部のルーティング用リストの内容が変わります。それぞれ別の変更として理解してください。更新後に動作が変わった場合は、まず変更履歴とログを確認し、ルーティングとDNSの設定が以前と同じかを調べます。すべての変化をノードだけのせいにしないようにしましょう。
更新前に復元できる設定を保存し、更新後はまず基本的な接続を確認してからカスタムルールをテストします。古いガイドではメニュー名が変わっていることがあり、設定例も特定のコアだけを対象にしている場合があります。このサイトでは、基本操作をガイドページに、構造や設定項目の説明をJSONガイドに、具体的な問題の記録を使用メモにまとめています。現在の症状に合わせて参照してください。
使用メモ
「使えない」という症状でも、原因はアプリ、システムプロキシ、DNS、ルーティング、サーバーなどさまざまです。以下の記事では症状ごとに確認手順を整理しています。まず影響範囲を特定してから変更する項目を決め、再インストールを繰り返して本当の原因を見えにくくしないようにしましょう。
速度低下の原因をノード負荷、回線品質、通信プロトコル、ローカル設定の4つに分けて順番に確認し、どこがボトルネックなのか、何を調整すべきかを見極めます。
Webページの表示が遅い場合と、大容量ファイルのダウンロードが遅い場合では、原因が異なることがあります。アプリとテスト条件を固定してからノードやネットワーク環境を比較すると、偶発的な変動による誤判定を減らせます。1回の接続テストだけで回線品質を決めつけないでください。
原因を段階的に切り分ける方法を見る →時刻同期、DNS設定、ルーティングルール、アプリごとのプロキシ設定、ノードの順に確認し、「接続済み」と表示されるのにインターネットへ接続できない原因を特定します。
まず、すべてのアプリで異常が起きているのか、特定のアプリだけ開けないのかを切り分けます。ログからリクエストがコアに届いているか確認し、通信を取り込めていない状態でノードを何度も変更するのは避けましょう。通信を取り込めているのに名前解決に失敗する場合は、DNSの経路を確認します。
接続確認チェックリストを見る →ブラウザーがプロキシを使わない場合は拡張機能やPAC設定、ターミナルが使わない場合は環境変数が原因のことがあります。記事ではそれぞれの設定を別々に確認し、検証用コマンドも紹介します。
システムプロキシの設定がすべてのプログラムで使われるとは限りません。原因を調べる際は、まずアプリがどの設定を参照するかを確認し、次にローカルの待ち受けアドレスとポートを確認してください。ブラウザー拡張機能、ターミナルの環境設定、クライアントのルーティングルールは、それぞれ個別に検証します。
システムプロキシのトラブル対処を見る →