まず、アプリの起動がブロックされているのか、ネットワーク接続が機能していないのかを切り分けましょう。前者はmacOSの「プライバシーとセキュリティ」でアプリごとに許可し、後者はローカルの待ち受けポート、システムプロキシ、TUNの権限を確認します。初回インストール時やアップデート後に接続できなくなった場合に役立つ手順です。順番に確認すれば、Gatekeeper、コアの起動、サブスクリプションの問題を混同せずに済みます。
1. インストーラーとブロックの種類を確認する
v2rayNはプロキシ接続を設定・管理するデスクトップクライアントで、実際の接続は選択したコアが処理します。macOSに「開発元を検証できません」と表示された場合、アプリ自体がまだ起動していない可能性があります。この段階では、サーバーの変更、VLESSの設定変更、サブスクリプションの更新をしてもブロックは解除されません。まず警告の内容を確認してから、次の手順に進みましょう。
Appleメニューから「このMacについて」を開きます。Appleシリコン搭載機ではarm64版、Intelプロセッサ搭載機ではx64版を選んでください。配布パッケージに記載された最低システム要件も確認しましょう。macOSのバージョンが古い場合と、開発元を検証できない場合は別の問題です。インストーラーは、当サイトのクライアントのダウンロードページでプラットフォームを選んで入手できます。
| 表示されるメッセージ | まず確認すること | 対処方法 |
|---|---|---|
| 「開発元を検証できません」または「悪意のあるソフトウェアが含まれていないことを確認できません」 | Gatekeeperによる起動時の評価 | 入手元を確認したうえで、「プライバシーとセキュリティ」からアプリごとに許可する |
| 「アプリが破損しているため開けません」 | 解凍時の完全性、パッケージの内容、システムの判定結果 | 該当するアーキテクチャの完全なパッケージを再入手し、許可コマンドを安易に実行しない |
| 「悪意のあるソフトウェアが含まれています」または「コンピュータに損害を与えます」と明示される | システムのセキュリティ検査 | 実行を中止して入手元を確認する。通常の開発元確認の警告と同じ方法で対処しない |
| メインウィンドウは開くが、ブラウザーがインターネットに接続できない | コア、ローカルポート、通信の経路制御方式 | まずローカルプロキシを確認し、その後システムプロキシまたはTUNを確認する |
圧縮ファイルをダウンロードした場合は、完全に解凍し、同梱のリソースやコアのフォルダーを残してください。パッケージにアプリバンドルが含まれている場合は、「アプリケーション」に移動してから起動できます。配布パッケージの説明で関連フォルダーの保持が指定されている場合は、まとめて固定の場所に置いてください。実行ファイルだけを取り出したり、圧縮ファイルのプレビューから直接実行したりしないでください。
2. 「プライバシーとセキュリティ」でアプリを許可する
以下の手順は、「システム設定」を使うmacOS 13以降が対象です。ボタンの表示名はシステムのバージョンによって多少異なる場合があります。該当するブロック履歴を表示するには、まずアプリの起動を試してください。「このまま開く」は、ブロックされてから一定時間だけ表示されることがあります。見つからない場合は、もう一度起動を試してください。
-
起動時の警告を表示する
Finderで解凍済みのv2rayNをダブルクリックします。警告の文面を確認してから閉じてください。アプリをゴミ箱に移動してから許可ボタンを探す必要はありません。
-
セキュリティ設定を開く
Appleメニューから「システム設定」→「プライバシーとセキュリティ」を開き、「セキュリティ」までスクロールして、先ほどブロックされたアプリの記録を探します。
-
アプリ名を確認する
表示された記録が今回ダウンロードしたv2rayNのものだと確認し、「このまま開く」をクリックします。求められた場合は、管理者の認証情報またはTouch IDで認証してください。
-
もう一度起動して確認する
続いて表示される確認ダイアログで「開く」を選択します。メインウィンドウが表示されたら、既存のサブスクリプションや設定を読み込む前に、ログにコアの起動エラーがないか確認してください。
一部の旧バージョンでは、Finderで右クリックして「開く」を選ぶと追加確認が表示される場合があります。ただしmacOS 15以降では、この方法で該当するブロックを解除できるとは限りません。「プライバシーとセキュリティ」に表示される専用の操作を優先してください。アプリの更新後に再審査されることは珍しくありません。新しいパッケージを確認して再度対処し、システムのセキュリティチェックを恒久的に弱めないようにしましょう。
3. システムプロキシとTUNの権限を分けて確認する
アプリの起動を許可すること、システムプロキシを変更すること、仮想ネットワークインターフェースを作成することは、それぞれ別の操作です。ブラウザーの通信を確認するだけなら、まずシステムプロキシを使えばよく、最初からTUNを有効にする必要はありません。通信方式を切り替えるときは一度に一項目だけ変更し、問題の箇所を特定しましょう。
まずはシステムプロキシを使う
おすすめv2rayNのメイン画面で「システムプロキシ」を開き、「システムプロキシを自動設定」を選択します。続いて「システム設定」→「ネットワーク」→接続中のネットワーク→「詳細」→「プロキシ」を開き、HTTPおよびHTTPSプロキシの宛先がローカルの待ち受けアドレスとポートになっているか確認してください。バージョンによっては、ウィンドウ下部やステータスメニューに設定があります。
用途:初回の接続確認、ブラウザーでのアクセス、ローカルプロキシが動作しているかの切り分け。
必要に応じてTUNを使う
TUNは仮想ネットワークインターフェースを介して通信を制御するため、特権ヘルパープログラム、管理者認証、または関連するシステム権限が必要になることがあります。具体的な仕組みは、使用しているv2rayNの配布パッケージとコアの実装によって異なります。他のクライアントのネットワーク拡張の許可手順を、そのまま流用しないでください。
用途:システムプロキシに従わないアプリや、ルーティングとDNSをさらに設定する必要がある場合。
システムにネットワーク拡張がブロックされたと明示され、使用中の配布パッケージが実際にその拡張を使っている場合に限り、該当する設定を確認してください。macOS 15では「システム設定」→「一般」→「ログイン項目と機能拡張」→「ネットワーク機能拡張」を確認できます。それ以外のバージョンでは、システムの警告に表示された手順に従ってください。該当項目が一覧にないからといって、拡張機能の追加インストールが必要とは限りません。名前のわからないコンポーネントを安易に許可しないでください。
- 管理者パスワードを求められたら、直前に行ったクライアントの操作に対する要求か確認してください。許可した後も、コアのログを確認しましょう。
- 「ローカルネットワーク」へのアクセスを求められた場合、この権限は主にLAN上の機器の検出やアクセスに関係します。プロキシ経由の外部通信を許可する権限ではありません。関連機能が必要な場合にのみ許可してください。
- 通常、プロキシ接続に「アクセシビリティ」や「フルディスクアクセス」を許可する必要はありません。目的に関係のない権限を求められた場合は、用途を確認してください。
- 別のVPN、ネットワークフィルターツール、または他のTUNが同時に動作していると、ルーティングの競合が起きることがあります。切り分けの際は、ほかの通信制御アプリを終了してください。
4. ポートとコマンドで問題の箇所を特定する
メインウィンドウが正常に表示されても、プロキシのコアが動作しているとは限りません。まずクライアントの現在の設定でローカルの待ち受けポートを確認し、以下の例と照らし合わせてください。ここでは例として10808を使いますが、お使いのバージョンの既定値と同じとは限りません。コマンドのポート番号は、実際のSOCKSまたはmixed待ち受けポートに置き換えてください。
「アプリケーション」→「ユーティリティ」→「ターミナル」を開き、次のコマンドを実行します。最初の2つはシステムとアーキテクチャの情報を表示し、3つ目は例に使ったポートでTCP接続を待ち受けているかを確認し、4つ目はシステムプロキシの状態を表示します。いずれもシステム設定は変更しません。
sw_vers -productVersion
uname -m
lsof -nP -iTCP:10808 -sTCP:LISTEN
scutil --proxy
uname -mを実行すると、Appleシリコンのネイティブ環境では通常arm64、Intel環境では通常x86_64と表示されます。ターミナルが変換環境で動作している場合は、「このMacについて」でハードウェアを確認してください。待ち受けの確認結果が空の場合は、まずコアのログを確認し、システムの許可ボタンを何度もクリックしないでください。ポートが別のプロセスに使われている場合は、競合するアプリを終了するかクライアント側でポートを変更し、システムプロキシの設定も合わせて更新してください。
curl --proxy socks5h://127.0.0.1:10808 \
--connect-timeout 5 --max-time 15 \
-I https://www.example.com/
- ローカルポートへの接続にすぐ失敗する:クライアントのコアが動作していること、ポート番号が正しいこと、そのポートがSOCKSに対応していることを確認してください。
- ローカルポートには接続できるが、ハンドシェイクエラーまたはタイムアウトが発生する:サーバーの状態、プロトコルの設定、ログを確認してください。VMess、VLESS、Trojanの設定を互いに置き換えることはできません。
- HTTPレスポンスを受信するが、ブラウザーでは接続できない:少なくとも今回の明示的なプロキシリクエストには応答が返っています。ブラウザーのプロキシ設定、拡張機能、システムプロキシの設定が一致しているか確認してください。すべての通信が正常だと判断する根拠にはなりません。
5. アップデート後に動かない場合:アプリとネットワーク設定を別々に復旧する
アップデートによってアプリの場所、コアのファイル、補助コンポーネントが変わったり、セキュリティの再評価が行われたりすることがあります。アップデート前に必要な設定をエクスポートし、ローカルポート、ルーティング方式、DNS設定、選択中のコアを記録してください。サブスクリプションのURLにはアクセス用の認証情報が含まれることが多いため、バックアップやスクリーンショットは安全に保管してください。
復旧の順序:まず起動し、その後に通信制御を戻す
新しいバージョンが開かない
- 旧プロセスを完全に終了し、固定した場所にある新しいアプリを起動していることを確認します。
- アーキテクチャと最低システム要件を確認し、パッケージをもう一度完全に解凍します。
- 開発元の確認を求められた場合は、アプリごとの許可手順をもう一度行います。
- ウィンドウが開いたら、すべての詳細設定を戻す前にコアのログを確認します。
開くがインターネットに接続できない
- まずTUNを無効にし、明示的なプロキシリクエストでローカルポートを確認します。
- クライアントの「システムプロキシ」で設定をいったん解除してから、自動設定し直します。
- ポートが正常だと確認できたら、TUNに必要な権限と設定を戻します。
- アップデート前の記録を見ながら、ルーティングとDNSを一項目ずつ戻します。複数の設定を同時に変更しないでください。
原因不明の問題を、複数の通信制御方式を重ねて解決しようとしないでください。設定を一つ戻すたびに、ブラウザーでのアクセスとクライアントのログを確認しましょう。
クライアントが異常終了した後にMac全体がインターネットに接続できなくなった場合は、現在のネットワークの「詳細」→「プロキシ」を開き、停止したローカルポートが参照されたままになっていないか確認してください。該当するプロキシを無効にして設定を適用し、直接接続を試します。会社で指定されたプロキシ設定を不用意に削除しないでください。管理対象の端末では、元の値を記録してから管理者に相談してください。
6. よくある質問と注意点
「このまま開く」が表示されない場合は?
Finderからもう一度アプリを起動し、すぐに「システム設定」→「プライバシーとセキュリティ」の下部を確認してください。システム要件を満たしていない、ファイルが破損している、または悪意のあるソフトウェアが検出されたという警告の場合は、開発元の確認と同じ手順で無理に続行しないでください。管理対象の端末では、ユーザーによるポリシーの変更が禁止されている場合もあります。
許可した後も、起動のたびにパスワードを入力する必要がありますか?
まずパスワード入力画面の説明を確認してください。Gatekeeperのアプリごとの許可と、TUNの特権操作は別の権限です。TUNを有効にしたときだけ要求される場合は、使用中の配布パッケージで補助プログラムが正しくインストールされているか確認してください。通常の起動でも何度もブロックされる場合は、毎回新しい解凍先から起動していないか確認しましょう。
ネットワーク拡張を許可しても、サブスクリプションを更新できない場合は?
拡張機能を許可しても、期限切れのサブスクリプションURLは修復されません。まず明示的なプロキシリクエストで通信を確認し、サブスクリプションのURLとサービスの状態を調べてください。接続が確立している場合に限り、クライアントにプロキシ経由の更新機能があれば試します。ログにタイムアウトと認証エラーが記録されている場合は、それぞれ別に対処してください。
権限を復旧するには、アンインストールして再インストールする必要がありますか?
通常はまず、使用中のアプリの場所、システムプロキシの設定残り、コアのログを確認してください。再インストールしても、サーバーの設定やリモートサービスの問題は自動で解決されず、カスタム設定が上書きされる場合もあります。再インストールが必要な場合は、先に設定をバックアップし、配布パッケージの説明に従ってファイルを入れ替えてください。ログを共有する前に、サブスクリプションのトークン、サーバーの認証情報、個人のパスを隠してください。