FIELD REFERENCE
クライアントは設定の読み込みや切り替え、表示を担当し、コアは設定に基づいて接続を処理します。まず待ち受けポート、名前解決方法、出力先を区別し、該当する項目を変更してください。以下の例は個別の設定項目を説明するもので、つなぎ合わせても完全なサブスクリプションにはなりません。例のポリシーグループが参照するのは組み込みの出力先DIRECTのみです。実際のプロキシノードは別途設定してください。
mixed-portは同じポートでHTTPとSOCKSのリクエストを受け付けます。ブラウザーやコマンドラインツールなど、プロキシアドレスを手動設定するアプリに便利です。端末内だけで使う場合は、通常ループバックアドレスを指定し、ポート番号を実行中の設定とそろえます。allow-lanはLAN内の端末からの接続を許可するかどうかを指定しますが、待ち受けアドレスとOSのファイアウォールも確認が必要です。システムプロキシはクライアントがOSに設定を書き込む機能で、すべてのアプリがこのポートを通るとは限りません。ほかの通信も中継する場合は、ガイドを参考にTUNモードを検討してください。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: infodns.enableは内蔵DNSサービスの有効・無効を設定し、enhanced-modeは拡張名前解決方式を指定します。Fake-IPは仮想アドレスを使ってドメインと接続の対応関係を保ち、ドメインに基づくルールの振り分けを可能にします。nameserverには上流DNSサーバーを指定します。内蔵DNSを有効にしただけでは、システムのDNSリクエストが自動的にそのサービスへ届くとは限りません。TUNのDNSハイジャック設定やシステムのDNS設定も確認してください。ClashでDNS漏れを調べる際は、スイッチの状態だけでなく、リクエストの実際の経路を確認しましょう。LAN内のドメインに問題がある場合は、該当ドメインに合わせてフィルターや名前解決のルールを設定してください。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- https://dns.alidns.com/dns-queryproxiesはノード定義のリストです。各項目のnameで参照用の名前を設定し、typeでプロトコルを指定します。server、port、認証情報はサーバー側の設定と一致させてください。プロトコルごとに必要なパラメーターは異なるため、同じパスワード項目で代用できるとは限りません。通常、サブスクリプションにはノード情報が含まれているため、初めて使う際に手作業で書き直す必要はありません。以下の例にある予約済みドメインと説明用パスワードは構造の解説用であり、接続には使えません。プロトコルの対応状況は使用中のコアによって異なります。クライアントの画面に名前が表示されても、コアの設定チェックに通ったとは限りません。
proxies:
- name: サンプルノード
type: ss
server: proxy.example.com
port: 443
cipher: aes-128-gcm
password: "your-password"proxy-groupsはノードやほかのポリシーグループをまとめ、出力先として扱います。selectは手動選択、url-testはテスト結果に基づく自動選択、fallbackは利用可能な候補へ順に切り替える方式です。名前だけを見て用途を置き換えることはできません。ルールが参照するのはグループ名であり、画面上の並び順ではありません。nameを変更したら、rulesやほかのグループからの参照も更新されているか確認し、グループ間の循環参照を避けてください。例では有効な参照先としてDIRECTを残しています。実際のサブスクリプションを読み込んだ後、一覧にそのサブスクリプション内のノード名を追加してください。
proxy-groups:
- name: 出力先の選択
type: select
proxies:
- DIRECT
rules:
- MATCH,出力先の選択rulesはリストの上から順に照合され、最初に一致したルールで接続の出力先が決まります。DOMAINは完全一致するドメイン、DOMAIN-SUFFIXはドメインとそのサブドメイン、IP-CIDRは宛先IPアドレスの範囲に一致します。MATCHは通常、末尾に置いて残りの接続を受け持ちます。具体的なルールは広い範囲に一致するルールより前に置いてください。そうしないと、後続の条件が適用されないことがあります。変更後は接続の詳細画面で、一致したルールと実際のポリシーグループを確認できます。このリストによる振り分けが行われるのはルールモードです。グローバルモードに切り替えた場合、同じ一致結果を前提に動作を判断しないでください。
rules:
- DOMAIN,example.com,DIRECT
- DOMAIN-SUFFIX,example.org,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT
- MATCH,出力先の選択profileのstore-selectedはポリシーグループの選択状態を保存し、store-fake-ipはFake-IPのマッピングを永続化します。これらは実行状態を扱う項目であり、サブスクリプションのダウンロードや更新間隔には関与しません。サブスクリプション更新後にグループ名が変わると、以前の選択状態を引き継げない場合があります。その際は設定をすべて消去するのではなく、ポリシーグループを確認してください。サブスクリプションを編集する前に、クライアントが上書きやマージに対応しているか確認しましょう。ダウンロードしたファイルを直接編集すると、次回の更新で変更が失われることがあります。
profile:
store-selected: true
store-fake-ip: trueクライアントが保存するサブスクリプションの原文、ユーザー用の上書きファイル、コアが最終的に読み込む設定は、それぞれ別のファイルである場合があります。変更前に現在有効なサブスクリプションを確認し、クライアントが提供する実行中の設定やマージ結果を調べてください。使用されていない複製ファイルを編集しないよう注意しましょう。
項目の型、ルール構文、マージ順の詳細は設定リファレンスをご覧ください。サブスクリプションを初めて読み込む場合は、クイックスタートから始めれば、設定全体を手書きする必要はありません。
CLIENT / PLATFORM
まずOSとプロセッサーのアーキテクチャを確認し、そのうえでクライアントごとの設定管理方法を比較します。デスクトップGUIはサブスクリプション管理や接続確認に便利です。サーバーやルーターではコアを直接実行できますが、設定ファイルの場所、サービスの起動、ネットワーク権限を自分で管理する必要があります。OSを移行する際は同じYAML項目を参考にできますが、システムプロキシ、TUNの権限、設定の上書き場所は個別に設定してください。
まずはClash Plusがおすすめです。使い方に応じてClash Verge Rev、FlClash、Clash Nyanpasuも選べます。システム情報でアーキテクチャを確認し、ダウンロードページから該当するインストーラーを選んでください。Clash for Windowsから移行する場合は、プログラムの保存先を上書きするのではなく、サブスクリプション、ルール、ポリシー選択を引き継ぎます。起動後、mixed-portとシステムプロキシのアドレスが一致しているか確認しましょう。
ダウンロードページへ「このMacについて」でApple SiliconかIntelかを確認し、対応するインストーラーを選びます。まずはClash Plusがおすすめです。Clash Verge RevやFlClashも選択肢になります。ネットワークの中継を初めて有効にするときは、システムの案内に従って必要な権限を許可してください。メニューバーに動作中と表示されても、システムプロキシが有効とは限りません。アプリの設定と接続ログの両方で確認しましょう。
ダウンロードページへまずはClash Plusがおすすめです。設定形式に応じてClash Meta for Android、FlClash、Surfboardも選べます。端末のアーキテクチャを確認してからインストールし、初回接続時にシステムのVPN利用を許可してください。アプリごとの振り分け設定とシステムVPNの設定によって、プロキシを経由するアプリが変わります。接続直後は正常でもバックグラウンドで切断される場合は、バッテリー管理とバックグラウンド実行の制限を確認してください。
ダウンロードページへダウンロードページにはClash PlusのApp Storeリンクと公式サイトclashplus.ioがあります。インストール後、対応するサブスクリプションを読み込み、システムの許可画面でVPN構成の追加を許可してから、クライアントでポリシーグループを選択してください。接続に問題がある場合は、まず有効になっている設定を確認し、ほかのネットワーク拡張機能が同時に有効になっていないか調べましょう。
ダウンロードページへデスクトップ環境ではClash Verge RevまたはFlClashがおすすめです。ディストリビューションに合ったパッケージ形式を選んでください。システムプロキシは通常デスクトップ環境に依存し、ターミナルのプログラムではプロキシ環境変数を別途設定する場合があります。デスクトップ環境のないホストでは、ダウンロードページのコア欄を参考に、サービス管理、作業ディレクトリ、権限を手動で設定してください。デスクトップクライアントの手順をルーターにそのまま適用しないでください。
ダウンロードページへQUICK START / THREE STEPS
01 / IMPORT
サブスクリプション提供元からクライアントに対応した設定リンクを取得し、クライアントのサブスクリプションまたは設定画面でリモート設定を追加します。ダウンロード後、その設定を現在の設定として有効にしてください。リストに項目が表示されるのは最初の段階で、コアが正常に読み込めたことも確認する必要があります。リンクにはアクセス情報が含まれることがあるため、トラブルシューティング用のスクリーンショットではURL全体を隠してください。形式エラーが表示されたら、YAML設定と単一ノードのリンクを区別し、拡張子だけを変更しないでください。
02 / ROUTE
実行モードをルールモードに設定し、プロキシまたはポリシーグループの画面で、手動選択が必要なグループの出力先を指定します。グループ名は設定によって異なり、サブスクリプションごとに同じとは限りません。ノードを選んだだけではシステムの通信がクライアントを経由するようにはなりません。デスクトップでは用途に応じてシステムプロキシまたはTUNを有効にし、モバイルではシステムVPNを許可してください。初回のテストでは設定をシンプルに保ち、DNSと振り分けルールを同時に変更しないようにしましょう。
03 / VERIFY
アクセスしたいページを開き、クライアントの接続一覧で宛先ドメイン、一致したルール、出力先ポリシーを確認します。遅延テストの成功はテストリクエストが完了したことを示すだけで、実際のアプリでの動作確認にはなりません。接続一覧に記録がない場合は、まず通信の入口を確認してください。記録があるのに接続できない場合は、ルールの宛先、ノードの状態、名前解決の結果を調べます。確認後、必要に応じてサブスクリプションの更新間隔を設定し、カスタム上書きの場所を記録しておきましょう。
SOURCE / CORE / CONFIGURATION
Clashエコシステムでは、YAML設定、ルールによる振り分け、GUIクライアントを中心にさまざまな実装が使われています。初期のプロジェクトのメンテナンス状況が変化した後も、後継のコアやクライアントは開発を続けています。そのため、「Clash」が単一のインストーラーを指すわけではありません。ダウンロード時はプロジェクト名、対応プラットフォーム、メンテナンス状況を確認してください。ファイル名にClashが含まれているだけで、既存の設定と完全互換だと判断しないようにしましょう。当サイトはドキュメントとダウンロード先を案内するもので、すべてのクライアントプロジェクトの開発元ではありません。
mihomoはClashエコシステムのプロキシコアで、プロトコル接続、ルール照合、DNSなどを処理します。Clash Verge RevなどのGUIクライアントは、その上で設定管理や操作画面を提供します。画面のメニューとYAMLの項目が一対一で対応するとは限らず、クライアントが一部の設定を生成または上書きすることもあります。問題を調べる際は、まずコアが最終的に読み込んだ項目を確認し、その後でメニューの設定を調べると、「ファイルを変更したのに動作が変わらない」という誤解を防げます。
mihomoのソースコード、ライセンス、課題の議論、リリース履歴はプロジェクトのリポジトリで確認できます。リポジトリのライセンスはGPL-3.0です。各オープンソースプロジェクトのライセンスと配布方法は個別に確認してください。コアのライセンスが、すべてのクライアント、サブスクリプションサービス、第三者の設定に共通する許可を与えるわけではありません。動作を再現する場合は、使用したクライアントとコアの情報、発生条件を記録してください。問題を報告する際は必要な部分だけを残し、サブスクリプションのURL、パスワードなどの認証情報を削除しましょう。
クライアントアプリ、コア、サブスクリプションの更新はそれぞれ別の操作です。アプリの更新では画面や統合機能が変わり、コアの更新では対応項目や処理方法が変わることがあります。サブスクリプションの更新ではリモート設定の内容が置き換わります。設定の読み込みエラーが発生したら、まずエラーの位置と項目の型を確認し、プログラムを何度も入れ替えて問題の特定を先送りしないでください。新しい設定項目が古いクライアントで認識されない場合もあります。移行前にクライアント選びのガイドを確認してください。
長期的に使うカスタムルールは、クライアントが対応する上書きまたはマージ機能に設定し、サブスクリプション処理のどの段階で統合されるか確認してください。リストが置き換えられるか、クライアントの仕様に従って追加されるかは異なります。YAMLの階層だけから判断することはできません。更新のたびに主要なポリシーグループ名、末尾のMATCH、DNS設定が想定どおりか確認しましょう。詳しい例と適用範囲は設定リファレンスをご覧ください。ソースコードはプロジェクトのリポジトリから確認できます。
CONFIGURATION NOTES
記事では具体的な操作場面ごとに解説します。プロキシを共有する場合は待ち受けポートを確認し、ノードを選ぶ際はテスト結果と通信量の倍率を区別し、サブスクリプションを変換する際は設定の構造を確認してください。共通の項目は設定リファレンスと照らし合わせ、個別記事の設定を既存の設定全体にそのまま上書きしないようにしましょう。
mixed-portとallow-lanの役割を解説し、同じLAN内のスマートフォン、テレビ、ゲーム機からパソコンのプロキシを使う設定手順と、ファイアウォールの注意点を紹介します。
設定ガイドを読む →遅延テストの数値が示す内容と限界、通信量倍率が使用量に与える影響を解説します。用途に応じた地域やプロトコルの選び方も紹介し、ノード一覧から選ぶ際の判断材料を提供します。
設定ガイドを読む →ClashのYAMLサブスクリプション、Base64エンコードされたリンク、単一ノードURIの構造を比較します。変換時の項目の対応関係と、変換後に確認すべき点も解説します。
設定ガイドを読む →