クライアントの入手先 / 設定項目ガイド
v2rayNのダウンロードと設定ガイド
VLESSノードの取り込みからルーティングまで、4つのOS向けクライアントとconfig.jsonの設定項目を紹介します。
CLIENT / PLATFORM
デスクトップではv2rayN、Androidではv2rayNGが主な選択肢です。まずOSとCPUアーキテクチャを確認してから、対応するインストーラーを選びましょう。同じサブスクリプションを複数のクライアントで使えますが、画面上の設定項目やローカルポート、ルーティングの初期設定は異なる場合があります。ダウンロードページでは入手先とパッケージの種類を案内しており、トップページには個別のバージョンを掲載していません。
v2rayN / Desktop · WPF
サブスクリプションのグループ分けやノード選択、システムプロキシの管理をデスクトップでまとめて行えます。ダウンロードページではデスクトップ版と従来のWPF版を案内しています。前者は新世代のクロスプラットフォームUI、後者は従来のデスクトップ操作に対応しています。まずOSとの互換性を確認し、そのうえで使いたいUIを選びましょう。同じPCに両方をインストールする必要はありません。
初回起動後は、コアが正常に動作することと、ローカルの待ち受けポートが競合していないことを確認してからノードを追加します。更新前にサブスクリプショングループや独自ルーティングを保存してください。設定を移行する場合は、実行フォルダーをむやみに上書きせず、クライアントのエクスポート機能を使いましょう。
ダウンロードへ Windows クライアント →v2rayN / Apple Silicon · Intel
デスクトップでのサブスクリプションやルーティング管理には、v2rayNも使えます。まず「このMacについて」でチップを確認し、Apple Siliconならarm64、Intelならx64を選択してください。CPUアーキテクチャによってインストーラーが異なるため、外観や購入時期だけで判断しないようにしましょう。
インストール後は、アプリの起動やネットワーク権限に関するシステムの通知を確認してください。システムプロキシが適用されるのは、その設定に対応したアプリだけです。ターミナルツールや独自のプロキシ設定を持つアプリでは、個別の設定が必要な場合があります。接続できないときは、まず対象アプリがどのプロキシ経路を使っているか確認しましょう。
ダウンロードへ macOS クライアント →v2rayNG / v2flyNG
まずはXrayコアを採用したv2rayNGを確認しましょう。V2Flyとの設定互換性が必要な場合は、v2flyNGも選択肢になります。比較的新しい端末の多くはarm64ですが、アーキテクチャが分からない場合は汎用インストーラーの説明を確認してください。2つのクライアントでは対応するコアが異なるため、名前が似ていてもすべての設定項目が共通とは限りません。
初回接続時は、システムのVPN接続許可が必要です。ほかのVPNがすでに接続されている場合は、競合していないか確認してください。バックグラウンドで接続が切れる場合は、バッテリー最適化やバックグラウンド実行の制限が原因のこともあります。バックグラウンド実行を許可したうえで、ログからノードや名前解決の問題がないか確認しましょう。
ダウンロードへ Android クライアント →v2rayN / deb · rpm
ディストリビューションのパッケージ管理方式に合わせてdebまたはrpmを選び、x64かarm64かも確認してください。Debian系とRPMを採用するディストリビューションでは、入手先が異なります。パッケージ形式は機能の優劣を示すものではありません。デスクトップ環境やシステム依存関係、ネットワーク権限もインストールや起動に影響します。
GUIクライアントでノードや設定を管理し、実際の通信はコアが処理します。システムプロキシが有効になるかどうかは、デスクトップ環境やアプリの対応状況によって異なります。ブラウザーでは接続できてもコマンドラインツールで接続できない場合は、ツール側のプロキシ設定を確認してください。すぐにノードを変更したり、設定全体を書き直したりする必要はありません。
ダウンロードへ Linux クライアント →CONFIG / FIELD INDEX
GUIはノードや設定を管理し、コアは設定を読み込んで接続を処理します。ここでは、実際の用途に沿って両者の役割を整理します。コードは項目の位置を確認するための一部抜粋であり、そのまま接続に使える完全なノード設定ではありません。構文は使用するコアに合わせてください。
VMess、VLESS、Trojan、Shadowsocksは、それぞれ異なる送信プロトコルです。トランスポート方式とセキュリティ層は、別の設定項目で指定します。ノードを取り込んだら、サーバーアドレス、ポート、トランスポート、TLSの設定をあわせて確認してください。REALITYはセキュリティの仕組みであり、単独のノードプロトコルではありません。v2rayNやv2rayNGで特定の組み合わせが使えるかは、選択したコアによって異なります。プロトコル名だけで判断するのではなく、サーバーから提供された設定一式の互換性を確認し、ハンドシェイクログも確認しましょう。
送信設定の項目を見る →{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}
]
}共有リンクには通常、1つのノード情報が含まれます。サブスクリプションURLは、更新可能なノード一覧を取得するためのものです。先にサブスクリプショングループを作成してから更新し、ノードを選べば、手動で取り込んだ際の重複を減らせます。サブスクリプショングループはクライアントが管理するデータであり、config.json共通のトップレベル項目ではありません。実行時には、選択したノードがコアで認識できる送信オブジェクトに変換されます。例にあるtagはルーティングから参照する名前で、サブスクリプションURLではありません。手動で追加したノードは専用のグループに分けると、サブスクリプション更新時に混同しにくくなります。
サブスクリプションの取り込み手順を見る →{
"outbounds": [
{
"tag": "local-socks",
"protocol": "socks",
"settings": {
"servers": [
{
"address": "127.0.0.1",
"port": 1080
}
]
}
}
]
}ルーティングでは、リクエストの条件と送信タグを結び付けます。ドメイン名、IP、受信タグなどを条件にし、outboundTagで送信先を指定できます。ルールの順番によって結果が変わるため、一般に具体的な条件を広い条件より前に置きます。この例ではexample.comとそのサブドメインをdirect送信に割り当てています。outboundsにこのタグが定義されている必要があります。すべての通信の出口を何度も切り替えるより、対象を絞ったルールのほうが検証しやすくなります。一度に変更するのは1つにして、アクセスログで実際に適用されたか確認しましょう。
routingルールを見る →{
"routing": {
"rules": [
{
"type": "field",
"domain": [
"domain:example.com"
],
"outboundTag": "direct"
}
]
}
}DNSはドメイン名の解決方法を決め、policyは一部の接続動作を制御します。両者は別の設定です。コアのDNS、システムDNS、ブラウザー内蔵の名前解決が同時に使われることもあり、どれか1つを変更してもすべてのリクエストに反映されるとは限りません。この例ではlocalhostを使ったローカル名前解決を指定し、ユーザーレベル0のハンドシェイクタイムアウトを設定しています。実際の運用では、ルーティングで接続先のドメイン解決が必要か、そのDNSリクエストがどの経路を通るかも確認してください。ドメイン名でのみアクセスできない場合は、まず名前解決と接続のどちらで失敗しているかを切り分けてから設定を変更しましょう。
DNS設定を見る →{
"dns": {
"servers": ["localhost"]
},
"policy": {
"levels": {
"0": {
"handshake": 4
}
}
}
}v2rayNでは複数のコアを管理できますが、切り替えてもすべての設定項目が自動変換されるわけではありません。V2FlyとXrayには共通するエコシステムの背景がある一方、それぞれ独自のプロトコルやパラメーターがあります。特にREALITYなどを設定する場合は、対応範囲を確認してください。v2rayNGとv2flyNGの主な違いにも、採用するコアの系統があります。設定に切り替え用の共通core項目はなく、操作はクライアントから行います。切り替え後はwarningログで起動状態を確認し、ノード接続を検証してから、独自のルーティングとDNS設定を戻しましょう。
3つのクライアントを比較 →{
"log": {
"loglevel": "warning"
}
}START / THREE STEPS
まず3つの違いを確認
クライアントはローカルで設定を管理する画面、ノードは接続先の情報一式、サブスクリプションはノード一覧を取得するURLです。クライアントをダウンロードしても、利用できるノードは別途必要です。ソフトウェアに汎用のサーバーアカウントは付属しません。これらを区別すると、問題がインストール、取り込み、接続のどの段階で起きているか判断しやすくなります。
共有リンクやサブスクリプションURLには、アクセス認証情報が含まれている場合があります。URL全体を公開スクリーンショットに載せたり、試験目的で不明な変換サービスに渡したりしないでください。問題を報告する際は、エラーの種類、コア名、関連項目を残し、URL内の識別情報は隠しましょう。
以前のクライアント設定を引き継ぐ場合は、使用中のノード、プロキシモード、独自ルールを事前に記録してください。最初は必要最小限の接続を確立し、正常に動作することを確認してから追加設定を1つずつ戻しましょう。過去の設定に起因する問題を新しい環境に持ち込まずに済みます。
クライアントの選び方を見る →v2rayNではサブスクリプショングループの設定を開き、自分が利用できるURLを追加して保存し、サブスクリプションを更新します。単一ノードはクリップボードから取り込みます。v2rayNGでも、サブスクリプショングループまたは共有リンクからノードを追加できます。メニュー名は画面の更新で変わることがあります。入力内容を目安に、複数ノードを取得する場合はサブスクリプション、単一のプロトコルリンクの場合はノードの取り込みを選びましょう。
更新後は、一覧にノードが表示されていることを確認し、名前、アドレス、プロトコルが想定どおりか確認してください。取り込みに成功しても、サーバーが稼働中とは限りません。一覧が空の場合は、サブスクリプションURLの有効期限、認証の要否、現在のネットワークから取得できるかを確認しましょう。
ノードを1つ選び、用途に合わせてシステムプロキシとルーティングモードを設定します。システムプロキシは「アプリの通信をクライアントに渡すか」を決め、ルーティングは「受け取った通信をどこへ送るか」を決めるため、互いの代わりにはなりません。デスクトップではシステムプロキシに対応したブラウザーで確認し、AndroidではシステムのVPN接続許可が完了しているか確認してください。
初めて使う場合は、クライアントの基本ルーティング設定をそのまま使うのがおすすめです。TUNは仮想ネットワークアダプターと追加の権限を必要とし、毎回有効にするものではありません。通常のプロキシ経路が安定してから、対象アプリのプロキシ対応状況に応じてTUNを使うか判断しましょう。複数のネットワーク層を同時に変更するのは避けてください。
選択した経路でアクセスする必要があるページを開き、クライアントのログとあわせて接続状態を確認します。遅延テストは参考情報であり、実際のアプリでのアクセス確認の代わりにはなりません。ノードのテスト結果が表示されても、DNS、TLS、対象サイトへのアクセスがすべて正常とは限りません。ログが読みづらくならないよう、まずはページを1つだけテストしましょう。
タイムアウトが発生したら、ローカルの受信、システムプロキシ、ルールの適用、リモートへの送信の順に確認します。接続拒否の場合は待ち受けポートと接続先ポートを、ハンドシェイクエラーの場合はシステム時刻、サーバー名、セキュリティ層の設定を確認してください。すべての設定を続けて変更するより、変更前後の結果を記録するほうが原因を特定しやすくなります。
PROJECT V / CORE / CLIENT
画面で管理し、コアが接続を処理
V2RayはProject Vのエコシステムに属するネットワークプロキシツールです。設定は受信、ルーティング、送信の3つに分けて考えられます。受信がアプリからのリクエストを受け付け、ルーティングが条件に照らして振り分け、送信が接続を実行します。DNS、ポリシー、ログは、それぞれ名前解決、接続動作、実行記録を補います。この構造を把握することがconfig.jsonを読む基本です。
V2Rayのコミュニティ開発を引き継ぎ、コアと関連する設定機能を保守しています。
V2Rayのエコシステムから派生した別のコア系統で、独自のプロトコルとセキュリティ機構を発展させています。
設定の見た目が共通でも、構文まで完全に同じとは限りません。項目が認識されない場合は、ノードの不具合と決めつけず、まずコアの種類と対応範囲を確認してください。特にプロトコル拡張、トランスポートのオプション、セキュリティ層の組み合わせは、各コアの対応状況に基づいて判断する必要があります。
v2rayNはデスクトップ向けで、サブスクリプション、ノード、ルーティング、選択可能なコアをまとめて管理できます。v2rayNGはAndroid向けでXrayコアを採用し、v2flyNGはV2Fly系のAndroid向けクライアントです。いずれもオープンソースですが、クライアント名はプロトコル名ではありません。また、クライアントが更新されても、コアの機能がすべて同じように更新されるとは限りません。
GUIではよく使う操作を選択肢としてまとめていますが、実行時にはコア用の設定が生成されます。そのため、画面上の1つのスイッチが複数のJSON項目に影響する場合があります。逆に、低レベルの設定すべてにGUIからアクセスできるとは限りません。独自設定が必要な場合は、クライアントが実行ファイルをどのように保存、生成、上書きするかを確認してから編集しましょう。画面から再生成された内容で変更が失われるのを防げます。
オープンソースとは、各ライセンスに定められた条件のもとで、ソースコードの利用、調査、改変ができることを指します。すべてのコンポーネントが同じライセンスとは限りません。V2FlyとXrayのコアコードは主にMPL-2.0を採用していますが、クライアント、依存ライブラリ、同梱コンポーネントのライセンスはそれぞれ確認してください。改変や再配布を行う場合は、著作権表示やソースコードの提供など、各プロジェクトの条件に従う必要があります。「無料」というだけで利用条件を判断することはできません。
コミュニティでは、画面の改善、設定への対応、コアの更新がそれぞれ進められています。更新内容を読む際は、どの層に関する変更かを確認しましょう。画面の変更は操作場所だけに影響する場合がありますが、コアの変更はプロトコルのパラメーター、接続動作、ルールの対応状況に影響することがあります。このサイトではダウンロード先と設定ガイドを案内していますが、各ソフトウェアプロジェクトのライセンス説明に代わるものではなく、ノードサービスも提供していません。
更新前にサブスクリプショングループ、独自ノード、独自ルールを保存しておきましょう。更新後は起動ログを確認し、普段使うノードやアプリで接続をテストしてください。特定の種類の接続だけに問題がある場合は、設定をすべて消去するのではなく、関連するルーティングやDNS設定を一時的に戻して1つずつ比較します。診断にログを使う場合は、詳細すぎる記録を長期間有効にしないようにしましょう。接続先のドメイン名など、アクセス情報が記録される場合があります。
設定を学ぶときも、同じ順序で進めると整理しやすくなります。まず基本の接続を動かし、次に送信タグとルールのマッチングを確認し、最後に名前解決とポリシーを調整します。各項目がどの段階に影響するか分かれば、変更が問題の解決につながったか判断できます。詳しい項目の型や例は設定ファイルのガイドをご覧ください。
NOTES / LATEST
基本の接続を確立したら、状況に応じて関連ガイドを確認しましょう。プロトコルの記事では各項目の仕組みを、ノード選びの記事ではテスト結果の見方を、トラブルシューティングのチェックリストでは問題の切り分け方を説明しています。動作している設定は残し、変更を1つずつ確認してください。
システムプロキシの状態、ローカルポート、DNSの名前解決、ルーティングルール、ノードの稼働状況、システム時刻の順に確認します。v2rayNのデスクトップ版とv2rayNGのAndroid版でよくあるケースを取り上げます。
記事を読む →速度テストの遅延の読み方、通信量倍率の計算、地域と回線の関係から、VMess、VLESS、Trojanの選び方まで、ノード選びの判断基準を順を追って解説します。
記事を読む →XTLS Visionが暗号化の重複をどう減らすのか、REALITYがTLSハンドシェイクをどう改善するのかを平易に解説し、Xrayコアの設定に使われるflowとsecurityの項目も紹介します。
記事を読む →