Windows
システムのデバイス情報でCPUアーキテクチャを確認してください。一般的なIntel・AMD搭載PCにはx64版を使います。ARM搭載端末では、選んだクライアントに対応するビルドがあるか確認しましょう。インストール後は設定を読み込んでからシステムプロキシを有効にします。テストに成功しても一部のアプリだけプロキシを経由しない場合は、アプリがシステム設定を引き継いでいるか確認してください。すぐにサブスクリプションを変更する必要はありません。
ダウンロードオープンソースコア · 設定リファレンスを随時更新
OSに合わせて対応クライアントを選び、YAMLの例で mihomo のポート、DNS、ルールによる振り分けを確認できます。
01 Downloads
まずOSを確認し、次にインストーラーのアーキテクチャを選びます。デスクトップではGUIクライアントと単体コアも区別しましょう。初めて使う場合はGUIクライアントから始めるのがおすすめです。
システムのデバイス情報でCPUアーキテクチャを確認してください。一般的なIntel・AMD搭載PCにはx64版を使います。ARM搭載端末では、選んだクライアントに対応するビルドがあるか確認しましょう。インストール後は設定を読み込んでからシステムプロキシを有効にします。テストに成功しても一部のアプリだけプロキシを経由しない場合は、アプリがシステム設定を引き継いでいるか確認してください。すぐにサブスクリプションを変更する必要はありません。
ダウンロード「このMacについて」でチップまたはプロセッサを確認し、Apple Silicon版かIntel版を選びます。メニューバーの表示でクライアントの起動状態は確認できますが、すべてのアプリの通信がプロキシ経由とは限りません。設定を切り替えたら接続ログで現在のリクエストを確認します。テスト終了後はシステムのプロキシ設定が元に戻っていることも確認してください。
ダウンロード端末が対応するアプリのアーキテクチャに合わせてインストーラーを選びましょう。プロセッサが64ビットかどうかだけで判断しないでください。初回起動時は通常、システムからVPN接続の許可を求められます。バックグラウンドに移ると接続が切れる場合は、クライアントの動作状態とシステムのバッテリー管理を確認してください。仕事用プロファイルや別のVPNがある場合は、現在の接続をどのアプリが管理しているかも確認しましょう。
ダウンロードダウンロードページからApp Storeを開き、対応クライアントとシステム要件を確認します。設定を読み込んだら、システムの案内に従ってVPN構成の追加を許可し、クライアントに戻って選択中の設定を確認してください。デスクトップで保存したYAMLは移行の出発点になりますが、ローカルファイルのパス、プロキシモード名、詳細設定はそのまま使えない場合があります。
ダウンロードデスクトップクライアントは、ディストリビューションが対応するパッケージ形式とCPUアーキテクチャに合わせて選びます。インストール前に、システムのパッケージマネージャーが使う形式を確認してください。同じアーキテクチャでも形式の異なるパッケージは互換ではありません。ターミナルとデスクトップアプリのプロキシ設定は別々の場合があります。ターミナルからの通信だけが失敗するなら、そのプログラムが実際に参照するプロキシ設定を確認しましょう。
ダウンロード02 Config Reference
まずインバウンド、アウトバウンド、マッチ条件を区別しましょう。項目を選ぶと対応する設定例を確認できます。各例は設定の一部分を解説するもので、サブスクリプションやノードを含む完全なファイルではありません。
混合ポートは、ローカルアプリからのHTTP接続とSOCKS接続を同時に受け付けます。アプリがコアに接続するためのポートであり、リモートノードのポートではありません。この端末だけで使うなら、まずLANからの接続を無効にし、アプリに設定したアドレスとポートを確認しましょう。ポートが使用中の場合は、該当プロセスを特定してからコアとアプリの設定をそろえて変更します。片方だけ変更すると、リクエストがコアに届かず、接続ログにもルールの適用が記録されないことがあります。
まずリクエストがコアのDNSモジュールに届いているか確認し、そのうえで名前解決モードが適切か判断します。fake-ipは一時的なマッピングアドレスを返し、後続の接続でコアがドメイン名を識別できるようにします。システム上のすべてのDNS問い合わせが自動的にコアへ渡るわけではありません。トラブル時はブラウザーのセキュアDNS、システムの名前解決、コアの名前解決を分けて確認してください。特定のドメインだけがマッピングアドレスに対応しない場合は、そのドメインのフィルター設定を確認し、DNS設定全体を変更するのは避けましょう。
mixed-port: 7890
allow-lan: false
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
ルールモードでは上から順に評価され、最初に一致した有効なルールで指定されたアウトバウンドが使われます。ドメインサフィックスルールは同じ末尾を持つドメインに適用され、地域ルールには対応する地理データが必要です。対象を絞った例外は、より広範囲に適用されるルールより前に置き、条件のない MATCH は末尾に配置します。通信の振り分けが想定と違う場合は、接続ログで実際に一致したルールを確認し、ルールの宛先と現在のプロキシグループを調べましょう。ルールが正しくても、グループ内で選択したアウトバウンドが違えば結果も変わります。
url-testはテスト先への接続性と応答時間に基づいて候補のアウトバウンドを選び、許容差を設定して頻繁な切り替えを抑えられます。測定されるのはテスト経路であり、すべての通信が同じ経路を通るとは限りません。fallbackはあらかじめ定めた優先順位で利用可能な項目を選ぶ用途に、load-balanceは接続の分散に適しています。例にある2つのノード名は、同じ設定ファイル内で定義されている必要があります。テスト先も、そのネットワークで利用できることを確認したアドレスに変更してください。
mode: rule
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- GEOIP,LAN,DIRECT,no-resolve
- MATCH,DIRECT
proxy-groups:
- name: 自動速度テスト
type: url-test
proxies: [ノードA, ノードB]
url: https://example.com/
interval: 300
tolerance: 50
proxiesは、コアがリモートノードに接続する方法を定義します。ノードのtypeによって、ほかの項目の解釈が決まります。以下はSOCKS5の例で、アドレスにはドキュメント用の予約済みネットワークを使用しているため、接続先としては使えません。リモート側のportをシステムのローカルプロキシポートに設定しないでください。また、あるプロトコルの通信オプションを別のプロトコルにそのまま流用しないでください。読み込み時に未対応の項目が表示されたら、クライアント名だけでなく、実行中のコアとノードのプロトコルを確認しましょう。
まず通常のログで起動、設定の読み込み、接続処理を確認し、必要な場合に限って一時的にデバッグログを有効にします。編集して保存しただけでは、コアが設定を再読み込みしたとは限りません。クライアントの上書きレイヤーでログレベルが変更されている場合もあります。問題を再現する前に現在の設定名を記録し、同じアプリからリクエストを1回送って、接続ログと発生時刻を照合してください。ログを共有する前にサブスクリプションURL、ノードの認証情報、公開に適さないドメインを削除し、確認後は元のログレベルに戻しましょう。
proxies:
- name: ドキュメント用の例
type: socks5
server: 192.0.2.10
port: 1080
log-level: info
設定を読む順序:まず mixed-port や mode などのトップレベル項目を確認し、次に proxies で定義されたアウトバウンドを調べます。最後に proxy-groups と rules がそれらの名前をどう参照しているか確認しましょう。プロキシグループ名も参照先の一部です。名前を変更する場合は、グループ内の入れ子の参照とルール末尾の宛先も合わせて変更してください。YAMLの解析に成功しても、コアが読み込みを拒否することがあります。
変更する場所:サブスクリプション元、ローカルの上書き設定、クライアントが生成した最終設定は、それぞれ別のファイルです。更新後に変更が消えた場合は、まずどの層を編集しているか確認してください。変更を長期的に保持するには、クライアントが対応する上書きレイヤーを使い、リストの内容が追加されるのか置き換えられるのかも確認します。特に rules は、全体を置き換えると既存の例外が消えることがあり、MATCH の後ろに追加すると一致しなくなる場合があります。構文の詳細は設定項目リファレンスをご覧ください。
03 Quick Start
初めて使うときは、設定を読み込んで選択し、通信の入口を有効にして、リクエストを1回送って確認するだけです。まず基本の接続を確立し、その後でDNSやルールを調整しましょう。
クライアントの設定画面を開き、手元の情報に合わせてサブスクリプションURLまたはローカルYAMLを選びます。更新に成功したら、その設定を選択してプロキシ画面でグループを展開できるか確認してください。ファイル名が表示されるのは設定項目が保存されたということにすぎません。グループとメンバーが表示されれば、読み込みが成功した可能性が高まります。エラーが出た場合は、該当行、項目名、ダウンロード時のメッセージを確認してください。同じサブスクリプションを続けて追加する必要はありません。
config.yaml · 設定の読み込み
ドメイン名やアドレスに応じて通信を振り分ける場合は、まずルールモードを選び、プロキシグループで使用中のアウトバウンドを確認します。デスクトップではクライアントの説明に従ってシステムプロキシを有効にし、モバイルでは案内に従ってVPN接続を設定してください。接続方式とプロキシグループを同時に変更しないようにしましょう。結果が変わったとき、どちらの設定が影響したのか分かりにくくなります。別のプロキシがすでに動作している場合は、今回使う接続経路を先に確認してください。
mode: rule · システムプロキシ
普段使うアプリでページを再読み込みし、接続ログから該当ドメイン、一致したルール、実際のアウトバウンドを確認します。ログがない場合は、アプリが現在の接続経路を使っているか確認してください。ログがあるのにリクエストが失敗する場合は、DNS、プロキシグループ、ノードの状態を確認します。ページのキャッシュや既存の接続が判定に影響することがあるため、新しいリクエストを送ってください。テストが1回成功したら、カスタム設定を一つずつ元に戻しましょう。
リクエスト先 → 一致したルール → 実際のアウトバウンド
インストールや接続に関する問題は、Clashのよくある質問もご覧ください。
04 Project Sources
ソースコード、クライアント、サブスクリプションは、それぞれ異なるプロジェクトやサービスが提供しています。問題が起きたら、まず対象を特定し、対応するドキュメント、リリースノート、課題記録を確認しましょう。
Clashエコシステムの設定ファイルでは、ノードの定義、プロキシグループの構成、ルールに基づくアウトバウンドの選択など、いくつかの共通概念が使われています。mihomoはClash.Metaの開発を引き継ぎ、この構造に機能を追加しています。旧ガイドの一般的な記述は設定を読み解く手掛かりになりますが、個別のプロトコル、DNS項目、ルールタイプについては、実行中のコアの仕様を確認してください。画面上の項目名が同じでも、2つのクライアントが同じように解釈するとは限りません。古い設定を移行するときは、最小構成でテストしてから詳細設定を一つずつ戻すと安全です。
mihomoのソースコードは公開されており、GPL-3.0ライセンスで提供されています。項目の意味や実装動作について調べるときは、リポジトリの該当コード、変更履歴、既知の問題を確認してください。トレイメニュー、サブスクリプション更新ボタン、端末の権限に関する問題は、通常コアではなく該当クライアントの情報を調べます。ライセンスやソースコードの記録が示すのは各プロジェクトの公開・許諾条件です。サブスクリプションサービスの説明に代わるものではなく、あるプロジェクトのライセンスから他のクライアントやルールデータのライセンスを推測することもできません。
クライアントが設定を取得・整理し、コアが最終設定を読み込んで実際の接続を処理します。サブスクリプションの取得失敗は取得段階、未対応項目のエラーは読み込み段階、ルールに一致しても接続できない問題は実行段階で起こります。まずどの段階で止まっているか特定し、サブスクリプションの応答、読み込みエラー、接続ログのどれを確認するか判断しましょう。再現手順を共有するときは項目の構造とエラーの種類を残し、実際のノードアドレスはドキュメント用アドレスに置き換えてください。問題を説明しつつ、サブスクリプションにアクセスできるURLを共有せずに済みます。
クライアントをアップグレードすると、画面や同梱コアが変わる場合があります。サブスクリプションの更新は通常、設定の再取得です。地理データベースやルールセットの更新は別の処理です。変更の原因を調べる際は、直近に実行した更新の種類を記録し、更新前に使えていたローカル設定を保存してください。サブスクリプション更新後にだけ問題が発生するなら、最終的なルール順序やノード項目を比較します。地域判定に変化があれば、現在のデータ元、更新日時、読み込み成功の有無を確認しましょう。一度に変更するのは一種類に絞り、同じアプリから同じ宛先へ再度リクエストを送ります。
05 Field Notes
設定リファレンスは項目別、使い方の記事は目的別に読めます。以下の記事では、複数端末での同期、モバイル端末への読み込み、クライアント画面について解説します。
PCとスマートフォンの間でClashの設定を同期する方法を比較します。サブスクリプションURLの直接利用、上書きファイル、WebDAVバックアップ、プライベートGitリポジトリを取り上げ、それぞれの運用コストと注意点を紹介します。
iOSでClashの設定に対応したクライアントをApp Storeから入手し、サブスクリプションURLやYAMLファイルを読み込み、VPN構成を有効にして初回接続する手順を解説します。
画面の流れに沿って、プロキシ画面のグループと速度テスト、設定画面のサブスクリプションと切り替え、ログ画面のレベルとフィルターを解説します。各ボタンやステータス表示の意味を、初めて使う人にも分かりやすく紹介します。