まず「アプリが開かない」場合と「起動後にネットにつながらない」場合を切り分けます。前者はインストーラーのアーキテクチャとmacOSのセキュリティ警告を確認します。後者はコア、本機のポート、システムプロキシ、サーバー接続の順にチェックします。通常のWeb閲覧にはまずシステムプロキシを使い、より多くのアプリの通信を制御する必要がある場合に限って、TUNの管理者権限を設定しましょう。すべての権限を一度に有効にする必要はありません。
まず確認:起動時のブロックとネットワーク障害は別
「開発元を検証できません」という警告は、通常macOSのアプリ安全性チェックによるものです。メインウィンドウが表示される前に起きる問題で、サブスクリプションの有効性やサーバーの稼働状況とは別です。この段階でサブスクリプションを何度も更新したり、サーバーのポートを変更したりしても、起動時のブロックは解除されません。
まずAppleメニューから「このMacについて」を開きます。Appleシリコン搭載のMacならarm64版、Intelプロセッサ搭載のMacならx64版のインストーラーを選びます。Appleシリコン搭載Macでは一部のx64アプリにRosettaが必要な場合がありますが、トラブルシューティングでは対応するアーキテクチャを選び、余計な要因を減らしましょう。
| 表示される症状 | 該当する箇所 | まず試すこと |
|---|---|---|
| 開発元を検証できない/悪意のあるソフトウェアか確認できない | アプリ起動時のセキュリティチェック | 入手元を確認してから、「プライバシーとセキュリティ」にあるブロック履歴を確認します。 |
| アプリが破損しているため開けません | ダウンロードの完全性、署名、アプリの状態 | 対応するアーキテクチャのインストーラーを再度入手し、通常の許可手順をそのまま適用しないでください。 |
| このコンピュータに損害を与える/マルウェアが検出された | 明確なセキュリティリスクの警告 | 実行を中止し、入手元を確認してください。無理に回避しないでください。 |
| ウィンドウは表示されるが、Webページを開けない | コア、プロキシの接続先、またはリモート接続 | ログを確認してから、本機の待ち受けポートとシステムプロキシを確認します。 |
「プライバシーとセキュリティ」でアプリの起動を許可する
以下は「システム設定」画面が採用されたmacOS 13以降を対象としています。システムのバージョンによって確認ボタンの表記は多少異なりますが、設定場所は「プライバシーとセキュリティ」の「セキュリティ」欄です。許可するのは入手元を確認したこのアプリだけであり、Mac全体のセキュリティチェックを無効にするわけではありません。
-
アプリケーションフォルダに移動する
ダウンロードしたDMGを開き、v2rayNを「アプリケーション」へドラッグします。インストール用ディスクイメージを取り出した後、「Finder」→「アプリケーション」から起動してください。ディスクイメージ内のコピーを使い続けないようにします。
-
起動時の警告を表示する
v2rayNをダブルクリックし、システムの警告を読んでから閉じます。表示された文言を控え、開発元の検証に関する警告なのか、マルウェアに関する明確な警告なのかを確認してください。
-
ブロック履歴を確認する
Appleメニュー→「システム設定」→「プライバシーとセキュリティ」を開き、「セキュリティ」まで下にスクロールします。v2rayNの起動が最近ブロックされた記録を確認してください。
-
今回の起動を許可する
「このまま開く」をクリックし、画面の指示に従ってTouch IDまたは管理者の認証情報で確認します。その後、確認ダイアログが表示されたら、アプリ名を確認して「開く」をクリックしてください。
-
もう一度起動して確認する
メインウィンドウが表示されることを確認し、いったん終了してから「アプリケーション」よりもう一度起動します。同じようにブロックされる場合は、ダウンロードフォルダにある別のコピーを起動していないか確認してください。
macOS 15以降では、署名や公証が適切でない一部のアプリを開く手順がより厳格になっています。古い解説にある右クリックの「開く」が必ず使えるとは限りません。また、隔離属性を削除するコマンドやGatekeeperの無効化、アプリ全体のアクセス権変更を安易に実行しないでください。原因を隠し、調査対象を広げるおそれがあります。
システムプロキシとTUN:必要な機能だけを選ぶ
v2rayNは設定と管理を行うインターフェースで、実際に通信を転送するのはコアです。画面が起動してもコアが起動しているとは限らず、コアがサーバーに接続できてもブラウザーがプロキシを使っているとは限りません。システムプロキシは、システム設定に従うアプリに接続先となる本機の入口を指定します。TUNは仮想ネットワークインターフェースを使い、ルールに合致する通信を取り込みます。
まずはシステムプロキシを使う
おすすめまずTUNを無効にしたまま、有効なサーバーを選び、v2rayNの「システムプロキシ」→「システムプロキシを自動設定」から有効にします。メニューの場所はデスクトップ版によって異なる場合がありますが、通常はメインウィンドウ下部または通知領域のメニューにあります。
用途:ブラウザーでの閲覧、初期設定、本機の接続先とリモート接続のトラブル切り分け。
必要な場合にTUNを有効にする
通常のプロキシが使えることを確認してから、TUNを試します。仮想インターフェースの作成やルーティングの変更などには通常、管理者の認証が必要です。表示される警告はクライアントのバージョンや使用するコアによって異なります。
用途:システムプロキシに従わないアプリや、通信をまとめて制御したい場合。
システムプロキシを有効にした後、「システム設定」→「ネットワーク」→接続中のWi-FiまたはEthernet→「詳細」→「プロキシ」で設定を確認できます。Webプロキシ、安全なWebプロキシ、SOCKSプロキシの種類は、クライアントが実際に提供するローカル接続方式と一致させてください。項目にチェックが入っているだけでは、正しく設定されているとは限りません。
- アドレス:本機のプロキシには通常
127.0.0.1を指定します。本機のプロキシ欄にサブスクリプションのサーバーアドレスを入力しないでください。 - ポート:v2rayNの「設定」→「パラメーター設定」に表示されるローカル待ち受けポートを使います。画面の構成や項目名はバージョンによって異なる場合があります。
- 認証:ローカル接続にユーザー名とパスワードが明示的に設定されている場合のみ、システムプロキシに認証情報を入力します。
- 終了時:クライアントを終了する前に「システムプロキシ」→「システムプロキシを解除」を選びます。終了後もシステムが待ち受けを停止したポートを参照し続けるのを防げます。
ネットワーク権限:表示されたときに許可し、すべては有効にしない
macOSには、すべてのデスクトップアプリに共通する「すべてのネットワーク通信を許可」スイッチはありません。セキュリティ上の起動許可、ローカルネットワークへのアクセス、システムプロキシの設定、TUNの管理者権限はそれぞれ別の手順です。いずれかのダイアログが表示されても、ほかの設定まで完了したとは限りません。
| 権限・設定 | 用途 | 設定時の注意 |
|---|---|---|
| ローカルネットワーク | macOS 15以降で、この仕組みの管理対象となるローカルネットワークへのアクセスを制御します。 | ルーターやLAN内のデバイスへのアクセス、またはLAN向けサービスの提供が必要な場合は、「プライバシーとセキュリティ」→「ローカルネットワーク」を確認します。 |
| ネットワークプロキシ設定 | 現在のネットワークサービスで使用するプロキシのアドレスとポートを変更します。 | システムから認証を求められた場合は、操作元を確認してから許可してください。失敗する場合は、現在のネットワークサービスと管理ポリシーを確認します。 |
| TUNの管理者権限 | 仮想インターフェースの作成やルートの変更など、制限された操作を許可します。 | クライアントに表示される実際の認証手順に従ってください。日常的に使うGUIアプリを管理者として常時実行しないでください。 |
| ファイアウォールの受信接続 | ほかのデバイスから本機のサービスへの接続を制御します。 | 本機からループバックアドレス経由でプロキシに接続する場合、通常は外部からの受信接続を許可しても解決しません。 |
「ローカルネットワーク」の一覧にv2rayNがなくても、インストールに失敗したとは限りません。この権限は通常、アプリが制御対象のアクセスを試みてから表示されます。インターネットや本機のループバックアドレスへのアクセスを、一律にローカルネットワーク権限の不足と判断することもできません。Webページのタイムアウトを解決するために、ファイアウォール全体を無効にしないでください。
ローカルポートで接続経路を確認する
「コアの起動→ローカル待ち受け→明示的なプロキシ接続→システムプロキシ→TUN」の順に確認します。以下の10808は説明用のポート番号で、すべてのバージョンの既定値ではありません。クライアントが実際にそのポートでHTTPまたは混合プロキシの接続を受け付けている場合のみ、例のコマンドを使ってください。
「Finder」→「アプリケーション」→「ユーティリティ」→「ターミナル」を開き、次の2つの読み取り専用コマンドを実行します。1つ目は例のポートでTCP接続を待ち受けているかを確認し、2つ目は現在のシステムプロキシ設定を表示します。どちらもシステム設定は変更しません。
lsof -nP -iTCP:10808 -sTCP:LISTEN
scutil --proxy
- 待ち受けの結果が表示されない:実際のポート番号とコアのログを確認します。出力がないことだけで、アプリのインストール失敗とは判断できません。
- 想定と異なるコアが待ち受けている:ポートが使用中の可能性があります。プロセス名を控え、クライアントで空いているポートに変更してからコアを再起動してください。
- システムプロキシのアドレスまたはポートが一致しない:システムプロキシを再設定し、現在使用中のWi-FiまたはEthernetサービスを確認してください。
この接続先がHTTPプロキシに対応していることを確認してから、明示的なプロキシ接続を1回試します。このテストはブラウザーがシステムプロキシを使うかどうかに左右されないため、「本機からの転送」と「システムプロキシの反映」を分けて確認できます。
curl --connect-timeout 10 --max-time 20 -I \
--proxy http://127.0.0.1:10808 https://v2raybit.com/
ローカル接続がSOCKSにしか対応していない場合は、プロキシの引数を--proxy socks5h://127.0.0.1:10808に変更します。ポートは実際のSOCKS待ち受けポートに合わせてください。応答内容を事前に決めつけず、接続拒否ならまずローカルの待ち受けを確認します。タイムアウトの場合は、コアのログも参考に、リモート接続・DNS・ルールのどこに原因があるかを確認してください。
よくある質問と終了後の復旧
起動のたびに「このまま開く」をクリックする必要がありますか?
一度許可した同じアプリなら、通常は繰り返し操作する必要はありません。すべてのコピーを終了し、「アプリケーション」から起動してください。アップデートでアプリの内容が変わると、システムが再チェックする場合があります。何度もブロックされる場合は、警告の文言を控え、古いコピーを起動していないか、管理ポリシーで制限されていないかを確認します。
起動を許可したのに、サブスクリプションの更新に失敗するのはなぜですか?
起動の許可で解決するのは起動時のチェックだけです。サブスクリプションのURLが正しく入力されているか、有効期限が切れていないか、更新時にプロキシ経由の接続が必要かを確認します。利用可能なプロキシ経路がすでにある場合に限り、「プロキシ経由で更新」が役立つことがあります。この設定だけで接続が確立するわけではありません。ログを共有する際は、サブスクリプションのURL全体と認証情報を隠してください。
TUNを有効にするとネットにつながらなくなります。どの権限を追加すればよいですか?
まずTUNを無効にして、動作確認済みのシステムプロキシ経由に戻します。その後、TUNだけを有効にし、最初に失敗したときのログとシステムの認証画面を記録してください。通常のプロキシは使えるのにTUNが使えない場合は、仮想インターフェース、ルートの競合、DNSを重点的に確認します。ノード、プロトコル、権限を同時に変更しないでください。
v2rayNを終了した後、Mac全体でインターネットに接続できなくなった場合は?
「システム設定」→「ネットワーク」→接続中のネットワーク→「詳細」→「プロキシ」を開き、本機のポートを参照したままになっていないか確認します。クライアントが今回設定したプロキシ項目だけを解除し、ネットワークに元から設定されていた内容は残してください。TUNを有効にしている場合は、通常の手順でTUNを無効にしてから終了し、必要であればネットワークに再接続します。
切り分けに必要な情報は、macOSのバージョンとチップの種類、v2rayNの実際のバージョン、失敗時に最初に出た関連ログの3つです。まず問題がどの層で起きているかを特定してから設定を調整すると、何度も再インストールしたり権限を広げたりするより原因を絞りやすくなります。