クライアント / インストーラー / アーキテクチャ
OSを選び、CPUアーキテクチャを確認してください。GUIクライアントは日常的な設定と接続に、単体のmihomoコアは自分で環境を構築する場合に使用します。
Windows / x64
現在、GUIインストーラーはx64が中心です。「設定 → システム → 詳細情報」でシステムの種類を確認してから、クライアントを選んでください。
GUIからサブスクリプションの管理、プロキシモードの選択、接続状況の確認を行いたい方に適しています。ダウンロード後にインストーラーを実行し、画面の案内に従ってインストールしてから、既存の設定を読み込んでください。インストールしただけではシステムプロキシは有効になりません。クライアントの稼働状況とプロキシ設定を確認しましょう。
初回はルールモードで基本的な接続を確認してから、必要に応じてTUNを有効にしてください。他のプロキシアプリを使用中の場合は、どのアプリがシステムプロキシを管理するか確認し、複数のクライアントが同じ設定を同時に変更しないようにしましょう。
複数の設定、プロキシグループ、ルールを管理したいデスクトップユーザーに適しています。インストール後、設定を選択し、ログで正常に読み込まれたことを確認してからシステムプロキシを有効にしてください。設定の編集とサブスクリプションの更新は別の操作です。更新すると、リモート設定の内容が置き換わる場合があります。
サービスモードやTUNを使用する場合は、アプリの案内に従って権限を設定してください。サービスが起動しないときは、サービスの状態とセキュリティソフトの通知を確認しましょう。設定内のネットワーク関連のスイッチをすべて一度に有効にするのは避けてください。
通常のデスクトップ利用にはインストーラー、自分でアプリの保存先を管理したい場合はZIP版が適しています。ZIP版はすべて展開してから起動し、圧縮ファイルのプレビュー画面から直接実行しないでください。アプリ本体と設定ファイルの保存場所は異なる場合があります。
アップデート前に、現在使用できる設定を保存してください。旧プロセスを終了してからアプリのファイルを置き換えます。別のクライアントへ移行する場合は、プロキシグループの選択とシステムプロキシのポートを改めて確認してください。画面上の似た項目名だけで設定が引き継がれたと判断しないようにしましょう。
GUIから設定の切り替えや動作状況の確認を行いたい方に向けた、デスクトップ用の設定管理クライアントです。設定を読み込んだ後、使用中のコアを確認し、コアが対応していない項目やプロトコルが設定に含まれていないかチェックしてください。
システムプロキシの設定が適用されるのは、その設定に従うアプリだけです。個別にプロキシ設定が必要なアプリもあれば、TUNで通信を取り込む必要がある場合もあります。まず通信の経路を確認し、必要な範囲だけを取り込むようにしましょう。
旧設定からの移行、過去の画面の確認、既存環境の再現に利用できます。アーカイブ版はメンテナンスが終了しているため、新しいプロトコルやルール形式、OSへの対応が今後も続くとは限りません。初めてインストールする場合は、上記のメンテナンス中のクライアントを優先してください。
移行前にローカル設定をエクスポートし、ポート番号とプロキシグループの選択内容を記録してから、新しいクライアントで一つずつ確認してください。旧アプリのデータフォルダを新しいアプリのフォルダに丸ごとコピーするのは避けましょう。画面の状態や設定の保存形式が異なる場合があります。
| 確認項目 | 選び方 |
|---|---|
| OSバージョン | サポートが継続しているWindows 10 / 11を推奨します。最低バージョンは、選択したクライアントのリリースノートで確認してください。 |
| CPU | このページのインストーラーはx64向けです。Windows on ARMでエミュレーション実行できても、ARM64ネイティブ対応を意味するわけではありません。 |
| 実行権限 | 通常の設定操作と、TUNやサービスのインストールに必要な権限は異なります。後者では管理者の許可が必要になる場合があります。 |
macOS / ARM64 · x64
「このMacについて」でチップの種類を確認してください。Apple SiliconではARM64と明記されたビルドを、Intel搭載Macではx64を選びましょう。
Apple Silicon用とIntel用のインストーラーを提供しています。ディスクイメージを開き、アプリを「アプリケーション」フォルダに移動してから起動してください。マウントしたイメージから起動し続けないようにしましょう。初回起動時は、システムの案内に従って必要な権限を許可してください。
設定を読み込んだら、使用する設定が選択されていることを確認してからシステムプロキシを設定してください。より広範囲の通信を取り込む場合は、ネットワーク機能拡張、補助サービス、TUNの権限についてクライアントの説明を確認しましょう。
サブスクリプション、ルール、デスクトップのプロキシ状態を管理する用途に適しています。現在、どちらのアーキテクチャ用リンクも同じx64表記のファイルを指しており、後者もARMネイティブ版ではありません。Apple Silicon搭載Macでは、Rosettaでの動作条件を確認してください。
インストール後、補助サービスが正常に動作しているか確認してください。システムプロキシを有効にしてもブラウザーが直接接続する場合は、ローカルの待ち受けポートとシステムプロキシのポートが一致しているか確認し、接続ログを確認しましょう。
FlClashの設定方法を使い続けたいデスクトップユーザーに適しています。現在、どちらのリンクもAMD64ファイルを指しています。Apple Silicon搭載Macでは互換動作に対応しているか確認してください。ネイティブ版が必要な場合は、上記のARM64表記のインストーラーを選びましょう。
アップデート前に起動中の旧プロセスを終了し、「アプリケーション」内のファイルを置き換えてください。サブスクリプションのURLとローカルの上書き設定を保持し、更新後にプロキシグループの選択を再確認しましょう。設定の問題を解決するために何度も再インストールする必要はありません。
既存環境の確認や設定移行に使うアーカイブ版です。現在、どちらのアーキテクチャ用リンクも同じx86_64ファイルを指しています。Apple Siliconで使用する前に互換性を確認してください。メンテナンス終了版は、新しいOSやプロトコルに対応するクライアントとして推奨できません。
他のクライアントに移行する際は、旧アプリのシステムプロキシを無効にしてから新しいアプリを有効にしてください。元のYAMLは参照用に残し、新しいコアの対応状況に合わせて項目を調整しましょう。旧設定をすべてそのまま引き継ぐのは避けてください。
| 確認項目 | 選び方 |
|---|---|
| OSバージョン | 最低対応macOSバージョンはクライアントごとに異なります。インストール前にリリースノートとシステムの案内を確認してください。 |
| チップの種類 | Apple MシリーズはARM64、Intelはx64です。互換版のリンクがあっても、ARMネイティブビルドが提供されているとは限りません。 |
| インストール先 | アプリを「アプリケーション」フォルダに移動してください。ネットワーク関連の権限は、システムとクライアントの案内に従って設定します。 |
Android / ARM64 · ARM
最近のスマートフォンの多くはARM64です。初回接続時にVPN権限の許可が必要です。バックグラウンドでの安定性は、OSの省電力設定にも左右されます。
スマートフォンからサブスクリプションの読み込み、モード選択、接続管理を行いたい方に適しています。このリンクはARM64向けです。インストールできない場合は、同じファイルを何度もダウンロードするのではなく、端末のアーキテクチャとOSバージョンを確認してください。
初回接続時にAndroidからVPN接続の許可を求められます。許可後、通知欄とクライアントの状態を確認して、実際に通信できるかテストしてください。バックグラウンドで継続して使う場合は、端末の設定でバックグラウンド動作を許可し、バッテリー最適化の対象外にしてください。
アーキテクチャに合ったアプリを導入し、Clashの設定やプロキシ状態を管理したいAndroidユーザーに適しています。ARM64とARM 32ビットは別のビルドです。端末のアーキテクチャが不明な場合は、システム情報を確認してからユニバーサル版を検討してください。
サブスクリプションを読み込んだら、設定のダウンロードが完了するまで待ち、その設定を選択してサービスを起動してください。VPNの許可は、OSがローカルの通信経路の確立を認めたことを示すだけで、リモートプロキシへの接続を保証するものではありません。プロキシグループと接続ログも確認しましょう。
ARM64、ARM 32ビット、x86_64向けのインストーラーを用意しています。システム情報に「64ビット」と表示されていても、一般的なARMスマートフォンにx86_64版は使えません。x86_64版は主に対応アーキテクチャの端末やエミュレーター向けです。
他のクライアントから切り替える前に、使用中のVPN接続を停止してください。通常、AndroidのVPN接続は同種のアプリで同時に使用できません。許可画面が何度も表示されたり、接続が切り替わったりする場合は、別のVPNアプリが動作していないか確認しましょう。
Clash YAMLとは異なる設定形式を採用しています。対応するサブスクリプションをすでに利用している方や、専用の構文に慣れている方に適しています。一般的なClash設定をそのままSurfboardに読み込めるとは限らないため、サブスクリプションの提供元が出力する形式を確認してください。
設定を変換する場合は、ルールの種類、プロキシグループ、プロトコルの対応状況の違いに注意してください。読み込めても、すべての項目が同じ意味で維持されるとは限りません。初回接続後に重要なルールとアプリの通信動作を一つずつ確認しましょう。
| 確認項目 | 選び方 |
|---|---|
| OSとアーキテクチャ | クライアントが対応するAndroidバージョンを確認してください。arm64-v8aはARM64、armeabi-v7aはARM 32ビットです。 |
| インストール権限 | ブラウザーやファイル管理アプリからAPKをインストールする場合は、システムの案内に従って、そのアプリにインストール権限を許可してください。 |
| 実行権限 | 初回接続にはVPNの許可が必要です。バックグラウンドで切断される場合は、バッテリー最適化、バックグラウンド動作、自動起動の制限を確認してください。 |
iOS / App Store
App Storeで端末との互換性を確認してインストールしてください。対応するOSバージョンは、ストアの商品ページに表示される最新情報を確認してください。
App Storeの商品ページからインストールを開始します。インストール後にアプリを開き、利用権限のあるサブスクリプションまたは設定を読み込んでください。初回接続時は、iOSの案内に従ってVPN構成の追加を許可します。必要に応じて、端末の認証を行ってください。
接続状態とプロキシポリシーは別々に確認してください。システムにVPN接続済みと表示されても、通信が意図どおり振り分けられるとは限りません。現在のモード、設定のルール、選択中のポリシーを確認しましょう。
アプリのアップデートはApp Storeで管理されます。端末を変更する前に、サブスクリプションと必要なローカル設定を記録してください。再インストール後は基本的な接続を確認してから、アプリ別やドメイン別の通信振り分け設定を戻しましょう。
| 確認項目 | 選び方 |
|---|---|
| 互換性 | App Storeの商品ページで、最新の最低システム要件と対応端末を確認してください。 |
| インストール方法 | App Storeからインストールとアップデートを行い、インストール後にアプリで設定を読み込みます。 |
| 接続の許可 | 初回利用時はシステムの案内に従ってVPN構成を追加し、現在のポリシーとルールモードを確認してください。 |
Linux / AMD64
デスクトップではディストリビューションに合わせてDEBまたはRPMを選んでください。GUIのないサーバーでは、下記のコア単体の利用を検討してください。
DEBは主にDebian、Ubuntuおよびその派生ディストリビューションで使われます。RPMはFedoraやopenSUSEなど、対応するパッケージ管理方式を採用したディストリビューション向けです。パッケージ形式だけでなく、デスクトップ用ランタイムとOSバージョンも要件を満たしているか確認してください。
インストール後はデスクトップのアプリ一覧から起動し、設定とコアの状態を確認してください。ターミナルのアプリがデスクトップのシステムプロキシを参照するとは限りません。各ツールの対応状況に応じて、プロキシ環境変数を設定してください。TUNの利用には追加のルーティング設定と権限が必要です。
このページではAMD64デスクトップ向けのDEBパッケージを提供しています。インストール前に、ディストリビューションが対応するパッケージ管理方式を採用しているか確認し、依存関係はシステムのパッケージマネージャーで処理してください。ARM64端末ではこのAMD64インストーラーを使用できません。
起動時に実行する場合は、デスクトップへのログイン後に起動する設定と、システムサービスを分けて考えてください。前者はグラフィカルセッションに依存し、後者には個別の権限と実行ディレクトリの設定が必要です。サーバー用途ではコア単体の導入が適している場合があります。
| 確認項目 | 選び方 |
|---|---|
| CPU | uname -mでアーキテクチャを確認します。x86_64は、このページのAMD64向けGUIインストーラーに対応します。 |
| ディストリビューション | パッケージ管理方式に合わせてDEB / RPMを選んでください。依存関係と最低対応ディストリビューションは、クライアントの説明を確認しましょう。 |
| 実行環境 | GUIクライアントの実行にはデスクトップ環境と関連ライブラリが必要です。GUIのないサーバーではコア単体の利用を検討してください。 |
core / mihomo
サーバー、ルーター、サービスを自分で管理する方向けです。一般的なデスクトップやスマートフォンでは、上記のGUIクライアントを優先してください。
コアは設定の読み込み、ルールの照合、プロキシ接続を担いますが、デスクトップ向けの設定管理機能は備えていません。使用前にconfig.yaml、実行ディレクトリ、起動方法を用意してください。起動時に実行する場合は、システムサービスも設定します。圧縮ファイルを展開して得られる実行ファイルは、端末のOSとCPUアーキテクチャに合ったものを選んでください。
Linuxルーターでは、ファームウェア、命令セット、実行環境も確認してください。MIPS-softfloatは該当するソフトウェア浮動小数点方式の環境向けであり、すべてのMIPS端末で使えるわけではありません。TUNを有効にする前にルーティング変更の範囲を把握し、リモートサーバーを操作する際は既存の管理用接続を維持してください。
config.yamlの設定項目を見る →| OS | アーキテクチャ | ファイル形式 | ダウンロード |
|---|---|---|---|
| Windows | AMD64 / x64 | ZIP | AMD64版をダウンロード |
| Windows | ARM64 | ZIP | ARM64版をダウンロード |
| macOS | Intel / AMD64 | GZ | Intel版をダウンロード |
| macOS | Apple Silicon / ARM64 | GZ | Apple Silicon版をダウンロード |
| Linux | AMD64 | DEB | DEB版をダウンロード |
| Linux | AMD64 | GZ | AMD64版をダウンロード |
| Linux | ARM64 | GZ | ARM64版をダウンロード |
| Linux | ARMv7 | GZ | ARMv7版をダウンロード |
| Linux | MIPS-softfloat | GZ | MIPS版をダウンロード |
ダウンロードでアプリを導入し、設定とシステム権限でプロキシに流す通信を決めます。
クライアントの変更やアップデート前に、現在使用できるサブスクリプションURL、ローカルのYAML、上書き設定、必要なプロキシグループの設定を保存してください。サブスクリプションには認証情報が含まれる場合があるため、スクリーンショットや問い合わせ記録で公開しないようにしましょう。新しいクライアントで設定を読み込めたら、よく使う通信を確認してから旧環境を停止してください。
初回は「設定を読み込む → 設定を選択 → ルールモードとポリシーを選ぶ → プロキシを有効にする → ログを確認する」の順に進めます。アプリをインストールしただけではプロキシサービスは利用できません。また、プロトコル、ルール形式、設定項目の違いにより、別世代のコアでは既存設定を読み込めない場合があります。詳しくはClashの使い方ガイドをご覧ください。
システムプロキシ、AndroidやiOSのVPN許可、デスクトップのTUN、バックグラウンドサービスは、それぞれ別の設定です。まず最小限の設定で接続を確立し、必要に応じて通信を取り込む範囲を広げてください。問題が発生したら、ログの時刻、エラーの種類、実行した操作を記録しましょう。DNS、ルーティング、プロキシモードを一度に変更すると、原因を特定しにくくなります。
アーキテクチャ、互換性、用途に合わせたインストーラーの選び方を解説します。
Windows、macOS、Android、iOSではClash Plus、LinuxではClash Verge Revをまず確認してください。OSとCPUアーキテクチャを確認してからインストーラーを選びます。既存の設定を引き継ぐ場合は、クライアントのコアが使用中のプロトコルや設定項目に対応しているかも確認しましょう。
ARM64とx64は異なるCPUアーキテクチャです。AMD64も一般にx64を指します。Androidのarmeabi-v7aは32ビットARM向け、ユニバーサル版には複数のアーキテクチャ向けコンポーネントが含まれます。端末のメーカー名だけで判断せず、システム情報とインストーラーの対応アーキテクチャを確認してください。
掲載中のClash Verge RevとFlClashは、macOS向けのどちらのリンクもx64またはamd64表記のファイルに対応しています。ClashX Metaもx86_64ファイルです。ARMネイティブ版という意味ではありません。Apple Silicon搭載Macでは、Rosettaでの動作に対応しているか確認するか、ARM64と明記されたインストーラーを選んでください。
旧版は引き続き動作する場合がありますが、新たなメンテナンスやコア機能が提供されるわけではありません。主に旧環境の再現や、移行前に既存設定を確認する用途に適しています。新規インストールにはメンテナンス中のクライアントを選び、移行前に設定をエクスポートして、ルール、プロキシグループ、サブスクリプションの互換性を確認してください。
インストーラーに含まれるのはクライアントアプリであり、すぐに使えるプロキシサービスは付属しません。インストール後、利用権限のあるサブスクリプションまたは設定を読み込み、プロキシモードとポリシーを選択します。さらに、OSに応じてシステムプロキシを有効にするか、VPN権限を許可してください。TUNで通信を取り込む場合は、追加の権限が必要になることがあります。
サーバー、ルーター、コンテナで運用する場合や、サービスの起動を自分で管理する場合は、コア単体が必要になることがあります。一般的なデスクトップやスマートフォンでは、GUIクライアントをインストールしてください。コア単体を使うには、設定ファイル、実行ディレクトリ、権限、サービス管理方法を自分で用意する必要があり、クライアント画面の機能をすべて代替するものではありません。