v2rayN 初回インストールと初期設定ガイド：Windows/macOS 共通の要点とよくある落とし穴

インストール前にデスクトップ版を正しく選ぶ

v2rayN はデスクトップ向けのプロキシ管理クライアントで、ノードの保存、プロキシコアの呼び出し、システムプロキシの切り替え、ルーティングルールの適用を行います。ノードサービスそのものではありません。初回利用前に有効なサブスクリプションURLまたはノードの完全なパラメータを用意し、パソコンのOSと動作環境も確認してください。

Windows ユーザーには通常、WPF 版と Avalonia 版の2種類があります。WPF 版は Windows 本来の画面に近く、Windows 専用で使う場合に適しています。Avalonia 版は Windows、macOS、Linux に対応し、画面と機能の配置がより統一されています。macOS ユーザーは Avalonia 版を選び、Windows の実行ファイルをそのままコピーして起動しないでください。

ダウンロード後は、アーカイブを Windows なら D:\Apps\v2rayN のような固定フォルダーへ完全に解凍してください。アーカイブのプレビュー画面から直接起動し続けたり、頻繁に削除される一時フォルダーへ配置したりしないでください。設定、ログ、コアファイルには安定して読み書きできる場所が必要です。

初回起動：コア、ポート、ログの状態を確認する

メイン画面を開いても、すぐにノードの利用可否を判断しないでください。まずステータスバー、コアの種類、ローカルの待受ポートを確認します。コアが正常に起動していなければ、サブスクリプションのノードが表示されていても実際のプロキシ接続は確立できません。

バージョンや移行済みの設定によっては別のポートが使われるため、上記の番号は一般的な初期値にすぎません。実際のポートは「設定」→「パラメータ設定」にあるローカル待受設定を確認してください。ブラウザ、ダウンロードツール、開発ツールでプロキシを手動入力する場合も、ここに表示されるアドレスとポートを使う必要があります。

1. 完全解凍

   すべてのファイルを固定フォルダーへ解凍してからメインプログラムを起動します。フォルダーに書き込み権限があり、コア、設定、ログのサブフォルダーが保持されていることを確認してください。

2. コアを選択

   「設定」→「パラメータ設定」→「Core タイプ」を開き、VLESS、REALITY、または新しいトランスポート設定を日常的に使う場合は、まず Xray を選択してください。

3. ポートを確認

   パラメータ設定で SOCKS と HTTP の待受ポートを確認し、ほかのローカルプロキシソフトと同じポートを使っていないことを確認します。

4. ログを確認

   メイン画面に戻ってログ欄を開きます。正常時はコアの起動と待受成功を示す情報が表示され、同じエラー行が延々と繰り返されることはありません。

5. 保存して再起動

   コアや待受パラメータを変更したら設定を保存し、「サービスを再起動」を実行して新しいパラメータを反映させます。

コア不足は、起動直後に停止する、ログにコアファイルが見つからないと表示される、またはノードテストがすべて失敗するといった形で現れます。まず完全なデスクトップパッケージをダウンロードしたか確認してください。メインプログラムだけの簡易ファイルでは不十分です。次に「Core タイプ」が現在のフォルダーに実在するコアを指しているか確認します。コアを切り替えた後は必ずサービスを再起動してください。

サブスクリプションを取り込み、初回接続を完了する

サブスクリプションURLは、ノードとプロトコルパラメータをまとめて取得するために使います。VMess、VLESS、Trojan などの設定が含まれる場合があり、v2rayN では Xray コアと VLESS、REALITY、または VMess を組み合わせる構成がよく使われます。取り込み後、クライアントはサーバーから提供されたアドレス、ポート、ユーザー識別子、トランスポート方式、安全層のパラメータをローカル一覧へ保存します。

1. グループを追加

   「サブスクリプショングループ」→「サブスクリプショングループ設定」を開き、「追加」を選択します。識別しやすい名前を入力し、完全なサブスクリプションURLを貼り付けてください。

2. サブスクリプションを更新

   保存後、「サブスクリプショングループ」→「すべてのサブスクリプションを更新」に進み、ノード一覧が更新されるまで待ちます。初回更新時は短時間に連続してクリックしないでください。

3. 遅延をテスト

   ノードグループを1つ選び、実測の遅延テストを実行します。家庭用回線では40〜250ミリ秒程度が利用可能な結果としてよく見られます。タイムアウトは、その時点の測定が完了しなかったことを示すだけです。

4. アクティブに設定

   対象ノードをダブルクリックするか、右クリックメニューからアクティブサーバーに設定します。メイン画面のステータスバーに選択したノードが表示されていることを確認してください。

5. プロキシを起動

   適切なシステムプロキシモードを選び、ブラウザで通常のウェブページを開いて、ログに新しい接続記録が出るか確認します。

サブスクリプションの更新に成功したのに一覧が空の場合は、現在のサブスクリプショングループが有効になっているか確認し、システム時刻も確認してください。VLESS と VMess の認証や安全なハンドシェイクには正確なパラメータが必要で、トランスポート方式によっては時刻のずれにも敏感です。デスクトップの自動日時・時刻・タイムゾーン設定を有効にしてください。

システムプロキシ、ブラウザプロキシ、ルーティング

ノードがアクティブになったことは、v2rayN が送信設定を選択したことを示すだけです。ウェブページがプロキシを経由するかどうかは、システムプロキシとアプリ自身のネットワーク設定にも左右されます。遅延テストが成功したからといって、ブラウザが必ずローカルポートを自動使用するとは限りません。

