v2rayN 初回インストール・設定ガイド：Windows／macOS共通の要点とよくある落とし穴

ダウンロード前にOSとプロセッサーのアーキテクチャを確認

v2rayN 7.x のデスクトップ画面は Windows と macOS で動作しますが、両プラットフォームではファイル形式が異なり、プロセッサーのアーキテクチャも一致させる必要があります。Windows の一般的な端末は x64、Qualcomm プロセッサー搭載の一部端末は arm64 です。古い 32 ビットシステムでは、現在の 64 ビット版をそのまま使うのは適していません。macOS では Intel x64 と Apple シリコン arm64 を区別します。

Windows では「設定」→「システム」→「システム情報」を開き、「システムの種類」を確認します。「x64 ベースのプロセッサ」と表示される場合は x64、「ARM ベースのプロセッサ」と表示される場合は arm64 を選びます。macOS ではシステム情報を開き、チップ名が Apple M シリーズなら arm64、プロセッサーが Intel なら x64 を選択します。アーキテクチャを間違えると、ウィンドウがまったく表示されないか、OS にアプリを実行できないと表示されることがあります。

Windows の圧縮ファイルは、圧縮ソフトのプレビュー画面から直接実行できません。v2rayN は自身のフォルダーまたはユーザーデータフォルダーから設定、ログ、Core ファイルを読み込みます。圧縮ファイル内の実行ファイルだけを起動すると、Core が見つからない、設定を保存できない、再起動後にサブスクリプションが消えるといった問題が起きやすくなります。D:\Apps\v2rayN のような固定フォルダーを使い、追加の書き込み権限が必要なシステムフォルダーは避けてください。

macOS でダウンロードしたアプリを初めて開くと、システムによる提供元の確認を求められることがあります。まず Finder でアプリを選択して「開く」を使い、画面の指示に従って確認してください。それでもブロックされる場合は、「システム設定」→「プライバシーとセキュリティ」で直前のブロック履歴を確認します。複数のコピーを何度もダブルクリックすると、「ダウンロード」フォルダーと「アプリケーション」フォルダーのどちらを起動しているのか分かりにくくなります。

初回起動では6項目を決まった順序で確認する

初回起動時に、すべての高度なパラメーターをすぐ変更する必要はありません。まずクライアント、Core、サブスクリプション、ローカルリスニングポートを一連の経路として整え、その後にルーティングやシステムプロキシのモードを決めます。以下の順序で進めると、「クライアントが起動していない」のか「ノード自体が使えない」のかを切り分けやすくなります。

1. 解凍または移動

   Windows ではすべてのファイルを固定フォルダーへ解凍し、macOS ではアプリを「アプリケーション」へ移動します。同名の実行コピーを複数残さないでください。

2. メインプログラムを起動

   メインウィンドウが表示されたら、まずタイトルバーと通知領域またはメニューバーのアイコンを確認します。ウィンドウを閉じても、通常はプログラムがバックグラウンドで動作し続けます。

3. Core を確認

   「設定」→「パラメーター設定」→「Core タイプ」を開き、一般的な VLESS、VMess、Trojan ノードでは Xray を優先して選択します。

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

   「サブスクリプショングループ」→「サブスクリプショングループ設定」→「追加」と進み、備考と完全なサブスクリプションURLを入力して保存します。

5. ノードを更新

   「すべてのサブスクリプションを更新」を実行し、メインリストにノードが表示されるまで待ちます。ノードを1つ選び、アクティブサーバーに設定します。

6. 接続をテスト

   まず実接続による遅延テストを実行し、その後でシステムプロキシを有効にします。ICMP ping だけでプロキシプロトコルの利用可否を判断しないでください。

メインウィンドウが表示されたら、画面下部のステータス情報またはログウィンドウを確認します。正常な状態では、現在のアクティブノード、ローカルリスニングポート、起動中の Core プロセスが少なくとも表示されます。初回実行時には、システムファイアウォールがネットワークアクセスの許可を尋ねることがあります。信頼できる現在のネットワークの種類に限り、必要な権限を付与してください。拒否してもクライアント画面は正常に表示される場合がありますが、他のアプリからローカルプロキシポートへの接続は失敗します。

メインウィンドウを閉じても、必ずしも終了したとは限りません。v2rayN は既定で Windows の通知領域または macOS のメニューバーに収納できます。完全に終了する場合は、通知領域またはメニューバーのメニューから「終了」を実行し、タスクマネージャーまたはアクティビティモニタで関連プロセスが終了したことを確認します。ファイルの更新、フォルダーの移動、ランタイムの切り替え前には、必ずこの操作を行ってください。

• プログラムのウィンドウは表示されるのにノードがない：サブスクリプションを保存し、「すべてのサブスクリプションを更新」を実行したか確認します。
• ノードリストはあるのに画面下部にアクティブサーバーがない：対象ノードを右クリックしてアクティブサーバーに設定します。
• Core 起動直後に終了する：ログを開き、まずポートの競合、ノードの項目、Core タイプを確認します。
• ブラウザーが通常のネットワークを使い続ける：システムプロキシが有効か確認し、ブラウザー独自のプロキシ設定も確認します。

