macOS版 v2rayNのインストール方法｜開発元を確認できない場合とネットワーク権限の設定

この記事のポイント

初回インストールでは、まずプロセッサのアーキテクチャに合ったパッケージを選び、Gatekeeperの警告に対処します。メイン画面が開いたら、ローカルプロキシでノードを確認してからシステムプロキシを設定し、必要に応じてTUNを有効にしましょう。アプリの起動許可、システムプロキシの変更権限、ネットワーク拡張の承認を分けて解説します。インストールを阻止された場合や、ブラウザーがプロキシを使わない場合、TUNを起動できない場合に役立つ内容です。

インストールパッケージの選び方：Appleシリコンはarm64、Intelはx64

v2rayNはノード、サブスクリプション、ルーティング設定を管理するデスクトップクライアントです。実際の接続処理は、クライアントが起動するプロキシコアが担います。パッケージのアーキテクチャは、メイン画面が開くかだけでなく、同梱されたコアが動作するかにも関わります。そのため、画面が表示されても実行環境全体が正常とは限りません。

「このMacについて」のプロセッサ情報に合わせて選ぶ

Appleシリコン搭載Mac

Appleメニューから「このMacについて」を開き、「チップ」欄を確認します。
Apple Mシリーズの場合は、macOS arm64版を選びましょう。
Rosettaに対応しているからといって、x64版を優先する必要はありません。コアや補助コンポーネントもアーキテクチャに対応している必要があります。

Intel Mac

「このMacについて」にIntelプロセッサの情報が表示されます。
macOS x64版を選びます。x86_64も同じ種類のアーキテクチャを示す表記です。
arm64版はIntel搭載Mac用の代替パッケージにはなりません。

アーキテクチャと最低システム要件は別々の条件です。適切なパッケージを選んだ後も、現在のリリースが要求するmacOSのバージョンを確認してください。

ダウンロードページからmacOS版を選びます。ディスクイメージを入手した場合は、アプリを「アプリケーション」フォルダにドラッグします。圧縮ファイルの場合は、すべて展開してからリリースノートに従ってアプリを配置してください。圧縮ファイルのプレビュー画面から直接実行したり、同じフォルダにある依存ファイルを残して本体だけをコピーしたりしないでください。更新前に旧バージョンを終了し、サブスクリプション、ルーティング、必要な設定をバックアップしておきましょう。

開発元を確認できない場合：入手元を確認してから許可する

「開発元を確認できない」または「Appleは、悪質なソフトウェアが含まれていないことを確認できませんでした」という警告は、通常Gatekeeperによる起動時のチェックです。ノードの不具合ではありません。サブスクリプションを何度も読み込み直しても解決しませんし、Mac全体のセキュリティ機能を無効にする必要もありません。まず入手元、ファイルが完全に展開されているか、警告に表示されたアプリ名を確認してください。

アプリの場所を確認する

Finderで「アプリケーション」フォルダを開き、インストールしたv2rayNを起動していることを確認します。ダウンロードフォルダにある古いコピーや、ディスクイメージ内のコピーではないことも確かめてください。
起動時のチェックを実行する

アプリをダブルクリックし、ブロックの警告を確認して閉じます。開発元の確認に失敗した場合、アーキテクチャに互換性がない場合、ファイルが破損している場合を見分けられるよう、警告の正確な文面を控えておきましょう。
セキュリティ設定を開く

Appleメニューから「システム設定」→「プライバシーとセキュリティ」を開き、下にスクロールして「セキュリティ」欄を確認します。ブロックされたアプリと「このまま開く」ボタンが表示されているか確認してください。
今回の起動だけを許可する

アプリ名を確認して「このまま開く」をクリックし、求められた場合は管理者認証を行います。続いて表示される確認画面でも「開く」を選択してください。完了したらアプリに戻り、メイン画面とログを確認します。

macOS 15以降では、未署名または未公証のソフトウェアを開く手順が厳格化されており、Finderで右クリックして「開く」を選ぶだけでは許可できない場合があります。ここでは「プライバシーとセキュリティ」に表示される確認画面を使います。旧バージョンでは設定項目の名称が異なることがあります。組織管理対象のMacでは操作が制限されている場合があるため、管理ポリシーを回避せず、デバイス管理者に相談してください。

まずローカルポートを確認し、次にブラウザーでシステムプロキシを使う

