Macにv2rayNを初めてインストールする方や、アプリが開かない、システムプロキシが機能しないといった問題がある方向けの記事です。プロセッサに合ったパッケージを選び、アプリを「アプリケーション」に移動してから、macOSのアプリごとの許可機能を使って起動します。その後、ローカルの待ち受け、システムプロキシ、必要に応じて表示されるネットワーク権限を個別に確認します。Gatekeeperの許可はプロキシ接続の成功を意味せず、管理者の承認もセキュリティ機能を無効にする必要があるという意味ではありません。
インストーラーの選び方：チップとシステム要件を確認
画面左上のAppleメニューから「このMacについて」を開きます。「チップ Apple M…」と表示される場合はApple Silicon（ARM64）版を、「プロセッサ Intel…」と表示される場合はIntel（x64）版を選びます。外観や購入年で判断しないでください。同じ製品名でも搭載プロセッサが異なる場合があります。
Apple Siliconネイティブ版
推奨Appleチップ搭載Mac向けのパッケージで、ダウンロード項目には通常arm64と表示されます。「推奨」はAppleチップ搭載Macで対応するネイティブ版を優先するという意味で、すべてのMacでこのパッケージを選ぶという意味ではありません。
対象：「このMacについて」にAppleチップと表示されるMac。
Intelネイティブ版
Intel搭載Mac向けのパッケージで、ダウンロード項目には通常x64と表示されます。Intel MacではARM64版を実行できません。Apple Silicon上で一部のIntelアプリを動かすにはRosettaが必要な場合がありますが、初回インストールではまずネイティブ版を選んでください。
対象：「このMacについて」にIntelプロセッサと表示されるMac。
クライアントのダウンロードページでmacOS版を選び、リリースごとに記載されている最小システム要件を確認します。macOS用のデスクトップアプリを選び、Windows用のWPF版は選択しないでください。Rosettaが必要と表示され、Appleチップ搭載Macを使っている場合は、ダウンロードしたアーキテクチャを再確認します。アプリ本体と同梱カーネルのアーキテクチャも一致させ、古いフォルダにある別アーキテクチャの実行ファイルを混在させないようにしてください。
- 圧縮ファイルは完全に展開してからアプリを「アプリケーション」に移動します。ディスクイメージの場合は開いた後、中のアプリを「アプリケーション」へドラッグします。
- アプリを置き換える前に旧バージョンを終了してください。初回起動時に圧縮ファイルのプレビューやディスクイメージ内の一時コピーから直接実行しないでください。
- 更新前に、クライアントのバックアップまたはエクスポート機能で設定を保存してください。サブスクリプションURLを含むバックアップを公開場所にアップロードしないでください。
Gatekeeperのブロック：「このまま開く」でアプリごとに許可
「開発元を確認できません」や「Appleは、悪質なソフトウェアが含まれていないことを確認できませんでした」という表示は、アプリの信頼性を確認するための警告であり、ノード、DNS、サブスクリプションの問題ではありません。ファイルが想定した配布元から入手したものか確認してから、macOSが用意するアプリごとの許可手順を使ってください。以下は「システム設定」を使用するmacOS向けの手順です。システムのバージョンによって表示文言が多少異なる場合があります。
-
初回起動
「Finder」→「アプリケーション」からv2rayNをダブルクリックします。セキュリティチェックでブロックされた場合は、警告内容を確認してダイアログを閉じ、今回の起動記録を残します。
-
セキュリティ設定を開く
Appleメニューから「システム設定」→「プライバシーとセキュリティ」を開き、下部の「セキュリティ」までスクロールします。ブロックされたアプリ名が、先ほど起動したv2rayNであることを確認してください。
-
アプリごとに許可
該当する記録の横にある「このまま開く」をクリックします。求められたらTouch IDまたは管理者アカウントで認証し、続いて表示される確認ダイアログで「開く」を選びます。
-
メイン画面を確認
アプリが起動したら、まずメイン画面とログを確認し、カーネルの起動に失敗していないことを確認します。ウィンドウが開いても、許可されたアプリが起動したことを示すだけです。プロキシの待ち受けとネットワーク設定も続けて確認してください。
一部の古いmacOSでは、FinderでアプリをControlキーを押しながらクリックして「開く」を選ぶと、例外を許可する確認画面を表示できます。ただし、新しいシステムではこの方法が使えない場合があります。優先して「プライバシーとセキュリティ」の設定を利用してください。Gatekeeper全体を無効にしたり、システム整合性保護を無効にしたりする必要はありません。
初回接続：ローカルポートとシステムプロキシを区別
v2rayNのメイン画面で自分のサブスクリプションを追加して更新し、有効なノードを選択します。「設定」→「パラメータ設定」でローカルの待ち受けポートを確認してから、メイン画面またはメニューバーアイコンの「システムプロキシ」メニューで「システムプロキシを自動設定」を選びます。デスクトップ版によって設定の場所が異なる場合があるため、現在の画面に表示される同名の設定を使ってください。
以下では、HTTPプロキシに対応するローカル待ち受けの例として 127.0.0.1:10808 を使用します。これは、すべてのリリースで既定のポートが同じという意味ではありません。クライアントに別のポートが表示されている場合や、HTTPとSOCKSが別々のポートで待ち受けている場合は、システムのWebプロキシに実際のHTTPポートを指定してください。例をそのまま使わないでください。
有効にした後、「システム設定」→「ネットワーク」→現在使用中のWi-FiまたはEthernetサービス→「詳細」→「プロキシ」を開きます。手動でHTTPシステムプロキシを設定する場合は、「Webプロキシ（HTTP）」と「セキュアWebプロキシ（HTTPS）」が該当するローカルアドレスとポートを指していることを確認してください。HTTPSプロキシの設定は、HTTPSリクエストがそのHTTPプロキシ経由でトンネル接続されることを示します。ローカルの接続口でTLSを有効にする必要があるという意味ではありません。
クライアントの待ち受け設定例
- 待ち受けアドレス
- 127.0.0.1
- 待ち受けポート
- 10808
- 対応するプロトコル
- HTTPプロキシ対応
- 使用中のサーバー
- 選択中の有効なノード
まずログでカーネルの起動成功を確認します。例の値は、必ずこのMacの実際の設定に置き換えてください。
システムプロキシの設定例
- Webプロキシ
- 127.0.0.1:10808
- セキュアWebプロキシ
- 127.0.0.1:10808
- プロキシ認証
- ローカルの接続口に合わせて入力
- 適用するサービス
- 現在インターネットに接続しているネットワークサービス
クライアントでPACを設定している場合は、自動プロキシ設定のURLを確認してください。出所の不明な手動プロキシを重ねて設定しないでください。
システムプロキシの設定が適用されるのは、その設定に従うアプリだけです。ブラウザではアクセスできても、コマンドラインツールが直接接続する場合がありますが、それだけで権限の問題とは限りません。そのツールに個別のプロキシ指定が必要なことがあります。逆に、システム設定でプロキシが有効でも、カーネルが待ち受けている証拠にはなりません。両方を個別に確認してください。
ネットワーク権限：管理者、ローカルネットワーク、TUNを個別に判断
macOSに、すべてのプロキシ通信を一括で許可するための必須スイッチはありません。権限の確認が表示されたら、どのプログラムが何を変更しようとしているかを確認してください。通常のシステムプロキシ、ローカルネットワーク上のデバイス検出、仮想ネットワークインターフェースによる通信の制御は、それぞれ役割が異なります。Webページが開かないからといって、すべての権限を有効にしないでください。
| 表示される警告・設定項目 | 用途 | 対応方法 |
|---|---|---|
| 管理者アカウントによる認証 | 保護されたネットワーク設定の変更、または必要な補助コンポーネントのインストール | 要求元のプロセスと操作内容を確認し、実行したクライアント操作によるものと確認できた場合に許可します。パスワードをサブスクリプションやノードの入力欄に入力しないでください。 |
| 「プライバシーとセキュリティ」→「ローカルネットワーク」 | アプリによるLAN上のデバイスなど、ローカルネットワークリソースへのアクセスを制御 | macOS 15以降では、このアクセス許可を求められることがあります。LAN機能が必要な場合に限って許可してください。インターネット接続全体を許可するスイッチではありません。 |
| TUN関連の権限昇格 | 仮想ネットワークインターフェースの作成、ルートやDNSの変更 | 現在のリリースでこの機能が提供され、システムプロキシに従わないアプリも通信を制御する必要がある場合に限り有効にし、クライアントの案内に従って許可してください。 |
| 「ネットワーク」→「ファイアウォール」 | 受信接続の管理 | ローカルプロキシからの外向き接続が失敗しても、通常はファイアウォールを無効にする必要はありません。他のデバイスからの接続が明確に必要な場合に限り、該当する受信ルールを確認してください。 |
「ローカルネットワーク」の一覧にv2rayNが表示されなくても、インストールに失敗したわけではありません。通常、この一覧にアプリが表示されるのは、該当するアクセス要求が発生した後です。ループバックアドレス経由でローカルプロキシを使うだけなら、それを理由に許可が必要と判断する必要はありません。管理対象の業務用Macでは、組織のポリシーによってネットワーク拡張機能やプロキシ設定が制御されている場合があります。管理者に対応を依頼し、管理設定を自分で削除しないでください。
接続のトラブル対処：待ち受けとネットワークサービスを順番に確認
「システムプロキシは有効なのにWebページが開かない」場合は、ローカルの接続口、システム設定、リモート接続の順に確認します。システムプロキシを書き換える他のツールは終了し、複数のプログラムが設定を上書きし合わないようにしてください。以下のコマンドは状態を読み取るだけで、システム設定は変更しません。「アプリケーション」→「ユーティリティ」→「ターミナル」で実行できます。
# サンプルポートでTCP待ち受けがあるか確認
lsof -nP -iTCP:10808 -sTCP:LISTEN
# ネットワークサービスの一覧を表示し、実際に使用しているサービス名を確認
networksetup -listallnetworkservices
# 以下ではサービス名 Wi-Fi を例にします
networksetup -getwebproxy "Wi-Fi"
networksetup -getsecurewebproxy "Wi-Fi"
networksetup -getautoproxyurl "Wi-Fi"- 待ち受けが見つからない：v2rayNに戻り、ログでカーネルが終了していないか、ポートが異なっていないかを確認します。ポートが使用中の場合は、使用中のプロセスを特定するか、クライアント側でポートを変更してからシステムプロキシを再設定してください。
- システムプロキシのポートが古い：クライアントでシステムプロキシをいったん解除してから、自動設定し直します。手動で変更する場合は、現在接続中のサービスで2つのWebプロキシ設定をどちらも更新してください。
- サービス名の確認でエラー：コマンド内の
Wi-Fiを一覧に表示された実際のネットワークサービス名に置き換えます。名前に空白が含まれる場合は、半角の二重引用符で囲んでください。 - 待ち受けとシステム設定に問題がない：ログでリモート接続、TLS、ドメイン名解決に関するエラーを確認します。タイムアウトはサーバーに到達できないことが原因の場合があります。証明書エラーの場合は、システム時刻とノードのTLS設定を確認してください。証明書検証のスキップで問題を回避しないでください。
以下のリクエストを使って、ローカルHTTPプロキシだけをテストすることもできます。プロキシを明示的に指定するため、システムプロキシの設定には依存しません。例のポートは実際のポートに変更してください。接続先はこのサイトのホームページです。結果は現在のネットワーク、ノード、接続先サイトの状態に左右されるため、一度の成否だけで全アプリの状態を判断しないでください。
curl --proxy http://127.0.0.1:10808 --head --max-time 15 https://v2raydns.com/127.0.0.1に接続できないと表示された場合は、まずローカルの待ち受けを確認してください。ローカル接続はできるのにリモートへのリクエストが失敗する場合は、使用中のノードとログを確認します。プロキシを明示したリクエストが成功してブラウザだけ失敗する場合は、ブラウザ独自のプロキシ設定、古いPAC設定、拡張機能による上書きを確認してください。ローカルの接続口が動作する前に、DNSを繰り返し変更しないでください。
よくある質問：起動を許可した後に確認すること
「このまま開く」ボタンが表示されないのはなぜですか？
まず「アプリケーション」からもう一度起動し、その直後に「システム設定」→「プライバシーとセキュリティ」の下部にあるセキュリティ項目を確認します。警告が開発元の確認に関するものか、マルウェアのブロックや組織のポリシーによるものかを見分けてください。それでも許可項目が見つからない場合は、macOSのバージョンと警告全文を記録します。システム全体のセキュリティチェックを無効にしないでください。
起動を許可したのに、ログに権限不足と表示されるのはなぜですか？
Gatekeeperが扱うのはアプリの実行許可だけです。エラーがカーネルの実行、設定フォルダへの書き込み、TUNの権限昇格のどれに関するものか確認してください。アプリが「アプリケーション」に完全に移動されていることと、現在のユーザーがクライアントの設定フォルダに書き込めることも確認します。フォルダのアクセス権の問題を隠すために、デスクトップアプリ全体を管理者として実行しないでください。
Wi-Fiを切り替えた後にプロキシが動かなくなった場合、再度許可が必要ですか？
まず現在のネットワークサービスで「詳細」→「プロキシ」を確認してください。Wi-Fiから有線LANに切り替えると別のサービスに切り替わり、プロキシ設定が異なる場合があります。v2rayNでシステムプロキシを自動設定し直して、アドレスとポートを確認してください。ネットワークサービスの違いを、Gatekeeperによる再ブロックと誤解しないようにしてください。
クライアントを終了した後、ブラウザがインターネットに接続できなくなった場合は？
v2rayNを起動し、「システムプロキシ」から「システムプロキシを解除」を選んでから終了してください。アプリを起動できない場合は、現在のネットワークサービスの「プロキシ」画面で、古いローカルポートを指すWebプロキシをオフにするか、古いPACを無効にします。このクライアントに関連する設定だけを解除してください。組織のネットワークで必要なプロキシについては、先に管理者へ相談してください。
インストール後の確認：元に戻せるネットワーク設定を維持
設定後は少なくとも一度、「クライアントを起動 → システムプロキシを有効化 → 正常にアクセス → システムプロキシを解除 → クライアントを終了」の一連の手順を確認してください。実際の待ち受けと正しい設定で接続できており、ブラウザのキャッシュや他のプロキシ設定の残留が原因ではないことを確認できます。アプリの更新、ノードの変更、TUNの有効化は一度に一種類ずつ行うと、問題の原因を特定しやすくなります。
- 次回の確認用に、実際のローカル待ち受けポートと現在使用中のネットワークサービス名を控えておきます。サブスクリプションURLを公開のトラブル報告用スクリーンショットに含めないでください。
- ログを共有する前に、サーバーアドレス、ユーザー識別情報、サブスクリプションのトークンなどの機密情報を隠し、エラーの種類と必要な前後関係だけを残してください。
- アンインストールする前に、TUNを無効にして（有効にしている場合）、システムプロキシを解除してください。アプリを削除してもネットワーク設定が同時に元に戻るとは限りません。
- サブスクリプションの追加やDNS設定について詳しく知りたい場合は、入門ガイドに沿って順番に設定してください。カーネル、ルーティング、名前解決の設定を同時に変更しないでください。