この記事は、v2rayNを初めて使うWindows・macOSユーザー向けです。「インストーラーを選ぶ」「固定の場所に配置する」「コアの起動を確認する」「設定を読み込む」「システムプロキシを設定する」の順に進め、まず通常のプロキシ接続を確立しましょう。TUNモードはその後に検討してください。起動に失敗した場合は、ログやファイルパス、ローカルの待ち受けポートを確認します。原因をすべてサーバー側に求めないことが大切です。
1. インストーラーの選び方：OSとCPUアーキテクチャを確認
v2rayNはクライアントの画面を提供し、実際のプロキシ接続はコアが処理します。メインプログラムが起動しても、コアがそろっていることや設定が使えることを意味するわけではありません。初回インストールでは、配布パッケージのフォルダー構成を保ってください。メインプログラムだけをデスクトップにコピーしたり、異なる配布パッケージのファイルを混在させたりしないでください。
Windowsでは「設定」→「システム」→「システム情報」で「システムの種類」を確認します。macOSではAppleメニュー→「このMacについて」で「チップ」または「プロセッサ」を確認します。AppleシリコンはARM64、Intelプロセッサはx64に対応します。Windows ARM搭載端末では、x64版をネイティブのARM64版と取り違えないでください。動作するかどうかは、システムの互換性にも左右されます。
Windowsデスクトップ版
おすすめ初めてインストールする場合は、ダウンロードページのWindowsデスクトップ版を選びましょう。ページの案内に従ってインストーラーか圧縮ファイルを選びます。インストーラーはウィザードに沿って実行し、圧縮ファイルはすべて展開してから起動してください。
おすすめの対象：初めてインストールする方、クロスプラットフォーム対応のデスクトップ版を使いたいWindowsユーザー。
Windows WPF版
従来のWindowsインターフェースを使えます。使い慣れた画面を利用したい場合に選択してください。デスクトップ版の設定ファイルをWPF版のフォルダーにそのまま上書きしないでください。移行前にバックアップを取っておきましょう。
おすすめの対象：従来のWindowsメニューやウィンドウレイアウトに慣れている方。
macOSデスクトップ版
プロセッサに合わせてARM64版またはx64版を選びます。DMGを入手したら開き、アプリを「アプリケーション」にドラッグしてから、そのフォルダー内で起動してください。マウントしたディスクイメージから常用しないでください。
おすすめの対象：AppleシリコンまたはIntelプロセッサ搭載のMacユーザー。
2. Windowsでの展開と初回起動：固定フォルダーにすべてのファイルを配置
以下は圧縮ファイル版を使う場合の手順です。インストーラーをダウンロードした場合は、先にインストールを完了してください。インストーラーを圧縮ファイルのように扱わないでください。通常のシステムプロキシを使うだけなら、TUNを先に有効にする必要はありません。また、あらゆる起動トラブルに対して「常に管理者として実行」を適用するのも避けてください。
-
すべて展開する
圧縮ファイルを右クリックして「すべて展開」を選び、現在のユーザーが書き込みできる固定フォルダー（例：
D:\Tools\v2rayN）に展開します。圧縮ソフトのプレビュー画面からメインプログラムを起動しないでください。一時展開では設定ファイルとコアが別の場所に置かれることがあります。 -
メインプログラムを起動する
展開したフォルダーを開き、
v2rayN.exeを実行します。同じフォルダー内の依存ファイルやサブフォルダーはそのまま残してください。デスクトップから起動したい場合は、実行ファイルを移動せず、ショートカットを作成しましょう。 -
ランタイムを確認する
.NET Desktop Runtimeのインストールを求めるダイアログが表示された場合は、必要なランタイムのバージョンとアーキテクチャを確認してから案内に従ってください。ランタイムが同梱されているかどうかは配布パッケージによって異なります。.NETの表示だけを見て、別のアーキテクチャ向けランタイムをむやみにインストールしないでください。
-
サブスクリプションを追加する
メイン画面の「サブスクリプショングループ」→「サブスクリプショングループの設定」でグループを追加し、URLを入力して保存します。その後、「サブスクリプショングループ」メニューから更新してください。画面のバージョンによって「追加」ボタンまたは「+」ボタンが表示されます。入力先はサブスクリプショングループのURL欄で、個別サーバーの編集欄ではありません。
-
サーバーを選択する
更新後、サーバー一覧から項目を選び、右クリックメニューの「アクティブサーバーに設定」を実行します。次にメイン画面のログを確認し、「プロセスの起動に失敗しました」「ファイルが見つかりません」やポートのバインドエラーがないことを確かめてから、システムプロキシを設定してください。
3. macOSで起動を許可する：アプリのブロックとコアの実行エラーを切り分ける
アプリを初めて開くときのシステム警告と、プロキシコアの起動失敗は別の問題です。前者はアプリの起動時に表示され、後者は通常、アプリのログで対象ファイルを確認します。アプリのウィンドウが表示されても接続ボタンが反応しない場合は、ログを確認してください。アプリを「アプリケーション」から何度も取り除いて入れ直す必要はありません。
- まずアプリをコピー：アプリを「アプリケーション」に移動し、ダウンロードしたディスクイメージを取り出してから、Finderでアプリを開きます。圧縮ファイル版の場合は、安定した場所に展開してから起動してください。ダウンロード画面のプレビューから直接実行しないでください。
- 初回のブロックに対処：入手元を確認したうえで、FinderでControlキーを押しながらアプリをクリックし、「開く」を選びます。それでもブロックされる場合は、「システム設定」→「プライバシーとセキュリティ」で該当する案内を確認してください。今回起動するアプリであることを確認できた場合に限り、「このまま開く」を選びます。ボタンの表示はシステムのバージョンによって異なることがあります。
- コアのエラーを確認：ログの
permission deniedは実行権限またはアクセス権限の問題、bad CPU type in executableはアーキテクチャの不一致を示します。両者に同じ対処法を使わないでください。 - 必要な権限だけを許可：システムプロキシの変更時に許可を求められたら、アプリ名を確認してから操作してください。通常のプロキシ接続を初めて試すだけなら、トラブル調査のためにフルディスクアクセスを許可する必要はありません。
ディレクトリ全体のセキュリティ属性を再帰的に削除するターミナルコマンドを、そのまま実行しないでください。「アプリが壊れている」という警告を、常にシステムの制限を回避すべきだと解釈するのも誤りです。まず対応するアーキテクチャの配布パッケージを入手し直し、システムの案内を確認してください。組織管理下の端末では管理ポリシーが原因の場合もあるため、管理者に確認が必要です。
4. コアの保存場所：ログに記録された起動パスを確認
v2rayNはサーバーや設定を管理し、XrayやV2Flyなどのコアが設定に応じた処理を行います。プロトコル名とコア名は別の概念です。VLESSとREALITYの組み合わせには、その構成に対応するコアが必要です。どちらのコアも一部のプロキシプロトコルに対応しているからといって、自由に置き換えられるわけではありません。
Windowsで確認する項目
- メインプログラム
v2rayN.exe- コアの例
- Xrayの実行ファイル名は通常
xray.exeです - 一般的なフォルダー
- 配布パッケージ内の
binサブフォルダーと、その中のコア用サブフォルダー - パスの確認方法
- ログに記録された、実際に起動しようとしたファイルのパス
フォルダー構成は配布パッケージによって異なります。以前の手順を参考に、同じ名前のフォルダーを手動で作らないでください。
macOSで確認する項目
- アプリの場所
/Applications内のアプリケーションパッケージ- コアの例
- Xrayの実行ファイルには通常
.exe拡張子がありません - アーキテクチャ
- 選択した配布パッケージに対応するARM64またはx64
- エラーの確認方法
- ログに記録された実行パス、権限エラー、アーキテクチャエラー
アプリケーションパッケージ内のリソースとユーザーデータの保存先は別の場合があります。使用中の配布パッケージと起動ログを基準に確認してください。
コアの選択を確認するには、「設定」→「パラメータ設定」を開き、現在の画面で利用できるコア関連の項目を確認します。画面によっては「Coreタイプ」と表示されるほか、プロトコルごとに設定する場合もあります。エラーがないのに何度もコアを切り替える必要はありません。ログにコアが見つからないと明記されている場合は、該当する配布パッケージをすべて再インストールするか、クライアントのコア更新機能を使ってください。任意の実行ファイルをダウンロードして名前を変え、フォルダーに入れる方法は避けてください。
- ファイルが見つからない：ログのパスをたどってファイルを探し、展開漏れやセキュリティソフトによる隔離、更新の中断がないか確認します。
- 設定の解析に失敗：具体的なフィールド名を確認し、サーバーのプロトコルとコアの対応状況を照合します。システムプロキシの切り替えでは解決できません。
- データファイルがない：ルーティングルールが
geoip.datまたはgeosite.datを参照している場合は、コアが使うリソースの場所に各データファイルがあることも確認してください。
5. システムプロキシとポート：まずローカルの接続口を確認
コアが正常に起動したら、メイン画面の「システムプロキシ」メニューから「システムプロキシを自動設定」を選びます。システムプロキシは、システム設定に従うアプリの通信をローカルプロキシに渡します。ルーティングルールは、コアに届いた通信をプロキシ経由にするか直接接続するかを決めます。「グローバル」ルーティングを選んでも、すべてのアプリが自動的に対象になるわけではなく、システムプロキシの設定に代わるものでもありません。
「設定」→「パラメータ設定」でローカルの待ち受けポートを確認します。該当項目は基本設定のページにある場合があります。以下ではトラブル調査の例として127.0.0.1:10808を使いますが、すべての環境での既定値ではありません。実行前に画面に表示された実際のポートに置き換え、HTTPまたは混合プロキシの接続口であることを確認してください。
ポートを待ち受けているプロセスを確認
WindowsではPowerShellで1つ目のコマンドを、macOSではターミナルで2つ目のコマンドを実行します。待ち受けの記録が表示されても、ポートを何らかのプロセスが使用していることしか分かりません。今回起動したコアのプロセスかどうかも確認してください。
# Windows PowerShell
Get-NetTCPConnection -State Listen -LocalPort 10808 |
Select-Object LocalAddress, LocalPort, OwningProcess
# macOS ターミナル
lsof -nP -iTCP:10808 -sTCP:LISTEN- 待ち受けの記録がない：クライアントのログに戻り、コアが起動していない、ポート設定が保存されていない、設定の生成に失敗したなどの原因を調べます。
- ログに address already in use と表示される：まず重複して起動しているクライアントを終了し、ポートを使用中のプロセスを確認します。原因を確認する前に、正体の分からないシステムプロセスを終了しないでください。
- 待ち受けポートを変更した：コアを再起動し、システムプロキシの設定も適用し直してください。システムが古いポートを参照したままになるのを防げます。
プロキシを明示して接続テスト
以下のリクエストで、HTTPプロキシの接続口が接続を受け付けるか確認できます。Windowsではcurl.exe、macOSではcurlを使います。接続先は疎通確認の例です。そのアドレスがルーティング設定で直接接続になっている場合、応答が成功してもリモートのプロキシサーバーが使えるとは限りません。
# Windows
curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 -I https://example.com/
# macOS
curl --proxy http://127.0.0.1:10808 --connect-timeout 10 -I https://example.com/6. 初回インストールのよくある質問と設定の復元
ダブルクリックしてもウィンドウが表示されません。インストールに失敗していますか？
まずタスクバーの通知領域またはmacOSのメニューバーを見て、プログラムが起動済みか確認します。Windowsではタスクマネージャーで重複したプロセスがないかも調べてください。ランタイムの案内が表示された場合は、その指示に従います。何度も連続でクリックして複数のプロセスを起動しないでください。後から起動したコアでポート競合が起きることがあります。
サブスクリプションの更新に失敗しました。先に再インストールすべきですか？
まず再インストールする必要はありません。入力したものが完全なサブスクリプションURLであり、単独のvmess://またはvless://共有リンクではないことを確認してください。単独のリンクはクリップボードからのインポート機能を使います。次にシステムの日付と時刻を確認し、ログを見てタイムアウト、証明書エラー、サーバー側の拒否を切り分けます。トラブルのスクリーンショットを共有する際は、サブスクリプションURLや認証情報を隠してください。
速度測定は成功したのに、Webページが開きません。
速度測定の結果だけでは、ブラウザーがシステムプロキシを使っているとは限りません。コアのログ、ローカルの待ち受け、システムプロキシのアドレス、ブラウザー拡張の順に確認してください。プロキシを明示したリクエストが成功し、ブラウザーでは失敗する場合は、まずアプリ側の接続設定を確認します。どちらも失敗する場合は、サーバー、ルーティング、DNSのエラーを確認してください。
v2rayNを終了したら、通常のWebページも開けなくなりました。
クライアントをもう一度起動し、「システムプロキシ」から「システムプロキシをクリア」を選んでから、通常の手順で終了してください。Windowsでは「設定」→「ネットワークとインターネット」→「プロキシ」で手動プロキシを確認できます。macOSでは「システム設定」→「ネットワーク」→使用中のネットワーク→「詳細」→「プロキシ」で設定が残っていないか確認します。変更前に元の設定を記録し、組織によって設定されたプロキシはむやみに削除しないでください。
初回設定が済んだら、プログラムの実際の保存先、現在有効なコア、ローカルの待ち受けアドレスとポートの3点を記録しておきましょう。次回のトラブルでは、この3点とログから確認を始め、一度に変更する設定は1つにします。アップデート前にはクライアントが提供する方法で設定データをバックアップしてください。サブスクリプションの認証情報を含む設定全体を公開の掲示板に投稿しないでください。