v2rayNが起動したら、まず信頼できるサブスクリプションを読み込み、サーバー一覧を更新してノードを選びます。ログでコアが起動したことを確認してください。メイン画面の「設定」→「パラメーター設定」でローカルのリスニング設定を確認します。項目名はバージョンによって異なります。リッスンアドレスとポートを確認してから、システムプロキシのトラブルを調べましょう。

10808

以下のコマンドで使うHTTPプロキシポートの例

10809

ポートが競合した場合に検討できる代替ポートの例

ここに示す2つのポート番号はトラブルシューティング用の例であり、すべてのリリースの既定値を示すものではありません。コマンドを実行する前に、ポート番号をパラメーター設定で実際に有効になっているHTTPまたは混合リスニングポートに置き換えてください。SOCKSしかリッスンしていない場合、以下のHTTPプロキシの指定方法は使えません。このMacだけで使う場合は、リッスンアドレスを127.0.0.1に設定してください。権限の問題を解決するために、すべてのネットワークインターフェイスで待ち受ける設定にするのは避けましょう。

# ポートのTCPリスナーが存在するか確認
lsof -nP -iTCP:10808 -sTCP:LISTEN

# macOSのシステムプロキシ設定に頼らずHTTPプロキシを明示
curl --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com

example.comは接続確認用のテスト先です。この結果だけで、すべてのサイトやルーティングルールが正常とは判断できません。接続が拒否された場合は、まずローカルでリッスンしているか確認します。プロキシのハンドシェイクエラーが出た場合は、ポートの種類を確認してください。ローカルプロキシへの接続後にタイムアウトする場合は、コアのログ、ノードのパラメーター、実際のアウトバウンド接続を確認します。ブラウザーが読み込み中のままという理由だけで、システム権限が不足していると判断しないでください。

プロキシを明示したコマンドは成功するのにブラウザーで失敗する場合：システムプロキシが現在のネットワークサービスに設定されているか、ブラウザー独自のプロキシ設定を使っていないか確認します。
プロキシを明示したコマンドも失敗する場合：TUNを追加する前に、コア、ノード、ルーティングを確認します。
ポートが別のプロセスに使われている場合：まずプロセスを特定し、競合するアプリを終了するかリッスンポートを変更します。変更後はシステムプロキシの設定も更新してください。

システムプロキシとTUN：用途に合わせて通信の処理方法を選ぶ

システムプロキシは仮想ネットワークインターフェイスではなく、この設定に従うアプリにのみ適用されます。TUNは仮想ネットワークインターフェイスとルーティングを使って通信を処理するため、通常はより高い権限が必要で、ほかのネットワークツールとの競合も起こりやすくなります。初めて設定する場合は、まず動作を確認しやすいシステムプロキシを使い、その後TUNが必要か判断しましょう。

まずはシステムプロキシ

必要な場合にTUNを有効にする

ノードが正常に動作することを確認してから、クライアントのTUNスイッチを使い、現在のバージョンの説明に従って権限昇格や補助サービスを設定してください。TUNで通信を処理する場合もルーティングルールは適用されるため、すべての接続がプロキシ経由になるわけではありません。

おすすめの用途：システムプロキシに従わないアプリを使う場合や、仮想ネットワークインターフェイスでより多くの通信を処理したい場合。

システムプロキシの設定は「システム設定」→「ネットワーク」→使用中のWi-FiまたはEthernet→「詳細」→「プロキシ」から確認できます。Webプロキシ、安全なWebプロキシ、SOCKSプロキシがそれぞれ有効か、アドレスとポートがクライアントの設定と一致しているか確認してください。手動で変更する前に元の値を記録しておきましょう。特に、組織のネットワークで必要な自動プロキシ設定を誤って削除しないよう注意してください。

# 現在のシステムプロキシの状態を確認
scutil --proxy

# ネットワークサービス名を一覧表示し、以降の確認では実際の名称を使う
networksetup -listallnetworkservices

# 以下ではWi-Fiという名前のサービスを例にする
networksetup -getwebproxy "Wi-Fi"
networksetup -getsecurewebproxy "Wi-Fi"
networksetup -getsocksfirewallproxy "Wi-Fi"

これらのコマンドは設定を変更しません。Wi-Fiの切り替え、ドッキングステーションの有線LANへの接続、ネットワークロケーションの変更などによって、使用中のネットワークサービスが変わることがあります。その場合はプロキシの状態を再確認してください。ターミナルのコマンドラインツールはmacOSのシステムプロキシ設定を自動で読み込むとは限りません。上記ではプロキシを明示するコマンドで確認し、ツールの動作をクライアントの不具合と誤認しないようにしています。

