オープンソースコア · 設定リファレンスを随時更新

Clash対応クライアントのダウンロードと設定ガイド

OSに合わせて対応クライアントを選び、YAMLの例で mihomo のポート、DNS、ルールによる振り分けを確認できます。

ソースコード公開 日本語ドキュメント

01 Downloads

プラットフォーム別にClashクライアントをダウンロード

まずOSを確認し、次にインストーラーのアーキテクチャを選びます。デスクトップではGUIクライアントと単体コアも区別しましょう。初めて使う場合はGUIクライアントから始めるのがおすすめです。

Windows

システムのデバイス情報でCPUアーキテクチャを確認してください。一般的なIntel・AMD搭載PCにはx64版を使います。ARM搭載端末では、選んだクライアントに対応するビルドがあるか確認しましょう。インストール後は設定を読み込んでからシステムプロキシを有効にします。テストに成功しても一部のアプリだけプロキシを経由しない場合は、アプリがシステム設定を引き継いでいるか確認してください。すぐにサブスクリプションを変更する必要はありません。

ダウンロード

macOS

「このMacについて」でチップまたはプロセッサを確認し、Apple Silicon版かIntel版を選びます。メニューバーの表示でクライアントの起動状態は確認できますが、すべてのアプリの通信がプロキシ経由とは限りません。設定を切り替えたら接続ログで現在のリクエストを確認します。テスト終了後はシステムのプロキシ設定が元に戻っていることも確認してください。

ダウンロード

Android

端末が対応するアプリのアーキテクチャに合わせてインストーラーを選びましょう。プロセッサが64ビットかどうかだけで判断しないでください。初回起動時は通常、システムからVPN接続の許可を求められます。バックグラウンドに移ると接続が切れる場合は、クライアントの動作状態とシステムのバッテリー管理を確認してください。仕事用プロファイルや別のVPNがある場合は、現在の接続をどのアプリが管理しているかも確認しましょう。

ダウンロード

iOS

ダウンロードページからApp Storeを開き、対応クライアントとシステム要件を確認します。設定を読み込んだら、システムの案内に従ってVPN構成の追加を許可し、クライアントに戻って選択中の設定を確認してください。デスクトップで保存したYAMLは移行の出発点になりますが、ローカルファイルのパス、プロキシモード名、詳細設定はそのまま使えない場合があります。

ダウンロード

Linux

デスクトップクライアントは、ディストリビューションが対応するパッケージ形式とCPUアーキテクチャに合わせて選びます。インストール前に、システムのパッケージマネージャーが使う形式を確認してください。同じアーキテクチャでも形式の異なるパッケージは互換ではありません。ターミナルとデスクトップアプリのプロキシ設定は別々の場合があります。ターミナルからの通信だけが失敗するなら、そのプログラムが実際に参照するプロキシ設定を確認しましょう。

ダウンロード

02 Config Reference

Clashの設定項目とYAMLの例

まずインバウンド、アウトバウンド、マッチ条件を区別しましょう。項目を選ぶと対応する設定例を確認できます。各例は設定の一部分を解説するもので、サブスクリプションやノードを含む完全なファイルではありません。

混合プロキシポート

混合ポートは、ローカルアプリからのHTTP接続とSOCKS接続を同時に受け付けます。アプリがコアに接続するためのポートであり、リモートノードのポートではありません。この端末だけで使うなら、まずLANからの接続を無効にし、アプリに設定したアドレスとポートを確認しましょう。ポートが使用中の場合は、該当プロセスを特定してからコアとアプリの設定をそろえて変更します。片方だけ変更すると、リクエストがコアに届かず、接続ログにもルールの適用が記録されないことがあります。

DNSの名前解決モード

まずリクエストがコアのDNSモジュールに届いているか確認し、そのうえで名前解決モードが適切か判断します。fake-ipは一時的なマッピングアドレスを返し、後続の接続でコアがドメイン名を識別できるようにします。システム上のすべてのDNS問い合わせが自動的にコアへ渡るわけではありません。トラブル時はブラウザーのセキュアDNS、システムの名前解決、コアの名前解決を分けて確認してください。特定のドメインだけがマッピングアドレスに対応しない場合は、そのドメインのフィルター設定を確認し、DNS設定全体を変更するのは避けましょう。

config.yaml
mixed-port: 7890
allow-lan: false
dns:
  enable: true
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16

設定を読む順序:まず mixed-port や mode などのトップレベル項目を確認し、次に proxies で定義されたアウトバウンドを調べます。最後に proxy-groups と rules がそれらの名前をどう参照しているか確認しましょう。プロキシグループ名も参照先の一部です。名前を変更する場合は、グループ内の入れ子の参照とルール末尾の宛先も合わせて変更してください。YAMLの解析に成功しても、コアが読み込みを拒否することがあります。

変更する場所:サブスクリプション元、ローカルの上書き設定、クライアントが生成した最終設定は、それぞれ別のファイルです。更新後に変更が消えた場合は、まずどの層を編集しているか確認してください。変更を長期的に保持するには、クライアントが対応する上書きレイヤーを使い、リストの内容が追加されるのか置き換えられるのかも確認します。特に rules は、全体を置き換えると既存の例外が消えることがあり、MATCH の後ろに追加すると一致しなくなる場合があります。構文の詳細は設定項目リファレンスをご覧ください。

03 Quick Start

Clashの設定読み込みと接続テスト

