v2rayNを初めて使うときは、まずアプリとコアが起動することを確認し、次にサブスクリプションを追加して、最後にシステムプロキシを設定します。Windows・macOSのデスクトップ利用者向けに、インストールパッケージ、権限、サブスクリプション、コア、ローカルポートの順に確認します。「ウィンドウが開く」「ノードを選択した」「ブラウザーの通信が実際にプロキシを経由している」は、それぞれ別の状態です。
インストールパッケージの選び方:OS・アーキテクチャ・実行環境
まずダウンロードページで、OSとプロセッサーのアーキテクチャに合ったパッケージを選びましょう。ファイル名にv2rayNとあるだけで判断しないでください。Windowsデスクトップ版と従来のWPF版は別のインターフェースで、WPF版はWindows用のためmacOSでは動作しません。macOSではApple SiliconとIntelを区別し、それぞれに対応するarm64版またはx64版を選びます。
v2rayNはプロキシを設定・管理するクライアントで、接続を実際に処理するのはコアです。ウィンドウが正常に開いても、コアが起動しているとは限りません。初回起動時に実行環境がないというメッセージが表示されたら、メッセージに記載されたフレームワーク名、アーキテクチャ、要件を確認し、パッケージの説明に従って必要な環境を追加してください。名前が似ているランタイムを推測でインストールするのは避けましょう。
インストール前にOSごとに確認
Windows
- 「設定」→「システム」→「システム情報」を開き、システムの種類を確認します。
- x64パッケージはデバイスのアーキテクチャに合ったものを選びます。x64はすべてのプロセッサーで使えるという意味ではありません。
- .NETが見つからない場合は、起動時のメッセージと選択したパッケージの説明に従ってください。デスクトップランタイムとSDKは用途が異なります。
- 選択したパッケージで外部の実行環境が必要な場合は、インストール後にクライアントを終了してから再起動します。
macOS
- Appleメニューから「このMacについて」を開き、「チップ」または「プロセッサ」を確認します。
- Apple Siliconではarm64、Intelではx64を選び、対応するアーキテクチャを優先してください。
- ディスクイメージを開いたら、アプリを「アプリケーション」にコピーしてから、コピー先から起動します。
- 必要なシステムバージョンは、現在のダウンロードパッケージの説明で確認してください。
まずOSとアーキテクチャを合わせ、その後に実行環境のメッセージに対応します。ノードを何度切り替えても、アプリの起動失敗は解決しません。
初回起動:解凍先とアクセス権の確認
Windows版の圧縮ファイルは完全に解凍してから実行してください。圧縮ソフトのプレビュー画面から実行ファイルを直接開くのは避けましょう。例として、現在のアカウントで書き込み可能な専用フォルダー(D:\Tools\v2rayNなど)を使えます。このパスは一例で、Dドライブが必須という意味ではありません。実行ファイル、付属ファイル、サブフォルダーをまとめて保持することが重要です。
実行ファイルだけをデスクトップにコピーすると、クライアントがコアやその他の依存ファイルを見つけられない場合があります。いったん終了し、フォルダー全体を改めて解凍するほうが、ファイルを一つずつ追加するより原因を特定しやすくなります。また、別々のフォルダーにある2つのバージョンを同時に起動しないでください。設定、ログ、ポートが別々のものを見てしまう可能性があります。
-
完全に解凍する
Windowsでダウンロードした圧縮ファイルを右クリックし、「すべて展開」を実行します。解凍後のフォルダーを開き、メインプログラムを起動してください。用途がわからないコアのサブフォルダーを移動・削除しないでください。
-
決まった場所に配置
macOSではアプリを「アプリケーション」にコピーし、ディスクイメージを取り出してからアプリを開きます。一時的にマウントされた場所から起動し続けるのを防げます。
-
警告内容を確認
OSに起動をブロックされた場合は、まずファイルの入手元と警告内容を確認します。macOSでは通常、「システム設定」→「プライバシーとセキュリティ」から起動を許可できます。入手元を確認できたアプリに限って操作し、システム全体のセキュリティ保護は無効にしないでください。
-
ログを確認
クライアントの「ログ」を開き、ファイル不足、アクセス拒否、ポートの競合がないか確認します。メニューの場所はデスクトップ版の画面によって異なることがあります。まず最初に表示された具体的なエラーを確認してください。
サブスクリプションの追加:アドレスを保存しただけではノードは取得できない
サブスクリプションURLはノード設定を取得するためのアドレスであり、ノード名やサービス提供元のログインページではありません。URLを入手したら、まずクライアントにサブスクリプショングループを作成し、更新を実行します。グループを保存しただけで更新していない場合、ノード一覧が空のままになることがあります。更新後は、使用するノードを選択して有効にする必要があります。
デスクトップ版によって、メニュー名は「サブスクリプショングループ」または「サブスクリプショングループ設定」と表示されます。以下では一般的なメニュー名を使って説明します。ボタン名が異なる場合は、「グループ設定」と「サブスクリプションを更新」の機能を探し、他の設定を見慣れないスクリーンショットに合わせて変更しないでください。
- 「サブスクリプショングループ」→「サブスクリプショングループ設定」を開き、「追加」を選択します。わかりやすい名前と、サブスクリプションURL全体を入力してください。
- 保存後、「サブスクリプショングループ」に戻り、対象グループの「サブスクリプションを更新(プロキシを使用しない)」を実行します。まだ使えるプロキシがない初回は、この方法なら余計な依存を避けられます。
- プロキシなしではサブスクリプションにアクセスできず、すでに利用可能なノードがある場合は、「サブスクリプションを更新(プロキシを使用)」を試してください。すべてのサブスクリプションで必要な設定ではありません。
- 更新後にノード一覧を確認し、ノードを選択します。右クリックメニューの「アクティブサーバーに設定」または現在の画面にある同等の操作で有効にしてください。
- 解析エラーが出る場合は、URL全体をコピーしたか、WebページのURLを誤って貼り付けていないか、サブスクリプション提供元がクライアントで認識できる形式を提供しているかを確認します。
ノードをインポートできても、設定が認識されたことを示すだけで、サーバーに接続できる証明にはなりません。サブスクリプションURLにはアクセス用の認証情報が含まれることもあるため、URL全体を公開スクリーンショットに載せないでください。問い合わせる際は、エラーメッセージとプロトコルの種類を残し、サブスクリプションのパラメーター、ユーザー識別情報、サーバーの機密情報は隠してください。
コアの選択:プロトコルのパラメーターを合わせる
V2RayとXrayはコアのプロジェクト、v2rayNはデスクトップクライアントであり、同じ名前の表記違いではありません。VMessとVLESSはノードのプロトコル、WebSocketはトランスポート方式、TLSは接続を保護する仕組みです。コアを選ぶときはプロトコル名の略称だけでなく、ノードの設定全体がサポートされているか確認してください。
REALITYやxtls-rprx-visionなどのパラメーターを使うノードでは、該当する組み合わせに対応したXrayを選び、クライアントが設定を正しく生成できることを確認してください。一般的な設定場所は「設定」→「パラメーター設定」→「Coreタイプ」です。画面によっては「Coreタイプ設定」として独立している場合もあります。変更後はアクティブノードを再度有効にし、ログで実際の起動結果を確認します。
- まずインポートした値を維持:アドレス、ポート、ユーザー識別情報、トランスポート方式、パス、SNI、公鍵などは提供元が指定した値です。「最適化」のために推測で変更しないでください。
- 次に対応範囲を確認:「未対応のフィールド」や設定の読み込み失敗が表示されたら、まず選択中のコアと設定への対応状況を確認します。DNSを先に変更する必要はありません。
- 最後に接続エラーを確認:設定を読み込めてもタイムアウトする場合は、ネットワーク、サーバーの状態、ノード情報を確認します。タイムアウトは解析失敗とは異なります。
システムプロキシ:ローカルアドレスと待ち受けポートを確認
Webページを初めてテストする場合は、まずシステムプロキシを使います。v2rayNの「システムプロキシ」で「システムプロキシを自動設定」を選び、OSに設定されたプロキシのアドレスとポートを確認してください。これはシステムプロキシに従うアプリをローカルのクライアントへ接続する操作であり、リモートサーバーのアドレスをOSの設定に直接入力するものではありません。
以下の2つのポートは確認用の例であり、既存の設定を上書きする指示でも、すべてのバージョンで標準使用される値でもありません。クライアントによってはHTTPとSOCKSを同じポートで受け付ける混合リスナーを使うほか、HTTPとSOCKSを別々に設定する場合もあります。分離している場合は、それぞれのポートを確認してください。
クライアント側の確認
- 設定画面
- 「設定」→「パラメーター設定」にあるローカルリスナー関連の項目
- ローカルアドレス
127.0.0.1(このコンピューターのループバックアドレス)- 待ち受けポート
- 実際に有効なHTTP、SOCKS、または混合ポートを記録します
- 起動結果
- ログにバインド失敗やアドレス使用中のエラーがないこと
画面にポートを入力しただけでは不十分です。コアが実際に待ち受けを開始したことも確認してください。
OS側の確認
- Windows
- 「設定」→「ネットワークとインターネット」→「プロキシ」
- macOS
- 「システム設定」→「ネットワーク」→現在の接続→「詳細」→「プロキシ」
- プロキシアドレス
- クライアントのローカル待ち受けアドレスと一致していること
- プロキシポート
- 対応するプロキシプロトコルの実際の待ち受けポートと一致していること
OSのバージョンによって設定画面の項目名は異なる場合があります。アドレス、プロトコル、ポートが一致しているか確認してください。
ログにポート使用中と表示された場合は、重複して起動したクライアントや他のプロキシプロセスを終了してから再試行します。ポートを変更する必要がある場合は、クライアントの待ち受け設定を変更した後、システムプロキシを自動設定し直し、OS側のポートも同期しているか確認してください。片方だけ変更すると、ウィンドウは正常でノードも選択済みなのに、ブラウザーが接続できないことがあります。
動作確認と仕上げ:一度に変更するのは1項目
動作確認では、アクティブノード1つ、内容がわかっているルーティング設定1つ、通信を取り込む方式1つに絞ります。システムプロキシが影響するのは、その設定に従うアプリだけです。独自のプロキシ設定を使うアプリや、直接接続するアプリもあります。ブラウザーでWebページが開けても、すべてのアプリがプロキシ経由とは限りません。ノードの遅延テストに結果が出ても、目的のWebサイトへ接続できるとは限りません。
ルーティング設定では、どの接続を直接接続し、どの接続をプロキシ経由にするかを決めます。初回のテストでは、クライアントに用意された意味の明確なプリセットを選び、設定を記録してください。「ルールに一致しない」と「ノードが使えない」を切り分ける必要がある場合に限り、一時的にグローバルプロキシへ切り替えてテストし、終了後に元のルーティング設定へ戻します。
- ウィンドウが開かない:インストールパッケージ、アーキテクチャ、実行環境を確認します。サブスクリプションは後で確認してください。
- ノード一覧が空:グループの保存、更新結果、サブスクリプションの形式を確認します。
- ノードの起動時にエラーが出る:コアの対応状況、設定の生成、ローカルポートの競合を確認します。
- ブラウザーにプロキシ接続エラーが表示される:サーバー側の障害と決めつけず、まずローカルの待ち受けポートとシステムプロキシのポートを確認します。
- 一部のWebサイトだけ開けない:ルーティングルールへの一致、DNS名前解決、ノードから対象サイトへの接続状況を確認します。
v2rayNを終了したらブラウザーでWebページを開けなくなったのはなぜ?
OSにローカルポートを指すプロキシ設定が残っている一方で、クライアントが待ち受けを停止している可能性があります。v2rayNを再度開き、「システムプロキシ」で「システムプロキシをクリア」を選んでから、通常の手順で終了してください。アプリを起動できない場合は、OSのプロキシ設定に残った項目がないか確認します。組織管理下のデバイスでは、管理者の方針を確認してから操作し、統一設定を無断で変更しないでください。
初回設定でTUNを有効にしてDNSも変更する必要がありますか?
必要ありません。まずシステムプロキシでノードとブラウザーの接続を確認してください。システムプロキシに従わないアプリの通信を取り込む必要がある場合に限り、TUNを設定します。ドメイン名の名前解決エラーが出た場合は、その後にDNSを確認してください。通信の取り込み方式、ルーティング、名前解決の設定を一度に変えると、比較できる状態がなくなり、原因を調べにくくなります。
設定が完了したら、インストール先、アクティブノード、選択したコア、待ち受けポート、システムプロキシの状態を記録しておきます。次に問題が起きたときは、最後に変更した箇所から確認してください。アップグレード前に設定をバックアップします。新旧フォルダーの設定やコアを無造作に混在させたり、使えることを確認する前に元の設定を削除したりしないでください。