v2rayN 7.xを初めて使う場合は、まずOSとCPUアーキテクチャに合ったパッケージを選び、設定をインポートしてノードを1つ有効にし、ローカルプロキシを確認します。WindowsとmacOSではインストール方法や権限の設定場所が異なりますが、接続の確認手順は共通です。アプリがプロキシ経由で通信できることを確かめてからログイン時の自動起動を設定しましょう。問題が起きたら、インストール、サブスクリプション、コア、アプリの各段階を順に確認すれば、すぐに再インストールする必要はありません。
パッケージ選びと初回起動:OSとアーキテクチャを確認
メインウィンドウが開いても、クライアントの画面が起動しただけで、通信を処理するコアが動作しているとは限りません。ダウンロード時はOSとアーキテクチャに加え、コアが含まれているかも確認しましょう。初めて設定する場合は、必要なコアを含むと明記されたパッケージを選ぶと、ノードを追加した後で実行ファイルが見つからない事態を避けられます。
Windowsのパッケージ選び
- アーキテクチャを確認
- 「設定」→「システム」→「バージョン情報」→「システムの種類」
- パッケージの表記
- x64ベースのプロセッサならx64、ARM端末ならOSに合ったarm64パッケージを選びます
- 圧縮ファイル
- 完全に展開し、現在のアカウントで書き込み可能で、後から移動しない場所に保存します
- 初回起動
- 圧縮ファイル版は展開先から
v2rayN.exeを実行します。インストーラー版は画面の指示に従ってインストールします
圧縮ソフトのプレビュー画面からメインプログラムを直接起動しないでください。隣接するコアのファイルが一緒に展開されない場合があります。
macOSのパッケージ選び
- アーキテクチャを確認
- Appleメニュー→「このMacについて」で「チップ」または「プロセッサ」を確認します
- パッケージの表記
- Appleシリコン搭載Macはarm64、Intelプロセッサ搭載Macはx64を選びます
- アプリの保存先
- パッケージの説明に従って展開するかディスクイメージを開き、アプリを「アプリケーション」に移動します
- 初回起動
- 「アプリケーション」から起動します。ディスクイメージを常用の実行場所にしないでください
インストール後、まず手動で一度起動してください。ログイン項目にアプリを登録する際、パスが一時的なマウント先を指すのを防げます。
- Windowsでランタイム不足と表示される場合:エラーに記載されたランタイム名とメジャーバージョンを確認し、配布パッケージの説明と照らし合わせてください。システムランタイムに依存するパッケージを使っている場合は、案内に従って対応するアーキテクチャの .NET デスクトップ ランタイムをインストールします。管理者権限を付与しても、ランタイム不足は解消しません。
- macOSで開発元を検証できないと表示される場合:まずパッケージの入手元とアーキテクチャを確認してください。開発元の検証に関する警告が表示され、アプリの安全性を確認できている場合は、一度起動を試した後、「システム設定」→「プライバシーとセキュリティ」に「このまま開く」が表示されるか確認します。アプリがコンピュータに損害を与える可能性があるとシステムが警告した場合は起動を続けず、システム全体のセキュリティ機能も無効にしないでください。
サブスクリプションの追加:保存・更新・有効化の3ステップ
サブスクリプションURLは複数のノードを取得するためのものです。URLを保存しただけでは接続できません。ここではv2rayN 7.xの中国語UIを例に、メニューの機能に沿って手順を説明します。マイナーバージョンによってメニューの表記が少し異なる場合があります。vmess:// または vless:// で始まる単一ノードの共有リンクを受け取った場合は、サブスクリプションURL欄ではなく、クリップボードからサーバーをインポートする機能を使ってください。
サブスクリプショングループを作成
「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、項目を追加します。識別しやすい名前とサブスクリプションURL全体を入力して保存し、メイン画面に戻ります。URLにアクセストークンが含まれる場合があるため、公開するスクリーンショットやログに載せないでください。
サブスクリプション一覧を更新
作成したグループを選び、「サブスクリプショングループ」メニューから「現在のサブスクリプションを更新(プロキシを使用しない)」を実行します。初回インストール時はまだ使えるノードがないため、プロキシ経由での更新は選ばないでください。更新後は、グループ名が作成されたかだけでなく、ノードがグループ内に表示されていることを確認します。
ノードを有効化
一覧から利用可能と確認できたノードを選び、右クリックして「アクティブサーバーに設定」を実行します。行をクリックしただけでは選択状態になるだけで、接続先は切り替わりません。切り替え後、メイン画面のアクティブ項目とログを確認し、コアがすぐに終了していないことを確かめてください。
アプリの接続を確認
まずローカルプロキシのポートを確認し、次に通知領域またはメニューバーのアイコンから「システムプロキシ」→「システムプロキシを自動設定」を選びます。ブラウザー側でシステム設定を上書きする個別プロキシルールを無効にし、アクセスできることが分かっているHTTPSページを開いて、正常に読み込めるか確認します。
コアの選択:まず現在の設定を確認してからマッピングを変更
ノードにはプロトコル、接続先アドレス、トランスポートなどの接続パラメーターが保存され、コアがそれらを使って通信します。「設定」→「パラメーター設定」→「Coreタイプ」(バージョンによっては「Coreタイプ設定」)を開くと、内蔵ノードのプロトコルに割り当てられたコアを確認できます。この設定でVMessノードをVLESSに変更することはできません。また、設定一式を含むカスタムノードには、ここで説明する一般的な判断をそのまま当てはめないでください。
ノードの現在のコア設定を維持
おすすめまずは現在のプロトコルとコアの対応設定を維持し、ノードを有効にしてログを確認しましょう。サーバー側の設定がVLESS + REALITYで、使用中のXrayが設定を正しく読み込めているなら、検証のためにコア、トランスポート、安全性の設定を同時に変える必要はありません。
向いているケース:初回インストール、標準的なサブスクリプションをインポート済み
サーバーの要件に合わせてコアを変更
サーバー側から互換性に関する指定がある場合、または現在のコアが設定項目を認識できないとログに記録されている場合に限り、その組み合わせに対応するインストール済みコアを選びます。保存後、同じノードを再度有効にして、変更前後のログを比較してください。サーバーも同時に変更すると、どの変更が有効だったか判断できません。
向いているケース:既知の設定への移行、設定項目の互換性に関する明確な問題の調査
ログにコアファイルが見つからないと表示された場合は、まずパッケージの内容とプラットフォームのアーキテクチャを確認してください。コアは起動しているのに接続ログにTLSまたは認証エラーが出る場合は、サブスクリプションに記載されたアドレス、サーバー名、認証パラメーターが同じ設定一式のものか確認します。設定の不一致を隠すために証明書の検証を無効にしないでください。
ローカル待ち受けとシステムプロキシを個別に確認
「設定」→「パラメーター設定」でローカルの待ち受けポートを確認します。ここでは混合インバウンドポート 10808 を例に、HTTPプロキシとして接続をテストします。SOCKSとHTTPのポートが別々に表示される場合は、コマンドのポートをHTTPインバウンドのものに置き換えてください。コマンドからローカルプロキシに直接接続するため、システムプロキシは一時的に無効のままで構いません。
curl -I --max-time 10 --proxy http://127.0.0.1:10808 https://example.com/
Windows PowerShellでは、先頭の curl を curl.exe に置き換えてください。コマンドの待ち時間は最大10秒です。判定時は、プロキシがトンネルを確立した際に表示されることがある 200 Connection established だけでなく、接続先サイトが最終的に返すHTTPステータス行を確認します。このコマンドはアプリから指定先までの経路確認用であり、速度テストではありません。
| 表示された状態 | 次に確認する項目 |
|---|---|
127.0.0.1:10808 への接続が拒否される | コアが動作中か、ポートとインバウンドの種類が正しいかを確認し、ログに待ち受け失敗やポート使用中のメッセージがないか調べます。 |
| トンネル確立のメッセージが表示された後、タイムアウトまたはTLSエラーになる | ローカルポートはリクエストを受け付けています。コアのログを確認し、現在のアウトバウンド、サーバーへの到達性、TLSパラメーターを調べてください。まずブラウザーの設定を変更する必要はありません。 |
| コマンドでは接続先サイトの応答があるのに、ブラウザーでは開けない | ブラウザーがシステムプロキシを使用しているか、拡張機能やアプリ内プロキシが設定を上書きしていないか確認します。ブラウザーを再起動し、同じアドレスでもう一度試してください。 |
システムプロキシは、システム設定に従うアプリの接続先をローカルの待ち受けに向けます。ルーティングルールは、コアに届いた接続をプロキシ経由で外部に送るか、直接接続するかを決めます。コマンドが成功した場合に分かるのは、リクエストがローカルのインバウンドを経由して応答を受け取ったことだけです。プロキシ経由のアウトバウンドが選ばれたことまで確認するには、現在のルーティングルールと利用可能な接続ログを照らし合わせてください。ページが開いたというだけでは判断できません。
ログイン時の自動起動とよくあるトラブル
ブラウザーでの接続確認が済んでから、自動起動を設定しましょう。自動起動は通常、ユーザーのログイン時に実行されるもので、システムにログインする前から動作するわけではありません。クライアントの自動起動とシステムプロキシの復元は別の設定です。設定後、それぞれ個別に確認してください。
- Windows:「設定」→「パラメーター設定」で「Windows起動時に自動起動」を確認します。設定前にプログラムの保存先を決めてください。圧縮ファイル版のフォルダーを後から移動した場合は、自動起動を設定し直し、ログイン時に古いパスが参照されないようにします。
- macOS:「システム設定」→「一般」→「ログイン項目」で、「アプリケーション」内のv2rayNをログイン時に開く項目へ追加できます。一部のシステムバージョンでは、この画面が「ログイン項目と機能拡張」と表示されます。クライアント側ですでに自動起動を設定している場合は、同じアプリを重複して追加しないでください。
- 再ログインして確認:まずクライアントが起動していることを確認し、次にアクティブノード、コアのログ、システムプロキシの状態を確認します。使用を停止する場合は、クライアントを終了する前にシステムプロキシを解除してください。アプリが終了したローカルポートにリクエストを送り続けるのを防げます。
サブスクリプショングループは表示されるのに、中身が空なのはなぜ?
グループを選択し、「現在のサブスクリプションを更新(プロキシを使用しない)」を手動で一度実行してから、更新ログを確認してください。ログにHTTP 401または403が記録されている場合は、URLが完全か、アクセストークンが有効かを確認します。接続がタイムアウトする場合は、まずこの端末からサブスクリプションサービスに接続できるか確認してください。プロキシ経由で更新するのは、利用可能なプロキシがすでにある場合に限ります。
ノードの速度測定結果が表示されるのに、Webページが開かないのはなぜ?
速度測定の結果は、ブラウザーがそのノードを使っていることを意味しません。まず対象ノードがアクティブサーバーに設定されていることを確認し、ローカルプロキシを明示的に指定するコマンドで同じ接続先を試します。コマンドが成功してブラウザーだけ失敗する場合は、遅延順に別のノードへ切り替える前に、ブラウザーのプロキシ設定を確認してください。
ウィンドウを閉じたのに、プロキシが動作し続けるのはなぜ?
通知領域またはメニューバーにv2rayNのアイコンが残っているか確認してください。ウィンドウを閉じてもアプリを常駐させる設定が有効な場合、ウィンドウが消えただけでは終了していません。停止するには、まず「システムプロキシ」メニューでシステムプロキシを解除し、その後クライアントのメニューから「終了」を選びます。
ログイン後にクライアントは起動したのに、ターミナルがプロキシを使わないのはなぜ?
多くのコマンドラインプログラムは、デスクトップのシステムプロキシ設定を引き継ぎません。まず、このツールのプロキシオプションを使ってテストします。たとえば、上記の curl --proxy でローカルのインバウンドを指定してください。長期的な設定が本当に必要な場合に限り、ツールのドキュメントに従って対応するプロキシオプションや環境変数を設定します。1つのコマンドをプロキシ経由にするためだけに、全体設定を変更する必要はありません。