v2rayNの初回インストールと初期設定｜Windows・macOS共通の確認事項とよくあるトラブル

この記事の要点

v2rayNを初めて使う方や、WindowsからmacOSへ移行する方に向けたガイドです。「環境に合うパッケージを選ぶ → コアを起動する → 設定をインポートする → ローカルの待ち受けを確認する → システムプロキシを設定する → リクエストを検証する」の順に進め、まずは1つのノードで接続を確認してから、ルーティングやその他の機能を設定しましょう。本文中のポート番号は設定例であり、すべてのバージョンの初期値を示すものではありません。メニュー名はデスクトップ版のバージョンによって異なる場合があるため、現在の設定画面と実行ログもあわせて確認してください。

1. インストールパッケージを選ぶ：OSとプロセッサを確認

v2rayNは、ノードやサブスクリプション、ルーティング、コアのプロセスを管理するデスクトップアプリです。プロキシ接続を実際に処理するのはコアです。メインウィンドウが開いても、コアが起動しているとは限らず、ブラウザの通信がプロキシ経由になった証拠にもなりません。初回インストール時は、各段階を分けて確認しましょう。

利用環境	選び方	最初に確認すること
Windows x64	該当するデスクトップ版のパッケージを選びます。WPFはWindows向けの従来型UIで、macOS用インストーラーではありません。	「設定」→「システム」→「バージョン情報」でシステムの種類を確認し、パッケージの動作要件も読みます。
macOS（Appleシリコン）	arm64版のDMGを選びます。	Appleメニュー→「このMacについて」を開き、チップの種類を確認します。
macOS Intel	x64版のDMGを選びます。	プロセッサの種類と、ソフトウェアが必要とするmacOSの最低バージョンを確認します。

Windows版の圧縮ファイルは、まず C:\Tools\v2rayN など書き込み可能なフォルダーにすべて展開し、その中のメインプログラムを起動してください。圧縮ソフトのプレビューから直接実行したり、メインプログラムだけを取り出したりしないでください。コアやリソース、その他の依存ファイルが圧縮ファイル内に残ることがあります。インストーラーをダウンロードした場合は、セットアップウィザードに従えばよく、無理に展開手順を適用する必要はありません。

macOSではDMGを開き、アプリを「アプリケーション」フォルダーにドラッグしてから、ディスクイメージを取り出し、「アプリケーション」から起動します。こうすることで、一時的にマウントした場所から起動し続ける事態を避けられます。別のデバイスへ移行する場合は、クライアントのインポート機能またはバックアップ機能を使ってください。別のプラットフォームのプログラムフォルダー全体を上書きせず、特にコアのパスとファイル権限を確認し直しましょう。

2. 初回起動：5つの手順で最小限の設定を行う

まずは通常のシステムプロキシモードで基本動作を確認します。TUN、複雑なルーティング、カスタムDNS、自動起動は後から追加し、複数の条件を同時に変えないようにしましょう。以下では一般的なメニュー名を使っています。プラットフォームによって設定画面の場所が異なる場合は、該当する設定画面で項目名を探してください。まったく同じボタン配置を探す必要はありません。

起動してログを確認

メインプログラムを起動し、メインウィンドウのログ欄を確認します。「コアファイルが見つからない」「権限が不足している」「起動直後に終了する」といったエラーがないか確認してください。依存ファイルが不足している場合は、現在のインストールパッケージの説明に従って補ってください。見知らぬサイトから同名の実行ファイルだけをダウンロードするのは避けましょう。
サブスクリプションを登録

「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、新しいグループを作成して、URL欄にサブスクリプションURLを入力し保存します。次に「サブスクリプショングループ」メニューから「すべてのサブスクリプションを更新（プロキシを経由しない）」を実行します。画面によっては、グループを右クリックしたメニューに更新操作があります。
ノードを選択

更新後、リストにノードが表示されることを確認します。接続先のノードを選択してEnterキーを押すか、右クリックメニューから「アクティブサーバーに設定」を実行します。表の行を選択しただけで接続設定が切り替わっていない場合があるため、現在のアクティブ項目も確認してください。
コアを確認

