OSSエコシステム資料 · 全プラットフォーム活用ガイド

Clashリソースハブ
全プラットフォーム対応クライアントと設定ガイド

Clashをダウンロード ガイドを見る

クライアントの選択からルールの適用まで、全プラットフォームのダウンロード先、日本語設定ガイド、ルール分流の方法をまとめています。まず使える接続を確立し、プロキシモード、プロキシグループ、設定ファイルを段階的に理解しましょう。

永久無料 オープンソース 日本語ドキュメント ルール駆動
プラットフォームを選択
Windows Android iOS macOS Linux
代表的な接続先
米国 日本 香港 シンガポール 韓国
PLATFORMS / WINDOWS · MACOS · ANDROID · IOS · LINUX CORE / MIHOMO · CLASH CONFIG / YAML · RULE PROVIDERS LICENSE / OPEN SOURCE
コア機能

まずトラフィックがどのように判定・転送されるかを理解する

Clashの要点はボタンを何度も切り替えることではなく、サブスクリプション、プロキシグループ、ルール、システムの取り込み方式を、説明可能な一連の処理として組み立てることです。以下では資料の概要を示し、後半の詳しい章で具体的な構造を解説します。

マッチング順序

ルールは上から順に判定

ドメイン、宛先IP、プロセス、地理情報は、それぞれマッチング条件になります。リクエストが最初の適用可能なルールに一致すると、対応するプロキシグループへ渡されます。そのため具体的なルールは対象範囲の広いルールより前に置き、最後にMATCHで未マッチのトラフィックを処理します。順序の関係を理解すれば、中国本土向けの直接接続、特定サービスのプロキシ経由、LANの迂回を明確で保守しやすい設定として記述できます。

rules:
  - DOMAIN-SUFFIX,example.com,Proxy
  - GEOIP,CN,DIRECT
  - MATCH,Proxy
ルールエンジン

具体的な条件から最後のフォールバックまで

ルールモードは設定内のルール一覧を読み込み、記述された順序で現在の接続を確認します。ドメインサフィックスを例にすると、DOMAIN-SUFFIXは特定サイトとサブドメインをまとめて対象にするのに適しています。単一ドメインを正確に一致させる場合はDOMAINを使用できます。宛先がすでにIPアドレスとして示されている場合は、IP-CIDRまたはGEOIPと組み合わせて判定します。ルール自体は接続を行わず、リクエストをDIRECT、REJECT、またはプロキシグループへ渡すだけです。

ルールを編成するときは、まずLANアドレス、専用サービス、明確なドメインを記述し、次に地理的範囲の広い判定を置き、最後にMATCHを残します。広すぎるルールを先に置くと、後続の詳細条件は適用されません。問題を調べる際はクライアントのログを開き、リクエストがどのルールとプロキシグループに一致したかを確認しましょう。Webページが開くかどうかだけで設定状態を推測するのは避けてください。

config.yaml / rules 順序マッチング 
rules:
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - DOMAIN-SUFFIX,example.cn,DIRECT
  - DOMAIN-SUFFIX,example.com,Proxy
  - GEOIP,CN,DIRECT
  - MATCH,Proxy

プロキシグループ名はproxy-groups内の名前と完全に一致させる必要があります。変更後はまず設定を検証し、その後クライアントを再読み込みしてください。

サブスクリプション更新

上流設定を保持し、ローカルオーバーライドを分離

サブスクリプションリンクは通常、サービス提供者が管理しており、プロキシノード、プロキシグループ、基本ルールが同時に含まれることがあります。更新の本質は上流の内容を再取得することなので、置き換えられるファイルに長期的なカスタム設定を直接書き込むのは適切ではありません。オーバーライドやマージに対応するクライアントなら、サブスクリプションとは別にローカル設定を保存できます。コマンドライン環境では、独立したファイルと自動化スクリプトで同じ階層化を実現できます。

更新前に、現在の設定が正常に読み込めることを確認し、使用中のプロキシグループを控えておきます。更新後は、設定の解析結果、プロキシグループ名、ルールプロバイダーの状態、DNS関連フィールドを順に確認してください。上流でグループ名が変更され、ローカルルールが古い名前を指していると、構文チェックには通っても期待どおりに分流できない場合があります。更新と切り替えを別の操作に分けると、問題を特定しやすくなります。

設定の構造

YAMLを確認しやすい階層に分ける

一般的なClash設定は、共通ポート、動作モード、DNS、プロキシノード、プロキシグループ、ルールで構成されます。設定を読むときは先頭から末尾まで通読する必要はありません。まずmode、mixed-port、DNSを確認し、次にproxiesがプロキシグループから参照されているか、最後にルールの対象が存在するかを確認します。引用関係に沿って確認するほうが、インデントの問題を一文字ずつ探すより効果的です。

