デスクトップ · Windows / macOS / Linux
v2rayN
デスクトップ向け GUI クライアントで、Windows、macOS、Linux に対応。既定で Xray コアを採用し、サブスクリプション管理、ルーティング分割、ログ確認を同じ画面で行えます。
Project V エコシステム · Xray / V2Fly デュアルコア
3つの V2Ray GUI クライアントのダウンロード入口とインストール・設定ガイド:Windows・macOS・Android・Linux の4プラットフォームそれぞれに手順を用意し、サブスクリプションの読み込み、ルーティング分割、ログの切り分けまでステップごとの説明と設定例を掲載しています。
サブスクリプション管理、ルーティング分割、コアの選択、ログ診断は、日常的に最もよく触れる4つの設定です。以下では設定例ごとに順を追って説明します。
サブスクリプション → サブスクリプションを追加
アドレス https://example.com/api/v1/client/subscribe?token=xxxx
メモ サンプルサブスクリプション
更新間隔 1440 分
自動更新 オン
サブスクリプションリンクはノード設定の配布手段です。クライアントは設定した間隔でノード一覧を取得し、ローカルにはリンク自体だけを保存します。ノードの追加・削除は配布側がサーバー上で行います。v2rayN は複数のサブスクリプションを追加でき、それぞれに更新間隔を設定できます。自動更新をオフにして手動更新に切り替えることも可能です。v2rayNG のサブスクリプション入口はサイドバーにあり、読み込み後は長押しで名前を変更できます。読み込みに失敗する原因は大きく3つです。リンク自体が無効になっている、取得時にネットワークが通らない、返ってくる内容が標準的なノード一覧ではない。切り分けでは、まずブラウザでリンクを開いて応答があるか確認し、次にクライアントの更新ログで具体的なエラーを確認します。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{ "type": "field", "domain": ["geosite:cn"], "outboundTag": "direct" },
{ "type": "field", "ip": ["geoip:cn"], "outboundTag": "direct" },
{ "type": "field", "network": "tcp,udp", "outboundTag": "proxy" }
]
}
}
ルーティングは、ある接続をプロキシ経由にするか直接接続にするかを決めます。ルールは上から下へ順に照合され、一致した時点で評価が止まります。そのため、直接接続のルールはフォールバックのプロキシより前に書く必要があります。ドメインルールでは geosite:cn で中国本土の主要サイトをカバーし、IP ルールでは geoip:cn で名前解決後のアドレスを拾います。domainStrategy を IPIfNonMatch に設定すると、ドメインルールに一致しなかった場合にのみ IP を解決してもう一度照合します。ルールを変更した後は、設定の再読み込みかコアの再起動をしないと反映されません。ログには実際に一致したルールのタグが出力されるので、分割が意図どおりか検証できます。
コア設定
現在のコア Xray-core
代替コア V2Fly-core
切り替え手順 設定 → コア設定 → コアファイルを選択
反映方法 コアの再起動後に反映
GUI クライアント自体はプロキシ通信を処理しません。実際に接続を確立するのはコアです。v2rayN と v2rayNG は既定で Xray-core を採用し、V2Fly-core への切り替えにも対応しています。両者は VMess、VLESS などのプロトコル基盤を共有し、設定ファイルの形式もほぼ共通です。Xray は REALITY や XTLS Vision といった新機能への追随が早く、V2Fly は古い設定との互換性をより保守的に保ちます。コアの切り替えが影響するのは端末側の解決とアウトバウンドの実装だけで、ノードが使えるかどうかはサーバー側の設定次第です。新しいコアであるプロトコルがエラーになる場合は、もう一方のコアで試して、原因が設定にあるのかコアの違いにあるのかを切り分けられます。
{
"log": {
"loglevel": "warning",
"access": "none",
"error": ""
}
}
実行ログは、設定の読み込み、ノードとのハンドシェイク、ルールに沿ったアウトバウンドという3つを時系列で記録します。ログを見るときは最初の error を探し、その上数行で前後の状況を確認します。failed to parse は設定の構文エラー、connection refused は接続先に到達できない状態、context deadline exceeded はタイムアウトを表すことが多いです。loglevel を warning にすると日常的なノイズを減らせ、debug にするとハンドシェイクの流れを詳しく確認できます。調査が終わったら元に戻してください。ログパネルはクリアとエクスポートに対応しており、問題が起きた時刻と照らし合わせると原因を特定しやすくなります。
プラットフォームごとにクライアントとインストールパッケージの形式が異なります。カードをクリックすると、ダウンロードページでファイルの詳細とシステム要件を確認できます。
v2rayN はデスクトップ版とクラシックな WPF 版の2つの入口があり、いずれも x64 のインストールパッケージです。使い方に合わせて選んでください。
ダウンロードへチップのアーキテクチャに合わせて Apple Silicon 版か Intel 版を選びます。インストール後はクライアントがシステムプロキシを引き継ぎます。
ダウンロードへv2rayNG が主な選択肢で、v2flyNG はコアが異なるため、古い設定との互換性が必要な場合の代替として使えます。
ダウンロードへdeb と rpm の2種類のパッケージ形式があり、x64 と arm64 それぞれに対応ファイルが用意されています。ディストリビューションに合わせて選んでください。
ダウンロードへ3つのクライアントはいずれも Project V のオープンソースプロトコル体系の上に成り立っています。コアとクライアントの関係を理解しておくと、バージョ選 びや設定の読み解きがしやすくなります。
Project V はオープンソースのネットワークプロキシツール群の総称で、当初は v2ray-core コアとその設定プロトコルを指していました。2020年前後、コミュニティはメンテナンスの進め方をめぐって意見が分かれます。一方のチームは V2Fly の名で v2ray-core の保守を続け、もう一方のチームは同じプロトコル体系の上で転送層を書き直し、Xray-core が生まれました。現在「V2Ray クライアント」と呼ばれているものは、実際にはこの2つのコアの GUI フロントエンドです。クライアントが画面、サブスクリプション管理、ルーティング設定を担い、コアが接続の確立、暗号化、転送を処理します。
V2Fly と Xray は VMess、VLESS、Trojan などのプロトコル基盤を共有しており、設定ファイルのフィールド名や構造もほぼ同じで、同じ設定をたいていは両コア間で移行できます。違いは進化の方向性です。Xray は転送性能と新しいプロトコル機能を重視し、REALITY や XTLS Vision といった方式はいずれも Xray で先に実装されました。V2Fly は安定性を重視し、旧バージョンの設定との互換性をより保守的に保ちます。v2rayN と v2rayNG は既定で Xray コアを使い、コア切り替えの入口も用意しているので、比較検証がしやすくなっています。
3つのクライアントはいずれもオープンソースライセンスで公開され、ソースコードは誰でも確認でき、利用や配布に費用はかかりません。v2rayN と v2rayNG は GPL-3.0、V2Fly コアは MIT、Xray コアは MPL-2.0 を採用しており、いずれも著作権表示を保持したうえでの自由な再配布を認めています。日々の保守はコミュニティが担っており、不具合報告やリリース、ドキュメント更新は商業主体に依存していません。これも同種のツールが長く使われ続けている理由のひとつです。
サイト内のダウンロード入口は、バージョン一覧を通じて現在のリリースファイルへ動的に解決されます。一覧はデプロイ層が管理しており、ページ自体はインストールパッケージをキャッシュしません。クライアント側の更新は、それぞれの内蔵チェック機能やリリースチャネルが行います。コアとクライアントのバージョンは独立しているため、個別にアップグレードできます。サブスクリプション内容の更新はまた別の経路です。配布元がサーバー側でノードを追加・削除し、クライアントはサブスクリプションに設定した間隔で取得するため、ローカルで設定を手動編集する必要はありません。
サイト内のチュートリアルは、結論を先に示してから手順を並べる構成です。設定例はクライアントの実際の設定項目から引用し、用語は用語解説ページの項目に統一しています。GUI クライアントの画面はバージョンごとに変わるため、ドキュメントではボタンの絶対位置ではなく設定のたどり方を説明します。画面と説明が一致しない場合は、お使いのクライアントのバージョンの設定項目を優先してください。問題診断ページは症状ごとに章を分けており、現象を特定してから該当する章を読む流れになります。
デスクトップ · Windows / macOS / Linux
デスクトップ向け GUI クライアントで、Windows、macOS、Linux に対応。既定で Xray コアを採用し、サブスクリプション管理、ルーティング分割、ログ確認を同じ画面で行えます。
モバイル · Android
Android 向けクライアントで、Xray コアを採用。サブスクリプションの読み込み、アプリ単位の分割、ローカル DNS 設定に対応し、画面はタッチ操作に合わせたレイアウトです。
モバイル · Android
Android 向けの V2Fly コア版で、画面は v2rayNG と共通です。古い設定との互換性が必要な場合や、コアの違いを比較したい場合に向いています。
よくある4つの質問に簡潔に答えます。分類別の Q&A はよくある質問ページ、体系的な切り分けは問題診断ページをご覧ください。
プラットフォーム別のインストール、プロトコル解説、トラブルシューティングごとにまとめた最近の記事で、いずれも照合できる設定例付きです。
Windows で v2rayN の2つの画面バージョンをどう選ぶか、インストールから接続までの手順、トレイ、権限、スタートアップ登録などのつまずきやすい点をまとめます。
全文を読む →TLS ハンドシェイクと転送層の暗号化から入り、REALITY と XTLS Vision がそれぞれ解決する課題、その代償、適用条件を説明します。
全文を読む →中国本土と海外の分割を例に、ルーティングルールの照合順序、ドメインルールと IP ルールの書き方、プロキシと直接接続の境界を分解して解説します。そのまま使えるルールのひな形付き。
全文を読む →