v2rayNを初めて使うときは、まずインストールパッケージのアーキテクチャと書き込み可能な保存先を確認し、次にコアの起動とローカルポートの待ち受けをチェックします。その後、サブスクリプションをインポートしてシステムプロキシを設定しましょう。Windows・macOSの初期設定を、プログラムの起動 → コアの起動 → ノードへの接続 → アプリの接続という順に確認できます。設定を一度に複数変更して原因が分からなくなるのを防ぎます。
インストールパッケージと解凍先：アーキテクチャと書き込み権限を確認
v2rayNは設定用の画面で、実際の接続は選択したコアが処理します。メイン画面が開いても、コアのファイルがそろっていることやノードが使えることの証明にはなりません。ダウンロード時はOS、プロセッサアーキテクチャ、配布パッケージの説明を確認してください。Windows版はデスクトップ版と従来のWPF版があり、ファイル名にx64とあるだけでは、現在の環境に適しているか判断できません。
Windows・macOSで保存先を確認する
Windows
- 「設定」→「システム」→「システム情報」を開き、システムの種類を確認してx64とARM64を見分けます。
- 圧縮ファイルは最後まで解凍し、たとえば現在のユーザーが書き込める
C:\Users\Public\Tools\v2rayNに保存します。保存先の実際のアクセス権も確認してください。 - メインプログラムと同じ場所にある依存ファイルやコアのフォルダーも残してください。実行ファイルだけをデスクトップに移動しないでください。
- ショートカットのリンク先は解凍後のプログラムにします。圧縮ファイルのプレビュー内にある一時ファイルを指定しないでください。
macOS
- Appleメニューから「このMacについて」を開き、AppleシリコンかIntelプロセッサかを確認します。
- 配布パッケージの形式に応じて解凍するかディスクイメージを開き、アプリを「アプリケーション」などの安定した場所に移動します。
- 読み取り専用のディスクイメージや一時的な解凍先から、アプリを使い続けないでください。
- ログに設定フォルダーへ書き込めないと表示された場合は、ログに記載されたフォルダーを確認します。ホームフォルダー全体の権限を安易に広げないでください。
プログラムと設定の保存先を決めてから、サブスクリプションをインポートします。アップデート前には設定をバックアップし、新旧のフォルダーから交互に起動しないようにしてください。
ポータブル版では、通常、設定や関連データがプログラムのフォルダー内に保存されます。アクセス制限のある場所に置いたあと、起動のたびに設定が消える場合は、まず書き込みに失敗していないか、別のコピーを起動していないかを確認してから、権限の変更を検討してください。パスはなるべく短くし、自動削除される一時フォルダーは避けましょう。日本語を含むパスが必ず問題を起こすわけではないため、それだけを理由にOSを再インストールする必要はありません。
初回起動：実行環境、システムによるブロック、TUNの権限を確認
Windowsで実行環境が不足しているというメッセージが表示されたら、案内にあるフレームワーク名、メジャーバージョン、アーキテクチャを確認して対応します。システムの実行環境に依存するパッケージと、必要なものを内包したパッケージでは条件が異なります。従来のWPF画面では対応するWindowsデスクトップランタイムが必要な場合があり、適当に別のメジャーバージョンをインストールしても代用できません。自己完結型パッケージをダウンロードしても起動しない場合は、ランタイムを何度も入れ直すのではなく、まずエラーログを確認してください。
-
最初にエラー内容を記録する
起動時のメッセージ、OSのバージョン、インストールパッケージ名を控えてください。ウィンドウがすぐ閉じる場合は、プログラムのログやシステムのアプリケーションエラー記録を確認し、実行環境の不足、ファイルの欠落、アーキテクチャの不一致を切り分けます。
-
起動許可を確認する
Windowsでセキュリティによってブロックされた場合は、「Windows セキュリティ」→「ウイルスと脅威の防止」→「保護の履歴」を確認します。提供元とブロックされた対象を確認してから対応し、セキュリティ機能全体を無効にしないでください。
-
OSの警告に対応する
macOSで、提供元を確認済みだが実行が許可されていないアプリの場合は、「システム設定」→「プライバシーとセキュリティ」に表示される内容を確認し、OSの手順に従って許可します。アプリが破損しているという警告が出た場合は、まずアーキテクチャに合ったパッケージを再ダウンロードしてください。
-
TUNの有効化は後回しにする
最初の接続では通常のローカルプロキシを使います。TUNは仮想ネットワークデバイスやルーティング、追加の権限が関係するため、通常のプロキシで接続を確認してから個別に設定してください。権限を求められた場合は、クライアントの案内に従って許可します。
サブスクリプションのインポートとコア選択：検証可能な設定をひとつ作る
サブスクリプションURLはノード一覧を取得するためのもので、ノードのサーバーアドレスでもブラウザーのプロキシアドレスでもありません。サブスクリプションには認証トークンが含まれる場合があるため、トラブルシューティング時にURL全体を公開しないでください。バージョンによってボタンの場所が異なることがあります。以下では「サブスクリプショングループ設定」「パラメーター設定」などの機能名を目印にし、実際の画面表示に従ってください。
-
サブスクリプショングループを追加する
「サブスクリプショングループ」→「サブスクリプショングループ設定」を開き、グループを追加します。見分けやすい名前とサブスクリプションURL全体を入力してください。先頭と末尾に空白がないことを確認して保存し、メイン画面に戻ります。
-
ノード一覧を更新する
「サブスクリプショングループ」メニューから更新します。初回で使えるノードがない場合は、まずプロキシを使わずに更新してみてください。提供元がプロキシ経由のアクセスを要求する場合は、すでに使える接続が必要です。まだインポートしていないノードを使ってこの手順を実行することはできません。
-
コアの種類を確認する
「設定」→「パラメーター設定」→「Core タイプ」を開き、使用するプロトコルに対応したコアか確認します。VLESS、REALITY、XTLS Visionを組み合わせた設定には、その組み合わせに対応するXrayコアを使用してください。名前が似ているからという理由で切り替えないでください。
-
使用するノードを選択する
ノードをひとつ選んでアクティブサーバーに設定し、設定の解析失敗やコアの終了がログに記録されていないか確認します。コアを切り替えたら画面の案内に従って再起動し、古いプロセスが残っていないことを確かめてください。
VMessとVLESSはプロキシプロトコル、XrayとV2Rayはコアのプロジェクト、v2rayNは設定を管理してコアを起動するクライアントです。この3つの役割は互いに代用できません。サブスクリプションのインポートに成功したのは、内容を読み込めたことを示すだけです。ノードに接続できるかどうかは、プロトコルのパラメーター、トランスポート方式、TLS設定、サーバーの状態にも左右されます。
- コアが見つからない場合：配布パッケージに対応するコアが含まれているか、セキュリティソフトがファイルを隔離していないか確認してください。別のアーキテクチャ向けのファイルをコピーしてフォルダーを埋め合わせないでください。
- 未知のフィールドまたは無効な設定と表示される場合：ノードの要件とコアの対応状況を確認し、元のエラーを保存してから、クライアントがサポートする方法でコアを更新してください。
- TLS関連のエラー：まずシステムの日付と時刻を同期し、サーバー名などの設定を確認してください。証明書の検証を無効にする方法を通常の解決策にしないでください。
ローカルリスニングポート：127.0.0.1と実際のポート番号を確認
ここでは、ローカルSOCKSまたはSOCKS互換の混合ポートの例として10808、現在のデバイスを示すアドレスとして127.0.0.1を使用します。すべての配布版で共通の固定値ではありません。まず「設定」→「パラメーター設定」を開き、ローカルの待ち受けアドレス、ポート、入口プロトコルを確認します。テストコマンドの値は、画面に表示された実際の設定に合わせてください。
| 確認する項目 | 正しい確認方法 | よくある間違い |
|---|---|---|
| SOCKSとHTTPの入口 | 入口のプロトコルに合わせてアプリのプロキシを設定します。混合ポートでは対応するプロトコルを利用できます。 | SOCKS専用ポートを、アプリのHTTPプロキシ欄に入力する。 |
| 専用のHTTPポート | 10809を手動で設定した場合は、そのポートが実際に待ち受けていることを確認します。 | 古いガイドに10809と書かれているため、自分の環境でも必ず有効だと思い込む。 |
| 待ち受けアドレス | このデバイス内で使う場合は、まず127.0.0.1を確認します。LAN内で共有する設定は別項目です。 | トラブルシューティングのためだけに、すべてのネットワークインターフェースで待ち受けるようにして、アクセス範囲を広げる。 |
| ポートの競合 | プロセスIDから使用中のプロセスを特定し、重複起動したプロセスを終了するか、ポートを変更します。 | アプリ側のポートだけ変更し、コアの待ち受け設定を更新しない。 |
Windows：待ち受け状態と使用中のプロセスを確認
Get-NetTCPConnection -LocalPort 10808 -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess
Test-NetConnection -ComputerName 127.0.0.1 -Port 10808PowerShellで上記のコマンドを実行します。最初のコマンドで結果が表示されない場合は、コアが起動しているか、ポート番号が正しいか確認してください。使用中のプロセスIDが表示されたら、タスクマネージャーで該当プロセスを確認します。正体の分からないシステムプロセスをそのまま終了しないでください。2つ目のコマンドで接続成功と表示されても、確認できるのはローカルのTCP入口に到達できることだけで、リモートノードへの接続を保証するものではありません。
macOS：待ち受けソケットを確認
lsof -nP -iTCP:10808 -sTCP:LISTEN出力されたプロセス名とPIDから、待ち受けているプロセスを特定できます。何も表示されない場合は、まずv2rayNのログでコアの起動エラーを確認してください。待ち受けポートを変更した場合は、コアを再起動してからもう一度確認します。古いポートでテストしながら、新しい設定が機能しないと判断しないでください。
システムプロキシとルーティング：入口を確認してから出口を判断
システムプロキシを設定すると、その設定に対応したアプリのリクエストがローカルの入口に送られます。ルーティングは、コアに入ったリクエストがどの出口を使うかを決めます。ルーティングをグローバルにしても、システムプロキシを無視するアプリが自動的に接続されるわけではありません。初回テストではTUNを無効にし、v2rayNの「システムプロキシ」メニューから「システムプロキシを自動設定」を選び、OS側に該当するプロキシが設定されていることを確認します。
- Windows：「設定」→「ネットワークとインターネット」→「プロキシ」を開き、現在のプロキシ設定を確認します。クライアントを終了したあともブラウザーが停止中のローカルポートを参照する場合は、クライアントを再起動し、「システムプロキシをクリア」を実行して元に戻してください。
- macOS：「システム設定」→「ネットワーク」→現在のネットワークサービス→「詳細」→「プロキシ」を開き、現在有効な項目を確認します。ネットワークサービスを切り替えた場合は、あらためて確認してください。クライアントのボタン表示だけで判断しないでください。
- ブラウザーとコマンドライン：ブラウザーは独自のプロキシ拡張機能の影響を受けることがあります。コマンドラインツールも、システムプロキシを参照するとは限りません。テスト時にプロキシを明示すると、入口の不確実性を減らせます。
以下のコマンドを実行するには、10808でSOCKSサービスが実際に待ち受けている必要があります。Windows PowerShellではcurl.exe、macOSのターミナルではcurlを使います。コマンド内のsocks5hは宛先ドメインの名前解決をプロキシ側で行うため、ローカルDNSとプロキシ接続の問題を切り分けるのに役立ちます。ただし、システムのDNS設定が変更されるわけではありません。
# Windows PowerShell
curl.exe --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com
# macOS ターミナル
curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com初回起動でよくある問題：症状から原因を絞り込む
ウィンドウは開くのに、ノードを選ぶとエラーになるのはなぜ？
ノードを有効にした直後に出る最初のエラーを確認します。ファイルが見つからない場合はコアの場所、設定の解析に失敗する場合はプロトコルとCoreタイプ、ポートが使用中の場合は待ち受け中のプロセスを確認してください。これら3種類のエラーをすべてサブスクリプションの不具合と決めつけないでください。
サブスクリプションの更新がタイムアウトしたら、プロキシ経由で更新する設定を有効にすべき？
使えるノードがあり、そのノードからサブスクリプションURLにアクセスできる場合は、「サブスクリプショングループ」メニューからプロキシ経由で更新できます。初回でノード一覧が空のときにこの設定を有効にしても、接続が自動的に確立するわけではありません。まずURLの有効性、ネットワークへの到達性、サービスの有効期限を確認してください。
遅延に数値が表示されるのに、Webページが開かないのはなぜ？
まず実行したのがTCP遅延テストか、実際の接続テストかを確認します。ポートに到達できても、プロトコルのハンドシェイクに成功したとは限りません。プロキシを明示したコマンドでリクエストを確認し、システムプロキシ、ブラウザーの設定、ルーティングログも調べてください。遅延の数値だけで接続状態を判断しないでください。
再起動するとサブスクリプションを再インポートする必要があります。設定が保存されていない？
まず別のプログラムのコピーから起動していないか確認し、次に設定フォルダーへ書き込めるか調べます。ショートカットやアプリの保存場所を固定し、終了後にもう一度起動して設定が残るか確認してください。フォルダーを移動する場合は、先に設定をバックアップし、新旧のプログラムを同時に起動しないでください。
設定完了後の確認手順
初回インストールでは、すべての機能を一度に有効にするのではなく、繰り返し確認できる接続経路をひとつ作ることが目標です。設定をひとつ変更するたびにテストしてください。失敗しても、直前に変更した設定に原因を絞り込めます。TUN、自動起動、より複雑なルーティングが必要な場合は、基本の接続が安定してからひとつずつ追加しましょう。
- プログラム：アプリが正常に起動し、終了して再度開いてもサブスクリプションと設定が残っている。
- コア：アクティブなノードを有効にしても設定の解析エラーがなく、ローカルポートが待ち受け状態になっている。
- 接続：プロキシを明示したテストで応答があり、ルーティングログと照らし合わせて使用された出口を確認できる。
- アプリ：対象のアプリに正しいプロキシが設定され、ブラウザーとコマンドラインそれぞれのテスト結果を説明できる。
- 終了時の復元：「システムプロキシをクリア」を実行してからクライアントを終了し、通常のネットワークリクエストが停止した待ち受けポートに依存していないことを確認する。
引き続き調査する場合は、OSとアーキテクチャ、v2rayNのバージョン、コア名とバージョン、入口ポート、最初のエラーログを記録してください。スクリーンショットを共有する前に、サブスクリプションのトークン、ノードの認証情報、サーバーの機密パラメーターを隠してください。何度も再インストールしたりコアを頻繁に切り替えたりするより、エラー前後の状況が分かる記録のほうが原因の特定に役立ちます。