Windows
普段使いのデスクトップ用には、Clash PlusやClash Verge Revを候補にできます。インストール前に「設定 → システム → システム情報」でシステムの種類を確認し、ダウンロードページの要件と照らし合わせてください。初回起動後はサブスクリプションを追加し、システムプロキシを有効にします。一部のアプリがシステムプロキシに従わない場合に限り、TUNモードを検討しましょう。最初から権限、ルート、DNSを同時に変更するのは避けてください。
端末に合ったClashクライアントを選び、サブスクリプションの追加から始めましょう。次にルールによる振り分けとTUNモードを設定します。基本の接続方法と応用設定は分けて確認できます。
無料で利用可能オープンソース日本語ドキュメント
プラットフォームを選び、クライアントを選択
Clashのダウンロード先とインストール方法
デスクトップでは、現在もメンテナンスされているGUIクライアントがおすすめです。モバイルでは、OSの権限とサブスクリプションの形式を先に確認しましょう。ダウンロードページでは、各プラットフォームのクライアント、対応アーキテクチャ、インストール要件を紹介しています。ここでは選択肢を案内し、異なるOSのインストーラーを混在させないようにしています。
macOS
まず「このMacについて」でチップを確認してください。AppleシリコンとIntelプロセッサではインストーラーが異なります。インストール後は、システムの案内に従ってネットワーク関連の機能を許可します。クライアントを切り替えるときは、以前のアプリを終了し、システムプロキシをオフにしてから新しいアプリを起動してください。複数のクライアントが同時にプロキシ設定を変更すると、ブラウザーは使えても他のアプリが接続できないことがあります。
Android
最近の端末の多くはARM64ですが、古い端末ではプロセッサのアーキテクチャを確認してください。Clash Plus、Clash Meta for Android、FlClashでは設定画面が異なりますが、まずサブスクリプションを追加する点は共通です。接続時にはシステムのVPN接続要求を許可します。画面ロック後に切断される場合は、バッテリー最適化やバックグラウンド動作の制限を確認しましょう。バックグラウンド関連の問題をすべてサブスクリプションの失効と決めつけないでください。
iOS
ダウンロードページにはClash PlusのApp Storeへのリンクと公式サイト clashplus.ioを掲載しています。インストール後、既存のサブスクリプションを追加し、初回接続時にシステムの案内に従ってVPN構成の追加を許可してください。ステータスバーにVPNアイコンが表示されても、ネットワーク拡張機能が動作していることを示すだけです。ポリシーの選択と実際のWebアクセスも確認しましょう。他のVPNアプリが接続に影響する場合もあります。
Linux
デスクトップ環境ではClash Verge RevまたはFlClashを選び、ディストリビューションに合ったパッケージを使用できます。サーバーやルーターで使う場合は、ダウンロードページのmihomoコアを確認してください。GUIクライアントとコマンドラインのコアではインストール方法が異なります。また、デスクトップのプロキシ環境変数、ブラウザーのプロキシ、TUNのルーティングはそれぞれ別に機能します。インストール後、アプリが実際にどの経路で通信しているか確認してください。
すべてのクライアントを見る →
クライアントはあるのにインターネットへ接続できませんか？何度も再インストールする前に、クライアント名、動作モード、ログのエラーを記録してヘルプセンターを確認してください。
ルール・DNS・接続の設定
必要な設定項目を選んで確認できます。以下のYAMLは機能ごとのスニペットであり、単独で動作する完全な設定ではありません。記載されているPROXYというポリシー名は、実際の設定内で定義する必要があります。メニュー名はクライアントによって異なるため、最終的には有効な設定とコアのログを確認してください。
ルールによる振り分け：上から順に照合
ルールモードでは上から順に照合し、最初に一致したルールのポリシーが適用されます。ドメインルールは特定のWebサイトに、IPルールは明確なネットワーク範囲に適しています。MATCHは最後に置き、どのルールにも一致しない通信の受け皿にします。特定のサイトを直接接続したい場合は、接続履歴で実際のドメインと適用されたルールを確認し、より具体的なルールを汎用ルールより前に配置してください。グローバルモードと異なり、接続ごとに異なるポリシーを適用できます。継続して使う変更はローカルオーバーライドに保存し、サブスクリプション更新で失われないようにしましょう。
mode: rule
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXYTUNモード：システムの通信を取り込む
TUNは仮想ネットワークインターフェースを作成し、システムプロキシ設定を参照しないアプリの通信もルール処理に取り込みます。デスクトップでは通常、サービスモードまたは管理者権限が必要です。モバイルではOSが提供するVPNインターフェースを使います。有効にする前に、他の同種のネットワークツールを終了し、正常に動作する設定を保存しておきましょう。auto-routeはルーティングに、DNSハイジャックは名前解決の経路に影響します。スイッチがオンになっただけでは接続成功とは判断できません。通信できなくなった場合は、まずTUNをオフにして基本のネットワークを確認し、その後に権限、デフォルトルート、DNSログを調べてください。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53サブスクリプション管理：配信設定とローカル変更を区別
サブスクリプションURLからは、完全なClash YAMLが返る場合もあれば、ノード一覧だけが返る場合もあります。インポート前に、提供元が案内する形式を確認してください。GUIクライアントのサブスクリプション機能は設定のダウンロードと切り替えを行います。一方、proxy-providersは設定ファイル内でプロキシの一覧を管理する機能で、別のものです。更新前にローカルルールとオーバーライドをバックアップし、更新後は意図した設定が選択されているか確認しましょう。サブスクリプションURLのトークンは認証情報です。スクリーンショット、ログ、質問を共有するときは必ず隠し、信頼できないオンライン変換サービスに実際のURLを入力しないでください。
proxy-providers:
local-nodes:
type: file
path: ./providers/nodes.yaml
proxy-groups:
- name: PROXY
type: select
use:
- local-nodesDNS設定：名前解決の経路を確認
Webサイトを開けない一方でプロキシ接続は確立できる場合、ドメインの名前解決失敗、ノードへの接続不能、ルールの選択ミスを切り分けます。Fake-IPは予約済みのアドレスをドメインに割り当て、接続時にコアがドメイン情報を保持できるようにする仕組みです。実際のサーバーアドレスではなく、DNSエラーを意味するものでもありません。暗号化DNSを設定する場合は、DNSサーバー自身のドメインをどう解決するかも考慮してください。まず動作する上流DNSを確保し、分岐ルールは少しずつ追加しましょう。LAN機器名、プリンター、特定のアプリで問題が起きた場合は、DNS機能全体を無効にするのではなく、ログを確認してfake-ip-filterの利用を検討してください。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- https://1.1.1.1/dns-queryLAN共有：待ち受け設定とファイアウォールを確認
LAN接続を許可すると、同じ信頼できるネットワーク上の端末から、このPCのプロキシポートへ接続できるようになります。allow-lanを有効にするだけでは不十分です。待ち受けアドレス、OSのファイアウォール、ネットワーク分離も接続に影響します。他の端末にはPCのLANアドレスを指定し、自分自身を指すループバックアドレスは使わないでください。PCのスリープ後やIPアドレス変更後も再確認が必要です。待ち受けアドレスは実際に使うインターフェースに限定し、ファイアウォールでは接続元のネットワーク範囲を制限してください。公衆ネットワークでプロキシポートを公開せず、外部コントローラーのポートをプロキシ用として指定しないでください。
mixed-port: 7890
allow-lan: true
# 待ち受けアドレスを、このPCで実際に使うLANアドレスに変更する
bind-address: 192.168.1.10外部コントローラー：管理APIとプロキシの入口を区別
external-controllerは管理APIを提供し、パネルから接続情報の取得、プロキシグループの切り替え、一部の動作状態の変更を行えます。ブラウザーのリクエストを中継する機能はないため、mixed-portの代わりにはなりません。PC内だけで使う場合はループバックアドレスにバインドし、専用のアクセスキーを設定してください。リモート管理では、認証とネットワークアクセス制限を別途設計する必要があります。外部パネルに接続できない場合は、まずアドレス、ポート、キーが一致しているか確認し、その後にブラウザーのクロスオリジン制限やセキュアコンテキストの要件を確認してください。クライアント画面で変更した内容が保存されるかどうかは、設定の生成方法とオーバーライドの仕組みによって異なります。
external-controller: 127.0.0.1:9090
# 説明用の例です。使用前に専用のランダムキーに変更してください
secret: "your-controller-secret"
コア / クライアント / 設定
mihomoコアとClashクライアントの関係
まず、通信を処理するコア、操作に使うGUI、接続情報を提供するサブスクリプションを区別しましょう。それぞれ別に開発・保守され、更新時期も異なります。このサイトではダウンロード先と設定ドキュメントを紹介しますが、プロキシのサブスクリプションは提供しておらず、各クライアントの開発チームとも関係ありません。
プロジェクトの沿革とメンテナンス範囲
Clashは、ルールベースのプロキシコアを起点にエコシステムを形成しました。その上でGUIクライアントが、設定の選択、システムプロキシ、接続状況の確認などを提供します。元のプロジェクトや一部の初期デスクトップクライアントのメンテナンス終了後も、コミュニティでは複数のフォークが開発されています。mihomoはClash Metaの開発方針を引き継ぎ、ルール、DNS、TUN、さまざまなプロキシプロトコルに対応しています。名称が似ていても同じソフトウェアとは限らず、古いガイドのボタンが現在のクライアントにあるとも限りません。
情報を調べるときは、使用中のGUIクライアントと内蔵コアを確認してから、それぞれのドキュメントを参照してください。画面上の項目名が同じだけでは不十分です。クライアントによって、設定の自動生成、オーバーライドの統合、編集可能な項目の制限などが異なります。他のクライアント向けの設定一式でそのまま上書きすると、既存のサブスクリプション管理を迂回したり、管理APIや待ち受け設定を上書きしたりする可能性があります。移行前に以前の設定とローカル変更を保存し、新しいアプリが起動することを確認してから、項目ごとに移行しましょう。
GUIが操作を担当し、コアが通信を処理
Clashクライアントは通常、トレイメニュー、自動起動、システムプロキシ、サブスクリプションのダウンロード、設定編集を担当します。実際の通信処理、ドメインの名前解決、ルールの照合を行うのはコアです。画面に「実行中」と表示されても、プロセスが動作していることを示すだけで、サブスクリプションの有効性やすべての接続先へのアクセスを保証しません。トラブル時は、クライアントが起動するか、設定を読み込めるか、ノードに接続できるか、ルールが想定したポリシーに一致するか、ドメインを解決できるかに分けて確認してください。
システムプロキシとTUNも異なる階層で動作します。システムプロキシは、この設定に従うアプリにローカルポートへの接続を指示します。一部のコマンドラインツールでは、プロキシ環境変数を別途設定する必要があります。TUNは仮想インターフェースとルーティングを通じて、より多くの通信を取り込みますが、権限やネットワーク環境の影響を受けやすくなります。ブラウザーでWebサイトを開けても、特定のアプリが使えないからといって、すぐにノードの障害とは判断できません。まず接続一覧にそのアプリが表示されるかを確認し、プロキシの入口とルールのどちらを調べるべきか判断しましょう。すべてのスイッチを同時にオンにするより、原因を特定しやすくなります。
サブスクリプションが設定を提供し、クライアントは接続情報を生成しません
インストール後も、既存のサブスクリプションまたは自分で用意した接続情報が必要です。サブスクリプションにはノード、プロキシグループ、ルール、DNSが含まれる場合も、プロキシ一覧だけの場合もあります。インポート時に形式エラーが出たら、まず返された内容がClash YAMLか確認してください。ブラウザーでURLを開いたときにログイン画面やエラーページが表示される場合、クライアントも設定として読み込めません。空の一覧、認証失敗、タイムアウトが起きるときは、ローカルのプロキシポートを変更するのではなく、サービスの状態、URLの有効性、ダウンロード経路を確認しましょう。
サブスクリプションURLに含まれるトークンは認証情報として扱ってください。スクリーンショットを共有するときはURL全体を隠し、設定をエクスポートする前にアカウント情報を削除し、公開の場で相談するときは必要なエラーと機密情報を伏せたスニペットだけを掲載しましょう。サードパーティのサブスクリプション変換を使うと、元のURLを別の事業者に渡すことになります。利用前に情報の流れを確認してください。サブスクリプションを更新してもローカル設定が更新されるとは限りません。クライアントがルールを再生成する場合があるため、独自の振り分け設定は対応するオーバーライド機能に記述し、更新後に実際に反映された内容を確認してください。
オープンソースの記録は調査に役立ちますが、実機での動作確認に代わるものではありません
mihomoはGPL-3.0ライセンスを採用しており、ソースコードと開発履歴はリポジトリで確認できます。GUIクライアントにはそれぞれ独自のプロジェクト、ライセンス、リリースノートがあるため、個別に確認してください。オープンソースの利点は、実装や変更内容を確認でき、互換性の問題に関する議論を追えることです。特定のネットワーク環境、サブスクリプション、設定の組み合わせで必ず動作することを保証するものではありません。このサイトでは、根拠を確認できる資料の代わりに、裏付けのないダウンロード数、評価、速度の数値を掲載しません。
問題を報告するときは、OS、クライアント名、関連する設定、再現手順を記載してください。ログはエラー前後の必要な部分だけを抜き出し、サブスクリプション、キー、個人のアクセス先を隠しましょう。「address already in use」は待ち受けポートの競合、「connection refused」は接続先ポートからの拒否を示します。名前解決に失敗する場合は、DNSの経路をさらに確認してください。「インターネットにつながらない」とだけ書くより、実際のエラーメッセージを残す方が、クライアント、設定、サーバーのどこに問題があるかを切り分けやすくなります。
更新する順番と元に戻せる設定
クライアント、コア、サブスクリプション、GeoIPデータベースは、それぞれ別の更新対象です。クライアントの更新では画面やサービスコンポーネントが変わる場合があり、コアの更新ではプロトコルや設定項目に影響することがあります。サブスクリプションの更新は接続情報やルールに、GeoIPデータの更新は地域情報に基づく照合結果に影響します。一度に変更する対象を一種類に絞り、変更前の状態を記録してください。問題が起きたら直近の変更を戻す方が、すべての設定をリセットするより原因を特定しやすくなります。
初期設定では、まずルールモードでブラウザーに接続し、次に他のアプリを確認してから、TUN、LAN共有、外部パネルを検討しましょう。確認時はWebサイトが開くかだけでなく、接続一覧のドメイン、適用されたルール、最終的なポリシーが想定どおりかも見てください。接続できてもポリシーが異なる場合は調整が必要です。カスタム設定は別ファイルに保存し、YAMLのインデントにはスペースを使ってください。同じ階層のフィールドを重複して定義しないよう注意します。クライアントに設定を読み込ませた後はログで成功を確認してから、次の手順に進みましょう。
ドキュメントの入口とトラブル対処の手順
初めて使う場合はサブスクリプションの追加手順から始め、追加、設定の選択、ルールモードへの切り替え、プロキシの有効化の順で接続を確認してください。接続はできていてWebサイトごとの経路を調整したい場合は、詳細設定でプロキシグループ、ルールセット、オーバーライドを確認できます。用語がわからないときは、フィールド名から用途を推測せず、まず用語集を参照してください。設定の流れを一貫させることで、断片的な設定の貼り付けによる上書きを防ぎやすくなります。
有効にした後まったくアクセスできない場合は、他のプロキシツールを終了し、通常のネットワークが使えることを確認してから、サブスクリプションの有効性、現在選択中の設定、プロキシグループ、DNSログの順に調べてください。一部のWebサイトだけで問題が起きる場合は、すぐに再インストールせず、その接続のルールと接続先を確認しましょう。クライアントを終了してもアクセスできない場合は、システムプロキシの設定が残っていないか、元のネットワーク設定に戻っているかを確認してください。症状別の回答はヘルプセンターにまとめています。ここでは確認手順を案内し、すべてのトラブルを一つのスイッチで解決しようとはしません。
設定の知識とトラブル対処の記事
サブスクリプションの形式、証明書エラー、スマートフォンのバックグラウンド動作は、それぞれ異なる設定に関わります。具体的な症状に応じて読み進め、問題がどの層で起きているか把握してから該当する項目を変更してください。以下は最近公開した記事です。
Androidでプロキシを使うと電池の減りが早い：バックグラウンド動作、省電力の例外設定、Clashの調整
バックグラウンドでの常駐、頻繁なヘルスチェック、DNS問い合わせから確認し、通常の通信負荷と、OSがサービスを繰り返し終了することで生じる余分な消費を切り分けます。端末のバッテリー管理設定を確認したうえでクライアントを調整し、省電力機能を一律に無効化するだけの対処は避けましょう。
記事を読む →サブスクリプション形式を解説：Clash YAML、Base64形式のノードURL、変換サービスの違いと使い方
完全な設定ファイル、エンコードされたノード一覧、単一のプロトコルURLは、それぞれ別の形式です。各データの構造、クライアントが読み込める内容、変換サービスがアクセスする情報を解説します。インポートに失敗したら、まず形式を確認し、その後でフィールドや設定の統合を見直しましょう。
記事を読む →プロキシ接続後にWebサイトで証明書エラーが表示される：HTTPS証明書エラーの原因と確認手順
システム時刻、名前解決の経路、HTTPS通信の証明書、問題のあるノードを順に確認します。Fake-IPがWebサイトの証明書を発行することはありません。証明書の警告をそのまま無視するのも避けてください。まずブラウザーのエラーと証明書の主体を記録し、ネットワークのどの段階で変化が起きたかを調べましょう。
記事を読む →