v2rayNをmacOSにインストールする方法｜開発元未確認の警告とネットワーク権限の設定

インストーラーの選び方とアプリの配置

画面左上のAppleメニューから「このMacについて」を開きます。「チップ」にApple製チップの型番が表示される場合はmacOS ARM64、「プロセッサ」にIntelの型番が表示される場合はmacOS x64を選択してください。ファイルサイズからアーキテクチャを判断したり、Windows用インストーラーをmacOSアプリとして起動したりしないでください。

インストール前に「このMacについて」でmacOSのバージョンを確認し、選んだリリースの最低システム要件と照らし合わせましょう。OSのバージョン不足とGatekeeperによるブロックは別の問題です。「このアプリケーションはこのMacでは使用できません」と表示されても、セキュリティ設定の許可が必要とは限りません。まずアーキテクチャとシステム要件を確認し、警告の全文を読みましょう。

1. アーキテクチャを確認

   Appleメニューから「このMacについて」を開き、チップ情報に応じてARM64またはx64を選択します。ダウンロード先はサイト内のダウンロードページをご覧ください。

2. ディスクイメージを開く

   ダウンロードしたDMGファイルをダブルクリックし、開いたディスクウインドウでv2rayNアプリを探します。イメージをマウントできない場合は再ダウンロードしてください。すぐにシステムのセキュリティ設定を変更する必要はありません。

3. アプリケーションへ移動

   v2rayNをFinderの「アプリケーション」フォルダへドラッグします。コピーが終わったらディスクイメージを取り出し、「アプリケーション」から起動してください。

4. 情報を記録

   アプリの「バージョン情報」に表示されるバージョン、macOSのバージョン、インストーラーのアーキテクチャを記録しておきましょう。問題が起きたとき、「開けない」とだけ伝えるより、原因を特定しやすくなります。

アプリをディスクイメージやダウンロードフォルダから常用しないでください。インストール先を固定すると、アップデートや権限の認識、ログイン項目の管理がしやすくなります。アップデート前に旧バージョンを終了してください。旧バージョンでTUNを有効にしていた場合は、TUNを無効にしてシステムプロキシを解除してからアプリを置き換えましょう。

「開発元を検証できません」と表示された場合の許可方法

Gatekeeperによる確認はアプリの起動時に行われます。「開発元を検証できません」や「悪意のあるソフトウェアが含まれていないことを確認できません」と表示された段階では、通常、コアはまだポートの待ち受けを開始していません。ノードやサブスクリプション、DNSを変更しても起動ブロックは解消しません。

1. アプリを起動

   「アプリケーション」フォルダでv2rayNをダブルクリックし、ブロックの警告を確認して閉じます。配布元を確認できているアプリに限り、次の手順へ進んでください。

2. セキュリティ設定を開く

   Appleメニューから「システム設定」→「プライバシーとセキュリティ」の順に開き、「セキュリティ」欄まで下へスクロールして、直前にブロックされたアプリの記録を確認します。

3. 今回のみ許可

   記録に表示されたアプリ名を確認し、「このまま開く」をクリックします。求められた場合は管理者認証を行い、次の確認ダイアログで「開く」を選択してください。

4. もう一度確認

   「アプリケーション」フォルダに戻り、アプリを再度起動します。該当する記録がない場合は、もう一度起動してブロックを発生させてから確認してください。組織管理下のデバイスでは、管理者に相談しましょう。

macOSのバージョンによって、Finderで右クリックして「開く」を選んだ場合の動作は異なります。必ず有効な方法とは限らないため、「プライバシーとセキュリティ」に表示される明示的な許可記録を優先してください。組織管理下のデバイスでは「このまま開く」がポリシーで無効になっている場合があります。管理者パスワードを何度入力しても、管理ポリシーを回避することはできません。

システムプロキシとTUN：通信の制御方法を選ぶ

v2rayNの画面が開いても、すべてのアプリの通信がプロキシ経由になるとは限りません。システムプロキシは、現在のネットワークサービスにプロキシの接続先を設定する機能ですが、各アプリがその設定に従うかはアプリの実装によります。TUNは仮想ネットワークインターフェースを通じて通信を制御し、ルーティングやDNS、権限にも関わります。最初の切り分けでは、2つの方式を別々に確認しましょう。

クライアントがネットワーク設定の変更を求めた場合は、該当する操作を直前に行っており、認証ダイアログに対象アプリまたは既知のコンポーネントが明記されている場合に限り許可してください。通常のシステムプロキシ設定はネットワーク拡張のインストールとは別のもので、インターネット接続のために「フルディスクアクセス」や「アクセシビリティ」を許可する必要はありません。