YAMLはスペースによる階層に敏感なので、リスト項目、オブジェクトのフィールド、文字列の構造を明確に保つ必要があります。プロキシグループ名に特殊文字が含まれる場合は引用符を使い、ポートは数値で記述し、真偽値は設定が受け付ける形式にしてください。複雑な設定はrule-providersとproxy-providersに分割し、メインファイルには参照関係だけを残すと、ルールセット更新のたびに全設定を書き直さずに済みます。

設定ファイルリファレンスを見る →
クライアントをダウンロード

デバイスに合った入口を選ぶ

システムによってインストール方法、権限モデル、バックグラウンド制限は異なります。まずデバイスからダウンロードページを探し、各プラットフォームのタブでクライアントの違い、動作要件、パッケージ形式を確認してください。

Windows

グラフィカルインターフェース、システムプロキシの切り替え、設定管理を必要とするデスクトップユーザーに適しています。ダウンロード前にプロセッサーのアーキテクチャとパッケージ形式を確認し、初回起動後にサブスクリプションを読み込んでシステムプロキシを有効にしてください。

ダウンロードする

macOS

IntelとApple Siliconのデバイスに対応します。インストール時はシステムの指示に従ってアプリの権限を確認してください。TUNを使用する場合は、ネットワーク拡張機能や仮想ネットワークデバイスに関する許可も確認しましょう。

ダウンロードする

Android

Androidクライアントは、システムのVpnServiceを通じて接続を取り込みます。初回有効化時にシステムの許可ダイアログが表示されます。バックグラウンドで停止しやすい場合は、クライアントをバッテリー最適化の対象外にし、バックグラウンド実行を許可してください。

ダウンロードする

iOS

iPhoneとiPadでは、システムのネットワーク拡張機能を使ってプロキシツールを動作させます。ダウンロードページにはApp Storeへのリンクがあり、サブスクリプションの読み込み、ネットワーク権限の確認、オンデマンド接続などの基本手順も説明しています。

ダウンロードする

Linux

デスクトップ環境ではグラフィカルクライアントを、サーバーやルーター環境ではMihomoカーネルを直接実行する方法が適しています。導入前にアーキテクチャ、ファイル権限、サービス管理方式、TUN対応を確認してください。

ダウンロードする

全クライアントを見る →

クイックスタート

インストールから接続まで、3つの手順で完了

初めて使うときから複雑なルールを変更する必要はありません。まず有効な設定をクライアントに読み込ませ、システムへの取り込みを完了します。その後、実際のアクセス結果に応じてDNS、TUN、カスタム分流を調整してください。

  1. 01

    クライアントをインストールしてサブスクリプションを読み込む

    ダウンロードページで、OSとプロセッサーのアーキテクチャに合ったクライアントを選びます。インストール後にサブスクリプション管理を開き、サービス提供者から案内されたURLを貼り付けてダウンロードまたは更新を実行してください。設定の読み込みに成功すると、通常は選択可能なプロキシグループが表示されます。すぐに解析エラーが出る場合は、URLが完全か、ネットワークに接続できるか、設定内容がYAML構造に沿っているかを確認しましょう。

  2. 02

    ルールモードと利用可能なプロキシを選ぶ

    普段の利用ではルールモードを優先し、ドメインやIPの条件に応じて直接接続とプロキシ接続を振り分けます。プロキシまたはプロキシグループの画面で、主要なグループに利用可能な出口を選択してください。この段階で大量のルールを同時に変更するのは避けましょう。接続失敗の原因はノードだけでなく、システムプロキシ、DNS、権限にもあるため、変数を少なくすると切り分けが容易になります。

  3. 03

    システムプロキシを有効にして経路を確認する

    デスクトップではまずシステムプロキシを有効にし、モバイル端末では指示に従ってシステムのネットワーク接続権限を許可します。その後、種類の異なるWebサイトにアクセスして結果を確認してください。ブラウザーは使えるのにコマンドラインツールがプロキシを経由しない場合、そのプログラムがシステムプロキシを参照していない可能性があります。環境変数を手動設定するか、権限を確認したうえでTUNを使いましょう。確認後に自動起動と自動更新を設定します。

完全ガイドを見る →

OSSエコシステム

Clashカーネルから継続的に保守される実装まで

Clashは当初、YAML設定、プロキシグループ、ルール一覧を基盤とする利用方式を確立し、その後デスクトップ、モバイル、コマンドライン環境向けに複数のクライアントプロジェクトが形成されました。似た設定概念を共有していても、グラフィカルインターフェース、カーネルの選択、更新頻度、システム統合の方法は完全に同じではありません。クライアントを選ぶ際は、画面の見た目だけでなく対象プラットフォーム、保守状況、必要な機能も確認してください。

