Windows
デスクトップでの日常利用に適しています。インストール前にOSのバージョンとCPUアーキテクチャを確認してください。ほかのプロキシツールを使用中の場合は終了してから、クライアントのシステムプロキシを有効にします。ポートが使用中の場合は、再インストールを繰り返すのではなく、ポートを使用しているプロセスを確認しましょう。
ダウンロードへ →クライアント / OSから選ぶ
すべてのクライアントを見る →macOS
Apple SiliconまたはIntelに合ったインストーラーを選びます。初回起動後、OSが求める権限を許可し、まず設定を追加してシステムプロキシをテストしてください。より多くのアプリの通信を制御する場合は、サービスコンポーネントとTUNモードに必要な権限を確認しましょう。
ダウンロードへ →Android
スマートフォンやタブレットではモバイル向けクライアントを選んでください。Clash Verge Revはデスクトップ向けです。ダウンロードセンターで対応アプリを確認し、互換性のあるサブスクリプションを追加してVPN接続を許可します。バックグラウンド接続では、OSのバッテリー管理設定にも注意してください。
ダウンロードへ →iOS
iPhoneまたはiPadでClash PlusのApp Storeページを確認できます。モバイル版はデスクトップ版と画面構成が異なるため、追加前にサブスクリプション形式の対応状況を確認してください。接続時はOSの案内に従ってVPN構成を追加し、ルールとプロキシグループの選択も確認しましょう。
ダウンロードへ →Linux
ディストリビューションのパッケージ形式に合ったデスクトップ版を選び、インストール前に依存関係を確認してください。GUI環境ではクライアントから設定を管理できます。サーバーやルーターでは、ダウンロードセンターのMihomoセクションを参照し、サービスと権限を個別に設定してください。
ダウンロードへ →クライアント、サブスクリプション、プロキシサービスはそれぞれ別のものです。クライアントをインストールすると実行環境が整い、サブスクリプションからノードやプロキシグループ、ルールなどの設定を取得します。実際に接続できるかどうかは、サービスの稼働状況にも左右されます。インストーラーはOS、次にアーキテクチャを確認して選びましょう。サブスクリプションは形式と、設定に必要なコア機能を確認してください。
旧クライアントから移行する場合は、まず既存の設定をエクスポートし、ポート、プロキシモード、手動で変更した内容を控えておきましょう。新しいクライアントの初回起動時は設定を1つだけ有効にし、接続できることを確認してからオーバーライドやカスタムルールを移行します。問題が起きた場合に、インストール環境、サブスクリプション、ローカル設定のどこに原因があるか切り分けやすくなります。
サブスクリプション・プロキシ・ルール設定
操作対象ごとに画面の一部を紹介します。スイッチは説明用の表示です。実際の設定はクライアントで行ってください。
画面 / 設定 / サブスクリプション管理
サブスクリプションの追加と設定の切り替え
設定画面にサブスクリプションURLを貼り付けて追加し、ダウンロードが完了したら該当する設定を選びます。次にプロキシ画面でプロキシグループを確認してください。コアの設定ファイルを直接編集する方法と比べ、GUIではサブスクリプションの取得元と現在の有効状態をまとめて確認できるため、複数の設定を日常的に管理するのに便利です。追加できても接続できるとは限りません。形式やノード情報、プロキシグループの選択も確認しましょう。リモートサブスクリプションの更新で元の内容が置き換わることがあるため、長く使うルールはローカルオーバーライドで管理してください。画面を共有する際は、URLに含まれる個人識別情報を隠しましょう。
サブスクリプションの追加手順を見る →画面 / 設定 / システムプロキシ
システムプロキシと混合ポート
システムプロキシを有効にすると、OSのプロキシ設定に対応したアプリがクライアントの待ち受けアドレスを使います。混合ポートはHTTPとSOCKSの両方の接続を受け付けます。例ではポート番号を7897としていますが、実際の値は設定画面で確認してください。初めて使うときはシステムプロキシを有効にして、ブラウザーから目的のサイトにアクセスします。ターミナルや独自のプロキシ設定を使うアプリには、別途設定が必要な場合があります。TUNモードより通信を制御する範囲が明確で、初期設定やトラブルの切り分けも簡単です。ポートを変更したら、アプリ内のプロキシアドレスも確認してください。クライアントを終了する前に、システムプロキシが元に戻っていることも確認しましょう。
システムプロキシの設定を見る →画面 / ルール / マッチ順
ルールのマッチングとプロキシグループの選択
ルールモードでは、設定に記載された順に接続を判定し、通常は最初に一致したルールに従って処理します。ルールが指定するプロキシグループでは、さらに使用するノードを選びます。この2つは別の設定です。すべての通信を同じ経路に流すのではなく、ルールによってドメインごとに直接接続やプロキシ接続を使い分けられます。ルールを追加したら、対象ドメインとプロキシグループ名が正しいか確認し、個別のルールをフォールバック用ルールより前に配置してください。想定どおりにアクセスできない場合は、接続画面でマッチしたルールとプロキシチェーンを確認しましょう。サイトが開くかどうかだけでは、設定が適用されたか判断できません。
ルールとプロキシグループの設定を見る →画面 / 設定 / TUNモード
仮想ネットワークインターフェースで通信を制御
TUNモードは仮想ネットワークインターフェースを通じて通信を処理するため、システムプロキシに従わないアプリにも使えます。システムプロキシとの違いは通信を取り込む経路であり、サブスクリプションを置き換えたり、ノードを自動で用意したりする機能ではありません。有効にする前に通常のプロキシ接続が使えることを確認し、クライアントの案内に従ってサービスコンポーネントと必要な権限を準備してください。ほかのVPNや仮想ネットワークインターフェース、企業向けネットワークツールを併用している場合は、ルートの競合に注意しましょう。通信できなくなったら、まずTUNを無効にして比較し、DNS、自動ルート、インターフェースの選択を確認してください。一度に変更するのは1項目にして、ネットワークを復旧できる元の設定を残しておきましょう。
TUNとFake-IPの説明を見る →設定 / dns / enhanced-mode
ドメイン解決とルールの連携
DNSはドメイン名の解決方法を決め、宛先IPに基づくルール判定にも影響します。MihomoのDNS設定は、実際に通信を取り込む方法と合わせて考える必要があります。上流DNSサーバーを入れ替えただけで問題が解決したとは限りません。Fake-IPはドメイン名に仮想アドレスを割り当てる仕組みで、実際のアドレスを返す通常の名前解決とは動作が異なります。変更前に拡張モード、上流サーバー、フィルター項目を記録し、同じドメイン名で比較してください。一部のアプリだけで問題が起きる場合は、アプリ独自の暗号化DNSやキャッシュを先に確認しましょう。複雑なパラメーターの用途や相互関係は、応用設定で項目ごとに確認できます。
DNS設定の最適化を見る →画面 / 接続とログ / 問題の切り分け
接続履歴とエラーの確認
接続画面では、通信がコアに届いているか、どのルールにマッチしたかを確認できます。ログ画面では、設定の読み込みや解析の失敗、接続エラーを確認できます。ノードを何度も切り替えるだけでなく、これらの情報を使って問題の範囲を絞り込みましょう。発生時刻と宛先ドメインを記録してから再現し、該当する記録を探します。必要な場合だけログレベルを一時的に上げ、情報を集めたら通常の設定に戻してください。情報が多すぎると確認しづらくなります。問題を外部に報告する前に、サブスクリプションURL、認証情報、個人的なアクセス履歴を削除し、再現手順と試した操作を添えましょう。
よくあるログエラーを見る →初めての設定：追加・選択・確認
まず再現可能な接続手順を1つ確立します。基本設定が正常に動作することを確認してから、オーバーライド、ルールセット、TUN設定を追加しましょう。
-
有効なサブスクリプションを追加する
クライアントをインストールして起動し、設定画面でサービス提供元から受け取ったサブスクリプションURLを貼り付けます。追加が完了したら、その設定を選択してください。URLの配信内容がクライアントに対応している必要があります。Webページの共有URLがサブスクリプションURLとは限りません。ローカルファイルを使う場合は、ノード一覧だけでなく、完全なClash YAML設定ファイルであることを確認しましょう。
初回テストでは、有効な設定を1つだけにします。解析に失敗した場合は、エラーが示すフィールドや行番号を確認し、インデントと形式を見直してください。ポート、DNS、ルールを一度に変更するのは避けましょう。
-
プロキシグループを選んでプロキシを有効にする
プロキシ画面で、サブスクリプションのプロキシグループが表示されていることを確認し、手動選択が必要なグループにはノードを指定します。初回はルールモードのまま、設定画面でシステムプロキシを有効にしてください。プロキシグループ名は設定によって異なり、サブスクリプションごとに構成も違うため、名前だけで実際の接続先を判断することはできません。
まずはシステムプロキシに対応したブラウザーでテストします。アプリに独自のプロキシ設定がある場合は、古いクライアントのポートを参照していないか確認してください。問題を段階的に切り分けるため、ほかの通信制御機能はまだ有効にしないでおきましょう。
-
接続画面で結果を確認する
目的のサイトにアクセスしたあと、接続画面で宛先ドメイン、マッチしたルール、プロキシチェーンを確認します。サイトが開いたとしても、そのアクセスが完了したことを示すだけで、通信が想定した経路を通った証拠にはなりません。該当する接続が見つからない場合は、アプリがシステムプロキシに従っているか、追加した設定が現在使われているかを確認してください。
接続記録があるのにアクセスできない場合は、ログで名前解決や接続のエラーを確認します。同じドメイン名をテストに使い、設定を1つずつ変更することで、ルール、ノード、ローカル環境のどれが原因か判断しやすくなります。
設定前に知っておきたい3つの違い
- サブスクリプションURLと設定ファイル
- サブスクリプションURLはリモート設定を取得するための入口で、設定ファイルはクライアントが実際に読み込む内容です。リモート設定は更新時に再取得され、ローカルファイルは自分で管理する必要があります。形式を変換する前に、サービス提供元がクライアント対応のサブスクリプションを用意していないか確認しましょう。完全な設定をノード一覧だけに変換してしまうことがあります。
- ルールモードとグローバルモード
- ルールモードではルール一覧に基づいて通信の処理方法を選び、グローバルモードでは通常、すべての通信をグローバルプロキシグループに送ります。どちらのモードも有効なノードと設定が必要です。モードの切り替えは比較テストに使えますが、ルールの順序、プロキシグループの選択、接続先の記録を確認する代わりにはなりません。
- システムプロキシとTUNモード
- システムプロキシは、アプリ側が該当する設定に対応している必要があります。TUNモードは仮想ネットワークインターフェースを通じて通信を取り込みます。ブラウザーでは正常なのにほかのアプリで問題が起きる場合は、まずアプリごとの接続方式を確認しましょう。TUNモードには権限、ルート、DNSの設定が関わるため、通常のプロキシが動作することを確認してから設定してください。
プロジェクト情報 / ソースコードとコア
Clash Verge Rev オープンソースプロジェクト
プロジェクトの成り立ちとデスクトップUI
Clash Verge Revは、Clash Vergeのデスクトップクライアントとしての路線を引き継ぎ、GUIからサブスクリプション、プロキシ設定、接続、各種設定を管理できます。プロジェクトを理解するには、クライアントの画面とプロキシコアを分けて考えることが大切です。設定画面では設定の取得元を管理し、各種設定ではデスクトップとの連携を行います。ネットワーク通信のルール判定やプロトコル処理は、主にコアが担います。古いガイドではボタンの位置が現在の画面と異なる場合があります。機能を探すときは、スクリーンショットの位置を頼りにするのではなく、操作の目的から探しましょう。
Mihomoコアと設定の互換性
MihomoはClash設定のエコシステムに属し、プロキシプロトコル、プロキシグループ、ルール、DNSなどの機能を提供します。クライアントはこれらの機能をデスクトップの操作画面につなぎますが、設定ファイルの各項目に個別のスイッチがあるとは限りません。サブスクリプションの内容に由来する設定、クライアントが生成する実行時設定、ローカルオーバーライドによる変更があります。設定と画面の表示が一致しない場合は、まず現在有効な設定を確認し、マージ後の内容を調べてください。Clash Metaのガイドを参照するときは、コアの更新状況と各フィールドの対応状況にも注意が必要です。異なるクライアントの画面操作をそのまま置き換えることはできません。
GPL-3.0ライセンスとソースコード
このプロジェクトのソースコードはGPL-3.0ライセンスで公開されています。機能の実装を調べる場合は、リポジトリの説明、ソースコード、Issueの記録を参照してください。変更や再配布を行う際は、ライセンスに定められた義務を確認しましょう。オープンソースは、コードを閲覧・議論し、改善に参加できる基盤を提供しますが、あらゆるネットワーク環境で同じ動作を保証するものではありません。実際に利用する際は、OS、サービスコンポーネント、設定の取得元、ネットワーク環境を確認してください。問題を報告する際は、「接続できない」と伝えるだけでなく、再現手順を明確にし、機密情報を削除したログを添えると役立ちます。
クライアント・コア・サブスクリプションは個別に更新
クライアント、コア、リモートサブスクリプションの更新は、それぞれ異なるレイヤーに影響します。クライアントの更新では画面やOS連携が変わる場合があり、コアの更新ではプロトコルや設定フィールドに影響することがあります。サブスクリプションの更新ではノード、ルール、プロキシグループの内容が変わります。アップデート前に現在使える設定を保存し、リリースノートを読み、ローカルオーバーライド、ポート、サービス設定を記録しましょう。更新後はまず従来の接続手順を試し、ルール判定とアプリの接続が正常なことを確認してから新機能を試してください。特定のサブスクリプションだけに問題がある場合は、すべてのコンポーネントをすぐに戻すのではなく、設定内容を先に確認しましょう。
ソースコードとリリースノートを見る →ソースコードリポジトリ / git clone
git clone https://github.com/clash-verge-rev/clash-verge-rev.git通常利用とソースコードからのビルド
通常利用の場合は、ダウンロードセンターからインストーラーを選んでください。リポジトリのクローンは、実装の確認、変更の提出、自分でのビルドに適していますが、インストールまで自動で行うものではありません。ソースからビルドするには、ツールチェーン、依存関係、OS環境の準備も必要です。具体的な手順は、リポジトリの最新ドキュメントを確認してください。
サブスクリプションの内容とローカル変更
サブスクリプションには通常、ノード、プロキシグループ、ルールが含まれ、更新時に元の内容が上書きされることがあります。カスタムルールを継続して使う場合は、クライアントのオーバーライド機能を確認し、更新のたびに手作業で変更し直すことがないようにしましょう。ルールが参照するプロキシグループ名は、設定内に存在している必要があります。複数のサブスクリプションを統合する場合は、グループ名の重複、重複ノード、ルールの順序にも注意してください。設定を変更したら、正常に読み込まれたことを確認し、接続画面で実際のマッチ結果を検証しましょう。
トラブルの記録とプライバシー保護
トラブルの切り分けでは、OS、ネットワーク接続方法、有効にしているプロキシモード、エラーの発生時刻を記録すると役立ちます。設定ファイルやログには、サブスクリプションURL、サーバーアドレス、認証情報、アクセスしたドメインが含まれることがあります。公開する前に項目ごとに機密情報を削除してください。問題を説明するための最小限の設定には、必要なフィールドだけを残しましょう。個人用のサブスクリプション全体を公開の場に貼り付けたり、一時的なデバッグ設定を普段の設定に残したりしないでください。
応用設定ガイドへ →設定ファイルとトラブル対処の記事
問題に合わせて記事を選べます。形式がわからない場合はサブスクリプション、設定の読み込みに失敗する場合はYAML、起動時に問題が起きる場合はポートの記事を確認してください。
ClashのYAML設定ファイルを項目別に解説：mixed-portからrulesまで
mixed-port、dns、proxies、proxy-groups、rule-providers、rulesの各項目を順に解説し、よくあるインデントエラーも紹介します。
サブスクリプションの追加を済ませ、設定ファイルの内容を確認したい方におすすめです。まずトップレベルの項目とリストの階層を把握し、変更が必要なのは待ち受けポート、名前解決の方法、ルールの参照先のどれかを見極めましょう。関連する設定を見落として、一部の断片だけをコピーしないよう注意してください。
記事を読む →混合ポート7897が使用中：プロセスを特定して待ち受けポートを変更する方法
Windows、macOS、Linuxでコマンドを使ってポートを使用中のプロセスを特定し、クライアントの設定で混合ポートを変更してシステムプロキシを合わせる方法を解説します。
待ち受けに失敗する場合や、クライアントの切り替え後に接続できない場合に役立ちます。まずポートを使用しているプロセスを確認し、終了が必要か判断してからポートを変更します。最後に、ブラウザー、ターミナル、ほかのアプリが古いプロキシアドレスを使っていないか確認してください。
記事を読む →サブスクリプションをクライアントに追加する3つの方法とYAML・Base64形式の違い
URLの貼り付け、ローカルファイルの読み込み、QRコードの3つの追加方法を解説。Clash YAMLとBase64形式のノード一覧の違いや、更新間隔の設定も紹介します。
追加方法はクライアントによって異なります。まず利用中のアプリがどの方法に対応しているか確認し、次にサブスクリプションが実際に返す内容を調べましょう。リンクを開いてWebページやエラーメッセージが表示される場合は、拡張子を何度も変えるのではなく、取得元を見直してください。
記事を読む →