FAQ / 使い方とトラブル対処

Clashのよくある質問

サブスクリプションの追加から、プロキシによる通信の取り込み、ノードのタイムアウトまで。問題がどの段階で起きているかを見極め、関連する設定とログを確認しましょう。

BASICS

基礎知識

クライアント、コア、ローカルポート、リモートノードの違いを確認します。

設定項目を確認する
Clashクライアントとmihomoコアの違いは?

クライアントは画面とシステム連携を提供し、コアは設定の読み込み、ルール判定、接続の確立を担います。インストーラーは通常クライアントのプロジェクトから配布されますが、対応する設定項目は実際に動作するコアとそのバージョンによって異なります。「不明な項目」と表示された場合は、クライアントのバージョン情報画面や起動ログでコアを確認し、該当バージョンのドキュメントを参照してください。画面だけ更新してもコアが更新されるとは限りません。同じ設定を使っていても、コアのバージョンが異なると2台の端末で動作に差が出ることがあります。

ルール・全般・DIRECTの各モードはどう選ぶ?

普段はルールモードがおすすめです。コアは設定の順に通信を照合し、最初に一致したルールに指定されたポリシーへ振り分けます。全般モードは一時的な切り分けに使えます。全般ポリシーで正常に使える出口を選び、同じリクエストを再試行してください。DIRECTモードでは、コアに入った通信を直接外部へ送りますが、システムプロキシやTUNが無効になるわけではありません。アプリがコアを経由せず通信できるか確認するには、該当する通信の取り込み設定だけを無効にして、新しい接続で試してください。

mixed-portはリモートノードのポート?

いいえ。mixed-portはコアがローカルで待ち受ける混合ポートで、HTTPとSOCKSのプロキシ接続を受け付けます。ノード設定のportは、リモートサーバー側のポートです。ローカルアプリに手動で設定する場合は、通常127.0.0.1を指定し、ポート番号は現在の設定またはクライアントに表示されている待ち受けポートを確認してください。すべての設定が7890とは限りません。ローカルだけで使う場合はLANからのアクセスを無効にし、同じネットワーク上の他の端末にプロキシの入口を公開しないようにしてください。

サブスクリプションURL・YAMLファイル・ノードURLは相互に置き換えられる?

それぞれ用途が異なります。サブスクリプションURLはリモートの設定を取得するためのもので、クライアントから必要に応じて更新できます。ローカルのYAMLファイルは独立したファイルで、通常は元のサブスクリプションと同期されません。単一ノードのURLには一般に1つの出方向接続しか記述されず、ローカルポートやポリシーグループ、ルール一式は含まれません。ノードURLしかない場合は、クライアントが単一ノードのインポートに対応しているか確認してください。完全な設定専用の入力欄に貼り付けないでください。サブスクリプションURLにはアクセス認証情報が含まれることがあるため、公開スクリーンショットや問い合わせに載せないようにしてください。

SETUP

インストールと設定

インストーラーを選び、設定が読み込まれたことを確認してから通信を取り込みます。

インポート手順を確認する
クライアントのインストール前に確認するシステム要件は?

OSのバージョン、プロセッサのアーキテクチャ、パッケージ形式を確認してください。デスクトップOSではシステム情報からx64かARM64かを確認できます。Macでは「このMacについて」を開き、IntelプロセッサかAppleシリコンかを確認してください。Linuxではディストリビューションに対応したパッケージ形式も確認しましょう。拡張子以外のファイル名が似ているだけでは、互換性を判断できません。更新前に、インストーラーが該当クライアントの公式配布元から提供されたものか確認してください。システムから非対応と表示されたり起動を拒否されたりした場合は、最低要件のOSバージョンとアーキテクチャを確認し、システム全体のセキュリティ設定を無効にしないでください。

サブスクリプションを追加した後、設定が有効か確認するには?

