WindowsまたはmacOSでv2rayNを初めて使う方向けです。まずインストーラーとコアが動作することを確認し、ノードとローカルプロキシポートを検証してから、システムプロキシとログイン時の自動起動を設定します。各手順を個別に確認すれば、アプリが起動していないのか、ポートが待ち受けていないのか、アプリがプロキシを使っていないのかを切り分けられます。
初回起動の手順:パッケージ選択、ノード有効化、プロキシ確認
ここではデスクトップ版v2rayN 7.xを例に説明します。マイナーバージョンやビルドによってメニューの配置は異なる場合があり、特にWindowsのタスクトレイメニューとmacOSの画面では入口が異なります。初回起動時は、ほかのプロキシクライアントを終了し、TUNは有効にせず、LAN接続も有効にする必要はありません。
アーキテクチャを確認する
Windowsでは「設定」→「システム」→「バージョン情報」でシステムの種類を確認し、x64とARM64を判別します。macOSではAppleメニュー→「このMacについて」でチップまたはプロセッサを確認します。AppleシリコンはARM64、Intelプロセッサはx64です。クライアントと同梱コアは同じアーキテクチャを選んでください。
パッケージを展開する
Windowsのポータブル版は、圧縮ファイルを固定のフォルダーにすべて展開してから、フォルダー内の
v2rayN.exeを起動します。実行ファイルだけを圧縮ファイルから取り出すと、必要なファイルが不足します。macOSでは圧縮ファイルを展開し、v2rayN.appをアプリケーションフォルダーへ丸ごと移動してから、そこから開いてください。テスト用ノードを追加する
共有リンクが1件ある場合はコピーし、メイン画面の「サーバー」メニューからクリップボードの内容をインポートします。サブスクリプションURLだけがある場合は、「サブスクリプショングループ」→「サブスクリプショングループ設定」でグループを追加し、更新してください。リストに項目が表示されたら1つ選び、使用サーバーに設定します。
待ち受けポートを確認する
「設定」→「パラメーター設定」を開いてローカル待ち受けポートを確認し、メイン画面のログでコアが正常に起動したか確認します。実際のポート番号と、HTTP・SOCKS・混合プロキシのどれを受け付けるかを控えてください。ノード編集画面に表示されるリモートポートと取り違えないようにします。
システムプロキシを設定する
クライアントのシステムプロキシメニューから「システムプロキシを自動設定」を選びます。Windowsではタスクトレイアイコンの右クリックメニューから操作できます。その後、システムプロキシを使用するブラウザーでWebページを開いて確認します。ブラウザーに別のプロキシ拡張機能や個別設定がある場合は、先にそれらの影響を除外してください。
アプリとコアの場所:権限・パス・アーキテクチャを切り分ける
メイン画面が開いても、確認できるのはv2rayNの画面が起動したことだけです。接続を処理するのはコアのプロセスです。項目をインポートした後も、選択中のノードで使うコアが見つかり、実行できることを確認してください。まず起動ログを確認し、その後でパッケージの変更やコアの更新を検討します。
OSごとにアプリの配置を確認する
Windows:フォルダー一式を保持する
- ポータブル版は、現在のユーザーが書き込み可能な固定フォルダーに置けます。圧縮ファイルのプレビュー画面からプログラムをダブルクリックしたり、
v2rayN.exeだけをコピーしたりしないでください。 - 一般的な7.xのフォルダー構成では、コアはプログラムフォルダー内の
binに配置されます。たとえばbin\xray\xray.exeです。ファイルが見つからない場合は、コア同梱パッケージをダウンロードしたか確認するか、クライアントのコア更新機能から追加してください。 - 実行時コンポーネントの不足と書き込み権限エラーは別の問題です。前者は表示された案内に従って必要なランタイムとアーキテクチャを確認します。後者はプログラムやデータの保存先に書き込めるかを確認し、「管理者として実行」を常用の対処にしないでください。
macOS:アプリのパッケージ構造を維持する
v2rayN.app内の実行ファイルだけを移動したり、名前を変更したりしないでください。コアの実際のパスは使用中の配布パッケージと起動ログで確認し、Windowsのフォルダー構成を当てはめないようにします。- ログに
bad CPU type in executableと表示された場合は、エラーの対象がクライアントかコアかを確認してから、端末のアーキテクチャに合ったパッケージに切り替えます。サブスクリプションを何度読み込んでも、実行ファイルのアーキテクチャは変わりません。 - システムに起動をブロックされた場合は、まず具体的な警告を読み、ダウンロード元と組織の端末管理ルールを確認してください。アプリを1つ起動するために、システム保護を無効にしないでください。
移動やアップグレードの前に旧バージョンを終了し、使用中の設定フォルダーをバックアップします。配置先を変更したら、新しいパスから一度手動で起動し、既存のショートカットと自動起動の設定を確認してください。
バックアップではメインプログラムだけを残すのではなく、ログを設定のバックアップとして扱わないでください。サブスクリプションURLにはアクセストークンが含まれる場合があり、ノード情報に接続認証情報が含まれることもあります。エラー情報を共有する際は、エラーの種類と必要なパスだけを残し、サブスクリプションURL、ノードの認証情報、パスに含まれる不要なアカウント名を削除してください。
コアの選択:使用中ノードのプロトコル設定に合わせる
サブスクリプションは複数の項目を取得するための入口で、個々の項目を解釈して実行するのはコアです。サブスクリプションの更新に成功しても、すべての設定が選択したコアに対応しているとは限りません。「設定」→「パラメーター設定」で、該当プロトコルのコア種別を確認してください。ノード編集画面に個別のコア設定がある場合は、その項目も確認します。
項目に対応するコアを使う
おすすめインポート後に確認したプロトコルとトランスポートの設定を維持してください。たとえば項目がVLESS + REALITYと明記されている場合は、その組み合わせに対応するXrayコアを使用します。接続失敗をすぐにコアのせいにしたり、接続を試すためにREALITYをTLSへ変更したりしないでください。
適したケース:初回設定で、サーバー側の設定が明確に示されている
単一の設定で別のコアを検証する
管理者から特定のVMess設定がV2RayとXrayの両方に対応すると明示されている場合は、既知の設定を保ったまま、その項目だけコアを切り替えて起動ログを比較できます。プロトコル名を認識できても、その項目のトランスポートやセキュリティ設定まで認識できるとは限りません。
適したケース:再現可能な問題があり、コアの互換性の違いを切り分けたい
ローカルポートとシステムプロキシ:待ち受けと接続設定を別々に確認する
ローカル待ち受けポートは同じコンピューター上のアプリが接続するためのものです。リモートポートはコアがサーバーへ接続するためのもので、両者は異なる場合があります。システムプロキシを有効にすると、システム設定に従うアプリがローカルの接続先を見つけられるようになりますが、コアのリモート接続が修復されるわけではなく、すべてのアプリの通信がその接続先を通るわけでもありません。
- ログにポート使用中と表示される:まず、別のプロキシクライアントや旧バージョンのv2rayNを終了します。使用中のプロセスを終了できない場合は、v2rayNに空いているポートを割り当て、コアを再起動してからシステムプロキシを設定し直します。アプリに手動入力した古いポートも更新してください。
- ポートは待ち受けているのにブラウザーで失敗する:Windowsでは「設定」→「ネットワークとインターネット」→「プロキシ」、macOSでは「システム設定」→「ネットワーク」→現在のネットワークサービスの「詳細」→「プロキシ」を確認します。ここではシステムに実際に設定されている内容を確認すればよく、別途手動で設定する必要はありません。アプリがHTTPプロキシを求める場合、SOCKS専用ポートは指定できません。
- 終了後にWebページを開けない:システムプロキシが、すでに待ち受けを停止したローカルポートを指していないか確認します。終了前にクライアントの「システムプロキシを解除」を選べます。組織や学校から指定されたプロキシを使っていた場合は、すべてを無効にするのではなく、元の設定に戻してください。
ログイン時の自動起動:起動経路とプロキシ状態を確認する
まず手動起動でWebページを閲覧できることを確認してから、ログイン時の自動起動を設定します。デスクトップアプリの自動起動は通常、ユーザーのログイン後に実行されます。端末の電源を入れてからログインするまでの間にプロキシが使えるという意味ではありません。また、自動起動で確認できるのはプログラムの起動だけで、コアが起動したことやシステムプロキシが必要なモードに戻ったことまでは保証されません。
- Windowsでは、まず「設定」→「パラメーター設定」に「起動時に自動起動」オプションがあるか確認します。使用中のビルドに該当する設定がない場合は、Win + R で
shell:startupを開き、現在のプログラムの場所を指すショートカットを配置する方法もあります。二重起動を避けるため、どちらか一方を使ってください。 - macOSでは「システム設定」→「一般」→「ログイン項目と機能拡張」で、「アプリケーション」フォルダーにあるv2rayNをログイン時に開く項目へ追加できます。バージョンによっては、この画面が「ログイン項目」と表示されます。アプリを移動した場合は、一覧が新しい場所を指しているか確認してください。
- ログアウトして再度ログインし、クライアントが一度だけ起動すること、使用中のノードが想定どおりであること、ローカル待ち受けポートとシステムプロキシ設定が一致していることを確認します。起動時にネットワークがまだ利用できない場合は、接続が回復してから再テストし、自動起動の失敗なのか接続確立が遅れているのかを判断してください。