Macにv2rayNを初めてインストールする方や、クライアントは起動できたものの、プロキシの許可や接続確認でつまずいている方に向けた記事です。まずCPUアーキテクチャとインストール先を確認し、Gatekeeperの警告に対処したあと、コア、システムプロキシ、TUNをそれぞれ検証します。アプリの起動許可、ネットワーク設定の変更権限、ネットワーク拡張の承認は別々の手続きです。一度許可しただけですべて解決したと判断せず、個別に確認してください。
1. macOS版インストーラーとCPUアーキテクチャ
v2rayNのmacOS版はクロスプラットフォームのデスクトップUIを採用しています。WPF版はWindows向けのため、Macでは使用できません。ダウンロード前にAppleメニューの「このMacについて」を開き、「チップ」または「プロセッサ」の表示を確認してください。Appleシリコン搭載MacではmacOS arm64版、Intelプロセッサ搭載MacではmacOS x64版を選びます。ファイル名にv2rayNとあるだけで動作すると判断しないでください。
-
Macの機種を確認
Appleメニューから「このMacについて」を開き、チップの種類とmacOSのバージョンを確認します。そのうえで、ダウンロードページに記載されたシステム要件と照らし合わせてください。アーキテクチャが合っていても、古いOSでは動作要件を満たさない場合があります。
-
インストーラーを選ぶ
当サイトのクライアントページからmacOS版を選び、arm64またはx64に合ったファイルをダウンロードします。初回インストール時の切り分けが複雑にならないよう、CPUに対応したビルドを選び、変換実行環境の問題を避けてください。
-
ファイルを展開する
圧縮ファイルは最後まで展開します。ディスクイメージが配布されている場合は、まずマウントしてください。アプリケーションを見つけたら「アプリケーション」フォルダに移動します。アプリケーションパッケージ内の実行ファイルだけを取り出して使わないでください。
-
初回起動
「Finder」→「アプリケーション」からv2rayNを開きます。セキュリティ警告が表示されたら、まず内容を最後まで確認し、次のセクションの手順に従ってください。同じファイルを何度もダウンロードしても、権限の確認にはなりません。
アップデート前に起動中の旧バージョンを終了し、アプリを置き換えてください。既存の設定はバックアップし、初回の更新時にサブスクリプション、ルーティング、コアの設定を同時に変更しないようにします。問題が起きた場合に、アプリの更新と設定変更のどちらが原因か切り分けやすくなります。
2. 「開発元を検証できません」と表示されたときの許可方法
Gatekeeperはアプリの起動前に、入手元や署名の状態を確認します。「開発元を検証できません」や「悪質なソフトウェアが含まれていないことを確認できません」という警告は、起動時のチェックに関するものです。ノードへの接続失敗やシステムプロキシの権限不足とは別の問題です。ファイルの入手元が信頼でき、インストーラーが選択したプラットフォームに合っていることを確認したうえで、このアプリのみを個別に許可してください。
- まず「アプリケーション」からv2rayNを一度開き、システムに今回の起動ブロックを記録させます。
- Appleメニューから「システム設定」→「プライバシーとセキュリティ」を開き、下にスクロールして「セキュリティ」欄を探します。
- この欄に直前にブロックされたv2rayNが表示されたら、アプリ名を確認して「このまま開く」をクリックします。このボタンは、ブロック後の一定時間だけ表示される場合があります。
- システムの指示に従い、アカウントのパスワードまたはTouch IDで認証します。続けて確認画面が表示されたら、もう一度「開く」を選択してください。
- アプリに戻り、メイン画面が表示されるか確認します。画面が開いたら設定をインポートしてください。セキュリティ設定の画面をネットワーク設定の画面と混同しないようにしましょう。
macOSのバージョンによって警告の文言は異なります。一部の古いバージョンでは、FinderでアプリをControlキーを押しながらクリックし、「開く」を選ぶと確認画面に進めます。新しいシステムでは「プライバシーとセキュリティ」での許可が必要な場合があります。現在のシステムに表示される手順に従ってください。
3. サブスクリプションを追加し、ローカルの待ち受けを確認
メイン画面が開いたことは、アプリが起動時のチェックを通過したことを示すだけです。通信の転送はコアが実行し、サブスクリプションからサーバー設定を取得します。「サブスクリプショングループ」→「サブスクリプショングループの設定」でグループとURLを追加して保存し、「サブスクリプショングループ」に戻って更新してください。メニューに「すべてのサブスクリプションを更新」がある場合は、各グループの内容を取得できます。バージョンによってはプロキシ経由で更新するかどうかを選べます。まだ接続できていない初回は、プロキシを経由しない方法で更新してください。
設定が一覧に表示されたら1つ選び、アクティブサーバーに設定します。ログを確認し、コアが正常に起動したことも確かめてください。VMessとVLESSはプロトコルの種類であり、システム権限の名称ではありません。サブスクリプションに含まれるトランスポート、TLS、サーバー名などの設定はそのまま維持してください。macOSの許可を得るためにVLESSをVMessへ変更したり、TLSをむやみに無効化したりする必要はありません。
以降のコマンドでは、ローカルアドレス127.0.0.1、ポート10808を例にします。実際の値は「設定」→「パラメーター設定」でローカルの待ち受けポートを確認し、起動ログと照合してください。現在のバージョンに混合ポートがある場合、同じ待ち受けでHTTPとSOCKSの両方を受け付けます。画面で2種類のポートが別々に表示される場合は、それぞれの用途に合った値を入力してください。同じ番号をそのまま使えるとは限りません。
- コアが起動していない：まずログに表示された起動エラーを確認してください。システムプロキシが設定済みでも、ローカルの転送先が動作していません。
- ポートが使用中：旧バージョンのプロセスやポートを使用している別のアプリを終了するか、待ち受けポートを変更してください。変更後はシステムプロキシ側の設定も更新します。
- サブスクリプションが空：URLの期限切れやログインの要否を確認し、更新ログにエラーが出ていないか調べてください。Gatekeeperの許可とは関係ありません。
4. システムプロキシの許可とネットワーク設定の確認
通常のWeb閲覧には、まずシステムプロキシを使います。v2rayNのメイン画面で「システムプロキシ」を開き、「システムプロキシを自動設定」を選択してください。macOSからネットワーク設定の変更や補助ツールのインストールを求められたら、要求元のアプリ、操作内容、入手元を確認してから必要に応じて許可します。メイン画面を起動するためだけに、クライアントを管理者権限で常時実行する必要はありません。
クライアント側の確認項目
- システムプロキシ
- システムプロキシを自動設定
- アクティブな設定
- アクティブサーバーに設定した項目
- ローカルアドレス
127.0.0.1- ポート番号の例
10808（実際の待ち受けポートを確認）
まずコアの起動を確認してからシステムプロキシを設定します。それぞれ個別に状態を確認してください。
macOS側の確認項目
- 設定場所
- システム設定 → ネットワーク
- 現在のネットワークサービス
- 接続中のWi-FiまたはEthernet
- 詳細画面
- 詳細 → プロキシ
- 確認する内容
- 有効になっているプロキシのアドレスとポート
ネットワークサービスを切り替えたら、あらためて設定を確認してください。未使用のインターフェースの値だけを見ても判断できません。
macOSの「プロキシ」画面で、実際に設定された内容を確認します。「Webプロキシ」はHTTP、「セキュアWebプロキシ」はHTTPSリクエスト用のプロキシです。後者の「セキュア」は、ローカルのプロキシ待ち受け自体がTLSを使うという意味ではありません。クライアントが管理する項目だけを確認し、チェック項目をすべて埋めるために、自動プロキシ検出、自動プロキシ設定、手動入力のプロキシを同時に有効にしないでください。
システムプロキシは、アプリが参照するシステム設定であり、すべての通信を制御するものではありません。一部のコマンドラインツール、独自プロキシを設定したブラウザー、自前で接続を確立するアプリは、この設定を参照しない場合があります。ブラウザーではページを開けるのに特定のターミナルコマンドだけ失敗する場合は、まずそのコマンドのプロキシ設定方法を確認してください。すぐに権限の問題だと判断しないようにしましょう。
5. TUN、ネットワーク拡張、通常のプロキシの違い
TUNは仮想ネットワークインターフェースを通じて通信を処理し、インターフェース、ルーティング、DNSに関係するため、通常のローカルプロキシより高い権限が必要になることがあります。初回インストールで必ず有効にする機能ではありません。まずシステムプロキシで設定が使えることを確認し、アプリの対応範囲に応じてTUNを有効にするか判断してください。一度に複数の条件を変えずに済み、原因を誤認しにくくなります。
使い分け：通常のプロキシを確認してからTUNを検討
システムプロキシモード
- システムプロキシを参照するブラウザーやデスクトップアプリに適しています。
- ローカルの待ち受け、アクティブサーバー、ネットワークサービスのプロキシ設定を確認します。
- 通常のプロキシを有効にしただけで、ネットワーク拡張の承認が必ず必要になるわけではありません。
TUNモード
- 仮想インターフェースで通信を処理する必要があり、現在のビルドが対応している場合に適しています。
- クライアントの案内に従い、必要な補助コンポーネントをインストールまたは許可します。
- 有効にしたあとは、インターフェース、ルーティング、DNS、他のトンネルソフトとの競合も確認してください。
TUNの実装はクライアントのバージョンやコンポーネントによって異なります。仮想インターフェース、補助サービス、ネットワーク拡張はそれぞれ別のものです。
コンポーネントがネットワーク拡張の権限を実際に要求した場合に限り、対応する承認項目を探してください。macOS 15では「システム設定」→「一般」→「ログイン項目と機能拡張」→「ネットワーク機能拡張」を確認できます。ほかのバージョンでは「プライバシーとセキュリティ」に許可を求める通知が表示される場合があります。一覧に該当項目がないからといって、通常のシステムプロキシのインストールに失敗したとは限りません。存在しない拡張機能をインストールする必要もありません。
- ネットワーク拡張：名称と開発元が、今回インストールしたコンポーネントと一致する項目だけを許可してください。v2rayNの問題を解決するために、関係のない項目まで有効にしないでください。
- ローカルネットワークへのアクセス：この権限があるシステムでは、「プライバシーとセキュリティ」→「ローカルネットワーク」で確認できます。主にLANへのアクセスに関わるもので、外部ネットワークへのすべての接続を制御する設定ではありません。
- ファイアウォール：「ネットワーク」→「ファイアウォール」は、主に受信接続の制御に関する設定です。ブラウザーが外部サーバーに接続できない場合でも、ファイアウォール全体を無効にするのは避けてください。
- 管理ポリシー：学校や職場の管理対象デバイスでは、拡張機能、補助サービス、ネットワーク設定が制限される場合があります。個人アカウントのパスワードを入力しても、制限を解除できるとは限りません。
6. システムの状態と明示的なプロキシ指定で原因を特定
トラブルシューティングでは、「プロキシ設定が反映されたこと」と「通信の転送に成功したこと」を分けて確認します。まずシステムの記録を調べ、次にポートを確認し、最後にコマンドでローカルプロキシを明示的に指定します。以下のコマンドは「ターミナル」で実行してください。例は状態の確認または通常のWebリクエストを行うもので、システムのセキュリティ設定は変更しません。
# システムの現在のプロキシ状態を確認
scutil --proxy
# ポートの例でTCP待ち受けを確認
lsof -nP -iTCP:10808 -sTCP:LISTEN
# HTTPプロキシを明示的に使用（このポートがHTTPに対応している場合のみ）
curl --proxy http://127.0.0.1:10808 --connect-timeout 10 -I https://example.com
# SOCKSを明示的に使用し、接続先ドメインの名前解決をプロキシ側で行う
curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 -I https://example.comscutil --proxyに表示されるHTTPEnable、HTTPProxy、HTTPPortなどの項目で、実際のシステム状態を確認できます。SOCKSを使っている場合は、対応するSOCKSの項目を見てください。lsofで結果が表示されない場合は、権限の再確認を繰り返すのではなく、ポート番号の間違いやコアの停止をまず確認します。
| 確認できた状態 | まず確認する項目 | 次の手順 |
|---|---|---|
| ローカル接続が拒否される | 待ち受けポート、コアのプロセス | ポート番号と起動ログを確認し、まず待ち受けを復旧します。 |
| プロキシを明示すると成功するが、ブラウザーでは失敗する | システムプロキシ、ブラウザー独自の設定 | 現在のネットワークサービスのプロキシ設定を確認し、ブラウザー側で上書きされていないか調べます。 |
| ローカルの待ち受けは正常だが、リクエストがタイムアウトする | ノード、DNS、ルーティング、上流への接続 | クライアントのログを確認し、別の既知の有効な設定でも試してください。 |
| TUNモードだけ失敗する | 補助サービス、インターフェース、DNS、ルーティングの競合 | TUNを無効にしてシステムプロキシに戻し、基本の通信経路が使えるか確認します。 |
接続先サイトからHTTPレスポンスが返ってきても、そのリクエストが応答を受け取れたことしか確認できません。すべてのドメインがプロキシを経由する証明にはなりません。ルーティングルールによって、一部のリクエストが直接接続される場合があります。テスト時はコアのログで使用されたアウトバウンドを確認し、「システムプロキシをグローバルに設定すること」と「すべての接続先にプロキシ経由のアウトバウンドを使うこと」を混同しないでください。
7. インストールと権限に関するよくある質問
「このまま開く」が見つからない場合は？
「アプリケーション」からもう一度アプリを開き、そのあと「システム設定」→「プライバシーとセキュリティ」で直近のブロック記録を確認してください。実際の警告がOSの非対応、アプリの破損、悪質なソフトウェアに関するものなら、それぞれの原因に応じて対処します。管理対象デバイスでは管理者に相談し、ポリシーを回避しようとしないでください。
起動を許可したのに、なぜパスワードを求められるのですか？
アプリの起動許可とネットワーク設定の変更は、別々の操作です。システムプロキシの設定や補助サービスの操作を行った直後に表示された確認画面かどうかを見て、名称と用途を確認してから許可してください。何度も表示される場合は、インストール先、旧プロセス、補助コンポーネントの状態を確認します。内容を見ずに続けて許可しないでください。
v2rayNを終了したら、ブラウザーでWebページを開けなくなったのはなぜ？
クライアントを再度開き、「システムプロキシ」から「システムプロキシをクリア」を実行してから終了してください。アプリを開けない場合は、「システム設定」→「ネットワーク」→現在のネットワークサービス→「詳細」→「プロキシ」を開き、残っているローカルプロキシ設定を削除します。職場や学校のプロキシ設定、自動設定URLは控えておき、誤って一緒に削除しないようにしてください。
アップデートのたびに確認する項目は？
まず、同じアーキテクチャのアプリに置き換えたか確認します。起動後はアクティブな設定、待ち受けポート、システムプロキシの状態を確認してください。システムが起動を再びブロックした場合や、権限を求めた場合に限り、該当する警告に対処します。アプリ本体を更新しても、サブスクリプションを再作成する必要はなく、すべてのネットワーク権限を有効にし直す必要もありません。
設定後の確認手順は毎回同じです。アプリが開くこと、サブスクリプションを読み込めること、コアが待ち受けていること、システムプロキシが正しいポートを参照していること、接続先から応答があることを確認します。必要な場合に限りTUNを有効にし、追加で必要になる権限とネットワークの変化を個別に検証してください。この順序なら、インストール、権限、ノードの問題をそれぞれ明確な確認項目に分けられます。