Windows
まずClash Plusを確認し、Clash Verge Rev、FlClash、Clash Nyanpasuも比較できます。インストール後に設定を読み込み、システムプロキシを有効にしてください。TUNを使う場合は、サービスと権限も設定します。ローカルポートが使用中なら、再インストールを繰り返す前に、ポートを使用しているプロセスを特定してください。
ダウンロードページへオープンソースプロジェクト · mihomo コアを継続更新
OSに合ったクライアントを選び、YAML設定で接続を管理します。ルール分岐とTUNモードでネットワークへの接続方法を設定できます。
TRAFFIC / CONFIGURATION
まず通信をコアに取り込む方法を決め、次に接続の出口を設定します。
システムプロキシは、OSのプロキシ先をクライアントのローカル待ち受けポートに設定します。ブラウザーなど、システム設定に従うアプリの通信がコアに入り、現在のモードに応じた出口へ送られます。初めて設定する場合は、まずこの方法を試すのがおすすめです。サブスクリプションを読み込み、コアを起動してから、クライアントのシステムプロキシを有効にします。TUNとの違いは接続対象の範囲であり、ノードの速度ではありません。システムプロキシを使わないアプリは、直接接続する場合があります。設定のmixed-portはHTTPとSOCKSの両方を受け付けますが、OSの設定を変更するのはクライアントのスイッチです。
mixed-port: 7890allow-lan: falsemode: rulelog-level: info# システムプロキシはクライアントの画面から有効化
TUNは仮想ネットワークインターフェースとルーティングを使い、システムプロキシを使わないアプリの通信もコアに取り込みます。有効にする前に、通常のプロキシモードでサブスクリプションが使えることを確認し、クライアントに必要な管理者権限またはVPN権限を付与してください。自動ルートは通信をインターフェースに流し、DNSハイジャックは指定した名前解決の経路に接続します。どちらも端末のネットワーク環境に合わせて確認が必要です。システムプロキシより広い範囲の通信を扱うため、ほかのVPN、仮想NIC、ルーティングソフトの影響も受けやすくなります。競合が起きた場合は、設定を一度に変更せず、項目ごとに原因を切り分けてください。
tun: enable: true stack: mixed auto-route: true auto-detect-interface: true dns-hijack: - any:53
ルールモードでは、設定に記載された順に接続先を照合し、一致したルールに対応するポリシーを適用します。ドメインのサフィックス、IPアドレス範囲、ルールセットを組み合わせて通信を振り分け、最後に残りの接続をデフォルトルールで処理できます。すべての通信に同じポリシーを適用するグローバルモードと異なり、ルールモードではローカルサービスを直接接続し、指定したサイトだけをプロキシ経由にできます。カスタムルールを追加する際は、先にポリシー名が定義済みか確認し、範囲の広いルールより具体的なルールを上に置きます。例のPROXYはプロキシグループ名です。完全な設定内で別途定義する必要があり、この断片だけをサブスクリプションとして読み込むことはできません。
mode: rule# PROXYはプロキシグループで定義する必要がありますrules: - DOMAIN-SUFFIX,github.com,PROXY - IP-CIDR,192.168.0.0/16,DIRECT - MATCH,PROXY
サブスクリプションURLから、設定元のノードまたは完全な設定を取得できます。初めて使う場合は、通常クライアントの設定画面でURLを貼り付け、ダウンロード後に対象の設定を選んで有効にします。完全なYAMLにはプロキシグループ、ルール、DNS設定を含められます。一方、プロキシプロバイダーはノードの取得元を管理するもので、利用するにはメイン設定から参照する必要があります。単一のノードURLをコピーするより、既存のルール構成を保てる完全なサブスクリプションが便利です。更新前にローカルの変更をバックアップし、クライアントがオーバーライド機能に対応しているか確認してください。サブスクリプションのキャッシュファイルを直接編集すると、次回の自動更新で上書きされることがあります。
# ローカルのプロキシプロバイダー設定例proxy-providers: local-nodes: type: file path: ./providers/nodes.yaml# プロキシグループからuseでlocal-nodesを参照
PACKAGES / PLATFORMS
OSを選び、プロセッサのアーキテクチャとインストール方法を確認してください。クライアントのダウンロードとプロキシサービスの利用は別の作業です。インストール後に使用可能な設定を用意する必要があります。
まずClash Plusを確認し、Clash Verge Rev、FlClash、Clash Nyanpasuも比較できます。インストール後に設定を読み込み、システムプロキシを有効にしてください。TUNを使う場合は、サービスと権限も設定します。ローカルポートが使用中なら、再インストールを繰り返す前に、ポートを使用しているプロセスを特定してください。
ダウンロードページへApple SiliconまたはIntelに合ったインストーラーを選んでください。Clash Plus、Clash Verge Rev、FlClashではそれぞれ異なる画面を利用できます。ClashX Metaを探す場合は、アーカイブ済みかどうかにも注意してください。初回起動時にmacOSのセキュリティ警告が表示されたら、提供元を確認してから、システムの案内に従って許可してください。
ダウンロードページへClash Plus、Clash Meta for Android、FlClash、Surfboardから選び、サブスクリプション形式がクライアントに対応しているか確認してください。初回接続時はVPN接続の許可が必要です。バックグラウンドで接続が切れる場合は、まずバッテリー最適化とバックグラウンド実行の制限を確認し、その後サブスクリプションの有効期限を確認してください。
ダウンロードページへダウンロードページからClash PlusのApp Storeページに進めます。公式サイトはclashplus.ioです。設定を読み込み、VPN構成の追加を許可してから、ポリシーとノードを選択してください。OSのVPNアイコンはトンネルが確立したことを示すだけです。実際の通信の振り分けは、リクエストの記録も確認してください。
ダウンロードページへデスクトップ環境ではClash Verge RevまたはFlClashから試し、ディストリビューションに合ったパッケージ形式を選んでください。サーバーやルーターではmihomoコアを単独で導入し、設定ディレクトリ、サービス権限、起動方法を別途設定できます。コマンドラインでの導入は、デスクトップクライアントのインストールとは異なります。
ダウンロードページへFIRST CONNECTION
「設定元 → 接続方法 → リクエストの確認」の順に進め、問題が起きた場合も同じ順番で見直しましょう。
ダウンロードページでOSに合ったクライアントを選びます。設定またはサブスクリプションの画面を開き、サービス提供元から入手したClash対応のサブスクリプションURLを貼り付けてダウンロードし、現在の設定として選択してください。設定名が表示されても、有効になったとは限りません。ノード一覧とプロキシグループが表示されていることも確認しましょう。
単一のノードURLまたはBase64テキストだけを入手した場合は、まずクライアントがその形式の読み込みに対応しているか確認してください。変換が必要なら、信頼できるローカル環境での処理を優先しましょう。サブスクリプションURLにはアカウント情報や通信情報が紐づいている場合があります。提供元が不明なオンラインツールには貼り付けないでください。
プロキシグループから利用可能なノードを手動で選び、動作モードをルールに設定します。デスクトップでは、まずシステムプロキシを有効にしてブラウザーで基本動作を確認してください。接続できたら、必要に応じてTUNを有効にします。モバイル端末では、OSの案内に従ってVPN接続を許可してください。
グローバルモードとTUNは別の設定です。前者は通信がコアに入った後のポリシー選択を決め、後者は通信をコアに取り込む方法を決めます。グローバルモードにしても、端末上のすべてのアプリが自動的に取り込まれるわけではありません。
確認したいサイトにアクセスしながら、クライアントの接続一覧を開きます。対象ドメイン、適用ルール、プロキシグループ、最終的なノードを確認し、想定どおりの経路になっているかチェックしてください。1回の遅延テストで分かるのは特定のテスト先に対する結果です。ダウンロード速度や、すべてのサービスの品質を示すものではありません。
ページを開けない場合は、まず通信がコアに届いているか確認します。記録がない場合は、システムプロキシ、VPN権限、ルーティングを調べてください。記録があるのに接続できない場合は、DNS、ノードへの接続状況、ルールの接続先を確認します。設定は一度にひとつだけ変更し、再現可能な確認結果を残してください。
インストーラーにプロキシサービスは含まれていません。クライアントは設定を読み込んで通信を処理し、ノードは設定元から提供されます。サブスクリプションを正常にダウンロードできても、すべてのノードが利用できるとは限りません。サービスの稼働状況と実際の通信で確認してください。
接続できても、通信が正しく振り分けられているとは限りません。ローカル端末、社内ネットワーク、プリンターへの接続には、通常DIRECT経路が必要です。TUNを有効にしてこれらのサービスに問題が起きた場合は、すべての通信をプロキシに送る前に、LANのルーティングと除外設定を確認してください。
ローカルの変更は、継続して保存できる方法で管理してください。サブスクリプションの更新で手動編集が上書きされることがあります。長期的に使うカスタムルールは、クライアントが対応するオーバーライドまたはマージ機能に設定し、更新後にルールの順序とプロキシグループ名を再確認してください。画面や手順はクライアントによって異なるため、プラットフォームごとのドキュメントを参照してください。
OPEN SOURCE / RESPONSIBILITY
画面、コア、設定元の役割を把握すると、機能の対応状況や問題の原因を正しく判断できます。
Clashのエコシステムには、コア、デスクトップ用の画面、モバイルクライアント、設定ツールがあります。Clash Metaは過去の情報を検索する際によく使われる名称で、mihomoは関連するコアの開発を引き継いでいます。古いガイドでは両方の名称が使われていることがあります。実際の設定は使用中のコアのドキュメントを確認してください。アプリ名だけで、対応するプロトコルや設定項目を判断することはできません。
ClashXはmacOS向けクライアントを指す名称として使われており、すべてのプラットフォームで同じアプリが使われるわけではありません。当サイトでは、各プラットフォームのインストーラーと日本語ガイドを整理し、メンテナンス中のクライアントとアーカイブ済みのプロジェクトを区別できるようにしています。プロジェクトごとにリリースの時期は異なります。画面が似ていても、コアの動作が同じとは限りません。
mihomoの公開リポジトリでは、ソースコード、ライセンス、課題の議論、リリース情報を確認できます。オープンソースであることの利点は、実装を確認でき、設定や環境を明確にして問題を再現できることです。GPL-3.0はここで紹介するmihomoコアのライセンスであり、すべてのサードパーティ製クライアントやストアアプリが同じライセンスを採用しているという意味ではありません。配布や改変の際は、それぞれのプロジェクトの説明を確認してください。
問題を報告する前に、OS、クライアント名、コアの情報、問題が起きるまでの手順を記録してください。ログは再現に必要な範囲だけを残し、サブスクリプションURL、アカウント情報、ノードのパスワードなどの認証情報は隠してください。「特定のサイトが開けない」という症状を、名前解決の失敗、接続失敗、ルール選択の誤りに分けると、原因を特定しやすくなります。
クライアントは通常、設定の読み込み、サブスクリプションの更新、トレイメニュー、システムプロキシ、権限を必要とするサービスを担当します。コアは設定の解析、ルールの適用、プロキシ接続の確立、ネットワークリクエストの処理を担います。そのため、画面のスイッチが反映されない場合、システムの許可設定や設定のオーバーライドが原因のこともあります。ノード一覧だけを確認しても解決しない場合があります。
クライアントを移行する際は、まず設定をエクスポートし、カスタマイズした項目を記録してください。完全なYAML、単一のノードURL、プロキシプロバイダーはそれぞれ異なる形式です。いずれかを読み込めても、ほかの形式をそのまま使えるとは限りません。プロトコル、TUNのネットワークスタック、ルールの動作についても、使用するコアで確認してください。
アプリのインストーラー更新、コアの更新、サブスクリプションの再取得、ルールセットのダウンロードは、別々の操作です。サブスクリプションを更新できても、取得した内容が新しいことしか確認できません。アプリが古い設定を使い続けたり、プロキシグループに以前の選択が残ったりする場合があります。更新後は更新日時だけでなく、現在有効な項目を確認してください。
互換性の問題が起きたら、まずバックアップを取り、更新前後の設定を比較してください。クライアント、ノード、DNS、ルールを一度に変更すると、何が問題を解決したのか判断しにくくなります。長時間稼働させる環境では、復元できる設定のコピーを保管し、重要な変更をローカルに記録しておくことをおすすめします。
NOTES / FIELD GUIDES
ポート、サブスクリプション形式、Linuxへの導入など、問題に合わせて手順を確認できます。
Clashの起動時にポート使用中のエラーが出た場合は、netstatやlsofなどで使用中のプロセスを特定し、mixed-portとexternal-controllerのポートを変更します。システムプロキシの設定もあわせて更新してください。
記事を読む →代表的なサブスクリプション形式の違いを整理し、ClashでYAML設定が必要な理由を解説します。Base64形式のノードリンクを、直接読み込める完全な設定に変換する方法と注意点も紹介します。
記事を読む →LinuxでClashを使う2つの方法を紹介します。GUI付きのデスクトップクライアントをインストールする方法と、サーバーやデスクトップ環境のない端末にmihomoバイナリを導入し、systemdサービスを設定してWebパネルに接続する方法です。
記事を読む →