SETUP NOTES · 約10分

v2rayN 設定ガイド:サブスクリプション登録、プロキシモード、接続・動作確認

この入門手順では、初回利用時に必要な4つの作業だけを扱います。サブスクリプションをクライアントに登録し、通信の処理方法を決め、現在の設定で接続を開始し、ログと実際のアクセス結果で接続状態を確認します。

BEFORE STARTING

開始前:クライアントと有効なサブスクリプションを準備

設定には2つの条件があります。クライアントが正しくインストールされていること、そしてサブスクリプションURLが有効であることです。サブスクリプションはサービス提供元が管理し、クライアントはそこからサーバー設定を読み込んでコアに渡し、実行します。

デスクトップでは v2rayN、Android端末では v2rayNG を使用します。まだインストールしていない場合は、クライアントのダウンロードページでOSとプロセッサーアーキテクチャに合うバージョンを選んでください。インストール後にこのページへ戻ればよく、あらかじめコアファイルを変更したり、JSON設定を手入力したりする必要はありません。初回起動時にシステムネットワークやVPN権限の確認が表示されることがあります。内容を確認したうえで、端末のセキュリティ設定に従い、クライアントによるローカルプロキシサービスの作成を許可してください。

サブスクリプションURLは通常、HTTPSで始まる完全なリンクです。コピーする際は先頭、末尾、クエリパラメーターが欠けていないことを確認し、検索欄や公開チャット、関係のないアプリに貼り付けないでください。サブスクリプションには個人アカウントやサービス権限が紐づくことがあるため、パスワードと同じように機密情報として扱います。提供元がQRコードを案内している場合、v2rayNGではサブスクリプション管理画面またはスキャン機能から読み取れます。以後の更新を安定させるため、最終的に保存されるのが一時的な単一ノードではなく、サブスクリプション項目であることも確認してください。

クライアントに古い設定が残っていても、すぐに削除する必要はありません。現在使っているサブスクリプショングループとサーバー名を記録してから新しい項目を追加すれば、必要な設定を誤って削除せずに済みます。以下の4ステップは順番どおりに構成しています。初回操作では途中の手順を飛ばさないことをおすすめします。各ステップが終わるたびに画面の反応を確認してから、次へ進んでください。

SUBSCRIPTION

サブスクリプションを登録してサーバー一覧を取得

サブスクリプションは接続スイッチではなく、更新可能な設定ソースです。URLを保存した後、手動で一度更新する必要があります。更新して初めてサーバー項目がクライアントの一覧に追加されます。

v2rayN デスクトップ版にサブスクリプションを追加

v2rayNを起動し、まずメインウィンドウ上部にある「サブスクリプショングループ」または「サブスクリプション」メニューを探します。バージョンによってメニュー名は多少異なりますが、サブスクリプショングループの設定と更新機能は共通して用意されています。グループ設定を開いて追加を選び、備考欄にサービス名や用途など識別しやすい名前を入力し、完全なサブスクリプションURLをURL欄に貼り付けます。備考はローカルで識別するためのもので、サブスクリプションの内容は変更しません。

設定を保存してメインウィンドウに戻り、サブスクリプションメニューから「現在のサブスクリプションを更新」または「すべてのサブスクリプションを更新」を選択します。クライアントがサブスクリプションの内容を取得し、サーバー設定を解析します。更新が完了すると、メイン一覧に複数のサーバー項目が表示されます。一般的な列には、別名、アドレス、ポート、通信方式、サブスクリプショングループなどがあります。一覧に内容が表示されて初めて登録が完了したことになります。設定画面にURLが1行表示されただけでは、サーバーがローカルに更新されたとは限りません。

更新後も一覧が空の場合は、サブスクリプション設定を開き直し、URLの前後に空白がないことと、先ほど作成したグループが選択されていることを確認します。続いて画面下部のログを確認してください。ネットワーク要求に失敗した場合はタイムアウトや接続エラー、形式を解析できない場合はサブスクリプション内容に関するメッセージが表示されます。更新ボタンを連続して押さず、まずURLがまだ利用できるか確認してから、もう一度更新してください。

v2rayNG Android版にサブスクリプションを追加

v2rayNGを開き、サイドメニューの「サブスクリプショングループ設定」に進みます。右上の追加ボタンをタップし、サブスクリプション名を入力してURLを貼り付け、保存します。サーバー一覧に戻ったら右上のメニューを開き、「サブスクリプションを更新」を実行します。更新中は現在の一覧が一時的に表示されたままになることがあります。完了すると登録結果が表示され、サーバー一覧に該当する項目が追加されます。

