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

v2rayNのインストールから初回起動まで、パッケージの選び方、カーネルの読み込み、システムプロキシ、自動起動の設定と、初心者がつまずきやすい点を解説します。

この記事のポイント

この記事は、WindowsまたはmacOSで初めてv2rayNを使う方向けです。インストールパッケージ、保存先、カーネル、サブスクリプション、システムプロキシ、自動起動の順に確認し、まずはブラウザーで再現性のある接続を確立しましょう。TUNや複雑なルーティング設定はその後で構いません。ポート番号は設定例です。メニュー名はデスクトップ版と従来のWPF版で異なる場合があるため、実際の待ち受けポートやエラーは画面とログで確認してください。

インストールパッケージの選び方:OS・アーキテクチャ・画面の種類

v2rayNは、ノードの管理やプロキシカーネルの起動、システムプロキシの設定を行うデスクトップクライアントです。インストールしただけで使えるノードが手に入るわけではありません。初めてダウンロードする際は、ファイルサイズだけでなくOSとCPUアーキテクチャを確認しましょう。Windowsではx64とARM64、macOSではIntelとAppleシリコンで対応するビルドが異なります。画面が起動しても、同梱カーネルが環境に合っているとは限りません。

クロスプラットフォーム版

おすすめ

初めて使う場合は、ダウンロードページでOSとアーキテクチャを選び、デスクトップ版から始めるとよいでしょう。WindowsとmacOSで確認の流れは共通ですが、システム権限やプロキシの設定方法はそれぞれ確認が必要です。

おすすめのユーザー:初めてインストールする方、WindowsとmacOSの両方を使う方。

Windows従来版(WPF)

従来のWindows向け画面を使えます。以前の操作に慣れている場合に適していますが、設定を移行する前にバックアップしてください。2つのバージョンを同時に起動すると、ローカルポートが競合することがあります。

おすすめのユーザー:Windowsで従来の画面や操作方法を使い続けたい方。

インストール先:展開を完了してから起動する

圧縮ファイルは、アーカイブソフトのプレビュー画面から直接実行できません。メインプログラムは通常、同じフォルダーにあるカーネルやリソース、設定ファイルも必要です。実行ファイルだけを取り出すと、画面は起動してもコアプロセスを読み込めないことがあります。インストーラー、圧縮ファイル、ディスクイメージでは扱い方が異なるため、選んだパッケージの説明に従ってください。

  1. パッケージの種類を確認

    インストーラーはウィザードに従ってインストールします。圧縮ファイルは、まず固定のフォルダーにすべて展開してください。macOSでディスクイメージが配布されている場合は、開いた後にアプリを「アプリケーション」へ移動します。マウントしたディスクイメージから長期間起動しないでください。

  2. 保存先を固定

    Windowsの展開版は、D:\Apps\v2rayNのような書き込み可能なフォルダーに保存できます。一時フォルダーや圧縮ファイルのプレビュー用フォルダー、同期ドライブは避けましょう。パスに日本語が含まれていても、すぐに問題とは限りません。フォルダーに書き込めることと、ファイルがすべてそろっていることが重要です。

  3. 起動時の警告に対処

    Windowsでランタイム不足の警告が出たら、必要なランタイム名とアーキテクチャを確認し、パッケージの説明に沿って準備してください。DLLを適当にダウンロードするのは避けましょう。macOSで開発元を確認できないという警告が出た場合は、配布元を確認したうえで、「システム設定」→「プライバシーとセキュリティ」にアプリを許可する項目があるか確認します。

  4. 初回は通常の権限で起動

    まずは通常のユーザー権限で起動し、システムプロキシのモードだけをテストします。最初からTUNを有効にしたり、問題解決のためにすぐ管理者権限で起動したりしないでください。権限の問題とノードの問題を切り分けやすくなります。

  5. 動作記録を残す

    「ヘルプ」→「バージョン情報」でクライアントのバージョンを記録し、ログでカーネル名とバージョンも確認します。一度終了して再度起動した後もノードが残っているか確認し、設定が正常に保存されることを確かめてください。

カーネルの読み込み:画面の起動とプロキシの準備状況を分けて確認

