v2rayNの初回インストールと初期設定｜Windows・macOSの基本とよくあるトラブル

1. インストーラーの選び方：OS・アーキテクチャ・UIを確認

v2rayNは、サーバーを管理し、プロキシコアを起動してローカルのプロキシ接続を設定するデスクトップクライアントです。メイン画面が開いても、起動に成功したのはUIプログラムだけです。コアファイル、ノードの設定、システムプロキシはそれぞれ確認が必要です。初めてインストールする場合は、クライアントのダウンロードページで使用するOSに合ったものを選び、パッケージの種類とアーキテクチャを記録しておくと、エラーの原因を特定しやすくなります。

.NETと表示されているからといって、異なるバージョンのランタイムをいくつもインストールしないでください。ランタイム不足のエラーには通常、フレームワーク名、必要なバージョン、アーキテクチャが表示されます。たとえばMicrosoft.WindowsDesktop.Appが見つからない場合は、対応する.NET Desktop Runtimeを確認してください。基本のRuntimeや開発用SDKだけをインストールしても解決しません。必要なメジャーバージョンはクライアントのパッケージによって異なるため、パッケージ内の説明とエラーメッセージを確認してください。

2. 初回起動：展開先・アプリの保存場所・権限

Windows版の圧縮ファイルは、必ずすべて展開してから起動してください。圧縮ソフト上で実行ファイルを直接ダブルクリックすると、ファイルが一時的にしか展開されず、コアやリソース、設定を正しく読み込めないことがあります。展開版は、たとえばD:\Tools\v2rayNのように、長期的に保存でき、現在のユーザーが設定を保存できる固定の場所に置いてください。パスは一例です。

1. パッケージを確認

   ダウンロードページでOS、プロセッサのアーキテクチャ、パッケージの種類を確認します。Windowsではシステムの「すべて展開」を使って完全に展開してください。インストーラー版はインストールウィザードに従います。展開版の保存場所に関する手順は当てはまりません。

2. アプリの保存場所を固定

   Windowsの展開版は、フォルダー構成を保ったまま保存します。macOSでディスクイメージが提供されている場合は、開いたあとアプリを「アプリケーション」フォルダーにコピーしてください。一時的にマウントしたディスクイメージから使い続けないでください。

3. 初回起動を完了

   Windowsではまず通常ユーザーとして起動します。macOSで開発元を検証できないという警告が表示された場合は、ダウンロード元を確認してから、「システム設定」→「プライバシーとセキュリティ」で許可して開く方法を確認してください。システム全体のセキュリティチェックを無効にしないでください。

4. 起動ログを確認

   メイン画面のログ欄を開き、設定を保存できること、コアが起動することを確認します。ファイル不足、権限不足、アーキテクチャの不一致が表示された場合は、サブスクリプションを追加する前に該当するエラーを解消してください。

3. コアの選択：ノードの要件に応じてXrayまたはV2Flyを確認

クライアントとコアは別のプログラムです。v2rayNはUIと設定を管理し、実際のプロキシ接続はコアが確立します。バージョン番号が異なっていても問題ありません。数字をそろえるためにファイルを置き換える必要はありません。初回インストールでは、配布パッケージに含まれるコア設定をそのまま使います。プロトコル上の要件がある場合は、「設定」→「パラメータ設定」と、使用するバージョンのCoreタイプに関する設定を確認してください。

Coreタイプの設定項目や構成はバージョンによって異なり、プロトコルごとに指定する場合もあります。確認するのは、現在選択中のノードで実際にどのコアが使われているかです。設定画面に名前が表示されたことだけでは判断できません。ログに未対応の項目や設定を解析できないエラーがある場合は、ノードの要件とコアのバージョンを確認してください。暗号化、トランスポート、TLSの設定を手当たり次第に変更しないでください。

• ファイルが見つからない：該当する配布パッケージをもう一度すべて展開し、システムのセキュリティ履歴でコアファイルが隔離されていないか確認してください。出所不明のファイルを個別に追加しないでください。
• アーキテクチャが不一致：UIとコアの両方が、システムでサポートされているアーキテクチャに対応している必要があります。メイン画面が開いても、同梱コアが実行できるとは限りません。
• 起動に失敗する：最初に出たコアのエラーと、その前後のログを保存してください。その後に続く大量の接続エラーは、コアが起動していないことが原因の場合があります。

4. サブスクリプションを追加：サーバーを選んで接続を確認

インストールしただけでは、サーバーは自動で追加されません。サブスクリプションURLは通常、サービス提供元から発行され、アクセス用の認証情報を含みます。ウェブサイトのアカウントページ、プランの説明ページ、個別ノードの共有リンクは、いずれもサブスクリプションURLとは異なります。コピーする際は、改行や全角の引用符、前後の空白が入っておらず、全体を正しくコピーできているか確認してください。