サービス提供元からQRコードを案内された場合は、クライアントのスキャン機能で読み取れます。ただし、そのQRコードがサブスクリプションなのか、単一サーバーなのかを先に確認してください。単一サーバーを登録すると通常は固定設定が1件作成され、以後のサブスクリプション更新には追従しません。サブスクリプション項目なら再度更新してサーバーの変更を受け取れます。継続的に管理する設定には、サブスクリプショングループとして保存する方法が適しています。

サブスクリプションには複数のプロトコルや通信設定が含まれることがあります。入門段階では、アドレス、ポート、TLS、通信方式などを個別に変更する必要はありません。これらはサブスクリプションから一括して提供されます。項目を手動で変更すると、サーバー側と設定が一致しなくなる可能性があります。JSON構造全体を理解したい場合は、別途設定大全の outbounds 解説を参照してください。ここでは項目を選択できる状態になったことだけ確認します。

次のステップ:プロキシモードを選択 →
PROXY MODE

プロキシモードと通信範囲を選択

プロキシモードは、どのリクエストを現在のサーバーで処理するかを決めます。サーバーが利用可能かどうかとは別の問題なので、初回設定では範囲が明確で確認しやすいモードを選びます。

デスクトップ版ではまずシステムプロキシとルーティングモードを区別

v2rayNの「システムプロキシ」は、ブラウザなどOSのプロキシ設定に従うアプリがリクエストをクライアントへ送るかどうかを制御します。「ルーティングモード」は、リクエストがクライアントに入った後、プロキシ経由、直接接続、ブロックのどの出力先へ進むかを決めます。両者は連携して動きますが、作用する層が異なります。サーバーを選択しただけでシステムプロキシを有効にしていない場合、通常のブラウザは元のネットワーク経路でアクセスします。システムプロキシを有効にして初めて、クライアントがこれらのアプリのリクエストを受け取ります。

初回操作では、トレイメニューまたはメインウィンドウからシステムプロキシの自動設定を選び、クライアントのルールモードを使用するとよいでしょう。ルールモードは、組み込みまたはサブスクリプションで提供されたルーティングルールに従って通信先を決めるため、日常利用や後のトラブル対応に適しています。グローバルモードは広い範囲のリクエストをプロキシサーバーへ送るため、アクセス問題がルールに起因するか短時間で切り分ける際に役立ちます。ただし、すべての状況で固定的に使う設定ではありません。直接接続したいローカルアドレス、LAN内の機器、特定ドメインは、ルーティングルールで明示的に処理してください。

macOSとLinuxのv2rayNデスクトップ版でも、システムプロキシの状態を確認する必要があります。デスクトップ環境やネットワーク管理コンポーネントが異なるため、メニュー名や権限確認の表示はWindowsと完全には一致しません。「システムプロキシが有効」という状態を基準にし、使用中のブラウザがシステムプロキシを読み取ることを確認してください。独自のプロキシ設定を持つアプリは、システム設定に自動追従しない場合があります。その場合はアプリ内でシステムプロキシの使用を個別に選択します。

Android版でアプリごとのプロキシ範囲を決める

v2rayNGはシステムのVPNサービスを通じて通信を処理します。初回利用では、まずデフォルトのルーティング設定のまま確認する方が簡単です。いきなり複雑なアプリ別プロキシを有効にする必要はありません。有効にする場合は、「選択したアプリのみプロキシ」と「選択したアプリをプロキシから除外」のどちらかを明確に選びます。意味は正反対です。確認に使うブラウザが一覧で選択されていなければ、接続ボタンが動作中になっていても、ブラウザの通信がクライアントを経由しないことがあります。

目的がサブスクリプションとサーバーの利用可否を確認するだけなら、アプリ別の制限を一時的に無効にして確認経路を単純にします。接続できた後で、必要に応じてアプリの範囲を絞ってください。これにより、「サーバーが利用できない」問題と「アプリがプロキシ対象に含まれていない」問題を切り分けられ、初回設定で変更する要素が増えすぎるのを防げます。

モードを決めたら、すぐに多数の設定画面を確認する必要はありません。まずサーバー一覧に戻り、具体的な項目を選んで接続を確立します。ドメイン、IP、インバウンドタグ、アウトバウンドタグの細かなルールが必要な場合は、基本接続を確認してから設定大全の routing 章を読んでください。

次のステップ:接続を確立 →
CONNECT

サーバーを選択して接続を確立

接続には2つの段階があります。まず現在のアクティブサーバーを指定し、その後クライアントのコアとシステムプロキシまたはVPNサービスを実行状態にします。

