v2rayNの初回インストール設定ガイド|Windows・macOSの注意点とよくある失敗

展開先や実行環境、初回起動時の権限から、ローカルポートとコアの選び方まで解説。Windows・macOSでv2rayNを初めて使う際の設定ミスをまとめました。

この記事の要点

WindowsまたはmacOSで初めてv2rayNを使うときは、次の3点を順に確認します。メイン画面が開くこと、選択したノードからローカルプロキシ経由でリクエストを送れること、ブラウザーがシステムプロキシ設定を使えることです。前の段階を確認してから次へ進めば、起動時のクラッシュ、空のサブスクリプション、ブラウザーの接続不良が起きても、どの層を調べればよいか判断しやすくなります。

インストールパッケージ、展開先、初回起動時の権限

デスクトップアプリとプロキシコアは別のものです。ダブルクリックしてもメイン画面が表示されない場合は、まずパッケージ、実行環境、システムの警告を確認します。画面は開くものの、ノード選択後にログでエラーが出る場合は、コアファイル、ノード設定、ポートを確認してください。以下では、v2rayN 7.xの中国語版でよく使われるメニュー名を例にしています。マイナーバージョンによって項目名やボタンの位置が異なることがあります。

サブスクリプションを追加して、まずノードを1つ確認

サブスクリプションURLを登録しただけでは、ノードの取得が成功したとは限りません。初回設定では、参照元を1つ、ノードを1つに絞り、サブスクリプションの更新、コアの起動、システムプロキシを個別に確認します。URLにアカウントトークンが含まれることがあるため、スクリーンショットを共有する前にURL全体を隠し、ログに出力されていないかも確認してください。

  1. サブスクリプショングループを追加する

    メイン画面で「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、ウィンドウ内の「追加」をクリックします。見分けやすい名前を入力し、任意のURL欄にサブスクリプションURL全体を貼り付けて保存してください。vmess://またはvless://で始まる単一の共有リンクを受け取った場合は、「サーバー」メニューからクリップボードのインポート機能を使います。サブスクリプションURL欄には入力しないでください。

  2. 現在のグループを更新する

    メイン画面に戻り、新しいグループを選択します。「サブスクリプショングループ」メニューから現在のサブスクリプションを更新し、初回はプロキシを使わない更新方法を試してください。ログで取得結果を確認し、グループ内にノードが表示されるかを見ます。更新に成功したことは一覧を取得できたという意味であり、ノードの接続成功を示すものではありません。

  3. 使用するノードを選択する

    一覧で利用可能と確認済みのノードを右クリックし、「アクティブサーバーに設定」を選びます。行をクリックしただけでは一覧項目を選択したにすぎず、コアが切り替わったとは判断できません。切り替え後はメイン画面の現在のノードとログを確認し、コアの起動失敗やポートのバインドエラーがないかを見てください。

  4. ローカルポートを確認する

    「設定」→「パラメーター設定」を開き、「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/

初回設定でよくある問題

サブスクリプション更新がタイムアウトし、一覧が空のままですか?

まずログを確認し、サブスクリプションのドメイン名の名前解決、接続、サーバー応答のどこで失敗したかを調べます。URLの貼り付け間違いがないか、正しいグループを選んでいるかも確認してください。401または403が返る場合は、トークンとアクセス権についてサブスクリプション提供元に問い合わせます。接続タイムアウトで、接続できると確認済みのノードがすでにある場合は、「プロキシ経由」での更新を試してください。利用可能なノードがない状態でこの設定を何度切り替えても、接続が新たに確立するわけではありません。

Webページは開くのに、ターミナルは直接接続されるのはなぜですか?

ブラウザーはシステムプロキシを参照していても、ターミナルのプログラムが同じ設定を使うとは限りません。まずは上記の--proxyを指定し、1回のリクエストだけでプロキシ接続を試してください。成功した場合は、使用しているツールがHTTPS_PROXYに対応しているか、またNO_PROXYで接続先が除外されていないかを確認します。最初から環境変数を全体の起動設定に書き込まないでください。

再起動するとサブスクリプションや設定が消えるのはなぜですか?

ショートカットのリンク先が正しいプログラムのパスか確認し、別の展開先にあるコピーを誤って起動していないか調べます。クライアントを終了し、現在のバージョンを固定の書き込み可能な場所に置いてください。再度起動して、見分けやすい設定を1つ変更してから再起動し、保存されるか確認します。ログに書き込み失敗がある場合は、フォルダーの権限を修正するか、現在のユーザーが書き込める場所に移してください。

終了後にどのサイトも開けません。再インストールが必要ですか?

まず、システムプロキシがすでに終了した127.0.0.1の待ち受けポートを参照したままになっていないか確認します。クライアントを起動できる場合は「システムプロキシを解除」してから終了してください。起動できない場合は、システムのプロキシ設定を開き、今回のテストで追加した値を取り消します。職場のネットワーク設定がある場合は、事前に控えた値に戻し、ほかのプロキシ項目まで不用意に消さないでください。

v2rayNをダウンロード