Clash 設定ノート

Clash クライアントのダウンロードサブスクの追加と設定

OSに合ったクライアントを選び、まずサブスクを追加します。ルール設定と接続ログで通信経路を確認しましょう。

  • 日本語ドキュメント
  • YAML 設定例

CONFIG WORKBENCH

Clash の設定項目と操作

変更したいのが設定の読み込み元、通信経路、リモートリソースの更新間隔のどれかを確認しましょう。それぞれ設定場所は別です。右側の例は既存設定に追加する断片で、そのまま接続に使える完全なサブスクではありません。

設定の読み込み元とプロキシグループ

設定全体とプロキシプロバイダーを区別する

まず、サービス提供元が案内するURLの種類を確認します。Clash用の完全なサブスクは通常、クライアントの設定画面から読み込みます。取得した内容には、ノード、プロキシグループ、ルールがまとめて定義されている場合があります。一方、プロキシプロバイダーはノードのみを提供し、メイン設定の proxy-providers から参照します。完全な設定をプロバイダーとして扱うと、URLにアクセスできてもプロキシグループにノードが表示されないことがあります。形式を確認する場合は、まずサービス提供元の説明を参照してください。アクセス情報を含むURLをオンライン判定ツールに入力するのは避けましょう。

チュートリアルを見る
プロキシグループからプロバイダーを参照する

プロキシグループの use リストにはプロバイダー名を指定します。単一のノードとして proxies に記述しないでください。例では「手動選択」にDIRECTと自動選択グループを候補として登録し、リモートプロバイダーも参照しています。「自動選択」は同じプロバイダーのノードだけを使用します。読み込み後、グループ内に想定した候補が表示されるか数えてから接続をテストしましょう。グループ名を変更する場合は、参照箇所もすべて変更します。名前、空白、大文字・小文字は定義と一致させてください。

現在有効な設定を確認する

一覧にサブスク名が表示されても、クライアントに設定項目が追加されたことを示すだけで、コアに適用済みとは限りません。新しい項目に切り替えたら、プロキシ画面のグループ名が変わったか確認してください。切り替えに失敗した場合は、ログに構文エラーや未対応の項目がないか調べます。すぐにクライアントを再インストールする必要はありません。以前の設定を比較用に残しておけます。個人情報を含む記録を共有する際は、スクリーンショットからURLのクエリ、アカウント情報、不要な接続情報を隠してください。

config.yaml · プロキシグループ
proxy-groups:
  - name: 手動選択
    type: select
    proxies: [DIRECT, 自動選択]
    use: [remote]
  - name: 自動選択
    type: url-test
    use: [remote]
    url: https://example.com/
    interval: 300

OSに合ったClashクライアントを選ぶ

まずOSとプロセッサのアーキテクチャを確認し、設定のオーバーライド、接続ログ、システムへの適用方法を比較しましょう。ダウンロードページではプラットフォームごとにクライアントを紹介しています。別のフロントエンドに移行する場合も、サブスクの取得元は維持できますが、以前のクライアントに保存した設定まで引き継がれるとは限りません。

Windows

システムの「バージョン情報」でOSの種類を確認してください。初めて使う場合は、まずシステムプロキシをテストしてからTUNを有効にするか判断しましょう。サポートが終了したClash for Windowsを使い続けている場合は、現在の設定を残したうえで、保守が続いている代替クライアントを比較してください。

ダウンロードページへ

Android

デバイスに対応したアーキテクチャのパッケージを選び、初回接続時に表示されるシステムのVPN許可を確認してください。画面ロック後にだけ切断される場合は、バックグラウンド実行とバッテリー設定を確認します。特定のアプリだけプロキシを経由しない場合は、アプリごとの設定を調べましょう。

ダウンロードページへ

iOS

ダウンロードページからストアに進み、まずデバイスがストア記載のシステム要件を満たしているか確認します。読み込み後は、クライアントで設定が選択されていることと、システムがVPN接続を許可していることをそれぞれ確認してください。両方が正常なら、既知の宛先で通信経路をテストします。

ダウンロードページへ

macOS

「このMacについて」でAppleシリコン搭載機かIntelプロセッサ搭載機かを確認し、対応するインストーラーを選びます。システムプロキシの状態は、アクティブなネットワークサービスによって変わる場合があります。Wi-Fiやドッキングステーションの有線LANに切り替えた後は、クライアントが通信を制御しているか再確認してください。

ダウンロードページへ

Linux

デスクトップでは、ディストリビューションとパッケージ形式に合ったGUIクライアントを選びましょう。サーバーでは、ダウンロードページから単体のコアを確認できます。デスクトップのプロキシ設定とコマンドラインプログラムの環境設定は異なる場合があるため、実際に使うアプリで接続を確認してください。

