Macにv2rayNを初めてインストールするときは、チップに合ったパッケージを選び、システムの警告に応じて必要な許可を設定します。メイン画面が開いたら、まずシステムプロキシを確認し、必要に応じてTUNをテストしましょう。アプリの起動、プロキシコア、システムのネットワーク設定を切り分けてトラブルを確認できます。
AppleシリコンとIntel:アーキテクチャに合ったインストーラーを選ぶ
Appleメニュー「」→「このMacについて」を開きます。「チップ」にApple Mシリーズの名称が表示されていればARM64、「プロセッサ」にIntelの名称が表示されていればx64を選びます。どちらの場合も、配布パッケージに記載された最低macOSバージョンを確認してください。チップの種類が合っていても、OSのバージョンが要件を満たすとは限りません。
ARM64ネイティブ版
おすすめAppleシリコン搭載Macでは、ARM64またはarm64と記載されたmacOS版を選んでください。初回起動時にRosettaのインストールを求められた場合は、ダウンロードしたファイルと使用するコアのアーキテクチャを確認しましょう。
対象:Appleシリコン搭載Mac
x64ネイティブ版
Intel Macではx64またはx86_64版を選びます。ARM64版はIntel Macでは動作しません。プライバシー設定を変更しても、アーキテクチャの不一致は解消できません。
対象:Intelプロセッサ搭載Mac
ディスクイメージをダウンロードした場合は、イメージを開いてv2rayNアプリを「アプリケーション」にドラッグし、イメージを取り出してから「アプリケーション」内のアプリを起動します。圧縮ファイルの場合は、完全に解凍してから配布元の説明に従ってアプリを移動してください。圧縮ファイルのプレビューから直接起動したり、パッケージ内のコアファイルだけを別の場所に移動したりしないでください。
Gatekeeperの警告:「このまま開く」はどこにある?
「開発元を検証できません」という警告は、起動時にmacOSが行う確認です。サブスクリプション、ノード、ネットワーク権限とは関係ありません。ソフトウェアの入手先が信頼でき、正規の配布パッケージであることを確認し、デバイスの管理ポリシーで許可されている場合に限り、このアプリだけを例外として許可してください。「コンピュータに損害を与える」またはマルウェアが検出されたという警告が表示された場合は起動を中止し、入手先を再確認してください。通常の開発元確認の警告として扱わないでください。
「アプリケーション」から起動する
Finderで「アプリケーション」を開き、v2rayNをダブルクリックします。警告が表示されたら、アプリ名と警告の文面を控えてから閉じてください。別のアプリを誤って許可しないよう、まず名前を確認します。
セキュリティ設定を開く
macOS 13以降では、「」→「システム設定」→「プライバシーとセキュリティ」を開き、「セキュリティ」までスクロールします。ブロックされた直後に確認してください。この項目は直近の起動試行に対するもので、常に表示されるわけではありません。
アプリごとに許可する
「セキュリティ」欄にv2rayNが表示されていることを確認し、「このまま開く」をクリックします。画面の指示に従って認証し、確認ダイアログで「開く」を選択してください。管理対象のデバイスでこの項目が表示されない場合は、管理者に相談してください。セキュリティ設定全体は変更しないでください。
起動結果を確認する
メイン画面が表示されたら、サブスクリプションとプロキシを設定します。画面は開くもののログにコアの起動失敗が記録される場合、問題はアプリの起動許可ではありません。エラー内容に応じて、コアのアーキテクチャ、ファイルの不足、ポートの競合を確認してください。
システムプロキシ:ローカルの待受設定とネットワークサービスを確認
まずTUNを無効にし、利用可能なノードを1つ選びます。v2rayNの「設定」→「パラメータ設定」でローカルの待受設定を確認し、メイン画面の「システムプロキシ」で「システムプロキシを自動設定」を選びます(ボタンの位置はバージョンによって異なる場合があります)。以下の数値はアドレスとポートの確認例であり、すべてのバージョンの初期値を示すものではありません。
- 現在の接続を確認します。「システム設定」→「ネットワーク」で、使用中の接続を選びます。Wi-Fiの場合は、「Wi-Fi」→接続中のネットワークの「詳細」→「プロキシ」と進みます。有線接続では、該当するEthernetサービスを確認してください。接続先を切り替えた後、以前のサービスにプロキシが設定されていても、新しいサービスに設定済みとは限りません。
- プロキシの種類を合わせます。有効になっているWebプロキシまたはSOCKSプロキシのアドレスとポートを確認し、実際の待受プロトコルと照合します。SOCKS専用ポートをHTTPプロキシに設定しないでください。バージョンが混合待受を使用している場合は、その待受が実際に対応するプロトコルを確認します。
- ブラウザーからのリクエストを確認します。システムプロキシ設定に従うブラウザーで、アクセス可能と分かっているWebページを開き、v2rayNのログに新しいリクエストが記録されるか確認します。リクエストは届くのに接続できない場合は、ノードとルーティングを優先して確認してください。リクエストがまったく届かない場合は、ブラウザー独自のプロキシ設定が使われていないか、現在のネットワークサービスでプロキシが有効かを確認します。
システムプロキシを有効にする前に、既存の手動プロキシ設定や自動構成URLを控えておきます。テスト後は、まずv2rayNでクライアントが設定したシステムプロキシを解除し、アプリを終了して、元の設定に戻っていることを確認してください。戻さないと、ブラウザーが待受を停止したローカルポートへ接続し続ける場合があります。
TUNとネットワーク拡張:必要な機能だけを許可する
システムプロキシは、プロキシ設定に従うアプリで使います。TUNは仮想インターフェースとルーティングを使って通信を処理するため、システムプロキシ設定を参照しないアプリの確認に適しています。TUNとネットワーク拡張は同じものではありません。バージョンによっては管理者の許可や特権ヘルパーが必要になるほか、VPN構成やネットワーク拡張の許可をmacOSから求められる場合があります。拡張機能の警告が表示されなくても、インストール手順が不足しているとは限りません。
- まずシステムプロキシモードでノードが使えることを確認します。TUNをテストするときは、今回設定したシステムプロキシを解除し、必要なネットワーク管理設定は残したうえで、TUNだけを有効にします。どの経路で通信しているか混同しないためです。
- VPN構成の追加やネットワーク拡張の許可を求められた場合は、警告に表示されたアプリ名と、直前に自分で実行した操作を確認してください。macOS 15では、「システム設定」→「一般」→「ログイン項目と機能拡張」→「ネットワーク機能拡張」で関連項目を確認できます。現在のバージョンでその拡張機能が実際に使われており、項目と警告の内容が一致する場合に限り有効にしてください。管理者の確認が必要な場合は、権限を持つアカウントでシステムダイアログから許可します。
- 有効にしたら、WebページとLAN内のリソースにアクセスできるか試し、ログにインターフェース作成、DNS、ルーティングのエラーがないか確認します。社内リソースに接続できなくなった場合は、まずTUNを無効にして元の接続に戻ることを確認し、既存のVPN、サブネットのルート、企業ポリシーとの競合を調べます。ルーティングの修正とノードの変更を同時に行わず、一度に一つずつ変更してください。
初回起動とネット接続のトラブルシューティング
「このまま開く」が表示されない場合
「アプリケーション」からv2rayNをもう一度起動し、ブロックの警告を閉じたら、すぐに「プライバシーとセキュリティ」の最下部を確認します。アーキテクチャ非対応やmacOSのバージョン不足が原因の場合は、パッケージの要件に合う版を選び直してください。デバイス管理ポリシーによる制限の場合は、管理者に対応を依頼します。
サブスクリプションの更新に成功したのにWebページを開けないのはなぜ?
サブスクリプションの更新成功は、サブスクリプションURLにアクセスして設定を取得できたことを示すだけで、選択したノードが使えることを意味しません。対象のノードを選び、コアのログで待受状態を確認してから、現在のネットワークサービスの「プロキシ」画面でポートを照合します。リクエストがログに記録されていてハンドシェイクに失敗する場合は、ノード設定を確認してください。アプリの許可をやり直す必要はありません。
v2rayNを終了したらブラウザーがネットにつながらなくなった場合
現在のネットワークサービスで、Webリクエストの送信先がループバックアドレスのままになっていないか確認します。今回のテストで設定したプロキシが残っている場合は、v2rayNを再起動してシステムプロキシを解除してから終了するか、ネットワーク設定で事前に控えた値に戻してください。TUNを使った場合は、TUNも無効になっていることを確認します。