FIG 1 / CONFIGURATION WORKSPACE
サブスクリプションが設定を提供し、クライアントが設定を組み立て、コアがルールを実行します。それぞれの役割を把握したうえで、オーバーライド、プロキシグループ、通信の取り込み方法を調整しましょう。
Clash Nyanpasuはデスクトップでの設定管理を目的としたクライアントです。リモートサブスクリプションを追加したら、まず設定が読み込めることを確認し、次にプロキシグループとルールの宛先を確認します。以下の例は設定項目の関係を説明するもので、接続可能なプロキシサービスは含みません。例中のDIRECTは直接接続を表します。モバイル端末向けのクライアントは、下のプラットフォーム別リンクから確認できます。
Profileは、クライアントが管理する設定単位です。ローカルのYAMLファイルから作成することも、リモートサブスクリプションから取得することもできます。サブスクリプションの内容を直接編集すると、次回の更新で変更が失われる場合があります。ポート、DNS、カスタムルールなど長期的に維持したい設定は、個別のオーバーライドに記述し、最終的に生成された設定を確認しましょう。リスト項目の置換・追加やスクリプトの扱いはクライアントごとに異なるため、すべてのマージを単純な文字列の連結と考えることはできません。Profileを切り替える前に使用可能なコピーを残し、読み込み後はログを確認して、オーバーライドが想定した階層に反映されているか確かめてください。
Clash Nyanpasumixed-port: 7890
allow-lan: false
mode: rule
log-level: infoプロキシグループを使うと、ルールの宛先と実際の接続先を分けて管理できます。ルールではグループ名を指定し、グループ内で使用する接続先を選べるため、出口を変更するたびにドメインルールを一つずつ直す必要はありません。selectタイプは手動選択に使います。その他のグループタイプの動作は、コアのドキュメントも確認してください。グループ名はrulesの宛先と完全に一致させる必要があり、大文字・小文字、空白、名前の変更も参照に影響します。以下の例では構文の説明に限り、最小限の構成としてDIRECTを使用しています。古い設定を移行する場合は、削除済みのメンバーを参照していないか、グループ間に循環参照がないか、最後にフォールバックルールの宛先が有効かを確認しましょう。
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECTルールは上から順に条件を評価し、通常は最初に一致したルールで接続先が決まります。そのため、厳密なドメイン指定や個別の例外は、広い条件より前に配置し、MATCHは最後のフォールバックにします。ルールの記述が正しくても結果が想定と異なる場合は、現在のモード、宛先のプロキシグループ、先行するルールへの一致をあわせて確認してください。GEOIPなどのルールは対応するデータも必要です。1行の設定だけで結果を判断しないようにしましょう。以下の例にあるPROXYは、有効なプロキシグループとしてあらかじめ定義してください。グループの接続先がDIRECTのみの場合、そのグループに一致した通信は直接接続され、プロキシ経由にはなりません。
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXYシステムプロキシは、主にシステムのプロキシ設定に従うアプリで利用されます。一方、TUNは仮想ネットワークインターフェースを通じて、より多くの通信を取り込みます。TUNを有効にする前に、通常のプロキシモードで設定が使えることを確認し、クライアントの案内に従ってサービスをインストールするか、必要な権限を許可してください。DNS設定はドメイン名の名前解決を担い、fake-ipはその方式の一つです。TUNの有効化と同じものではありません。ドメインへのアクセスに問題がある場合は、名前解決の経路、システム上のほかのネットワークソフト、コアのログを確認し、一度に複数の設定を変更しないでください。以下の例は設定の階層のみを示しています。実際の利用には、システムのルーティング、権限、DNS設定もあわせて確認が必要です。
tun:
enable: true
auto-route: true
dns:
enable: true
enhanced-mode: fake-ipFIG 2 / PLATFORM SELECTOR
デスクトップとモバイルでは、適したクライアントが異なります。
インストーラー、対応アーキテクチャ、システム要件はダウンロードページで確認できます。
Clash Nyanpasuのデスクトップ向け機能と、Clashエコシステムのマルチプラットフォーム対応クライアントは分けて考える必要があります。Windows、macOS、Linuxでは、デスクトップ環境や設定方法に合うGUIクライアントを選びましょう。AndroidとiOSでは各OS向けのアプリを使用し、デスクトップ用プログラムをインストールしようとしないでください。ここでは5つのプラットフォーム向けダウンロード案内を掲載しています。対応クライアントの詳細はダウンロードページで確認できます。既存のサブスクリプションを使う場合も、出力形式を確認してください。アプリによって対応する設定項目が異なります。
システムプロキシ、設定編集、サービスモードを使いたいデスクトップユーザー向けです。ダウンロード前に「システム設定」→「一般」→「情報」を開き、プロセッサのアーキテクチャを確認してから対応するインストーラーを選びます。初回起動時は使用可能な設定をインポートし、ポートの競合がないことを確認してからシステムプロキシを有効にしてください。TUNを使う場合は、その後にサービスの権限を設定します。
Clash for Windowsから移行する場合は、元の設定とカスタムルールをバックアップしてください。新しいクライアントでは設定の保存先、オーバーライドの設定場所、コアが対応する項目が異なる場合があります。アプリのデータフォルダー全体をそのまま上書きせず、項目ごとに移行することをおすすめします。
ダウンロード Windows版クライアント「このMacについて」でApple SiliconかIntelかを確認してから、対応するインストーラーを選びます。インストール後は、システムの案内に従って起動を許可してください。バックグラウンドサービスやネットワーク関連の権限が必要かどうかは、使用するクライアントと通信の取り込み方法によって異なります。まず通常のシステムプロキシが使えることを確認し、その後でほかのネットワーク機能を段階的に有効にすると、権限や設定の問題を切り分けやすくなります。
クライアントを切り替える前に、古いアプリを終了し、システムプロキシを無効にしてください。ブラウザーが引き続き古いプロキシアドレスを使用する場合は、サブスクリプションを何度も読み込み直すのではなく、システムのネットワーク設定を確認しましょう。
ダウンロード macOS版クライアント端末のアーキテクチャに合ったAndroidクライアントを選び、インストール後に対応するサブスクリプション設定を追加してください。初回接続時には、通常、システムからVPN接続の許可を求められます。これはアプリが端末内の通信を取り込むためのシステム手順であり、サブスクリプションが使用可能になったことを意味するものではありません。設定の読み込み状態とルールの宛先も確認してください。
バックグラウンドでの動作は、システムのバッテリー管理設定に左右されます。アプリを切り替えた後に接続が途切れる場合は、設定を見直す前にバッテリー最適化とバックグラウンド制限を確認してください。ほかのVPNアプリが起動している場合は、システムの接続を占有していないかも確認しましょう。
ダウンロード Android版クライアントiPhone・iPadでは、ダウンロードページからClash PlusのApp Storeページに進めます。インストール後、アプリの案内に沿って設定を追加し、システムから求められたらVPN構成の追加を許可してください。サブスクリプションURLは信頼できる提供元から入手し、アクセス情報を含む完全なURLをスクリーンショットや公開の場に載せないでください。
デスクトップの設定ファイルは移行時の参考になりますが、スクリプトやオーバーライドの機能がすべてそのまま使えるとは限りません。インポート後は、アプリが対応する設定項目とプロキシグループを確認してから、必要な調整を行いましょう。
ダウンロード iOS版クライアントデスクトップでは、ディストリビューションのパッケージ形式に合うGUIクライアントを選び、デスクトップセッションに必要な依存関係も確認してください。サーバーやルーターで使う場合は、ダウンロードページのmihomoコアの項目を参照できます。コア単体にはデスクトップ向けの設定管理画面がないため、設定ファイルの場所、起動引数、サービスの起動・停止を自分で管理する必要があります。
システムプロキシが適用される範囲は、デスクトップ環境やコマンドラインツールによって異なります。特定のアプリがプロキシを経由しない場合は、まずシステム設定を参照するアプリかどうかを確認し、アプリ固有のプロキシ設定を使うか、別の通信取り込み方法にするかを判断してください。
ダウンロード Linux版クライアントクライアントはローカルの設定と接続を管理するもので、プロキシサービスは含まれません。インポートに失敗したらサブスクリプションの形式を確認し、接続に問題がある場合はモード、ルールの宛先、システムプロキシの順に確認しましょう。初期設定の手順はクイックスタート、設定項目の意味は用語ガイドをご覧ください。
すべてのクライアントを見る →FIG 3 / SOURCE & RUNTIME
GUI / PROFILE / CORE
Clash NyanpasuはClashエコシステムのオープンソース・デスクトップGUIクライアントです。Clashは初期のプロジェクト名として使われるほか、互換性のある設定形式や関連クライアントの総称として使われることもあります。チュートリアルを読む際は、プロジェクト名と設定構文を区別し、古いクライアントの画面操作をすべてのアプリに当てはめないようにしましょう。Clash for Windowsの代替を選ぶときは、名前の近さだけでなく、設定の移行、コアの対応状況、サービスに必要な権限を比較してください。
クライアントはサブスクリプションの管理、画面操作、設定の生成、システム連携を担当します。mihomoは設定を読み込み、プロトコル処理、ルール判定、DNSなどを実行します。画面でスイッチが有効になっていても、コアが該当する設定を正常に読み込んだとは限りません。生成後の設定内容と起動ログを照らし合わせて確認しましょう。構文エラーならYAMLの階層、参照エラーならグループ名、待ち受けの失敗ならポートの使用状況を確認し、異なるレイヤーの問題を混同しないようにしてください。
プロジェクトのソースコードはClash Nyanpasuのオープンソースリポジトリで確認できます。ライセンスはGPL-3.0です。ソースコード、リリースノート、問題報告は、それぞれ実装の理解、変更点の確認、既知の挙動の把握に役立ちます。問題を報告する際は、OS、操作手順、期待する結果、関連ログを記載し、サブスクリプションURL、認証情報、個人用ドメインは削除してください。無関係な項目を含む設定全体より、再現に必要な最小限の設定のほうが原因を特定しやすくなります。
アプリ、コア、サブスクリプションの更新はそれぞれ別の操作です。アプリを更新すると画面や設定の処理方法が変わることがあり、コアの更新では設定項目の対応状況が変わる場合があります。サブスクリプションの更新では、リモートの内容が置き換わります。更新前にローカルのオーバーライドと使用可能な設定をバックアップし、更新後はまず従来の基本機能を確認してから、新しい項目を試してください。トラブルの切り分け中にクライアントの変更、DNSの修正、ルールの書き換えを同時に行うと、どの変更が影響したか判断しにくくなります。
ローカル環境にGitが必要です。cloneで取得できるのはソースコードのみです。ビルド方法はリポジトリのドキュメントを参照してください。通常の利用には、ダウンロードページのインストーラーをお使いください。
git clone https://github.com/LibNyanpasu/clash-nyanpasu.git初めて使う場合は、まずクイックスタートを読み、設定の追加、モードの選択、システムプロキシの設定を行いましょう。Profile、fake-ip、プロキシグループなどの用語は用語ガイドで確認できます。設定項目を変更する場合はYAML設定ガイドを使い、共通設定、プロキシ、プロキシグループ、ルール、オーバーライドの順に確認してください。例は内容を理解してから使い、特にルールの各宛先が定義済みか確認しましょう。解説用の断片を完全なサブスクリプション設定として使うことはできません。
いわゆるClashの無料ノードやプロキシサービスのサブスクリプションについて、クライアントが行うのは設定の読み込みです。第三者サービスの稼働状況、プライバシーの取り扱い、継続性は保証されません。利用元を選ぶ際は利用規約と利用範囲を確認してください。問題のスクリーンショットを共有するときは、サブスクリプションURLを隠しましょう。設定をインポートできても、ネットワーク接続やルーティングが期待どおりに動作するとは限りません。
READING / RECENT NOTES
ブログ記事は、それぞれ一つの操作テーマを扱います。ルールの記事では評価順序、プラットフォームの記事ではシステム権限、設定の記事では複数のProfileの管理方法を解説します。問題を調査する場合は、まず使用可能な設定を一つに絞り、元のログを保存したうえで、記事に沿って一つずつ変更してください。異なるOSの権限設定や、別のクライアントの操作手順を混ぜないようにしましょう。
DOMAIN-SUFFIX、IP-CIDR、GEOIP、RULE-SET、MATCHなどのルールの書き方を解説。上から順に評価し、最初に一致したルールが適用される仕組みと、ルールの並べ方を紹介します。
記事を読む →macOSで「開けない」と表示される問題、サービスモードの許可、ネットワーク拡張の有効化、キーチェーンの確認が繰り返し表示される問題について、システム設定の手順に沿って解説します。
記事を読む →Profileとconfig.yamlの関係から、ローカル設定、リモートサブスクリプション、オーバーライドスクリプトの役割を解説。複数の設定を使う際の名前の付け方、切り替え、バックアップ方法も紹介します。
記事を読む →