初回接続では「システムプロキシ」→「システムプロキシを自動設定」を使うのがおすすめです。その後ブラウザのページを更新し、ログに対象ドメインと送信記録が出るか確認します。ログに新しい接続がまったくない場合、問題はリモートノードではなく、ブラウザからローカルプロキシまでの区間にある可能性が高いです。

ブラウザによってはシステムプロキシを読み込みますが、個別に設定したブラウザは独自のプロキシルールを使い続けることがあります。以前プロキシを手動設定したことがある場合は、アドレス、プロトコル、ポートを確認してください。SOCKS クライアントは通常 127.0.0.1:10808、HTTP プロキシは 127.0.0.1:10809 に接続しますが、最終的には v2rayN の現在のパラメータを優先します。

ローカル SOCKS の例
アドレス：127.0.0.1
ポート：10808

ローカル HTTP の例
アドレス：127.0.0.1
ポート：10809

ルーティングは、接続をプロキシ経由、直接接続、または遮断のどれにするかを決めます。インストール直後に複雑なルールを取り込むのは避け、まずクライアントの基本ルールで接続を確認してください。その後、実際の用途に合わせて調整します。ルールが上から順に適用される場合、範囲の広すぎる直接接続ルールが先に通信を処理し、後続のプロキシルールが機能しなくなることがあります。

• ログに direct と表示される：接続が直接接続の送信先へルーティングされています。ドメインルール、IP ルール、ルールの順序を確認してください。
• ログに proxy と表示されるがタイムアウトする：ローカルプロキシはリクエストを受信しています。ノード、経路、プロトコルパラメータを確認してください。
• ログにリクエストがない：ブラウザが現在のシステムプロキシを使っていないか、ローカルポートを誤って入力しています。
• 一部のウェブサイトだけ異常がある：DNS、ドメインの振り分け、ブラウザキャッシュを確認し、いきなりクライアントを再インストールしないでください。

コアの選び方と切り替えが必要な場面

v2rayN は管理画面であり、実際の接続は選択したコアが処理します。Xray と V2Ray の各コアは一般的なプロキシプロトコルに対応していますが、新しいトランスポート機能やパラメータの対応範囲は異なります。サブスクリプションからノードを取り込むと、通常は設定に応じて互換性のあるコアが選ばれます。手動で切り替える前に、ノードが使うプロトコルを確認してください。

ノードが VLESS + REALITY で、xtls-rprx-vision Flow を使用している場合は、この組み合わせに対応する Xray コアを選択してください。標準的な VMess + WebSocket + TLS であれば通常はどちらのコアでも処理できますが、サブスクリプションのパラメータとクライアントの判定結果を優先してください。

切り替え手順は「設定」→「パラメータ設定」→「Core タイプ」です。保存後に「サービスを再起動」を実行し、ログに表示されるコア名とバージョンを確認します。プルダウンだけ変更して再起動しない場合、既存プロセスが古いコアを使い続けることがあります。

スタートアップ、トレイ常駐、設定の保存

スタートアップには、v2rayN 本体を起動する動作と、起動後にプロキシコアまたはシステムプロキシを復元する動作という2つの要素があります。本体の自動起動だけを有効にしても、ログイン後にノードが自動選択され、プロキシ設定が書き込まれるとは限りません。初回設定後はパソコンを再起動し、完全に動作するか確認してください。

Windows でスタートアップが機能しない場合は、まずシステムのスタートアップアプリ一覧を開き、v2rayN が無効になっていないか確認します。次にプログラムフォルダーが移動されていないか確認してください。スタートアップ登録は通常、元のプログラムパスを参照しているため、フォルダーを移動した後は自動起動をいったん無効にして再度有効にする必要があります。

macOS では、システムのログイン項目で v2rayN の起動が許可されていることと、ネットワーク関連の権限が維持されていることを確認してください。プログラムが Dock やメニューバーに表示されるのにウェブページが直接接続される場合は、システムプロキシが復元されているか確認します。システムアップデートやネットワーク環境の変更後は、プロキシ設定を再適用する必要がある場合があります。

• 終了前に設定変更が保存されていることを確認し、コアプロセスを直接終了させないでください。
• プログラムフォルダーを移動した後は、スタートアップを再設定し、サブスクリプションデータが残っているか確認してください。
• クライアントを更新する前に現在の設定フォルダーをバックアップし、更新後はまずコアとポートを確認してください。
• トレイアイコン、コアプロセス、システムプロキシは別々の状態です。それぞれ個別に確認してください。

よくある落とし穴はこの順番で確認する

接続問題の切り分けでは、ノードを何度も切り替えるより、確認する順番を固定したほうが効果的です。サブスクリプションが更新されているか、システム時刻が正確か、コアが起動しているか、ローカルポートが待受中か、システムプロキシが有効かを順に確認し、最後にプロトコルパラメータと経路の状態を確認してください。

ログを使えば問題を3つの区間に分けて確認できます。ブラウザからローカルポート、ローカルコアからノード、ノードから対象サイトまでです。最初の区間に記録がなければシステムプロキシを確認します。2つ目でハンドシェイクに失敗するなら、時刻、コア、プロトコルパラメータを確認します。3つ目でタイムアウトが続くなら、ノードの品質と時間帯による経路状況を確認してください。

初期設定が完了したら、動作確認済みの基本設定を1つ残しておくことをおすすめします。コア、ポート、DNS、ルーティングルールを同時に変更せず、毎回1つの変数だけを変えて、ログとウェブアクセスの結果から影響を判断してください。原因を見つけやすくなります。