Windows
デスクトップでのブラウジングや普段使いに適しています。システム情報でCPUの種類を確認してからインストールし、設定を読み込んでシステムプロキシを有効にしてください。システムプロキシを使わないアプリの通信も制御したい場合は、ガイドに沿ってTUNを設定します。初回接続前に複数のネットワーク設定を同時に変更するのは避けてください。
ダウンロードまずOSを確認し、次にCPUアーキテクチャを確認してください。ダウンロードページでは、クライアントの選び方、インストール方法、システム要件をまとめて確認できます。このリンクから各OSのページへ直接移動できます。
デスクトップでのブラウジングや普段使いに適しています。システム情報でCPUの種類を確認してからインストールし、設定を読み込んでシステムプロキシを有効にしてください。システムプロキシを使わないアプリの通信も制御したい場合は、ガイドに沿ってTUNを設定します。初回接続前に複数のネットワーク設定を同時に変更するのは避けてください。
ダウンロードApple SiliconまたはIntelに合ったインストーラーを選びます。「このMacについて」でチップ情報を確認し、インストール後は案内に従ってネットワーク機能を許可してください。別のクライアントに切り替えるときは、旧クライアントのシステムプロキシを先に無効にし、バックグラウンドプロセスによるポート占有やネットワーク設定の変更を防ぎます。
ダウンロードスマートフォンやタブレットでの利用に適しています。端末のアーキテクチャに合ったパッケージを選び、サブスクリプションを読み込んだらVPN接続を許可してください。通常、VPN接続を利用できるアプリは同時に1つだけです。接続に失敗する場合は、ほかのVPNアプリが動作していないか確認してください。バックグラウンド接続が頻繁に切れる場合は、バッテリー最適化とバックグラウンド実行の権限を確認します。
ダウンロードiPhoneとiPadで利用できます。ダウンロードページからClash PlusのApp Storeページにアクセスできます。公式サイトはclashplus.ioです。インストール後に設定を読み込み、VPN接続を許可してからクライアントに戻り、接続を開始してください。利用前にサブスクリプションの形式がクライアントに対応しているか確認しましょう。
ダウンロードデスクトップではGUIクライアントを選び、ディストリビューションのパッケージ管理方法に沿ってインストールできます。サーバーやルーターで使う場合は、ダウンロードページでコアの入手先を確認できますが、設定、サービス権限、ルーティングは自分で管理する必要があります。GUIが起動しても通信が制御されているとは限りません。プロキシの入口とルールの適用状況を確認してください。
ダウンロードルールによる振り分けからネットワークの制御まで、5つの設定項目はそれぞれ役割が異なります。各機能の役割を理解してから、有効にするか判断しましょう。以下はmihomoの設定例です。クライアントによって項目名や利用できる機能は異なり、この断片を完全な設定として読み込むことはできません。
ルールモードでは、設定に記述された順に接続を照合し、一致したルールに対応するポリシーで処理します。具体的なドメインルールは包括的なルールより前に置き、最後にMATCHで残りの接続を処理します。ポリシーグループは選択できる接続先を決め、ルールはどの接続をそのグループに振り分けるかを決めます。両者は役割が異なります。すべての通信を1つの接続先に送るグローバルモードと異なり、ルールモードでは直接接続を維持しながら、用途に応じてプロキシ通信を整理できます。変更後は接続ログで適用されたルールを確認し、順序を調整する必要があるか判断してください。
mode: rule
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,DIRECT
ルールは上から順に照合されます。MATCHは最後に配置します。
設定管理では、サブスクリプションやローカルのYAMLファイルを複数保存できます。読み込み後は、見分けやすい名前を付け、現在有効な設定を確認してください。ダウンロードできても、コアの設定が切り替わったとは限りません。リモートサブスクリプションを更新すると内容が更新されます。ローカルファイルは、変更を管理しやすい検証用設定の保存に適しています。サブスクリプションの原文に変更を書き込むより、クライアントが対応するオーバーライド機能を使うほうが個人設定を保ちやすくなります。複数の設定を切り替える場合、通常は設定全体が置き換わり、ポリシーグループやルールが自動で統合されることはありません。
更新前にローカルオーバーライドを保存し、切り替え後に現在の設定を確認してください。
TUNは仮想NICとルーティング設定を使って通信をコアに取り込み、システムプロキシを参照しないアプリにも適しています。ブラウザーのプロキシ設定とは異なり、有効にすればすべての通信がプロキシ経由になるわけではありません。コアに取り込まれた通信も、モードとルールに応じて接続先が選ばれます。初回の有効化には、サービスコンポーネントやシステム権限が必要な場合があります。まず通常のプロキシ接続を確認してからTUNを有効にし、LANへのアクセスとDNS名前解決を確認しましょう。ほかのVPNと競合する場合は、ルーティング設定を重ねて変更せず、どちらか一方を停止してください。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
自動ルーティングには、OSの対応と必要な権限が求められます。
DNSはドメイン名をどのように名前解決するかを決め、Fake-IPは割り当てたIPアドレスを使ってドメインと後続の通信を関連付け、コアがドメインルールに基づいて通信を処理できるようにします。Fake-IPはパブリックDNSのアドレスではなく、無効なサブスクリプションを単独で修復するものでもありません。実IPアドレスを直接返す方式と異なり、Fake-IPではコアが対応関係を管理します。LAN内のサービスによっては、状況に応じてフィルター対象に加える必要があります。変更前に、DNSリクエストがコアに届いているか、上流DNSに接続できるかを確認してください。トラブル対処では一度に1項目ずつ変更し、モード、上流DNS、通信の取り込み方法を同時に変えないようにします。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
nameserver:
- 1.1.1.1
割り当てたIPアドレスはコアが処理します。上流DNSはネットワーク環境に合わせて選択してください。
外部コントロールAPIを使うと、対応パネルからコアの状態や接続を確認し、ポリシーを切り替えられます。プロキシ通信を受け付けるポートとは用途が異なるため、ポート番号を間違えるとパネルが接続できません。GUIクライアントには通常、管理機能が組み込まれています。パネルを別途導入する機会が多いのはサーバー環境です。設定を直接編集する代わりに、コントロールパネルは状態の確認や一時的な操作に便利ですが、変更が保存されるかどうかは実装によって異なります。接続先は原則としてローカルアドレスに限定し、アクセスキーを設定してください。コントロールAPIをインターネットに直接公開しないでください。
external-controller: 127.0.0.1:9090
secret: "your-password"
ローカルアドレスのみにバインドし、サンプルのパスワードは必ず変更してください。
まずはクライアントの標準設定で安定した状態を確認し、その後に機能を1つずつ追加しましょう。詳しいパラメーター、ポリシーグループの種類、ルールセットの管理方法は設定の応用をご覧ください。見慣れない項目は用語集で役割を確認できます。
初めて使うときは、まず最短の手順で確認します。設定を読み込めること、通信がクライアントに届くこと、対象のリクエストが想定どおり処理されることを確かめましょう。以下の3ステップでは、必要な流れに絞って説明します。すべてのパラメーターを先に理解する必要はありません。クライアントによってボタンの位置は異なりますが、設定、モード、ネットワークの入口の関係は共通です。
設定管理画面を開き、サブスクリプションURLを入力欄に貼り付けて、読み込みをクリックします。設定項目が表示されたら、現在の設定として選択してください。ローカルファイルを使う場合はファイルから読み込み、内容がクライアント対応のYAMLであることを確認します。Webページのテキストやエラーメッセージでは読み込めません。
次に、構文エラーがないか確認します。設定名が表示されただけでは不十分です。コアがその設定を読み込んでいることも確認してください。読み込みに失敗した場合は、URLが完全か、サブスクリプションが有効か、システム時刻が正しいかを先に確認します。原因が分かりにくくなるため、DNSやTUNはまだ変更しないでください。
普段の利用では、まずルールモードにしてから、プロキシ画面で設定内のポリシーグループと接続先を選びます。デスクトップではシステムプロキシを有効にし、モバイル端末では案内に従ってVPN接続を許可してください。TUNが必要な場合は、基本の接続確認後に有効化し、クライアントの案内に従ってサービスのインストールや権限の許可を行います。
グローバルモードは、ルールの問題か接続の問題かを一時的に切り分けるときに使えます。直接接続モードでは、リクエストはプロキシポリシーを通りません。モードを切り替えても、設定の確認が不要になるわけではありません。アプリ独自のプロキシ設定や別のVPNがある場合は、リクエストがどのネットワーク経路に入っているかを先に確認してください。
アクセスしたいページを開き、クライアントに戻って接続ログを確認します。リクエストが記録されているか、想定したルールが適用されているか、選択したポリシーと接続先が正しいかを確認してください。直接接続が必要なページやLAN内のサービスも確認し、1つのWebサイトだけをテストして通常の通信を見落とさないようにしましょう。
ページを開けない場合は、まず「接続ログがない」場合と「ログはあるが接続に失敗している」場合に分けて考えます。前者ではシステムプロキシ、VPNの許可、アプリの設定を確認します。後者では接続先、サブスクリプション、名前解決を確認してください。エラーメッセージを記録し、設定を1つずつ変えて再テストすると、複数のスイッチを一度に変更するより原因を特定しやすくなります。
Clashのエコシステムには、コア、GUIクライアント、設定ツール、コントロールパネルがあります。名称が似ていても、同じプロジェクトとは限りません。オリジナルのClashプロジェクトと、その後に登場したコミュニティ製の実装は分けて考える必要があります。mihomoはClash Metaに関連する技術路線を引き継いでおり、現在多くのクライアントで採用されているオープンソースコアです。古いガイドの画像、メニュー、設定項目は、すでにメンテナンスが終了したクライアントのものかもしれません。操作時は、使用中のプロジェクトのドキュメントを確認してください。
ダウンロードページでは、アーカイブ済みのクライアントを個別に表示し、旧環境との互換性が必要なユーザーにも分かるようにしています。選ぶ際は、名称になじみがあるかだけで判断せず、現在もメンテナンスされており、利用中のOSに対応する実装を優先してください。トップページには個別のリリース番号を掲載せず、クライアントのリリース情報はダウンロードページにまとめています。コアのリリースとGUIのリリースを混同しないためです。
コアは設定の解析、接続の確立、ルールの照合、DNS処理、ネットワークの取り込みを担当します。GUIクライアントは、サブスクリプション管理、モード切り替え、システムプロキシ、ログ確認などの操作画面を提供します。そのため、同じコア機能でもクライアントによってスイッチの名称が異なり、サービスコンポーネントが代わりに管理する場合もあります。設定項目を使う前に、コアが対応しているかだけでなく、クライアントから直接編集またはオーバーライドできるかも確認してください。
クライアントの更新とコアの更新は別のものです。画面が更新されても、ネットワークの動作が変わるとは限りません。コアを入れ替えると、設定の互換性が変わることもあります。トラブル対処では「更新した」とだけ伝えるより、クライアント名、OS環境、有効にしたモード、エラーメッセージを記録するほうが役立ちます。問題を再現するときは、最小限の設定を使い、関係のないルールやオーバーライドを先に取り除いてください。
mihomoの公開リポジトリでは、ソースコード、ライセンス、課題の議論、リリースノートを確認できます。ライセンスはGPL-3.0です。オープンソースであれば実装を確認でき、メンテナンス状況もダウンロードページの説明ではなく公開記録から判断できます。プロトコルの対応状況、設定項目の動作、既知の問題は、コアのドキュメントとリリースノートを参照してください。特定クライアントのGUI機能については、そのクライアントのドキュメントを確認します。
コミュニティに問題を報告する前に、同じ現象がすでに報告されていないか検索し、再現手順をまとめてください。ログに含まれるサブスクリプションURL、アクセスキー、接続先IPアドレス、個人のアクセス履歴には機密情報が含まれる場合があります。内容を加工せず、そのまま公開しないでください。エラーの該当部分、関連する設定項目、実際に確認した結果を整理して共有すると、議論が進みやすくなります。当サイトは日本語の案内と操作説明を提供しますが、各プロジェクトのメンテナンス責任とライセンスは、それぞれのリポジトリをご確認ください。
ソフトウェアの更新ではクライアントやコアの実装が変わり、サブスクリプションの更新では接続情報、ポリシー、ルールが更新されます。両者は分けて管理してください。サブスクリプションを更新する前に、個人設定がローカルオーバーライドとして保存されているか確認します。ソフトウェアを更新する前には、現在の設定と必要な項目をバックアップし、ネットワーク動作に関する変更内容を確認してください。リモートサブスクリプションの原文に個人設定を保存しないでください。次回の更新で編集内容が上書きされることがあります。
アップグレード後に問題が起きたら、コアが正常に設定を読み込んでいるか、オーバーライドが有効か、システムプロキシやTUNが再び有効になっているかを確認します。ネットワークが使えているなら、特定のバージョン番号を追うためだけに設定を頻繁に変える必要はありません。新機能が必要な場合や既知の問題を解決する場合に、リリースノートを確認して更新してください。変更前の状態に戻せるよう、毎回の変更で復元可能な基準を残しておくと、変化がソフトウェア、設定、ネットワーク環境のどれに起因するか判断しやすくなります。
基本の接続を確認したら、具体的な症状に応じて詳しく調べましょう。以下の記事では、証明書の検証、起動ログ、接続経路を取り上げ、問題が発生している層を説明したうえで確認手順を紹介します。現在の設定を保ち、変数を1つずつ変えて再テストしてください。
証明書エラーの主な原因を解説し、プロキシに関係するものと、システム時刻やネットワーク上の干渉に起因するものを切り分けて、状況に応じた対処方法を紹介します。
記事を読む →設定の構文エラー、コアファイルの欠落、権限不足、残存プロセスの4つの観点から起動時のクラッシュ原因を特定し、各OSでのログの場所と設定のリセット方法を解説します。
記事を読む →サブスクリプションの有効性、システム時刻、ポートの競合、DNSの名前解決、ルールの適用状況の順にノードのタイムアウトを確認し、各手順の判断基準と対処方法を紹介します。
記事を読む →