v2rayN 初回インストールガイド：Windows・macOSの初期設定と注意点

インストールパッケージの選び方：デスクトップ版、WPF版、プロセッサアーキテクチャ

v2rayNはサーバー設定を管理し、プロキシコアを起動してシステムプロキシなどの機能を提供するデスクトップクライアントです。利用可能なサーバーは付属しません。使用を始める前に、有効なサブスクリプションURLまたはサーバー共有リンクを用意してください。メイン画面が開いただけでは、接続が確立したことにはなりません。

Windowsでは「設定」→「システム」→「システム情報」を開き、「システムの種類」を確認します。macOSではAppleメニューから「このMacについて」を開き、「チップ」または「プロセッサ」を確認します。Appleシリコン搭載MacはARM64、Intel搭載Macはx64を選びます。WindowsのARMデバイスでは、配布パッケージの説明も確認してください。ファイルの拡張子だけで実行可否を判断しないようにしましょう。

インストーラー、圧縮ファイル、ディスクイメージでは扱い方が異なります。配布形式をすべて「展開すればそのまま実行できる」と考えないでください。初回起動時は、ローカルポートの競合を防ぐため、異なるインターフェースの版を同時に起動しないようにしましょう。最新の説明はダウンロードページで確認してください。

Windowsで初めて起動する：フォルダー構成と実行環境

圧縮ファイルには、メインプログラムのほかにコアのフォルダーや依存ファイルが含まれている場合があります。メインプログラムだけをデスクトップに移すと、画面は開いてもコアが起動しないことがあります。圧縮ファイルを使う場合は、まず全体を解凍し、C:\Users\Public\Tools\v2rayNのような、現在のユーザーが書き込み可能な固定フォルダーに保存してください。フォルダーのアクセス権が用途に合っていることも確認します。

1. インストールパッケージを展開する

   圧縮ファイルの場合は、エクスプローラーで「すべて展開」を実行してから、展開先のフォルダーを開きます。インストーラーの場合は、セットアップウィザードの手順に従ってください。圧縮ソフトのプレビュー画面から直接起動しないでください。

2. 実行環境を準備する

   起動時に.NETがないというメッセージが表示されたら、必要なランタイムの種類、メジャーバージョン、アーキテクチャを確認し、Microsoft公式の配布元からインストールしてください。WPF版には対応する.NET Desktop Runtimeが必要です。SDKだけを入れたり、異なるアーキテクチャのランタイムを入れたりしても、解決しない場合があります。

3. 通常ユーザーとして初回起動

   メインプログラムを通常のユーザー権限で起動し、まず基本的なプロキシ接続を確認します。「管理者として実行」をあらゆるエラーに対する万能の解決策と考えないでください。TUNなど追加の権限が必要な機能は、基本接続が正常になってから個別に設定します。

4. 書き込み権限を確認する

   設定を開いて一度保存し、通常の方法で終了してから再起動します。言語などの設定が元に戻る場合は、設定の保存先に書き込み権限があるか、別の場所にあるプログラムを起動していないか確認してください。

macOSで初めて起動する：アプリの配置とセキュリティ警告

.dmgをダウンロードした場合は、ディスクイメージを開き、画面の案内に従ってアプリを「アプリケーション」フォルダーにドラッグします。圧縮ファイルの場合は、まず解凍してからアプリを固定の場所に移動してください。インストール後はディスクイメージを取り出し、「アプリケーション」から起動します。イメージ内の一時的なコピーを使い続けないようにしましょう。

• アーキテクチャが合わない：「このMacについて」でチップの情報を再確認し、ARM64またはx64のパッケージを選び直してください。起動に失敗しても、最初にシステムのセキュリティ設定を変更しないでください。
• 提供元を確認できないという警告：まずファイルの入手元を確認します。提供元が信頼できると確認できた場合に限り、「システム設定」→「プライバシーとセキュリティ」→「このまま開く」が表示されていれば、案内に従って許可してください。項目の場所はOSのバージョンによって異なる場合があります。
• アプリが破損しているという警告：権限の問題だけだと決めつけないでください。お使いのアーキテクチャに合った完全な配布パッケージを再入手し、リリースノートとOSの互換要件を確認します。他のアプリのセキュリティ属性をまとめて削除しないでください。
• プロキシの変更に許可が必要：システムプロキシを自分で変更するときに表示されるシステムの確認だけを許可してください。ウィンドウが正常に起動することと、システムプロキシの設定が書き込まれることは別です。後者については、現在使用中のネットワークサービスも確認する必要があります。

macOSのシステムプロキシは、ネットワークサービスごとに設定されます。Wi-Fiと有線ネットワークを切り替えた後は、「システム設定」→「ネットワーク」→現在のネットワークサービス→「詳細」→「プロキシ」で実際の状態を確認してください。以前のmacOSでは、「システム環境設定」→「ネットワーク」→「詳細」に項目がある場合があります。

初期設定：言語、サブスクリプション、接続先サーバー

インターフェースの言語はサーバープロトコルに影響しません。変更するには、「設定」→「パラメーター設定」から言語の項目を探し、保存して画面の案内に従って再起動します。配布版によっては設定メニュー内に言語の項目があります。この記事では中国語のメニュー名を記載していますが、操作時は現在の画面にある同等の項目を選んでください。

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

   「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、新しいグループを追加して、メモとサブスクリプションURLを入力します。URLの前後に空白がないこと、WebサイトのログインURLではなくサブスクリプションリンクをコピーしていることを確認してください。

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

   「サブスクリプショングループ」に戻り、該当する更新操作を実行します。利用可能なプロキシがまだない初回は、まずプロキシを経由せずに更新してください。利用可能な接続があり、直接の取得に失敗した場合に限り、プロキシ経由での更新を試します。

