Windows
まずはClash PlusなどのGUIクライアントから始めましょう。初回接続ではシステムプロキシの動作を確認し、アプリに応じてTUNを有効にします。ポート競合やサービス権限の警告が出た場合は、サブスクリプションを何度も変更するのではなく、まずローカル環境を確認してください。
ダウンロードページへmihomoコアオープンソースクライアントを継続更新
mihomoコアをベースに、サブスクリプションの読み込みからルール分岐まで、設定項目ごとにプロキシ、DNS、TUNを解説します。
CONFIGURATION INSPECTOR
設定ファイルは、通信の受け入れから名前解決、ルール判定、送信先までを順に定めます。まずリクエストがコアに届いていることを確認し、次にマッチしたルールとプロキシグループを調べましょう。複数の設定を一度に変えるより、該当する項目に絞って確認するほうが原因を特定しやすくなります。
ルールは上から順に評価され、一致すると指定されたプロキシグループで処理されます。ドメインサフィックスは対象サイトの指定に、地理情報ルールはIPアドレスの地域判定に使えます。最後のMATCHは、ほかのルールに一致しなかった通信を受け持ちます。サイトへの接続先が想定と異なる場合は、接続ログでドメイン、マッチしたルール、最終的なプロキシグループを確認してください。選択中のノードだけを見ても原因は分かりません。Ruleモードではこのルール一覧が適用され、Globalモードではグローバルポリシーが使われます。モードを切り替えてもルール自体は修正されません。例で参照するPROXYグループは事前に定義が必要です。また、GEOIPルールには利用可能な地理情報データが必要です。
mode: rule
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY
TUNは、ルーティング条件に合う通信を仮想ネットワークインターフェース経由で取り込みます。システムプロキシ設定を参照しないアプリや、追加の処理が必要なUDP通信に適しています。有効にする前に、クライアントにサービス起動または管理者権限があることを確認し、仮想インターフェースとルートが作成されているか調べてください。TUNで拡張されるのは通信を取り込む範囲であり、接続先の回線品質が向上したり、すべてのノードでUDPが使えるようになったりするわけではありません。ほかのVPNと同時に使うとデフォルトルートが変わる場合があるため、初回設定では通信を取り込むツールを一つに絞りましょう。この例は通信の取り込み設定のみを示しています。DNSのリダイレクトには、コアのDNS機能も有効にする必要があります。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
mihomoは複数のプロキシプロトコルに対応していますが、同じプロトコル名でも設定項目をそのまま流用できるとは限りません。設定を読み込む際は、提供元のサーバー、ポート、認証情報、トランスポート設定を維持してください。TLSを使う場合は、証明書の検証設定とサーバー名も確認します。証明書検証を無効にして、時刻、ドメイン名、証明書チェーンの問題を回避しないでください。GUIで選べる項目は、クライアントと搭載コアの対応状況によって異なります。以下は予約済みのサンプルドメインを使ってSOCKS5設定の項目を示したものです。アドレスと認証情報は実際の接続先ではなく、そのままでは接続できません。
proxies:
- name: example-socks
type: socks5
server: proxy.example.com
port: 1080
username: your-username
password: your-password
プロキシグループを使うと、ルールと個々のノードを分けて管理できます。ルールからは固定のグループ名を参照し、グループ内で手動選択、定期的な速度テスト、利用可能なノードへのフォールバックを設定します。selectは初回接続時などに接続先を明示したい場合に適しています。url-testはテスト結果に基づいて候補を評価し、fallbackは設定順に利用可能な候補を選びます。自動選択はテスト先、ネットワーク状態、チェック間隔などに左右され、テスト値がそのままダウンロード速度を示すわけではありません。以下の例では手動選択グループから既存のプロキシに接続します。example-socksはproxiesで定義してください。グループ名の大文字・小文字とルール側の参照名も一致させないと、設定が想定どおり読み込まれません。
proxy-groups:
- name: PROXY
type: select
proxies:
- example-socks
- DIRECT
fake-ipはDNSクエリに合成アドレスを返し、コアがアドレスとドメインの対応を保持することで、後続のリクエストをドメインベースのルールで判定できるようにします。実際のサーバーアドレスを恒久的に別の接続先へ置き換えるものではなく、最終的なアクセス先はプロキシポリシーによって決まります。設定時はDNS上流への到達性、通信の取り込み方法、ローカルアプリとの互換性を考慮してください。LAN内のデバイス検出や独自の名前解決では、対象を除外する必要がある場合があります。例ではループバックアドレスを使い、ローカルでの名前解決先を示しています。外部ネットワークに公開しないでください。この設定を有効にした後、OSまたはTUNからのDNSクエリが実際にコアへ渡されていることも確認しましょう。
dns:
enable: true
listen: 127.0.0.1:1053
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- 1.1.1.1
クライアントの設定用サブスクリプションは通常、YAML設定全体を読み込みます。一方、proxy-providersはプロキシグループから参照できるプロキシ一覧を読み込む機能で、両者は用途を確認せずに置き換えられません。更新に失敗した場合は、まずURLの有効期限と返却内容を確認し、次にダウンロード通信の経路を調べてください。サブスクリプションURLにはアカウント情報が含まれることがあるため、認証情報として管理し、スクリーンショット、ログ、公開リポジトリに実際のURLを載せないでください。以下は予約済みのサンプルドメインを使い、更新間隔とローカルキャッシュのパスを示しています。提供元のデータはprovider形式に準拠している必要があり、プロキシグループからuseで参照して初めて選択対象になります。
proxy-providers:
remote:
type: http
url: "https://subscription.example.com/proxies.yaml"
path: ./providers/remote.yaml
interval: 3600
CLIENT ENTRY POINTS
まずOSを選び、次にCPUアーキテクチャを確認してください。GUIクライアントは設定管理やシステムとの連携を担い、コアはルールの判定と通信の転送を処理します。インストーラーの対応状況、TUNに必要な権限、設定形式の互換性はそれぞれ確認が必要です。クライアント名だけで判断しないでください。
まずはClash PlusなどのGUIクライアントから始めましょう。初回接続ではシステムプロキシの動作を確認し、アプリに応じてTUNを有効にします。ポート競合やサービス権限の警告が出た場合は、サブスクリプションを何度も変更するのではなく、まずローカル環境を確認してください。
ダウンロードページへApple SiliconまたはIntelに合ったインストーラーを選んでください。システムプロキシとネットワーク拡張では許可する場所が異なるため、インストール後にシステムの案内を確認します。スリープからの復帰後やネットワーク切り替え後は、接続先と名前解決が正常か再確認してください。
ダウンロードページへデバイスのアーキテクチャとインストール権限を確認し、サブスクリプションを読み込んだらVPN接続を許可します。バックグラウンドの省電力設定でサービスが停止することがあります。画面ロック後に切断される場合は、バッテリー制限と、ほかのVPNアプリが通信の取り込み機能を使用していないか確認してください。
ダウンロードページへダウンロードページからClash PlusのApp Storeページへ進んでください。公式サイトはclashplus.ioです。読み込み前に設定形式の互換性を確認し、初回起動時はシステムの案内に従ってVPN接続を許可してから、ルールと接続先を検証してください。
ダウンロードページへデスクトップではGUIクライアントを選べます。サーバーやルーターで使う場合は、コアのダウンロード先を確認してください。インストール前に、ディストリビューションのパッケージ形式、CPUアーキテクチャ、サービスの実行ユーザーを確認しましょう。デスクトップのプロキシ設定だけで、端末全体の通信が取り込まれるとは限りません。
ダウンロードページへダウンロードページでは、OS別にクライアント、アーキテクチャ、システム要件を確認できます。すでに別のクライアントを使っている場合は、移行前に設定をエクスポートし、ローカルルール、オーバーライド、プロキシグループの選択内容を記録してください。同じサブスクリプションでも、ツールによって変換処理が異なる場合があります。画面が似ていても、設定の処理方法まで同じとは限りません。
Clash for Windowsは更新が終了していますが、古いインストーラーがチュートリアルのスクリーンショットに残っている場合があります。新たに導入する場合は、メンテナンスが続いている選択肢を優先し、アーカイブ版は明確な互換性要件がある場合に限って利用してください。移行後は古いツールの自動起動とシステムプロキシを無効にし、複数のプロセスによるポート競合やシステム設定の上書きを防ぎましょう。
FIRST CONNECTION
クライアントをインストールしただけでは、通信がプロキシ経由になるとは限りません。「設定を読み込む → プロキシグループを選ぶ → 通信を取り込んで検証する」の順に進めると、サブスクリプションの取得、ノードへの接続、ローカル通信の取り込みを切り分けられます。以下の画面は設定項目の一例です。具体的なメニュー名は使用するクライアントによって異なります。
設定またはサブスクリプションの画面を開き、リモート設定を追加して既存のURLを貼り付けます。取得できたら、その設定を選択してプロキシグループが表示されることを確認してください。URLを保存しただけで設定を有効にしていない場合、現在の接続は変わりません。
Webページやログイン画面が返る場合、または内容が空の場合は、まずサブスクリプション提供元にURLとアカウントの状態を確認してください。アカウント情報を含むURLを公開変換サイトに送信したり、サブスクリプションの内容を公開の質問掲示板に貼り付けたりしないでください。
初回はRuleモードを選び、実際のルールから参照されているプロキシグループでノードを指定してテストします。遅延テストの結果は特定の接続先への測定値であり、すべてのWebサイトの表示速度を示すものではありません。
テストがタイムアウトしても、ノードが完全に使えないとは限りません。測定先や名前解決経路に問題がある場合もあります。実際のWebサイトへの接続やログも確認し、まず接続先を一つに固定して検証してから、自動テストやフォールバックを設定してください。
まずシステムプロキシを使ってブラウザーで動作を確認します。プロキシ設定に従わないアプリでは、必要に応じてTUNを有効にしてください。対象サイトを開き、接続ログでマッチしたルール、プロキシグループ、最終的な接続先が想定どおりか確認します。
検証時は、ブラウザー、ターミナル、その他のアプリを分けて確認してください。ターミナルのツールでは、プロキシ環境変数を個別に設定する必要がある場合があります。また、IP確認サイトに表示されたアドレスはその問い合わせの接続先を示すだけで、すべての通信が同じ経路を通っている証拠にはなりません。
SOURCE & MAINTENANCE
Clash Metaは、このコアの系統で初期に使われていた名称です。現在、コアプロジェクトはmihomoとして開発・保守されています。検索結果、設定ガイド、一部のクライアント名には、今もMetaの表記が残っています。ドキュメントが使えるか判断するときは、ウィンドウのタイトルではなく、実際に動作しているコアと対応する設定項目を確認してください。古いスクリーンショットにあるボタン名が、現在の画面では変わっていることもあります。
mihomoは設定の解析、プロトコル処理、ルール判定、DNSなどを担います。GUIクライアントはその上に、サブスクリプション管理、トレイメニュー、システムプロキシ、サービス管理などを提供します。クライアントの更新とコアの更新は別々です。設定キーが認識されない場合は、更新する前に実際のコア情報と読み込みログを確認し、どちらの層を更新すべきか判断してください。
公開リポジトリのコード、ライセンス、課題、リリースノートは、動作を確認するための重要な情報源です。ガイドと実際の画面が一致しない場合は、該当プロジェクトのドキュメントとリリース履歴を確認し、設定項目の名称やデフォルト値が変わっていないか、新しい実行権限が必要かを調べてください。当サイトは中国語の操作ガイドを提供するもので、上流プロジェクトによる機能説明に代わるものではありません。
プロキシコアやクライアントは、プロキシサービスそのものではありません。サブスクリプションに含まれるノード、回線の稼働状況、通信量、アカウントの有効期限はサービス提供元によって決まります。クライアントを新しくダウンロードしても、期限切れのサブスクリプションは復旧しません。いわゆるClash向けVPNサブスクリプションは、サービス提供元から渡される設定の入口です。利用前に提供元、プロトコルの対応状況、サービス規約を確認し、コアプロジェクトに通信サービスが付属していると誤解しないでください。
ルール一覧、地理情報データ、プロキシのサブスクリプションには、それぞれ異なる更新周期があります。ClashのGeoIPデータを更新する場合は、設定で使われているデータ形式とファイルの保存先を確認してください。サブスクリプションを更新する場合は、ノード一覧とローカルのオーバーライドが保持されているか確認します。更新作業を分けて実行すると、問題が起きても既知の状態に戻しやすくなります。
現在動作している設定、重要なオーバーライド、起動オプションを保存し、変更内容を確認してから更新してください。更新後は、起動とYAMLの読み込みを確認してから、DNS、よく使うWebサイト、通信を取り込む必要があるアプリをテストします。差異が見つかった場合は、機密情報を伏せたエラーメッセージを保存してください。問い合わせ時はOS、アーキテクチャ、クライアント、コアの情報を伝え、実際のサブスクリプションURL、パスワード、アカウント情報全体は共有しないでください。
ソースコードの取得は実装の確認や変更履歴の追跡に使います。cloneで取得できるのはリポジトリの内容であり、クライアントが自動でインストールされるわけではありません。一般的なデスクトップ環境では、ダウンロードページのインストーラーを利用できます。
git clone https://github.com/MetaCubeX/mihomo.git
CONFIGURATION NOTES
基本設定が終わったら、症状に合ったガイドを確認してください。システムプロキシが効かない、ルールが誤ってマッチする、ノードが利用できないといった問題は、それぞれ異なる段階で発生します。現状を保ったままリクエストがどこで想定から外れるかを特定し、関連する設定だけを変更しましょう。
ブラウザーとターミナルの両面から、システムプロキシが効かない原因を調べます。ブラウザー拡張機能によるプロキシ設定の上書き、PAC設定やポートの競合、ターミナルでのhttp_proxy環境変数の手動設定などを解説。
トラブル対処の手順を読む →実際のrules設定例を使い、ルールの評価順、GEOSITEとGEOIPの使い分け、rule-providersの参照方法を解説。中国本土への通信を直接接続し、海外向け通信をプロキシ経由にする設定を紹介します。
設定ガイドを読む →サブスクリプションを読み込んだ後の初回接続手順を解説。プロキシグループからノードを選び、遅延テストの見方を確認して、ブラウザーとIP確認サイトでプロキシが有効か確かめます。
接続手順を読む →