この記事は、WindowsまたはmacOSで初めてv2rayNを使う方向けです。インストールパッケージ、保存先、カーネル、サブスクリプション、システムプロキシ、自動起動の順に確認し、まずはブラウザーで再現性のある接続を確立しましょう。TUNや複雑なルーティング設定はその後で構いません。ポート番号は設定例です。メニュー名はデスクトップ版と従来のWPF版で異なる場合があるため、実際の待ち受けポートやエラーは画面とログで確認してください。
インストールパッケージの選び方:OS・アーキテクチャ・画面の種類
v2rayNは、ノードの管理やプロキシカーネルの起動、システムプロキシの設定を行うデスクトップクライアントです。インストールしただけで使えるノードが手に入るわけではありません。初めてダウンロードする際は、ファイルサイズだけでなくOSとCPUアーキテクチャを確認しましょう。Windowsではx64とARM64、macOSではIntelとAppleシリコンで対応するビルドが異なります。画面が起動しても、同梱カーネルが環境に合っているとは限りません。
- Windows:「設定」→「システム」→「バージョン情報」を開き、「システムの種類」でプロセッサの種類を確認します。一般的なIntel・AMD搭載PCではx64を選び、ARM搭載PCではダウンロードページの案内に従ってください。
- macOS:Appleメニューから「このMacについて」を開き、「チップ」または「プロセッサ」を確認します。Appleシリコン搭載Macでは対応するARM64ビルドを、Intel搭載Macではx64ビルドを選びます。
- 画面の種類:クロスプラットフォーム版はWindows、macOS、Linuxに対応し、従来のWPF版はWindows向けです。メニューの配置は同じではないため、一方の画面でのボタン位置を、もう一方とそのまま照らし合わせないでください。
クロスプラットフォーム版
おすすめ初めて使う場合は、ダウンロードページでOSとアーキテクチャを選び、デスクトップ版から始めるとよいでしょう。WindowsとmacOSで確認の流れは共通ですが、システム権限やプロキシの設定方法はそれぞれ確認が必要です。
おすすめのユーザー:初めてインストールする方、WindowsとmacOSの両方を使う方。
Windows従来版(WPF)
従来のWindows向け画面を使えます。以前の操作に慣れている場合に適していますが、設定を移行する前にバックアップしてください。2つのバージョンを同時に起動すると、ローカルポートが競合することがあります。
おすすめのユーザー:Windowsで従来の画面や操作方法を使い続けたい方。
インストール先:展開を完了してから起動する
圧縮ファイルは、アーカイブソフトのプレビュー画面から直接実行できません。メインプログラムは通常、同じフォルダーにあるカーネルやリソース、設定ファイルも必要です。実行ファイルだけを取り出すと、画面は起動してもコアプロセスを読み込めないことがあります。インストーラー、圧縮ファイル、ディスクイメージでは扱い方が異なるため、選んだパッケージの説明に従ってください。
-
パッケージの種類を確認
インストーラーはウィザードに従ってインストールします。圧縮ファイルは、まず固定のフォルダーにすべて展開してください。macOSでディスクイメージが配布されている場合は、開いた後にアプリを「アプリケーション」へ移動します。マウントしたディスクイメージから長期間起動しないでください。
-
保存先を固定
Windowsの展開版は、
D:\Apps\v2rayNのような書き込み可能なフォルダーに保存できます。一時フォルダーや圧縮ファイルのプレビュー用フォルダー、同期ドライブは避けましょう。パスに日本語が含まれていても、すぐに問題とは限りません。フォルダーに書き込めることと、ファイルがすべてそろっていることが重要です。 -
起動時の警告に対処
Windowsでランタイム不足の警告が出たら、必要なランタイム名とアーキテクチャを確認し、パッケージの説明に沿って準備してください。DLLを適当にダウンロードするのは避けましょう。macOSで開発元を確認できないという警告が出た場合は、配布元を確認したうえで、「システム設定」→「プライバシーとセキュリティ」にアプリを許可する項目があるか確認します。
-
初回は通常の権限で起動
まずは通常のユーザー権限で起動し、システムプロキシのモードだけをテストします。最初からTUNを有効にしたり、問題解決のためにすぐ管理者権限で起動したりしないでください。権限の問題とノードの問題を切り分けやすくなります。
-
動作記録を残す
「ヘルプ」→「バージョン情報」でクライアントのバージョンを記録し、ログでカーネル名とバージョンも確認します。一度終了して再度起動した後もノードが残っているか確認し、設定が正常に保存されることを確かめてください。
カーネルの読み込み:画面の起動とプロキシの準備状況を分けて確認
v2rayNの画面を動かすプロセスと、実際に通信を中継するカーネルプロセスは別です。ノードを選んで有効なサーバーに設定した後、カーネルが起動し、ローカルポートで待ち受けていることを確認してください。ログの「ファイルが見つからない」「アクセス権がない」「アドレスが使用中」は、それぞれ原因が異なります。接続ボタンを何度も押しても解決しません。
「設定」→「パラメーター設定」を開き、現在のバージョンにあるカーネル選択または「Coreタイプ」に関する項目を探して、ノードに使うカーネルを確認します。画面の構成が異なる場合は、機能名と動作ログを参考にしてください。ノード名にV2Rayとあるからといって、すべての設定を特定のカーネルに切り替えないでください。VMessやVLESSはプロトコル名、Xrayなどはカーネルの実装名です。ノードでは通信方式やセキュリティ設定も指定されています。
- カーネルファイルがない:必要なカーネルが含まれた完全なパッケージか確認してください。別途カーネルを用意する必要があるビルドでは、パッケージの説明に従って指定の場所に配置します。ファイル名をむやみに変更しないでください。
- VLESSとREALITY:選択したカーネルが、サーバーで指定された組み合わせに対応しているか確認してください。サーバー名、公開鍵、Short ID、flowなどはサブスクリプションの値をそのまま使い、推測で入力しないでください。
- VMessと時刻:ログに認証や時刻に関するエラーが出た場合は、まずシステム時刻の自動設定を確認し、その後ノードの設定を見直してください。システム時刻が大きくずれていると、TLS証明書の検証にも影響することがあります。
- 古いプロセスを終了:トレイまたはメニューバーから別のv2rayNを終了してから、現在のバージョンを起動します。2つの画面がそれぞれカーネルを起動し、同じ待ち受けポートを取り合う場合があります。
サブスクリプションの登録:提供元を確認し、ノードを1つテスト
クライアントのインストールパッケージに、サーバーへの接続情報は含まれていません。サブスクリプションURLはサービス提供元から取得します。アクセス情報が含まれることが多いため、アカウントのパスワードと同じように管理してください。URL全体を公開スクリーンショットや掲示板、オンライン解析ツールに貼り付けないでください。問い合わせる際はステータスコードやエラーの内容を伝え、URL内のトークンは隠しましょう。
- 「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、グループを追加して、わかりやすい名前とサブスクリプションURLを入力します。画面のバージョンによって、追加操作は「追加」または「+」で表示されます。
- 保存後、「サブスクリプショングループ」メニューから対象グループを更新します。まだ使えるプロキシがない場合は、まずプロキシを経由せずに更新してください。直接接続で失敗し、使えるノードがある場合に限り、プロキシ経由での更新を試します。
- 更新に成功したら、サーバー一覧に項目が追加されていることを確認します。グループ名だけが表示され、サーバーがない場合は、応答が空、サブスクリプションの期限切れ、現行バージョンで未対応の形式などが考えられます。まず更新ログを確認してください。
- ノードを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やリモート接続のエラーは、カーネルログも合わせて判断してください。
- コマンドは成功するのにブラウザーで失敗する:ブラウザー独自のプロキシ設定を一時的に無効にし、別のポートを使っていないか確認します。
- コマンドもブラウザーも失敗する:まずカーネルが動作しているかを確認し、次に有効なノードとログを確認します。すぐにDNS、Mux、すべてのルーティングルールを変更しないでください。
- 一部のWebサイトだけ失敗する:ドメイン名、時刻、適用されたルーティングを記録し、DNSやルーティング設定を確認します。一度のアクセス失敗を、すぐにインストールパッケージの問題と決めつけないでください。
自動起動と終了:プロキシ設定が残らないよう確認
自動起動の設定は、接続を確認した後に行いましょう。クライアントの自動起動、起動後の最小化、自動的なシステムプロキシ設定は、それぞれ別の項目です。画面がバックグラウンドで動いていても、システムプロキシが設定されているとは限りません。プロキシが有効でも、前回のノードが使えるとは限りません。初期設定を終えたら、少なくとも一度は終了後の再起動と、再ログイン後の動作を確認してください。
- クライアント側:「設定」→「パラメーター設定」で、自動起動や起動後の最小化に関する項目を探し、必要に応じて有効にします。現在のビルドに該当項目がない場合は、OSの起動管理機能を使ってください。
- Windows側:「設定」→「アプリ」→「スタートアップ」で起動項目を確認します。ショートカット、タスクスケジューラ、クライアントの自動起動を重複して設定しないようにしてください。
- macOS側:「システム設定」→「一般」→「ログイン項目」で、ログイン時にアプリを起動できる設定か確認します。アプリの保存場所を移動した場合は、ログイン項目が引き続き有効かも確認してください。
- 終了する前に:「システムプロキシ」メニューで「システムプロキシを解除」を選んでから、クライアントを終了します。その後、通常のWebページが直接接続で開けることを確認してください。社内ネットワークのプロキシを以前から使っている場合は、設定を一律に消去せず、元の状態に戻してください。
初回インストールでよくある質問:症状に合わせて一つずつ確認
メイン画面は表示されるのに、インターネットに接続できないのはなぜ?
まず有効なサーバーを選び、カーネルの起動失敗がログにないことを確認します。次に「システムプロキシ」が「システムプロキシを自動設定」になっているか確認してください。プロキシを明示したcurlリクエストが成功する場合は、クライアントを再インストールせず、ブラウザーとシステムプロキシの設定を優先して確認しましょう。
ポートが使用中と表示されたら、ノードを変更すべき?
多くの場合、原因はローカルの待ち受けポートの競合です。接続先のノードを変えてもポートは解放されません。古いクライアントと残ったカーネルを終了し、実際の待ち受けポートを確認してください。ポートを変更する場合、たとえば10808から10818に変更したら、システムプロキシとブラウザーの手動設定も合わせて変更します。
サブスクリプションの更新がタイムアウトします。先にプロキシ経由の更新を有効にしてもいい?
プロキシ経由で更新するには、まず使えるノードが必要です。最初にプロキシを経由しない更新を試し、サブスクリプションURLが完全か、期限切れでないか確認してください。使えるノードがある場合は、「サブスクリプショングループ」メニューからプロキシ経由での更新を試します。認証に失敗した場合は提供元に問い合わせ、速度測定を繰り返さないでください。
macOSで毎回パスワードを求められるのは正常?
まず、どの操作が通知を表示させているか確認してください。システムプロキシの変更や設定に関わる補助機能の権限には、認証が必要な場合があります。起動のたびに繰り返し表示される場合は、内容を記録し、アプリが「アプリケーション」に固定して保存されているか確認してください。警告を消すために、クライアント全体を常に高い権限で起動しないでください。
初回インストールからTUNを有効にしたほうがいい?
最初は有効にしないでください。TUNは仮想ネットワークインターフェース、ルーティング、権限に関わるため、システムプロキシの動作を確認した後、システムプロキシを参照しないアプリへの対応に使います。テストする場合は、先に元の設定を記録し、一度に有効にする項目を1つにしてください。問題が起きたら無効にし、通常の接続が復旧するか確認します。
インストール完了の目安は明確です。クライアントを再起動しても設定を読み込めること、有効なノードでカーネルが起動すること、ブラウザーがシステムプロキシ経由でアクセスできること、終了後に直接接続へ戻ること、再ログイン後の自動起動が想定どおりであることを確認します。クライアントとカーネルのバージョン、待ち受けポート、失敗時のログを記録しておくと、「つながらない」という説明より原因を特定しやすくなります。設定をバックアップする際は、サブスクリプションの認証情報やノードの鍵が含まれる場合があるため、公開しないでください。