● 設定ガイドCLASH / YAML

Clashクライアントのダウンロードと設定ガイド

OSに合ったインストーラーを選び、サブスクリプションの読み込みから始めて、ルール設定と YAML の各項目を確認しましょう。

オープンソースのコア日本語で読める設定項目
インストール方法OS / ARCH

OSに合ったClashインストーラーを選ぶ

まずOSを選び、CPUアーキテクチャとインストーラー形式を確認しましょう。ダウンロードページでは、プラットフォーム別にクライアントとシステム要件をまとめています。同じ名前のアプリでも、OSによってコアやオーバーライドの対応状況が異なる場合があります。

Windows

システム設定の「バージョン情報」でOSの種類を確認します。デスクトップクライアントを使う前に、ほかのプロキシツールがシステムプロキシやローカルの待受ポートを使用していないか確認してください。

ダウンロードページへ →

macOS

「このMacについて」に表示されるチップまたはプロセッサを確認し、Apple SiliconとIntelを選び分けます。ネットワークを制御する場合は、選択したクライアントの案内に従って権限を許可してください。

ダウンロードページへ →

Android

デバイスが対応するアプリのアーキテクチャに合わせてインストーラーを選びます。初回接続時はOSのVPN許可画面を確認し、同じ接続方法を使う別のツールが動作していないことも確かめてください。

ダウンロードページへ →

iOS

ダウンロードページからApp Storeに進みます。インストール後、クライアントが対応するインポート形式を確認してから設定を追加し、案内に従って接続を許可してください。

ダウンロードページへ →

Linux

ディストリビューション、パッケージマネージャー、CPUアーキテクチャで絞り込みます。デスクトップ環境ではGUIクライアントを優先し、プロセスを自分で管理したい場合はコアのパッケージも確認しましょう。

ダウンロードページへ →

すべてのクライアントを見る →

プロジェクトと情報源CORE / GUI

Clashのオープンソースエコシステムと役割分担

似た名前のアプリを見かけたら、プロジェクトの変遷、コアの由来、クライアントの保守状況を確認してから設定を移行しましょう。

Mihomoのソースコードリポジトリ ↗

git clone https://github.com/MetaCubeX/mihomo.git

プロジェクトの変遷:名称からドキュメントの対象を見分ける

Clashはもともと、ルール設定を使うプロキシコアを指す名称であり、デスクトップやモバイル向けツール群の総称としても使われてきました。MihomoはClash Metaの開発方針を引き継いでいるため、古いガイドにあるMetaという名称が、現在のMihomoプロジェクトを指す場合があります。古い情報を参照するときは、元のコア、後継のフォーク、特定のクライアントの操作画面のどれを扱っているか確認しましょう。ボタン名や設定画面が変わっても、YAMLの構文まで同時に変わったとは限りません。逆に、画面が似ていても、古い設定の拡張項目が引き続き使えるとは限りません。

コミュニティ情報の読み方:リポジトリとクライアントの説明

MihomoのソースコードはGPL-3.0で公開されています。リポジトリではコード、課題の議論、リリース情報を確認できます。一方、デスクトップやモバイルのクライアントはそれぞれのプロジェクトが保守しており、同じコアを使っていても、ライセンスや配布方法が同じとは限りません。コミュニティの報告を調べるときは、OS、接続方法、実際のエラーを照らし合わせましょう。症状が同じでも、対処法がそのまま使えるとは限りません。上のcloneコマンドは、閲覧や開発用にコアのソースコードを取得するものです。GUIクライアントのインストールやサブスクリプションの読み込みには使えません。

役割の違い:UIが設定を作成し、コアがネットワーク処理を実行

GUIクライアントは通常、サブスクリプションの取得、設定の切り替え、システムプロキシの操作、ログ表示を担当します。コアは有効な設定を読み込み、待受、DNS、ルール照合、通信の送信を処理します。設定が反映されるかどうかは、クライアントが最終設定ファイルに書き込むか、コアがその項目を読み取るか、OSが関連するネットワーク操作を許可するかによって決まります。移行するときは、新しいクライアントに元の設定を読み込ませて接続を確認してから、ローカルのオーバーライドを一つずつ戻すと安全です。クライアントの比較はクライアント比較を参考にし、見た目だけで選ばないようにしましょう。

更新の考え方:アプリ、コア、サブスクリプションを個別に管理

アプリの更新では設定の保存場所や画面上の入口が変わることがあります。コアの更新では対応する項目やネットワーク動作が変わる場合があります。サブスクリプションの更新では、提供元のプロキシ、プロキシグループ、ルールが置き換わります。この3種類の変更は分けて行いましょう。更新前に再インポート可能な設定とローカルのオーバーライドを保存し、現在の接続方法を記録します。更新後は、使用中の設定が正しいか、ローカルポートが待ち受けているか、よく使うサイトにどのルールが適用されるかを確認してください。問題が起きた場合は、直前に変更した層だけを元に戻し、原因の切り分けに使える設定まで上書きしないようにしましょう。

インストールと設定に関するよくある質問

ポート7890で待ち受けていれば、システムでプロキシが使われていますか?

必ずしもそうではありません。mixed-portが指定するのは、コアがプロキシリクエストを受け付けるポートです。OSやアプリ側で、実際の待受アドレスとポートを指定する必要があります。アプリによっては独自のネットワーク設定があり、システムプロキシが有効でも、その設定に従って接続する場合があります。まずポートの設定項目を確認し、次にクライアントの接続画面に送信したリクエストが表示されるか見てみましょう。

サブスクリプションを更新したら、以前選んだ接続先が表示されなくなったのはなぜですか?

サブスクリプションの更新で、グループ名、項目名、メンバーの順番が変わることがあります。選択中の接続先が削除済みのメンバーを指している場合、クライアントが現在のグループで利用可能な候補に切り替えることがあります。まず使用中の設定を確認し、更新前後のプロキシグループとオーバーライドの参照先を比べてください。グループタイプなどの用語がわからない場合は、用語集を確認しましょう。

同じ設定を別のデバイスへそのまま移行できますか?

基本的な項目は移行しやすい一方、仮想ネットワークインターフェース、ネットワークインターフェース名、ローカルファイルの場所、クライアントのオーバーライドスクリプトはデバイス環境に依存することがあります。まず移行先のクライアントが対応するインポート形式を確認し、デバイスに依存しないルールやポリシーから移しましょう。設定に問題がないことを確認してから、移行先でシステムプロキシや接続の権限を設定してください。以前のデバイスのパスをそのまま引き継がないようにしましょう。

Clashの技術ノート

クライアント比較、接続トラブル、モバイルでの初回インポートを問題別に解説します。

すべての記事を見る →