ネットワーク権限：ネットワーク拡張の承認とTUNの権限昇格は別

「ネットワークを許可する」という一つの設定ですべての問題を解決できるわけではありません。システムプロキシの変更、TUNインターフェイスの作成、ローカルネットワークへのアクセス、着信接続の受け入れ、ネットワーク拡張の読み込みは、それぞれ異なる仕組みで管理されています。v2rayNの実装はリリースやコアの組み合わせによって変わるため、TUNという表示だけを見てネットワーク拡張が必須だと判断しないでください。

警告・症状	確認場所	確認のポイント
プロキシの変更時に認証を求められる	クライアントの操作後にシステム認証画面が表示される	要求元が現在操作中のアプリであることを確認します。認証後、プロキシが実際に設定されたか確認してください。
TUNを作成できない、または権限が不足している	v2rayNのログと現在のバージョンの補助サービス設定	permission deniedやoperation not permittedなどのメッセージを確認し、リリースノートに従って権限を設定します。
ネットワーク拡張の承認画面が実際に表示される	macOS 15の「システム設定」→「一般」→「ログイン項目と機能拡張」→「ネットワーク機能拡張」	インストールしたコンポーネントに対応する項目だけを確認してください。ほかのバージョンでは「プライバシーとセキュリティ」に承認項目が表示される場合があります。
ローカルネットワーク上のデバイスに接続できない	この項目があるmacOSでは、「プライバシーとセキュリティ」→「ローカルネットワーク」	この権限はローカルネットワークへのアクセスを制御するもので、インターネットプロキシの許可とは異なります。TUNの権限昇格の代わりにもなりません。
着信接続を許可するか確認される	「システム設定」→「ネットワーク」→「ファイアウォール」→「オプション」	着信接続の許可は通常のアウトバウンドプロキシとは別の設定です。このMacだけで使う場合は、これを理由にリッスン範囲を広げないでください。

TUNを有効にする前に、デフォルトルート、DNS、仮想ネットワークインターフェイスを変更するほかのネットワークツールを一時的に終了し、通信を処理する経路は一度に一つだけにしてください。システム認証後も失敗する場合は、パスワードを何度も入力するのではなく、起動直後のエラーと前後のログを保存します。組織のポリシーで制限されたデバイスでは、管理者の許可やアプリ内設定で管理ポリシーの承認を代替することはできません。

終了とアップデート：残ったプロキシ設定と構成の移行を確認

終了後にネットワークへ接続できなくなる原因として、システムプロキシが停止したローカルポートを指したままになっているケースがよくあります。通常は、終了前にクライアントでシステムプロキシを解除し、TUNをオフにしてからアプリを終了してください。アプリが異常終了した場合は、システム設定で現在のネットワークサービスのプロキシ項目を確認し、変更前に記録した状態に戻します。自動プロキシを使うネットワークでは、自動プロキシ設定が変更されていないかも確認してください。

メイン画面が開かない：システム警告の正確な文面を記録し、アーキテクチャ、最低システム要件、Gatekeeperによる許可状態を再確認します。
メイン画面は開くがコアが終了する：コアのアーキテクチャ、実行権限、設定エラー、ポートの競合を確認します。まずログを保存し、必要に応じてインストールパッケージを展開し直してください。
プロキシを指定したコマンドは成功するのにアプリは失敗する：アプリがシステムプロキシに従うか、独自のプロキシ設定があるかを確認してから、TUNに切り替えるか判断します。
TUNの有効化後にドメインへ接続できない：DNSとルーティングのログから名前解決の経路を確認します。名前解決の失敗をすべて権限不足と判断しないでください。
アップデート後に動作が変わった：アップデート前後のリッスンポート、選択中のコア、ルーティング設定を比較します。確認せずに古いファイルで新しい設定一式を上書きしないでください。

トラブルシューティングの記録には、macOSのバージョン、プロセッサのアーキテクチャ、v2rayNのバージョン、使用中のコア、現在のプロキシモード、エラーが発生した時刻を含めてください。ログを共有する前に、サブスクリプションURL、ノードのパスワード、ユーザー識別情報などの機密情報を削除します。こうすれば、インストールのブロック、コアの起動失敗、ルーティングの問題を切り分けやすくなります。一度に複数の設定を変更して比較できなくなる事態も避けられます。