macOSでv2rayNをインストールする方法｜「開発元を確認できません」の対処とネットワーク権限設定

プロセッサのアーキテクチャとアプリの保存場所を確認

Appleメニューから「このMacについて」を開きます。Appleチップ搭載のMacではARM64版、Intelプロセッサ搭載のMacではx64版を選んでください。v2rayNのmacOS版とWindows版は共用できません。アプリの画面が起動しても、同梱されたコアのアーキテクチャが適切とは限りません。必要なmacOSのバージョンは、選択したリリースパッケージの説明を確認してください。

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

   Appleメニューから「このMacについて」を開き、「チップ」または「プロセッサ」を確認します。「ターミナル」でuname -mを実行する方法もあります。ネイティブ環境では通常、arm64またはx86_64と表示されます。Rosetta経由で動作するターミナルでは結果が異なる場合があるため、システム情報での確認を優先してください。

2. インストールパッケージを選ぶ

   当サイトのダウンロードページで、macOS用の適切なアーキテクチャのv2rayNを選びます。ダウンロードしたファイルはそのまま保管し、内容をすべて展開してください。ディスクイメージの場合は開いて、アプリを「アプリケーション」フォルダにコピーします。

3. アプリの保存場所を固定する

   初回起動の前に、アプリを固定の場所に保存します。マウントしたディスクイメージから使い続けたり、アプリパッケージ内の実行ファイルだけを取り出したりしないでください。

4. 初回起動

   Finderの「アプリケーション」からv2rayNを開き、警告の正確な文言を確認します。開発元の確認に関する警告、アプリが破損しているという警告、コアの実行エラーを区別してから次の手順に進んでください。

この記事では「システム設定」というメニュー名を使います。古いmacOSでは「システム環境設定」と表示される場合があります。v2rayNの設定項目はバージョンによって変わることもあります。ポートやTUNの設定では、インストール中のバージョンに表示される項目を確認し、他のプラットフォームの画面で見た手順をそのまま当てはめないでください。

「開発元を確認できません」という警告と初回起動のブロックに対処

Gatekeeperはアプリの配布元に対する信頼性を確認します。「開発元を確認できません」と表示されても、サーバーへの接続失敗を意味するわけではなく、サブスクリプションの変更で解決する問題でもありません。ダウンロード元とファイルが正しいことを確認したうえで、そのアプリだけを許可してください。

1. 警告の内容を確認

   初回起動がブロックされたら、まず警告を閉じます。表示されているのが、ダウンロードしたv2rayNであることを確認してください。同じ名前の古いコピーや、見覚えのない補助プログラムではないかも確かめます。

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

   Appleメニューから「システム設定」→「プライバシーとセキュリティ」を開き、下にスクロールして「セキュリティ」を確認します。直前にブロックされたアプリについての説明が表示されていることがあります。

3. 対象アプリだけを許可

   システムに許可され、入手元も確認できている場合は、アプリの横にある「このまま開く」をクリックします。画面の指示に従って管理者認証を行い、起動を確認してください。ボタンの表記はmacOSのバージョンによって多少異なります。

4. アプリを再度起動

   「アプリケーション」に戻り、同じコピーを起動します。許可するボタンが表示されない場合は、もう一度アプリを開いてから再確認してください。管理対象のMacでは、組織のセキュリティポリシーで許可が制限されていないかも確認します。

クライアントをインストールするためにMac全体のGatekeeperを無効にしたり、「ダウンロード」フォルダ全体から隔離属性を削除したりしないでください。許可しても起動できない場合は、アプリを終了して問題のあるコピーを削除し、アーキテクチャに合った完全なリリースパッケージを再ダウンロードしましょう。出どころのわからないターミナルコマンドを次々に試すより、原因を絞り込みやすくなります。

まずシステムプロキシを確認し、必要ならTUNを有効にする

v2rayNの画面、プロキシコア、システムのネットワーク設定はそれぞれ別の層です。画面が開くのはアプリが起動できたことを示すだけです。コアがローカルポートで待ち受けて初めて、アプリから利用できるプロキシの接続先ができます。さらにシステムプロキシが正しく設定されていれば、その設定に従うアプリが接続先を利用します。

サブスクリプションをインポートしてサーバーを選んだら、まずTUNを無効のままにします。v2rayNの「システムプロキシ」メニューから「システムプロキシを自動設定」を選んでください。ここでの「自動設定」が必ずPACを使うとは限りません。実際に設定されたHTTP、HTTPS、SOCKSプロキシの項目をシステム側で確認します。

• 「システム設定」→「ネットワーク」→現在使用中のWi-FiまたはEthernet→「詳細」→「プロキシ」を開きます。
• 有効になっているプロキシのサーバーアドレスとポートを確認します。ローカルプロキシを使う場合、アドレスは通常127.0.0.1です。ポートはv2rayNが現在待ち受けている値と一致している必要があります。
• クライアントからネットワーク設定の変更を求められた場合は、要求元を確認してから認証します。許可を取り消した場合や、ネットワークサービスを切り替えた場合、または別のプロキシアプリに設定を上書きされた場合は、変更が反映されないことがあります。
• 外部への接続を直すために、macOSのファイアウォールを安易に無効にしないでください。受信接続の制御と、Mac上で送信プロキシを設定する問題は別です。

ポートとコマンドで権限の問題を切り分ける

