v2rayNの初回インストールと初期設定｜Windows・macOSの手順と注意点

インストールパッケージの選び方：OS・アーキテクチャ・UIを確認

v2rayNはデスクトップ向けクライアントです。GUIでノードを保存し、設定を生成してプロキシコアを起動します。画面が開いてもコアが動作しているとは限らず、ノードが表示されてもブラウザーの通信がプロキシを通っているとは限りません。初回インストールではこの3つを分けて確認し、Webページが開かないからといって何度も再インストールするのは避けましょう。

ダウンロードページで、OSとプロセッサアーキテクチャに合ったパッケージを選びます。Windowsの従来型WPF版とクロスプラットフォームのデスクトップ版は別のビルドです。また、macOSではWindows用の実行ファイルを使えません。ダウンロード前に各パッケージの動作環境を確認し、ファイルサイズだけでランタイムやコアの同梱有無を判断しないでください。

以下では、一般的なデスクトップ版の日本語メニュー名を示します。リリースによって設定項目が同じウィンドウ内の別タブにある場合があります。名称が異なるときは、「サブスクリプショングループ」「システムプロキシ」「Coreタイプ」など、項目の意味を手掛かりに探してください。古い画面キャプチャの配置をそのまま当てはめないようにしましょう。

プログラムの配置：Windowsでの展開とmacOSでの初回起動

Windowsで短いパスを使うのは、主にトラブルシューティングをしやすくするためです。日本語のフォルダー名で必ず動作しなくなるという意味ではありません。確認すべきなのは、フォルダーに書き込めるか、ファイルがそろっているか、セキュリティソフトが依存ファイルやコアを隔離していないかです。隔離履歴がある場合は、ファイルの入手元と警告内容を確認してください。システムの保護機能を一括で無効にするのは避けましょう。

ランタイムと起動ログ：アプリ本体とコアのエラーを切り分ける

Windows版の一部ビルドでは、対応する.NETランタイムが必要です。一方、ランタイムを同梱したビルドもあります。実行環境が見つからない場合は、起動ダイアログに表示されるフレームワーク名、メジャーバージョン、アーキテクチャを確認してください。WPF版では通常、対応するDesktop Runtimeが必要です。SDKだけ、または異なるアーキテクチャのランタイムをインストールしても、要件を満たすとは限りません。特定リリースの要件をすべてのパッケージに当てはめないよう、ここではランタイムのバージョンを固定していません。

• メインウィンドウがまったく表示されない：システムエラーの全文を記録し、アーキテクチャ、ランタイム、最小システム要件を優先して確認します。
• メインウィンドウは開くが、コアが見つからないと表示される：アーカイブを完全に展開したか、選択したコアがパッケージに含まれているか、関連ファイルが隔離されていないかを確認します。
• コアが起動直後に終了する：クライアントのログで最初に記録された起動エラーを確認し、ポートの競合、設定項目、プロトコルの対応状況を重点的に調べます。
• macOSでアーキテクチャ非対応と表示される：Appleシリコン用とIntel用のパッケージの対応を確認し直してください。アーキテクチャの問題をサブスクリプションのエラーとして扱わないでください。

通常のシステムプロキシを使うだけなら、常に管理者権限で実行する必要はありません。TUNやルーティングの変更には追加の権限が必要な場合がありますが、初回の動作確認には不要です。まず通常の権限で基本的なプロキシ接続をテストすると、権限変更とネットワーク制御機能が同時に影響するのを避けられます。

初期設定の順序：言語、コア、サブスクリプションのインポート

まずはネットワーク関連の設定を初期状態のままにし、必要だと分かっている項目だけ変更します。表示言語を変えてもメニューの表示が変わるだけで、サーバーのプロトコルは変わりません。サブスクリプションURLはノード一覧を取得するためのもので、ローカルの待ち受け設定やシステムプロキシの代わりにはなりません。サブスクリプションURLにアクセス用の認証情報が含まれる場合があるため、スクリーンショットや問い合わせ時のログではURL全体を隠してください。

1. 表示言語を確認

   「設定」を開き、言語の項目で日本語を選択します。ビルドによっては「設定」→「パラメーター設定」にあります。再起動を求められた場合は、クライアントを通常終了してから起動し直し、設定を続けてください。

2. コアを確認

   「設定」→「パラメーター設定」→「Coreタイプ」を開き、使用するプロトコルに対応したコアが選ばれているか確認します。この項目は独立したタブにある場合もあります。プログラムパッケージに必要なコアが含まれていることを確認してから保存し、ネットワーク機能を同時に複数切り替えないでください。

3. サブスクリプショングループを作成

   「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、新しいグループを追加して、手元にあるサブスクリプションURLを入力します。グループ名はローカルで識別するためのものです。URL欄に空白、説明文、改行を入れないでください。

4. ノード一覧を更新

   「サブスクリプショングループ」メニューから、すべてのサブスクリプションを更新する操作を選びます。利用可能なプロキシがまだない初回は、プロキシを経由しない更新方法を使います。更新に成功したらノード数が変わったか確認し、ノードを1つ選んでアクティブサーバーに設定します。

