macOS初心者ガイド：クライアントのインストール、システム権限からサブスクリプションの読み込みまで

このmacOSクライアントのインストールとサブスクリプション読み込みガイドでは、ダウンロード前の確認から、アプリのインストール、システム権限、サブスクリプション更新、ノード選択、ルール分岐の確認、トラブルシューティングまで順に解説します。初回設定でつまずきやすいのは回線そのものではなく、アプリのアーキテクチャの不一致、ネットワーク拡張の未承認、設定の未適用、ブラウザ独自のDNSやプロキシ設定であることが多いです。

Macのネットワーククライアントは、単に「開けば使える」ものではありません。プロキシが必要な接続を処理するため、システムプロキシ、仮想ネットワークインターフェース、ネットワーク拡張を作成する場合があります。macOSはこれらを慎重に扱うべきネットワーク設定の変更とみなすため、初回起動時に確認画面が表示されるのは正常です。アプリの入手先と要求内容を確認し、現在のユーザーが明示的に許可してください。通知を無視してサブスクリプションを何度も読み込むのは避けます。

クライアントのインストール前に確認すること

まずMacのプロセッサーのアーキテクチャとmacOSのバージョンを確認し、クライアントのリリースページにあるインストーラーを確認します。AppleシリコンとIntelプロセッサーではアーキテクチャが異なり、別々のビルドが用意される場合も、ユニバーサルインストーラーが提供される場合もあります。アーキテクチャを間違えると、アプリが開かない、起動直後に終了する、互換レイヤーでの実行を求められるといった症状が起こります。

インストーラーは、クライアントプロジェクトの正式なリリースページ、サービス事業者の管理画面にあるダウンロード入口、またはシステムのアプリストアから入手してください。ダウンロード後は、ファイル名、アプリ名、開発元の情報が案内と一致するか確認します。システムがインターネットから入手したアプリだと警告した場合は、入手先を確認してから続行できます。一方、ファイルが破損している、開発元を確認できない、署名に問題があると表示された場合は、まず再ダウンロードして公式案内を確認し、システム保護の無効化を通常のインストール手順にしないでください。

• ✅ プロセッサーのアーキテクチャとインストーラーが一致している。
• ✅ 正式なリリースページまたはサービス管理画面からクライアントを入手する。
• ✅ インストール前に同種のプロキシクライアントを終了し、システムプロキシの競合を避ける。
• ✅ サブスクリプションURLは元のテキストのまま保持し、スクリーンショットや手入力で移さない。
• ❌ 出所不明の構成プロファイルをシステム設定に追加しない。
• ❌ 一度起動に失敗しただけでmacOSのセキュリティ確認を長期的に無効化しない。

一般的なインストールでは、ディスクイメージを開き、アプリを「アプリケーション」フォルダへドラッグしてから、そのフォルダから起動します。ダウンロードフォルダやディスクイメージから長期間直接実行すると、自動更新、補助コンポーネントのパス、権限の記録に問題が生じる場合があります。クライアントが圧縮ファイルで提供されている場合も、まず完全に解凍してからアプリを「アプリケーション」フォルダへ移動してください。

システム権限とネットワーク拡張

クライアントが初めてシステムプロキシ、拡張モード、仮想ネットワークインターフェースを有効にすると、macOSはVPN構成、ネットワーク拡張、補助コンポーネントの追加を求める場合があります。接続の制御方法はクライアントごとに異なり、画面上の名称も変わります。システムプロキシは通常、システムプロキシ設定に従うアプリだけに影響します。仮想ネットワークインターフェースはより多くの種類の通信を処理できますが、より高いレベルのシステム権限が必要です。

許可する際は、システム画面に表示されたアプリ名を読み、先ほどインストールしたクライアントと一致することを確認します。その後、Macの現在のアカウントでシステム認証を完了します。通知を閉じてしまった場合は、「システム設定」の「プライバシーとセキュリティ」、「ネットワーク」、またはVPN関連のページで、承認待ちの項目がないか確認してください。承認後は通常、クライアントに戻って該当モードを再度有効にします。場合によってはクライアントを終了して再起動する必要があります。

