初回起動では、まず本体が開くこと、コアが起動すること、ローカルポートが待ち受け状態になることを確認してから、サブスクリプションを追加し、システムプロキシを設定します。v2rayNをインストールしたばかりのWindows・macOSユーザー向けに、インストーラー、実行環境、権限、ポート、プロキシ設定の5つの観点から確認し、PC側の起動問題をノードの不具合と取り違えないようにします。
本体・コア・システムプロキシの役割を確認
v2rayNのウィンドウが表示されても、プロキシが使えるとは限りません。本体はノード一覧やサブスクリプション、各種設定を管理し、コアは接続の確立やルーティングルールの適用を担います。システムプロキシは、その設定に従うアプリの通信をローカルの待ち受けポートへ転送します。この3つが順に機能している必要があります。
V2RayはProject Vの一部で、V2Flyは関連する技術エコシステムを引き継ぎ、Xrayは同じ技術分野における別のコア実装です。v2rayNはこれらの接続設定を管理するデスクトップクライアントであり、リモートサーバーではありません。VMessやVLESSの設定をインポートした後も、選択したコアが設定内のプロトコルやトランスポートのパラメーターに対応しているか確認してください。
- ウィンドウが開かない：インストーラーのアーキテクチャ、実行環境、OSによるブロックを確認します。サブスクリプションを何度も更新する必要はありません。
- ウィンドウは開くがコアが終了する：起動ログ、コアファイル、ポートの競合を確認します。まずDNSを変更する必要はありません。
- コアは正常だがWebページを開けない：次に、使用中のノード、システムプロキシ、ルーティングルールを確認します。
- ブラウザーは使えるが特定のアプリがつながらない：そのアプリがシステムプロキシに従うか、独自のプロキシ設定を使用しているか確認します。
Windows・macOS：インストーラーと実行環境
まず、当サイトのダウンロードページで使用するプラットフォームを選びます。Windows版のDesktopとWPFは異なるUIの系統で、WPFはWindows向けです。macOSではプロセッサのアーキテクチャに合ったパッケージを選んでください。Windowsのランタイムへの対処方法を、そのままmacOSに当てはめないでください。
初回起動前に確認すること
Windows
- 「設定」→「システム」→「システム情報」でシステムの種類を確認し、インストーラーのアーキテクチャと一致しているか確かめます。
- インストーラーは画面の指示に従ってインストールします。圧縮ファイルの場合は、すべて展開してから実行してください。圧縮ソフトのプレビュー画面から直接起動しないでください。
- ポータブル版は、現在のユーザーに書き込み権限がある固定のフォルダーに置き、同梱ファイルとフォルダー構成を維持してください。
- .NETが不足しているという警告が出た場合は、要求されているバージョン、アーキテクチャ、ランタイム名を控えてから、該当するコンポーネントを追加します。
macOS
- Appleメニューから「このMacについて」を開き、AppleシリコンかIntelプロセッサかを確認します。
- Appleシリコン搭載Macではarm64、Intel Macではx64を選びます。初回のトラブルシューティングで、変換実行を前提にしないでください。
- DMGを開いたら、アプリを「アプリケーション」フォルダーにコピーし、その場所から起動します。
- 初回起動時にシステムがブロックした場合は、まずファイルの入手元を確認し、「プライバシーとセキュリティ」の設定で具体的な理由を調べます。
まずインストーラー、システムのアーキテクチャ、実行環境を一致させてから、接続設定に進みます。この段階では通常、Tunモードを有効にする必要はありません。
古いガイドを参考に特定バージョンを追加しない
リリースパッケージによって、ランタイムが同梱されている場合と、指定されたランタイムがシステムに必要な場合があります。Windowsで Microsoft.WindowsDesktop.App が見つからないという警告が出た場合は、案内されたアーキテクチャに合う .NET Desktop Runtimeをインストールしてください。通常の.NET Runtimeだけでは、WPFアプリの要件を満たせないことがあります。古いガイドにあるバージョン番号だけを頼りに、インストールするものを決めないでください。
実行環境の警告が表示されず、クリック直後に終了する場合は、エラー全文を保存してください。まず、セキュリティソフトのブロック履歴、インストール先のアクセス権、パッケージが完全に展開されているかを確認してから、再インストールを試します。起動させるためにシステムの保護機能を長期間無効にしないでください。
初期設定は5つの手順で完了
ここでは、中国語UIでよく使われるメニューを手がかりに説明します。DesktopとWPFではボタンの位置が異なる場合があり、メニュー名もバージョンによって変わります。項目が見つからないときは、現在の画面にある実際の設定項目を確認し、スクリーンショットの位置だけを頼りに操作しないでください。初回接続では基本的な通信経路だけを確認し、複雑なルーティングや透過的な通信の取り込みは後回しにします。
-
本体を起動する
ウィンドウが正常に開き、設定を保存できることを確認します。ポータブル版では本体だけをコピーしないでください。フォルダー内のファイルが不足していると、画面は開いてもコアが動作しないことがあります。
-
待ち受けポートを確認する
「設定」→「パラメーター設定」を開き、ローカルの待ち受けポート、待ち受けアドレス、関連するインバウンド設定を確認します。現在のポート番号を控え、LANからの接続許可はひとまず有効にしません。PC内だけで使う場合は、ループバックアドレスでの待ち受けを優先してください。
-
サブスクリプションを追加する
メイン画面の「サブスクリプショングループ」から新しいグループを追加し、サブスクリプションURL全体を入力して保存します。その後、「サブスクリプショングループ」メニューから更新を実行してください。サブスクリプションURLと個別の共有リンクは用途が異なります。Webページの紹介URLをサブスクリプションとして入力しないでください。
-
使用するノードを選ぶ
サーバー一覧からノードを選び、使用中のサーバーに設定します。続いてメイン画面のログを確認し、コアがすぐに終了していないことを確かめてください。ファイルが見つからないという警告が出た場合は、まずコアファイルを修復します。アドレスが使用中という警告が出た場合は、先に待ち受けポートを確認してください。
-
システムプロキシを設定する
「システムプロキシ」で「システムプロキシを自動設定」を選び、システムプロキシに従うブラウザーから、アクセス可能なことが分かっているHTTPSページを開きます。UIの系統によって表示が異なる場合は、既存の設定を維持するだけの項目ではなく、システムプロキシを設定する項目を選んでください。
ローカルポート：待ち受けを確認してからプロキシの接続先を確認
ポート番号は、v2rayNの実際の待ち受け設定、システムプロキシの接続先、アプリの手動プロキシ設定の3か所で一致させる必要があります。以下の数値は設定方法の例であり、すべてのバージョンの初期値を示すものではありません。現在の「パラメーター設定」とコアの起動ログを確認してください。
現在のバージョンで混合インバウンドが使える場合は、同じポートでHTTPとSOCKSのリクエストを受け付けられます。独立したインバウンドとして設定されている場合は、それぞれのポートを控えてください。古いガイドに 10809 と書かれているからといって、10808 のみで待ち受ける設定に無理に入力しないでください。ループバックアドレスには 127.0.0.1 を指定します。リモートノードのアドレスではありません。
Windowsでポートの使用状況を確認する
PowerShellまたはコマンドプロンプトで次のコマンドを実行します。例のポート番号を実際の値に置き換え、待ち受け状態の記録とプロセスIDを確認してください。ほかの接続状態だけが表示されても、そのポートが待ち受け中で使用されているとは限りません。
netstat -ano | findstr :10808macOSで待ち受け中のプロセスを確認する
lsof -nP -iTCP:10808 -sTCP:LISTEN- クライアント起動前から待ち受けがある：まずプロセスを特定してください。以前のインスタンスや別のローカルサービスの可能性があるため、正体の分からないシステムプロセスを終了しないでください。
- 起動後も待ち受けがない：コアのログを確認し、コアファイルに実行権限があるか、設定を読み込めるか、起動に失敗していないかを調べます。
- ポートの競合を確認した：重複して起動しているインスタンスを終了するか、空いているポートを選びます。変更後はシステムプロキシを再設定し、アプリの手動プロキシ設定も同じポートに変更してください。
ポートを変更した後にWebページが急に開けなくなった場合は、システムプロキシの接続先が古いポートのままになっていないか確認します。この問題はリモートノードの品質とは無関係です。ノードを何度切り替えても、ローカルのポート不一致は解消しません。
システムプロキシとTun：初回接続ではどちらを選ぶ？
システムプロキシとルーティングによる通信振り分けは、別の段階の設定です。前者はアプリの通信をクライアントに渡すかどうかを決め、後者はコアに渡された通信の出力先を決めます。そのため、「システムプロキシを自動設定」を選んでも、すべての宛先がプロキシ経由になるとは限りません。実際の出力先は現在のルーティングルールに従います。
まずはシステムプロキシ
おすすめまずはブラウザーなど、システムプロキシに従うアプリで動作を確認します。通信経路がシンプルなので、問題が起きたときにポート、コア、ノードのどこに原因があるか切り分けやすくなります。システムプロキシに従わないアプリは、この設定を有効にしただけでは自動的に通信を取り込めません。
おすすめの用途：初回インストール、Webアクセスの確認、普段のブラウザー利用
必要に応じてTunを有効化
仮想ネットワークインターフェースを使って通信を取り込みます。通常は権限やルーティング、DNSの設定も関係します。まず基本の接続が使えることを確認し、その後で個別に有効化してテストしてください。必要な権限はOSと現在のクライアントに表示される案内に従います。
おすすめの用途：基本接続の確認後、システムプロキシに従わないアプリの通信も取り込みたい場合
明示的なプロキシ指定で問題を切り分ける
例の 10808 がHTTPまたは混合プロキシとして実際に待ち受けている場合は、次のコマンドを実行できます。Windowsでは curl.exe を使います。一部のPowerShell環境で curl が別のコマンドとして解釈されるのを避けるためです。macOSでは curl を使用できます。
curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 -I https://example.comこのコマンドはリクエストの送信先にローカルプロキシを明示するため、ブラウザーがシステムプロキシ設定を読み取るかどうかに左右されません。HTTPレスポンスが返れば、このリクエストに応答があったことは分かりますが、すべての宛先に接続できることや、プロキシ経由で通信したことまで証明するものではありません。ルーティングで対象が直接接続に設定されていれば、リクエストはプロキシを経由せずに送信されることがあります。出力経路を確認するには、そのリクエストのログ、対象に適用されるルール、出力タグを合わせて確認してください。
- 接続がすぐに拒否される：ローカルアドレス、ポート、待ち受け状態を優先して確認します。
- ローカル接続の確立後にタイムアウトする：ノードのパラメーター、リモートへの到達性、関連ログを確認します。
- 明示的なプロキシ指定では成功するが、ブラウザーでは失敗する：ブラウザー独自のプロキシ設定、拡張機能、システムプロキシの状態を確認します。
起動エラーと権限の警告：表示内容に応じて対処
初回起動時に役立つのは「開かない」という説明だけでなく、エラーの原文です。プログラムのダブルクリック時、コアの起動時、Tunの有効化時のどの段階でエラーが発生したかを記録してください。それぞれ必要な権限が異なるため、「常に管理者として実行」を一律の解決策にしないでください。
Windowsでダブルクリックするとランタイム不足と表示される。何を入れる？
ダイアログに表示されたフレームワーク名、バージョン、アーキテクチャを確認します。Windows Desktop Runtimeが必要と表示された場合は、該当するデスクトップランタイムをインストールしてください。通常のランタイムだけでは不十分です。インストール後にクライアントを再起動します。それでも失敗する場合は、異なるプロセッサアーキテクチャのコンポーネントを誤ってインストールしていないか確認してください。
macOSで「開発元を検証できない」と表示された。どうすれば開ける？
ダウンロード元とアプリの名前を確認したうえで、「システム設定」→「プライバシーとセキュリティ」を開き、今回ブロックされた理由を確認します。システムに「このまま開く」が表示される場合は、画面の指示に従って確認してください。古いOSでは「システム環境設定」という名称の場合があります。特定のアプリの警告を解消するために、セキュリティチェック全体を無効にしないでください。
画面は開くのに、コアが見つからないと表示されるのはなぜ？
まず、インストーラーの説明に必要なコアが含まれているか確認します。次に、元のフォルダー構成を移動していないか、セキュリティソフトがファイルを隔離していないかを調べます。現在のバージョンに用意されているコア更新機能、または完全なリリースパッケージを使って対応するファイルを復元してください。別のプラットフォーム用のコアをコピーして代用しないでください。
Tunを有効にすると管理者権限を求められる。インストールに失敗した？
これは別の問題です。仮想インターフェースやシステムルートの変更には、追加の権限が必要になることがあります。まずTunを無効にして、システムプロキシモードで接続できるか確認してください。通信を取り込む必要がある場合は、現在のバージョンの案内に従って必要な権限を付与します。組織管理の端末で変更が制限されている場合は、端末の管理ルールに従ってください。
終了時の確認：使えなくなったプロキシ設定を残さない
初回接続に成功した後、すぐに複雑なルールを追加する必要はありません。まずクライアントの再起動、使用中ノードの切り替え、正常終了の3つを確認し、設定が保存されること、ポートが変わらないこと、終了後にネットワークが元の状態に戻ることを確かめてください。プロセスを強制終了したり、システムが異常終了したりすると、停止したローカルサービスを指すシステムプロキシ設定が残ることがあります。
- 再起動後に確認：元のサブスクリプショングループと使用中のノードが残っており、ログに起動エラーが繰り返し記録されていないこと。
- 接続中に確認：ローカルポートが実際に待ち受けており、ブラウザーが応答を受け取り、対象へのリクエストが想定どおりにルーティングされること。
- 正常終了する前に：「システムプロキシ」で「システムプロキシをクリア」を選んでからクライアントを終了します。ほかのネットワーク管理方法を使っている場合は、元の設定に戻してください。
- 異常終了した後：Windowsでは「設定」→「ネットワークとインターネット」→「プロキシ」を確認します。macOSでは「システム設定」→「ネットワーク」→現在のネットワークサービス→「詳細」→「プロキシ」を確認してください。今回のテストで設定されたローカルプロキシだけを解除し、組織のネットワーク要件に必要な設定を上書きしないでください。
これらの確認を終えて初めて、「プログラムのインストール完了」から「基本接続を繰り返し使える状態」へ進めます。その後、特定のWebサイトだけ開けない場合は、ルーティング、DNS、ノードのパラメーターを順に確認してください。操作手順を最初から確認する場合は入門ガイドを、エラーの症状から原因を探す場合はトラブル対処をご覧ください。