「設定」→「パラメーター設定」の「Coreの種類」または該当するコア設定画面を開き、現在のプロトコルで使用するコアを確認します。保存後は再起動ログも確認してください。この項目がないバージョンでは、ノードの編集画面と実際の起動ログに表示されるコアを基準にします。
システムプロキシを設定

Windowsでは、タスクトレイのアイコンから「システムプロキシ」→「システムプロキシを自動設定」を選びます。クロスプラットフォーム版でステータスバーに同じ項目がある場合は、そこから操作できます。macOSでプロキシ設定の許可を求められたら、案内を確認してから、システムのネットワーク設定に表示されるプロキシのアドレスとポートを確認してください。

サブスクリプションを直接更新できない場合、「すべてのサブスクリプションを更新（プロキシを経由）」を試すのは、利用可能なアクティブノードがすでにある場合に限ります。ノードが空の状態やコアが起動していない状態でこの設定に切り替えても、初回インポートの問題は通常解決しません。単一ノードの共有リンクは「サーバー」→「クリップボードから共有リンクをインポート」から取り込みます。定期更新するサブスクリプションURLとして登録しないでください。

3. コアの選択：名前や性能の印象ではなく、ノードの設定で判断

Project Vは関連するプロキシ技術のエコシステムを背景とし、V2FlyとXrayはそれぞれ異なるコアプロジェクトです。v2rayNで利用できるコアは、現在のバージョンやインストールパッケージ、設定画面が対応しているかどうかで決まります。画面にVMessやVLESSと表示されているだけで、どのコアでもノードの拡張パラメーターをすべて扱えると判断しないでください。

Xrayコア

推奨

ノードにVLESS、REALITY、Visionのパラメーターが含まれる場合は、まずXrayの対応条件とバージョン要件を確認してください。サブスクリプションに含まれる通信方式、セキュリティレイヤー、サーバー名、Flowなどの項目はそのまま保持し、VMessノードをVLESSに変更しないでください。

適した環境：サーバー側からXrayを指定されている場合や、対応する拡張パラメーターを使うノード。

V2Flyコア

使用中のv2rayNがこのコアに対応しており、サーバー設定との互換性が明確な場合は、指定に従って使用できます。VMessをインポートする場合も、通信方式、セキュリティレイヤー、コアのバージョンを確認してください。コアの変更をあらゆる問題に有効な解決策と考えないでください。

適した環境：V2Flyの設定が明示的に必要で、既存の設定動作を維持したい環境。

コアが有効になったかどうかは、設定を保存した後の起動ログとエラーメッセージで確認します。プルダウンの表示だけでは判断できません。「不明なフィールド」「設定を解析できない」「セキュリティ設定に非対応」と表示される場合は、コアのバージョンとノードのパラメーターが合っているか確認してください。接続タイムアウトの場合は、ネットワークへの到達性、サーバーアドレス、ポートを確認します。この2種類のエラーは発生する層が異なります。

一度に変更するのは1項目だけ：まず現在の設定を記録し、その後にコアやノードのパラメーターを変更すると、元に戻しやすくなります。
サブスクリプションの項目を優先：自動インポート後に、SNI、通信パス、公鍵をむやみに書き換えないでください。
画面とコアは別々に確認：画面をアップデートしても、すべてのコアファイルが更新されるとは限りません。インストールパッケージの説明と実行ログを確認してください。

4. ローカルポート：プロキシの入口とリモートサーバーを区別

ブラウザはPC上のローカルプロキシに接続し、コアがリモートサーバーへ接続します。ノードに設定されたリモートポート（例：443）を、システムプロキシのローカルポート欄に入力してはいけません。以下の例は切り分け方法を説明するためのものです。実際の値は「設定」→「パラメーター設定」にあるローカル待ち受け設定で確認してください。

127.0.0.1

ループバックアドレスの例

10808

ローカルのSOCKSまたは混合プロキシの例

10809

独立したHTTPプロキシの例