システム設定に旧クライアントが残したVPN構成やネットワーク拡張があっても、用途を確認せずにすべて削除しないでください。まず旧クライアントを終了し、該当する構成を使わなくなったことを確認してから、項目ごとに削除します。企業管理端末では管理ポリシーがネットワーク拡張を制御している場合があるため、組織の管理方針に従ってください。個人アカウントに承認権限があるとは限りません。

サブスクリプションの読み込みと設定更新

クライアントが正常に起動しても、利用可能な設定を取得できているとは限りません。サービス管理画面にログインし、汎用クライアントまたは現在のプラットフォームに対応したサブスクリプションの入口を探します。コピーするときはページのコピー buttonを使い、ブラウザによるURL末尾の文字の欠落を避けてください。サブスクリプションURLには設定へアクセスできる情報が含まれるため、公開ページへの掲載、スクリーンショットでの共有、信頼できないオンライン変換ツールへの貼り付けは避けます。

クライアントによって入口の名称は「サブスクリプション」「設定」「リモート設定」「構成ファイル」など異なります。クリップボードまたはURLからの読み込みを選び、URL全体を貼り付けて保存してから更新を実行します。更新に成功すると通常、ノード一覧、グループ、または設定名が表示されます。保存後も一覧が空の場合は、まず更新エラーを確認してください。同じ名前のサブスクリプションを何度も作成すると、切り替えやトラブルシューティングが難しくなります。

1. サービス管理画面を開き、現在のクライアントに対応したサブスクリプションURLをコピーする。
2. クライアントのサブスクリプションまたは設定管理画面を開き、URLから追加を選択する。
3. 識別しやすい設定名を入力し、URLを貼り付けて保存する。
4. 手動更新を1回実行し、ノードまたはグループが表示されることを確認する。
5. 対象ノードを選択し、システムプロキシまたは仮想ネットワークインターフェースを有効にする。
6. ウェブ、DNS、アプリの接続を確認し、ルールが想定どおり適用されていることを確認する。

サブスクリプションにはShadowsocks、VMess、Trojan、VLESS、Hysteria2、TUICなどのプロトコルが含まれる場合があります。プロトコル名はクライアントとノード間の接続方式を示すもので、回線品質を意味するものではありません。クライアントは、サブスクリプションで実際に使われるプロトコルとパラメーターに対応している必要があります。旧バージョンではノード名を認識できても、新しいフィールドを解析できない場合があります。「不明なプロトコル」「設定が無効」や、読み込み後にノードを選択できない場合は、まずクライアントを更新し、サブスクリプション形式が対応しているか確認してください。

サブスクリプションの読み込みと単一ノードの読み込みは同じではありません。単一ノードURLには1つの接続設定しか含まれず、サービス側の変更後は通常、再取得が必要です。サブスクリプションURLならクライアントから更新でき、ノードの変更を同期しやすくなります。日常利用では、分かりやすいメインのサブスクリプションを1つ残し、クライアントが対応していれば適切な自動更新を有効にしてください。更新に失敗しても古い設定が一覧に残る場合があるため、「ノードが表示される」だけでは直近の更新成功を証明できません。

読み込み後の確認手順
設定名 → 更新結果 → ノード一覧 → ルール選択 → 接続モード → アクセス確認

トラブルシューティングでは一度に1項目だけ変更する
まず既定のルールに戻す
次にノードを切り替える
続いてDNSを確認する
最後にアプリ独自のプロキシを確認する

ノード、回線、接続モードの選び方

ノード名には通常、国や地域、都市、回線種別、用途を示す情報が含まれます。初めて使う場合は、複雑なルール構成を追求する必要はありません。地理的に適切で、クライアントの接続テストに成功するノードを選び、既定のルールで確認するほうが、プロトコル、DNS、ルールセット、インターフェースの設定を同時に変更するより原因を特定しやすくなります。

直接接続の回線は、端末から対象ノードへ直接接続するため経路がシンプルですが、国際経路は現地通信事業者のルーティング変更の影響を受けやすくなります。中継回線は中継入口を経由してから国際経路へ進み、入口の品質と経路設計の改善を重視します。IEPL専用線は、安定性が重視される国際通信で使われることが多く、一般的なインターネット経由の直接接続とは経路設計が異なります。回線名はサービス側の分類を示すだけなので、実際の選択では利用中のネットワーク、対象アプリ、接続状況を合わせて判断してください。

