目次
ダウンロード前に「このMacについて」で Apple Silicon か Intel かを確認する
Apple メニューから「このMacについて」を開きます。「チップ」に Apple M1、M2、M3、またはそれ以降の Apple シリーズと表示される場合は、Apple Silicon / arm64 ビルドを選択してください。「プロセッサ」に Intel と表示される場合は、x64 / Intel ビルドを選びます。中古端末や組織管理端末は購入年からの推測と一致しないことがあるため、システム情報を直接確認するのが最も確実です。
Clash Verge Rev など、実際のプロジェクトの Release ページから macOS 用ファイルをダウンロードしてください。ファイル一覧はバージョンタグとリリースノートに対応している必要があります。名称が似たファイル共有サイトの「Mac クラック版」は使用せず、ファイル名に Clash が含まれるだけで保守中だと判断しないでください。
Mac とファイルの表記
| Mac に表示される内容 | 選択肢 |
|---|---|
| Apple M シリーズのチップ | arm64 / Apple Silicon |
| Intel プロセッサ | x64 / Intel |
| Universal | 両方のアーキテクチャを含み、通常はファイルサイズが大きい |
| 判別できない | 推測せず、「このMacについて」に戻って確認する |
DMG はインストール用メディアです。アプリは Applications にドラッグしてください
標準的なインストール手順
ダウンロードした DMG を開く
Finder にアプリアイコンと Applications フォルダが表示されるまで待ちます。
アプリを Applications にドラッグする
コピーが完了したら Applications フォルダから起動し、DMG 上で使い続けないでください。
ディスクイメージを取り出す
アプリをコピーしたら、Finder のサイドバーから DMG を取り出せます。
元の Release 情報を残す
バージョンとアーキテクチャは、後のトラブルシューティングや更新でも必要になります。
Applications に同名の旧バージョンがある場合は、置き換える前にメニューバーのプログラムを完全に終了してください。古い ClashX、別の Mihomo クライアント、または VPN が同時に動作していると、それぞれがシステムプロキシを書き換え、新バージョンのインストールに失敗したように見えることがあります。
「開発元を確認できません」は「プライバシーとセキュリティ」で対処する
macOS でインターネットから取得したアプリを初めて開くと、開発元を確認できない、またはアプリがブロックされたと表示される場合があります。プロジェクトの Release、バージョン、ファイル名をもう一度確認し、「システム設定 > プライバシーとセキュリティ」で直前にブロックされた項目を探して、システムの「このまま開く」手順に従ってください。
Gatekeeper を全体で無効にするコマンドを実行したり、警告を回避するために出所不明の署名パッチをインストールしたりしないでください。システムによる個別アプリの例外で十分であり、ほかのダウンロードは引き続き保護されます。アプリが破損していると表示された場合は、セキュリティ属性をすぐ削除せず、正しいアーキテクチャのファイルを再度ダウンロードしてください。
メニューバーにアイコンが表示されたら、コアの状態が安定するまで待つ
初回起動時に画面が表示されても、Mihomo の準備が完了したとは限りません。設定またはログを開き、コアが繰り返し終了していないことと、クライアントが自身の設定ディレクトリを正常に読み書きできることを確認してください。この時点ではまだサブスクリプションをインポートしていないため、core failed や permission denied はローカルインストールの問題として先に対処します。
Rosetta の案内後にしかアプリが開かない場合は、Intel ビルドを選んだ可能性があります。Apple シリコンでも一部の Intel アプリは動作しますが、追加の依存関係や今後の更新時の混乱を減らすため、プロジェクトが提供する arm64 版への変更を推奨します。
初回設定ではサブスクリプションとシステムプロキシだけを使う
Profiles 画面で Clash または Mihomo 互換のサブスクリプションを追加し、手動で更新して選択します。Proxies を開いてノードを一つ固定し、モードは Rule のままにして System Proxy を有効にしてください。macOS からシステムプロキシ変更の許可を求められた場合、要求元のアプリが直前にインストールしたクライアントであることを確認します。
ブラウザで使い慣れたサイトを開くと、Connections に対応する接続が表示されるはずです。通常のシステムプロキシが動作するまでは、TUN を有効にしたりネットワーク拡張をインストールしたりしないでください。そうしないと、一度の失敗でサブスクリプション、ノード、システムプロキシ、ネットワーク権限を同時に調べることになります。
初回接続で確認できる結果
- Profile に今回の更新日時が表示される
- Proxies で特定のノードを選択できる
- 現在のクライアントが macOS のシステムプロキシを書き込む
- Connections で直前のブラウザリクエストを確認できる
アプリが開かない問題とWebページが開かない問題は、別々に調査する
アプリアイコンに禁止マークが付いている
macOS のバージョン要件とアプリのアーキテクチャを確認し、対応するビルドをダウンロードしてください。
アプリが破損していると表示される
元の Release から再度ダウンロードし、ファイルが完全で同じ配布元から取得されたことを確認してください。
サブスクリプション更新で 401 / 403 が返る
リンクの認証情報またはアカウント状態に問題があり、macOS の権限とは関係ありません。
ブラウザが失敗し、Connections に記録がない
System Proxy が書き込まれていることを確認し、ほかのプロキシクライアントを終了してください。
接続は Clash に入るが timeout になる
動作確認済みの別ノードへ切り替えてください。DMG を再インストールする必要はありません。
最初にエラーが出た画面に対応する階層へ戻って対処してください。アプリが起動し、Profile が更新でき、ノードを選択できるようになって初めて、Web接続の問題でプロキシとルールを調べる意味があります。
アンインストールやクライアント変更の前に、macOS を直接接続へ戻す
アンインストール、バージョンのロールバック、別クライアントへの移行を行う前に、現在のアプリでシステムプロキシと TUN を無効にし、メニューバーから完全に終了してください。ウィンドウを閉じただけでは、バックグラウンドプロセスがローカルプロキシポートを保持する場合があります。そのままアプリをゴミ箱へ移すと、Webリクエストが待受プロセスのないアドレスを参照し続けます。
macOS のネットワーク設定で HTTP、HTTPS、SOCKS プロキシが解除されていることを確認します。ブラウザはローカルで到達可能なサイトへ直接接続できる必要があります。直接接続が戻ったことを確認してから Applications のアプリと不要なデータを削除してください。移行時はサブスクリプションを再インポートし、二つのクライアントのデータディレクトリを上書きし合わないでください。
新しいクライアントで System Proxy を有効にした後、Connections に新しいブラウザリクエストが表示されれば、古いプロキシ設定は解消されています。これで、この Mac はアーキテクチャの選択、アプリのインストール、Gatekeeper の許可、サブスクリプションの追加、システムプロキシまでの初回設定を完了しました。今後バージョンを変更するときも、同じ終了手順と直接接続の確認を行ってください。
