v2rayNの初回インストールと初期設定：Windows・macOS共通のポイントとよくある落とし穴

v2rayN 7.xは、従来のWindows向けトレイアプリにとどまらず、現在のデスクトップ版ではmacOSとLinuxにも対応しています。初回利用で本当に確認すべきなのは、複雑なプロトコル設定ではありません。プログラムの保存先に書き込めるか、実行環境がそろっているか、ノードに合ったコアか、そしてシステムプロキシが意図した状態になっているかです。これらを順番に確認しておけば、VMess、VLESS、サブスクリプションURLを追加するときも状況を把握しやすくなります。

ダウンロードと解凍最初に保存先を整える

v2rayNのデスクトップ版は、通常アーカイブまたはアプリパッケージで配布されています。Windowsではアーカイブを完全に解凍してから起動し、圧縮ソフトのプレビュー画面から実行しないでください。プレビュー時の一時フォルダーは画面を閉じると削除されることがあり、データベース、ログ、ダウンロードしたコアファイルを安定して保存できません。

Windowsでは、D:\Apps\v2rayNやC:\Users\現在のユーザー\Apps\v2rayNのような、現在のアカウントで書き込める固定フォルダーを選べます。追加の管理者権限が必要なシステムフォルダーには置かず、ダウンロードフォルダーで何度も上書きする運用も避けてください。パスに日本語を含めることはできますが、問題を切り分ける際は、短い英数字のフォルダー名のほうがログ内のファイル位置を確認しやすくなります。

1. プラットフォームを確認

   Windowsではまず「設定」→「システム」→「システム情報」でシステムの種類を確認し、一般的なPCではx64を選びます。ARMプロセッサ搭載機ではarm64を選択してください。macOSは「このMacについて」でチップの種類を確認し、対応するビルドを選びます。

2. 完全に解凍する

   Windowsではアーカイブを固定フォルダーに解凍し、メインプログラムと同梱ファイルが同じ階層にあることを確認してください。実行ファイルだけを取り出すと、リソースファイルやコアフォルダーを見つけられなくなる場合があります。

3. 初回起動

   Windowsではv2rayNのメインプログラムを実行します。macOSではアプリを「アプリケーション」へ移動してから開いてください。提供元の確認が表示された場合は、システム設定のセキュリティ画面でアプリ名を確認し、開く操作を許可します。

4. 書き込みを確認

   起動後に画面言語またはウィンドウ設定を一度変更し、通常の手順で終了してから再度開きます。設定が保持されれば、設定フォルダーへの書き込み権限は問題ありません。元に戻ってしまう場合は、ノードを何度も追加する前にフォルダーの権限を確認してください。

macOSではアプリ本体は通常「アプリケーション」にあり、設定とキャッシュは現在のユーザーフォルダーに保存されます。読み取り専用のディスクイメージから直接起動している場合は、いったん終了して「アプリケーション」へ移動してください。WindowsのポータブルフォルダーとmacOSのアプリフォルダーは構成が異なるため、両方のプログラムファイルを混在させないでください。

ランタイムとコアノードを起動できるかを左右する

v2rayNは、グラフィカルインターフェースとプロキシコアの2層で構成されます。画面側はサブスクリプションの保存、ノードの切り替え、ルーティングの変更、システムプロキシの制御を担当します。Xrayまたはv2flyコアは、ローカルポートの待ち受け、外向き接続の確立、ルーティング規則の実行を担当します。メイン画面が開くことと、プロキシコアが正常に動作していることは同じではありません。

v2rayN 7.xを例にすると、Windows版は対応アーキテクチャの.NET 8 Desktop Runtimeを必要とする場合があります。ダブルクリックしても画面が表示されない、イベントビューアーにランタイムエラーが出る、Microsoft.WindowsDesktop.Appが見つからないと表示される場合は、まずプログラムと同じアーキテクチャの実行環境をインストールしてください。x64プログラムにはx64ランタイム、arm64ビルドにはarm64ランタイムが必要です。別アーキテクチャのランタイムでは代用できません。

