WindowsまたはmacOSで初めてv2rayNを使うときは、次の3点を順に確認します。メイン画面が開くこと、選択したノードからローカルプロキシ経由でリクエストを送れること、ブラウザーがシステムプロキシ設定を使えることです。前の段階を確認してから次へ進めば、起動時のクラッシュ、空のサブスクリプション、ブラウザーの接続不良が起きても、どの層を調べればよいか判断しやすくなります。
インストールパッケージ、展開先、初回起動時の権限
デスクトップアプリとプロキシコアは別のものです。ダブルクリックしてもメイン画面が表示されない場合は、まずパッケージ、実行環境、システムの警告を確認します。画面は開くものの、ノード選択後にログでエラーが出る場合は、コアファイル、ノード設定、ポートを確認してください。以下では、v2rayN 7.xの中国語版でよく使われるメニュー名を例にしています。マイナーバージョンによって項目名やボタンの位置が異なることがあります。
- Windowsでは、まずシステムの種類を確認します。「設定」→「システム」→「バージョン情報」を開き、「システムの種類」を確認してください。一般的なIntelまたはAMDの64ビットPCではx64を選び、ARMデバイスではシステムのアーキテクチャに合ったパッケージを選びます。圧縮ファイルは、
%LOCALAPPDATA%\Programs\v2rayNなど、現在のユーザーが書き込める固定の場所にすべて展開してください。圧縮ソフトのプレビューから実行したり、メインプログラムだけを取り出したりしないでください。コアや依存ファイルも必要です。 - ランタイムは、起動時のメッセージとパッケージの説明に従ってください。たとえばWindowsのWPFパッケージで
Microsoft.WindowsDesktop.App 8.0が必要と明記されている場合は、アプリのアーキテクチャに合った.NET 8 Desktop Runtimeをインストールします。同じ8.0でも、通常の.NET Runtimeはデスクトップランタイムの代わりにはなりません。別のメジャーバージョンをインストールしても要件を満たすとは限りません。パッケージに実行環境が含まれている場合は、説明に従って起動し、追加インストールは不要です。 - macOSでは、チップの種類とアプリの保存場所を確認します。Appleメニューの「このMacについて」を開き、「チップ」にAppleシリコンと表示される場合はarm64、「プロセッサ」にIntelと表示される場合はx64を選びます。ディスクイメージの場合は、同梱の手順に従ってアプリを「アプリケーション」にコピーし、その場所から起動してください。圧縮ファイルの場合は、先にすべて展開します。マウントしたディスクイメージやダウンロードフォルダーから常用しないでください。
- セキュリティによるブロックと権限不足は、表示内容で切り分けます。システムの警告が出たら、ダウンロード元、OSのバージョン、パッケージの種類を確認してから、Windows セキュリティの「保護の履歴」またはmacOSの「システム設定」→「プライバシーとセキュリティ」で理由を確認してください。アプリが破損している、またはマルウェアの可能性があるという警告が出た場合は起動せず、入手元を確認し直してください。ログに設定フォルダーへの書き込み不可とあるだけなら、書き込み可能な場所へ移します。毎回管理者として実行しても根本的な解決にはなりません。
サブスクリプションを追加して、まずノードを1つ確認
サブスクリプションURLを登録しただけでは、ノードの取得が成功したとは限りません。初回設定では、参照元を1つ、ノードを1つに絞り、サブスクリプションの更新、コアの起動、システムプロキシを個別に確認します。URLにアカウントトークンが含まれることがあるため、スクリーンショットを共有する前にURL全体を隠し、ログに出力されていないかも確認してください。
サブスクリプショングループを追加する
メイン画面で「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、ウィンドウ内の「追加」をクリックします。見分けやすい名前を入力し、任意のURL欄にサブスクリプションURL全体を貼り付けて保存してください。
vmess://またはvless://で始まる単一の共有リンクを受け取った場合は、「サーバー」メニューからクリップボードのインポート機能を使います。サブスクリプションURL欄には入力しないでください。現在のグループを更新する
メイン画面に戻り、新しいグループを選択します。「サブスクリプショングループ」メニューから現在のサブスクリプションを更新し、初回はプロキシを使わない更新方法を試してください。ログで取得結果を確認し、グループ内にノードが表示されるかを見ます。更新に成功したことは一覧を取得できたという意味であり、ノードの接続成功を示すものではありません。
使用するノードを選択する
一覧で利用可能と確認済みのノードを右クリックし、「アクティブサーバーに設定」を選びます。行をクリックしただけでは一覧項目を選択したにすぎず、コアが切り替わったとは判断できません。切り替え後はメイン画面の現在のノードとログを確認し、コアの起動失敗やポートのバインドエラーがないかを見てください。
ローカルポートを確認する
「設定」→「パラメーター設定」を開き、「v2rayN設定」にあるローカルの待ち受けポートを確認します。実際の値を控え、後述の明示的なプロキシリクエストでテストしてください。この段階ではノードの切り替え、ルーティングルールの変更、TUNの有効化を同時に行わないでください。リクエストに失敗したとき、原因を特定しにくくなります。
ノードの設定に合わせてコアを選ぶ
v2rayNはデスクトップクライアントで、接続処理を行うコアはXrayやV2Rayです。「設定」→「パラメーター設定」→「Coreタイプ」を開きます。通常は設定内容に合わせてコアを選び、任意のノードを一律に別のプロトコルへ変換するものではありません。サブスクリプションを取り込んだ後は、まず元の設定を維持してください。ログに未対応の設定が明示された場合に限り、コアの選択とバージョンを確認します。
Xrayコア
おすすめVLESS + REALITYの設定を取り込んだ場合は、サーバー側の案内に従ってXrayを選んでください。トランスポート方式、セキュリティ設定、Flowはサーバー側と一致させる必要があります。ノードにFlowが設定されていない場合、例に合わせるためだけに追加しないでください。認識されない項目があるときは、ログで起動したコアとバージョンを確認します。
向いているケース: サブスクリプションにVLESS + REALITYが明記されている場合、またはサーバー側からXrayを指定されている場合。
V2Rayコア
現在のクライアントにこの項目があり、管理者から適用可能なV2RayのバージョンとVMess設定が明示されている場合は、その案内に従って選択します。VMess + WebSocket + TLSの設定では、パスとサーバー名を元の値のまま使ってください。コアをV2Rayに変更するだけでは、パスや証明書名の誤りは修正されません。
向いているケース: V2Rayサーバーの設定手順が明確で、元の設定どおりに接続する必要がある場合。
ローカルの待ち受けポートとシステムプロキシを別々に確認する
ノード詳細にあるサーバーポートはリモート接続先の情報です。一方、ブラウザーやターミナルが使うのはローカルの待ち受けポートで、別の設定です。以下では10808を例にします。パラメーター設定とログの両方で、そのポートがHTTPプロキシリクエストを受け付けると確認できた場合に限り、例をそのまま実行してください。SOCKS専用ポートと表示されている場合は、右側の方法でテストします。初回の確認ではローカル接続だけを使い、トラブル対処のために「LANからの接続を許可」を有効にしないでください。
HTTPまたは混合待ち受け
- ローカルアドレス
127.0.0.1- ポートの例
10808。実際のHTTPまたは混合ポートに置き換えてください- プロキシアドレス
http://127.0.0.1:10808
接続先のURLがHTTPSでも、通常のローカルHTTPプロキシのアドレスはhttp://で始まります。
SOCKS待ち受け
- ローカルアドレス
127.0.0.1- ポートの例
10808。実際のSOCKSまたは混合ポートに置き換えてください- プロキシアドレス
socks5h://127.0.0.1:10808
これはcurlが認識する形式で、プロキシ側に接続先ホスト名を解決させます。システム設定のHTTPプロキシ欄には入力しないでください。
システムプロキシは一時的にオフ、TUNは無効のまま、明示的なプロキシ指定で通常のWebリクエストを送ります。Windows PowerShellではcurl.exeを使い、macOSのターミナルではコマンドの先頭をcurlに置き換えてください。接続タイムアウトは5秒、リクエスト全体の制限時間は15秒です。どちらも今回の診断用の上限であり、性能指標ではありません。
curl.exe --proxy http://127.0.0.1:10808 --noproxy "" --connect-timeout 5 --max-time 15 -I https://example.org/
- 接続が拒否される場合:クライアントが起動中か、ポート番号に誤りがないかを確認し、ログに待ち受けの失敗がないか調べます。
address already in useと表示された場合は、残っているクライアントのプロセスを終了するか、空いていると確認できたポートに変更してください。設定を反映したら、新しいポートで再テストします。 200 Connection establishedだけが表示される場合:これはプロキシからのCONNECT応答であり、接続先Webサイトの最終応答ではありません。続けて、接続先サイトのHTTPステータスが表示されるか確認してください。ハンドシェイクに失敗する、またはタイムアウトする場合は、同じリクエストのコアログでノード接続と証明書エラーを確認します。- 接続先から応答が返ってきた場合:今回のリクエストがローカルプロキシの入口を通ったことは分かりますが、リモートノードを経由したとは限りません。ルールによってテスト用ドメインが直接接続に振り分けられることがあります。ノードの外向き通信を確認するには、現在のルールでプロキシ経由になるドメインを選び、コアログで適用されたアウトバウンドを確認してください。
- 明示的なリクエストが成功してからシステムプロキシを有効にします:トレイまたはステータスメニューで「システムプロキシを自動設定」を選び、ブラウザーを開き直してテストします。Windowsでは「設定」→「ネットワークとインターネット」→「プロキシ」、macOSでは「システム設定」→「ネットワーク」→現在のネットワークサービスの「詳細」→「プロキシ」で確認できます。変更前の値を控えておき、テスト後はクライアントの「システムプロキシを解除」を使い、必要に応じて元の設定に戻してください。
初回設定でよくある問題
サブスクリプション更新がタイムアウトし、一覧が空のままですか?
まずログを確認し、サブスクリプションのドメイン名の名前解決、接続、サーバー応答のどこで失敗したかを調べます。URLの貼り付け間違いがないか、正しいグループを選んでいるかも確認してください。401または403が返る場合は、トークンとアクセス権についてサブスクリプション提供元に問い合わせます。接続タイムアウトで、接続できると確認済みのノードがすでにある場合は、「プロキシ経由」での更新を試してください。利用可能なノードがない状態でこの設定を何度切り替えても、接続が新たに確立するわけではありません。
Webページは開くのに、ターミナルは直接接続されるのはなぜですか?
ブラウザーはシステムプロキシを参照していても、ターミナルのプログラムが同じ設定を使うとは限りません。まずは上記の--proxyを指定し、1回のリクエストだけでプロキシ接続を試してください。成功した場合は、使用しているツールがHTTPS_PROXYに対応しているか、またNO_PROXYで接続先が除外されていないかを確認します。最初から環境変数を全体の起動設定に書き込まないでください。
再起動するとサブスクリプションや設定が消えるのはなぜですか?
ショートカットのリンク先が正しいプログラムのパスか確認し、別の展開先にあるコピーを誤って起動していないか調べます。クライアントを終了し、現在のバージョンを固定の書き込み可能な場所に置いてください。再度起動して、見分けやすい設定を1つ変更してから再起動し、保存されるか確認します。ログに書き込み失敗がある場合は、フォルダーの権限を修正するか、現在のユーザーが書き込める場所に移してください。
終了後にどのサイトも開けません。再インストールが必要ですか?
まず、システムプロキシがすでに終了した127.0.0.1の待ち受けポートを参照したままになっていないか確認します。クライアントを起動できる場合は「システムプロキシを解除」してから終了してください。起動できない場合は、システムのプロキシ設定を開き、今回のテストで追加した値を取り消します。職場のネットワーク設定がある場合は、事前に控えた値に戻し、ほかのプロキシ項目まで不用意に消さないでください。