v2rayNを初めてインストールする方や、アップデート後に起動をブロックされたりプロキシが機能しなくなったりしたmacOSユーザー向けです。まず配布元とCPUアーキテクチャを確認し、システムの案内に従って対象アプリの起動を許可します。アプリが起動したら、システムプロキシ、ローカルネットワーク、TUNを個別に確認し、異なる権限を混同せずに切り分けます。
Gatekeeperの警告とインストーラーのアーキテクチャを確認
コード署名は署名者の身元と署名後のコードの完全性を確認する仕組みです。一方、公証はAppleが提出されたソフトウェアを自動でセキュリティチェックするプロセスです。Gatekeeperはシステムのポリシーに基づいてダウンロードしたアプリを評価します。「開発元を確認できない」「悪質なソフトウェアが含まれていないことを確認できない」と表示されても、ダイアログだけでインストーラーの安全性を判断することはできません。また、起動できない原因がすべて未公証とは限りません。
- アーキテクチャ:Appleメニューから「このMacについて」を開きます。Appleシリコン搭載と表示される場合はARM64、Intelプロセッサと表示される場合はx64を選びます。アーキテクチャの不一致と署名の検証は別の問題です。セキュリティ設定を変更しても、アーキテクチャが合わないアプリをネイティブ実行できるようにはなりません。
- 配布元:ダウンロード元、リリースバージョン、ファイル名を確認します。見慣れないミラーサイトやチャットの添付ファイル、再パッケージされたファイルは、名前やアイコンが同じというだけで開かないでください。
- 警告の種類:システムがマルウェアを明確に検出した場合や、アプリが破損していると表示された場合は、起動を中止して配布元を再確認し、インストーラーを入手し直してください。組織管理のMacでアプリの実行が制限されている場合は、管理者に組織のポリシーを確認してください。
「プライバシーとセキュリティ」で特定のアプリを許可する
以下の手順は「システム設定」を使用するmacOSバージョンが対象です。配布元が信頼でき、システムに特定アプリの例外設定が表示される場合のみ操作してください。Gatekeeperを無効にしたり、システム全体のセキュリティポリシーを変更したりする必要はありません。
アプリケーションフォルダに移動
インストーラーがディスクイメージの場合は、開いたウインドウの案内に従ってv2rayNを「アプリケーション」にドラッグします。圧縮ファイルの場合は先に展開し、中のアプリを移動してください。その後、Finderの「アプリケーション」から起動し、ダウンロードフォルダにある古いコピーを誤って開かないようにします。
起動チェックを実行
インストールしたv2rayNをダブルクリックします。確認できないという警告が表示されたら、いったん閉じてアプリ名を控えてください。警告が表示されず、メイン画面が開く場合は、この節の以降の手順は不要です。
セキュリティ警告を確認
Appleメニューから「システム設定」→「プライバシーとセキュリティ」を開き、「セキュリティ」まで下にスクロールします。最近ブロックされたアプリがv2rayNであることを確認し、「このまま開く」をクリックします。この項目は通常、起動を試みてから約1時間以内に表示されます。
開くことを確認
システムのダイアログに従って本人確認を行い、開くことを確認します。この例外は選択したアプリに対するもので、ネットワーク権限を付与するものではありません。アプリの更新や置き換え後に再び警告が表示された場合は、新しいパッケージの配布元とバージョンを確認してください。
システムプロキシとTUNを分けて確認
メイン画面が開いても、コアの待ち受けが正常であることや、ブラウザーの通信がプロキシを経由していることまでは確認できません。初回のテストでは接続方法を一つだけ有効にしてください。両方を同時に有効にすると、ブラウザーで通信できても、どちらの設定が機能したのか判断できません。
2種類の接続方法を確認する手順
システムプロキシ:まずブラウザーをテスト
- TUNを無効にし、ノードを選択して、v2rayNの「システムプロキシ」メニューから「システムプロキシを自動設定」を選びます。設定変更の際に認証ダイアログが表示された場合は、要求内容が直前の操作と一致するか確認してから、案内に従って認証してください。
- 「システム設定」→「ネットワーク」→現在のサービス(「Wi-Fi」など)→「詳細」→「プロキシ」を開き、有効になっている項目を確認します。アドレスとポートがv2rayNのローカル待ち受け設定と一致しているか確認してください。有線ネットワークに切り替えた場合は、現在のサービスを改めて確認します。
TUN:次に仮想ネットワークインターフェイスをテスト
- まずシステムプロキシを解除してから、v2rayNのTUNモードを有効にします。表示された案内に応じて、管理者認証、VPN構成の追加、ネットワーク拡張の許可をそれぞれ確認してください。これらは別々の権限であり、実装によってはネットワーク拡張を要求しません。
- macOS 15でネットワーク拡張が無効だと明示された場合は、「システム設定」→「一般」→「ログイン項目と機能拡張」→「ネットワーク機能拡張」を開き、詳細を表示して該当項目を有効にします。VPN構成の追加が表示された場合は、システムの確認ダイアログで名称を確認し、「システム設定」→「VPN」で状態を確認してください。
プロキシ画面のポートがクライアントの待ち受けポートと一致していても、設定の向き先が同じであることしか確認できません。ノードへの接続状況はコアのログと実際のリクエストで確認してください。
システムプロキシの変更時に認証が表示されるとは限らず、すべてのバージョンで共通する常時表示の権限スイッチもありません。プロキシ画面に変化がない場合は、クライアントで「システムプロキシを変更しない」が選択されていないか確認し、権限エラーがログにないか調べてください。別のソフトウェアや管理ポリシーがプロキシを制御している場合は、設定を上書きせず、現在の内容を記録してください。
ローカルネットワーク権限は接続先に応じて判断
macOS 15の「ローカルネットワーク」権限は、アプリによるLAN上のデバイスへのアクセスを制御します。ブラウザーがローカルのループバックアドレス127.0.0.1に接続する場合と、v2rayNまたはそのコアがLAN上の別のホストに接続する場合は、異なる通信です。パブリックノードを使い、ブラウザーの接続先がループバックポートの場合、Webページが開かないという理由だけでローカルネットワーク権限を有効にしないでください。
パブリックノードとループバック待ち受け
推奨プロキシの待ち受け先はローカルに設定します。システムプロキシに従うブラウザーで接続を確認してください。ポートに例の値10808を設定していても、ログ上の実際の待ち受けポートが異なる場合は、クライアントまたはプロキシの設定を修正します。
適用例:初回インストール時、ローカルアプリだけをプロキシ経由にする場合
LAN上のノードに接続
ノードが同じLAN上にあり、たとえばアドレスが192.168.1.20の場合は、「システム設定」→「プライバシーとセキュリティ」→「ローカルネットワーク」で対象アプリのスイッチを確認します。一覧に対象が表示されない場合は、実際にアクセスを試み、システムの許可要求が表示されるか確認してください。システムに表示された要求元を確認し、見覚えのない項目をまとめて許可しないでください。
適用例:ノードまたは接続先のサービスが実際にLAN上にある場合
権限を許可しても接続できない場合の確認順
- ローカルの待ち受けを確認。ターミナルで
lsof -nP -iTCP:10808 -sTCP:LISTENを実行し、ポート番号をクライアントの現在の設定に置き換えます。結果が表示されたらプロセス名を確認してください。表示されない場合はv2rayNのログに戻り、コアが起動しているか、ポートのバインドに失敗していないか確認します。待ち受けが成功しても、リモートとのハンドシェイクが成功したとは限りません。 - ノードとのハンドシェイクを確認。ノードを一つ選び、リクエストを送信して、その時点のコアのログと照合します。接続がタイムアウトする場合はノードのアドレスとポートを確認します。ハンドシェイクエラーの場合は、サーバーが要求するトランスポート方式とセキュリティ設定を確認してください。ノード名だけで設定を判断したり、エラーを隠すために証明書検証を無効にしたりしないでください。
- アプリとルーティングを確認。ブラウザーでは通信できるのに特定のアプリだけ失敗する場合は、そのアプリがシステムプロキシを参照するか確認します。TUNモードでのみ失敗する場合は、ほかのVPNをいったん無効にし、ルートやDNSの競合を確認してください。LAN上のサービスだけに接続できない場合は、ルールによる振り分け、ローカルネットワーク権限、接続先デバイスの稼働状況を確認します。
- ネットワーク設定を元に戻す。確認が終わったら、まずTUNを無効にし、v2rayNでシステムプロキシを解除します。現在使用中のネットワークサービスの「プロキシ」画面を開いて設定を確認してください。組織のプロキシや手動プロキシを使っているデバイスでは、すべてを一律にオフにするのではなく、記録しておいた元の設定に戻します。