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

インストーラーの選び方：OSとプロセッサーを確認

v2rayNはデスクトップクライアントです。画面上で設定を管理し、実際の接続はコアが処理します。メイン画面が開いても、コアやノード、システムプロキシの準備が整ったとは限りません。初回インストールではクライアントのダウンロードページから使用するOS向けのパッケージを選び、プロセッサーのアーキテクチャとパッケージの説明も確認しましょう。

Windowsでは「設定」→「システム」→「システム情報」でシステムの種類を確認できます。macOSではAppleメニューの「このMacについて」でチップを確認してください。IntelやAMD搭載の一般的なデスクトップPCでは通常x64を選びます。ARMプロセッサー搭載機では、対応するアーキテクチャのパッケージを優先してください。異なるOS向けのコアファイルを同じフォルダーに混在させないでください。

ファイルの配置：完全に解凍してから起動

Windowsの圧縮ファイルは、まず D:\Apps\v2rayN などの固定フォルダーにすべて解凍してから、フォルダー内のメインプログラムを実行してください。圧縮ソフトのプレビューから起動したり、メインプログラムだけをデスクトップに移動したりしないでください。コアやリソースファイル、実行に必要なファイルが圧縮ファイル内に残ることがあります。

macOSでダウンロードしたものがディスクイメージまたはアプリケーションパッケージの場合は、パッケージの説明に従ってアプリを「アプリケーション」フォルダーに移してから起動してください。圧縮ファイルの場合は、先に解凍します。初回起動時にセキュリティ警告が表示されたら、まずダウンロード元とパッケージを確認し、「システム設定」→「プライバシーとセキュリティ」で該当アプリの警告を確認してください。システム全体のセキュリティ機能を無効にしないでください。

1. 固定フォルダー

   Windowsでは現在のユーザーが書き込める場所を選びます。macOSではパッケージの説明に従ってアプリを配置してください。一時的な解凍先は避け、複数のフォルダーにあるコピーを同時に実行しないようにしましょう。

2. 初回起動

   メイン画面を開き、ログまたは画面下部の情報欄を確認します。実行環境が不足しているというメッセージが表示された場合は、案内に従って対応アーキテクチャの実行環境をインストールしてください。適当な動的ライブラリをプログラムフォルダーにコピーしないでください。

3. コアを確認

   「設定」→「パラメーター設定」でコア関連の項目を開き、ログから実際に起動したコアを確認します。ファイルが見つからないというメッセージが表示された場合は、解凍が完了しているか、選択したコアに対応するフォルダーにファイルがあるかを確認してください。

4. 設定をインポート

   「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、グループを追加してサブスクリプションURLを入力します。保存後、「サブスクリプショングループ」メニューからサブスクリプションを更新してください。名称が異なる場合は、該当グループの更新コマンドを選びます。

5. サーバーを選択

   一覧から設定を1つ選び、使用中のサーバーに指定してから、コアの起動ログを確認します。ノードが一覧に表示されていても、現在の接続に使うノードとして選択されているとは限りません。

コアファイルがセキュリティソフトによって隔離された場合は、まずダウンロード元を確認し、隔離履歴を見て復元するか判断してください。すべての保護機能を無効にして問題を回避しないでください。更新または再解凍する前に、タスクトレイのプログラムを終了し、サブスクリプショングループ、ルーティング、カスタム設定をバックアップしてください。

サブスクリプションとプロトコル：追加後に重要項目を確認

サブスクリプションURLは設定一覧を取得するためのもので、ローカルプロキシのアドレスではありません。サブスクリプションには認証情報が含まれる場合があります。スクリーンショットを共有するときは、URL全体、ユーザーID、パスワードを隠してください。共有リンクが1つだけの場合は、「サーバー」→「クリップボードからURLを一括インポート」などのコマンドを使います。共有リンクをシステムプロキシのサーバー欄に入力しないでください。

• まずサブスクリプションの更新結果を確認：更新後、グループ内に設定が表示されるか、ログにダウンロード失敗、解析失敗、空の応答などが記録されていないか確認します。更新に成功したことと、サーバーに接続できることは別です。
• 次にプロトコルを確認：VMessとVLESSは異なるプロトコルです。WebSocketは通信方式、TLSは接続のセキュリティ設定であり、互いに置き換えることはできません。インポート後はサーバーが指定する組み合わせを維持してください。
• 設定に合ったコアを選択：VLESSやREALITYなどの設定には、該当機能に対応したコアとバージョンが必要です。XrayとV2Flyの機能は完全には一致しないため、コアの切り替えを万能な解決策と考えないでください。
• 設定をむやみに変更しない：サーバーアドレス、ポート、ユーザーID、通信パス、SNI、公鍵などはサーバー側の設定と一致させる必要があります。サブスクリプションで正しく設定されている項目を、別の解説画像を見て書き換えないでください。

待受ポート：クライアントとアプリの設定を統一

