Windows
まずデバイスのアーキテクチャとシステム要件を確認し、クライアントの一覧からインストーラーを選びます。インストール後、「設定」からサブスクリプションを読み込み、システムプロキシが有効か確認してください。一部のアプリが直接接続する場合は、システムプロキシに従うアプリかどうかを確認しましょう。
Windowsのダウンロードへ →初回起動チェックリストmihomo / Clash
Clashクライアントダウンロードと初期設定
デバイスに合ったインストーラーを選び、サブスクリプションの読み込み、ルールによる振り分け、システムプロキシを設定します。コアのパラメーターを変更する場合は、応用設定ガイドもご覧ください。
永久無料オープンソース日本語の設定ガイド
設定前と設定後を比較
手動設定でつまずきやすい点
設定ファイル、待ち受けポート、振り分けルールは、それぞれ別の通信処理を担います。まず問題がどの層にあるかを確認してから該当箇所を変更すると、プロキシノードを何度も切り替えるより原因を特定しやすくなります。
YAMLを手書きすると項目が抜けやすい
ノード、プロキシグループ、ルールを一から記述する場合、インデントと項目名をコアの構文に合わせる必要があります。設定の読み込みに失敗しても、サブスクリプションURLが無効とは限りません。まずクライアントのエラー表示を確認し、ファイルの構造を見直しましょう。
ポート設定とシステムプロキシが一致しない
設定ファイルでmixed-portを指定していても、システムプロキシが別のポートを参照していると、ブラウザーが直接接続したりエラーになったりすることがあります。待ち受けポートを変更したら、OSのプロキシアドレスも確認してください。
ルールがあるのに、想定どおりに振り分けられない
ルールモードでは、上から順にルールを照合します。前方に範囲の広いルールがあると、リクエストが先にそちらへ振り分けられることがあります。ルールが参照するプロキシグループ名と、クライアントがルールモードになっているかも確認しましょう。
クライアントの初期設定後に項目ごとに確認
画面上の設定は日常的なオン・オフに、設定ファイルは再利用するルールの管理に使います。まずクライアントで接続し、必要に応じてYAMLを変更しましょう。最初からすべての項目を同時に変更する必要はありません。
「設定」からサブスクリプションを読み込む
サービス提供元から入手したサブスクリプションURLを貼り付け、設定の読み込みが完了したことを確認してから「プロキシ」でグループを選択します。読み込みに成功しても、システムの通信がすでにプロキシ経由になったとは限りません。
待ち受けポートとシステムプロキシを合わせる
まず設定ファイルの混合ポートは変更せず、クライアントのシステムプロキシを有効にします。他のアプリがポートを使用している場合は、ポートを変更したうえでプロキシアドレスも更新し、クライアントとシステムで値が異ならないようにしましょう。
ルールモードで通信の振り分け先を確認
ルールモードに切り替え、接続ログで対象ドメインに適用されたルールと振り分け先のプロキシグループを確認します。特定のアプリだけ通信が記録されない場合に、TUNモードが必要か検討しましょう。
mixed-port: 7890
mode: rule
proxy-groups:
- name: 手動選択
type: select
proxies:
- DIRECT設定項目の概要
サブスクリプションから振り分けまで、目的別に設定を確認
左側の項目を選ぶと、具体的な操作を確認できます。下の例は項目間の関係を示すものです。実際のノードやサブスクリプション内容は、ご自身の設定に合わせてください。
完全な設定ファイルか確認する
クライアントの「設定」画面にサブスクリプションURLを貼り付けて読み込み、一覧に表示されたら現在の設定として選択します。通常、完全なYAMLにはノード、プロキシグループ、ルールが含まれます。ノード一覧だけのURLの場合は、サービス提供元がClash対応形式を提供しているか確認してください。サブスクリプションを更新する前に選択中の設定を控え、更新後はプロキシグループが正常に表示されるか確認しましょう。サブスクリプションURLは非公開情報です。公開ログのスクリーンショットや質問投稿に貼り付けないでください。読み込み後にシステムプロキシを有効にすると、設定の問題と通信の振り分けの問題を分けて確認できます。
設定 → サブスクリプションURLを読み込む → 現在の設定にする
プロキシ → プロキシグループを選択ルールの順序でリクエストの振り分け先を決める
ルールモードでは、リクエストを上から順に確認し、最初に一致したルールに対応するプロキシグループへ振り分けます。ドメインルールは特定のサイトに、IPルールは解決後のアドレスに適しています。末尾のフォールバックルールは、それまでに一致しなかったリクエストを処理します。変更時は、参照先のプロキシグループ名が存在することを確認し、範囲の狭いルールを広いルールより前に配置してください。一時的な切り分けにはグローバルモードとの比較も使えますが、普段はルールモードに戻しましょう。Webページが開くかどうかだけで判断するより、クライアントの接続ログで実際に適用されたルールを確認するほうが確実です。
mode: rule
rules:
- DOMAIN-SUFFIX,example.com,手動選択
- MATCH,DIRECTプロキシグループはルールと接続先の間で選択を担う
ルールから参照するのはプロキシグループ名であり、個々のルールに具体的なノードを書く必要はありません。selectは手動で接続先を選択し、url-testは定期的にテストして利用可能な候補を選びます。fallbackは候補の順に接続先を切り替えます。まず手動選択のグループで接続を確認してから自動選択を試すと、サブスクリプション、ルール、テスト用URLの問題を切り分けやすくなります。グループ名を変更したら参照元のルールも更新してください。グループ内から別のグループを参照している場合も、名前が一致するか確認しましょう。パラメーターの詳細は応用設定ガイドをご覧ください。
proxy-groups:
- name: 手動選択
type: select
proxies:
- DIRECTシステムプロキシで処理できない通信にTUNを検討
システムプロキシは、その設定に従うアプリ向けです。アプリによっては独自に接続するため、システムプロキシを経由しません。TUNは仮想ネットワークインターフェースを使って、より広い範囲の通信を取り込みます。通常、有効にするにはOSの許可が必要です。まずシステムプロキシで基本的な接続を確認し、必要な場合にTUNを有効にしてください。その際、LAN、他のVPN、ファイアウォール間のルーティングにも注意しましょう。TUNを無効にしてアプリが正常に戻る場合は、すぐにサブスクリプションを変更せず、DNSやルートの設定を確認してください。許可を求める画面はプラットフォームやクライアントによって異なるため、表示内容に従ってください。
システムプロキシ → 基本接続
TUNモード → 必要に応じて有効化
確認 → 許可 / ルート / DNSドメイン解決とルール判定をまとめて確認
ドメインルールが想定どおりに動作するかは、クライアントが認識するドメイン名や名前解決の結果にも左右されます。DNS上書きではコアが使用する名前解決方法を指定し、Fake-IPでは通信を取り込むための仮想アドレスをドメインに割り当てます。変更前に現在の設定を保存し、システムDNS、クライアントのDNS、TUNの状態をそれぞれ記録してください。一度に変更するのは一項目だけにし、ログと接続記録を確認しましょう。LAN内のドメイン、内部サービス、実IPに依存するアプリには個別の対応が必要な場合があります。入手したDNS設定をファイル全体にそのまま上書きせず、既存ルールとの関係を先に確認してください。
dns:
enable: true
enhanced-mode: fake-ipコントロールインターフェースとパネルを区別する
外部コントロールインターフェースは、クライアントの画面や独立したパネルからコアの状態を確認したり、プロキシグループを切り替えたりするためのものです。プロキシ通信の待ち受けポートとは異なります。本機だけで使う場合は、ループバックアドレスへのバインドを優先してください。LAN経由でアクセスする場合は、待ち受けアドレス、アクセス制限、デバイス間のネットワーク境界も考慮し、公開サンプルをそのまま使わないでください。パネルに接続できない場合は、コアの起動状態、コントロールインターフェースのアドレス、アクセス認証情報をそれぞれ確認します。パネルが使えなくてもプロキシは動作する場合があるため、パネルの接続失敗をサブスクリプションの接続失敗と混同しないようにしましょう。
external-controller: 127.0.0.1:9090
secret: "your-password"パラメーターを詳しく確認する場合は、応用設定ガイド →をご覧ください。ルールセット、プロキシグループ、DNS、TUN、ローカル上書きを個別に解説しています。初回起動時にすべて設定する必要はありません。
ダウンロード先
すべてのクライアントを見る →デバイスに合ったクライアントを選ぶ
まずOSを選び、ダウンロードページで同じプラットフォーム向けのクライアントを比較してください。インストーラーの種類、CPUアーキテクチャ、必要な権限はデバイスに合わせて選びます。コアだけが必要なサーバーやルーターでは、ダウンロードページのmihomo欄をご覧ください。
macOS
Apple Silicon搭載機とIntel搭載機では、それぞれに合ったインストーラーを選んでください。クライアントを初めて開くときは、システムの案内に従って許可を設定します。メニューバーに接続中と表示されてもブラウザーがプロキシを経由しない場合は、クライアントに戻り、現在の設定とシステムプロキシの状態を確認してください。
macOSのダウンロードへ →Android
設定を読み込んだ後、システムに表示されるダイアログでVpnServiceの権限を許可すると、クライアントが端末上にVPNインターフェースを作成できます。画面ロック後に頻繁に切断される場合は、サブスクリプションを何度も削除するのではなく、バッテリー最適化、自動起動、バックグラウンド実行の権限を確認してください。
Androidのダウンロードへ →iOS
ダウンロードページからClash PlusのApp Storeページに進みます。インストール後、アプリの案内に従って設定を読み込み、初回接続時にシステムのVPN接続許可を確認してください。ルールやプロキシグループを切り替えるときは、クライアントの画面から操作できます。
iOSのダウンロードへ →Linux
デスクトップではGUIクライアントの配布パッケージを比較できます。サーバーやルーターでは独立したコアも選択肢になります。インストール前にディストリビューション、CPUアーキテクチャ、実行方法を確認し、設定ファイルを読み書きできる場所を確保してください。
Linuxのダウンロードへ →同じサブスクリプションでも、すべてのクライアントで使えるとは限りません。まずサービス提供元の設定形式を確認し、使用するクライアントが含まれるプロトコルやルール構文に対応しているか調べてください。別のデバイスに移行する際は、その端末でのネットワーク権限とシステムプロキシの設定も改めて確認しましょう。
オープンソースのエコシステムと設定の基礎
クライアント・コア・設定の関係を知る
Clashは、ルールベースのプロキシツールのエコシステムを指す名称です。GUIクライアントは設定の読み込み、切り替え、接続状況の確認を行う画面を提供し、コアは設定の解析、接続の確立、ルールの適用を担います。インストーラーを選ぶときは、まずOSを確認し、コアが対応する設定構文もチェックしましょう。
プロジェクトの変遷
オリジナルのClash、Clash Meta、後継のmihomoは、それぞれメンテナンス状況が異なります。画面上の名称が似ていても、同じコアを使用しているとは限りません。新しいプロトコルやルール形式、DNSパラメーターの一部は、特定のコアでのみ利用できます。設定の読み込みエラーが起きたら、アプリ名だけで互換性を判断せず、クライアントに表示されているコアを確認し、サブスクリプションの構文と照らし合わせてください。
ソースコードとライセンス
オープンソースのコアであるmihomoは、ソースコードとライセンス情報を公開しています。GPL-3.0はソフトウェアの利用、変更、再配布に関する条件を定めるもので、ノードサービスの品質を保証するものではありません。GUIクライアントを選ぶ際は、クライアント自体のプロジェクト情報も確認してください。コアがオープンソースであることと、個々のGUIクライアントのメンテナンス状況は別の問題です。
設定の管理範囲
クライアントは設定の読み込みと状態の表示を担い、サブスクリプションの内容は通常、利用中のサービス提供元が管理します。読み込みは成功してもノードが使えない場合は、設定の更新日時、プロキシグループの選択肢、接続ログを確認しましょう。クライアントのインストールに失敗した場合は、パッケージ形式とシステム要件を確認します。問題を分けて考えると、原因を追いやすくなります。
アップデート時の確認ポイント
クライアントをアップデートする前に、使用中の設定と重要なローカル上書きを控えておきます。更新後はまずコアが起動するか確認し、次にサブスクリプション、プロキシグループ、ルールモード、システムプロキシをチェックしてください。コアを変更した場合や、長期間更新されていなかった場合は、既存設定のルールプロバイダー、DNS、TUNの項目を重点的に見直しましょう。以前の設定がそのまま互換性を保つとは限りません。
git clone https://github.com/MetaCubeX/mihomo.gitこのコマンドは公開ソースコードをローカルで確認するためのもので、GUIクライアントのインストールには必要ありません。一般ユーザーはインストーラーページからデバイスに合ったクライアントを選べます。ルールやDNSを変更する場合は、応用設定ガイドを見ながら項目ごとに設定してください。
初回起動時によくある質問
詳しい手順を見る →接続前に確認するポイント
設定の読み込み、通信の取り込み、ルールの適用の順に確認します。一度に変更する設定は一つにすると、接続に影響した箇所を判断しやすくなります。
サブスクリプションを読み込んだのに、ブラウザーが直接接続するのはなぜ？
読み込みが完了しただけでは、通信はプロキシ経由になりません。対象の設定が現在の設定になっていることを確認し、ルールモードとプロキシグループを選んでから、システムプロキシを有効にしてください。その後、接続ログにブラウザーからのリクエストが表示されるか確認します。記録がない場合は、まずシステムプロキシのスイッチとポートを確認しましょう。チュートリアルに沿って確認 →
ルールモードとグローバルモード、最初はどちらを選ぶ？
普段はルールモードを選び、設定内のルールでリクエストの振り分け先を決めます。グローバルモードは一時的な切り分けに使えます。グローバルモードでは接続できるのにルールモードでは想定どおりにならない場合は、ルールの順序とプロキシグループ名を確認してください。テスト後は必要なモードに戻しましょう。モードの切り替え手順を見る →
mixed-portを変更したら、アプリが接続できなくなったのはなぜ？
変更後のポートが他のアプリに使われていないか確認し、OSまたはアプリ内のプロキシアドレスが古いポートを参照していないか確認してください。設定ファイルを変更した後は、クライアントで設定を再読み込みする必要があります。YAMLだけを変更してシステムプロキシを更新しないと、両者の設定が一致しません。接続の確認手順に戻る →
TUNモードを有効にするのはどんなとき？
まずシステムプロキシを使って基本的な接続を確認してください。対象のアプリがシステムプロキシに従わず、より広い範囲の通信を取り込む必要がある場合に、クライアントの案内に従ってTUNに必要なシステム権限を許可します。有効にした後、LANへのアクセスに問題が起きたら、ルートとDNSの設定を個別に確認しましょう。TUNの設定方法を見る →
使い方のヒント
すべての記事を見る →具体的なトラブルをさらに確認
以下の記事では、公開日順にサブスクリプション形式、Androidのバックグラウンド接続、コアの選び方を取り上げ、初期設定後によくある課題を解説しています。
Clashのサブスクリプション形式を解説：YAML設定、Base64ノードリスト、形式変換
完全なYAML設定、Base64形式のノードリスト、単一ノードの共有リンクを区別し、同じURLでもクライアントによって読み込み結果が異なる理由や、形式変換で失われる可能性のある項目を解説します。
記事を読む →Android版Clashがバックグラウンドで切断されるときの対処法：VpnServiceの許可とバッテリー最適化
画面ロック後に切断される場合は、システム権限、バッテリー最適化、自動起動、バックグラウンド実行の順に確認します。まずクライアントのVPN権限を確認し、システムによるプロセス終了とサブスクリプション自体の問題を切り分けましょう。
記事を読む →オリジナルClash・Clash Meta・mihomoコアの違い：バージョンの変遷と選び方
コアのメンテナンス状況、プロトコル対応、ルール構文を比較し、GUIクライアントとコアの関係を解説します。見慣れない設定項目がある場合は、まずコアの違いを確認しましょう。
記事を読む →