WindowsまたはmacOSでv2rayNを初めて使う場合は、まず適切なインストーラーを選び、設定が保存できることを確認します。次に、信頼できる提供元からノードまたはサブスクリプションを1つだけ追加し、システムプロキシを有効にしてブラウザーで動作を確認します。問題が起きたら「アプリが起動するか」「コアが待ち受けているか」「アプリの通信がプロキシ経由か」の順で確認し、一度に変更する設定は1つに絞りましょう。
インストーラーの選び方:CPUと実行環境を確認
v2rayNは設定を管理するデスクトップクライアントです。実際の接続は、Xrayなど起動したコアが処理します。ウィンドウが開いても、起動したのはクライアントだけです。必要なコアが同梱されていない場合や、システムによってコアの実行がブロックされた場合は、ノードを選んでも接続できないことがあります。
Windows・macOSのインストール前チェック
Windows
- 「設定」→「システム」→「バージョン情報」で「システムの種類」を確認し、x64またはARM64に対応するパッケージを選びます。
- 圧縮ファイルを使う場合は、まずユーザーが書き込み可能な固定フォルダー(例:
%LOCALAPPDATA%\v2rayN)にすべて展開し、その後でv2rayN.exeを実行します。実行ファイルだけをデスクトップに移動したり、圧縮ファイルのプレビューから起動したりしないでください。 - 起動時に.NETが見つからないというメッセージが表示されたら、案内とパッケージの説明に従い、対応するメジャーバージョンとアーキテクチャのランタイムをインストールします。WPF版で
Microsoft.WindowsDesktop.Appが必要と明記されている場合は、通常の.NET Runtimeではなく.NET Desktop Runtimeをインストールしてください。
macOS
- Appleメニューから「このMacについて」を開きます。Appleチップ搭載と表示される場合はARM64、Intelプロセッサと表示される場合はx64を選びます。
- 配布形式に応じてアーカイブを展開するかディスクイメージを開き、
v2rayN.appを「アプリケーション」フォルダーに移してから起動します。マウントしたディスクイメージから常用しないでください。 - システムによって起動がブロックされた場合は、まず表示されたメッセージを確認し、配布元とアーキテクチャを確かめます。配布元が信頼でき、今回の起動だけを許可する選択肢がシステムに用意されている場合に限り、「システム設定」→「プライバシーとセキュリティ」で許可してください。セキュリティチェック全体を無効にする必要はありません。
まずは通常の権限で起動してください。具体的なランタイムエラーや書き込みエラーが発生した場合に、メッセージに従って対処します。管理者権限での実行を常用しないでください。
初期設定:ノードを追加してブラウザーで確認
ノードはサーバーへの接続設定、サブスクリプションはリンクからノード一覧をまとめて取得する仕組みです。初回は接続元を1つだけ追加すると、サブスクリプションを取得できていないのか、個々のノードが使えないのかを切り分けやすくなります。以下ではv2rayN 7.xの中国語UIでよく使われるメニューを例に説明します。ビルドによってボタンの表記が異なる場合があります。
設定が保存されるか確認
「設定」→「パラメータ設定」を開き、画面が表示されることを確認します。ノードを追加した後、正常に終了して再起動し、グループが残っているか確認してください。毎回空に戻る場合は、プログラムを一時フォルダーから実行していないか、ログに設定の書き込みエラーがないかを確認します。
接続元を1つ追加
サブスクリプションのリンクを入手した場合は、「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、グループを追加します。識別しやすい名前とサブスクリプションURLを入力して保存してください。メイン画面に戻り、そのグループを選んでから「サブスクリプショングループ」→「現在のサブスクリプションを更新(プロキシを使用しない)」を試します。ノードのリンクを1つだけ入手した場合は、そのリンクをコピーし、「サーバー」→「クリップボードから共有リンクをインポート」で追加します。ノードのリンクをサブスクリプションURL欄に入力しないでください。
ノードを有効にしてログを確認
一覧のノードを右クリックし、「アクティブサーバーに設定」を選びます。ビルドによってはダブルクリックでも切り替えられます。メイン画面のログ欄を確認し、まずコアの起動や待ち受けに失敗していないことを確かめてください。一覧にノードが表示されていても、設定がインポートされたことを示すだけで、接続先が利用できるとは限りません。
システムプロキシを有効化
クライアントのメニューから「システムプロキシ」を開き、「システムプロキシを自動設定」を選びます。システムプロキシは、対応するアプリにOSが提供するプロキシ設定であり、すべてのプログラムの通信を引き受けるものではありません。最初の動作確認ではTUN(仮想ネットワークアダプターによる通信の取り込み)を有効にせず、既存のルーティングルールも変更しないでください。通信の入口と振り分け方法を同時に変えるのを避けられます。
Webページとログを照合
システムプロキシに従うブラウザーで新しいページを開き、普段アクセスできるHTTPSサイトに接続しながら、同じ時刻のコアログを確認します。ページが表示されても、そのリクエストが必ずリモートプロキシ経由とは限りません。ルーティングはルールに従って通信を直接接続するかプロキシに渡すかを決めます。ログに直接接続と表示されている場合、確認できたのはその直接接続経路が使えることだけです。
ローカルポートの競合:待ち受けを確認してから設定を変更
ローカルの待ち受けポートは、アプリがこの端末上のプロキシに接続するための入口です。サブスクリプションに記載されたサーバー側のポートとは異なります。v2rayNでよく使われるローカルの初期ポートは10808ですが、「設定」→「パラメータ設定」のローカル待ち受け設定と起動ログを基準にしてください。ポートの競合を優先して調べるのは、ログにバインド失敗やアドレス使用中などのメッセージがある場合です。
ポートを使用中のプロセスを確認
WindowsではPowerShellを開き、待ち受けの記録にあるプロセスIDOwningProcessを調べます。次にタスクマネージャーの「詳細」タブでPIDを照合してください。
Get-NetTCPConnection -LocalPort 10808 -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess
macOSでは「ターミナル」を開き、出力にあるCOMMANDとPIDを確認します。この端末で10808以外のポートを設定している場合は、まずコマンド内の数字をログに表示されたエラー対象のポートに置き換えてください。
lsof -nP -iTCP:10808 -sTCP:LISTEN
- 起動中の別のv2rayNが原因なら、メニューから古い方を正常に終了して再試行します。Xrayのプロセスが見つかっても、必ずしも競合ではありません。現在のインスタンスに属し、ログにエラーがなければ、待ち受けは正常な動作です。
- ポートを他の必要なソフトウェアが使用している場合は、見覚えのないプロセスを終了しないでください。代替ポートが使用可能であることを確認してから、「設定」→「パラメータ設定」でローカルの待ち受けポートを変更します。コアを再起動し、システムプロキシを設定し直してください。プロキシアドレスを手動設定したアプリも、ポートの更新が必要です。
- この端末だけで使う場合はループバック待ち受けのままにし、競合解消のために「LANからの接続を許可」を有効にしないでください。ポートを変えても、リモート側の認証エラーや無効なサブスクリプションURLは解決しません。
よくあるトラブル:症状から原因の層を特定
アプリを開くと一瞬表示されて消える。まず何を確認する?
まずアーキテクチャと展開先をもう一度確認します。Windowsでウィンドウが表示されない場合は、「イベント ビューアー」→「Windowsログ」→「Application」を開き、起動した時刻のアプリケーションエラーや.NET Runtimeの記録を探して、不足している項目に対処します。macOSで開けない場合は、システムのセキュリティ警告なのか、パッケージの破損やアーキテクチャの不一致なのかを切り分けます。後者の場合は、権限を上げるのではなく、対応するパッケージを入手し直してください。
サブスクリプションを保存したのに、一覧が空なのはなぜ?
まず選択中のグループを確認し、URLに余分な空白や改行がないことを確かめてから、現在のグループを手動で更新します。ログに401または403が表示される場合は、サブスクリプション提供元にリンクが有効か確認してください。タイムアウトが発生し、すでに利用可能な接続がある場合は、「現在のサブスクリプションを更新(プロキシを使用)」を試します。使える接続がない状態でこの設定を繰り返し切り替えても、ローカルプロキシで接続できるようにはなりません。
ノードの遅延は測定できるのに、ブラウザーで開けないのはなぜ?
ノードを選択しただけではなく、「システムプロキシを自動設定」が選ばれているか確認します。Windowsでは「設定」→「ネットワークとインターネット」→「プロキシ」、macOSでは「システム設定」→「ネットワーク」→現在のネットワークサービスの「詳細」→「プロキシ」を確認してください。ブラウザーや拡張機能で別のプロキシを設定している場合は、システム設定に従うブラウザーで動作を比較します。遅延テストの成功が示すのは、そのテストリクエストが完了したことだけで、Webページに必要なすべての接続が正常とは限りません。
v2rayNを終了したら、かえってWebページが開けなくなった
もともと会社のプロキシや手動設定のプロキシを使っていない場合は、v2rayNを再度起動し、「システムプロキシ」から「システムプロキシをクリア」を選んでから正常に終了します。会社のプロキシや自動設定スクリプトを使っている場合は、元の設定を確認して復元してください。すべての設定を一律に消さないでください。特にアプリが異常終了した後は、待ち受けを停止したローカルポートに通信が送られ続けていないか確認します。
初期設定後は、元に戻せる状態を保つ
まず一連のプロキシ切り替えを確認してから、スタートアップや複雑なルーティングを検討してください。正常に終了してから再起動し、グループが残っていることを確認します。プロキシが必要なときはブラウザーとログを確認し、使わないときは元のネットワーク設定に戻せることを確かめてください。次回のアップデートやパッケージ変更で問題が起きても、動作確認済みの設定と比較できます。
- クライアントのバージョン、パッケージのアーキテクチャ、実際のローカル待ち受けポートを控えておきましょう。問い合わせの際は、エラーメッセージの全文と発生時刻を添えると、「接続できない」だけの場合より原因を特定しやすくなります。
- スクリーンショットやログを共有する前に、サブスクリプションURL全体、アクセストークン、ノードの認証情報を隠してください。サブスクリプションURLは一般的なWebページのURLとは限りません。
- 動作が安定してから、自動起動やカスタムルーティングを1つずつ有効にします。変更直後に問題が起きたら、最後に追加した設定を戻してください。コア、ノード、ポートを同時に変更しないようにします。