「設定」→「パラメーター設定」→「Core タイプ」を開き、現在Xrayが選択されていることを優先的に確認します。サブスクリプションのノードにflow=xtls-rprx-vision、Realityの公開鍵、短いID、フィンガープリントのパラメーターが含まれている場合は、v2flyコアへ変更しないでください。コアが合っていないと、ノードの追加、アドレスやポートの表示までは成功しても、起動ログに未対応フィールドや外向き接続の初期化失敗が記録されることがあります。

初期パラメーターポートとシステムプロキシを統一する

ローカルポートは、ブラウザー、システムプロキシ、その他のアプリがv2rayNへ接続する入口です。バージョンや移行した設定によって既定値が異なる場合があるため、解説記事のポート番号を固定値だと考えないでください。「設定」→「パラメーター設定」で現在の待ち受けポートを確認し、開発サーバー、別のプロキシアプリ、古いv2rayNのプロセスと競合していないことを確認します。

初回の切り分けでは、ローカルのmixedポートを10808に設定し、待ち受けアドレスは127.0.0.1のままにすると便利です。これは同じPCからの接続だけを受け付け、LANには公開しない設定です。画面にHTTPポートとSOCKSポートが別々に表示される場合は、HTTPを10809、SOCKSを10808とする例も使えますが、実際の値はシステムプロキシ画面や、そのプロキシを利用するアプリと一致させてください。

システムプロキシに関する3つの操作は、それぞれ意味が異なります。「システムプロキシを設定」は、現在のシステムのHTTPなどのプロキシをv2rayNへ向けます。「システムプロキシを解除」は、このプロキシ設定を削除します。「システムプロキシを変更しない」はコアだけを起動し、OSの既存設定を変更しません。初回設定ではまず「システムプロキシを変更しない」を選び、ログで127.0.0.1:10808の待ち受けを確認してから「システムプロキシを設定」へ切り替えるのがおすすめです。

ノードだけを起動してシステムプロキシを設定しない場合、ブラウザーはそのまま直接接続することがあります。反対に、v2rayNを終了した後もシステムプロキシが残ると、ブラウザーは停止したローカルポートへ接続し続け、すべてのページが即座に失敗します。その場合はv2rayNを再起動して「システムプロキシを解除」を実行するか、OSのネットワーク設定で手動プロキシを無効にしてください。

サブスクリプションとノード決まった順序で初回接続を確認する

サブスクリプションURLは更新可能なノード一覧で、VMessまたはVLESSの共有リンクは通常1つのノードだけを表します。どちらもv2rayNへ追加できますが、その後の管理方法は異なります。サブスクリプションは定期的な更新が必要なのに対し、単独のリンクにはサーバー側で追加・変更されたノードが自動で反映されません。追加前に、クリップボードの内容が完全で、余分な空白や途中で切れた改行がないことを確認してください。

v2rayN 7.xはマイナーバージョンによってメニュー名が少し異なる場合がありますが、サブスクリプション関連の操作は通常「サブスクリプショングループ」メニューにあります。先にグループを作成してURLを保存し、その後で更新を実行します。URLを追加するだけでは、メイン一覧にノードは自動生成されません。

1. サブスクリプションを追加

   「サブスクリプショングループ」→「サブスクリプショングループ設定」→「追加」を開き、識別しやすい別名と完全なサブスクリプションURLを入力します。保存後、メイン画面に戻ります。

2. グループを更新

   「サブスクリプショングループ」→「すべてのサブスクリプションを更新」を実行します。ステータスバーに追加または更新されたノード数が表示されます。0と表示された場合は、グループが有効か、URLが完全かを確認してください。

3. ノードを選択

   ノード一覧から、プロトコルとコアが一致する項目を1つ選び、アクティブサーバーに設定します。転送方式、TLS、SNI、UUID、Realityのパラメーターを一度に変更しないでください。

4. コアを起動

   起動後にログを開き、ローカルポートの待ち受けが成功していること、ポート競合、未対応フィールド、ドメイン名の解決失敗、ハンドシェイク失敗が発生していないことを確認します。

