v2rayNを初めてインストールする方や、Macの買い替え後に再設定する方向けです。インストールパッケージのアーキテクチャ、Gatekeeperの警告、ローカル待ち受け、システムプロキシ、ネットワーク権限の順に確認します。まず問題の箇所を切り分けてから、再インストールやプロキシ設定の変更、権限の確認を行いましょう。
v2rayNのインストールと初回起動時の警告への対処
プロセッサを確認する
Appleメニューから「このMacについて」を開きます。Appleシリコン搭載Macはarm64版、Intelプロセッサ搭載Macはx64版を選びます。ダウンロードページに記載されたシステム要件も確認してください。アーキテクチャの不一致による起動エラーは、ネットワーク権限を変更しても解決しません。
アプリケーションフォルダに移動する
アーカイブ形式のファイルは先に展開し、ディスクイメージは開いてから、v2rayNアプリをFinderの「アプリケーション」フォルダにドラッグします。コピーが完了したら、そのフォルダからアプリを起動してください。ダウンロードフォルダやディスクイメージ内にある別のコピーから起動しないようにします。アップデート前に旧バージョンを終了し、必要な設定をバックアップしてください。
警告の文言を確認する
「開発元を検証できません」という警告は、macOSが開発元の信頼性を確認できなかったことを示すもので、ノードの接続テスト結果ではありません。警告に表示されたアプリ名が、「アプリケーション」フォルダに移動したものと一致するか確認してください。入手元が不明な場合や、「コンピュータに損害を与える可能性があります」と表示された場合は起動せず、提供元が明確なパッケージを入手してください。
アプリごとの選択肢を確認する
macOS 13以降では、Appleメニューから「システム設定」→「プライバシーとセキュリティ」を開き、「セキュリティ」までスクロールします。起動がブロックされた後、そのアプリに対して「このまま開く」が表示されることがあります。配布元を確認し、対象のアプリを特定でき、デバイスのポリシー上も許可されている場合に限り、この項目を選択して認証を完了し、アプリを開いてください。この例外は対象アプリにのみ適用され、Mac全体のセキュリティ設定を変更する必要はありません。
macOS 15以降では、FinderでControlキーを押しながらクリックして「開く」を選ぶ方法で、署名や公証のチェックによるブロックを回避することはできません。「このまま開く」が表示されない場合は、直近のブロック対象が現在インストールされているアプリか確認してください。組織管理下のMacではこの選択肢が制限されていることがあります。全体設定を変更せず、管理者にポリシーを確認してもらいましょう。
Gatekeeper、プロキシ、ネットワーク権限を切り分ける
表示内容から問題の箇所を見分ける
おすすめメインウィンドウが表示されない場合は、まずシステムの警告を確認します。ウィンドウは表示されるもののコアが終了する場合は、v2rayNのログを確認してください。コアが待ち受けているのにブラウザーが接続できない場合は、プロキシのアドレスとポートを確認します。変更は一度に一項目ずつ行い、変更前の値を記録しておきましょう。
対象:初回インストール、アップデート後の不具合、Macの買い替え後の移行
既存のシステムプロキシ設定を維持する
職場のネットワークでプロキシや自動プロキシ設定を使用している場合は、まず既存の設定を維持してください。プロキシを個別に設定できるテスト用アプリにv2rayNの実際の待ち受けアドレスを入力すると、コアの問題とシステムプロキシ設定の競合を切り分けられます。
対象:既存のプロキシ設定を維持したい場合、特定のアプリだけで動作を確認したい場合
システムプロキシは、アプリが参照できるプロキシ設定であり、すべての通信を自動的に経由させるものではありません。アプリ独自のプロキシ設定を使っている場合や、直接接続している場合は、システムプロキシを変更しても接続経路が変わらないことがあります。v2rayNのルーティングルールが適用されるのは、コアに届いたリクエストです。ルーティングを変更しても、もともと直接接続しているアプリが自動的にローカル待ち受けを使うわけではありません。
待ち受けポートとmacOSのシステムプロキシを確認する
まずv2rayNの「設定」→「パラメーター設定」でローカル待ち受けの設定を確認し、コアの起動ログと実際の待ち受け状態を基準にしてください。フィールド名や待ち受け方法、ポートはバージョンによって異なる場合があります。古い記事にSOCKS用とHTTP用のポートが別々に書かれていても、そのままシステム設定に入力しないでください。混合インバウンドを使用するバージョンでは、実際の設定を確認し、同じポートで両方のプロトコルを受け付けるか判断します。
ローカル待ち受けの確認
- サーバー
- このMac上でのテストには
127.0.0.1を使用 - ポート
- 現在の設定と起動ログを確認
- プロトコル
- HTTP、SOCKS、混合インバウンドを区別する
- 状態
- コアプロセスが実行中か確認
ポートが待ち受け状態でも、プロセスがそのポートを使用していることしか分かりません。リモートノードに接続できることの証明にはなりません。
システムプロキシの確認
- 設定画面
- 「システム設定」→「ネットワーク」
- サービス
- 現在使用中のWi-FiまたはEthernet →「詳細」→「プロキシ」
- プロキシの種類
- ローカルのインバウンドプロトコルに合わせる
- サーバーとポート
- ローカルの待ち受け先を入力。リモートのサブスクリプションノードは入力しない
変更前に、手動プロキシ、自動プロキシ設定、例外項目の現在値を記録しておくと、後から元に戻せます。
v2rayNで「システムプロキシを設定」を選択したら、現在接続中のネットワークサービスに戻り、実際に設定が反映されたか確認します。別のネットワークアダプターに切り替えた後、アプリがプロキシを経由しなくなった場合は、新しいサービスの設定を確認してください。コアのログに address already in use と表示される場合は、以下のコマンド例をターミナルで実行して、ポートを使用しているプロセスを確認できます。例のポート番号は、ログに表示された番号に置き換えてください。
lsof -nP -iTCP:10808 -sTCP:LISTEN
ポートを使用しているプロセスを確認してから、旧インスタンスを終了するか、現在のインスタンスのポートを変更するか決めます。ポートを変更した場合は、旧ポートを参照しているシステムプロキシやアプリごとのプロキシ設定も更新してください。v2rayNの終了後にWebページを開けなくなった場合は、システムプロキシが停止済みのループバックポートを参照していないか確認します。もともと職場のプロキシを使用していた場合は、設定を一律に削除せず、記録しておいた内容に戻してください。
macOSのネットワーク権限に関するよくある質問
「ローカルネットワーク」を拒否すると、サブスクリプションを更新できませんか?
必ずしもそうではありません。macOS 15のローカルネットワーク権限は、LAN内のデバイスへのアクセスなどを対象とするもので、インターネット全般の接続を制御する設定ではありません。インターネット上のサブスクリプション更新に失敗した場合は、まずログでDNS解決の失敗、接続タイムアウト、サーバー側のエラーのどれに該当するか確認してください。LAN内のリソースへのアクセスが必要な場合に限り、「システム設定」→「プライバシーとセキュリティ」→「ローカルネットワーク」で対象アプリの設定を確認します。
ファイアウォールが着信接続の許可を求めています。許可すべきですか?
このMacでシステムプロキシを使うだけなら、送信接続のタイムアウトを解消するためにLANからの着信接続を許可する必要はありません。「システム設定」→「ネットワーク」→「ファイアウォール」→「オプション」で対象アプリのルールを確認し、待ち受け先がループバックアドレスのみにバインドされているか確認してください。ファイアウォールの着信ルールと、コアがリモートサーバーに接続できるかどうかは別の問題です。
ブラウザーは使えるのに、別のアプリはなぜ直接接続するのですか?
そのアプリに独自のプロキシ設定があるか確認してください。手動設定に対応している場合は、ローカルの待ち受けと同じプロトコルを選び、ループバックアドレスと実際のポートを入力して、同じリクエストを再試行します。直接接続しか選べないアプリでは、システムプロキシの設定に成功しても、そのアプリがプロキシを経由するとは限りません。
システムからネットワーク構成の追加を求められました。通常のプロキシでも必要ですか?
まず、TUNやその他の仮想ネットワーク機能を自分で有効にしていないか確認してください。通常のシステムプロキシをテストする場合は、そのモードを終了し、ローカル待ち受けと現在のネットワークサービスのプロキシ設定だけを確認できます。追加の権限を求められた場合は、ダイアログに表示された対象と用途を確認してください。管理対象デバイスでは、有効にしてよいか管理者に確認します。