Core タイプ、リスニングポート、システムプロキシの設定方法

Core タイプは、ノード設定を解析する Core を決めます。Xray は VLESS、REALITY、XTLS Vision、一般的な VMess 設定への対応がより充実しており、v2rayN の通常利用における既定値として適しています。V2Fly Core は、既存の VMess や WebSocket などの設定互換性を確認する用途に向いています。Core はノードの項目と一致させる必要があり、名称を変えてもサーバー側にないパラメーターを補うことはできません。

ローカルリスニングポートは、ブラウザーや他のアプリが v2rayN に接続する入口です。v2rayN でよく使われる基本ポートは 10808 ですが、実際の値は「設定」→「パラメーター設定」のローカルリスニング設定と実行ログを基準にしてください。ポートは変更できますが、他のプロキシプログラムやローカルサービスと重複させないでください。ログに「address already in use」または「ポートが使用中」と表示された場合は、他のプロキシプログラムを終了するか、ポートを 10818 に変更して Core を再起動します。

システムプロキシは、システムプロキシ設定に従う通信をローカルポートへ渡すだけで、すべてのプロセスが自動的に接続されるわけではありません。一部のコマンドラインツール、ゲーム、独自にネットワークスタックを管理するソフトウェアはシステムプロキシを無視します。初回確認では、まず通常のブラウザーでウェブページを開き、その後に SOCKS または HTTP アドレスを個別入力する必要があるアプリを設定します。

サブスクリプションのインポート後にノード項目を確認

サブスクリプションURLの保存に成功しても、ノードがすぐ表示されるとは限りません。「すべてのサブスクリプションを更新」を実行して、クライアントにリモートの内容を読み込ませ、現在のグループへ書き込む必要があります。更新結果が0件の場合は、まずURLが完全か、コピー時に空白が混入していないかを確認し、その後ログの HTTP ステータスと解析メッセージを確認します。同じグループを何度も新規作成しないでください。重複ノードが増え、更新結果を見分けにくくなります。

サブスクリプションをインポートする利点は、プロトコル項目が提供元から一括して配布されることです。VLESS + REALITY を例にすると、サーバーアドレス、ポート、ユーザーID、Server Name、公開鍵、Short ID、フィンガープリント、Flow は互いに対応している必要があります。どれか1つでも期限切れまたは欠落していると、クライアントは起動してもプロトコルのハンドシェイクを完了できない場合があります。VMess + WebSocket + TLS では、Host、パス、TLS、サーバー側のトランスポート設定も一致させる必要があります。

ノードが表示されたら、まず1つのノードを選んで実接続遅延テストを行います。このテストはローカル Core を経由して実際の接続を確立するため、単純な ping よりもプロキシのハンドシェイク結果に近い情報が得られます。1回の結果はその時点のネットワーク状態しか示しません。10秒間隔で3回テストするのがおすすめです。たとえば同じノードが 168 ms、175 ms、171 ms なら変動は小さいと判断できます。140 ms、890 ms、タイムアウトのような結果なら、回線の揺らぎ、パケットロス、ハンドシェイクの不安定さが疑われます。

遅延が利用可能でも、ダウンロード速度が高いとは限りません。遅延テストは接続確立に必要な時間を主に示すもので、スループットはサーバー帯域、中継回線の混雑、トランスポート方式、接続先サイトの制限にも左右されます。初回インストールでは、接続を確立できること、ウェブページを読み込めること、DNS 解決が正常なことを確認すれば十分です。速度の最適化は、基本経路が安定してから個別に行ってください。

Windows でよくある起動失敗と通知領域の問題

Windows でよくある起動失敗の原因は、圧縮ファイルの解凍不完全、.NET ランタイムの不一致、プログラムフォルダーへの書き込み不可の3つです。ダブルクリックしても画面がまったく表示されない場合は、まずタスクマネージャーでプロセスが一時的に現れていないか確認します。次に、プログラムフォルダー内のログファイルとシステムイベントログを確認します。エラーが .NET 8 を明確に指している場合は、v2rayN と同じアーキテクチャの Desktop Runtime をインストールしてください。SDK や別アーキテクチャのランタイムだけでは解決しません。

メインウィンドウを閉じた後にプログラムが見つからなくても、プロセスが終了したとは限りません。Windows ではアイコンが通知領域の非表示リストに折りたたまれていることがあります。タスクバー右側の上向き矢印をクリックして v2rayN のアイコンを確認し、「設定」→「個人用設定」→「タスクバー」の通知領域アイコン設定で表示を許可します。メインプログラムを再度起動しても、既存のプロセスを呼び出すだけで、2つ目のウィンドウが作られない場合があります。