1. v2rayNのメイン画面で「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、新しいグループを追加します。見分けやすい名前とサブスクリプションURLを入力し、設定を保存してください。
2. 「サブスクリプショングループ」メニューに戻り、「すべてのサブスクリプションを更新（プロキシを使用しない）」を実行します。利用可能なノードがまだない初回は、まずプロキシを使わずに更新してください。
3. サーバーの一覧にノードが表示されたことを確認します。URLへのアクセスにプロキシが必要な場合は、先に別の接続を確立してから「すべてのサブスクリプションを更新（プロキシを使用）」を使います。この方法では、最初の接続を新たに確立できません。
4. サーバー一覧からノードを選び、右クリックメニューの「アクティブサーバーに設定」を選択します。アクティブサーバーが切り替わったことを確認し、ログに起動エラーがないか確認してください。
5. クライアントに用意された接続テストで初期確認してから、システムプロキシを設定します。遅延テストに成功しても、ブラウザーがそのノードを使っているとは限りません。

5. ローカル待ち受けポート：クライアントとシステムの設定を一致させる

ローカル待ち受けアドレスは、アプリがv2rayNに接続するための入口であり、リモートサーバーのアドレスではありません。「設定」→「パラメータ設定」でローカル待ち受けの項目を確認できます。変更後にコアの再起動を求められた場合は再起動し、実際の待ち受けポートをログで確認してください。以下は2種類の設定例です。どちらも現在のバージョンの既定値だと決めつけないでください。

初回はループバックアドレス127.0.0.1をそのまま使います。「LANからの接続を許可」を有効にすると、入口にアクセスできる範囲が変わり、ファイアウォールやアクセス制御にも関わります。ローカルでウェブページを開けない場合に、常に有効にすべき設定ではありません。システムプロキシのポート、アプリに手動で設定したポート、コアのログに記録された待ち受けポートが一致している必要があります。

ポートが使用中か確認する方法

ログにaddress already in useと表示された場合は、まずv2rayNを重複して起動していないか確認します。以下はWindowsのコマンドプロンプトとmacOSのターミナルで確認する例です。別のポートを使う場合は数字を置き換えてください。

netstat -ano | findstr ":10808"

lsof -nP -iTCP:10808 -sTCP:LISTEN

Windowsでは、ローカルアドレス欄と状態が「LISTENING」になっているかを確認します。最後の列にあるPIDは、タスクマネージャーの「詳細」で照合できます。プロセスの所有者を確認してから、重複したインスタンスを終了するか、ローカルポートを変更してください。数字が表示されたというだけで、見覚えのないプロセスを終了しないでください。ポートを変更したら、システムプロキシとアプリに手動設定したプロキシも合わせて変更します。

6. システムプロキシとルーティングモード：個別に確認する

システムプロキシは、OSのプロキシ設定に従うアプリがリクエストを送る先を決めます。ルーティングルールは、リクエストがコアに届いたあと、直接接続するか、プロキシを使うか、遮断するかを決めます。「グローバルプロキシ」にしても、すべてのアプリが自動的にシステムプロキシに従うわけではありません。「システムプロキシを自動設定」を選んでも、コアに届いたすべてのリクエストがリモートサーバーを経由するわけではありません。

• 接続を確認：アクセスできることが分かっているHTTPSページを開き、対応する接続がコアのログに記録されるか確認します。ログの情報が不足する場合は、一時的にログレベルを上げ、テスト後に元に戻してください。
• アプリによる違い：独自のプロキシ設定を使うブラウザーもあれば、環境変数だけを参照するコマンドラインツールもあります。こうしたアプリはシステムプロキシに従うとは限りません。
• 終了手順：使用を終えるときは、「システムプロキシ」で「システムプロキシを解除」を選んでから終了します。異常終了で古い設定が残った場合は、OSのプロキシ設定画面から手動で元に戻してください。

基本的な接続を確認したあと、必要に応じて自動起動、サブスクリプションの自動更新、TUNを有効にします。macOSでネットワークサービスを切り替えてプロキシの動作が変わった場合は、現在のサービスのプロキシ設定を確認してください。Windowsで設定が書き込まれてもすぐに戻る場合は、別のプロキシソフト、管理ポリシー、セキュリティツールが同じ設定を管理していないか確認します。

7. 初回インストールでよくある問題：発生箇所ごとに確認

問い合わせ時に用意しておく情報

• OSのバージョン、プロセッサのアーキテクチャ、v2rayNのバージョン、デスクトップ版かWPF版かなどのパッケージの種類。
• 使用中のコアとバージョン、実際のローカル待ち受けポート、システムプロキシのモード、TUNを有効にしているかどうか。
• エラーが発生した段階（画面を開く、コアを起動する、サブスクリプションを更新する、ウェブページにアクセスする）と、最初に発生した関連エラーおよび時刻。
• 共有する前に、サブスクリプションURL、サーバーの認証情報、UUID、パスワードを隠してください。スクリーンショットには設定項目の名前とエラー文だけを表示し、ノード設定全体を公開しないでください。

初回設定の完了基準は、クライアントの設定を保存できること、コアが正常に起動すること、ローカル入口とシステムプロキシの設定が一致すること、実際にウェブページへアクセスできることです。4項目すべてを確認してから、ルーティングや自動化のオプションを1つずつ調整します。一度に1項目だけ変更すれば、問題が起きたときに直前の正常な状態へ戻せます。