Windows
システム情報でデバイスのアーキテクチャを確認します。初めて使う場合は、まずシステムプロキシを有効にし、ブラウザーの接続がログに記録されるか確認してください。システムプロキシを参照しないアプリも接続する場合は、クライアントのTUN対応状況と必要な権限を確認します。古い設定を移行する前に元のアプリを終了し、複数のクライアントが同時にプロキシ設定を書き換えたり、待ち受けポートを取り合ったりしないようにしてください。
ダウンロードページへOSに合ったクライアントを選び、mihomoコアとYAML設定を確認。サブスクの追加からルール分岐の検証まで解説します。
サブスク全体はクライアントに読み込ませ、プロキシプロバイダーはコアに設定を読み込ませます。
設定一覧に互換性のあるサブスクURLを貼り付け、ダウンロードと解析が終わったら、現在の設定として選択します。手動入力と異なり、リモートサブスクは更新でき、ノード名の変更が既存の選択に影響する場合もあります。プロキシプロバイダーだけを使う場合は、proxy-providersで読み込み、プロキシグループから参照します。どちらもYAMLを返すURLでも、相互に置き換えられるとは限りません。更新に成功してもノードが表示されない場合は、まず取得した内容の種類を確認し、次にプロキシグループが正しいプロバイダーを参照しているか確認してください。
proxy-providers: office: type: file path: ./providers/office.yamlproxy-groups: - name: PROXY type: select use: [office]個別のルールを先に記述し、最後にフォールバックルールを置きます。
ルールモードではリストの上から順にリクエストを照合し、通常は最初に一致したルールが適用されます。ドメインサフィックスルールはサブドメインの分類に、IPアドレス範囲のルールは既知のネットワーク範囲の指定に適しています。グローバルモードと異なり、ルールモードでは接続先ごとに異なる出口を指定できます。設定では範囲の狭い例外を先に、広いルールを後に記述し、最後にMATCHでフォールバックします。意図しない出口につながる場合は、ノードを入れ替える前に接続ログで実際に適用されたルールとプロキシグループの選択先を確認してください。
mode: rulerules: - DOMAIN,docs.example.com,DIRECT - DOMAIN-SUFFIX,example.com,PROXY - MATCH,DIRECTDNSの接続方式によって、名前解決のリクエストがコアを経由するかどうかが決まります。
fake-ipモードでは、アプリに仮想IPアドレスを返し、コアが対応関係から接続先のドメイン名を特定します。実際のIPアドレスを直接返す方式とは異なり、その後の接続も対応関係を認識できるコアを経由する必要があります。設定時は、システムとアプリが使用するDNSの接続先を確認してください。実IPアドレスを必要とするLAN内サービスは、必要に応じてfake-ip-filterに追加します。変更後は同じアプリから接続し直し、古いDNSキャッシュやアプリ独自の名前解決による違いを、ルールの不具合と誤認しないようにしましょう。
dns: enable: true enhanced-mode: fake-ip fake-ip-filter: - '+.lan' nameserver: - systemサブスクの内容はそのままにし、ローカルの変更は個別の上書き設定に分けます。
リモートサブスクから生成された設定を直接編集すると、更新時に変更が失われることがあります。上書きに対応したクライアントでは、ポート、ログレベル、ローカルの例外などを個別に保存し、起動前にマージできます。マップやリストの扱いはクライアントごとに異なり、マップはキー単位で更新、リストは全体置換される場合があります。リストの先頭への追加や末尾への追加に対応するクライアントもあります。あるクライアントのマージ構文を別のクライアントに流用しないでください。保存後は最終的な設定を開き、ルールの順序、プロキシグループの参照先、待ち受けアドレスが想定どおりか確認します。
mixed-port: 7890allow-lan: falselog-level: infoコアの切り替えにはクライアント側の対応が必要です。設定項目が自動的に互換になるわけではありません。
画面を提供するクライアントと、設定を実行するコアは別々に更新されることがあります。コアを切り替えられるクライアントでは、まず現在の設定を残し、移行先のコアでそのコピーを読み込んで、プロトコル、ルールセット、DNSの設定項目が認識されるか確認してください。コアが固定されたクライアントでは、アプリを更新するか、別のクライアントを選びます。右側の最小構成は、起動の問題とサブスクの問題を切り分けるための直結設定です。まずコアが設定を読み込み、ポートを待ち受けていることを確認してから、プロキシグループとルールを少しずつ戻すと、互換性のない部分を特定しやすくなります。
mixed-port: 7890mode: rulerules: - MATCH,DIRECTまずOSで絞り込み、CPUアーキテクチャ、インストール方法、メンテナンス状況を確認してください。旧クライアントから移行する場合は、サブスクまたは設定ファイルを読み込む方法を優先し、新しいクライアントのアプリデータフォルダーを直接上書きしないでください。
システム情報でデバイスのアーキテクチャを確認します。初めて使う場合は、まずシステムプロキシを有効にし、ブラウザーの接続がログに記録されるか確認してください。システムプロキシを参照しないアプリも接続する場合は、クライアントのTUN対応状況と必要な権限を確認します。古い設定を移行する前に元のアプリを終了し、複数のクライアントが同時にプロキシ設定を書き換えたり、待ち受けポートを取り合ったりしないようにしてください。
ダウンロードページへ「このMacについて」でApple SiliconかIntelかを確認し、対応するインストーラーを選びます。プロキシを初めて有効にした後は、システム設定のネットワークで、現在のネットワークサービスに設定が適用されているか確認してください。クライアント終了後もアプリがローカルのプロキシポートに接続しようとする場合は、サブスクを何度も読み込み直すのではなく、システムプロキシ設定が元に戻っているか確認します。
ダウンロードページへシステムが対応するABIに合ったインストーラーを選びます。CPUが特定の命令セットに対応していても、現在のシステムにそのパッケージをインストールできるとは限りません。初回接続時は、システムの案内に従ってVPNを許可してください。画面ロック後に接続が切れる場合は、通知領域の状態を記録し、アプリのバックグラウンド実行制限や、別のVPNサービスが接続を引き継いでいないか確認します。
ダウンロードページへApp StoreでクライアントとOSの互換性要件を確認します。設定を読み込んでVPN構成の追加を許可したら、クライアントに戻り、選択中の設定とプロキシグループを確認してください。ステータスバーにVPN接続中と表示されても目的のアプリが使えない場合は、まずブラウザーで同じ接続先を確認し、次にアプリの接続ログを確認して、トンネルの起動とリクエストの転送を切り分けます。
ダウンロードページへデスクトップ環境では、ディストリビューションに合ったパッケージ形式を選べます。たとえばDebian系にはDEB、対応するディストリビューションにはRPMを使用します。デスクトップ環境のないデバイスでは、コアを単独で実行できますが、設定ディレクトリ、サービスの権限、ログを自分で管理する必要があります。起動後は、システム設定、環境変数、その他の接続方法を通じて、アプリからコアにリクエストが届いていることも確認してください。
ダウンロードページへサブスクまたは設定の画面で、提供元から入手した互換性のあるURLを追加します。ローカルのYAMLファイルを選ぶこともできます。ファイルが一覧に表示されたら、現在の設定として選択してください。読み込みに失敗する場合は、取得した内容が設定本文ではなく、ログインページやサービスの案内ページになっていないか確認します。スクリーンショット、ログ、問い合わせにはサブスクURLを載せないでください。
ルールモードを選び、プロキシグループで使用する出口を確認します。デスクトップではまずシステムプロキシを使い、モバイルでは案内に従ってVPNを許可してください。まず一つの接続方式で動作を確認し、TUNが必要かどうかはその後に判断します。コアが実行中でも、アプリの通信がコアを経由しているとは限りません。両方の状態を個別に確認してください。
直結する想定の接続先と、プロキシ経由の想定の接続先を一つずつ選び、順にアクセスして接続ログを確認します。対象ドメイン、適用されたルール、最終的な出口を照合してください。ログがない場合は、まずプロキシへの接続設定を確認します。ログがあり出口が違う場合は、ルールの順序を確認してください。適用ルールと出口がどちらも想定どおりの場合に限り、リモート側への接続を調べます。
オリジナル版Clashの設定は、プロキシノード、プロキシグループ、ルールを中心に構成されています。その後、異なるプロジェクトがこの形式を引き継いだり拡張したりしていますが、名前が似ていても配布元やメンテナンス期間が共通とは限りません。古いガイドでは画面上の項目が変わっている場合があります。読む際は、コアの設定項目、クライアントの操作、サブスク提供元の変換ルールのどれを扱っているか確認してください。
クライアントは設定管理、システムとの連携、接続状況の表示を担当します。コアは設定の解析、ルール照合、接続の確立を担い、サブスク提供元は配信内容を管理します。同じサブスクでも、クライアントによって結果が異なることがあります。たとえば、一方のクライアントだけがDNSや待ち受け設定を追加している場合があります。問題を調べるときは、サブスクの原文と最終的に適用された設定をそれぞれ保存し、画面上のスイッチだけでなく内容の差分を比較してください。
mihomoはClash Metaコアの開発を引き継ぎ、プロキシプロトコル、ルールセット、ネットワークスタックの設定項目を拡張しています。オリジナル版の設定でよく使われる基本項目は移行時の出発点になりますが、同名の項目でも値の範囲や関連する条件は移行先のコアに合わせて確認してください。設定の解析に失敗した場合は、エラーメッセージから最初の該当項目を特定し、設定リファレンスを確認します。用語が分からない場合は、用語集を参照してください。
クライアントとコアの変更履歴は分けて確認してください。アップデート前に、動作している設定と必要なローカル上書きを保存します。更新後は、まず設定が読み込めることを確認し、次にシステムプロキシ、名前解決の経路、ルールの適用状況を確認してください。再現可能な問題を報告する際は、使用したプラットフォーム、接続方式、最小限の再現用設定を記載し、個人のドメイン名、サブスクのパラメーター、ノードの認証情報は削除します。まず実際に起きたことを説明し、その後に期待する結果を記載すると、問題の切り分けに役立ちます。
コアはGPL-3.0で公開されています。以下のコマンドはソースコードを取得するためのもので、デスクトップクライアントのインストールには使いません。GUIクライアントをインストールする場合は、インストーラーのページに戻り、OSに合ったものを選んでください。
git clone https://github.com/MetaCubeX/mihomo.git
対応プラットフォーム、コアのバージョン、画面の操作性、TUN対応、設定の上書き機能を比較し、利用シーンに合わせたClashクライアントの選び方を紹介します。
すべてのノードがタイムアウトする場合や、特定のノードだけ接続できない場合に、サブスクの有効性、ローカルポート、DNS、システム時刻、ルールの適用状況を順に確認し、原因に応じた対処法を解説します。
Windows版Clashクライアントのインストールから、サブスクの追加、システムプロキシ、TUNモードの設定までを順に解説。ファイアウォールの遮断、ポート競合、サービスモードの権限など、よくある問題も紹介します。