Clash 全プラットフォーム対応のインストール・設定
初めて接続する場合は、クイックスタートに沿って設定の追加、グループ選択、動作確認を行ってください。設定済みの方や、端末を移行する方、通信がクライアントを経由しない原因を調べたい方は、本ガイドの該当する章をご覧ください。各章はダウンロード、インストール、設定の追加、通信の取り込み、動作確認の順にまとめています。
共通の事前準備:アプリ、設定、通信の取り込み方法
端末と利用範囲を確認する
クライアントをダウンロードから、OSに合ったアプリを選んでください。初めて使う場合は、そのプラットフォームで利用できるClash Plusがおすすめです。LinuxではClash Verge Revも候補になります。既存の設定を移行する場合は、製品名だけで判断せず、新しいクライアントが元のプロトコル、プロキシグループ、ルールセットに対応しているか確認してください。旧端末で安定して使えている設定があるなら、新端末での動作確認が済むまで、旧クライアントと設定を残しておきましょう。
インストール前に、テストするアプリを決めておきます。ブラウザーなど一部のアプリだけをプロキシ経由にするなら、システムプロキシかアプリ独自のプロキシ設定を使います。プロキシ設定を参照しないアプリも通信させる場合は、デスクトップではTUN、モバイル端末ではVPNを検討してください。同じルールを読み込んでも、通信を取り込む範囲は端末によって異なります。通信がまずクライアントに届いてから、ルールに従って直接接続、プロキシ経由、または拒否に振り分けられます。クライアントに届いていないリクエストは、ルールのログにも表示されません。
| 取り込み方法 | 最初に確認すること | よくある制約 |
|---|---|---|
| システムプロキシ | システムに設定されたアドレスとポートがクライアントの表示と一致しているか | アプリ独自のプロキシ設定が使われ、システム設定が参照されない場合がある |
| デスクトップTUN | 仮想ネットワークインターフェース、権限、ルーティング、DNSが正常か | LAN、企業VPN、仮想ネットワークに影響する場合がある |
| モバイルVPN | システムの許可、現在の接続、対象アプリの範囲 | 同じユーザーまたはプロファイル内で、VPN同士が通信の取り込み権限を競合する |
サブスクリプションURLとローカル設定を区別する
リモートサブスクリプションは、クライアントが定期的に設定を取得するためのURLです。ローカル設定は、端末上に保存されたファイルです。リモートURLを追加する際は、配信元がクライアントで読み込める形式を提供しているか確認してください。ノード共有リンク、サービスの管理ページ、完全な設定ファイルは別のものです。ブラウザーでURLを開けても、クライアントが内容を解析できるとは限りません。ブラウザーではログイン済みでも、クライアントからのアクセスにはログインページが返される場合があります。
サブスクリプションURLにはアカウントを特定できる情報が含まれることが多いため、パスワードと同様に管理してください。完全なURLを問い合わせ、スクリーンショット、共有ドキュメントに載せないでください。ローカル設定を移行するときは、メインの設定ファイルだけでなく、ルールセットやプロキシプロバイダーが参照するリソースも確認します。デスクトップ上のローカルパスは、通常スマートフォンには存在しません。キャッシュファイルが前回ダウンロードしたコピーにすぎない場合もあります。まず更新可能な元の設定を用意し、どのカスタマイズを新端末に移すか決めましょう。
ダウンロード、読み込み、起動を個別に確認する
設定を追加したら、一覧に新しい項目が表示されたか確認し、その項目を読み込んで現在の設定に選択します。クライアントによっては、インポートしても一覧に追加されるだけで自動的に有効にはなりません。サブスクリプションの更新時に設定が再読み込みされ、手動選択したノードが変わる場合もあります。プロキシグループに利用可能なメンバーがあること、ルールモードが選択されていることを確認してから、システムプロキシ、TUN、VPNを起動してください。初回テストの前に、設定項目を一度にすべて有効にするのは避けましょう。
動作確認では、直接接続する想定のドメインと、プロキシ経由にする想定のドメインを1つずつ選び、新しいリクエストを送ります。クライアントが対応していれば、接続ログの宛先、適用ルール、実際の送信先を照合してください。ルール全体の正しさを出口IPの変化だけで判断する必要はありません。出口IPが示すのは、確認サイトへの接続だけです。どちらのリクエストもログにない場合は、まず通信の取り込みを確認します。一方だけ送信先が違う場合は、ルールとプロキシグループを確認してください。
復旧できる基準状態を用意する
変更前にクライアントを停止し、現在のネットワークで普段使うWebページが開けることを確認します。企業プロキシ、専用DNS、業務用VPNが元から使われていたかも記録してください。基準状態でネットワークが正常でない場合は、まず接続を復旧します。原因を探すために複数のクライアントを次々と切り替えるのは避けましょう。公衆Wi-Fiに接続する場合は、通信の取り込みを始める前にログインページで認証します。認証前はページが開かず、サブスクリプションやノードの不具合のように見えることがあります。
Windows:システムプロキシとTUN
インストーラーを選び、旧クライアントを終了する
WindowsのダウンロードからClash Plusを入手してください。別のクライアントを検討する場合は、Clash Verge Rev、FlClash、Clash Nyanpasuも比較できます。Clash for Windowsは開発が終了したアーカイブ版です。新規インストールではなく、旧環境の確認用として扱ってください。ダウンロード前にWindowsの「設定」→「システム」→「バージョン情報」を開き、システムの種類とダウンロードページに記載されたアーキテクチャを確認します。ARM64の場合、デスクトップアプリが互換レイヤーで動作するかどうかと、仮想ネットワークインターフェースやサービスを正常にインストールできるかどうかは別の問題です。
インストール前に旧クライアントのシステムプロキシとTUNを無効にし、通知領域から終了してください。ウィンドウを閉じただけでは、画面が隠れるだけの場合があります。クライアントを2つ同時に起動すると、同じシステムプロキシ設定を互いに上書きしたり、同じローカルポートを取り合ったりすることがあります。インストール後は、まず通常の方法で一度起動してください。設定を追加するためだけに、クライアントを常に管理者として実行する必要はありません。ネットワークサービスのインストールが必要な場合は、該当操作を開始したときに表示されるシステムの許可を確認します。
設定を追加したら、まずシステムプロキシを確認する
クライアントの設定管理画面を開き、サブスクリプションまたはローカル設定を追加します。解析が終わったら、追加した設定を選択します。ルールモードに切り替え、プロキシグループのメンバーを選んでから、システムプロキシを有効にしてください。続いてWindowsの「設定」→「ネットワークとインターネット」→「プロキシ」で現在の状態を確認します。クライアントが手動プロキシを使う場合、システムに表示されるアドレスとポートがクライアントの表示と一致している必要があります。会社支給の端末でスクリプトによるプロキシ設定を使っている場合は、変更してよいか管理者に確認してください。
システムプロキシを通常どおり参照するブラウザーで対象ページを開き、クライアントのログと照合します。ブラウザーでは使えても、コマンドラインツールで使えないからといって、ノードに問題があるとは限りません。コマンドラインツールによっては環境変数や独自の引数を優先し、サービスの中にはWinHTTPを使うものもあります。次の読み取り専用コマンドでWinHTTPプロキシを確認できます。直結と表示されても、ブラウザーがプロキシ経由で通信している可能性はあります。ブラウザーとターミナルの確認手順は、システムプロキシの環境別トラブル対処をご覧ください。
netsh winhttp show proxy
ローカルの待ち受けを確認したい場合は、システム設定を変更せず、ツールにプロキシアドレスを個別に指定できます。ページ末尾のサンプル設定を読み込み、ローカルでその混合ポートを使っている場合は、次のコマンドを実行してください。このサンプルの送信先は直接接続です。HTTPレスポンスが返っても、リクエストをローカルの待ち受け経由で送れたことを示すだけで、リモートプロキシノードが有効とは限りません。自分の設定を使う場合は、クライアントに表示されているポートを指定してください。
curl.exe -I --proxy http://127.0.0.1:7890 https://example.com/
必要な場合に限りTUNを有効にする
対象アプリがシステムプロキシを参照しない場合は、システムプロキシを無効にして単独で確認してから、クライアントのTUN機能を有効にします。権限を求められたら、クライアントの手順に従ってサービスをインストールまたは有効化し、仮想ネットワークインターフェースとルートの準備が整うまで待ちます。新しいアプリ接続を作成してログを確認してください。切り替え前から続いているダウンロードや通話で動作を判断しないようにします。有効化後に通信できなくなったら、すぐにTUNを無効にして通常のネットワークが復旧するか確認し、サービスの起動エラーを調べます。
企業VPN、仮想マシン、コンテナーを同時に使っている場合は、組織のネットワークポリシーを変えずに共存できるか、まず確認してください。外部サイトは開くのに社内ドメインが開けない場合は、社内アドレスへの接続と名前解決を個別にテストし、ルートが取り込まれたのか、内部DNSにアクセスできなくなったのかを切り分けます。モードを切り替えるついでにネットワーク全体をリセットするのは避けましょう。変更点が分からなくなり、次回の再現が難しくなるうえ、元の接続を壊すおそれがあります。
スリープ復帰、ポート競合、終了後の残存プロセスに対処する
スリープ復帰後は、まずクライアントが動作中か確認してから、新しいリクエストを送ります。以前の接続のタイムアウトを設定不良と誤認しないためです。システムプロキシがローカルを指したままクライアントが終了していると、ブラウザーが接続できないことがあります。通信の取り込みを停止したら、システムプロキシを変更前の状態に戻してください。会社支給端末で、すべて直結に変更するのは避けましょう。ポートが使用中というログが出た場合は、そのポートを使う旧クライアントを終了するか、現在のクライアントのポートを変更します。手動でプロキシを設定しているツールがあれば、そちらも合わせて変更してください。
macOS:チップ、ネットワークサービス、スリープ復帰
チップに合ったアプリを選び、初回起動する
macOSのダウンロードでは、まずClash Plusを確認してください。設定との互換性に応じて、Clash Verge RevやFlClashも選べます。ClashX Metaは開発が終了しているため、移行前に元の設定をバックアップしてください。Appleメニューの「このMacについて」で、AppleシリコンかIntelプロセッサかを確認し、対応するアーキテクチャを選びます。互換レイヤーで画面が起動しても、ネットワークコンポーネントが同じ環境で動くとは限りません。対応アーキテクチャのインストーラーがある場合は、そちらを優先してください。
配布ファイルがディスクイメージの場合は、開いた画面の案内に従ってアプリを「アプリケーション」にコピーし、イメージ内のアプリを終了してから「アプリケーション」内のアプリを起動します。インストーラーパッケージの場合は、インストーラーの手順に従ってください。システムによって起動がブロックされた場合は、ファイルの入手元と警告の理由を確認し、システムが案内する手順で対処します。セキュリティ保護を全体的に無効にしないでください。アップグレード前に旧プロセスを完全に終了し、元の設定を残します。バックグラウンドで旧バージョンが動き続け、新しいアプリが無効だと誤解するのを防げます。
設定を追加し、現在使っているネットワークサービスを確認する
クライアントの設定管理画面からサブスクリプションまたはローカルファイルを追加し、現在の設定として選択します。移行したファイルが別の場所にあるルールセットを参照している場合は、参照先を解決してから通信の取り込みを有効にしてください。ルールモードとシステムプロキシを起動したら、「システム設定」→「ネットワーク」で、実際に接続に使っているサービスを選び、「詳細」→「プロキシ」を確認します。Wi-Fiと有線LANではプロキシ設定が別々の場合があります。ドッキングステーションを接続した直後は、Wi-Fiだけでなく現在使っている接続を確認してください。
まずブラウザーで、直接接続する想定の宛先とプロキシ経由の想定の宛先を開き、ログで適用ルールを比較します。ターミナルツールの結果が異なる場合は、ノードをすぐに変更せず、そのツールの環境変数や引数を確認してください。次の読み取り専用コマンドで動的プロキシ設定を確認できます。出力から分かるのは設定の登録状況であり、特定のプロセスが必ずその設定を使うという意味ではありません。ローカルの待ち受けを経由しているかどうかは、実際に新しいリクエストを送って確認します。
scutil --proxy
環境によっては、スクリプトがリクエストごとにプロキシの要否を判断する自動プロキシ設定が使われています。システムに自動設定と手動アドレスの両方がある場合、1つのスイッチだけで実際の経路を判断しないでください。元の設定を記録し、業務ネットワークで必要な項目を残したうえで、異なるドメインを使って比較します。会社の設定が管理プロファイルによって強制されている場合は、管理者に確認してください。システムが自動で戻す設定を何度も上書きしないようにします。
仮想ネットワークインターフェースを有効にする前に、条件を切り分ける
対象アプリがシステムプロキシを使わない場合は、現在のクライアントが対応するTUN機能を試します。クライアントによって使用するネットワークコンポーネントが異なるため、使用中のクライアントとシステムの案内に従って許可してください。別のクライアントの設定手順をそのまま使わないでください。システムプロキシが正常に使える状態を基準として残し、システムプロキシを無効にしてTUNだけをテストした後、アプリから新しい接続を作成します。これにより、ブラウザーが以前のプロキシ設定を使い続けて問題を隠すことなく、新しい経路自体を確認できます。
リモートプロキシには接続できるのに、LANプリンター、ファイル共有、社内サイトに問題がある場合は、LANアドレスと内部ドメインを別々に確認します。前者に接続できなければルートとネットワーク範囲を、後者だけ失敗するなら名前解決の経路を確認してください。ドメインに直結ルールを設定しても、クライアントに届いた通信の送信先が変わるだけで、システムのネットワーク探索機能が復旧するわけではありません。業務ネットワークを維持する必要がある場合は、まずTUNを無効にし、元のネットワークが復旧したことを確認してから一つずつ調整します。
ネットワーク切り替えやスリープ復帰後は、新しい接続で再確認する
Wi-Fiから有線LANに切り替えたときや、ノートPCがスリープから復帰したときは、メニューバーのアイコンが変わらなくても既存の接続が無効になる場合があります。まず新しいリクエストを送り、クライアントに届いているか確認してください。サブスクリプションの更新も失敗する場合は、現在のネットワークでログインが済んでいるか、本体の時刻が正しいかを確認します。以前から開いているアプリだけが止まっているなら、そのアプリを再接続してみてください。DNS変更、ノード切り替え、クライアント再インストールを一度に行うのは避けましょう。
アンインストールやクライアントの切り替え前に、システムプロキシとTUNを無効にしてアプリを終了します。複数のネットワークサービスでプロキシを有効にしていた場合は、それぞれのサービスに切り替えて元に戻ったか確認してください。変更前のプロキシ設定をスクリーンショットやメモで残しておくほうが、問題発生後にすべてのプロキシ設定を一括で無効にするより確実です。特に管理対象端末では、元から必要なプロキシまで無効にすると通信できなくなることがあります。
Android:APKのインストールとVpnServiceによる通信の取り込み
アーキテクチャ、入手元、既存アプリを確認する
Androidのダウンロードでは、まずClash Plusを確認してください。既存のClash Meta設定を使う場合は、Clash Meta for AndroidとFlClashの互換性を比較できます。Surfboardもダウンロードページに掲載されていますが、対応する設定形式を使ってください。他のクライアント用設定のファイル名だけを変更して読み込ませないでください。端末が対応するアプリのアーキテクチャは、OSのABIで確認します。プロセッサが64ビットに対応していても、OSが対応アプリのインストールを許可するとは限りません。クライアントが汎用パッケージを提供している場合は、ダウンロードページの案内に従って選んでください。
ブラウザーやファイル管理アプリからAPKを開くと、Androidでそのアプリからのインストール許可を求められる場合があります。APKを開くために使ったアプリだけに許可し、インストール後は必要に応じて取り消してください。インストールできない場合は、OSのバージョン、アーキテクチャ、空き容量、端末管理の制限を確認します。同名のクライアントがすでにインストールされている場合、パッケージ名が同じでも署名が異なると上書きアップデートできません。最初からアンインストールするのは避けましょう。サブスクリプションの記録や手動変更も消える可能性があるため、まず書き出し可能な設定をバックアップしてください。
設定を読み込んでからVPNの許可を求める
クライアントの設定一覧からサブスクリプションを追加するか、システムのファイル選択画面を使って端末上の設定ファイルを読み込みます。追加したら一覧に戻り、有効にする設定を選択してください。プロキシグループに利用可能なメンバーがあることを確認してから接続を開始します。Androidで接続要求が表示されたら、要求元のクライアント名を確認して許可してください。システムの許可後、クライアントはVpnServiceを使ってローカルVPNインターフェースを作成できます。これはリモートプロキシのサブスクリプションとは別の仕組みです。システムにVPN接続中と表示されても、通信の取り込みが始まったことを示すだけで、ノードへの接続が成功したとは限りません。
スマートフォンのWi-Fiにある「プロキシ」設定は、通常そのWi-Fi接続だけを対象とし、クライアントが起動するVPNとは別のものです。VpnServiceを使う通常の構成では、Wi-Fiにローカルプロキシを別途入力する必要はありません。通信の取り込みを有効にしたら、ブラウザーだけでなく、対象アプリでも実際にテストしてください。クライアントにアプリの対象範囲を指定する機能がある場合は、そのアプリが除外されていないか、許可対象に含まれているか確認します。仕事用プロファイルのアプリは、そのプロファイル内で確認してください。
別のVPNや「常時接続」設定に対処する
同じユーザーまたはプロファイル内で、別のVPNがすでにシステムの通信取り込みを使っている場合があります。許可後すぐに停止する場合は、Androidの「設定」で「VPN」を検索し、現在接続中のアプリと「常時接続VPN」の設定先を確認してください。企業のセキュリティ接続、DNSツール、ローカルフィルターもVPNインターフェースを使うことがあります。端末管理の制限がある場合は、業務上の利用ルールを確認し、仕事用の接続を安易に無効にしないでください。
以前「VPN未接続時の通信をブロック」を有効にしていた場合、クライアント停止中もシステムが通常の通信を遮断することがあります。設定を確認する際は、誰がそのスイッチを管理しているか、ネットワーク復旧のために変更してよいかを確認してください。この機能はルールによる送信拒否とは異なります。前者はVPNを経由しない接続をシステムレベルで遮断し、後者はクライアントに届いたリクエストを処理します。両者を混同すると、クライアントのログに何も出ないのにWebページが開けないことがあります。
バックグラウンド停止、ネットワーク切り替え、サブスクリプション更新を切り分ける
画面ロック後に切断する場合は、画面消灯、最近使ったアプリの終了、バッテリー残量低下、Wi-Fiからモバイルデータへの切り替えなど、切断時の条件を記録します。復帰後はシステムのVPN状態、クライアントの通知、新しい接続ログを確認してください。ネットワークを切り替えたときだけ失敗するなら、まず両方のネットワークで個別に確認し、省電力制限をすべて解除するのは避けます。システムが実際にバックグラウンドでクライアントを停止している場合は、端末メーカーの設定画面で、そのクライアントのバックグラウンド動作だけを調整してください。設定場所と症状については、VpnServiceの許可とバッテリー最適化の対象外設定をご覧ください。
サブスクリプションの定期更新と接続の維持は、別の機能です。クライアントで通信できるのに画面ロック中に設定が更新されない場合は、前面に戻して手動更新し、読み込み結果を確認します。手動更新に成功した場合に限り、バックグラウンド動作の制限を調べてください。手動でも失敗する場合は、サブスクリプションURL、ネットワーク、解析エラーを確認します。最後にWi-Fiとモバイルデータの両方で短時間のテストを行い、動作する設定を1つ残しておきましょう。外出中にリモート更新だけを頼りに接続を復旧する事態を避けられます。
iOS:App Storeからのインストール、サブスクリプション設定、VPN状態
公式の配布ページからインストールし、既存のVPNを確認する
iOSのダウンロードからClash PlusのApp Storeページを開き、案内に従ってインストールしてください。事前にApp Storeのページに記載されたシステム要件を確認し、家庭や組織の管理によってインストールが制限されていないかも確認します。仕事用VPNがすでに設定されている場合は、名前、用途、現在の状態を記録してください。クライアントをインストールできることと、個人用VPNを追加できることは別です。インストールが完了しても、組織が端末のネットワーク設定の切り替えを許可しているとは限りません。
初回起動後は、まず設定管理画面を開きます。この種のクライアントを初めて使う場合、ブラウザーなどのアプリを接続するためにWi-FiのHTTPプロキシを設定する必要はありません。Wi-Fiのプロキシは特定のネットワークと、その設定に対応する通信だけが対象です。別のアクセスポイントやモバイル通信に切り替えると、経路も変わります。日常の動作確認にはクライアントが作成するシステムVPNを使い、2種類のプロキシ設定が判断に影響しないようにしてください。
リンクが保存されたかだけでなく、設定内容が読み込まれたか確認する
クライアントのインポート機能からサブスクリプションURLを追加します。「ファイル」に保存した設定を使う場合は、ファイルが端末にダウンロード済みで、クライアントがファイル選択画面から読み込めることを確認してください。デスクトップから移行した設定では、ルールセットのローカルパス、片方の環境でしか使えないプロトコル、設定のマージに必要な拡張機能に注意が必要です。設定名が表示されるのは項目が作成されたというだけです。選択後にルールとプロキシグループが表示されて初めて、内容が読み込まれたことを確認できます。
サブスクリプションサービスが複数の形式を提供している場合は、使用中のクライアントに対応する形式を選んでください。チャット画面のプレビューカードからURLを何度も転送したり、URLが表示された編集画面を撮影したりしないでください。追加に失敗したら、取得時と解析時のどちらでエラーが起きたか確認します。取得に失敗する場合はURL、ネットワーク、サービスの状態を確認します。解析に失敗する場合は、応答がWebページになっていないか、形式が違わないか、クライアント非対応の項目を設定が参照していないかを確認してください。
システムVPNを追加し、実際に有効な接続を確認する
設定を読み込み、プロキシグループのメンバーを選んだら、クライアントから接続を開始します。初回起動時にiOSがVPN構成の追加を求める場合は、要求元を確認してからシステムの案内に従って許可してください。その後、システム設定で「VPN」を検索し、現在使われている接続がクライアントのものか確認できます。システムによっては、「一般」のデバイス管理にも関連項目があります。クライアント画面では起動中でもシステムの状態が一致しない場合は、いったんクライアントを停止し、別のVPNが通信を取り込んでいないか確認してください。
システムにVPN接続中と表示されても、システムのネットワーク層で接続が確立したことしか分かりません。Safariと、実際に通信させたいアプリからそれぞれ新しいリクエストを送り、接続ログがあれば選択中の送信先を確認してください。Safariだけに問題がある場合は、現在のネットワークで他のプライバシー機能やフィルターが有効かどうかも記録し、別のアプリと比較します。1つのIP確認サイトだけで全体が使えないと判断しないでください。システムが管理する通信とクライアントが確認できるリクエストは、完全には一致しない場合があります。
Wi-Fiのログイン認証、モバイル通信への切り替え、自動接続を切り分ける
ホテルや学校のWi-FiでWeb認証が必要な場合は、VPNを切断して認証を済ませ、通常のWebページが開くことを確認してから再接続します。モバイル通信でサブスクリプションを更新できない場合は、システムのモバイルデータ設定でクライアントの通信が許可されているか確認し、同じURLと設定で比較します。Wi-Fiとモバイル通信では、DNSやアクセス条件が異なる場合があります。一方のネットワークでエラーが出ても、設定ファイルが破損しているとは限りません。
切断してもVPNが自動で再接続する場合は、オンデマンド接続が設定されているか、端末管理ポリシーによって接続が起動されていないか確認します。変更が許可されている場合は、自動接続の設定を1つずつ無効にして、その都度テストしてください。ネットワーク切り替え後、以前の接続が使えない経路を指したままになることがあります。新しいWebリクエストで確認してから、元のアプリを再起動する必要があるか調べましょう。仕事用VPNに戻す場合は、個人用接続を停止し、システムに正しい構成が表示されていることを確認してから業務アプリを開いてください。
Linux:ディストリビューション別パッケージ、デスクトッププロキシ、ルーティング
デスクトップクライアントと単体カーネルを区別する
GUI環境のある端末では、LinuxのダウンロードからClash Verge Revを確認し、FlClashとも比較してください。ディストリビューションのパッケージ管理方式と、実際に提供されている形式に合ったものを選びます。DebianやUbuntuでは通常DEB、RPMを採用するディストリビューションでは対応するRPMを使います。インストール前に次のコマンドでアーキテクチャとディストリビューションを確認してください。インストーラーのAMD64は通常、システム表示のx86_64に、ARM64は通常aarch64に対応します。アーキテクチャが合っていても依存関係がそろっているとは限らないため、ディストリビューションの要件も確認してください。
uname -m
cat /etc/os-release
ディストリビューションのソフトウェアインストーラーまたはパッケージマネージャーでローカルファイルをインストールし、不足している依存関係を確認します。エラーを回避するために、別のディストリビューション向けパッケージを無理にインストールしないでください。Mihomo単体カーネルは、サーバー、ルーター、GUIを必要としない環境に適しています。デスクトップ環境のプロキシ設定や、デスクトップクライアントのサブスクリプション管理画面は提供しません。現在のデスクトップセッションで設定を使いたいだけなら、まずクライアント選びを済ませ、単体カーネルを別途サービスとして登録する必要はありません。
現在のデスクトップユーザーで設定を追加し、選択する
アプリメニューからクライアントを通常どおり起動し、設定管理画面でリモートURLを追加するか、ローカルファイルを読み込みます。インポートエラーを直すために、GUIアプリ全体を管理者権限で起動しないでください。設定が別のユーザーのディレクトリに保存されたり、通常ユーザーで書き込めなくなったりする可能性があります。解析後は、現在の設定とプロキシグループを確認してください。ファイルが見つからない場合は、参照先が旧端末や別ユーザーのパスになっていないかを確認し、リモートルールセットのダウンロード失敗とローカルファイルの読み取り権限の問題を切り分けます。
システムプロキシを有効にしたら、使用中のデスクトップ環境のネットワーク設定でプロキシアドレスを確認します。GNOME、KDEなどでは設定画面の場所も、設定が反映される範囲も異なります。デスクトップのプロキシを有効にしても、ターミナルのプロセスが必ずプロキシ環境変数を引き継ぐとは限りません。ブラウザーは使えるのにターミナルでは使えない場合は、全ログインセッションの起動ファイルにプロキシを設定する前に、コマンド固有のプロキシ引数で一時テストします。コンテナーや仮想マシンには独自のネットワーク境界があり、内部のループバックアドレスはホストのローカルプロキシを指しません。
TUNに必要な条件を一つずつ確認する
プロキシ設定を参照しないアプリをクライアント経由にする場合は、デスクトップのシステムプロキシを無効にして、TUNだけをテストします。現在のクライアントがTUNに対応していることを確認し、案内に従って必要なサービスと権限を有効にしてください。有効化したら、次の読み取り専用コマンドでインターフェースとルーティングポリシーを確認します。有効化の前後で実行し、実際の差分からインターフェースが作成されたか、ルールが変わったかを判断するのがおすすめです。メインのルーティングテーブルだけではポリシールーティングが見つからない場合があります。インターフェースが存在していても、対象のリクエストがそこを経由したとは限りません。
ip -brief link
ip rule show
ip route show table all
制限された環境にソフトウェアをインストールしている場合、TUNデバイスへのアクセスやルート変更の権限がないことがあります。制限がOS、コンテナー、パッケージ形式のどこから来ているかを確認し、クライアント全体に無関係な権限を与えないでください。リモート管理ホストでは特に注意が必要です。デフォルトルートを変更すると、現在の管理セッションが切れるおそれがあります。ローカルコンソールと復旧手段がない場合は、アプリ単位のプロキシを使い、ネットワークを独立して復旧できる状態になってから通信の取り込みをテストしてください。
名前解決の経路とバックグラウンドプロセスを確認する
IPアドレスには接続できるのに対応するドメイン名では開けない場合は、システムの名前解決と対象アプリが使う名前解決を比較します。systemd-resolvedを使うシステムでは、resolvectl statusでインターフェースごとのDNSを確認できます。このサービスがないディストリビューションでは、実際に使われているネットワーク管理ツールで確認してください。設定ファイル内のDNSが、すべてのプログラムの名前解決に使われるわけではありません。ブラウザー内蔵の名前解決、VPNから配布されたDNS、システムDNS、クライアント独自のDNSは別々の経路を通ることがあります。問題が起きている箇所を特定してから変更してください。
最後に、古いコマンドラインカーネルやユーザーサービスがまだ動作していないか確認します。デスクトップの自動起動項目とシステムサービスが、それぞれ別のプロセスを起動する場合があります。ウィンドウを閉じても、バックグラウンドのプロセスが止まるとは限りません。ローカルの待ち受けポートが競合する場合は、旧プロセスが別の用途に使われていないか確認してから停止するか、ポートを変更します。元に戻すときは、元の手順で通信の取り込みを停止し、デスクトップのプロキシ設定を復元してから通常のネットワークを確認してください。設定ディレクトリ全体を先に削除すると、変更前後を比較する手がかりが失われます。
設定のよくある質問:更新、ルール、DNS
サブスクリプションの更新に失敗したら、元の設定を削除すべき?
まだ使える設定は残しておきます。手動で一度更新し、接続、サーバー応答、ローカル解析のどこでエラーが起きたか記録してください。接続がタイムアウトする場合は、問題なく使えることが分かっている別のネットワークで確認します。クライアントが更新リクエストの送信先を選べる場合は、新端末から初めて設定を取得するときにもアクセスできるか確認してください。認証に失敗する場合は、URLが変更されていないか配信元に問い合わせます。Webページや空の応答が返る場合、ファイルの拡張子を変えて直そうとせず、正しい内容を取得できているか確認してください。
更新は成功してもルールが反映されない場合は、現在選択中の設定、更新時刻、クライアントが設定を再読み込みしたかを確認します。サブスクリプションが生成した内容を手動編集すると、次回の更新で上書きされることがあります。ルールを継続的に追加する場合は、現在のクライアントが対応する上書き機能を使ってください。その機能がない場合は、ローカルコピーを別に保存し、サブスクリプションの更新には追従しないことを把握しておきましょう。その他の症状はよくある質問をご覧ください。
通信は届いているのに、ルールの振り分け先が違う場合は?
既知の宛先に新しいリクエストを送ります。接続ログがない場合は、入口、ポート、対象アプリの範囲を確認してください。ログに記録されているのに経路が違う場合は、現在のモードと最初に適用されたルールを確認します。ルールモードでは上から順に照合されます。広い範囲のルールを狭いルールより前に置くと、後者に到達しません。適用ルールが決めるのは送信先です。プロキシグループが指定されている場合は、グループ内で実際に選択されているメンバーも確認してください。
以下はmihomoで使える最小限の直結テスト設定です。サブスクリプションを上書きせず、ローカル設定として別名で保存してください。ループバックアドレスで混合ポートを待ち受け、ドメインサフィックスルールでテスト用ドメインexample.orgを拒否し、それ以外のリクエストは最後のルールで直接接続します。ポートが使用中の場合は、空いているポートに変更してテストツールにも反映してください。GUIクライアントがローカルポートを上書きする場合は、画面に表示された値を使います。
mixed-port: 7890
bind-address: "127.0.0.1"
allow-lan: false
mode: rule
log-level: info
rules:
- DOMAIN-SUFFIX,example.org,REJECT
- MATCH,DIRECT
ローカルプロキシ経由でexample.orgとexample.comにそれぞれアクセスし、拒否と直接接続の結果を比較します。リモートノードは不要です。ローカルプロキシを明示的に使った場合の入口とルールの順序を確認するテストです。両方とも失敗する場合は、テストプロセスが現在の待ち受けを使っているか確認します。両方とも成功する場合は、古い設定、グローバルモード、既存の接続を使っていないか確認してください。テスト後は元の設定に戻します。
Fake-IPを有効にして名前解決がおかしくなった場合、まず何を確認する?
まず、アプリのDNSリクエストがクライアントを経由しているか確認します。Fake-IPは一時的なマッピングアドレスにドメイン情報を保持し、クライアントが取り込んだ接続をルールに従って振り分けます。マッピングアドレスが表示されること自体は問題ではありません。確認すべきなのは、アプリがそのアドレスを取得した後の接続がクライアントを迂回しているケース、または実アドレスが必要なローカルサービスが適切でない名前解決経路を通っているケースです。マッピングアドレスが表示されたからといって、すべての上流DNSを変更しないでください。
LAN内の端末だけに影響する場合は、端末のIPアドレスへ直接アクセスした結果と、端末名を使った結果を比較し、関連ドメインに名前解決の例外が必要か確認します。fake-ip-filterは、この種のアドレスマッピングを使わない問い合わせを指定します。nameserver-policyは、特定のドメインに使うDNSサーバーを選ぶ設定です。どちらも通信の振り分けルールの代わりにはなりません。変更後は新しいリクエストでテストし、OSやアプリに古い結果がキャッシュされていないか確認してください。詳しくはDNSの経路確認と設定方法をご覧ください。
遅延テストに成功しているのに、アプリが接続できないのはなぜ?
遅延テストで確認できるのは、ノードから特定のテスト先への結果だけです。任意の宛先、プロトコル、アプリが使えることを示すものではありません。同じノードで実際の宛先をテストし、次に同じ宛先を別のノードで試します。最後に、同じアプリを異なるネットワークで比較してください。HTTPSで開けても、音声通話やリアルタイムアプリに必要なUDP通信が正常とは限りません。遅延テストを何度も繰り返すより、接続ログ、エラーの種類、通信の取り込みを無効にしたときの結果を確認するほうが役立ちます。
復旧するときは、今回有効にした通信の取り込みを停止し、プロキシとDNSを元の設定に戻します。基本ネットワークが復旧したことを確認してから、最後に正常動作した設定を読み込んでください。引き続き原因を調べる場合は、クイックスタートに戻り、設定の追加、グループ選択、接続、動作確認を順番にやり直します。各段階で結果を記録すれば、最初に結果が変わった箇所に次の調査を絞れます。