以下では、ローカルHTTPプロキシの例としてポート10808を使います。すべてのバージョンの既定ポートとは限りません。まずv2rayNの「設定」→「パラメーター設定」で、ローカルの待ち受けポートとプロトコルを確認してください。現在のバージョンでメニューの場所が異なる場合は、該当するローカル受け入れ設定を確認します。

scutil --proxy
lsof -nP -iTCP:10808 -sTCP:LISTEN
curl -I --connect-timeout 15 --max-time 30 --proxy http://127.0.0.1:10808 https://example.com/

scutil --proxyは現在のプロキシ設定を確認するコマンドです。lsofではローカルのTCP待ち受けを確認できます。待ち受けが見つからない場合は、コアのログに起動失敗、アーキテクチャの不一致、アドレスの競合がないかを先に調べてください。システムプロキシの権限設定を繰り返し試す必要はありません。ポートが待ち受け中でもHTTPを受け付けるとは限らないため、受け入れプロトコルも確認します。

ローカルポートがSOCKSのみを提供している場合は、テスト時に--proxy socks5h://127.0.0.1:10808を使い、実際のSOCKSポートに置き換えてください。socks5hは接続先のドメイン名の解決をプロキシ側に任せる指定です。Mac上での名前解決結果と混同しないでください。

必要に応じてTUNとネットワークアクセスの権限を付与する

通常のプロキシ接続が成功してから、クライアントの「TUNを有効にする」を試します。仮想ネットワークインターフェースの作成、ルートの変更、関連する補助サービスの有効化には、管理者権限が必要な場合があります。具体的な動作はv2rayNのバージョンや使用するTUNコンポーネントによって異なるため、毎回同じシステムダイアログが表示されるとは限りません。

• 起動ログを確認：TUNを有効にした際に最初に表示されるエラーを記録します。権限不足、インターフェースの作成失敗、DNSのタイムアウトは分けて対処してください。
• 認証要求を確認：システムから管理者認証を求められたら、操作の時刻と要求元のプログラムを確認します。サブスクリプションのパスワードやサーバーの認証情報を、システムの認証画面に入力しないでください。
• 表示された要求に応じて設定：VPN構成やネットワーク機能拡張の要求が実際に表示された場合に限り、「システム設定」→「ネットワーク」→「VPNとフィルタ」など、該当する項目を確認します。新しいmacOSでは「一般」→「ログイン項目と機能拡張」で機能拡張を管理する場合もあります。
• ローカルネットワークの許可と区別：macOS 15以降では、「プライバシーとセキュリティ」→「ローカルネットワーク」でLANへのアクセスを管理します。これはインターネット全体へのアクセスを制御する設定ではありません。アプリが一覧に表示されないからといって、TUNの権限に問題があるとは限りません。
• 通信の重複制御を避ける：デフォルトルート、DNS、システムプロキシを変更する他のツールを一時的に停止し、v2rayNだけで動作を確認します。複数のTUN方式を同時に実行してテストしないでください。

ログイン項目を設定し、終了後に設定が戻るか確認

ログイン時の起動、バックグラウンド動作、TUNの許可はそれぞれ別の設定です。v2rayNをログイン項目に追加しても、ユーザーのログイン後にアプリの起動が試みられるだけで、サーバーの自動選択、システムプロキシの設定、TUNの確立までは保証されません。これらの動作は、クライアントの起動オプションやシステム権限にも左右されます。

1. ログイン項目に追加

   「システム設定」→「一般」→「ログイン項目」を開きます。バージョンによっては「ログイン項目と機能拡張」と表示されます。「ログイン時に開く」にある追加ボタンから、「アプリケーション」フォルダ内のv2rayNを追加してください。

2. 二重起動を避ける

   クライアントの起動時に開く設定をすでに使っている場合は、システムの一覧に登録済みか確認します。起動方法は明確なものを一つだけ残し、古いパスと新しいパスを重複して登録しないでください。

3. バックグラウンド項目を確認

   現在のバージョンで関連する補助項目が実際にインストールされている場合に限り、「バックグラウンドでの実行を許可」の一覧で名前と入手元を確認します。該当項目がなくても、アプリのインストールが不完全とは限りません。

4. 終了後の動作をテスト

   ウィンドウを閉じるだけでなく、メニューからアプリを終了します。システムプロキシが元に戻っているか確認してください。その後Webに接続できなくなった場合は、「ネットワーク」→現在のネットワークサービス→「詳細」→「プロキシ」に戻り、残っているローカルプロキシ設定を削除します。

最後に一度ログアウトして再度ログインし、固定した場所にあるアプリが起動すること、コアが待ち受けること、システムプロキシまたはTUNが想定どおり動作することを確認します。スリープから復帰した後に動かなくなった場合も、待ち受け、プロキシ設定、DNSの順に確認してください。Macの再起動だけを唯一の対処法にしないでください。

よくある警告と対処できる範囲

トラブルシューティングの記録として残すのは、macOSのバージョン、v2rayNのバージョン、プロセッサのアーキテクチャ、エラーの発生時刻、個人情報を伏せたエラー行だけで十分です。ログを共有する前に、サブスクリプションのURL、サーバーの認証情報、ネットワークを特定できる情報を削除してください。サブスクリプションのインポートやルーティングの基本は、当サイトの入門ガイドと応用ガイドをご覧ください。