3. 追加結果を確認する

   一覧にサーバーが表示されていることを確認し、プロトコル、アドレス、ポートに値が入っているかを確認します。Webページやログイン画面が表示される場合は、何度も追加を繰り返さず、提供元にサブスクリプションURLとアクセス条件を確認してください。

4. 接続先サーバーに設定する

   接続するサーバーを右クリックし、「アクティブサーバーに設定」を選んでから、コアのログに正常な起動が記録されているか確認します。一覧の行を選択しただけでは、実際に使用するサーバーが切り替わらない場合があります。

vmess://またはvless://のリンクが1つだけある場合は、内容全体をコピーし、「サーバー」メニューにある「クリップボードからインポート」を選びます。共有リンクとサブスクリプションURLは用途が異なります。前者は通常1つのサーバーを追加し、後者はグループ単位で設定を取得・更新するために使います。

システムプロキシとルーティング：それぞれ初期設定する

システムプロキシは、OSのプロキシ設定に従うアプリをローカルの待ち受けに接続します。ルーティングルールは、接続された通信をプロキシ経由にするか、直接接続するか、遮断するかを決めます。2つの設定は互いに代用できません。初回の動作確認ではシステムプロキシを使い、TUNは無効のままにして、権限、仮想ネットワークアダプター、DNSの制御による影響を抑えます。

以下の10808は比較用のポート例で、すべてのバージョンで初期値として使われているとは限りません。まず「設定」→「パラメーター設定」で実際のローカル待ち受けの種類とポートを確認し、システム設定と照らし合わせてください。HTTPとSOCKSのポートが別々に表示される場合は、プロトコルごとに入力します。混合待ち受けの設定例をそのまま使わないでください。

Windowsでは「設定」→「ネットワークとインターネット」→「プロキシ」で設定の反映を確認できます。macOSでは、現在のネットワークサービスのプロキシ項目を確認してください。どの設定が有効なのか分からなくなるのを防ぐため、初回は手動プロキシ、自動構成スクリプト、別のプロキシアプリを同時に有効にしないでください。

• 通常の振り分け：v2rayNのルーティング選択から用途に合ったルールを選び、「設定」→「ルーティング設定」で具体的なルールを確認します。モード名だけではルールの内容は分かりません。
• 一時的な動作確認：ルールによって対象が直接接続されている疑いがある場合は、接続済みの通信をプロキシ経由にするルールへ一時的に切り替え、同じ対象をテストします。確認後は通常の振り分けに戻してください。
• ルールの適用範囲：グローバルプロキシのルーティングでも、コアに入った通信だけが処理されます。すべてのアプリが自動的にシステムプロキシに従うわけではありません。
• DNSの調整：まず現在の妥当な設定を維持してください。ログに名前解決の失敗や想定と異なる名前解決経路が示された場合に限り、実際に使っているコアのDNS設定を確認します。複数の設定を同時に変更しないようにしましょう。

接続確認：ポートが使えてもWebサイトが表示できるとは限らない

近い範囲から順にテストします。まずクライアントのメイン画面とコアが動作していることを確認し、次にローカルポート、最後にプロキシ経由のリクエストを確認します。以下のコマンドは、HTTPまたは混合ポートが10808であることを確認済みの場合の例です。実際のポートが異なる場合は、先に数字を置き換えてください。リクエスト先のアドレスはコマンドの使い方を示すための例です。

Windows：待ち受けを確認してからリクエストする

Test-NetConnection -ComputerName 127.0.0.1 -Port 10808
curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/

macOS：プロキシを明示してリクエストする

curl --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/

プロキシを明示することで、「ターミナルがシステムプロキシを読み取るか」という違いを避けられます。ただし、コアのルーティングルールの影響は受けます。Windowsでポートのテストに成功しても、ローカルのプロセスが接続を受け付けていることしか分かりません。HTTPリクエストに応答があっても、その対象が現在のルールで到達できるというだけで、すべてのWebサイトやアプリが正常とは限りません。

初回利用時によくある質問

初期設定後の確認事項

初期設定が完了したかどうかは、アイコンの色ではなく、アクティブサーバーが明確であること、コアの起動エラーがないこと、対象の通信が想定どおりにルーティングされること、正常終了後にローカルネットワークが復旧することで判断します。まずこの最小限の設定を保ち、必要に応じて自動起動、追加のルール、TUN機能を1つずつ設定しましょう。問題が起きたときに元に戻しやすくなります。

• 使用中のプログラムフォルダー、インターフェースの種類、実際の待ち受けポートを記録し、古いコピーを起動しないようにします。
• クライアントが提供する必要な設定をバックアップし、サブスクリプションURLや認証情報を含むバックアップは、アクセスを管理できる場所に保管します。
• アップデート前にプログラムとコアを正常に終了します。実行中にファイルを上書きしないでください。
• ルーティング設定を続ける場合はルーティングの使い方を、接続の問題が起きた場合はログやリクエストの状態に応じてトラブルシューティングをご覧ください。