ダウンロードページへ

すべてのクライアントを見る → · クライアントの機能を比較

Clash の初回接続:3つの手順

まず設定を一つ読み込み、アプリ一つで接続できることを確認してから、自動起動、自動選択、TUNを順に追加しましょう。トラブルが起きたときに、最後に正常だった状態へ戻しやすくなります。

  1. 01

    サブスクを追加する

    設定画面でリモート設定を追加し、サービス提供元から案内されたClashサブスクを貼り付けて保存します。ダウンロード後は設定を有効にしてください。プロキシ画面に設定で定義されたグループ名と候補ノードが表示されたら、次に進みます。サブスクがローカルファイルで提供されている場合は、ファイルの読み込みを選択してください。

  2. 02

    モードとノードを選ぶ

    ルールモードを選び、確認したいプロキシグループでノードを一つ手動選択します。まずは自動切り替えを無効にして、接続先を判別しやすくしましょう。デスクトップではシステムプロキシを有効にし、モバイルではクライアントの案内に従ってVPNを接続します。別のプロキシやVPNを使っている場合は、どのアプリが通信を制御しているか確認してください。

  3. 03

    接続ログを確認する

    プロキシ経由になるはずの宛先と、DIRECT接続になるはずの宛先をそれぞれ開きます。ログで一致したルールと実際の出力先を確認してください。接続記録自体がない場合は、ノードの遅延を疑う前に、システムへの適用方法を見直しましょう。

チュートリアルをすべて見る → · 症状からトラブルの原因を探す

Clash のオープンソースエコシステムと mihomo コア

プロジェクトの変遷:設定形式は継承、保守する系統は別々

初期のClashは、YAMLでプロキシ、プロキシグループ、ルールを一つの設定ファイルにまとめ、ノード管理と通信判定を分けて扱えるようにしました。その後、複数のGUIフロントエンドや派生コアが登場し、この構成を引き継いでいますが、保守状況や対応する設定項目はそれぞれ異なります。特にClash for Windowsはサポートが終了しているため、古いドキュメントのメニュー位置やインストール方法を現在のクライアントにそのまま当てはめるのは避けてください。移行時は最小限の設定で基本機能と接続を確認し、その後で個別設定を戻すのがおすすめです。

コミュニティによる保守:問題の発生箇所に応じて記録を確認する

オープンソースのリポジトリにあるソースコード、リリース履歴、課題の議論から、具体的な動作を確認できます。ウィンドウが開かない、トレイアイコンが動かない、起動時の自動実行に失敗するといった問題は、まず使用中のGUIフロントエンドを調べましょう。同じ最小設定で複数のフロントエンドに同じルールエラーが出る場合は、共通で使われているコアを確認します。コミュニティの報告を見る際は、プラットフォーム、システム環境、再現手順を照らし合わせてください。タイトルが同じでも原因が同じとは限りません。「インターネットに接続できない」という問題には、設定の適用、名前解決、ノード接続など複数の原因が考えられます。

コアの役割:画面で管理し、コアで処理する

mihomo は Clash Meta から派生し、GPL-3.0 ライセンスで公開されています。GUIクライアントは主に設定管理、状態表示、システム連携を担います。プロトコル接続、ルール判定、一部のDNS動作はコアが処理します。同じコアを使うクライアント同士でも、初期設定、システムプロキシの設定、オーバーライド方法が異なれば、動作に差が出ることがあります。一方、クライアントが設定項目を読み込めても、参照先のすべての項目をコアがサポートしているとは限りません。互換性の問題が起きたら、画面での読み込みに失敗したのか、コアでの設定読み込みに失敗したのかを切り分けましょう。

更新の仕組み:アプリ、コア、設定を分けて管理する

アプリの更新では画面やシステム権限が変わり、コアの更新では対応項目や動作が変わることがあります。サブスクの更新は主にリモート設定の内容に影響します。3種類の更新は分けて確認しましょう。変更前に有効なポリシーと必要なオーバーライドを記録し、変更後は同じテスト先でログを比較します。クライアントとサブスクを同時に切り替えると、問題が起きたときにアプリと設定のどちらが原因か判断しにくくなります。元に戻せるローカル設定を保管し、アクセス情報を含むコピーは安全な場所に保存してください。

Clash の設定とトラブル対処ノート

症状に合わせて記事を選べます。初回接続では通信経路を確認し、設定を変更するときは項目別の解説を参照してください。接続はできるものの速度が不安定な場合は、原因を段階ごとに切り分けます。

すべての記事を見る →

Clash 最新版をダウンロード