FlClash よくある質問とトラブルシューティング

FlClash は Flutter で構築されたマルチプラットフォーム対応の GUI クライアントで、サブスクリプション管理、設定編集、プロキシ切り替え、システムプロキシ制御を担います。実際のプロトコル接続、ルールマッチング、DNS 処理、TUN 転送は mihomo カーネルが行います。問題を切り分ける際は、画面の設定とカーネルの稼働状態を分けて確認してください。画面が正常に開いても、カーネルが正常に起動しているとは限りません。

FlClash は Windows、macOS、Android、Linux で利用できます。対応するインストーラーとアーキテクチャはダウンロードセンターの掲載内容を確認してください。Windows は通常のデスクトップ版、macOS は Intel と Apple Silicon、Android は端末のアーキテクチャに合うパッケージを選びます。Linux はディストリビューションとデスクトップ環境に応じて形式と権限を確認してください。

ルールモードでは、設定内の rules を上から順に使ってドメイン、IP、プロセス、ルールセットを判定し、通信を対応するプロキシグループへ振り分けます。日常利用に適したモードです。グローバルモードでは、処理可能な通信の大部分を同じプロキシへ送るため、ノードの一時的なテストに便利です。直接接続モードはプロキシを経由せず、問題がローカルネットワークにあるのかプロキシ経路にあるのかを切り分ける際に使えます。テスト後は通常、ルールモードへ戻してください。

サブスクリプション URL はサービス提供者が公開するリモート設定の入口です。設定はクライアントが取得・解析した完全な YAML の内容、ノードは設定内の具体的なプロキシ出力先を指します。プロキシグループは複数のノードや他のプロキシグループをまとめ、手動選択、自動テスト、フォールバックに利用する集合です。サブスクリプションを読み込んだ後は、設定を選択し、プロキシグループで実際に使うノードを指定してください。

設定またはサブスクリプション画面を開き、「URL から追加」を選択します。完全なサブスクリプション URL を貼り付けて保存し、更新を一度実行してください。取得に成功したら追加した設定を選び、カーネルの読み込み完了を待ってから、プロキシまたはプロキシグループ画面でノードを選択します。ブラウザーで URL を開いた際にログイン画面、エラーページ、空の内容が返る場合は、繰り返し読み込むのではなく、まずサービス提供者に URL の状態を確認してください。

まず FlClash のカーネルが稼働していることを確認し、次にシステムプロキシの設定が Windows に正しく反映されているか確認します。一部のブラウザー、ダウンローダー、開発ツールは独自のプロキシ設定を使用するため、システムプロキシを無視することがあります。ブラウザー拡張機能がプロキシ設定を上書きしていないかも確認してください。アプリ内の手動プロキシを一度無効にし、対象プログラムを再起動してから、確認サイトで出口 IP を比較します。変化がない場合は TUN モードで切り分けます。

TUN は仮想ネットワークインターフェースを作成し、ルーティングを変更するため、デスクトップ OS では通常、管理者権限が必要です。Windows ではクライアントを終了してから管理者として再起動します。macOS ではネットワーク拡張を許可するか、システムの指示に従って認証してください。Linux ではカーネルが TUN に対応していること、現在のユーザーに必要なネットワーク権限があること、デバイスノードが利用可能であることを確認します。認証後はカーネルを再起動し、スイッチを繰り返し切り替えるだけにしないでください。

一部の UWP アプリはアプリコンテナーによるネットワーク分離の影響を受け、システムプロキシを有効にしてもローカルの待受アドレスへ接続できないことがあります。FlClash のツールまたはシステム設定から UWP ループバック関連の項目を探し、通信が必要なストアアプリのループバック制限を解除してください。変更後は対象アプリを完全に終了し、再度起動します。特定のアプリだけ失敗する場合は、独自 DNS やプライベートネットワーク制限が有効になっていないかも確認してください。

