FlClash導入と設定

プロジェクトの由来とクライアントの発展

FlClashはFlutterとClash Metaをベースにしたオープンソースクライアントです。ソースコードリポジトリでは、UI、プラットフォーム連携、ビルド関連の内容を公開しています。Clashエコシステムには、さまざまな開発者が保守するGUIクライアントやコアの派生版があります。Clash設定に対応していても、配布経路、保守状況、機能へのアクセス方法がすべて同じとは限りません。旧クライアントから移行する際は、サブスクリプションURLと独自ルールをバックアップし、新しいクライアントの対応状況を項目ごとに確認してから移行してください。既存のフォルダーをそのまま上書きするのは避けましょう。

プロジェクトを調べるときは、まずREADMEの対応プラットフォームと使い方を確認し、次にリリースノートから自分のOSに関係する変更を確認しましょう。問題を報告する際は、再現条件、OS、関連設定、個人情報を伏せたログを添えると役立ちます。「接続できない」という説明だけでは、権限、設定形式、ノード、ルーティングのどこに原因があるか判断しにくくなります。公開する前に、サブスクリプションURLの認証情報、ノードのパスワード、個人を特定できるアカウント情報を削除してください。

Clash Metaとmihomoの関係

Clash Metaコアの後継プロジェクトは、通常mihomoという名称で公開されています。ドキュメント、設定項目、ログには両方の名前が登場することがあります。FlClashはそのコアにGUIを提供しますが、プロトコルの互換性、ルール照合、DNSの動作は、実際に組み込まれたコアに大きく左右されます。YAMLを読み込めたとしても、ファイルが解析できたことを示すだけです。接続できるかどうかを判断するには、プロトコルのパラメーター、プロキシグループの参照先、現在のネットワーク環境も確認してください。

問題の切り分けは、「リクエストがコアに届いているか」「想定したルールに一致しているか」「利用可能な接続先が選ばれているか」の順で進めます。ログに対象のリクエストがない場合は、システムプロキシ、アプリ独自のプロキシ設定、TUNによる通信の取り込みを確認してください。リクエストが記録され、接続先も正しい場合は、名前解決、ハンドシェイク、リモート接続を調べます。この切り分け方は、同系統のコアを使うほかのクライアントにも応用できます。

GPL-3.0とソースコードの確認

FlClashプロジェクトはGPL-3.0ライセンスを採用しています。一般ユーザーはソースコードやリリースノートからソフトウェアの動作を確認できます。プロジェクトの変更、再配布、組み込みを行う場合は、リポジトリ内のライセンスと依存関係のライセンスを読み、適用される条件に従って表示の保持などの義務を果たしてください。オープンソースライセンスが定めるのはコードの利用条件であり、サブスクリプションサービス、リモートサーバー、ネットワーク環境まで同じプロジェクトが管理するという意味ではありません。

アプリの更新とサブスクリプションの更新は別々に管理

アプリの更新では、UI、システム連携、同梱コアなどが変更されます。一方、サブスクリプションの更新では、設定の提供元からノード、ルール、プロキシグループを再取得します。解決できる問題はそれぞれ異なります。ノードの停止はクライアントの再インストールで直るとは限らず、アプリの権限に関する問題もサブスクリプションの更新では解決しない場合があります。更新前に設定名、通信モード、通信の取り込み方法を記録し、重要なローカル変更は別途バックアップしてください。更新後は同じ宛先と接続先で再テストします。

サブスクリプションURLにはアカウントの認証情報が含まれていることが多いため、パスワードと同様に扱ってください。URL全体を公開スクリーンショット、オンラインYAMLチェックツール、問題報告に貼り付けないでください。設定の構造を共有する場合は、項目名を残しつつ、ドメイン、パスワード、トークンを明確なサンプル値に置き換えます。このサイトの設定例は項目間の関係を説明するもので、そのまま使えるプロキシサービスではありません。

初回利用時の確認手順

まず設定画面で設定を読み込み、有効にします。次にプロキシ画面でプロキシグループの接続先を選べることを確認し、最後にダッシュボードで必要な通信の取り込み方法を有効にしてください。通常の振り分けにはルールモード、一時的な比較にはグローバルモードが適しています。ただし、どちらもコアに取り込まれた接続だけに適用されます。新しいリクエストでテストし、接続画面やログで結果を確認しましょう。スイッチがオンになっているだけでは、実際の通信経路は分かりません。

サブスクリプションを更新できても目的のサイトに接続できない場合は、別の接続先と別の宛先をそれぞれ試してください。すべての接続先で失敗する場合は、端末のネットワーク、システム時刻、DNSを確認します。TUNを有効にしてから問題が起きた場合は、まずTUNを無効にして通常のプロキシで比較し、その後ルーティング、権限、ほかのVPNを個別に確認してください。詳しくはサブスクリプションの追加ガイドをご覧ください。ルールセットやDNSを調整する場合は、高度な設定マニュアルも参照してください。