バージョンによって、SOCKSとHTTPのポートが別々の場合と、混合プロキシの入口を使う場合があります。そのポートがHTTPプロキシに対応していると確認できた場合のみ、システムのHTTP/HTTPSプロキシに設定してください。例の値をそのまま使ってポートが存在すると決めつけたり、他のデバイスから接続するために待ち受け範囲をすべてのネットワークインターフェースへ広げたりしないでください。

クライアントの待ち受け設定例

待ち受けアドレス: 127.0.0.1
SOCKSプロキシ: 10808（有効になっていることを確認）
HTTPプロキシ: 10809（有効になっていることを確認）
LANからのアクセス: 初回の切り分け中は無効にする

これは設定例であり、固定の初期値ではありません。混合プロキシの場合は、使用中のバージョンに表示されている実際の設定を入力してください。

システムプロキシの確認項目

サーバーアドレス: 127.0.0.1
HTTPポート: クライアントのHTTPプロキシまたは混合プロキシのポートと同じ
HTTPSリクエスト: CONNECTに対応したローカルHTTPプロキシを使用
終了後の処理: クライアントを終了する前に、該当するプロキシ設定を解除

HTTPSプロキシ欄も通常はローカルのHTTPプロキシを指定します。ループバックアドレスに証明書を設定する必要はありません。

Windowsでは「設定」→「ネットワークとインターネット」→「プロキシ」でシステムプロキシを確認できます。macOSでは「システム設定」→「ネットワーク」→現在のネットワークサービス→「詳細」→「プロキシ」を開きます。クライアントがPACを使う場合は自動プロキシ構成を、手動HTTPプロキシを使う場合はサーバーとポートを確認してください。どちらか一方だけを確認して済ませないようにしましょう。

5. 接続を確認：まずプロキシの入口、次にブラウザ

システムプロキシの影響を受けるのは、システムプロキシ設定に従うアプリだけです。PC上のすべての通信を制御するわけではありません。また、ルーティングルールはリクエストがコアに到達した後、直接接続するかプロキシ経由にするかを決めます。「システムプロキシを有効にする」ことと「すべてのリクエストをリモートノード経由にする」ことは別の操作です。初回テストではプロキシルールの対象になることが明確な接続先を選び、ログも同時に確認してください。

アクティブノード、コアの起動時刻、ローカルの待ち受けポートを確認し、プロセスが起動していない可能性を先に除外します。
プロキシを明示したコマンドを使い、ローカルの入口からリモートの接続先までの経路を確認します。
次に同じ接続先へブラウザからアクセスします。コマンドは成功してブラウザだけ失敗する場合は、システムプロキシとブラウザ独自の設定を重点的に確認してください。
基本接続が安定してから、ルーティング、DNS、その他の通信制御方式を1つずつ調整し、変更のたびにテストを繰り返します。

以下のコマンドは、127.0.0.1:10808がSOCKSプロキシの入口だと確認済みであることを前提とします。socks5hでは接続先のドメイン名をプロキシ側で解決するため、アプリ側で名前解決する場合との比較に使えます。ただし、PCから他のDNSリクエストが送信されていないことを単独で証明するものではありません。

Windows PowerShell

Get-NetTCPConnection -LocalPort 10808 -State Listen
curl.exe --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com

macOSのターミナル

lsof -nP -iTCP:10808 -sTCP:LISTEN
curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com

ここに示した接続タイムアウト10秒と全体の制限時間20秒は診断用の設定であり、実測した遅延ではありません。待ち受け確認で結果が出ない場合は、まずローカルの入口を修復します。「接続が拒否されました」と表示されたら、ポート、プロセス、入口の種類を確認してください。HTTPレスポンスを受信した場合、そのリクエストは接続先に到達して応答を得ていますが、直接接続かプロキシ経由かはルーティングログも見て判断します。証明書エラーの場合は、システム時刻と信頼チェーンを確認し、証明書検証を無効にしないでください。

6. よくあるトラブル：セキュリティ警告、ポート競合、終了後のネット接続切れ

Windowsのセキュリティソフトにブロックされた場合、そのまま許可してよい？