インポートできても、有効になったとは限りません。クライアントの設定画面で「URLからインポート」などの項目を選び、保存して取得が完了するまで待ってから、その設定を明示的に選択してください。プロキシ画面に切り替え、新しい設定のポリシーグループが表示されているか確認し、ログに解析や起動のエラーがないかも確認します。設定一覧にファイルがあるのにプロキシ画面に古いグループが表示される場合は、現在有効な設定を確認してから、新しいファイルの読み込みに失敗していないか調べてください。最後にアクセス可能なサイトを開き、接続画面またはログでリクエストが実際にコアへ届いているか確認します。

TUNを有効にできず、権限不足と表示される場合は?

まず、クライアントが現在のOSでTUNに対応しているか確認し、必要な認証方法を調べてください。デスクトップクライアントでは、プロキシサービスのインストールと起動が必要な場合や、初回有効化時に管理者権限を求められる場合があります。Linuxではデバイスへのアクセス権やネットワーク管理権限が必要なこともあるため、ディストリビューションとクライアントの案内に従って許可してください。システムのVPN機能を使うモバイルクライアントでは、通常、OSのダイアログで接続リクエストを承認します。許可しても失敗する場合は、サービスの状態と最初に記録された起動エラーを確認し、別のVPNや仮想ネットワークアダプターがルートを制御していないか調べてください。

クライアントの更新前にローカル設定やオーバーライドを保存するには?

クライアントのバージョンを変更する前に、設定とオーバーライドをバックアップしてください。クライアントのエクスポート機能でローカルのYAMLファイル、オーバーライドファイル、残しておきたい設定を保存します。エクスポート機能がない場合は、クライアントのドキュメントで設定フォルダーを確認してください。バックアップは自分だけがアクセスできる場所に保存し、リモートのサブスクリプションURLも認証情報として扱いましょう。更新後は元の設定を選択し、ポリシーグループとルールが想定どおりか確認してから通信の取り込みを有効にしてください。更新後に解析エラーが出た場合は、エラーの内容を保存し、新旧のコアで該当項目がサポートされているか比較してください。

USAGE

使い方のヒント

リクエストがどこからコアに入り、どのルールに一致し、どのDNSで名前解決されるかを確認します。

ルール構文を確認する
システムプロキシとTUN、どちらを先に有効にする?

システムプロキシに対応したブラウザーやアプリだけをプロキシ経由にしたい場合は、まずシステムプロキシを使ってください。対応ソフトにローカルのプロキシアドレスを知らせる設定であり、すべてのプログラムの通信がコアに入るわけではありません。アプリがシステムプロキシを参照しない場合は、アプリ独自のプロキシ設定を使うか、クライアントが対応していればTUNを検討してください。TUNはルーティング層で設定範囲内の通信を取り込むため、LAN、社内VPN、DNSに影響することがあります。最初の切り分けでは入口を1つだけ有効にし、同じリクエストがログに記録されることを確認してから、取り込み範囲を調整してください。

UWPアプリだけループバックの例外設定が必要なのはなぜ?

Windowsのアプリコンテナーで動作する一部のアプリは、既定でループバックが制限され、127.0.0.1上のプロキシに接続できないことがあります。同じポートを使って通常のデスクトップブラウザーでは接続できるのに、特定のコンテナーアプリだけ接続できない場合が典型例です。クライアントに「UWPループバック」の管理機能がある場合は、OSの許可手順に従い、問題が発生していてローカルプロキシが必要なアプリだけに例外を設定してください。対象アプリをいったん終了して再起動し、動作を確認します。リスト全体をまとめて許可しないでください。それでも接続できない場合は、アプリがシステムプロキシを使用するか確認してください。

設定にルールを書いたのに、なぜ適用されない?

まずルールモードになっているか確認し、接続に実際に適用されたルールを確認してください。コアはルールを上から順に判定します。範囲の広いルールが先にあると、後続の具体的なルールが適用されないことがあります。通常、MATCHは最後のフォールバックとして配置します。ログに記録された宛先と設定内のドメインが一致するか確認し、ポリシーグループ名も完全に一致しているか調べてください。ログに宛先IPしか表示されない場合は、現在の通信取り込み方式でドメイン情報をコアに渡せるか確認します。一度に変更するのは1項目だけにし、設定を保存して再読み込みした後、新しい接続で確認してください。ブラウザーの既存接続は使わないでください。