5. プロキシを有効化

   「システムプロキシ」→「システムプロキシを設定」を選び、ブラウザーで異なる2つのサイトへアクセスします。その後「システムプロキシを解除」へ戻し、ブラウザーが直接接続に戻れることを確認してください。

遅延テストで分かるのは、ある時点の探測に対する応答結果だけで、Webページの通信全体が利用できることを保証するものではありません。ノードに80ミリ秒と表示されても、TLSパラメーター、転送経路、出口側の設定ミスによって実際の接続を確立できない場合があります。初回確認では、ノードの遅延、コアのログ、ブラウザーの表示結果を同時に確認してください。

自動起動とルーティング接続テストの後に設定する

自動起動で解決できるのは、プログラムを自動的に実行することだけです。無効なノード、誤ったサブスクリプション、ポート競合を自動修復する機能ではありません。少なくとも一度、起動、接続、プロキシ解除、終了、再起動までの一連の流れを完了してから、「設定」の起動オプションで自動起動を有効にすることをおすすめします。これにより、ログイン直後に利用できないプロキシ設定が書き込まれる事態を避けられます。

Windowsで自動起動を有効にした後は、「設定」→「アプリ」→「スタートアップ」でv2rayNが有効になっているか確認できます。macOSでは「システム設定」→「一般」→「ログイン項目」を確認してください。v2rayN側では有効なのにシステム一覧に項目がない場合は、いったん無効にして通常終了し、再起動後にもう一度有効にします。

• 自動起動：ユーザーのログイン後にv2rayNを実行するだけで、ノードの接続成功を保証するものではありません。
• 最小化して起動：設定済みの日常利用に適しています。初回のトラブル対応では、メイン画面とログを表示したままにすることをおすすめします。
• システムプロキシを自動設定：アクティブノードが安定してから有効にし、プログラム終了時に解除処理が行われることを確認してください。
• サブスクリプションを自動更新：まず手動更新が成功することを確認してから更新間隔を設定し、起動時に複数の変数が同時に変わるのを避けます。
• ルーティングモード：初回接続では内蔵の基本ルールを使い、出所の不明なカスタムルールを複数同時に読み込まないでください。

ルーティングは、どのドメインやIPをプロキシ経由、直接接続、またはブロックにするかを決める機能で、システムプロキシの有効・無効とは別の層です。システムプロキシはアプリの通信をv2rayNへ送り、ローカルコアがルールに従って出口を選びます。Webページを開けないときは、まず通信がローカルポートへ入っているかを確認し、その後で正しい出口へルーティングされているかを確認してください。

初心者によくあるのは、TUN、DNSの変更、ルーティングルールの追加、ポート変更を一度に行うことです。これでは障害が起きたときに原因を特定しにくくなります。より安全な順序は、通常のシステムプロキシで接続できた設定を1つ保存し、その後は毎回1項目だけ変更して、ログを確認しながら再テストすることです。

よくある起動トラブル症状ごとに切り分ける

トラブル対応では、頻繁に再インストールしないでください。v2rayNの画面、設定データベース、プロキシコア、システムプロキシはそれぞれ別の層に分かれています。症状から層を特定するほうが効果的です。プログラムが開かない場合はランタイムと保存先、画面は開くがコアが失敗する場合はポートとコアの種類、コアは正常なのにWebページが開かない場合はシステムプロキシ、ノード、ルーティングを確認します。

ログにノード接続のタイムアウトだけが表示されても、すぐにUUID、ポート、転送経路、サーバー名を変更しないでください。これらのフィールドは通常サブスクリプションから提供されるため、推測で変更すると復旧可能な設定まで崩れることがあります。まずサブスクリプションを更新し、同じグループ内の別ノードへ切り替え、本体の時刻とタイムゾーンが正しいことを確認してから、単一ノードの障害かどうかを判断します。

初期設定が完了したら、現在のv2rayNバージョン、コアバージョン、ローカルポート、有効なサブスクリプショングループ、システムプロキシモードを記録しておくと便利です。後で更新や移行を行う際も、これらを1項目ずつ照合すれば、変化が画面、コア、ノード、OSのネットワーク設定のどこで起きたかをすばやく判断できます。