この記事は、v2rayNを初めて起動するWindows・macOSユーザー向けです。インストールパッケージの選択、ファイルの解凍、実行環境、コアの確認、日本語を含む画面言語、ローカルポート、サブスクリプションのインポート、システムプロキシまでを扱い、初回起動時のエラーへの対処法も説明します。完了後は、クライアント、コア、ノード、システムプロキシの状態をそれぞれ確認できます。
インストール前にシステム構成と保存場所を確認する
まずシステム情報でプロセッサーのアーキテクチャを確認し、対応するパッケージを選びます。Windowsではx64が一般的で、ARMプロセッサー搭載デバイスではarm64を選択します。macOSでもx64とarm64を区別する必要があります。構成を間違えると起動できないか、互換レイヤー経由で動作して余分なリソースを消費する場合があります。
Windowsでは、圧縮ファイルのプレビュー画面からメインプログラムを直接実行しないでください。すべてのファイルをユーザーフォルダー内の Applications\v2rayN など、固定したディレクトリに解凍します。v2rayNの設定、データベース、コアファイルは相対パスで関連付けられているため、メインプログラムだけを取り出すとコアの検出に失敗します。
ディレクトリには現在のアカウントから書き込める権限が必要です。プログラムを一時ダウンロードフォルダーに置いたままにしたり、管理者権限がないと変更できないシステムフォルダーに保存したりしないでください。初回終了時、クライアントは画面言語、ローカルポート、サブスクリプショングループ、ルーティング設定を保存します。書き込みに失敗すると、再起動後に設定が初期値へ戻ります。
解凍後に確認するファイル
- メインプログラムとその他のディレクトリが同じ階層にあり、実行ファイルだけをコピーしていないことを確認します。
- ディスクに少なくとも300 MBの空き容量を確保します。コアやルーティングデータベースの更新時には、新しいファイルも書き込まれます。
- ディレクトリ名に不正な制御文字が含まれていないことを確認します。通常の日本語、英字、数字、スペースは基本的に問題なく使用できます。
- 旧バージョンから移行する場合は、まず旧ディレクトリを残し、すぐに上書きしないでください。初回起動が成功してから、必要に応じて設定を移行します。
Windows・macOSの初回起動手順
Windowsでは、まずv2rayNのメインプログラムをダブルクリックします。デスクトップ実行環境が不足していると表示されたら、通知に記載されたメジャーバージョンとアーキテクチャを確認し、対応する.NET Desktop Runtimeをインストールします。x64のプログラムにはx64のランタイムが必要です。別のアーキテクチャ版だけをインストールしても、通常は起動問題を解決できません。
起動後、システムトレイにだけ表示される場合があります。まずタスクバーの通知領域を確認してから、起動に失敗したかを判断します。トレイアイコンをダブルクリックするとメインウィンドウが開き、右クリックメニューからシステムプロキシ、ルーティングモード、現在のノードを切り替えられます。
- ディレクトリ全体を解凍し、現在のアカウントに読み取り・書き込み権限があることを確認します。
- メインプログラムを起動し、クライアントが設定ディレクトリとログを初期化するまで10〜20秒待ちます。
- メインウィンドウを開き、「設定」→「パラメーター設定」に進み、言語とローカル待受ポートを確認します。
- ログ画面を開き、赤色の起動エラーが繰り返し表示されていないことを確認します。
- 有効な設定を1つインポートし、遅延テストを実行してからシステムプロキシを有効にします。
macOSで初回起動する際の対処
macOSでは、まずアプリケーションを固定したアプリケーションフォルダーへ移動してから、Finderで開きます。初回起動時に提供元の確認が表示されたら、「システム設定」→「プライバシーとセキュリティ」を開き、ブロックされたアプリケーション名を確認して、システムに表示された再度開くための入口を使用します。権限通知を理由に複数のコピーを何度も解凍しないでください。実際に起動しているプログラムを後から特定しにくくなります。
アプリケーションに実行権限がないと表示された場合は、まずダウンロードと解凍が完全に行われたか確認します。グラフィカルな解凍ツールで元の圧縮ファイルを再展開するほうが、ディレクトリ全体の権限を直接変更するより確実です。起動できても設定を保存できない場合は、アプリケーションデータディレクトリの所有者が現在のアカウントになっているか確認します。
クライアント・コア・ノードの3層を確認する
v2rayNは設定とシステムプロキシを管理する画面で、実際の接続は選択したコアが処理します。メインウィンドウが開くのはクライアント画面が起動したことを示すだけで、コアが正常に動作していることや、ノードに接続できることを意味しません。トラブルシューティングでは、この3層を分けて確認する必要があります。
まず「設定」→「パラメーター設定」→「コア設定」を開き、設定タイプに対応するコアを確認します。VLESS、VMessなどの設定は通常、Xrayコアで処理できます。次にノードを選択してアクティブサーバーに設定し、ログにローカル待受アドレスと送信接続の記録が生成されるか確認します。
| 確認する層 | 正常な状態 | 異常時にまず確認する項目 |
|---|---|---|
| クライアント画面 | メインウィンドウまたはトレイアイコンを操作でき、設定を保存できる | 実行環境、ディレクトリの書き込み権限、重複プロセス |
| プロキシコア | ログにローカルポートの待受開始が表示され、終了を繰り返していない | コアファイル、設定構文、ポート競合 |
| リモートノード | 遅延テストに数値が返り、接続ログに送信記録が表示される | アドレス、ポート、プロトコルパラメーター、ネットワーク到達性 |
| システムプロキシ | ブラウザーのリクエストがv2rayNのローカル待受ポートに入る | システムプロキシのスイッチ、ブラウザー個別のプロキシ、バイパスルール |
結論：まずローカル待受を確認し、その後リモート接続をテストする
ログに127.0.0.1の待受ポートが表示されていない場合、ブラウザーやサブスクリプションの設定を変更しても意味がありません。まずコアの起動とポート競合を解決し、その後ノードのプロトコルとリモートアドレスを確認します。
画面言語、ローカルポート、起動時の動作を設定する
「設定」→「パラメーター設定」→「v2rayN設定」を開き、言語を日本語に切り替えます。一部の7.xマイナーバージョンでは、画面を再起動すると言語変更が完全に反映されます。変更後はクライアントを通常の手順で終了してから再起動し、プロセスを直接強制終了しないでください。
ローカルポートはアプリケーションからv2rayNへ接続するために使用します。一般的な設定では、SOCKSの入口に10808、HTTPの入口に10809を使用しますが、具体的な値は現在の「パラメーター設定」に表示される内容を確認してください。ポートは変更できますが、同じデバイス上で2つのプログラムが同じアドレスとポートを同時に待ち受けることはできません。
ブラウザーがシステムプロキシを使用する場合、SOCKSアドレスを別途入力する必要はありません。コマンドラインツール、開発ツール、システムプロキシを参照しないプログラムだけ、127.0.0.1 と対応するポートを手動で指定します。手動入力時はSOCKSとHTTPの種類を区別してください。
| 設定項目 | 推奨する初期値 | 変更する条件 |
|---|---|---|
| 待受アドレス | 127.0.0.1 | この端末だけで使う場合はローカルループバックアドレスを維持 |
| SOCKSポート | 10808 | ログにそのポートが使用中と明確に表示された場合に変更 |
| HTTPポート | 10809 | 外部ツールがそのポートを使用している場合に変更 |
| 起動時に自動起動 | 初回のデバッグ中は無効にする | 正常起動を数回確認してから有効にする |
| サブスクリプションを自動更新 | まず手動で更新 | グループアドレスと更新方法が正しいことを確認してから有効にする |
サブスクリプションをインポートして初回接続テストを行う
「サブスクリプショングループ」→「サブスクリプショングループ設定」を開き、新しいグループを作成してサービス提供元のサブスクリプションアドレスを貼り付けます。グループ名はローカルで識別するためのものなので、用途に応じて入力できます。保存後にメイン画面へ戻り、「サブスクリプショングループ」→「すべてのサブスクリプションを更新（プロキシを経由しない）」を実行します。
初回更新では、まだ検証していないプロキシノードに依存しないのが基本です。現在のネットワークからサブスクリプションを直接取得できない場合は、プロキシ経由で更新します。ただし、一覧に動作する設定がすでに存在していることが前提です。更新後はノード数とプロトコルの種類を確認し、「更新成功」という表示だけで判断しないでください。
- ノードを1つ選択し、右クリックメニューからアクティブサーバーに設定します。
- 遅延テストを実行し、結果がタイムアウトや空欄でないことを確認します。遅延値はテスト経路に到達できることを示すだけで、すべてのWebサイトにアクセスできることを保証するものではありません。
- トレイメニューから「システムプロキシ」→「システムプロキシを自動設定」を選択します。
- 基本テストではデフォルトのルーティングモードを維持し、複雑なカスタムルールは一時的に追加しないでください。
- ブラウザーで普段使うページを開き、対応する接続がログに表示されるか確認します。
- テスト完了後に、中国本土をバイパスするルールやその他のルーティングルールを有効にするか判断します。
VMessとVLESSはノードのプロトコルであり、システムプロキシのモードではありません。システムプロキシはアプリケーションの通信をローカルポートへ送り、ルーティングルールはリクエストをプロキシ経由にするか直接接続にするかを決め、プロトコルパラメーターはコアがリモートサーバーへ接続する方法を決めます。この3つの概念を置き換えて考えることはできません。
結論：初回テストは単一ノードとデフォルトルートで行う
まず動作確認済みのノード1つで「サブスクリプション更新、遅延テスト、システムプロキシ、Webページ閲覧」の一連の流れを完了し、その後にカスタムDNSやルーティングルールを追加します。一度に複数の層を変更すると、ログから具体的な原因を特定しにくくなります。
初回起動でよくあるエラーと対処法
エラー対応では、まずコアが終了する原因となった最初の記録を確認します。その後に表示された接続失敗だけを見ないでください。ログには連鎖的な通知が出ることがあります。実行環境の不足でメインプログラムが終了し、ポート競合でコアが終了し、さらにコアの終了によってブラウザーにプロキシサーバーが応答しないと表示される、といった流れです。
エラー：You must install or update .NET to run this application.
原因と対処：必要な.NET Desktop Runtimeがインストールされていないか、実行環境のアーキテクチャが一致していません。表示された指示に従い、対応するメジャーバージョンとx64またはarm64のアーキテクチャ版をインストールしてから、v2rayNを再起動します。
エラー：A fatal error occurred. The required library hostfxr.dll could not be found.
原因と対処：実行環境のファイルが不足しているか、メインプログラムだけをコピーして完全なディレクトリを保持していません。インストールパッケージ全体を再解凍し、実行環境に依存するバージョンを使っている場合は、対応する.NET Desktop Runtimeも修復します。
エラー：failed to start listener: bind: address already in use
原因と対処：10808、10809、または現在の設定で使用している待受ポートが別のプロセスに占有されています。重複しているv2rayNのインスタンスを終了するか、「設定」→「パラメーター設定」でポートを変更し、コアを再起動します。
エラー：failed to find an available destination
原因と対処：リモートアドレスの名前解決に失敗している、ノードパラメーターが無効、または現在のネットワークから接続先へ到達できません。サーバーアドレスとポートを確認し、DNSの状態を更新してから、同じ接続先への失敗が続いているかログで確認します。
通知：開発元を確認できないため「v2rayN」を開けません
原因と対処：macOSが初回起動をブロックしています。アプリケーションの提供元とファイル名を確認し、「システム設定」→「プライバシーとセキュリティ」を開き、システムに表示された再度開くオプションを使用して確認を完了します。
現象：設定を保存しても再起動すると初期値に戻る
原因と対処：プログラムディレクトリまたはアプリケーションデータディレクトリに書き込めないか、プロセスが強制終了されています。現在のアカウントで書き込める場所へプログラムを移動し、1度通常の手順で終了してから、設定ファイルの更新時刻を確認します。
ログに残すべき情報
- エラー発生前後の約20行を残し、最初の失敗記録を確認できるようにします。
- v2rayNのメジャーバージョン、OSのバージョン、プロセッサーのアーキテクチャを記録します。
- 現在のコアの種類、ローカル待受ポート、エラー発生時刻を記録します。
- ログを共有する前に、サブスクリプションアドレス、ノードのドメイン、ユーザー識別子、認証情報を削除します。
初期設定でよくある質問
以下の問題は、クライアントは起動しているものの、接続経路がまだ完全に確立していない段階でよく発生します。確認の順序は、ローカル待受、アクティブノード、システムプロキシ、ルーティングルールのまま、層ごとに進めてください。
ウィンドウを閉じても動作しているのはなぜ？
v2rayNは通常、システムトレイに格納されて動作を続けます。完全に終了するには、トレイアイコンを右クリックして「終了」を選択します。メインウィンドウを閉じるだけではコアは停止せず、現在のシステムプロキシも自動的には解除されません。
サブスクリプションの更新に成功したのに、ノード一覧が空なのはなぜ？
「サブスクリプショングループ」→「サブスクリプショングループ設定」を開き、現在のグループを更新しているか確認し、グループのフィルター条件も確認します。その後、もう一度更新を実行し、ログで解析された設定数が0になっていないか確認します。
遅延値は表示されるのに、ブラウザーでページを開けないのはなぜ？
まずトレイのシステムプロキシが「システムプロキシを自動設定」になっているか確認し、ブラウザーが個別にプロキシを上書きしていないか確認します。次に、ページへアクセスした際にログへ接続記録が出るか確認します。記録がない場合、通信がローカルポートに入っていない可能性が高いです。
10808が使用中です。別のポートに直接変更できますか？
できます。「設定」→「パラメーター設定」で未使用のポート（例：10818）に変更し、保存後にコアを再起動します。コマンドラインツールやその他の手動プロキシアプリケーションも、新しいポートへ変更してください。
起動するたびにノードを選び直す必要がありますか？
通常の手順で終了すれば、v2rayNはアクティブサーバーを保存します。毎回初期値に戻る場合は、まず設定ディレクトリへの書き込み権限を確認します。保存が正常に行われることを確認してから、パラメーター設定で起動時の自動起動を有効にします。
初期設定完了後の確認リスト
初回インストールの最後に、完全な動作確認を行います。メインウィンドウが開くだけで成功と判断しないでください。クライアントが設定を保存でき、コアがローカルポートで安定して待ち受け、アクティブノードが有効な送信記録を生成し、システムプロキシを有効化・解除できることを確認します。
- v2rayNを再起動した後も、画面言語、サブスクリプショングループ、ローカルポートが元の値で保持される。
- ログにコアの起動とローカル待受の記録があり、終了を繰り返す状態になっていない。
- アクティブノードのプロトコル、アドレス、ポートがサービス提供元の情報と一致している。
- システムプロキシを有効にするとブラウザーのリクエストがログに表示され、無効にするとシステムプロキシ設定が復元される。
- 10808、10809、またはカスタムポートが、2つ目のクライアントインスタンスに占有されていない。
- Windowsのランタイムとプログラムのアーキテクチャが一致し、macOSでは初回起動の権限確認が完了している。
- サブスクリプション更新時に、プロキシ経由またはプロキシを経由しない方法を明確に選択でき、未知の状態に依存していない。
- 複雑なルーティング、DNS、自動起動は一時的に無効にし、基本接続が安定してから1項目ずつ追加する。