設定でDNSを有効にすると、すべてのアプリがそのDNSを使う?

必ずしもそうではありません。コアのDNSを有効にすると関連機能が利用可能になりますが、システム上のすべての問い合わせがコアに送られるわけではありません。まずテストするアプリの名前解決経路を確認してください。システムのリゾルバー、ブラウザー独自の暗号化DNS、TUN経由でクライアントが取り込む問い合わせなどが考えられます。テスト時はクライアントのモードとブラウザーの設定を記録し、一度に1か所だけ変更して、新しい問い合わせで再試行し、ログを確認してください。1回の名前解決テストや返されたIPアドレスだけで、システムDNSが使われているかどうかを判断しないでください。ブラウザーのキャッシュやドメインごとの名前解決ポリシーも結果に影響します。

DIAGNOSIS

トラブル対処

最初のエラーを確認し、サブスクリプション、ローカルの接続口、リモート接続のどこに問題があるかを切り分けます。

システムプロキシの設定を確認する
サブスクリプションの更新失敗が、URLの無効化かネットワークの問題かを見分けるには?

更新ログを確認し、リクエストがどの段階で失敗したかを調べてください。401または403が返された場合は、アカウントの状態、URLのアクセス権、配布元でURLが変更されていないか確認します。404の場合は、古いURLを使い続けていないか確認してください。ドメインを解決できない、接続がタイムアウトする、証明書エラーが出るといったログの場合は、サブスクリプションの期限切れと決めつけず、現在のネットワーク、システム時刻、クライアントの更新経路を調べます。コンテンツを取得できたのにYAMLの解析エラーが出る場合は、返された内容がログインページやエラーページではないか確認してください。新しいサブスクリプションの読み込みが成功するまでは、現在使える設定を残しておきましょう。

Clashのノードがすべてタイムアウトする場合と、一部だけの場合の対処法は?

すべてタイムアウトする場合は共通の要因を、一部だけの場合は該当ノードを調べます。まず端末自体がインターネットに接続できること、有効な設定が読み込まれていること、速度テストの接続先が現在のネットワークで利用可能なことを確認してください。ノード経由でWebページを開けるなら、速度テストがタイムアウトしただけでノードが使えないとは限りません。速度テストも実際のリクエストも失敗する場合は、最初の接続エラーを確認し、ドメインの名前解決失敗、リモート接続のタイムアウト、ハンドシェイクの失敗を切り分けます。一部のノードだけに問題がある場合は、同じ端末と接続先で正常なノードと比較し、設定を更新するか提供元に問い合わせるか判断してください。

システムプロキシを有効にしたのに、アプリの通信がプロキシ経由にならないのはなぜ?

接続画面またはログで、リクエストがコアに届いていないのか、届いた後にルールでDIRECTと判定されたのかを切り分けてください。記録がない場合は、システムプロキシのアドレスとポートがコアの待ち受け設定と一致しているか確認し、アプリ独自のプロキシ設定やシステムの除外リスト、他のソフトによる設定の上書きも調べます。記録がありDIRECTと表示される場合は、システムプロキシを何度も切り替えるのではなく、モードとルールを確認してください。設定変更後はテストするアプリを再起動するか、新しい接続を開始し、既存の接続による見かけ上の変化のなさを避けてください。

起動時にポートが使用中と表示された場合の対処法は?

まず起動ログで、競合しているのがmixed-port、コントロールポート、その他の待ち受けポートのどれか確認します。次にOSのネットワーク監視ツールで、そのポートを使用しているプロセスを調べてください。よくある原因は、古いクライアントがバックグラウンドで動作していることや、複数のクライアントが同じポートを使っていることです。用途がわからないプロセスを強制終了しないでください。古いインスタンスだと確認できた場合は終了するか、現在のクライアントに未使用のポートを設定します。mixed-portを変更した後は、システムプロキシとプロキシを手動設定したアプリも更新し、コアを再起動して正常に待ち受けていることを確認してください。

Clashをダウンロード