Clash ダウンロード
クライアントとコア

Windowsのシステム要件とインストール条件

インストール後、スタートメニューからクライアントを起動します。画面が真っ白な場合は、まず実行コンポーネントを確認してください。ポート使用中のメッセージが表示された場合は、他のプロキシアプリを終了してから再試行します。システムプロキシを有効にしても、すべての端末アプリが自動的にプロキシを使うわけではありません。違いについてはトラブルシューティングガイドをご覧ください。

macOSのシステム要件とインストール条件

初回起動時にセキュリティ警告が表示された場合は、ダウンロード元とソフトウェア名を確認し、「システム設定 → プライバシーとセキュリティ」で具体的な理由を調べてください。アプリを起動するために、システムのセキュリティ機能をまとめて無効にしないでください。更新前にはメニューバーの旧プロセスを終了し、新しい画面が終了していない旧サービスに接続するのを防ぎます。

Androidのシステム要件とインストール条件

画面ロック後に接続が切れる場合は、まずバッテリー最適化とバックグラウンド制限を確認し、その後クライアントのログを確認します。特定のアプリだけ接続できない場合は、アプリごとの振り分けや除外リストを確認してください。すぐにアンインストールして再インストールする必要はありません。署名の競合を解消するため旧版を削除する場合は、ローカルルールやサブスクリプション情報を失わないよう、事前に設定をエクスポートしてください。

iOS・iPadOSのインストール要件

インストール後、まず現在のWi-Fiでサブスクリプションをダウンロードし、接続を確認してからモバイル通信でテストしてください。特定のネットワークだけで失敗する場合は、DNS、キャプティブポータル、アクセス制限を個別に確認します。すべてのルールをすぐに変更しないでください。スクリーンショットを共有する際は、サブスクリプションURLに含まれる識別情報を隠してください。

Linuxのシステム要件とインストール条件

依存関係のエラーが出た場合は、エラー全文を保存し、ディストリビューションのパッケージマネージャーで解決してください。依存関係を無視して進めないでください。GUIのない環境では、コアを動かすためにデスクトップ環境をインストールする必要はありません。サービスの起動に失敗した場合は、ファイアウォールやDNSを調べる前に、設定ファイルのパス、実行権限、ポートの競合を確認します。

コアの実行要件と導入手順

展開したバイナリを置いただけでは、システムサービスとしてインストールされたことにはなりません。まず端末のフォアグラウンドで実行し、設定の解析とポートの待ち受けを確認してから、自動起動を設定してください。Linuxのバイナリには実行権限の付与が必要な場合があります。サービスの作業ディレクトリは対話型端末と異なるため、設定ファイルのパスは明示するのがおすすめです。

以下のコマンドは、Linuxのカレントディレクトリに mihomo バイナリと config.yaml 設定ファイルがあることを前提としています。設定を確認してからフォアグラウンドで起動してください。コマンド自体は透過プロキシのルールを作成しません。

chmod +x ./mihomo
./mihomo -t -f ./config.yaml
./mihomo -f ./config.yaml

ルーターに導入する場合は、ゲートウェイ、DNS、転送経路の役割分担を個別に確認してください。メインルーターとサブルーターが同時に通信を処理すると、ループが発生するおそれがあります。設定の解析に成功しても接続できない場合は、待ち受けアドレス、ルール参照、外部への接続を確認してください。バイナリを何度も入れ替えるだけでは解決しません。