5. システムプロキシを有効化

   コアのログに起動エラーがないことを確認してから、クライアントの「システムプロキシ」メニューで「システムプロキシを自動設定」を選びます。ブラウザーで一度アクセスを確認した後、必要に応じてルールやサブスクリプションの自動更新間隔を調整してください。

ノードの共有リンクを1つだけ持っている場合は、サブスクリプションURL欄ではなく、「サーバー」メニューから該当するインポート操作を選びます。サブスクリプションの更新ではサブスクリプションサーバーにアクセスし、ノードのインポートでは接続パラメーターを解析します。失敗したときの確認箇所はそれぞれ異なります。

コアの選び方：ノードのプロトコルで確認し、名前で速度を判断しない

v2rayNはクライアントで、XrayとV2Flyはプロキシコアのプロジェクトです。対応するプロトコルやトランスポートは完全には共通していません。ノードを利用できるかどうかは、ノードのパラメーターと選択したコアの実際の対応状況で決まります。コアを変更すれば必ず速くなるわけではなく、無効になったサーバーアドレスや誤った認証情報も修正できません。

Coreタイプを変更したら、対象の接続を再起動し、実際の起動ログを確認してください。設定画面の選択値が、実行中のコアに変更した瞬間に反映されるとは限りません。画面上の設定だけで切り替え完了と判断しないでください。設定の階層を理解するには、JSON設定ガイドのインバウンド、アウトバウンド、ルーティングの説明も参考になります。

接続確認：ローカルポート、システムプロキシ、ルーティングを個別に確認

ローカルの待ち受けアドレスはアプリからクライアントに接続するための入口で、リモートサーバーのポートはコアがノードに接続する宛先です。両者を取り違えないでください。以下ではポート確認の例として 127.0.0.1:10808 を使います。実際のポートと入口のプロトコルは、「設定」→「パラメーター設定」の待ち受け設定とログで確認してください。ビルドによってSOCKS、HTTP、または混合の入口が用意されています。

Windowsではコマンドプロンプトからサンプルのポートを確認できます。出力の最後の列は通常、プロセスIDです。別のクライアントがポートを使用している場合は、まずプロセスを確認し、競合するアプリを通常の手順で終了するか、ローカルの待ち受けポートを変更してください。正体の分からないシステムプロセスを強制終了しないでください。

netstat -ano -p tcp | findstr ":10808"

macOSではターミナルから同じサンプルポートのTCP待ち受けプロセスを確認できます。何も表示されない場合、現在のコマンドで該当する待ち受けが見つからなかったというだけです。実際のクライアント設定ポートとログも確認し、「サブスクリプションが使えない」と即断しないでください。

lsof -nP -iTCP:10808 -sTCP:LISTEN

• ローカルの待ち受けポートを変更した場合は、クライアントのシステムプロキシ設定を適用し直し、ブラウザーやほかのアプリに手動設定したプロキシアドレスも更新してください。
• Windowsでは「設定」→「ネットワークとインターネット」→「プロキシ」、macOSでは利用中のネットワークサービスの「詳細」→「プロキシ」でシステムプロキシを確認できます。
• すべてのアプリがシステムプロキシに従うわけではありません。初回確認にはシステムプロキシを使うブラウザーを利用し、最初からTUNやブラウザー拡張機能を併用しないでください。
• クライアントを終了する前にシステムプロキシを解除してください。解除しないと、プログラムの停止後もシステムが閉じたローカルポートへ通信を送ろうとします。

初回インストールでよくある質問

設定完了後に保持する項目と再確認の順序

初回接続に成功したら、現在利用できているコア、待ち受けポート、ルーティング方式を記録しておきます。問題を調べるときは、一度に変更する項目を1つに絞ります。まずプログラムが起動するか、次にコアのログ、ノードの接続性、最後にアプリがプロキシを使っているかを確認してください。これにより、実行環境の変化、ノードの無効化、システム設定の残留を切り分けやすくなります。

• 必要な情報を記録：クライアントのバージョン、パッケージのアーキテクチャ、使用中のコア、ポートを手元に記録し、サブスクリプションURLやノードの認証情報は公開しないでください。
• 設定の保存前に終了：クライアント設定をバックアップする前に通常の手順で終了し、書き込み中のデータをコピーしないようにします。設定には機密情報が含まれる場合があるため、安全に保管してください。
• 更新時は説明を確認：UIの種類をまたぐ変更や大きなバージョンアップでは、旧フォルダーをそのまま上書きできると決めつけず、復元可能な設定のコピーを先に保管してください。
• 終了時の動作を確認：通常終了後にシステムプロキシが解除されること、パソコンの再起動後も通常のネットワークを使えることを確認してください。

サブスクリプションのインポートやルーティング設定を続けて確認する場合は、入門チュートリアルの手順に沿って進めてください。初回インストールの目的は、仕組みを理解して後から確認できる基本設定を整えることです。すべての機能を一度に有効にすることではありません。