Macにv2rayNを初めてインストールする方や、OSのアップデート後にプロキシが機能しなくなった方に向けた内容です。表示されたメッセージから、アプリの起動、ローカルの待ち受け、システムプロキシの設定のどこで問題が起きているかを見極め、該当する手順を確認してください。配布元が明確で、macOSに例外設定の項目がある場合に限り、そのアプリだけを許可します。
起動ブロックとプロキシの不具合を切り分ける
Gatekeeperはインターネットからダウンロードしたアプリを確認し、署名や公証などを判断材料にします。「開発元を確認できません」という表示は、現在のアプリがmacOSの標準ポリシーで確認できなかったことを示します。ネットワーク権限が拒否されたという意味でも、ファイルの安全性を証明するものでもありません。配布元が不明な場合、macOSがマルウェアを検出した場合、「壊れている」と表示された場合は、通常の開発元確認の例外設定で解決しようとしないでください。
表示された場所から原因を確認する
おすすめダブルクリックしてもメインウィンドウが表示されない場合は、まず起動時の警告に対処します。メインウィンドウは表示されるものの、プロキシを有効にしてからネットにつながらなくなった場合は、コアのログと現在のネットワークサービスのプロキシ設定を確認してください。最初に表示されたメッセージを記録し、設定は一度に一つずつ変更しましょう。
対象:初回インストール、アップデート後に原因が分からない場合
プロキシを使わない状態で確認する
v2rayNが起動できる場合は、まず現在のプロキシ設定を記録し、今回のテストで設定したプロキシを解除してから、同じブラウザーで以前は直接アクセスできたサイトを開いてみてください。プロキシなしでも接続できない場合は、Wi-Fi、ログインが必要なネットワーク、既存のネットワークポリシーを優先して確認し、ノード設定は変更しないでください。
対象:ネットワークを切り替えた後、ブラウザーで突然ウェブページを開けなくなった場合
まずメインウィンドウが表示されるか確認
メインウィンドウが開く場合は、現在のセキュリティ設定を変えずにコアのログを確認してください。アプリの起動が許可されても、同梱されているコアが正常に動作しているとは限りません。
「プライバシーとセキュリティ」でアプリ単体を許可する
インストールパッケージを確認する
信頼できる配布元でダウンロード元を確認してください。Appleメニュー →「このMacについて」でAppleシリコンかIntelプロセッサかを確認し、arm64またはx64と表示された適切なビルドを選びます。展開後はFinderで、以降も同じアプリを起動していることを確認してください。ダウンロードフォルダと「アプリケーション」にある別々のコピーを同時に試すのは避けましょう。
ブロック時のメッセージを読む
アプリをダブルクリックし、macOSの警告を確認します。開発元を確認できないという表示だけで、配布元が明確な場合は、警告を閉じて次の手順に進みます。アプリがコンピュータに損害を与える可能性があるという警告が表示された場合や、配布元を確認できない場合は、起動を中止し、配布元またはデバイス管理者に確認してください。
セキュリティ設定を開く
macOS 13以降では、Appleメニュー →「システム設定」→「プライバシーとセキュリティ」を開き、「セキュリティ」までスクロールします。先ほどブロックされたアプリの項目を探し、表示されたアプリ名が起動したコピーと一致することを確認してから「このまま開く」をクリックします。
今回の起動を許可する
macOSのダイアログに従って確認し、必要に応じて権限のあるアカウントで認証します。ボタンが表示されない場合は、同じアプリをもう一度起動してから、すぐに設定画面に戻って確認してください。学校や会社のポリシーで管理されているデバイスでは、例外設定が許可されているか管理者に確認し、システム全体の保護は無効にしないでください。
コアのログを確認する
メインウィンドウが開いたら、既存の設定を一つ選び、クライアントのログで該当するコアが起動し、ローカルの待ち受けにエラーがないことを確認します。この段階ではTUNを有効にしたり、サブスクリプションを一括更新したりしないでください。アプリの起動、コアの読み込み、リモート接続の問題が混在するのを避けられます。
システムプロキシとローカルネットワーク権限を確認する
システムプロキシはネットワークサービスごとに設定します。v2rayNが設定するアドレスとポートは、システムプロキシに従うアプリ向けであり、すべてのプログラムに適用されるインターネット接続権限ではありません。Wi-Fiを使う場合は、クライアント下部の「システムプロキシ」メニューから「システムプロキシを自動設定」を選びます。画面の表示が異なる場合は、現在のクライアントにあるシステムプロキシの項目を使ってください。続いて、Appleメニュー →「システム設定」→「ネットワーク」→「Wi-Fi」→ 接続中のネットワークの「詳細」→「プロキシ」を確認します。有線接続の場合は、実際に使用しているEthernetサービスを確認してください。
- 待ち受けポートを確認:v2rayNの「設定」→「パラメータ設定」でローカルの待ち受けポートを確認し、コアのログと照合します。ポートが実際に
10808の場合は、ターミナルでlsof -nP -iTCP:10808 -sTCP:LISTENを実行して、待ち受け中のプロセスを確認できます。別のプロセスがポートを使用している場合は、まずプロセスを特定してください。競合していることが分かっているアプリを終了するか、ポートを変更してから、システムプロキシを設定し直します。 - プロキシの種類を合わせる:システム設定の「Webプロキシ(HTTP)」「セキュアWebプロキシ(HTTPS)」「SOCKSプロキシ」は、それぞれ別の項目です。クライアントが実際に設定した項目と、対応する待ち受け方式を確認してください。SOCKS専用ポートをHTTPの項目に入力しないでください。以前に自動プロキシ構成や職場のネットワークプロキシを使っていた場合は、元の値を記録してから変更し、後で復元できるようにします。
- 必要なアクセスだけを許可する:macOS 15以降では、ローカルネットワーク上のデバイスにアクセスする際に、ローカルネットワークへのアクセス許可を求められることがあります。ローカルネットワークのアドレスにアクセスする必要がある場合は、「システム設定」→「プライバシーとセキュリティ」→「ローカルネットワーク」で、要求元に合ったアプリが表示されているか確認してください。
127.0.0.1を使ってこのMac上のプロキシに接続するだけなら、通常、ローカルネットワークへのアクセスを許可する必要はありません。
OSアップデート後にプロキシ設定を復元する
- どのアプリを起動しているか確認する。今後使うコピーを「アプリケーション」から起動してください。アップデート後にアプリのパッケージが変わり、開発元確認の警告が再度表示された場合は、新しいアプリの起動チェックとして配布元を確認し直します。以前のコピーに設定した例外が新しいコピーにも引き継がれるとは限りません。
- まずコアの待ち受けを復旧する。クライアントのログで起動結果を確認してください。ポートの競合がある場合は、先に解消します。コアファイルが見つからない、または実行できないというログが出る場合は、ファイルがすべて展開されているか、異なるアーキテクチャのファイルが混在していないか確認してください。コアが待ち受けていない状態でシステムプロキシを何度も設定しても、利用できないポートへの接続を試みるだけです。
- 現在のネットワークに設定し直す。コアが正常に起動したことを確認したら、クライアントの「システムプロキシ」メニューから今回書き込んだ古い値を解除し、自動設定を行います。現在のネットワークサービスの「プロキシ」画面に戻って、設定結果を確認してください。認証を求められた場合は、自分が開始した操作であり、表示内容がその操作と一致するときに限り確認します。管理対象の項目は管理者に対応を依頼してください。
- ブラウザーと他のアプリを分けて確認する。システムプロキシを使うブラウザーで動作を確認してから、対象のアプリを試します。ブラウザーは復旧したのに対象アプリだけ失敗する場合は、そのアプリ独自のプロキシ設定を確認してください。ブラウザーも接続できない場合は、コアのログを見て、ローカル接続の拒否かリモート接続のタイムアウトかを切り分けます。システム権限を何度も変更するのは避けてください。
初回起動とネットワーク権限に関するよくある質問
「このまま開く」が見つからないのはなぜ?
Finderから使用するアプリを起動し、表示されたメッセージを記録してから、「プライバシーとセキュリティ」の下部を確認してください。破損またはマルウェアの警告が表示された場合や、デバイスのポリシーで例外が許可されていない場合、この項目は利用できません。
v2rayNを終了するとウェブページも開けなくなるのはなぜ?
現在のネットワークサービスが、すでに待ち受けを停止したローカルポートへ通信を送っていないか確認してください。クライアントを再度開き、「システムプロキシ」メニューからv2rayNが設定した項目を解除できます。もともと職場のプロキシや自動構成アドレスを使っていた場合は、すべてのプロキシを無効にするのではなく、記録しておいた値に戻してください。
ローカルネットワークにv2rayNが表示されない場合、手動で追加する必要はありますか?
まず、接続先がローカルネットワーク上のデバイスかどうかを確認してください。リモートサーバーに接続できない場合は、リモートアドレス、ポート、コアのログを優先して確認します。ローカルネットワークへのアクセスが必要な場合は、該当する操作をもう一度行い、macOSから許可要求が表示されるか確認してください。通常のインターネット接続のために、追加の許可を探す必要はありません。