オープンソースのコア · マルチプラットフォーム対応
Clashチュートリアル
サブスクリプションの追加からルールベースの振り分けまで、OS別にクライアントを探し、手順に沿ってmihomoの設定を確認できます。
設定トラブル対応 / CONFIG DESK
接続できるか、通信がどこを経由するか、ドメインをどこで名前解決するかは、それぞれ別の問題です。該当する項目を確認し、設定を一つ変更して結果を確かめましょう。一度にあれこれ変更するのは避けてください。
サブスクリプションURLは設定を更新するためのもので、サーバー欄に直接入力するノードアドレスではありません。クライアントの設定画面またはサブスクリプション画面でリモート設定を追加し、URL全体を貼り付けます。更新に成功したら、その設定を選択して有効にしてください。解析に失敗する場合は、提供元がClash YAMLを返しているか確認しましょう。ウェブページやログイン画面、別のクライアント用ノード一覧が返されている可能性もあります。ノードを一つずつ登録する方法に比べ、サブスクリプションならまとめて更新できますが、ローカルでの変更は次回更新時に上書きされることがあります。残しておきたいルールは、クライアントが対応するオーバーライドまたはマージ設定に記述してください。画面を共有するときは、アクセス情報を含むことが多いサブスクリプションURLを必ず隠してください。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: infoこの抜粋はフィールドの確認用で、ノードを含む完全な設定ではありません。サブスクリプションの追加手順を見る →
ルールモードでは、リストを上から順に評価し、最初に一致したルールのポリシーが適用されます。具体的なドメインのルールは広範な地域ルールより前に置き、MATCHは最後にフォールバックとして設定します。ルール末尾には、定義済みのプロキシグループ名または組み込みポリシー名を指定します。名前と大文字・小文字を正確に合わせてください。グローバルモードと異なり、ルールモードでは接続先ごとに出口を振り分けられますが、通信がコアに届いており、ドメイン情報が途中で失われていないことが前提です。テストでは接続の詳細に表示される適用ルールを確認し、ウェブページが開くかどうかだけで判断しないでください。既存の接続には変更前のポリシーが適用されたままの場合もあります。
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT - MATCH,PROXYプロキシグループを使うと、ルールで指定するポリシー名と実際の出口を分けて管理できます。selectは手動選択に、url-testは応答の測定結果に基づく候補の自動選択に適しています。用途はそれぞれ異なります。まずグループ内に利用可能な候補があるか確認し、次に現在の選択項目を確認してください。グループを選んでも、すべての通信が自動的にそのグループを経由するわけではありません。ルールから参照されているか確認しましょう。各ルールにノード名を直接書く場合と比べ、プロキシグループを使えばノード変更時の修正箇所を減らせます。測定結果が示すのは指定したテスト先への接続状況であり、ダウンロード速度ではありません。実際の通信に失敗する場合は、接続先のサービスやプロトコルへの対応も確認してください。
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECTこの例の候補はDIRECTのみです。実際に使うときは、設定内で定義済みのノードまたはプロキシグループを追加してください。プロキシグループの用語を見る →
Fake-IPモードでは、ドメインに対応するアドレスを割り当て、コアがその対応関係から元のドメインを復元して接続します。予約済みアドレス範囲が表示されても、名前解決の失敗とは限りません。重要なのは、接続を開始する通信も同じコアで処理されているかどうかです。実際のアドレスを返す方式に比べ、Fake-IPは名前解決と通信転送の連携がより重要です。LAN内の機器検出、一部のゲーム、特殊なデバイスでは例外設定が必要になることがあります。まずクライアントの内蔵DNSが実際に有効か確認し、必要に応じて特定のドメインだけをフィルタリングしてください。一つのアプリのために設定全体を切り替えるのはおすすめしません。システムのキャッシュやブラウザー内蔵の暗号化DNSも、検証結果に影響します。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"システムプロキシは、システム設定に従うアプリにプロキシ接続先を提供しますが、すべてのプログラムの通信を自動的に取り込むわけではありません。TUNは仮想ネットワークインターフェースを通じて通信を取り込み、通常は追加の権限、ルーティング設定、DNSとの連携が必要です。まずシステムプロキシでサブスクリプションとルールを確認し、その後、アプリの要件に応じてTUNを有効にすると、切り分けが容易です。ブラウザーのプロキシ設定だけを変える場合に比べてTUNは広範囲の通信を扱えますが、ほかのVPNや仮想ネットワークアダプター、セキュリティソフトとルートが競合しやすくなります。問題を調べる際は、通信を取り込むツールの重複をいったん無効にし、新しい接続のログを確認してください。クライアント終了後にネットワークが不安定な場合は、システムプロキシが元に戻っているかも確認しましょう。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53クライアントでTUNを管理する場合は、手書き設定との上書き競合を避けるため、まず画面上のスイッチを使ってください。通信取り込みのトラブル対処を見る →
ダウンロード / PLATFORM BAY
デスクトップ用インストーラー、スマートフォンアプリ、コマンドライン用コアは、それぞれ異なる配布物です。まずOSを確認し、次にCPUアーキテクチャを確認してから、必要なプロトコルや設定機能に対応しているか確かめましょう。ダウンロードページでは各プラットフォームのクライアント、入手先、メンテナンス状況をまとめて案内しています。トップページにはインストーラーを置いていません。
初めて使う場合はClash Plusを候補にし、Clash Verge Rev、FlClash、Clash Nyanpasuとも比較できます。Clash for Windowsからの乗り換えでは、画面の類似性だけで決めず、サブスクリプションの互換性、サービスモード、設定のオーバーライド方法を確認してください。
インストール前にOSとCPUの種類を確認してください。初回起動時はまず設定をインポートし、その後でシステムプロキシを有効にします。ブラウザーは使えるのにほかのアプリが通信できない場合は、アプリがシステムプロキシに従うか確認し、それでも必要ならTUNを検討してください。OS起動時の自動起動とバックグラウンドサービスは別の設定です。権限の確認もそれぞれ行ってください。
ダウンロード WindowsクライアントまずApple SiliconとIntelを区別し、Clash Plus、Clash Verge Rev、FlClashの対応するインストーラーを選んでください。外観よりもシステム設定に表示されるチップ情報のほうが確実です。異なるアーキテクチャ向けのものをインストールすると、起動できなかったり、互換実行環境が別途必要になったりします。
初回起動時はシステムの案内に従ってアクセスを許可してください。通信の取り込みを有効にする前に、ほかのツールがプロキシやルートを同時に変更していないか確認しましょう。以前の設定を移行する場合は、元ファイルのコピーを保存し、ローカルパス、外部ルールファイル、プロセスルールを重点的に確認してください。これらは別のOSからそのまま移行できない場合があります。
ダウンロード macOSクライアント用途に応じて、Clash Plus、Clash Meta for Android、FlClash、Surfboardから選べます。サブスクリプション形式、スクリプト機能、コアはアプリごとに異なります。ある種類のノードURLを読み込めることと、Clash設定全体に対応していることは同じではありません。
接続を開始するときは、通常、システムのVPN接続許可が必要です。長時間バックグラウンドで使う場合は、すべての権限を許可するのではなく、端末のバッテリー管理でバックグラウンド動作が制限されていないか確認してください。モバイル通信とWi-Fiの切り替え後に問題が起きた場合は、まず接続を再確立し、DNSとアプリごとのプロキシ設定を確認しましょう。
ダウンロード AndroidクライアントダウンロードページではClash PlusのApp Storeへのリンクと、公式サイト clashplus.ioを案内しています。インポートする前に、サブスクリプション形式とアプリの機能が対応しているか確認してください。設定ファイルにフィールドが含まれていても、すべてのモバイルアプリでその設定が反映されるとは限りません。
初めて接続を有効にするときは、システムの案内に従ってVPN構成を追加し、現在の設定とポリシーの選択状態を確認してください。モバイル端末にはシステムのネットワーク拡張機能による制約があります。デスクトップのサービスモード、プロセス照合、ローカルファイル操作をそのまま適用できるとは限りません。アプリで実際に選べる設定と公式の説明を基準にしてください。
ダウンロード iOSクライアントデスクトップでは、Clash Verge RevとFlClashを比較し、ディストリビューションに合ったパッケージを選べます。GUIクライアントはデスクトップ環境やシステムコンポーネントに依存します。インストールできてもウィンドウが開かない場合は、サブスクリプションを何度も変えるのではなく、不足している依存関係や起動ログを確認してください。
サーバーやルーターでは、ダウンロードページからmihomoコアを探し、アーキテクチャと実行環境に合わせて導入してください。コマンドライン用コアには完全なデスクトップ画面は付属しません。設定ディレクトリ、権限、サービスの起動、ログのローテーションは自分で管理する必要があります。リモートでデバッグするときは、コントロールインターフェースをインターネットに直接公開しないでください。
ダウンロード Linuxクライアント開発元とメンテナンス / SOURCE NOTES
クライアントは操作画面、コアは接続とルールの処理、サブスクリプションは設定内容を担います。この3つを分けて考えると、設定を変えるべきか、設定ファイルを差し替えるべきか、開発元のドキュメントを確認すべきか判断できます。
Clashでは当初、YAML設定、プロキシグループ、ルールマッチングを中心とする使い方が広まり、その後、コミュニティによる複数の派生版やGUIクライアントが登場しました。Clash.Metaはこのエコシステムの拡張ブランチで、関連するコアプロジェクトは後にmihomoという名称で開発が続けられています。古いガイドではMeta、Clash Meta、mihomoの表記が混在することがありますが、これはプロジェクトの変遷や名称変更を反映したもので、互いに無関係な3種類の操作画面という意味ではありません。
オリジナルのプロジェクトと拡張コアでは、対応する機能の範囲が異なります。新しいプロトコル、DNSのフィールド、ルール機能、プラットフォームへの対応状況は、クライアント名にClashが含まれるかではなく、実際に動作しているコアを基準に確認してください。当サイトはダウンロードと日本語ガイドを提供する参考サイトであり、各クライアントやコアプロジェクトの公式発表に代わるものではありません。実装の詳細を確認するときは、該当プロジェクトのドキュメント、ソースコード、リリースノートを参照してください。
同じコアを異なるクライアントに組み込むことがあり、画面が似たクライアントでも採用するコアが異なる場合があります。GUIはサブスクリプション管理、プロキシの切り替え、システム連携、ログ表示を担います。設定構文、接続プロトコル、ルールの適用はコアが決めます。画面にスイッチがないからといって、コア側で設定できないとは限りません。反対に、サブスクリプションファイルを読み込めても、すべてのフィールドが対応済みで有効になるとは限りません。
選ぶ前に、必要な機能を整理しましょう。ルールのオーバーライドが必要か、特定のプロトコルに依存するか、アプリごとに通信を取り込む必要があるか、複数の端末間で設定を移行するかを確認します。そのうえで、クライアントの説明と実行ログに表示されるコアの情報を確認してください。プロトコルの違いやモバイル端末での機能上の制約は、技術リファレンスで項目ごとに比較できます。1回の接続テストや画面上の緑色の表示だけで判断しないでください。
サブスクリプションの更新ではリモート設定を取得し、ソフトウェアの更新ではアプリや同梱コアを置き換えます。互いに代わりにはなりません。サブスクリプションの内容が変わると、ノード名、ルールの接続先、プロキシグループの参照先に影響することがあります。ソフトウェアの更新では、新しいフィールドの追加、デフォルト動作の変更、互換性の問題の修正などが行われる場合があります。更新前に設定とローカルのオーバーライドを保存し、更新後はログを確認してからよく使うアプリで動作を検証してください。すべてのスイッチを最初から設定し直す必要はありません。
リモートのサブスクリプション更新でローカルの変更が上書きされる場合は、すべての更新を止めるのではなく、クライアントが提供する永続的なオーバーライド機能を確認してください。GeoIP、GeoSite、ルールセットには、それぞれ異なるデータソースと更新周期があります。通信の振り分けが変わったときは、まず設定やデータファイルに変化がないかを確認し、その後でソフトウェアを調べましょう。この順番で切り分ければ、「昨日まで使えたのに今日は動かない」という問題を検証可能な項目に分けられます。
ソースコードの価値は、機能の実装、設定例、問題の議論、変更履歴を確認できることにあります。ダウンロード前にプロジェクト名とクライアントが一致しているか確認し、設定を調べるときは現在のコアのドキュメントを優先してください。古い画面キャプチャを参照する場合は、記載されたフィールドが現在も使えるか確認しましょう。リポジトリのスター数がすべての端末に適していることを示すわけではなく、議論が活発でも修正がリリース済みとは限りません。実際の説明とリリース内容を根拠に判断してください。
問題を報告する際は、OS、クライアント名、コアの情報、再現手順、個人情報を伏せたログを添えると役立ちます。サブスクリプション全体、ノードのパスワード、コントロールインターフェースの認証情報を公開しないでください。設定ファイルを丸ごと公開の場に貼るのも避けましょう。最小限の設定で再現できる問題は原因を特定しやすくなります。まず関係のないルールやオーバーライドを取り除き、エラーが残るか確認してから、必要な情報を段階的に戻してください。
技術ノート / WORK LOG
入門ガイドでは接続までの基本手順を説明し、技術ノートでは個別のフィールドや例外的なケースを扱います。変更前に設定の管理元を確認し、変更後は新しい接続で結果を確認しましょう。一度に変更する項目を一つに絞ると、ログを比較しやすくなります。
Fake-IPが198.18.0.1/16のアドレス範囲を使ってDNS応答を高速化する仕組みを解説。redir-hostとの違い、fake-ip-filterの用途、LANやゲームでの注意点も紹介します。
ノートを読む →DOMAIN、DOMAIN-SUFFIX、IP-CIDR、PROCESS-NAMEなどのルール構文を整理し、上から順に評価されるルールの優先順位、no-resolveの意味、MATCHによるフォールバックの書き方を解説します。
ノートを読む →GeoIPとGeoSiteのデータファイルの役割と入手元を解説。mihomoのgeox-url設定と自動更新の方法、GEOIP・GEOSITEルールの正しい書き方も紹介します。
ノートを読む →