v2rayN は起動できるのに、再起動するたびに設定が初期状態へ戻る場合は、フォルダーの書き込み権限と設定ファイルの実際の保存場所を確認してください。プログラムを一時的な解凍フォルダーに長期間置いたり、クリーンアップツールでデータフォルダーを定期的に削除したりしないでください。プログラムを移動する前にクライアントを終了し、設定のバックアップを残します。移動後はサブスクリプションと Core タイプを再確認してください。

• メインプログラムと残りの解凍ファイルが同じフォルダー階層にあることを確認します。
• 次に、ランタイムのアーキテクチャとプログラムのアーキテクチャが一致していることを確認します。
• 続いて、10808 などのローカルポートが他のプロセスに使用されていないか確認します。
• 最後に、システムプロキシが現在リッスン中のポートを指しているか確認します。

macOS の権限、バックグラウンドアイコン、プロキシ設定の残留への対処

macOS で初回起動時に重要なのは、アプリの場所とシステム権限です。アプリは「アプリケーション」フォルダーから起動し、初回確認後はできるだけ場所を変えないでください。毎回「ダウンロード」フォルダー内の別コピーから起動すると、システムが別のアプリとして扱い、権限確認が繰り返されたり、設定ファイルの場所が分かりにくくなったりします。

メインウィンドウを閉じたら、画面上部のメニューバーにある v2rayN のアイコンを確認します。メニューバーの空きが少ないと、一部のアイコンが隠れることがあります。まずメニューバーを占有しているアプリを終了し、その後アクティビティモニタで v2rayN がまだ動作しているか確認します。クライアントを再起動する場合は、古い Core がローカルポートを使い続けないよう、先にメニューから終了してください。

1. Finder で、現在実行しているコピーが「アプリケーション」にあることを確認します。
2. 「アクティビティモニタ」を開き、v2rayN と現在の Core プロセスを検索します。
3. 終了を確認してから、アプリを再び開き、アクティブノードを選択します。
4. システムプロキシを有効にしてブラウザーをテストし、終了前にシステムプロキシをクリアします。

クライアント終了後もネットワーク通信が失敗し続ける場合は、まず v2rayN を再度開いてシステムプロキシをクリアします。次に「システム設定」→「ネットワーク」で現在のネットワークサービスの詳細設定を開き、プロキシ項目が 127.0.0.1 と古いポートを指していないか確認します。システムプロキシが残っている場合、通常のウェブページはすべて開けない一方、LAN 機器への直接接続は正常という症状がよく見られます。

アプリを開けてサブスクリプションも更新できるのに、ノードの起動だけが失敗する場合、問題は通常すでにシステム権限の層を離れています。この場合はログに戻り、Core タイプ、ノード項目、ポートの競合を確認します。フィンガープリント、Server Name、Flow、トランスポートパスを続けて変更しないでください。まずサブスクリプションを再更新し、別のノードと比較すると、単一ノードの障害かローカル環境の問題かをより早く判断できます。

インストール後の基本メンテナンスチェックリスト

初回接続が確立した後は、原因を説明できる変更だけを少数残すことをおすすめします。ルーティングルール、Mux、同時接続テスト、カスタム DNS は切り分けの変数を増やすため、基本接続が安定する前に一度に有効化するのは適していません。まずしばらく通常利用し、サブスクリプション更新、ノード切り替え、システムプロキシ、終了手順が正常に動作することを確認してから、実際の用途に合わせて調整してください。

サブスクリプションURLは設定への入口にあたるため、管理された場所に保存し、公開ログ、スクリーンショット、共有ドキュメントには貼り付けないでください。他人に不具合情報を渡す場合は、プロトコルの種類、ポート、トランスポート方式、エラーテキストを残してもかまいませんが、サブスクリプションURL、ユーザーID、公開鍵に関する情報、サーバーの認証情報は隠してください。

• クライアントを更新するたびに、「設定」→「パラメーター設定」→「Core タイプ」を再確認します。
• サブスクリプションの更新に失敗したら、すぐに元のグループを削除せず、まずログを確認します。
• 新しいノードの障害とローカルの障害を切り分けるため、検証済みの利用可能なノードを1つ残します。
• ローカルポートを変更したら、ブラウザー、コマンドラインツール、その他の手動プロキシ設定も同時に更新します。
• プログラムフォルダーをアップグレードまたは移動する前に正常終了し、現在の設定をバックアップします。
• 切り分けが終わったらログレベルを warning に戻し、デバッグ記録が長期間増え続けないようにします。

再現可能な基本状態は次のとおりです。v2rayN のメインウィンドウとバックグラウンドアイコンが正常に表示され、Xray Core が継続して動作し、サブスクリプション更新後に妥当な数のノードが表示され、アクティブノードの実接続遅延が結果を返し、システムプロキシを有効にするとブラウザーでネットワークへアクセスでき、システムプロキシをクリアして終了すると直接接続が正常に戻ることです。この6項目がすべて満たされれば、初回インストールは完了と判断できます。