ヘルプセンター · macOSの設定と接続のトラブル対処
Clash よくある質問
症状から確認しましょう。まず現在の設定と通信を取り込む方法を確認し、次にルールとリモート接続を調べます。Mac向けクライアントを中心に解説し、Windows固有の問題には注記しています。
基本知識
クライアント、コア、設定それぞれの役割を整理し、通信を取り込む方法と接続先モードを混同しないようにしましょう。
Clash、mihomo、Mac向けGUIクライアントの関係は?
Clashは一般に、プロキシコアとその設定エコシステムを指します。mihomoはClash Metaから発展したコアで、プロトコル接続、ルール照合、トラフィック転送を担います。Mac向けGUIクライアントは、コアに加えてメニューバー、購読管理、システムプロキシの切り替え機能などを提供します。どちらのクライアントもmihomoを使っていても、設定画面や補助サービス、コアの更新頻度は異なる場合があります。トラブル対処では、Clashだけでなくクライアント名とバージョン、コアのバージョンも記録してください。以前の設定を引き継げるかどうかは、使用している項目によって異なります。画面が似ていても、対応範囲が同じとは限りません。
クライアントをインストールしたのに、なぜ購読や設定ファイルが必要なのですか?
クライアントは設定を使って動作するためのツールであり、インストールしただけで利用可能なリモートプロキシが使えるようになるわけではありません。購読は通常、サービス提供元から配布され、ノードやプロキシグループ、ルールの取得に使います。自分で管理しているローカル設定をインポートすることもできます。インポート前に、Clashまたはmihomo互換の形式か、利用期限やデバイス制限があるかを確認してください。購読URLにはアカウント情報が含まれる場合があるため、パスワードと同様に扱い、公開フォーラムやスクリーンショット、オンライン変換サイトに載せないでください。設定がまだない場合は、まずインストールを済ませましょう。システムプロキシを何度切り替えても、接続情報の不足は解消されません。
ルール、グローバル、ダイレクトモードはどう使い分けますか?
普段はルールモードを選び、設定内のルールに従ってトラフィックの接続先を決めるのが基本です。グローバルモードでは接続をグローバル用プロキシグループに渡しますが、そのグループで利用可能な接続先を選ぶ必要があります。また、すべてのアプリの通信がクライアントに取り込まれるとは限りません。ダイレクトモードでは、取り込まれた接続が宛先へ直接アクセスします。システムプロキシがオフになったり、クライアントが終了したりするわけではありません。特定のサイトで問題が起きた場合は、一時的にモードを切り替えて比較し、その後ルールモードに戻して適用ルールを確認してください。アプリの通信を取り込む方法と、接続先を選ぶ方法は別の設定です。前者はシステムプロキシ、アプリ内設定、TUNなどで決まります。
プロキシを使うと、HTTPSの内容やアクセス履歴は誰に見られますか?
通常のHTTPS接続では、アプリと接続先のWebサイト間で通信が暗号化されます。一般的なプロキシ転送にルート証明書のインストールは必要ありません。ただし、プロキシサービスから接続時刻、接続先、通信量などのメタデータが見える可能性があるため、サービス提供元のデータ取り扱いを確認しましょう。証明書をインストールしてHTTPS通信を復号する操作を求められた場合は、その目的と信頼できる範囲を別途検討してください。クライアントのログにドメイン名、接続エラー、設定ファイルのパスなどが含まれる場合もあります。診断情報を共有する前に、購読URL、認証情報、個人情報を隠してください。プロキシを有効にすれば、すべてのアクセスが追跡不能になるわけではありません。
インストールと設定
アーキテクチャの選択、アプリの起動、購読の有効化、ヘルパーサービスの許可の順に確認しましょう。
AppleシリコンとIntel Macでは、どのインストーラーを選べばよいですか?
Appleメニューから「このMacについて」を開き、Apple Mシリーズのチップと表示される場合はarm64またはApple Silicon版を、Intelプロセッサと表示される場合はx64またはx86_64版を選びます。Universal版がある場合は、クライアントの案内に従ってインストールしてください。AppleシリコンでIntel版を実行するにはRosettaが必要な場合がありますが、互換性の問題を減らすため、ネイティブ版を優先しましょう。クライアントが要求するmacOSの最低バージョンも確認してください。アーキテクチャが合っていても、macOSのバージョンが要件を満たすとは限りません。具体的な入手先はインストーラーのページを確認し、MacBookの外観や購入年だけで判断しないでください。
macOSで「開発元を検証できません」または「アプリが破損しています」と表示された場合は?
まず、表示された警告の内容を確認し、インストーラーの入手元、チップのアーキテクチャ、システム要件を確かめてください。アプリを「アプリケーション」フォルダに移動してから開きます。起動がブロックされた場合は、「システム設定」の「プライバシーとセキュリティ」に「このまま開く」が表示されるか確認し、入手元を確認できたアプリに限って操作してください。「アプリが破損しています」という警告は、ダウンロードの失敗、署名の問題、バージョンの非互換性が原因の場合もあります。再ダウンロードしてリリースノートを確認しましょう。不明なアプリを起動するためにシステム保護を一律に無効化したり、出所不明のターミナルコマンドをコピーしたりしないでください。マルウェアの警告が表示された場合は、起動を中止して入手元を確認してください。
購読をインポートして、現在の設定が有効になったことを確認するには?
クライアントの購読または設定画面でURLからのインポートを選び、サービス提供元から受け取ったURL全体を貼り付けて保存します。取得と解析が終わるまで待ちます。その後、この設定を現在の設定として選択し、プロキシ画面に対応するプロキシグループが表示されているか確認してください。手動選択が必要なグループでは、接続先も指定します。購読の記録が一覧に表示されていても、取得に成功したことや設定が有効になったことを意味しません。インポートに失敗した場合は、HTTPステータスと解析エラーを確認し、URLにアクセスできないのか、形式が非対応なのかを切り分けてください。WebサイトのアカウントログインURLを購読URLとして使わないでください。ローカルファイルはファイルのインポート機能から開きます。
TUNモードで許可が必要なのはなぜですか?許可に失敗した場合は?
TUNは仮想ネットワークインターフェースを作成してルーティングを変更するため、Mac向けクライアントでは通常、特権ヘルパーサービスを使って処理します。そのため、管理者の許可を求められることがあります。まずクライアントの設定で案内に従ってヘルパーサービスをインストールまたは修復し、その後TUNを有効にして、コアのログにインターフェースの作成成功が記録されているか確認してください。許可を取り消した場合、サービスが起動していない場合、サービスとクライアントのバージョンが合っていない場合は、スイッチがすぐに元に戻ることがあります。他のVPNや類似のトンネルツールをいったん終了して再試行できますが、システムのネットワーク設定をむやみに削除しないでください。組織管理のデバイスで許可を得られない場合は、管理者に相談してください。システムプロキシに対応するアプリなら、一時的な利用方法として使えます。
手順を追って設定するには、購読のインポートとクイックスタートガイドをご覧ください。チップに合ったバージョンはMac用インストーラーで確認できます。
使い方
接続画面でリクエストがコアに届いているかを確認し、適用ルールと最終的な接続先を追跡しましょう。
システムプロキシを有効にしているのに、ブラウザがプロキシ経由にならないのはなぜですか?
まず、コアが動作中で現在の設定が有効か、システムプロキシのアドレスとポートがクライアントの実際の待ち受け設定と一致しているか確認してください。次に「システム設定」の「ネットワーク」で、現在使用中のWi-FiまたはEthernetサービスのプロキシ設定を確認します。ネットワークサービスを切り替えた場合、以前のサービスの設定が適用されるとは限りません。ブラウザの拡張機能、アプリ内プロキシ、他のVPNによって接続経路が上書きされることもあります。クライアントの接続画面を開き、テスト用Webサイトを再読み込みして、接続と接続先のプロキシグループが表示されるか確認してください。接続が表示されない場合は、通信を取り込む設定を確認します。接続が表示されてもダイレクト接続になっている場合は、システムプロキシを繰り返し切り替えるのではなく、ルールと除外リストを確認してください。
ターミナルのcurlやGitがmacOSのシステムプロキシを使わないのはなぜですか?
多くのコマンドラインツールはmacOSのシステムプロキシを参照せず、独自の設定やプロキシ環境変数を使います。まずクライアントのHTTPまたはmixedの待ち受けポートを確認し、各ツールのドキュメントに従ってプロキシを設定してください。たとえばcurlはコマンドごとにプロキシを指定でき、Gitは独自のプロキシ設定を変更できます。システムプロキシを参照しないアプリも含めて通信を取り込む必要がある場合は、TUNの利用を検討してください。調査時には、HTTP_PROXY、HTTPS_PROXY、ALL_PROXYが終了済みのクライアントや古いポートを参照していないか確認しましょう。環境変数を変更した後は、現在のターミナルセッションに反映されていることを確認してください。複数の接続方法を同時に変更すると、どの設定が影響したのか判断しにくくなります。
ルールモードで特定のサイトが誤ったプロキシグループを使う場合、どこを変更すればよいですか?
まず接続画面で対象のリクエストを探し、実際のドメイン、適用されたルール、最終的な接続先を確認します。ルールは通常、上から順に照合されるため、後方の詳細なルールより先に、前方の広いルールが適用されることがあります。プロキシグループが別のグループを参照している場合もあるため、グループ間の関係をたどって最終的な選択を確認してください。特定のドメインの経路を変更する場合は、クライアントが対応しているオーバーライド機能や追加ルール機能を優先し、ルールの挿入順に関する説明に従います。購読からダウンロードしたファイルを直接編集すると、次回の更新で上書きされることがあります。ルールに指定するプロキシグループ名が実在することを確認し、変更後に設定を再読み込みして新しい接続を作成してください。既存の接続はすぐには切り替わらない場合があります。
WindowsのUWPアプリが接続できない場合に関係する、ループバック制限とは?
これはWindowsのアプリコンテナーに関する問題であり、macOSの権限設定とは関係ありません。アプリコンテナー内で動作する一部のUWPアプリは、既定ではローカルのループバックアドレスにアクセスできません。一方、デスクトッププロキシは通常ローカルで待ち受けるため、ブラウザが使えてもUWPアプリが接続できるとは限りません。まずWindowsクライアントのループバック除外ツールを使い、必要なアプリにローカルプロキシへのアクセスを許可してください。管理者の許可を求められた場合は、その案内に従います。クライアントが対応していれば、TUNで通信を取り込む方法も検討できますが、アプリ固有の動作や他のファイアウォール制限も確認してください。Macで同じ名前の設定を探したり、ファイアウォール全体を恒久的に無効にしたりして回避しないでください。
トラブル対処
使える設定を残したうえで、購読の取得、リモート接続、名前解決、システムの復旧の順に原因を調べましょう。
購読が突然使えなくなった、または更新時に401、403、404が返る場合は?
まずサービス提供元のアカウントで、有効期限や通信量の状態、購読URLが再発行されていないか確認してください。401は認証、403はアクセス制限やアカウント制限、404はリンクの変更が関係することがありますが、最終的にはサービス提供元の案内を確認してください。ログインページや認証ページが返された場合、設定ファイルではないためクライアントで解析できません。URL全体を確認してから更新し、クライアントが対応していれば、ダイレクト接続またはプロキシ経由での取得も試してください。購読の取得経路が、すでに使えなくなった接続に依存しないようにします。元の有効な設定を残してから作業し、最初にすべての購読を削除しないでください。サービス提供元に問い合わせるときは、ステータスコードと発生時刻を伝え、URL全体は公開しないでください。
すべてのノードがタイムアウトする場合と、1つだけタイムアウトする場合を切り分けるには?
まずプロキシを無効にして、基本的なネットワーク接続が使えるか確認し、1つの接続先だけの問題か、すべての接続先の問題かを切り分けます。1つだけタイムアウトする場合は、同じプロキシグループ内の別の接続先に切り替え、サービス側でメンテナンスが行われていないか確認してください。すべてがタイムアウトする場合は、購読の状態、システム時刻、コアが設定内のプロトコルに対応しているか、ログに名前解決やハンドシェイク、認証のエラーがないか確認します。接続テストのタイムアウトは、テスト先が使えない場合やタイムアウト時間が短すぎる場合にも起こります。テスト結果だけでノードの停止と判断せず、実際のWebアクセスも試してください。ネットワークを変えると復旧する場合は、現在のネットワーク経路に違いがある可能性があります。調査中は一度に1つの条件だけを変え、結果を記録しましょう。
TUNを有効にするとドメインにアクセスできないのに、一部のアプリは接続できる場合、DNSをどう確認すればよいですか?
まずログに名前解決の失敗、DNSリクエストのタイムアウト、ルーティングのループがないか確認します。次に、現在の設定にあるDNSサーバー、TUNのDNSハイジャック、ルーティング設定が連携しているか確認してください。ブラウザのセキュアDNS、他のVPN、システムに設定したカスタムDNSによって、アプリごとに異なる経路で名前解決される場合があります。macOSの名前解決ツールとアプリが同じ経路を使うとは限らず、1回のコマンド結果で全アプリの状態を判断することはできません。fake-ipを使っている場合は、関連するアドレスが正しく通信対象として取り込まれているか確認し、非対応のLANサービスは設定の説明に従って例外に追加してください。まず既知の動作する設定に戻して比較し、DNS、ルール、すべてのノードを一度に変更しないでください。
クライアント終了後にインターネットへ接続できなくなった場合、Macのネットワーク設定を元に戻すには?
クライアントをまだ開ける場合は、システムプロキシとTUNを無効にしてから通常の手順で終了し、ネットワークが復旧するか確認します。アプリがすでに異常終了している場合は、「システム設定」の「ネットワーク」で現在使用中のネットワークサービスを選び、「詳細」の「プロキシ」にローカルホストを指す設定が残っていないか確認してください。クライアントの設定だと確認できた項目のみをオフにして、設定を適用します。他のVPN、ターミナルのプロキシ環境変数、手動で設定したDNSも確認してください。管理対象デバイスのプロキシ設定は組織によって構成されている場合があるため、むやみに削除しないでください。TUNのルートやヘルパーサービスが正常に解除されていない場合は、作業を保存してMacを再起動し、プロキシを経由しないリクエストで基本的なネットワーク接続を確認します。
見慣れないプロトコルやコアの設定項目がログに含まれる場合は、プロトコルとコアの技術資料をご覧ください。用語の意味は用語集で確認できます。