まずバージョンを選ぶ：デスクトップ版、クラシック版、プロセッサーのアーキテクチャ
v2rayN のインストールで最初に行うのは、サブスクリプションの追加ではなく、OS、プロセッサーのアーキテクチャ、画面版の種類を確認することです。インストールパッケージを間違えると、起動できない、アプリに互換性がないと表示される、コアプロセスが起動直後に終了するといった問題が起こります。まずシステム情報でデバイスの種類を確認し、ダウンロードセンターで対応するファイルを選びましょう。
Windows での選び方
近年製造された Windows パソコンの多くは x64 アーキテクチャです。Windows x64 のインストールパッケージを選択してください。ARM プロセッサー搭載端末では arm64 を選びます。x86 パッケージを検討するのは、32ビットシステムを使用していることが明確な場合だけです。システム設定に「64 ビット オペレーティング システム、x64 ベース プロセッサ」と表示されるなら、x86 版はダウンロードしないでください。
v2rayN デスクトップ版はマルチプラットフォーム向けの画面を採用しており、Windows と macOS で主要な操作手順が近いため、2つのデスクトップ OS で似た操作感を保ちたいユーザーに適しています。クラシック版は主に Windows 向けで、メニュー構成、トレイ操作、サーバー一覧の管理方法が長く受け継がれており、従来の操作に慣れているユーザーに向いています。どちらもサブスクリプションの追加、ノード選択、システムプロキシ、ルーティングの振り分けに対応しますが、設定名やメニューの位置はバージョンによって変わる場合があります。
macOS での選び方
macOS では「この Mac について」または「システム情報」を開き、まずプロセッサーの種類を確認します。Apple シリコン搭載端末は arm64、Intel プロセッサー搭載端末は x64 を選択してください。アーキテクチャが合わなくても互換機能で動作する場合はありますが、コアの呼び出し、トレイ表示、更新時のトラブルシューティングが複雑になる可能性があります。初回インストールではネイティブ対応のパッケージを使いましょう。
旧版から新版へ移行する場合は、プログラム一式を直接上書きせず、サブスクリプションを改めて追加することをおすすめします。旧設定には異なるコアのパス、ローカルポート、ルーティングルール、画面項目が保存されている可能性があり、一式を上書きすると無効な設定まで引き継ぐことがあります。カスタムルールを残したい場合は、ルール内容、待ち受けポート、サブスクリプショングループを先に記録し、新版で一つずつ復元してください。
インストール前の準備：ファイルの保存場所、実行権限、ネットワーク状態
Windows のクラシック版は圧縮ファイルで提供される場合があります。解凍してからメインプログラムを実行し、圧縮ファイルのプレビュー画面から直接起動しないでください。プログラムは自身のフォルダーからコア、設定、実行データを読み込みます。一時的なプレビュー場所から起動すると、コアファイルが見つからない、設定を保存できない、更新後にファイルが分散するといった問題が起きやすくなります。
プログラムフォルダーは、現在のアカウントに読み書き権限がある場所へ置いてください。パスには英数字も日本語も使用できますが、頻繁に削除される一時フォルダーは避けましょう。Windows の初回設定で、管理者として常時実行する必要は通常ありません。システムレベルの権限が必要なネットワーク機能を有効にする場合や、セキュリティポリシーによって書き込みが明確にブロックされた場合のみ、画面の指示に従って権限を処理してください。
macOS ではダウンロード後、アプリを「アプリケーション」へ移動してから起動します。ネットワークから取得したアプリを初めて開く際、提供元の確認を求められることがあります。システム設定のプライバシーとセキュリティで、現在ブロックされている理由を確認できます。ファイルが当サイトのダウンロードセンターから取得したものだと確認したら、システムの指示に従って許可してください。アプリの場所を何度も移動すると、権限が再記録され、ログイン時の起動やネットワーク権限を再確認する必要が生じる場合があります。
初回起動前には、次の3つの基本状態も確認します。
- システムの日付、時刻、タイムゾーンが正しいこと。時刻のずれは TLS に依存する接続に影響します。
- 現在のネットワークからローカルネットワークと普段利用する直接接続サイトへ正常にアクセスできること。基本的なネットワーク切断をノード障害と取り違えないためです。
- ローカルプロキシポートを使用している古いプロセスを終了すること。特に、以前起動した v2rayN のプロセスに注意してください。
初回起動：まずコアを確認し、次にローカルポートを設定
v2rayN はグラフィカルクライアントであり、VMess、VLESS、Trojan、Shadowsocks の接続を実際に処理するのは選択したコアです。一般的な構成では Xray コアを使用しますが、バージョンが提供する選択肢に応じて V2Ray コアを使うこともできます。クライアントは設定の管理、コアの呼び出し、システムプロキシの切り替え、実行ログの表示を担当します。画面が開けることと、コアが正常に動作していることは別です。
初回起動後、まず設定画面でコアの種類とコアのパスを確認します。コアの確認機能やバージョン情報機能がある場合は、先に一度実行してください。ログにコアのバージョン、待ち受けアドレス、起動完了の情報が表示されれば、プログラムがローカル接続を受け付けられる状態になっています。実行ファイルが見つからないと表示された場合は、インストールパッケージが完全に解凍されているか、プロセッサーのアーキテクチャが正しいか、セキュリティ設定がコアの起動を妨げていないかを再確認します。
続いてローカルの待ち受けポートを確認します。バージョンによって SOCKS、HTTP、混合ポートなどが用意され、初期値も異なる場合があります。初心者は現在のバージョンが提示するデフォルト設定をそのまま使えばよく、古い解説に合わせて特定の数字へ無理に変更する必要はありません。記録すべきなのは「現在実際に使われているポート」です。ブラウザーの手動プロキシ、開発ツール、ポート確認コマンドはすべてこの値と一致させる必要があります。
ローカルの待ち受けアドレスは通常、ループバックアドレスのままにし、本機のプログラムだけが接続できる状態にします。LAN 上の他の端末から接続する明確な理由がない限り、LAN からの接続を許可しないでください。LAN 待ち受けを開放する場合は、システムファイアウォール、ネットワーク環境、アクセス制御も同時に検討する必要があり、初回インストールに必須の手順ではありません。
ログで確認したい項目
address already in use：ローカルポートが別のプロセスに使用されています。connection refused：接続先が接続を拒否しています。サーバーが待ち受けていないか、ポートの入力を誤っている可能性があります。timeout：規定時間内に接続が完了しませんでした。ローカルネットワーク、サーバーの状態、ルーティング経路を切り分ける必要があります。failed to parse：設定内容を解析できません。サブスクリプション変換の異常や、手入力したパラメーターの形式ミスでよく発生します。- 証明書名やハンドシェイクに関するエラー：サーバーアドレス、SNI、転送方式、安全層のパラメーターを重点的に確認します。
サーバー一覧の遅延値だけを見て判断しないでください。遅延テストは異なる方法で探測する場合があり、遅延が返ってきても対象サイトへアクセスできるとは限りません。逆に、特定の探測に応答しないサーバーでも、実際のプロキシ接続は正常なことがあります。設定の利用可否は、コアのログ、実際の接続テスト、サブスクリプションパラメーターが完全かどうかで判断してください。
サブスクリプションの追加：更新、グループ、ノードの選択
サブスクリプション URL を取得したら、サブスクリプショングループの管理画面で新しい項目を追加します。名前はローカルで識別するためのもので、用途や回線の種類を入力できます。URL は前後に空白や改行が混ざらないよう、完全な形でコピーしてください。保存後にサブスクリプションを更新し、サーバー一覧に設定が表示されれば追加完了です。URL を保存するだけでは、ノードは自動生成されません。
サブスクリプションの更新に失敗したら、まず URL が期限切れでないか、現在のネットワークからサブスクリプションサーバーへアクセスできるかを確認し、次に更新ログを確認します。同じサブスクリプションを何件も作成しないでください。重複したグループは同名ノードを生み、設定の出所を判断しにくくします。更新後のノード数はサービス側の公開内容によって決まるため、更新ボタンを繰り返し押して増やすものではありません。
ノードを選ぶときは、プロトコルとパラメーターが完全かどうかを重点的に確認します。VMess の設定には通常、ユーザー識別子、転送方式、安全設定が含まれます。VLESS では TLS、Reality、SNI、フィンガープリント、フロー制御のパラメーターが必要になる場合があります。Trojan には正しいパスワードと安全層の情報が必要で、Shadowsocks には対応する暗号方式とパスワードが必要です。v2rayN はサブスクリプションの内容に基づいて設定を生成するため、サーバー側の設定が分からないままこれらの項目を変更しないでください。
ノードを選択したら、アクティブサーバーに設定する必要があります。一覧で行がハイライトされただけでは、切り替えが完了したとは限りません。ステータスバー、トレイメニュー、ログに表示される現在のサーバー情報を確認してください。切り替え後は通常、コアが設定を再読み込みするため、短時間だけ既存の接続が切れることがあります。これは設定の再読み込みによる正常な動作です。
システムプロキシ：ノードは使えるのにブラウザーがプロキシを経由しない理由
コアを起動すると、本機にプロキシの入口が開くだけです。アプリがその入口を経由するかどうかは、システムプロキシ、アプリ独自のプロキシ、その他の接続制御方法によって決まります。初回インストールで最も多いのは、サーバーテストもログ上のコア動作も正常なのに、ブラウザーが直接接続してしまう問題です。多くの場合、原因はプロトコルではなく、システムプロキシがまだ有効になっていないことです。
v2rayN で「システムプロキシを設定」を選ぶと、クライアントが現在のローカルプロキシアドレスを OS に書き込みます。システムプロキシに従う多くのブラウザーやデスクトップアプリは、この設定を読み取ります。設定後はブラウザーをいったん終了して再起動し、動作を確認してください。起動時にのみプロキシ状態を読み取るアプリもあり、システム設定の変更にすぐ反応しない場合があります。
システムプロキシの主なモードは、次のように理解できます。
- システムプロキシを解除：v2rayN が書き込んだプロキシ設定を削除し、アプリを OS 本来のネットワーク方式で接続します。
- 自動構成またはルールモード：設定スクリプトやルールに基づき、どのリクエストをローカルプロキシへ渡すかをシステムが決定します。
- グローバルプロキシ：システムプロキシに従うリクエストを v2rayN へ送り、コアが最終的な出口をルーティングで決定します。
「システムプロキシのルール」と「コアのルーティングルール」は別の層です。システムプロキシは通信を v2rayN に入れるかどうかを決め、コアのルーティングは入ってきた通信をプロキシ、直接接続、遮断のどれにするかを決めます。アプリがシステムプロキシをまったく読み取らない場合、コアのルーティングを変更しても自動的にプロキシへは入りません。その場合は、アプリに HTTP または SOCKS の個別プロキシ設定があるか確認してください。
macOS では、システムのネットワーク設定にあるプロキシ画面で、現在のサービスに HTTP、HTTPS、SOCKS の項目が設定されているか確認できます。Windows では、システムのプロキシ設定でアドレスとポートを確認します。手動で確認する場合、ポートは v2rayN が現在待ち受けている値と一致していなければなりません。システム画面に古いポートが残っている場合は、まず v2rayN でシステムプロキシを解除し、設定し直してください。
ルーティングの振り分け：まずプリセットを使い、次にカスタムルールを調整
ルーティングの振り分けは、コアに入った接続の出口を決定します。初回利用時から大量のカスタムドメインや IP ルールを追加することはおすすめしません。まずバージョンが提供する基本プリセットを選び、プロキシ接続と直接接続がどちらも動作することを確認してから、必要に応じてルールを追加しましょう。異常が起きた際に、サーバー、システムプロキシ、ルーティングルールのどこに原因があるか切り分けやすくなります。
ルールは通常、上から順番に照合され、前のルールが後のルールより先に適用される場合があります。ドメインルールはリクエスト内のドメイン、IP ルールは名前解決後のアドレス、プロセスルールはクライアントと OS が対応する識別方法を利用できるかどうかに基づいて照合します。ルールを変更したら設定を再読み込みし、ログで実際にどのルールに一致したかを確認してください。
DNS も振り分け結果に影響します。ドメインに基づくルールでも、アプリが先にドメインを IP に解決し、純粋な IP 接続としてプロキシへ渡すと、コアが元のドメインを取得できない場合があります。逆に、DNS リクエストと実際の接続が異なる出口を使うと、現在の回線に適さないアドレスが返されることもあります。初回設定では DNS の構成をシンプルに保ち、基本接続が安定してから、中国本土・海外ドメインのグループ分け、リモート DNS、より細かな DNS 汚染対策ルールを設定しましょう。
「グローバルプロキシ」にすれば、すべてのデバイスの通信が必ずサーバーを経由するわけではありません。システムプロキシを設定しただけでは、システムプロキシを迂回するアプリが残る場合があり、LAN 上の他の端末も自動的には接続されません。より多くの種類の通信を制御する必要がある場合は、クライアントが提供する TUN 機能を検討できますが、仮想ネットワークアダプター、システム権限、DNS の制御、ルーティングテーブルの変更が関わるため、初回インストールの最初の手順には向きません。
よくあるトラブル1：システムプロキシが反映されない
システムプロキシが反映されない場合は、複数の項目を同時に変更せず、決まった順番で切り分けます。
- v2rayN のメインプログラムが動作中で、トレイにアイコンが表示されていることを確認します。
- コアのログを確認し、ローカルの待ち受けが正常に確立されていることを確認します。
- 現在のサーバーがアクティブサーバーに設定されており、一覧で選択されているだけではないことを確認します。
- システム設定で、プロキシアドレスが本機のアドレスになっているか、ポートがクライアントと一致しているか確認します。
- テストするブラウザーやアプリを再起動し、古いプロセスがプロキシ設定を保持していないか切り分けます。
- 一時的に基本ルーティングプリセットを使い、カスタムルールによって対象が誤って直接接続または遮断へ振り分けられていないか確認します。
特定のアプリだけが動作せず、ブラウザーはプロキシ経由で正常にアクセスできる場合は、まずそのアプリ自身のネットワーク設定を確認してください。独自プロキシを使うプログラム、HTTP プロキシにしか対応しないプログラム、システムプロキシを完全に無視するプログラムがあります。その場合は、v2rayN のローカルアドレスと対応するプロトコルのポートをアプリの設定へ入力するほうが、サーバーを何度も切り替えるより効果的です。
すべてのアプリが接続できず、システムプロキシを解除すると直接接続が復旧する場合は、コアがすでに終了していないか確認します。システムプロキシはリクエストをローカルポートへ送るだけなので、そこを待ち受けるプロセスがなければ、ウェブページは通常すぐに接続エラーになります。コアを再起動しても失敗する場合は、ポートの競合と設定解析エラーを確認してください。
よくあるトラブル2：ポートの競合と重複プロセス
ポートの競合は、旧版 v2rayN が完全に終了していない、プログラムのクラッシュ後もコアプロセスがバックグラウンドで動作している、別のネットワークツールが同じポートを使っているといった場合に起こります。ログの address already in use は直接的なサインです。対処時はクライアントを複数起動せず、まずそのポートを待ち受けているプロセスを特定してください。
Windows では PowerShell で例としてポート 10808 を確認できます。実際の設定がこのポートでない場合は、コマンド内の数字を現在の値に変更してください。
Get-NetTCPConnection -State Listen |
Where-Object LocalPort -eq 10808 |
Select-Object LocalAddress, LocalPort, OwningProcessプロセス番号を取得したら、タスク マネージャーの「詳細」タブでプロセス名を照合できます。残存している v2rayN またはコアプロセスだと確認できた場合は、まずクライアントのメニューから通常の手順で終了します。画面を操作できない場合に限り、該当プロセスを終了してください。名前を確認せずにシステムプロセスをまとめて終了しないでください。
macOS ではターミナルで同じ例のポートを確認できます。
lsof -nP -iTCP:10808 -sTCP:LISTENそのポートが、停止させたくない別のサービスに使用されている場合は、v2rayN でローカルの待ち受けポートを変更できます。変更後は、システムプロキシと手動プロキシを使うアプリも合わせて確認してください。クライアントのポートだけを変更してアプリ側を更新しないと、コアは正常に動作しているのにアプリが接続できなくなります。
重複プロセスはログイン時の自動起動が原因になることもあります。新版と旧版の両方で自動起動を設定していると、システムへのログイン後に同じポートを順番に取り合います。移行が終わったら、現在使うバージョンだけを自動起動に残し、旧プログラムが終了していることを確認してください。Windows ではスタートアップアプリの一覧、macOS ではログイン項目とバックグラウンド拡張機能を確認できます。
よくあるトラブル3：サブスクリプションの更新は成功したのにノードへ接続できない
サブスクリプションの更新成功は、クライアントが内容を取得して解析できたことを示すだけで、すべてのサーバーが稼働中だという意味ではありません。ノードへ接続できない場合は、まず同じサブスクリプション内の別の設定へ切り替えます。複数の設定が同時にタイムアウトするなら、ローカルネットワーク、サブスクリプションの有効状態、サービス側のお知らせを確認してください。1つだけ失敗する場合は、そのノードのアドレス、ポート、プロトコルパラメーターを重点的に確認します。
サブスクリプションのノードを手動で変更すると、次回の更新でサーバー側の内容に上書きされる場合があります。一時的なテストが必要なら、設定を複製してから変更し、元のサブスクリプションノードを比較用に残してください。異なるノードの SNI、転送パス、ユーザー識別子、Reality パラメーターを混在させないでください。これらの項目は対応するサーバー側の設定と一致している必要があります。
プロトコルの選択はサブスクリプションの内容に従ってください。クライアントが特定のプロトコルに対応していても、現在のサーバーを自由にそのプロトコルへ切り替えられるわけではありません。VMess、VLESS、Trojan、Shadowsocks では認証方式と転送パラメーターが異なるため、プロトコル名だけを変更して変換することはできません。一般ユーザーは、サブスクリプションから配布された完全な設定をそのまま使用してください。
インストール後に安定して使うためのチェックリスト
初回設定が終わったら、再現可能な基本状態を1セット残しておくことをおすすめします。正常に更新できるサブスクリプショングループ、検証済みのサーバー、デフォルトのローカルポート、基本ルーティングプリセット、明確なシステムプロキシの状態を維持します。後で問題が起きたら、まずこの状態へ戻し、その後カスタム設定を一つずつ復元してください。
- クライアントを更新する前に、現在のバージョン、コアの種類、ローカルポート、ルーティングプリセットを記録します。
- サブスクリプションの更新後、現在のアクティブサーバーがまだ存在するか確認します。
- ネットワークを切り替えたら、古い遅延結果だけに頼らず、実際の接続テストをもう一度行います。
- クライアントを終了する際は、システムプロキシが想定どおりの状態に戻っていることを確認します。
- トラブルが起きたら、まず該当時間帯のログを保存してからプログラムを再起動し、重要なエラーが上書きされないようにします。
- カスタムルールは一度に1グループだけ変更し、変更後に再読み込みして一致結果を確認します。
Windows と macOS では画面上の位置が異なりますが、切り分けの考え方は同じです。まずクライアントプロセス、次にコアプロセスを確認し、ローカルポート、システムプロキシ、サブスクリプションパラメーター、ルーティングと DNS の順に検証します。この順番なら、「プログラムが開かない」「ノードに接続できない」「ブラウザーがプロキシを経由しない」という問題を分けて考えられ、複数の設定画面を行き来しながら試行錯誤せずに済みます。