• システムプロキシを確認するには、「システム設定」→「ネットワーク」→接続中のWi-FiまたはEthernet→「詳細」→「プロキシ」の順に開きます。HTTP、HTTPS、SOCKSに設定されているアドレスとポートを記録してください。
• ローカルアドレスを確認：本機のプロキシには通常 127.0.0.1 を使用します。ポートはv2rayNが実際に待ち受けている番号と一致させてください。解説に記載された数値をそのまま入力するのは避けましょう。
• 終了前に設定を戻す：v2rayNで「システムプロキシを解除」を選んでから、クライアントを終了します。アプリが異常終了した場合は、上記のシステム設定画面で本機を指すプロキシ設定が残っていないか確認し、解除してください。

ネットワーク拡張とネットワーク権限の見分け方

「ネットワーク拡張」「VPN構成」「ローカルネットワーク」と管理者認証は、それぞれ別の権限です。まずシステムの警告に記載された権限の種類を確認し、該当する設定を開いてください。v2rayNはリリース版や実行方式によって通信の制御方法が異なる場合があります。システムプロキシだけを使う場合、ネットワーク拡張の警告が表示されないのは正常なことがあります。

「VPN構成を追加」という警告が表示された場合は、アプリ名を確認してから許可するか判断してください。許可後はシステム設定で「VPN」を検索し、関連する項目を確認できます。通常のプロキシ接続のトラブルを調べるために、起動時のセキュリティ設定を弱めないでください。TUNの有効化後に通信できなくなった場合は、まずTUNを無効にしてシステムプロキシを解除し、通常のネットワーク接続が戻ることを確認します。その後、クライアントのログで権限、ルーティング、DNSのエラーを確認してください。

• 許可ダイアログが表示されない：アプリのウインドウを起動しただけではなく、追加権限が必要な機能を本当に有効にしたか確認してください。
• 許可しても解決しない：アプリを終了して再起動し、コアのログを確認してください。「権限が不足しています」と「アドレスがすでに使用されています」では対処方法が異なります。
• システムから再起動を求められた：作業内容を保存し、案内に従って再起動してください。クライアントを再起動するだけでは、システムコンポーネントの承認が完了しない場合があります。

初回起動後の接続確認

権限の設定が終わったら、まず動作確認済みの設定をインポートします。v2rayNで「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、名前とサブスクリプションURLを追加して保存します。その後、「サブスクリプショングループ」メニューから更新してください。メニュー名はバージョンによって多少異なりますが、先にグループを保存してからサブスクリプションを取得するのがポイントです。URLを保存しただけでは、ノードが正常にインポートされたことにはなりません。

VMessとVLESSは設定に使うプロトコル名であり、macOSの権限の種類ではありません。サブスクリプションURLは設定一覧の取得に使い、個別の共有リンクは1つの設定を示します。それぞれ対応するインポート方法を使ってください。サブスクリプションに含まれるTLS、SNI、通信方式、パスは元の値を保ち、インストールの問題を切り分けるために変更しないでください。

1. まず一覧を確認：更新後、設定が一覧に表示されることを確認します。一覧が空の場合は、サブスクリプションの応答、グループのフィルター、更新ログを確認してください。先にネットワーク拡張を許可する必要はありません。
2. 次にコアを確認：設定を選択してアクティブサーバーにし、ログにコアの起動失敗、ファイル不足、ポートの競合が記録されていないか確認します。画面上の稼働表示だけで判断せず、ログも確認してください。
3. 待ち受けポートを確認：「設定」→「パラメーター設定」でローカルの待ち受けポートに関する項目を確認し、システムのネットワークプロキシ設定と照合します。以下のコマンドにある 10808 は確認用の例です。実行前に実際のポート番号へ置き換えてください。
4. 接続を確認：まずシステムプロキシ経由で普段利用できるHTTPSサイトにアクセスし、対応する接続ログが記録されるか確認します。遅延テストに成功しても、すべてのアプリがプロキシを利用しているとは限りません。

lsof -nP -iTCP:10808 -sTCP:LISTEN
scutil --proxy

1つ目のコマンドで、指定したTCPポートをプロセスが待ち受けているか確認できます。出力されたプロセス名とPIDは使用中のプロセスの特定に役立ちます。何も表示されない場合は、まずポート番号が正しいか確認し、その後コアが起動しているか調べてください。2つ目のコマンドでは、現在のシステムプロキシ設定を確認できます。実際に表示される HTTPEnable、HTTPSProxy、HTTPSPort などの項目を確認してください。スイッチが1になっているかだけでなく、アドレスとポートの組み合わせも照合しましょう。

インストールと権限に関するよくある質問