MihomoはClashカーネルのエコシステムを継承・拡張しています。一般的なグラフィカルクライアントでは、カーネルの機能をサブスクリプション管理、プロキシ切り替え、システムプロキシ、TUN、ログ、オーバーライド設定などの操作画面にまとめています。カーネルは設定の解析とトラフィック処理を担い、グラフィカルクライアントはシステム統合と操作を担います。問題が起きたら、設定解析、カーネル動作、クライアント権限、OSのネットワーク設定のどの層にあるかを先に判断すると、原因を早く絞り込めます。

オープンソースリポジトリでは、コミット履歴、リリースノート、課題の議論、設定ドキュメントを直接確認できます。資料を読む際はプロジェクト名と保守ブランチに注意してください。古いガイドではフィールドが変更されている場合があり、クライアントによってはカーネル実装が変わっていることもあります。このサイトでは安定した概念と操作手順をテーマ別に整理し、具体的なパッケージとプラットフォーム差異はダウンロードページに、詳しいフィールド説明は設定リファレンスにまとめています。

更新の仕組みも階層ごとに理解する必要があります。クライアント更新は画面とシステム互換性を改善し、カーネル更新はプロトコル、ルール、ネットワークスタックの機能を変え、サブスクリプション更新はノードやサービス提供者の設定を置き換えます。これら3種類の更新は独立しています。変更前に正常に読み込める設定を保存し、更新後に設定、プロキシグループ、システムへの取り込み状態を順に確認すると、複数の変更が同時に起きることによる切り分けの難しさを減らせます。

よくある質問

まず問題が発生した層を見極める

インストール、設定、システムへの取り込み、対象サイトの状態は互いに影響します。ノードを次々に変更したり、クライアントを何度も再インストールしたりするより、層ごとに確認するほうが原因を見つけやすくなります。

サブスクリプションを読み込んだ後、プロキシグループが表示されない場合は？

まずサブスクリプションの更新が成功したかを確認し、次にクライアントログで設定の解析結果を確認します。YAMLを読み込めない場合、プロキシグループは表示されません。設定が正常でもグループが空の場合は、プロキシプロバイダーの取得に成功しているかを確認してください。詳しい手順は、トラブルシューティングページの「インストールと設定」カテゴリで確認できます。

インストールと設定の問題を見る →

ルールモード、グローバルモード、直接接続はどう選ぶ？

ルールモードは設定を上から順に判定するため、日常利用に適しています。グローバルモードは接続を指定したプロキシグループへ一律に渡すため、一時的な出口テストに向いています。直接接続モードはプロキシを迂回し、障害がプロキシ経路に関係するかを確認する際に使えます。切り替え後は接続を再実行してください。既存の接続経路はすぐに変わらない場合があります。

基礎知識の問題を見る →

ブラウザーは使えるのに、他のプログラムがプロキシを経由しないのはなぜ？

一部のプログラムはシステムプロキシを参照せず、独自のネットワークスタックを使用します。まずプログラム自体がHTTP、HTTPS、SOCKSプロキシに対応しているかを確認してください。より多くのトラフィックを取り込む必要がある場合は、TUNモードの権限、ルーティング、DNS設定を確認します。原因が不明なまま複数のプロキシツールを同時に有効にしないでください。

トラブルシューティングを見る →

サブスクリプション更新後にカスタムルールが消えた場合は？

リモートサブスクリプションの更新で元の設定が置き換えられることがあるため、長期的に使うルールはクライアントのオーバーライド、マージ設定、または独立したルールプロバイダーに配置してください。復元前に現在の設定とバックアップを比較し、プロキシグループ名が残っていることを確認してから、ローカル変更を少しずつ追加します。古い参照による読み込み失敗を防げます。

活用のヒントを見る →
最近の記事

プラットフォーム設定とルール実践

具体的なデバイス、プロキシモード、分流シナリオから出発し、基本ガイドでは扱いきれない操作の細部を補足します。

ルール分流

Clashの中国本土・海外向けルール分流を実践：ドメインルール、GEOIP、フォールバック戦略

中国本土は直接接続、海外向け通信はプロキシ経由とする典型的な構成を例に、ルールの順序、プロキシグループの指定、MATCHによるフォールバックを理解します。

全文を読む
Android活用

AndroidでClashクライアントを安定稼働：VpnServiceの許可とバッテリー最適化の除外設定

システムのネットワーク権限、バックグラウンド制限、バッテリー最適化の関係を説明し、よくある接続中断の確認手順を紹介します。

全文を読む
入門ガイド

Clashのルール・グローバル・直接接続、3つのプロキシモードの選び方：用途別比較と切り替えの要点

日常のアクセス、一時的なトラブル切り分け、全トラフィックのテストを比較し、3つのモードにおける転送の違いを理解します。

全文を読む

全記事を見る →