サーバーを現在のアクティブ項目に設定

サーバー一覧から、先ほどのサブスクリプショングループに属する項目を1つ選びます。v2rayNでは通常、ダブルクリック、右クリックメニュー、ショートカット操作でアクティブサーバーに設定できます。成功すると、その行に選択マーク、色の変化、アクティブ状態などが表示されます。v2rayNGではサーバー名を直接タップします。選択された項目には通常、左側に選択マークが表示されます。一覧を眺めるだけで終わらせず、クライアントが明確に1つのアクティブ設定を指していることを確認してください。

初回の選択で最低遅延にこだわる必要はありません。遅延テストは測定時点の接続状況を示すだけで、実際の接続確認の代わりにはなりません。テスト機能がある場合は、完全にタイムアウトする項目を除外してから、結果が返る設定を選ぶとよいでしょう。テスト結果が空でも、必ずしも利用できないとは限りません。ネットワーク環境やサーバー設定によっては特定の測定方式に応答しないことがあるため、最終的には接続ログと実際のアクセス結果で判断します。

デスクトップ版で接続を開始

v2rayNでサーバーを選択したら、コアが起動していることを確認し、前のステップで決めたシステムプロキシの状態をプロキシメニューで選択します。メインウィンドウ下部やログ欄に起動情報が表示され、トレイアイコンやステータスバーにもシステムプロキシの状態が反映されます。すぐにクライアントのプロセスを終了しないでください。ウィンドウを閉じてもトレイに最小化されるだけなら接続は継続しますが、トレイメニューから終了するとローカルプロキシサービスも停止します。

起動直後に停止する場合は、まずログの末尾を確認します。ポートが使用中なら、通常はリッスン失敗の内容が表示されます。設定項目に互換性がない場合は、解析または起動エラーが表示されます。コアファイルを実行できない場合は、起動段階で停止します。入門時のトラブル対応では、まず同じローカルポートを使用している別のプロキシを終了し、v2rayNを再起動してください。サブスクリプションから生成されたサーバー項目を直接編集するのは避けます。

Android版で接続を開始

v2rayNGでサーバーを選択したら、メイン画面右下の接続ボタンをタップします。システムが初めてVPNサービスを確立するときは権限ダイアログが表示されます。確認後、クライアントがローカルVPNインターフェースを作成できるようになります。接続に成功するとボタンの状態が変わり、システムのステータス領域にもVPN接続マークが表示されます。タップ後すぐに未接続状態へ戻る場合は、クライアントのログを開き、起動またはハンドシェイク段階のエラーを確認してください。

一部のAndroid端末では、バックグラウンドアプリの動作が制限されます。初回確認ではv2rayNGを前面に表示したまま、ウェブページへのアクセスとログ確認を済ませてください。その後、バックグラウンド動作の設定を検討します。前面では正常に接続でき、バックグラウンドへ移してしばらくすると切断される場合は、サブスクリプション登録よりも、システムのバッテリー設定やバックグラウンド制限が原因である可能性が高いです。

接続アイコンはローカルサービスが起動したことしか示さず、対象リクエストが遠隔サーバーへ正常に到達したことまでは証明しません。そのため最後に動作確認が必要です。確認中は現在のサーバーとモードを変更せず、問題が起きたときに同じ設定経路をたどって調べられるようにします。

次のステップ:動作を確認 →
VERIFICATION

実際のアクセスとログで動作を確認

有効な確認では、クライアント側とアプリ側の両方を観察します。ブラウザが実際のリクエストを発生させ、クライアントのログがそのリクエストのルートと出力結果を記録します。

再現可能なブラウザテストを1回行う

クライアントの接続を維持したまま、新しいブラウザウィンドウを開き、現在の設定を確認できる対象ページへアクセスします。安定して繰り返し開けるページを選び、複数のダウンロードやストリーミングを同時に開始しないでください。大量の同時ログが判断を妨げるためです。ページが正常に読み込まれたら1回更新し、操作時刻を覚えてから、すぐにクライアントのログを確認します。

v2rayNでは、ログ欄に新しい接続記録が表示されます。通常は対象ドメイン、対象ポート、使用したインバウンド、ルーティングされたアウトバウンドタグを確認できます。v2rayNGでも、ブラウザがリクエストを開始するとログページに該当記録が追加されます。ブラウザの操作時刻とログの時刻が対応していれば、リクエストがクライアントに入ったことを示します。ブラウザでアクセスしたのにログがまったく変わらない場合は、まずシステムプロキシ、アプリ別プロキシの範囲、ブラウザ独自のプロキシ設定を確認してください。

