まず、クライアント・コア・設定ファイルの違いを把握しましょう。クライアントは操作画面を提供し、mihomoコアはネットワーク接続を処理します。設定ファイルは、プロキシノード、グループ、ルールの連携方法を定めます。左側の項目を見て設定の意味を確認し、クライアントに戻って一つずつ設定してください。複数のスイッチを同時に変更すると、何が原因で動作が変わったのか分かりにくくなります。
mihomoは、設定の解析、ルールの照合、プロキシ接続の確立を担うコアです。GUIクライアントはその上にサブスクリプション一覧、モード切り替え、ログ画面などを提供します。そのため、画面の名称が異なっていても、基盤となる設定がすべて異なるとは限りません。クライアントを選ぶ際は、対応するコアと設定項目を確認してから、既存のサブスクリプションを読み込んでください。設定の解析エラーが出た場合は、クライアントが起動するかどうかだけで互換性を判断せず、ログに表示された項目名を確認しましょう。以下は基本的な項目の例であり、そのまま接続に使える完全な設定ではありません。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: infoサブスクリプションは設定内容を取得するためのURLで、YAMLは一般的な設定ファイル形式です。クライアントの設定またはサブスクリプション画面を開き、URLから読み込む項目を選択します。サービス提供元から案内されたURLをすべて貼り付け、更新が完了したら、その設定を選択してください。ローカルファイルはファイル読み込みの項目から追加します。ノード共有用の文字列は、完全な設定としてそのまま使えるとは限りません。まず形式を確認し、必要に応じて変換してください。サブスクリプションURLには認証情報が含まれることがあります。問題を報告する際はエラー内容だけを共有し、URL全体を公開しないでください。
https://example.com/sub?token=xxxx形式を示すサンプルです。利用可能なサブスクリプションサービスは提供していません。
サブスクリプションの読み込み手順を見る →ルールによる振り分けでは、ドメインやアドレスなどの条件に応じて、直接接続するかプロキシを使うかを決めます。コアは通常、上から順にルールを照合し、最初に一致した項目で接続先が決まるため、ルールの順序と内容が重要です。サブスクリプションを読み込んだら、まずルールモードを使い、プロキシグループで利用可能なノードが選択されているか確認してください。グローバルモードではより多くの接続をグローバル設定に渡しますが、利用できないノードが直るわけではありません。例のDIRECTは直接接続を表し、指定したドメインサフィックスにのみ適用されます。すべてのAppleサービスが直接接続されるという意味ではありません。
rules:
- DOMAIN-SUFFIX,apple.com,DIRECTシステムプロキシを有効にすると、端末のプロキシアドレスがOSの設定に反映され、その設定に従うアプリの通信がクライアントに渡されます。初めて使う場合は、まずこの方式を有効にしてブラウザーで接続を確認し、ログに該当するリクエストが記録されているか見てください。ターミナルツールや一部のアプリはシステムプロキシを参照しないため、個別にプロキシアドレスを設定するか、TUNを使う必要があります。クライアントを終了する前にシステムプロキシを無効にしてください。異常終了後にWebページが開けなくなった場合は、OSの設定が停止中のローカルポートを参照したままになっていないか確認しましょう。
# ポート番号はクライアントの実際の設定に合わせる
HTTP / SOCKS: 127.0.0.1:7890
mixed-port: 7890TUNは仮想ネットワークインターフェースで通信を受け取る方式で、システムプロキシ設定に従わないアプリにも適しています。通常、クライアントに補助サービスをインストールし、システムの許可を与える必要があります。まず通常のプロキシ接続が使えることを確認してからTUNを有効にし、ログとDNS名前解決が正常か確認してください。VPN、ほかのプロキシソフト、コンテナのネットワークがルートの競合を引き起こすことがあります。問題を切り分ける際は、通信を取り込む方式を一度に一つだけ有効にしてください。TUNは通信を取り込む範囲を広げる機能です。最終的に直接接続するかプロキシを使うかは、引き続きモードとルールによって決まります。
tun:
enable: true
auto-route: true
auto-detect-interface: trueAppleメニューから「このMacについて」を開き、「チップ」にApple製チップの名称が表示される場合は、Appleシリコン版またはARM64版を選びます。「プロセッサ」にIntelと表示される場合は、Intel版またはx64版を選択してください。ネイティブ対応のアーキテクチャなら変換環境への依存を減らせますが、クライアントに記載されたmacOSの要件も満たす必要があります。インストール前に旧クライアントを終了し、アプリをApplicationsにドラッグしてから起動してください。クライアントを乗り換える際は、設定とカスタムルールをバックアップし、複数のプログラムが同時にシステムプロキシを変更しないようにしましょう。
uname -m
# arm64：Appleシリコンのネイティブ環境
# x86_64：Intel環境または変換実行中のターミナル機能の説明は8秒ごとに切り替わります。クリック、キーボード操作、フォーカスのいずれかで停止します。項目の例は設定の意味を説明するもので、実際の設定は選択したクライアントとサブスクリプションの内容に従ってください。
まずOSを選び、次にアーキテクチャを確認します。デスクトップではGUIクライアントを優先し、サーバーやルーターではコアの直接実行を検討してください。以下のリンクから各プラットフォームのダウンロードページを開けます。ダウンロードは自動で始まりません。システム要件、メンテナンス状況、インストール手順を確認してからクライアントを選びましょう。
AppleシリコンまたはIntelに合ったインストーラーを選び、まずClash Plusを確認しましょう。Clash Verge RevやFlClashとの比較もできます。DMGディスクイメージを開き、アプリをApplicationsにドラッグしてから、アプリケーションフォルダ内のアプリを起動してください。インストーラーの画面は、日常的な起動に使うものではありません。
初回起動時は、システムの案内に従って提供元を確認してください。TUNを使う場合は、クライアントの案内に従って補助サービスをインストールします。システムが起動をブロックした場合は、ダウンロード元、システム要件、表示されたメッセージを確認してください。システムのセキュリティ機能を無効にすることを、一般的なインストール手順として扱わないでください。アーカイブされたクライアントは古い設定を確認する用途にとどめ、日常利用にはメンテナンスが継続している選択肢を優先してください。
Clash Plus、Clash Verge Rev、FlClashなどのデスクトップクライアントを比較し、OSとプロセッサに合ったものを選んでください。インストール後は設定を読み込み、プロキシグループでノードを選択してからシステムプロキシを有効にします。仮想ネットワークインターフェースで通信を取り込む場合は、クライアントの要件に従ってサービスをインストールするか、必要な権限を付与してください。
Clash for Windowsはメンテナンスが終了しています。ダウンロードページにはアーカイブ情報を掲載していますが、現在もメンテナンス中のクライアントと同じ選択肢として扱うことはできません。ストアアプリの一部ではUWPのループバック制限が関係するため、アプリの種類に応じて個別に確認してください。ブラウザーではWebページを開けるのにほかのアプリが接続できない場合は、すぐに再インストールせず、そのアプリがシステムプロキシを参照しているかを確認しましょう。
Clash Plus、Clash Meta for Android、FlClash、Surfboardのインストール方法を確認できます。比較的新しいスマートフォンの多くはARM64ですが、端末情報に基づいて選んでください。インストール後はクライアントが対応する形式の設定を読み込みます。初回接続時には、VPN接続の許可を求めるダイアログが表示されます。
AndroidのVPN権限は、端末上の通信を取り込むための経路を作るものです。利用可能なプロキシノードが手に入るわけではありません。接続がバックグラウンドで頻繁に切れる場合は、バッテリー最適化、バックグラウンド動作、ほかのVPNアプリとの競合を確認してください。クライアントによって対応するサブスクリプション形式が異なることがあります。URLをブラウザーで開けるだけで、そのまま読み込めると判断しないでください。
ダウンロードページからClash PlusのApp Storeページを開き、ストアでデバイスの互換性とアプリの説明を確認してください。クライアントの公式サイトはclashplus.ioです。インストール後に設定を追加し、システムの案内に従ってVPN構成の作成を許可してから、アプリに戻って接続を有効にします。
スマートフォンとMacで同じサービスのサブスクリプションを使える場合もありますが、形式とデバイス数の制限を確認してください。Wi-Fiとモバイル通信を切り替えた後に接続できない場合は、まずアプリの状態とサブスクリプションの有効期限を確認し、再接続します。許可ダイアログが解決するのはシステムの通信取り込み権限だけです。ノード、ルール、DNSの設定は、引き続きクライアントで確認する必要があります。
デスクトップ環境ではClash Verge RevまたはFlClashを選び、ディストリビューションに合ったパッケージ形式とアーキテクチャを確認してください。インストール後、まずGUIでサブスクリプションを読み込み、デスクトップ環境のプロキシ設定を確認します。設定の場所はデスクトップ環境によって異なります。また、GUIクライアントでプロキシを有効にしても、ターミナルのプログラムには反映されないことがあります。
サーバーやGUIのないデバイスでは、mihomoを直接実行し、systemdでプロセスを管理できます。その場合、設定ファイルのパス、実行ユーザー、リスニングアドレス、ログの権限を自分で管理する必要があります。コントロールインターフェースをインターネットに直接公開しないでください。また、接続を簡単にするためにLAN向けのリスニングを安易に有効にしないでください。コマンドラインでの導入とデスクトップへのインストールの違いは、インストールガイドで項目ごとに確認できます。
Clash for Macは、Macユーザー向けに各種クライアントのダウンロード先と設定方法をまとめた情報サイトです。当サイトは、各クライアントやコアプロジェクトの開発・保守担当者とは別の運営主体です。機能の対応状況やメンテナンス状況を判断する際は、名前にClashが含まれているかだけでなく、個々のプロジェクトのリリース情報を確認してください。
コアのリポジトリでは、設定の実装、課題、リリース情報を確認できます。コマンドを実行して取得できるのはソースコードのみで、GUIクライアントはインストールされず、プロキシ接続も自動で開始されません。
git clone https://github.com/MetaCubeX/mihomo.gitClashのエコシステムは、オリジナルのプロジェクトから複数のフォークやコミュニティ製クライアントへと発展してきました。mihomoはClash Metaの流れを受け継ぎ、機能を拡張したコアで、複数のGUIクライアントがプロキシ接続の処理に採用しています。古いガイドに以前の名称や画面が残っていても、現在のメニューの場所、設定項目の対応状況、メンテナンス状況まで同じとは限りません。
情報を調べるときは、まず記事がコアとGUIのどちらを扱っているか確認し、次に対象のクライアントを確かめてください。Clash for WindowsやClashX Metaのアーカイブ版は、古い環境を理解する際に参考になります。ただし、OSとの互換性に問題がある場合は、古い画面を何度も参考にするより、メンテナンスが続いているクライアントへの移行を検討しましょう。
オープンソースのリポジトリでは、設定の解析、ルールの動作、問題の修正について根拠を確認できます。ただし、すべてのクライアントが同じ機能に対応しているわけではなく、サブスクリプションサービスがコアプロジェクトから提供されるわけでもありません。GUIクライアント、プロキシノード、サブスクリプションの提供元にはそれぞれ異なる役割があるため、問題を切り分けて確認する必要があります。
ログに未対応の設定項目が表示された場合は、まずコアのドキュメントとクライアントのリリース情報を照らし合わせてください。設定を読み込めてもすべてのノードに接続できない場合は、サブスクリプションの有効期限、ネットワークへの到達性、ノード情報を確認します。公開の場で質問する際は、サブスクリプションの認証情報、アカウント情報、管理インターフェースのキーを隠し、再現手順と必要最小限のエラー部分だけを共有してください。
クライアントのアップデートでは、画面、補助サービス、コアの同梱方法が変更されることがあります。コアのアップデートは、プロトコル対応、ルール処理、ネットワーク動作に影響する可能性があります。両者が同時にリリースされるとは限りません。更新前に変更内容を読み、カスタムルールと現在の設定を保存してください。更新後は、まずサブスクリプションが読み込めるか確認し、次にシステムプロキシとTUNをテストします。
Webページが開けないからといって、すぐにソフトウェアが古いと判断しないでください。まず失敗するのが特定のサイトだけか確認し、次にDNS名前解決、ルールの適用、ノードへの接続のどこに問題があるか調べます。複数のクライアントを次々に入れ替えるより、確認する順序を整理したほうが原因を見つけやすくなります。ダウンロードページに選択可能なインストーラーをまとめ、ホームページには更新で変わりやすい個別のバージョン情報を掲載していません。
サブスクリプションの更新は、リモートの設定を再取得する操作であり、クライアントのアップデートではありません。更新間隔は提供元の案内とノードの変更頻度に合わせて設定してください。頻繁すぎるリクエストはサービス側の制限を受ける可能性があります。維持したいカスタムルールは、クライアントが対応する上書きやマージの仕組みで管理し、次回更新時にリモートの設定で上書きされないようにしましょう。
クライアントを終了する前にプロキシを切断すると、システムがローカルプロキシを参照したままになる事態を減らせます。TUNを長期間使わない場合は、補助サービスとルートの状態を確認してください。問題が起きたら、発生時刻、ネットワーク環境、モード、エラーメッセージを記録し、インストールガイドの確認手順に沿って対処しましょう。複数の設定を同時に変更すると、変更前の状態を思い出しにくくなります。
読み込みが完了しただけでは、通信できるとは限りません。設定が選択されているか、プロキシグループで利用可能なノードが選ばれているか、システムプロキシまたはTUNが有効かを確認してください。接続ログを開いて、リクエストがコアに届いているか確認します。リクエストがない場合は通信の取り込み設定を、リクエストがあるのに失敗する場合はノードとDNSを調べましょう。よくある質問でトラブルシューティングを見る →
システムプロキシは、アプリのリクエストをクライアントに渡すかどうかを決めます。ルールモードとグローバルモードは、リクエストがコアに届いた後、どの経路へ送るかを決めます。それぞれ別の段階で働くため、互いに置き換えることはできません。初めて使う場合はルールモードを選び、ブラウザーが接続できることを確認してから、アプリに応じて通信の取り込み方法を調整してください。モードの選び方を見る →
両方を有効にするかどうかは、クライアントの実装と用途によって異なります。TUNでより多くの通信を取り込めることが一般的ですが、ルート、DNS、除外設定も確認してください。問題を切り分ける際は、まずそれぞれの方式を個別にテストし、動作を確認してからクライアントの説明に従って併用します。複数のプロキシやVPNアプリが同時にネットワーク経路を変更しないよう注意してください。接続方式に関するQ&Aを見る →
インストールが済んだら、問題に応じて仕組みを確認しましょう。クライアントを乗り換える場合は、対応プラットフォームや操作感を比較してください。ターミナル、ゲーム、LAN内のデバイスが接続できない場合は、システムプロキシ、仮想ネットワークインターフェース、ルーターでの通信取り込みがそれぞれどの範囲を担当するかを整理します。以下の3つの記事では異なる切り口から解説し、デスクトップのスイッチ設定を別のデバイスにそのまま適用しないよう案内します。
対応プラットフォーム、コア、画面の使いやすさ、導入のしやすさから主要クライアントを比較し、Mac、Windows、スマートフォンそれぞれの選び方を紹介します。端末とメンテナンス状況を確認してから、既存の設定を移行するか検討しましょう。
設定ガイドを読む →システムプロキシとTUN仮想インターフェースの通信取り込み範囲を比較し、ターミナルコマンド、ゲーム、DNSの扱いを解説します。まずリクエストがコアに届いているか確認し、そのうえで通信の取り込み方法を調整するか、ルールやノードを調べるか判断しましょう。
設定ガイドを読む →メインルーターと中継ルーターの役割、ゲートウェイとDNSの設定先を整理し、構成の選び方、リソースの見積もり、よくある通信断の原因を解説します。デスクトップでのプロキシの仕組みを理解し、LAN内のデバイスにも通信の取り込み範囲を広げたい方に向けた内容です。
設定ガイドを読む →