v2rayNの画面を動かすプロセスと、実際に通信を中継するカーネルプロセスは別です。ノードを選んで有効なサーバーに設定した後、カーネルが起動し、ローカルポートで待ち受けていることを確認してください。ログの「ファイルが見つからない」「アクセス権がない」「アドレスが使用中」は、それぞれ原因が異なります。接続ボタンを何度も押しても解決しません。

「設定」→「パラメーター設定」を開き、現在のバージョンにあるカーネル選択または「Coreタイプ」に関する項目を探して、ノードに使うカーネルを確認します。画面の構成が異なる場合は、機能名と動作ログを参考にしてください。ノード名にV2Rayとあるからといって、すべての設定を特定のカーネルに切り替えないでください。VMessやVLESSはプロトコル名、Xrayなどはカーネルの実装名です。ノードでは通信方式やセキュリティ設定も指定されています。

サブスクリプションの登録:提供元を確認し、ノードを1つテスト

クライアントのインストールパッケージに、サーバーへの接続情報は含まれていません。サブスクリプションURLはサービス提供元から取得します。アクセス情報が含まれることが多いため、アカウントのパスワードと同じように管理してください。URL全体を公開スクリーンショットや掲示板、オンライン解析ツールに貼り付けないでください。問い合わせる際はステータスコードやエラーの内容を伝え、URL内のトークンは隠しましょう。

  1. 「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、グループを追加して、わかりやすい名前とサブスクリプションURLを入力します。画面のバージョンによって、追加操作は「追加」または「+」で表示されます。
  2. 保存後、「サブスクリプショングループ」メニューから対象グループを更新します。まだ使えるプロキシがない場合は、まずプロキシを経由せずに更新してください。直接接続で失敗し、使えるノードがある場合に限り、プロキシ経由での更新を試します。
  3. 更新に成功したら、サーバー一覧に項目が追加されていることを確認します。グループ名だけが表示され、サーバーがない場合は、応答が空、サブスクリプションの期限切れ、現行バージョンで未対応の形式などが考えられます。まず更新ログを確認してください。
  4. ノードを1つ選び、右クリックメニューの「アクティブサーバーに設定」で有効にしてから、カーネルログを確認します。表の行を選択しただけで、実際の接続先が切り替わったと思い込まないでください。

初回の確認ではノードを1つ選べば十分です。サブスクリプション全体の速度測定を何度も行う必要はありません。遅延測定に成功しても、その測定リクエストに応答があっただけで、ブラウザーがプロキシを使っているとは限りません。ダウンロード速度が特定の値に達することを示すものでもありません。まず同じノードで実際にWebページへアクセスし、その後ほかのノードと比較すると、再現性のある切り分けができます。

システムプロキシとポート:まずブラウザーで基本動作を確認

システムプロキシとルーティング設定は別のものです。前者はアプリの通信をローカルプロキシに送るかどうかを決め、後者はカーネルに届いた通信の出先を決めます。初回テストでは、v2rayNのメイン画面またはトレイにある「システムプロキシ」メニューから「システムプロキシを自動設定」を選び、通常のルーティング設定は維持してください。システムプロキシを有効にしても、すべてのアプリがプロキシ経由になるわけではありません。システムプロキシを参照しないアプリもあります。

クライアントの待ち受け設定例

待ち受けアドレス
127.0.0.1
混合ポート
10808(この記事の例)
LANからの接続を許可
初回インストール時は無効のまま
確認場所
「設定」→「パラメーター設定」内のローカル待ち受け項目

混合ポートではHTTPとSOCKSのリクエストを受け付けます。そのポートが提供されているか、具体的な番号はいくつかを、現在の設定で確認してください。

システムプロキシの設定値

サーバー
127.0.0.1
プロキシポート
クライアントで実際に待ち受けているHTTPまたは混合ポートと同じ値
設定例
混合ポートが10808の場合、HTTPプロキシにも10808を指定
以前の設定を確認
10809のままの場合は、そのポートで実際に待ち受けているか確認

古いガイドのポート設定をそのまま使わないでください。独立したHTTPポートがクライアントで実際に提供されている場合に限り、そのポートを指定します。