サブスクリプションまたは設定の詳細画面で自動更新を有効にし、サービス提供者の更新頻度に合わせて適切な間隔を設定します。頻繁に更新してもノードが速くなるわけではなく、API のレート制限にかかる可能性があります。更新にプロキシが必要なサブスクリプションでは、更新タスクに利用可能なプロキシグループを指定できます。現在の設定が無効な場合は、通信できる設定へ切り替えるか一時的に直接接続し、手動更新を実行して返されたエラーを確認してください。

クライアントの遅延テストは通常、指定したテスト先への接続時間を測定するもので、その時点の到達性と応答速度しか示しません。実際のダウンロード帯域とは異なります。連続してタイムアウトする場合は、ノード、テスト先、ローカルネットワークの少なくとも一つが利用できない可能性があります。断続的な高遅延はネットワークの揺らぎによることがあります。Web ページの読み込み、実際の転送速度、複数回のテスト結果を組み合わせて判断し、一度の遅延値だけでノードを選ばないでください。

まず設定内の dns.enable が有効であることを確認し、nameserver、fallback、nameserver-policy に信頼でき、到達可能な DNS サービスが指定されているか確認します。TUN 使用時は、DNS ハイジャック設定がシステムからのリクエストを適切に処理しているかも確認してください。名前解決に失敗する場合は、ブラウザーのセキュア DNS を一時的に無効にし、システムの DNS キャッシュを消去して再試行します。複数のローカル DNS ツールを同時に使用すると、リクエストの迂回やポート競合が起きるため避けてください。

接続ログを開き、その Web サイトに対応するドメイン、対象 IP、マッチしたルール、最終的なプロキシを確認します。Clash のルールは上から順に評価されるため、範囲の広いルールを先に置くと、後続の詳細なルールが適用されないことがあります。ドメインが IP に解決された後、IP ルールにマッチしていないか、ルールセットが正常にダウンロードされているかも確認してください。オーバーライドを調整する際は、まず限定的なルールを追加して検証し、ルール全体の順序を一度に変更しないようにします。

まずサブスクリプション URL をブラウザーなど確認しやすい環境にコピーし、設定内容が返されることを確認します。よくある原因は、URL の期限切れ、サブスクリプションのリセット、特定ネットワークを要求する API、DNS の名前解決失敗、無効なプロキシを経由した更新リクエスト、返却内容がログイン画面に変わっていることです。URL が有効だと確認できたら、FlClash で URL の前後にある空白を削除し、更新用プロキシを変更するか一時的に直接接続して、手動更新とログ確認を行います。

まず直接接続モードに切り替え、ローカルネットワークと DNS が正常であることを確認します。次にシステム時刻、サブスクリプションの有効期限、カーネルログを確認してください。すべてのノードが同時にタイムアウトする場合は、ノードを一つずつ削除するのではなく、ローカルネットワークの制限、DNS、カーネルの停止、テスト先への到達性、サブスクリプション全体の失効を優先して疑います。テスト先を変更し、他のプロキシツールを終了して、ポート競合やプロキシ経路の多重化も切り分けてください。

接続成功は、ノードとのハンドシェイクが完了した可能性を示すだけです。DNS、ルール、対象サイトまでの経路も確認する必要があります。まず同じノードをグローバルモードでテストし、その後別のノードと比較してください。IP アドレスにはアクセスできるのにドメイン名では失敗する場合は、DNS を重点的に確認します。特定の Web サイトだけ失敗する場合は、接続ログでマッチしたルールとプロキシを確認してください。システムプロキシモードでは対象アプリがシステム設定に従っているか、TUN モードではルーティングと仮想ネットワークアダプターの状態を確認します。

まず起動ログにある最初の明確なエラーを確認します。ポート競合の場合は、他の Clash クライアント、プロキシツール、同じ mixed-port を使用するプログラムを終了し、必要に応じて設定のポートを変更してください。設定の解析に失敗する場合は、YAML のインデント、コロン後の空白、重複フィールド、未対応フィールドを重点的に確認します。変更後は設定を検証してからカーネルを再起動し、TUN を有効にしている場合は権限と仮想ネットワークアダプターの状態も確認してください。