V2RAY · V2RAYN · V2RAYNG
サブスクリプションのインポートからルーティング設定まで、手順に沿ってv2rayN / v2rayNGを設定し、コアのログから接続問題を特定します。
CLIENT SELECTION
デスクトップではv2rayN、Androidではv2rayNGから確認しましょう。インストーラーのアーキテクチャは端末のプロセッサに合わせ、ファイル形式はOSやディストリビューションに応じて選びます。まずクライアントを決めてから既存のサーバー設定をインポートすると、インストールの問題と接続の問題を切り分けやすくなります。
デスクトップ版は新世代のクロスプラットフォームUIを採用し、WPF版は従来の操作性を維持しています。初めて使う場合は、デスクトップ版でサーバー一覧、サブスクリプショングループ、ログパネルを確認してみましょう。使い慣れた操作方法を優先する場合はWPF版も選べます。これはUIの違いであり、購入プランの違いや、サブスクリプションをインポートすれば必ず接続できるという意味ではありません。
インストール前にシステム設定でプロセッサのアーキテクチャを確認し、ダウンロードページの動作要件も読みましょう。起動後はサブスクリプショングループを追加して更新し、設定を1つ選んで実際に接続して速度を測ります。システムプロキシを有効にしても、反映されるのはシステムプロキシ設定に従うアプリだけです。ブラウザーが接続できても、すべてのアプリが同じ経路を使っているとは限りません。
ダウンロードへ「このMacについて」でチップ情報を確認します。Apple Siliconシリーズならarm64、Intelプロセッサならx64を選択してください。2つのインストーラーは異なるアーキテクチャ向けなので、両方をインストールする必要はありません。インストール中にシステム権限の確認が表示されたら、対象と入手元を確認したうえで、システムの手順に従ってください。
デスクトップクライアントは設定の保存、サーバーの切り替え、コアの実行パラメーターの生成を担い、実際の接続はコアが処理します。設定のインポート後は、現在選択されているサーバーとプロキシ方式を確認しましょう。クライアントを変更するときに、データディレクトリ全体をそのまま上書きするのは避けてください。元の設定を残し、サブスクリプションやルールを個別に移行すると、パスや権限の違いを見つけやすくなります。
ダウンロードへv2rayNGはXrayコアを使用するAndroid向けの第一候補です。v2flyNGはV2Flyコアを使用し、コアの要件に応じた選択肢です。比較的新しいスマートフォンなら、まずarm64版を確認しましょう。アーキテクチャがわからない場合は、汎用版の説明を参照してください。購入時期だけで判断せず、端末の実際のアーキテクチャとシステム要件を確認することが大切です。
初回接続時には、システムからVPN接続の許可を求められます。これは選択した通信をクライアントが処理するためのシステム機能です。許可した後は、アプリごとのプロキシ設定、ルーティングモード、バックグラウンド動作の制限も確認してください。バックグラウンドにしてしばらくすると切断される場合は、まずバッテリー最適化とプロセスの状態を確認し、すぐにサブスクリプションURLやサーバー設定が原因だと決めつけないようにしましょう。
ダウンロードへDebian、Ubuntuおよびその派生ディストリビューションでは通常debを、FedoraなどRPMパッケージ形式を採用するディストリビューションではrpmを選びます。さらにx64とarm64の違いも確認してください。パッケージ形式とプロセッサアーキテクチャは別々の条件です。形式が合っていてもアーキテクチャが異なれば、インストールや起動に失敗することがあります。
GUIクライアントを起動したら、まず通常の権限でサブスクリプション管理と基本的な接続テストを行い、追加権限が必要なネットワーク制御は後から検討しましょう。デスクトップ環境によってシステムプロキシへの対応は異なり、個別に設定が必要なアプリもあります。アプリごとに接続結果が異なる場合は、デスクトッププロキシに従っているか、どのDNSを使っているかを記録してから、TUNを有効にするか判断してください。
ダウンロードへクライアントのインストーラーに、すぐ使えるサーバーサービスは含まれていません。接続先アドレス、ポート、認証情報、サブスクリプションURLは、利用権限のあるサービスまたは自分で構築した環境から入手してください。インストール、インポート、速度測定、接続確認は、それぞれ順番に行います。
すべてのクライアントを見る →CONFIGURATION INDEX
設定の問題は、「設定の入手元」「通信の入口」「適用される出口」「ドメインの名前解決」の順に切り分けられます。以下の5つの項目から目的の設定を確認してください。例は関連フィールドのみを示しており、そのまま動作する完全な設定ではありません。実際のフィールドは、選択したコアとクライアントが生成する設定に合わせてください。
サブスクリプションはサーバー設定をまとめて取得するためのもので、接続の確立を意味するものではありません。v2rayNのサブスクリプショングループにURL全体を保存して更新します。Androidでも先にグループを追加し、設定を更新してください。リストに項目が表示されたら、使用するサーバーを選んで接続をテストします。以下はローカルSOCKSインバウンドの例で、サブスクリプションの内容とは別の階層です。ループバックアドレスで待ち受ける場合、接続できるのは同じ端末からだけです。更新に失敗したら、まずサブスクリプション取得時のログを確認してください。リモートアドレスの問題を直すためにインバウンドポートを変更しないでください。
{
"inbounds": [
{
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": true
}
}
]
}ルールはリクエストの出力先を決めるもので、サーバー自体の問題を解決するものではありません。プロキシ用と直結用の出力にわかりやすいタグを付け、具体的なルールから書き、最後にデフォルトの出力先を設定しましょう。以下ではプライベートアドレスをdirectという出力先に割り当てています。このタグは完全な設定内に存在し、参照するルールデータも利用可能でなければなりません。意図しない振り分けを調べるときは、先に一致したルールと、ドメインがIPアドレスに変換済みかを確認してください。ルール名だけで結果を判断したり、複数のルールを同時に変更したりしないようにしましょう。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}Webページが開けない原因は、サーバーの停止だけとは限りません。ドメインの名前解決が想定した経路を通っていない可能性もあります。システムDNS、アプリ独自の暗号化DNS、コア内蔵DNSを区別し、ルーティングによって名前解決が行われるかを確認しましょう。以下はコアのDNSサーバー設定を簡略化した例で、すべてのアプリの問い合わせが処理されるという意味ではありません。変更前後のログとアクセス結果を比較し、名前解決の設定は一度に1か所だけ変更してください。リモートDNSを使う場合は、DNSサーバーへの接続自体が確立できることも確認し、依存関係のループを避けましょう。
{
"dns": {
"servers": [
"1.1.1.1",
"8.8.8.8"
]
}
}TUNは仮想ネットワークインターフェースを使って通信を処理するため、より多くのアプリを対象にしたい場合に適しています。ただし、権限、ルーティング、DNSを連携させる必要があります。まず通常のプロキシ接続が使えることを確認してから、クライアントでTUNを有効にし、仮想インターフェースとシステムルートの変化を確認してください。以下はローカル接続テスト用のSOCKSインバウンドであり、TUNを有効にする設定ではありません。TUNの実装と設定形式はクライアントの構成要素によって異なるため、このJSONを仮想ネットワークインターフェースの設定としてそのまま使うことはできません。通信が切れたら、まずTUNを無効にしてログを保存してから原因を調べましょう。
{
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "udp": true }
}
]
}コアが起動できない問題と、接続後にタイムアウトする問題は発生段階が異なるため、分けて対処します。同じ起動中に最初に現れたエラーを見つけ、設定の構文、ポートの競合、フィールドの互換性を確認してから、リモート接続とTLSハンドシェイクを調べましょう。再現時に一時的にログレベルを上げると、問題の把握に役立ちます。調査後は通常のレベルに戻し、不要な出力を減らしてください。以下のwarning設定では警告とエラーを確認できます。ログを共有する前に、サブスクリプションURL、認証情報、実際のアドレスを削除し、エラーの種類と前後の記録だけを残しましょう。
{
"log": {
"loglevel": "warning"
}
}初回設定では、まずデフォルトのルーティングを維持し、必要なパラメーターがそろっているサーバー設定を1つ使って接続します。その後、ルールやDNS設定を段階的に追加しましょう。複数のスイッチを同時に有効にすると、調べる範囲が広がります。変更は一度に1つにして、変更前の値を記録しておけば、比較や復元が容易になります。
初回接続の設定手順を見る →PROJECT V ECOSYSTEM
V2Rayは、このプロキシツールのエコシステムを理解する出発点です。ただし、クライアント、コア、プロトコルはそれぞれ別のものです。ソフトウェア名だけを比べるよりも、各要素の役割を把握するほうが選びやすく、設定をそのまま流用したときの誤解も減らせます。
設定構造とプロキシコンポーネント
プロトコル処理と接続の実行
設定管理と操作画面
BACKGROUND
Project Vは、連携して動作する複数のコンポーネントにプロキシ機能を分けており、V2Rayはその中で広く使われている実装です。設定を理解するときは、インバウンドをアプリの通信入口、アウトバウンドを接続先への接続方法、ルーティングを両者の間で選択するルールと考えるとよいでしょう。DNS、ログ、ポリシーはそれぞれ名前解決、状態の確認、リソース管理を担います。この構成なら、1つの設定で複数の入口と出口を表現できます。サーバーアドレスだけを変えても、すべての接続問題が解決するとは限らない理由もここにあります。
GUIクライアントは、こうした構造をリスト、グループ、スイッチ、フォームに置き換え、日常的な管理を簡単にします。ただし、リモートサーバーの代わりになるものではなく、サーバー側の設定を担うものでもありません。リンクをインポートすると、通常は一連のパラメーターがローカルの設定項目に変換されます。実際に起動するとき、クライアントは現在のルーティングモード、待ち受けポート、ユーザー設定に応じて実行用の設定を再生成する場合があります。ガイドを読む際は、「インポート時に保存された設定」と「コアが実際に読み込む設定」を区別しましょう。2つのファイルや画面の内容が完全に同じだと考えないでください。
CORE FAMILIES
V2FlyはV2Rayのコミュニティによる保守を引き継ぎ、Xrayは関連コードの分岐から発展しました。両者には共通する設定概念がありますが、対応するプロトコル機能、フィールド、今後の開発は完全には一致しません。JSONの構造が似ていても、すべてのフィールドを相互に使えるとは限りません。あるコアが受け付けるトランスポート設定を、別のコアが同じ方法で解釈するとも限りません。互換性を確認するには、まずクライアントで実際に有効なコアを確認し、プロトコル、トランスポート層、セキュリティ層の組み合わせを照合してください。
VMess、VLESS、Trojan、Shadowsocksはプロトコル名、WebSocketやgRPCは通信方式、TLSは別レイヤーの接続セキュリティ設定です。1つのサーバー設定にこれらの名称が並んでいても、それぞれの役割は異なります。問題を調べるときは、アドレスとポート、認証情報、トランスポート経路、サーバー名の順に確認しましょう。コアを手当たり次第に切り替えても解決にはつながりません。コアの選択は、必要な機能が明確な場合に設定方針の一部として検討してください。
OPEN SOURCE CLIENTS
v2rayN、v2rayNG、v2flyNGはいずれもオープンソースのGUIクライアントで、コミュニティプロジェクトがソースコードを管理しています。v2rayNはデスクトップ向けで、サーバー管理、サブスクリプショングループ、ルーティングなどの機能を備えています。Android向けのv2rayNGはXrayコアを、v2flyNGはV2Flyコアを使用します。選ぶ際は、操作画面の好みよりも、端末、システム要件、サーバー設定との適合性を優先しましょう。名前が似ていても同じインストーラーではなく、データディレクトリをそのまま共有できるわけでもありません。
オープンソースライセンスは、ソフトウェアコードの使用、改変、再配布に関する条件を定めるもので、リモートサービスの利用可否を示すものではありません。V2RayとXrayのコアコードにはMPL 2.0が適用されます。個々のクライアントや同梱コンポーネントについては、それぞれのライセンスと表示を確認してください。クライアントは無料で使えても、リモートサーバー、ネットワーク接続、サブスクリプションサービスは別の事業者が提供している場合があります。ソフトウェアとサービスの提供元を区別すれば、問題の発生箇所を判断しやすくなり、サービス料金をクライアントのライセンス料と取り違えることもありません。
UPDATE & DIAGNOSIS
クライアントとコアの更新は、必ずしも同じ操作ではありません。画面の変更によって設定項目の場所が変わることがあり、コアの変更はフィールドの互換性やプロトコルの動作に影響する場合があります。更新前にサブスクリプショングループ、独自のルーティング、必要な個人設定を保存し、変更内容も確認してください。更新後は既存の設定で起動できるかを調べ、よく使う接続を確認します。基本的な接続が正常に動作してから、実験的なルールや通信制御の設定を戻しましょう。こうすれば、更新による変化を比較しやすい範囲に抑えられます。
更新後に問題が起きたら、設定をすべて削除して再インストールする前に、クライアントの種類、使用中のコア、OS、エラーが発生した段階を記録してください。コアが起動しない場合は最初の設定エラーを確認します。一部のドメインだけ開けない場合はDNSとルールの適用結果を調べます。ブラウザーは使えても他のアプリで使えない場合は、プロキシの適用範囲を確認しましょう。実際のサーバー、サブスクリプションURL、認証情報がログに含まれる場合は、先に隠してから再現手順をまとめてください。フィールドの意味や最小限の例は設定リファレンスで、具体的な操作手順は使い方ガイドで確認できます。
TECHNICAL NOTES
使い方ガイドでは一連の手順を、技術記事では個別の問題を取り上げています。インストールは終わったものの次に何を確認すればよいかわからない場合は、初回接続の記事をどうぞ。ボタンやパネルの役割を知りたい場合は、メイン画面の概要から確認できます。ルーティングを変更するなら、ルールの構文と適用順を確認してから進めましょう。
v2rayNのメイン画面を項目ごとに解説します。サーバー一覧の右クリックメニュー、サブスクリプショングループの切り替え、下部のログパネルの読み方、設定でよく使うスイッチを紹介します。
記事を読む →サブスクリプションをインポートしたら、まず実際に接続して速度を測り、使えるノードを選びます。次にシステムプロキシを有効にし、ブラウザーでのアクセスと出口IPの確認を通じて、通信がプロキシ経由になっていることを確かめましょう。
記事を読む →domainのprefix、full、regexpによるマッチング、ipとgeoipの記述方法、geosite分類の参照、上から順に適用されるルールとdomainStrategyの影響を解説します。
記事を読む →トラブル対処の記事を読むときは、問題がサブスクリプションの更新、コアの起動、接続の確立、アプリからのアクセスのどの段階で起きたかを確認しましょう。同じ「タイムアウト」でも原因となる段階は異なります。発生箇所と直前のログを照らし合わせると、何度も再試行するより原因を絞り込みやすくなります。
すべての記事を見る →