Windowsでは「設定」→「ネットワークとインターネット」→「プロキシ」でシステムプロキシを確認できます。macOSでは「システム設定」→「ネットワーク」→現在の接続→「詳細」→「プロキシ」を開きます。設定画面の名称はOSのバージョンによって異なります。まずクライアントから設定し、その結果をシステム側の画面で確認してください。両方から同時に変更すると混乱の原因になります。

curl -I -x http://127.0.0.1:10808 https://example.com

以下のコマンドは、10808でHTTPまたは混合プロキシを実際に提供している場合にのみ使えます。Windowsでは、コマンドのエイリアスの影響を避けるためにcurl.exeを使用できます。プロキシを明示的に指定することで、「ローカルプロキシが使えるか」と「システムプロキシがアプリに反映されていないか」を切り分けられます。HTTP応答が返っても、確認したリクエストに応答があったことを示すだけで、速度測定ではありません。接続が拒否された場合は、まず待ち受けポートを確認します。TLSやリモート接続のエラーは、カーネルログも合わせて判断してください。

自動起動と終了:プロキシ設定が残らないよう確認

自動起動の設定は、接続を確認した後に行いましょう。クライアントの自動起動、起動後の最小化、自動的なシステムプロキシ設定は、それぞれ別の項目です。画面がバックグラウンドで動いていても、システムプロキシが設定されているとは限りません。プロキシが有効でも、前回のノードが使えるとは限りません。初期設定を終えたら、少なくとも一度は終了後の再起動と、再ログイン後の動作を確認してください。

初回インストールでよくある質問:症状に合わせて一つずつ確認

メイン画面は表示されるのに、インターネットに接続できないのはなぜ?

まず有効なサーバーを選び、カーネルの起動失敗がログにないことを確認します。次に「システムプロキシ」が「システムプロキシを自動設定」になっているか確認してください。プロキシを明示したcurlリクエストが成功する場合は、クライアントを再インストールせず、ブラウザーとシステムプロキシの設定を優先して確認しましょう。

ポートが使用中と表示されたら、ノードを変更すべき?

多くの場合、原因はローカルの待ち受けポートの競合です。接続先のノードを変えてもポートは解放されません。古いクライアントと残ったカーネルを終了し、実際の待ち受けポートを確認してください。ポートを変更する場合、たとえば10808から10818に変更したら、システムプロキシとブラウザーの手動設定も合わせて変更します。

サブスクリプションの更新がタイムアウトします。先にプロキシ経由の更新を有効にしてもいい?

プロキシ経由で更新するには、まず使えるノードが必要です。最初にプロキシを経由しない更新を試し、サブスクリプションURLが完全か、期限切れでないか確認してください。使えるノードがある場合は、「サブスクリプショングループ」メニューからプロキシ経由での更新を試します。認証に失敗した場合は提供元に問い合わせ、速度測定を繰り返さないでください。

macOSで毎回パスワードを求められるのは正常?

まず、どの操作が通知を表示させているか確認してください。システムプロキシの変更や設定に関わる補助機能の権限には、認証が必要な場合があります。起動のたびに繰り返し表示される場合は、内容を記録し、アプリが「アプリケーション」に固定して保存されているか確認してください。警告を消すために、クライアント全体を常に高い権限で起動しないでください。

初回インストールからTUNを有効にしたほうがいい?

最初は有効にしないでください。TUNは仮想ネットワークインターフェース、ルーティング、権限に関わるため、システムプロキシの動作を確認した後、システムプロキシを参照しないアプリへの対応に使います。テストする場合は、先に元の設定を記録し、一度に有効にする項目を1つにしてください。問題が起きたら無効にし、通常の接続が復旧するか確認します。

インストール完了の目安は明確です。クライアントを再起動しても設定を読み込めること、有効なノードでカーネルが起動すること、ブラウザーがシステムプロキシ経由でアクセスできること、終了後に直接接続へ戻ること、再ログイン後の自動起動が想定どおりであることを確認します。クライアントとカーネルのバージョン、待ち受けポート、失敗時のログを記録しておくと、「つながらない」という説明より原因を特定しやすくなります。設定をバックアップする際は、サブスクリプションの認証情報やノードの鍵が含まれる場合があるため、公開しないでください。

v2rayNのインストールパッケージ