システムプロキシはブラウザやシステム設定に従うデスクトップアプリに適しており、設定が簡単でいつでも無効にできます。仮想ネットワークインターフェースは、クライアントによって拡張モードやTUNモードと呼ばれ、より多くのアプリや一般的なプロキシ以外の通信をカバーできますが、ファイアウォール、他のVPN、仮想マシンのネットワーク、企業管理ツールと競合しやすくなります。初回インストールでは、まずシステムプロキシでサブスクリプションとノードを確認し、必要に応じて仮想ネットワークインターフェースを有効にしてください。

グローバルモードでは、制御対象の大部分の通信が現在のプロキシルールを通るため、「ルールで対象接続が漏れていないか」を短時間確認するのに適しています。ルールモードはドメイン、ネットワークアドレス、アプリのルールに基づいて直接接続とプロキシ接続を振り分け、日常利用に向いています。グローバルモードでも、すべてのデータが必ず同じ経路を通るわけではありません。LANアクセス、システムサービス、クライアントの除外項目は独自のルールで処理される場合があります。

DNS、ルール分岐、接続の確認

接続ボタンが有効になったら、出口経路、DNS解決、ルール分岐の結果を個別に確認します。まずネットワーク確認ページを開き、現在の出口が選択したノードと一致するかを確認します。次に、プロキシ接続が必要なサイトと直接接続すべきサイトへアクセスし、両方が正常に動作するか確認してください。ネットワークアドレスではアクセスできるのにドメインでは開けない場合はDNSの問題が考えられます。ブラウザは正常なのにデスクトップアプリだけ失敗する場合は、そのアプリがシステムプロキシを迂回していないか確認します。

DNSリークとは、ドメインの問い合わせが想定したクライアント設定の解決経路を通らず、ローカルネットワークが提供するDNSサーバーへ送られ続ける状態です。ウェブページが開けなくなるとは限りませんが、ルール分岐の判断が不正確になり、ドメインの問い合わせ経路と出口経路が一致しなくなる可能性があります。クライアントにDNS制御、暗号化DNS、リモート解決の設定がある場合は、まずプロジェクト推奨の既定値を使ってください。ブラウザ、システム、クライアントで互いに競合する複数のDNS設定を同時に使うのは避けます。

一部のブラウザには独自のセキュアDNS設定があり、クライアントのシステムDNS設定を迂回することがあります。確認時は一時的にブラウザを既定値へ戻し、クライアントのDNS経路が正常であることを確認してから、ブラウザ独自のDNS機能を使うか判断してください。会社、学校、ホテルのネットワークでポータル画面による認証が必要な場合は、接続制御を有効にする前にローカルネットワークへログインします。

• ✅ ノードの状態が接続済みで表示され、再接続を繰り返していない。
• ✅ ネットワーク確認の結果が、現在選択している出口地域と一致している。
• ✅ プロキシ接続が必要なドメインを正常に解決・表示できる。
• ✅ ローカルサイトとLANリソースがルールどおりにアクセスできる。
• ✅ クライアントを終了すると、システムのネットワークが正常に戻る。
• ❌ 1つのウェブページの表示結果だけで、すべてのアプリの状態を判断しない。

ルール分岐を確認する最も効果的な方法は、一度に1つの対象だけを観察することです。まず既定のルールで基本接続を確認し、次にクライアントの接続ログで対象ドメインがプロキシ、直接接続、拒否のどのルールに該当したかを確認します。固定のネットワークアドレス、QUIC、独自プロキシを使うアプリは、ブラウザと異なる動作をする場合があります。その場合はアプリの実際の接続方式に合わせてルールを調整し、すべての通信を恒久的にグローバルモードへ切り替えないでください。

よくある権限エラーと復旧の順番

「構成を追加できません」は、システム認証が完了していない、古い構成が競合している、現在のアカウントの権限が不足している場合に起こります。まず他の同種クライアントを終了し、システム設定で既存のVPNとネットワーク拡張を確認します。古い構成を使わないことを確認してから削除し、現在のクライアントを再起動して認証を促します。システム設定の承認待ち項目を処理せず、接続ボタンを繰り返し押しても通常は状況は変わりません。