ローカル待受ポートは、ブラウザー、システム、コマンドラインからv2rayNに接続するための入口で、リモートサーバーのポートではありません。「設定」→「パラメーター設定」を開き、ローカル待受またはインバウンド関連の項目で、実際のアドレス、ポート、対応するプロキシ方式を確認してください。バージョンや以前の設定によってポート番号は異なる場合があるため、解説記事の記憶だけを頼りに入力しないでください。

以下の2つのカードは、現在 127.0.0.1:10808 でHTTPとSOCKSの両方を受け付ける混合待受が設定されていることを確認済みである前提です。クライアントで待受ポートを分けている場合は、それぞれ実際のポートを入力してください。例に合わせるためだけに、2種類の入口を同じポートに変更しないでください。

この端末だけで使う場合はループバック待受のままにし、LAN接続を許可する必要はありません。ポートを変更したら、コアに設定を再読み込みさせ、手動プロキシを設定したアプリのポートも更新してください。ログに address already in use と表示された場合は、まずクライアントが二重起動していないか確認し、ポートを使用中のプロセスを調べます。手当たり次第にポートを変更しないでください。

システムプロキシ：コアの動作確認後にアプリの通信を切り替える

初回のトラブルシューティングでは、まずTUNを有効にせず、ローカルプロキシの接続経路だけを確認しましょう。使用可能なノードがあり、コアの待受が始まってから、メイン画面またはトレイメニューの「システムプロキシ」で「システムプロキシを自動設定」を選びます。ここでいう「自動設定」はクライアントのメニュー操作であり、PACスクリプトのURLを手動入力することではありません。

• Windows：「設定」→「ネットワークとインターネット」→「プロキシ」を開き、プロキシのアドレスとポートが現在の待受先を指しているか確認します。組織のポリシーで管理されている端末では変更できない場合があるため、まず管理上のルールを確認してください。
• macOS：「システム設定」→「ネットワーク」→現在のネットワークサービス→「詳細」→「プロキシ」で確認します。macOSのバージョンによっては、ネットワークプロキシの変更に許可が必要です。権限の確認画面を見落とさないでください。
• アプリによる違い：すべてのアプリがシステムプロキシに従うとは限りません。一部のコマンドラインツール、ゲーム、独自にプロキシを設定するアプリは別の通信経路を使います。1つのアプリの結果から、すべての通信の状態を判断しないでください。
• 終了時の手順：使い終わったら、クライアントを終了する前にシステムプロキシを解除してください。終了後にWebページを開けない場合は、システムプロキシがローカルポートを指したままになっていないか確認しましょう。

プロキシを明示したリクエストで問題を切り分ける

WindowsではPowerShellで次のコマンドを実行します。macOSのターミナルでは curl.exe を curl に置き換えてください。この例では、ローカルの 10808 がHTTPプロキシを受け付けている必要があります。接続先の https://example.com/ は疎通確認用であり、専用の速度測定サービスではありません。

curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/

HTTPレスポンスが返れば、指定したプロキシ経由のリクエストが通ったことを確認できます。ただし、すべてのWebサイトやUDP通信が使えるとは限りません。ローカルポートに接続できない場合は待受状態を確認してください。プロキシ接続後にTLSエラーやリモート側のタイムアウトが起きる場合は、コアのログとノード、システム時刻、ネットワークを確認します。プロキシを明示したリクエストは成功するのにブラウザーだけ失敗する場合は、ブラウザー独自のプロキシ設定や拡張機能、システムプロキシを調べましょう。すぐにクライアントを再インストールする必要はありません。

初回起動でよくあるつまずき：症状から原因を切り分ける

設定完了後の確認：使える設定を保存してから応用設定へ

初回設定が完了したら、まず実際に動作した設定を記録し、その後に自動起動、ルーティングルール、TUNを検討してください。システムプロキシはアプリからクライアントへ接続を渡すかどうかを決め、ルーティングはコアに届いた接続の出口を決めます。両者は別の段階にあるため、システムプロキシを有効にしても、すべての接続先がリモートノードを経由するとは限りません。

• 固定フォルダー内のプログラムを再度起動でき、コアの起動ログにエラーがないことを確認します。
• 使用中のサブスクリプショングループ、ノードのプロトコル、コア、ローカル待受ポートを記録します。バックアップ時はサブスクリプションの認証情報を安全に保管してください。
• プロキシを明示したリクエストと、システムプロキシに従うブラウザーのアクセスをそれぞれテストします。
• システムプロキシを解除した状態でも通常どおりインターネットに接続できることを確認し、次回クライアントを終了した後に回線障害と誤認しないようにします。
• 応用設定を変更するときは、一度に1項目だけ変更してください。変更前のルーティング、DNS、インバウンド設定を保存しておけば、問題が起きたときに項目ごとに元へ戻せます。

設定の全手順を確認する場合はクライアント設定ガイドをご覧ください。VMess、VLESS、通信方式、コアの機能を比較する場合はプロトコルガイドをご覧ください。「設定をインポート済み」「コアが起動済み」「ポートに接続可能」「アプリがプロキシを使用中」の4点を順番に確認すると、インストーラーを何度もダウンロードし直すより原因を特定しやすくなります。