初めて使うときは、設定を読み込んで選択し、通信の入口を有効にして、リクエストを1回送って確認するだけです。まず基本の接続を確立し、その後でDNSやルールを調整しましょう。

  1. 01

    設定を読み込んで有効にする

    クライアントの設定画面を開き、手元の情報に合わせてサブスクリプションURLまたはローカルYAMLを選びます。更新に成功したら、その設定を選択してプロキシ画面でグループを展開できるか確認してください。ファイル名が表示されるのは設定項目が保存されたということにすぎません。グループとメンバーが表示されれば、読み込みが成功した可能性が高まります。エラーが出た場合は、該当行、項目名、ダウンロード時のメッセージを確認してください。同じサブスクリプションを続けて追加する必要はありません。

    config.yaml · 設定の読み込み

  2. 02

    モードを選び、通信を接続する

    ドメイン名やアドレスに応じて通信を振り分ける場合は、まずルールモードを選び、プロキシグループで使用中のアウトバウンドを確認します。デスクトップではクライアントの説明に従ってシステムプロキシを有効にし、モバイルでは案内に従ってVPN接続を設定してください。接続方式とプロキシグループを同時に変更しないようにしましょう。結果が変わったとき、どちらの設定が影響したのか分かりにくくなります。別のプロキシがすでに動作している場合は、今回使う接続経路を先に確認してください。

    mode: rule · システムプロキシ

  3. 03

    実際の接続を確認する

    普段使うアプリでページを再読み込みし、接続ログから該当ドメイン、一致したルール、実際のアウトバウンドを確認します。ログがない場合は、アプリが現在の接続経路を使っているか確認してください。ログがあるのにリクエストが失敗する場合は、DNS、プロキシグループ、ノードの状態を確認します。ページのキャッシュや既存の接続が判定に影響することがあるため、新しいリクエストを送ってください。テストが1回成功したら、カスタム設定を一つずつ元に戻しましょう。

    リクエスト先 → 一致したルール → 実際のアウトバウンド

よくある問題をすばやく確認

プロキシ画面にノードが表示されるのに、接続一覧にリクエストが出ないのはなぜ?
ノードが読み込まれていても、通信が接続されているとは限りません。まずシステムプロキシまたはVPNの状態を確認し、リクエストを送ったアプリがその接続経路を使っているか確認してください。
プロキシグループを切り替えても、開いているページに変化がないのはなぜ?
アプリがすでに確立した接続を再利用している可能性があります。新しいリクエストを送り、その接続を確認してください。切り替えの判定に古いログを使わないようにしましょう。
ルールを1つ変更しただけなのに、複数のサイトに影響するのはなぜ?
サフィックスによる一致は、その配下のサブドメインにも適用されます。また、前のルールに一致すると後続のルールは評価されません。ルール構文の比較で一致範囲と順序を確認してください。

インストールや接続に関する問題は、Clashのよくある質問もご覧ください。

04 Project Sources

mihomoオープンソースコアと設定の入手元

ソースコード、クライアント、サブスクリプションは、それぞれ異なるプロジェクトやサービスが提供しています。問題が起きたら、まず対象を特定し、対応するドキュメント、リリースノート、課題記録を確認しましょう。

プロジェクトの変遷:Clash、Clash.Meta、mihomo

Clashエコシステムの設定ファイルでは、ノードの定義、プロキシグループの構成、ルールに基づくアウトバウンドの選択など、いくつかの共通概念が使われています。mihomoはClash.Metaの開発を引き継ぎ、この構造に機能を追加しています。旧ガイドの一般的な記述は設定を読み解く手掛かりになりますが、個別のプロトコル、DNS項目、ルールタイプについては、実行中のコアの仕様を確認してください。画面上の項目名が同じでも、2つのクライアントが同じように解釈するとは限りません。古い設定を移行するときは、最小構成でテストしてから詳細設定を一つずつ戻すと安全です。

オープンソースのエコシステム:問題に応じて上流を確認

mihomoのソースコードは公開されており、GPL-3.0ライセンスで提供されています。項目の意味や実装動作について調べるときは、リポジトリの該当コード、変更履歴、既知の問題を確認してください。トレイメニュー、サブスクリプション更新ボタン、端末の権限に関する問題は、通常コアではなく該当クライアントの情報を調べます。ライセンスやソースコードの記録が示すのは各プロジェクトの公開・許諾条件です。サブスクリプションサービスの説明に代わるものではなく、あるプロジェクトのライセンスから他のクライアントやルールデータのライセンスを推測することもできません。

コアとの関係:読み込みと実行を区別する

クライアントが設定を取得・整理し、コアが最終設定を読み込んで実際の接続を処理します。サブスクリプションの取得失敗は取得段階、未対応項目のエラーは読み込み段階、ルールに一致しても接続できない問題は実行段階で起こります。まずどの段階で止まっているか特定し、サブスクリプションの応答、読み込みエラー、接続ログのどれを確認するか判断しましょう。再現手順を共有するときは項目の構造とエラーの種類を残し、実際のノードアドレスはドキュメント用アドレスに置き換えてください。問題を説明しつつ、サブスクリプションにアクセスできるURLを共有せずに済みます。

更新の種類:アプリ、サブスクリプション、ルールデータを個別に確認

クライアントをアップグレードすると、画面や同梱コアが変わる場合があります。サブスクリプションの更新は通常、設定の再取得です。地理データベースやルールセットの更新は別の処理です。変更の原因を調べる際は、直近に実行した更新の種類を記録し、更新前に使えていたローカル設定を保存してください。サブスクリプション更新後にだけ問題が発生するなら、最終的なルール順序やノード項目を比較します。地域判定に変化があれば、現在のデータ元、更新日時、読み込み成功の有無を確認しましょう。一度に変更するのは一種類に絞り、同じアプリから同じ宛先へ再度リクエストを送ります。

05 Field Notes

Clashの使い方

設定リファレンスは項目別、使い方の記事は目的別に読めます。以下の記事では、複数端末での同期、モバイル端末への読み込み、クライアント画面について解説します。

Clash ダウンロード