現象から問題の段階を特定

ログにリクエスト記録があるものの、その後に接続タイムアウト、ハンドシェイク失敗、リモート側による切断が表示される場合、通信はクライアントに入っています。問題はサーバー設定、ネットワーク経路、システム時刻にある可能性が高いです。まずサブスクリプションを一度更新し、同じグループの別サーバーに切り替えて比較します。TLSを使う設定はシステム時刻の影響を受けやすいため、端末の日付、タイムゾーン、時刻同期が正しいことを確認してください。

ルールモードではページを読み込めないのに、グローバルモードへ切り替えると回復する場合、サーバーは基本的に利用可能で、違いはルーティングの照合にある可能性があります。ルールモードへ戻し、対象ドメインがどのアウトバウンドに割り当てられているかを確認してください。グローバルモードのまま使い続けるのではなく、ルーティング配列は順番に照合されるため、範囲の広いルールが前にあるとリクエストを先に処理することがあります。項目間の詳しい関係はルーティングルールリファレンスで確認できます。

ドメインへのアクセスに失敗する一方、既知のIPアドレスには接続できる場合、DNSの解決経路に問題がある可能性があります。1回のトラブル対応で複数のDNS方式を同時に有効にしないでください。まずクライアントのデフォルト設定を維持して現象を記録し、DNS設定の章を参照しながら、ローカル解決、リモート解決、ルーティングルールの関係を1つずつ確認します。

すべてのサーバーを起動できず、設定の読み込み直後にログでエラーが出る場合は、今回の更新で生成された異常な項目を削除してからサブスクリプションを再更新します。1台だけ失敗し、ほかの項目が正常なら、クライアントを再インストールする必要はありません。そのサーバー設定に絞って確認してください。基本的な確認順序は、サブスクリプションが更新されたか、サーバーが選択されているか、ローカルサービスが起動しているか、リクエストがログに入っているか、リモート接続に成功したかです。

確認が終わったらテストページを閉じ、クライアントは起動したままにできます。デスクトップ版を終了する場合は、先に適切なシステムプロキシの状態へ戻してから、トレイメニューでクライアントを終了します。Android版はメイン画面の接続ボタンから切断できます。これにより、アプリを停止した後もシステムに古いプロキシ設定が残り、ブラウザのアクセスに問題が出るのを防げます。

完了チェックを見る →
FINAL CHECK

完了チェックと次に読む内容

基本設定が完了したら、まず安定して再現できる設定を1つ残してから、ルーティング、DNS、アプリの対象範囲を調整します。

01

サブスクリプションを更新できる

サブスクリプショングループが存在し、手動更新後にサーバー一覧が正常に更新され、解析エラーが継続していない。

02

アクティブサーバーが明確

一覧に明確な選択状態があり、項目を切り替えたときに、現在実際に使われている設定を判断できる。

03

プロキシ範囲が想定どおり

デスクトップ版ではシステムプロキシとルーティングモードが連携し、Android版では確認に使うアプリが正しいプロキシ範囲に含まれている。

04

ログが実際のリクエストと対応

ブラウザでアクセスすると新しいログ記録が追加され、時刻と対象アドレスからリクエストがクライアントに入ったことを確認できる。

QUICK RECOVERY

接続に失敗した場合の簡単な切り戻し手順

初回設定でよくある問題は、複雑な設定を書き直すことではなく、操作の流れが最後まで完了していないことです。まず確認しやすい状態に戻します。サブスクリプショングループを1つだけ残し、その中のサーバーを1つ選び、追加のアプリ別制限を無効にして、デフォルトのルーティングモードで接続を再開します。完了後はブラウザのページを1つだけ開いて確認してください。

ログにブラウザのリクエストが出ない場合は、システムプロキシまたはVPNの範囲を確認します。ログにリクエストが出るのにリモート接続に失敗する場合は、サブスクリプションを更新して同じグループのサーバーを変更します。コアを起動できない場合は、ポートの使用状況と起動エラーを確認します。ドメインだけ失敗する場合は、DNSを個別に確認してください。変更は毎回1項目ずつ行って再テストすると、原因と結果の関係を明確に保てます。

このページでは基本的な接続手順だけを扱いました。JSONのトップレベル構造、inbounds、outbounds、routing、dns、policyの体系的な解説は設定大全にまとめています。基本接続が確立した後に読むのがおすすめです。まず利用可能な基準状態を作り、その後に項目単位で調整する方が、初回起動前に複数のパラメーターを同時に変更するより問題を特定しやすくなります。