ファイル名だけを見て誤検知と判断しないでください。「Windows セキュリティ」→「ウイルスと脅威の防止」→「保護の履歴」を開き、検出名とブロックされたパスを記録します。ダウンロード元、パッケージ内のファイル、リリースノートも確認してください。確認が済むまでは、セキュリティ機能全体を無効にしたり、ダウンロードフォルダー全体を除外対象にしたりしないでください。判断できない場合は、実行を中止してください。

macOSで開発元を検証できないと表示されたら？

まずアプリの入手元と、必要なOSバージョンを確認してください。ユーザーによる確認で開ける開発元検証の警告であれば、起動を試した後に「システム設定」→「プライバシーとセキュリティ」を開き、「このまま開く」が表示されるか確認します。マルウェアの危険性を示す警告が出た場合は操作を中止して、さらに確認してください。すべてのセキュリティ警告を、初回起動時によくある案内として扱わないでください。

ログにaddress already in useと表示される場合は？

待ち受けアドレスまたはポートが競合しています。Windowsでは netstat -ano | findstr :10808、macOSでは lsof -nP -iTCP:10808 -sTCP:LISTEN を実行し、プロセス情報から使用中のプログラムを確認します。まず重複して起動したクライアントを終了してください。ポートを変更する場合は、設定を保存してコアを再起動し、システムプロキシとアプリ側の手動プロキシ設定も同じ値に更新します。

アプリを終了したら、なぜブラウザがネットにつながらなくなる？

システムプロキシが、停止したループバックプロキシを参照したままになっている可能性があります。まずv2rayNを再起動し、「システムプロキシ」→「システムプロキシを解除」で設定を削除してください。起動できない場合は、システムプロキシの画面で該当する手動プロキシまたはPACを無効にします。組織管理下のPCでは、元の設定を記録し、組織が配布したプロキシ設定を削除しないでください。

ノードの遅延は表示されるのに、Webページが開かない場合は？

遅延テストで確認できるのは、そのテスト方法が対象とする経路の一部だけであり、アプリからのアクセス確認の代わりにはなりません。前述のプロキシを明示したコマンドで再テストし、アクティブノード、ルーティングルールへの一致、DNSエラー、ブラウザのプロキシ設定を確認してください。複数のノードが同じ手順で失敗する場合は、クライアントを繰り返し再インストールするのではなく、共通するローカル設定を優先して確認します。

7. 基準設定を保存：更新や移行の前に記録を残す

初回接続に成功したら、動作する最小限の設定を記録します。クライアントとコアのバージョン、OSのバージョン、アクティブノードのグループ、待ち受けポート、システムプロキシの方式、ルーティングモードを控えておきましょう。アップデート後に問題が起きた場合、「昨日までは使えた」という情報より、原因の特定に役立ちます。プラットフォームをまたぐ設定は手動でインポートして確認してください。プログラムの保存先、権限、システムプロキシの設定が自動で同期されるとは限りません。

更新前：現在のクライアントに用意されたバックアップまたはエクスポート機能で設定を保存し、サブスクリプションの認証情報とバックアップファイルは安全な場所に保管します。
更新後：まず既存のノードとプロキシを明示したコマンドを再テストしてから、新機能を有効にします。問題が起きたら最初のエラーログを保存してください。
問い合わせ時：OSのアーキテクチャ、コアの起動エラー、再現手順を伝え、サブスクリプションURL、ユーザー識別情報、ノードの認証情報は伏せてください。
移行後：ローカルポート、コアファイルの場所、システムプロキシ、ファイアウォールの警告を再確認し、別のデバイスのパスをそのまま使わないでください。

インストールが完了したと判断する基準は、「ウィンドウが開く」ことではありません。コアが安定して起動し、ローカルの入口で待ち受けが行われ、プロキシを明示したリクエストが成功し、ブラウザも想定どおりにプロキシを経由し、終了後に通常のネットワーク接続へ戻ることを確認してください。エラーの症状に応じた詳しい切り分けは、トラブル診断で、起動、待ち受け、接続、名前解決、ルーティングの順に確認できます。