「補助コンポーネントのインストールに失敗しました」は、アプリが「アプリケーション」フォルダにない、アプリのパスが変わった、署名検証に失敗した、古いコンポーネントが動作中である場合などに表示されます。クライアントを終了し、アプリを正しいフォルダへ移動して正式な入手先から再インストールし、もう一度起動してください。クライアントに補助コンポーネントのアンインストール機能がある場合は、不確かなシステムファイルを手動削除せず、その機能を優先します。

「サブスクリプションの更新に失敗しました」は、ネットワークに到達できない、URLが無効、形式に互換性がない、システム時刻に問題がある場合を切り分ける必要があります。まずサービス管理画面でURLを再コピーし、クライアントのエラー情報を確認してから、Macの日付と時刻が正常な自動設定になっているか確認します。サブスクリプションURLにはアクセス情報が含まれる場合があるため、通常の検索欄に直接貼り付けてテストしないでください。サービス管理画面にサブスクリプションのリセット入口がある場合は、古いURLを無効にする必要があることを確認してから操作します。

「接続済みなのにネットワークがありません」は、決められた順番で対処します。まず仮想ネットワークインターフェースを無効にしてシステムプロキシへ戻し、既定のルールに戻します。次に別の利用可能なノードへ切り替え、その後DNSを確認します。クライアント終了後もアクセスできない場合は、システムプロキシが残っていないか確認し、現在のWi-Fiまたは有線ネットワークへ再接続します。これらの基本項目をすべて確認してから、再インストールを検討してください。

トラブルシューティングでは、再現できる手順を残すことが原則です。エラーがインストール、認証、更新、接続、名前解決のどの段階で発生したかを記録し、一度に1つの変数だけを変更します。クライアント、ノード、モード、DNS、ルールを同時に変更すると一時的に解決しても、本当の原因を特定できません。

完全に再インストールする場合

完全に再インストールする前に、自分で作成したルールをエクスポートし、現在のサブスクリプション名と必要な設定を記録します。ただし、認証情報を含むサブスクリプションURLを公開メモに保存しないでください。次にクライアントでシステムプロキシと仮想ネットワークインターフェースを無効にし、プロジェクトが提供するアンインストール入口から補助コンポーネントを削除して、アプリを終了します。アプリを削除した後にMacを再起動すると、古いプロセスやネットワーク拡張が使用中のまま残る可能性を減らせます。

再インストール後は、すぐにすべてのカスタム設定を戻さないでください。まずメインのサブスクリプションを読み込み、既定のルールとシステムプロキシで基本接続を確認します。その後、DNS、ルール、拡張モードを1つずつ戻します。これにより問題がインストール環境にあるのか、古い設定にあるのか判断できます。既定の設定では接続でき、特定の設定を戻した後に問題が再現するなら、その設定が次に確認すべき対象です。

日常利用と設定のメンテナンス

初回インストール後は、シンプルで復元しやすい設定構成を保ちます。メインのサブスクリプションには分かりやすい名前を付け、カスタムルールとサービス側から配布されたルールを分けて管理してください。クライアントを更新する前にリリースノートを確認し、特にプロトコル対応、ネットワーク拡張、設定形式の変更に注意します。サブスクリプション更新後にノード一覧が変わった場合は更新結果を基準にし、サブスクリプションから削除されたローカルコピーに長く依存しないでください。

信頼できない公共ネットワークを離れる前後には、システムプロキシと仮想ネットワークインターフェースの状態を再確認できます。スリープからの復帰やネットワーク切り替え後は、長時間接続が古いネットワーク状態を引き継ぐことがあります。接続が停滞した場合は、まず切断して再接続し、すぐに設定を消去する必要はありません。Wi-Fiから有線ネットワークやテザリングへ切り替えた場合、クライアントは経路を再確立するため、一時的な再接続は正常な現象です。

最後に、サブスクリプションURLはアカウントの認証情報と同じように管理してください。メールアドレスなしでユーザー名とパスワードを使って本サービスを開通できますが、ローカルでも認証情報は他と分けて安全に保管します。クライアントのログは接続段階の特定に役立つ一方、ノードアドレス、ドメイン、設定の一部が含まれる場合があります。サポートへ送る前に内容を確認し、トラブルシューティングに不要な機密情報を削除してください。