MANUAL · FULL-PLATFORM SETUP · REV.2026-07
Clash 全プラットフォーム インストール・設定完全ガイド
本ページはサイト内で体系的に参照できるマニュアルで、Windows、macOS、Android、iOS、Linux をそれぞれ1章として構成し、各章は「ダウンロード → インストール → サブスクリプション導入 → システムプロキシ / TUN → プラットフォーム特有の注意点」という固定の順序で展開します。ほかに共通の準備作業と設定トラブルシューティングの2章を設けています。10分以内に初回接続を完了したい場合は、まず利用ガイドのクイックスタートを読んでください。本ページは各工程の原理・パラメータ・トラブル対処法を網羅し、必要に応じて参照する用途を担います。クライアントのインストールパッケージはクライアントダウンロードページからまとめて取得できます。
共通の準備作業
CHAPTER / PREPARATION1.1開始前に確認すべき3つのこと
1つ目はサブスクリプションリンクです。Clash クライアント自体はルールエンジンとトラフィック振り分け機能のみを持ち、ノード情報は含まれていません。ノード情報はサブスクリプションリンクによって提供され、通常はサブスクリプションサービスのユーザーパネル、または自前で構築したサーバーからエクスポートした設定が元になります。サブスクリプションリンクは HTTPS のアドレスで、アクセスすると Clash 形式の YAML 設定が返されます。インストールを始める前に、このリンクを手元に用意しておいてください。各プラットフォームの導入手順で必要になります。
2つ目はプラットフォームとアーキテクチャです。デスクトップ環境では OS のバージョンと CPU アーキテクチャを確認する必要があります。Windows は x64 と ARM64 を区別し、macOS は Apple Silicon(M シリーズチップ)と Intel を「このMacについて」で確認し、Linux はディストリビューションのパッケージ形式(deb か rpm)とアーキテクチャを確認します。Android の主流機種は arm64-v8a で、古い機種では armeabi-v7a の場合があります。アーキテクチャの選択を誤るとインストールパッケージが動作しない、あるいは性能が大きく低下します。
3つ目は権限です。システムプロキシはユーザーレベルの設定で、通常権限で書き込み可能です。TUN モードは仮想ネットワークカードを作成するため、Windows では管理者権限でシステムサービスをインストールする必要があり、macOS では認可が必要、Linux では root または対応する権限(capability)が必要です。企業デバイスが MDM やグループポリシーで管理されている場合、一部の設定がロックされていることがあるため、インストール前にネットワーク設定の変更が許可されているか確認してください。
1.2用語の定義
本ページでは以下の用語が繰り返し登場するため、統一して定義します。より詳しい用語解説は用語集を参照してください。
| 用語 | 意味 |
|---|---|
| コア | 実際にトラフィックを処理する中核プログラム。現在の主流は Mihomo(Clash Meta コア)。GUI クライアントにはコアが内蔵されているため、通常のユーザーが別途インストールする必要はありません。 |
| GUI クライアント | グラフィカルインターフェースを持つラッパープログラムで、設定管理・ノード切り替え・コア制御を担う。例:Clash Plus、Clash Verge Rev。 |
| サブスクリプション | サービス提供者がホストするリモート設定。クライアントが定期的に取得・更新し、ノード変更時にファイルを手動で書き換える必要がない。 |
| システムプロキシ | OS のプロキシ設定に書き込まれるローカルアドレスとポートの組。この設定を読み取るプログラム(ブラウザなど)のトラフィックが Clash に渡される。 |
| TUN モード | 仮想ネットワークカードを介してネットワーク層で全トラフィックを引き受ける方式で、プログラムがシステムプロキシ設定を読み取るかどうかに依存しない。 |
| 振り分けルール | 設定ファイル内で上から順にマッチングされるルール一覧。各接続をプロキシ経由、直結、拒否のいずれにするかを決定する。 |
1.3クライアント選定クイックリファレンス
各プラットフォームで選択可能なクライアントと推奨順は下表の通りで、ダウンロードページの並びと一致します。選定の原則は、活発にメンテナンスされ、インターフェースと設定ロジックがプラットフォーム間で一貫しているクライアントを優先することです。保守が終了したプロジェクトはアーカイブとしての参考に留め、新規インストールは推奨しません。
| プラットフォーム | 推奨 | 代替 | アーカイブ(保守終了) |
|---|---|---|---|
| Windows | Clash Plus | Clash Verge Rev / FlClash / Clash Nyanpasu | Clash for Windows |
| macOS | Clash Plus | Clash Verge Rev / FlClash | ClashX Meta |
| Android | Clash Plus | Clash Meta for Android / FlClash / Surfboard | — |
| iOS | Clash Plus(App Store) | — | — |
| Linux | Clash Verge Rev | FlClash / Mihomo コア(サーバー用) | — |
Clash Plus は全5プラットフォームをカバーし、設定ロジックとインターフェース構成が各端末で統一されているため、複数デバイスを使うユーザーでも1つの操作方法だけ覚えれば済みます。デスクトップ環境での初回インストールの両OS比較は、記事「Windows と macOS における Clash 初回インストール」も参考にしてください。
サブスクリプションと設定ファイルの基礎
CHAPTER / CONFIG BASICS2.1設定ファイルの構造
Clash の設定ファイルは YAML 形式で、5つの主要部分から構成されます:基本ポート設定、DNS 設定、ノード一覧(proxies)、プロキシグループ(proxy-groups)、ルール一覧(rules)です。サブスクリプションから返されるのはまさにこの完全なファイルであり、その構造を理解しておくと、各プラットフォームの画面操作がすべて対応づけられます。最小構成の骨格は以下の通りです:
mixed-port: 7890 # HTTP と SOCKS5 を共用する混合インバウンドポート
allow-lan: false # LAN 内の他デバイスからの接続を許可するか
mode: rule # 動作モード:rule / global / direct
log-level: info
proxies: # ノード一覧(サブスクリプションから提供される)
- name: "ノードA"
type: trojan
server: example-server.net
port: 443
password: "********"
proxy-groups: # プロキシグループ:ノードを切り替え可能なグループにまとめる
- name: "ノード選択"
type: select
proxies: ["ノードA", "DIRECT"]
rules: # ルールは上から順にマッチングし、命中したら停止
- DOMAIN-SUFFIX,example.com,ノード選択
- GEOIP,CN,DIRECT
- MATCH,ノード選択 # デフォルトルール、必ず最後に置く
通常の利用ではこのファイルを手書きする必要はありません。サブスクリプションに完全な内容が含まれています。しかし「特定サイトの出口が間違っている」「あるルールが効かない」といった問題が発生した際は、rules セクションを理解していることが調査の前提になります。ルールは上から順にマッチングされ、最初に命中したもので停止するため、順序を間違えると後続のルールに一切到達しません。ルールの書き方と優先順位の詳しい解説は記事「Clash 振り分けルールの優先順位を徹底解説」を参照してください。
2.23つの動作モード
全クライアントが提供する3つの動作モードは、意味が固定されています:
| モード | 動作 | 適用シーン |
|---|---|---|
| rule | ルール一覧を1件ずつ順にマッチングし、出口を振り分ける | 日常のデフォルト。日本国内は直結、海外はプロキシ経由で相互に干渉しない |
| global | ルールを無視し、全トラフィックを現在選択中のノードへ流す | ノードの接続確認や、ルール異常時のフォールバック |
| direct | 全トラフィックを直結し、いずれのノードも経由しない | 「プロキシが原因かどうか」を切り分ける際に対照として使用 |
ネットワーク問題を調査する際、この3モードは天然の対照グループになります。direct モードで正常、rule モードで異常なら問題はルールかノードにあります。3モードすべてで異常が出るなら、ローカルネットワーク自体に問題があります。
2.3サブスクリプションの3つの導入方法と更新
全プラットフォームのクライアントで対応している導入方法はほぼ共通です:URL 導入(サブスクリプションリンクを貼り付け、クライアントが自動でダウンロード。最も一般的)、クリップボード導入(リンクをコピーするとクライアントが自動検出)、ローカルファイル導入(YAML を手動でダウンロードし、ファイルから追加。オフライン環境向け)。3つの方法の具体的な操作手順と形式の違いは記事「Clash サブスクリプションリンク導入ガイド」を参照してください。
URL 導入で追加したサブスクリプションは自動更新に対応しており、デフォルトの更新間隔は数時間から1日程度で、サブスクリプション項目の設定で調整できます。サービス提供者は通常サブスクリプションのレスポンスヘッダーでトラフィックと有効期限の情報を返し、クライアントはそれをサブスクリプションカード上に表示します。ローカルファイル導入には更新機能がなく、ノード変更後は再ダウンロードして置き換える必要があります。サブスクリプションの更新失敗については本ページの第08章を参照してください。
2.4ポートの取り決め
主流の設定では mixed-port: 7890 により混合インバウンドを提供し、同じポートで HTTP と SOCKS5 の両方を受け付けます。旧式の設定では port: 7890(HTTP)と socks-port: 7891(SOCKS5)を別々に記述する場合もあります。システムプロキシに書き込まれるアドレスは常に 127.0.0.1 と上記ポートの組み合わせです。コマンドラインツールや他のデバイスに手動でプロキシを指定する必要がある場合は、記憶で入力せず、クライアントのホーム画面に表示される実際のポート番号を確認してください。クライアントによってデフォルトポートが異なります。
Windows のインストールと設定
CHAPTER / WINDOWS3.1ダウンロードとバージョン選択
ダウンロードページの Windows セクションからインストーラーを取得してください。推奨は Clash Plus、代替として Clash Verge Rev(Rust + Tauri 実装、メモリ消費が少ない)、FlClash(Flutter 実装、シンプルな画面)、Clash Nyanpasu があります。Clash for Windows は保守が終了しており、アーカイブとしてのみ提供されるため新規インストールには選ばないでください。内蔵されている古いコアは新しいプロトコルやルールタイプへの対応が不完全です。システム要件は Windows 10 64bit 以上。ARM 搭載ノート PC は ARM64 パッケージを選択してください。x64 パッケージは ARM デバイス上でトランスレーションレイヤーに依存し、性能低下が明確に出ます。
3.2インストール手順
- インストーラーをダブルクリックします。SmartScreen の青い警告画面が出た場合は「詳細情報」→「実行」をクリックしてください。これは Windows が大規模配布の署名がないインストーラーに対して表示するデフォルトの警告で、インストーラー自体の異常を意味するものではありません。
- インストール先はデフォルトのままにすることを推奨します。パスをカスタマイズする場合は、日本語や空白を含むディレクトリを避けてください。一部のコンポーネントは非 ASCII パスとの互換性が不安定です。
- 初回起動時、Windows ファイアウォールがネットワークアクセスの確認を表示する場合があります。「プライベートネットワーク」にチェックを入れて許可してください。許可しないとコアがローカルポートをリスンできなくなります。
- クライアントの設定に入り、「自動起動」と「サイレント起動」を必要に応じて有効にし、再起動後にプロキシを開き忘れることを防いでください。
3.3サブスクリプションの導入
クライアントの「サブスクリプション」または「設定」画面を開き、新規作成をクリックしてサブスクリプションリンクを貼り付け、確定するとクライアントが設定をダウンロードして項目を生成します。ダウンロード完了の目印は、項目にノード数やトラフィック情報が表示されることです。読み込み状態のまま止まる場合は、まず端末のネットワークがサブスクリプションのアドレスに直接アクセスできるか確認してください。一部のサブスクリプションドメインはプロキシ経由でなければアクセスできない場合があり、その場合はクリップボード導入を使うか、まずローカルファイル導入で初回接続を完了させ、その後 URL サブスクリプションに切り替えてください。導入成功後、「プロキシ」画面で遅延が正常なノードを選択します。
3.4システムプロキシと動作確認
クライアントのホーム画面で「システムプロキシ」スイッチを有効にすると、127.0.0.1:7890(実際のポートに準ずる)が Windows の インターネットプロキシ設定に書き込まれます。確認は2段階で行います。1つは設定の確認——「設定 → ネットワークとインターネット → プロキシ」を開き、「プロキシサーバーを使う」が有効でアドレスとポートがクライアントと一致していること。もう1つはトラフィックの確認——プロキシに振り分けられるはずのサイトにブラウザでアクセスし、同時にクライアントの接続パネルに対応する記録が表示されるか確認します。リスンポートの存在をコマンドラインで確認する方法:
netstat -ano | findstr 7890
出力があればコアがリスン中であることを示し、出力がなければコアが起動していないかポートが変更されている可能性があるため、まずクライアントのログを確認してください。
3.5TUN モード
システムプロキシは「システムプロキシ設定を読み取る」プログラムに対してのみ有効です。UWP アプリ、一部のゲームクライアント、コマンドラインツールはデフォルトでこの設定を読み取らないため、それらのトラフィックには TUN モードによる引き受けが必要です。Windows で TUN を有効にする固定の手順:まずクライアントの設定でシステムサービスをインストール(UAC ダイアログで管理者権限の承認が必要)し、サービスのインストールが成功したら「TUN モード」スイッチを開きます。有効化の目印:デバイスマネージャーまたは「ネットワーク接続」に Mihomo または類似の名前を持つ仮想ネットワークカードが表示され、システムプロキシを読まないプログラムでも接続記録が発生し始めます。原理面の詳しい解説(仮想ネットワークカードとシステムプロキシの違い、DNS ハイジャックがなぜ必要か)は記事「TUN モードの原理と有効化方法」を参照してください。
TUN と他の VPN 系ソフトウェアの仮想ネットワークカードはデフォルトルートを奪い合います。TUN を有効にする前に他の VPN やアクセラレーターを終了してください。セキュリティソフトがサービスのインストールをブロックする場合は、許可した上でサービスを再インストールしてください。
3.6Windows 特有の問題
- ポートが使用中:クライアントがポート競合を通知した場合、
netstat -ano | findstr 7890で占有プロセスの PID を特定し、タスクマネージャーで終了するか、クライアント設定で別のポートに変更してください。よくある原因は完全に終了していない別のプロキシソフトのインスタンスです。 - 終了後にネットが使えない:クライアントが異常終了するとシステムプロキシ設定が残留し、ブラウザ全体が開けなくなることがあります。「設定 → プロキシ」で「プロキシサーバーを使う」を手動でオフにすれば復旧します。その後クライアントを正常に起動してください。
- 複数のプロキシソフトの併存:2つのプロキシソフトが同時にシステムプロキシを有効にすると、後から開いた方が先のものを上書きし、接続動作が混乱します。1つだけ残し、他はタスクトレイも含めて完全に終了してください。
- スリープ復帰後にネットが繋がらない:TUN モードで時々発生します。TUN スイッチをオフにして再度オンにし、仮想ネットワークカードを再構築すれば解決します。
macOS のインストールと設定
CHAPTER / MACOS4.1ダウンロードとチップの区別
ダウンロードページの macOS セクションへ進んでください。推奨は Clash Plus、代替は Clash Verge Rev と FlClash。ClashX Meta は保守終了のためアーカイブのみです。ダウンロード前にチップを確認してください:左上のアップルメニュー →「この Mac について」で「チップ」欄に Apple M シリーズと表示されていれば Apple Silicon 版、Intel プロセッサと表示されていれば Intel 版を選択します。Apple Silicon デバイスに Intel 版を入れると Rosetta 経由で動作しますが、メモリ消費と電力消費が余分にかかるため推奨しません。
4.2インストールと Gatekeeper の警告対処
- ダウンロードした dmg イメージを開き、アプリアイコンを Applications フォルダにドラッグしてから、イメージを取り出します。
- 初回起動時はダブルクリックせず、アイコンを右クリック(または Control キーを押しながらクリック)し「開く」を選択、ダイアログでもう一度「開く」をクリックします。これは App Store 以外で配布されたアプリに対する Gatekeeper の初回ブロックを回避する標準的な方法です。
- 「アプリケーションが壊れているため開けません」と表示される場合、ダウンロードファイルに検疫属性が付与されていることが原因です。インストーラーが本サイトのダウンロードページからのものであることを確認した上で、ターミナルで以下のコマンドを実行し検疫属性を除去してから再度開いてください:
sudo xattr -rd com.apple.quarantine /Applications/ClashPlus.app
パスは実際にインストールしたアプリ名に置き換えてください。このコマンドは、入手元が確実に信頼できるアプリに対してのみ実行することが前提です。
4.3サブスクリプションの導入
操作は Windows と同じです:サブスクリプション画面で新規作成 → リンクを貼り付け → 確定してダウンロード。macOS のクライアントはメニューバーアイコンとして常駐することが多く、メインウィンドウを閉じてもプログラムは動作を続けます。ウィンドウが見つからないときはメニューバーのアイコンをクリックして呼び出してください。導入後はプロキシ画面でノードを選択します。プロキシグループの構造は設定ファイル内の proxy-groups と一対一で対応しています。
4.4システムプロキシと認可
初回「システムプロキシ」スイッチを開くと、システムが認可ダイアログを表示しパスワード入力を求めます。クライアントがネットワーク設定内の「Web プロキシ(HTTP)」「セキュリティ Web プロキシ(HTTPS)」「SOCKS プロキシ」の3項目に書き込む権限が必要なためです。一度認可すれば長期間有効です。確認方法:「システム設定 → ネットワーク → 現在のネットワーク → 詳細 → プロキシ」で3項目が 127.0.0.1 とクライアントのポートを指しているか確認するか、ターミナルで scutil --proxy を実行し、出力の HTTPEnable が 1 でポートが一致していれば有効です。
4.5TUN モード
macOS で TUN を有効にするには、クライアントが特権ヘルパーコンポーネントまたはシステム拡張をインストールする必要があり、初回有効化時に1〜2回のシステムレベルの認可(パスワード入力、一部の OS バージョンでは「システム設定 → プライバシーとセキュリティ」でブロックされた拡張を手動で「許可」する操作も必要)が発生します。有効化が成功したら、ターミナルで ifconfig | grep utun を実行すると新たに追加された utun インターフェースが確認できます。Windows と同様、システムプロキシを読まないコマンドラインプログラムや一部のクライアントソフトは TUN が必要です。ブラウザのみを使う場合はシステムプロキシで十分であり、TUN を有効にする必要はありません。
4.6macOS 特有の問題
- OS の大型アップデート後にプロキシが失効:アップデートによりネットワーク設定がリセットされたり拡張の認可が取り消されたりすることがあります。スイッチはオンなのにトラフィックがプロキシを通らない場合、システムプロキシのスイッチをオフ→オンにして再書き込みを促してください。TUN 利用者は「プライバシーとセキュリティ」で拡張を再度許可してください。
- メニューバーアイコンが隠れる:ノッチ搭載機種はメニューバーの領域が限られており、アイコンが隠れてプログラムが起動していないと誤解することがあります。Finder の「アプリケーション」からアプリを再度クリックするか、メニューバーの常駐項目を減らしてください。
- Wi-Fi と有線が併存する場合、プロキシが片方のインターフェースにしか書き込まれない:システムプロキシはネットワークサービスごとに設定されるため、インターフェースを切り替えた後にプロキシが効かなくなったら、システムプロキシのスイッチを一度オフ→オンにして現在のインターフェースへ再書き込みさせてください。
- 会社のデバイス:MDM 管理下のデバイスではシステム拡張のインストールが禁止されている場合があり、TUN が有効化できないため、システムプロキシ方式のみ利用可能です。
Android のインストールと設定
CHAPTER / ANDROID5.1クライアントの選択
ダウンロードページの Android セクションへ進んでください。推奨は Clash Plus、代替は Clash Meta for Android(コミュニティでは CMFA と呼ばれ、機能が充実し設定項目も細かい)、FlClash(画面が直感的で初めての方に向いている)、Surfboard があります。APK のアーキテクチャは主流が arm64-v8a で、2016年以降の主流機種は基本的に対応しています。「パッケージの解析エラー」や「デバイスと互換性がありません」と表示される場合は、多くがアーキテクチャの不一致によるもので、armeabi-v7a または universal パッケージに切り替えてください。
5.2APK のインストール
- ブラウザで APK ファイルをダウンロードし、完了後にタップしてインストールします。
- システムが「不明なアプリのインストールは許可されていません」と表示してブロックした場合、表示内の「設定」をタップして遷移し、使用しているブラウザに対し「このソースからのアプリを許可」をオンにします。手動でのパスは「設定 → アプリ → 特別なアプリアクセス → 不明なアプリのインストール」です。
- 戻ってインストールを続行します。一部のメーカー独自 OS(MIUI、ColorOS など)では「リスクのあるアプリ」の確認がもう一度表示されますが、そのままインストールを続行して問題ありません。これはストア以外から入手した APK 全般に対する OS 共通の表示です。
5.3サブスクリプションの導入
アプリを開き「設定」または「サブスクリプション」画面に入り、右下の新規作成をタップして「URL」タイプを選択、サブスクリプションリンクを貼り付けて保存すると、アプリが設定をダウンロードします。サブスクリプション項目を長押しまたはタップして開くと自動更新の間隔を設定できます。12時間または24時間を推奨します。導入後ホーム画面に戻り、設定項目にチェックが付いた状態が有効化された状態です。
5.4プロキシの起動:VpnService の許可
Android にはデスクトップのような「システムプロキシスイッチ」は存在せず、クライアントはシステムの VpnService インターフェースを通じてローカル VPN トンネルを構築し、トラフィックを引き受けます。効果はデスクトップの TUN モードと同等です。ホーム画面の起動ボタンを初めてタップすると「接続リクエスト」ダイアログが表示され、必ず「OK」を選択する必要があります。許可後はステータスバーに鍵のような VPN アイコンが表示され、これが動作中の目印です。同時に VpnService を占有できるアプリは1つだけのため、他の VPN 系アプリは先に切断しておく必要があります。確認方法:「プロキシ」画面でプロキシグループの遅延テストを実行し、数値が返れば経路は利用可能です。
5.5Android 特有の問題
- バックグラウンドで強制終了される:各メーカー独自 OS の省電力ポリシーが最大の問題で、画面ロック後しばらくするとプロキシが切断される現象として現れます。対処法:システム設定でクライアントの電池ポリシーを「制限なし/バックグラウンド動作を許可」に設定し、最近使用したアプリ一覧でロックしてください。メーカーごとに設定項目の名称は異なりますが、考え方は「電池最適化のホワイトリスト + 自動起動の許可」で共通です。
- プライベート DNS の競合:「設定 → ネットワーク → プライベート DNS」で DoT サーバーが指定されている場合、DNS クエリがクライアントを迂回してしまい、振り分けが不正確になることがあります。「自動」に戻すことを推奨します。
- アプリごとのプロキシ設定:クライアントの「アクセス制御」はホワイトリスト(リスト内のアプリのみプロキシ経由)またはブラックリスト(リスト内のアプリはプロキシを通らない)に対応しています。銀行系アプリが VPN 環境に敏感な場合は、除外リストに追加してください。
- 常時オンの VPN:「設定 → VPN」でクライアントに対し「常にオン」と「VPN を使用していない接続をブロック」を有効にできます。前者は生存率を高め、後者はプロキシ切断時に全ネットワークを遮断するため、必要に応じて選択してください。
iOS のインストールと設定
CHAPTER / IOS6.1クライアントの入手
iOS では Clash Plus(App Store 商品ページ)を使用します。公式サイトは clashplus.io です。App Store で検索するか商品ページから直接インストールしてください。更新はストアから自動配信されるため、バージョンを手動で管理する必要はありません。
6.2初回起動と VPN 構成の許可
初回起動して接続を試みると、アプリがシステムに VPN 構成の追加を要求し、システムが「許可」を求めるダイアログを表示してロック画面のパスコードまたは Face ID による確認を求めます。許可が完了すると、「設定 → 一般 → VPN とデバイス管理 → VPN」に該当項目が表示されます。この操作は一度だけで済み、以後の接続と切断はアプリ内、あるいは設定の VPN スイッチで行います。
6.3サブスクリプションの導入
アプリの設定/サブスクリプション画面に入り、新規作成してサブスクリプションリンクを貼り付け、ダウンロード完了後にその設定を有効化します。Safari でリンクをコピーしてアプリに切り替えると、一部のシーンではクリップボードを自動検出し導入するか確認が表示されるので、確定すれば完了です。サブスクリプションは同様に自動更新に対応し、更新間隔はサブスクリプション項目の設定で調整できます。
6.4接続と日常利用
アプリ内の接続スイッチをタップし、ステータスバーに VPN マークが表示されれば動作中です。ノード切り替え、プロキシグループの選択、遅延テストはすべてアプリ内で行い、ロジックはデスクトップ版と同一です。プロキシグループは設定ファイル内の proxy-groups に対応し、ルールモードでは「ノード選択」グループ内の出口を選ぶだけで済みます。iOS のネットワーク拡張にはメモリ上限があり、ノード数が非常に多いサブスクリプションはメモリの少ない旧機種で接続失敗する場合があるため、サービス提供者に軽量版サブスクリプションの提供を依頼してください。
6.5iOS 特有の問題
- 設定を切り替えても反映されない:新しい設定を有効化した後は、一度切断して再接続する必要があります。それによりネットワーク拡張が新しいファイルを読み込みます。
- Wi-Fi とモバイル通信の切り替え時に一瞬切断する:ネットワークインターフェースが切り替わると VPN トンネルが再構築されるため、数秒間の断線が発生するのは正常な動作です。アプリが自動的に再接続します。
- 古い VPN 構成の残留:これまで複数のプロキシアプリを使ったことがあるデバイスでは、「VPN とデバイス管理」に複数の構成プロファイルが蓄積していることがあります。使わなくなったアプリに対応する項目を削除し、システムが複数の VPN 構成を誤って切り替えることを防いでください。
- 低データモード:モバイル通信で「低データモード」が有効な場合、バックグラウンド動作が制限され、サブスクリプションの自動更新が遅延することがあります。必要に応じて手動更新してください。
Linux のインストール・設定と Mihomo コア
CHAPTER / LINUX & CORE7.1デスクトップクライアントのインストール
デスクトップ環境では Clash Verge Rev(deb と rpm パッケージを提供)を推奨し、代替として FlClash があります。Debian/Ubuntu 系で deb パッケージをインストールする場合:
sudo dpkg -i clash-verge-rev_amd64.deb
sudo apt-get install -f # 依存関係が不足している場合、補完後にインストールが自動完了
Fedora などの rpm 系では sudo rpm -i または sudo dnf install ./パッケージ名.rpm を使用します。インストーラーはダウンロードページの Linux セクションから取得でき、amd64 と arm64 の区別に注意してください。インストール後はアプリケーションメニューから起動し、サブスクリプションの導入操作はほかのデスクトッププラットフォームと同一です:サブスクリプション画面で新規作成 → リンクを貼り付け → ダウンロード → ノードを選択。
7.2システムプロキシ:デスクトップ環境とターミナルは別物
Linux における「システムプロキシ」はデスクトップ環境レベルの設定で、GNOME と KDE でそれぞれ独自の仕組みがあります。クライアントのシステムプロキシスイッチは通常 GNOME の gsettings か KDE の対応項目にのみ書き込みます。GNOME のプロキシを手動で設定する等価コマンド:
gsettings set org.gnome.system.proxy mode 'manual'
gsettings set org.gnome.system.proxy.http host '127.0.0.1'
gsettings set org.gnome.system.proxy.http port 7890
gsettings set org.gnome.system.proxy.https host '127.0.0.1'
gsettings set org.gnome.system.proxy.https port 7890
重要な違いとして、ターミナルのプログラムはデスクトップのプロキシ設定を読み取らず、環境変数のみを参照します。現在のターミナルセッションに一時的にプロキシを設定する場合:
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export all_proxy=socks5://127.0.0.1:7890
シェルの設定ファイル(例:~/.bashrc)に書き込めば長期的に有効になりますが、プロキシをオフにした際にこれらの変数が原因でターミナルがネットに繋がらなくなることがあるため、オン/オフの関数として封じ込め、必要な時だけ有効化することを推奨します。環境変数の管理をしたくない場合は、TUN モードを有効にすれば一度の設定で済みます。
7.3TUN モードと権限
TUN デバイスの作成には CAP_NET_ADMIN 権限が必要です。Clash Verge Rev は「サービスモード」を提供しています:設定でシステムと共に動作する特権サービスをインストール(一度の sudo 承認が必要)すれば、以後は通常権限の画面から TUN をオン/オフできます。サービスモードを使わない場合は、コアプログラムに直接権限(capability)を付与することもできます:
sudo setcap 'cap_net_admin,cap_net_bind_service=+ep' /usr/bin/mihomo
有効化後、ip addr で新規追加された TUN インターフェースが確認でき、デフォルトルートがそこを指しています。デスクトップユーザーが「TUN スイッチをオンにするとすぐに自動でオフに戻る」という現象に遭遇した場合、9割はサービスが未インストールか認可失敗によるものなので、サービスを再インストールしてログを確認してください。
7.4Mihomo コア:サーバー・ルーター向け
グラフィカルインターフェースのないサーバーやソフトウェアルーターでは Mihomo コアを直接実行します。コアは単一の実行ファイルで、ダウンロードページのコアセクションからアーキテクチャ(amd64 / arm64 / armv7 / mips-softfloat)に応じて取得し、展開後 /usr/local/bin/ に配置します。設定ファイルは /etc/mihomo/config.yaml に置きます(サブスクリプションから取得した YAML をこのファイル名で保存)。systemd で管理する最小構成の unit 例:
[Unit]
Description=Mihomo Daemon
After=network.target
[Service]
Type=simple
ExecStart=/usr/local/bin/mihomo -d /etc/mihomo
Restart=on-failure
CapabilityBoundingSet=CAP_NET_ADMIN CAP_NET_BIND_SERVICE
AmbientCapabilities=CAP_NET_ADMIN CAP_NET_BIND_SERVICE
[Team]
上記の最終行はプレースホルダーであり、実際に保存する際は削除してください。ファイルを /etc/systemd/system/mihomo.service として保存後、sudo systemctl daemon-reload && sudo systemctl enable --now mihomo を実行して起動と自動起動設定を行い、journalctl -u mihomo -f でログを追跡します。コアには画面がないため、ノード切り替えは設定内で有効化した外部コントロールインターフェース(external-controller)と Web パネルを組み合わせて行います。一般的なデスクトップユーザーがこの方式を選ぶ必要はなく、GUI クライアントで全ての要件をカバーできます。
7.5接続確認
Linux で最も直接的な確認方法は、curl に明示的にローカルプロキシを指定させることです:
curl -x http://127.0.0.1:7890 -sS -o /dev/null -w '%{http_code}\n' https://www.example.com
200 が返れば「端末 → コア → ノード → 目的地」という経路全体が通っていることを示します。詰まる、または接続拒否が返る場合は、まずポートを確認(ss -lntp | grep 7890)し、次にコアのログに記録されている接続エラーを確認してください。
設定トラブルシューティング
CHAPTER / TROUBLESHOOTING8.1サブスクリプション導入後もネットに繋がらない
固定の順序で1つずつ確認し、手順を飛ばさないでください:①システムプロキシまたは VPN スイッチが本当にオンになっているか(デスクトップはシステム設定、モバイルはステータスバーのアイコンを確認)。②クライアントに表示されているポートとシステムプロキシに書き込まれたポートが一致しているか。③現在選択中のノードの遅延テストに数値が返っているか。全てタイムアウトの場合はまずノードを変更。④動作モードが direct ではなく rule になっているか。⑤ファイアウォールやセキュリティソフトがコアプロセスをブロックしていないか。各項目のコマンドによる確認方法とより詳細な分岐判断は記事「Clash 接続失敗トラブルシューティングチェックリスト」を参照してください。
8.2全ノードの遅延テストがタイムアウトする
可能性は3つで、発生確率の高い順に:サブスクリプションの期限切れまたはトラフィック使い切り(サブスクリプションカードの有効期限とトラフィック情報を確認するか、サービス提供者のパネルにログインして確認)。ローカルネットワークがノードのポートに干渉している(モバイルのテザリングなど別のネットワーク環境で対照確認)。遅延テストの URL 自体が到達不能(テストアドレスは設定で変更可能)。単一ノードのタイムアウトは通常の変動範囲内ですが、全ノードがタイムアウトする場合は調査が必要です。
8.3特定サイトの出口が間違っている、またはルールが効かない
まずクライアントの接続パネルで該当サイトの実際の接続記録を探し、どのルールに命中しているかを確認してください——これが判断の唯一の根拠であり、推測してはいけません。出口を誤る一般的な原因:カスタムルールがより広範なルールの後に配置されている(上から順に命中したら停止するため、MATCH のデフォルトルールより後のルールは全て無効なコードになる)。ドメインルールが DOMAIN(完全一致)で書かれているのに実際はサブドメインへアクセスしている場合は DOMAIN-SUFFIX に変更する必要がある。対象が裸の IP アクセスの場合、ドメインルールは命中しないため IP-CIDR ルールが必要。ルールタイプと配置順序の完全な例は「Clash 振り分けルールの優先順位を徹底解説」を参照してください。
8.4DNS 関連の異常
主流の設定はデフォルトで fake-ip モードを使用します:プロキシ対象のドメインに対してコアが予約セグメントの仮の IP を返し、実際の解決は出口側で行われます。利点はローカル DNS 汚染を回避し解決レイテンシを下げることです。副作用は2つあり、いずれも想定内の動作です:端末で ping や nslookup を実行すると 198.18.x.x セグメントのアドレスが表示されるのは正常です。実際の IP に依存する一部の LAN プログラムでは、関連するドメインを fake-ip-filter の除外リストに追加する必要があります。もう1つの問題は、OS レベルの DNS 設定がコアを迂回するケースです——Android のプライベート DNS やブラウザ内蔵の DoH は振り分けの不正確さを引き起こすため、調査時はまずこれらを自動/オフに戻してください。
8.5サブスクリプションの更新失敗
3つのケースに分けて対処します。更新リクエストがタイムアウトする場合:サブスクリプションのドメインがすでにプロキシ経由でなければアクセスできなくなっている可能性があるため、クライアント設定で「プロキシ経由でサブスクリプションを更新」を有効にしてから再試行してください。エラーまたは空のコンテンツが返る場合:サブスクリプションリンクがリセットされている可能性があるため、サービス提供者のパネルにログインして新しいリンクをコピーし再導入してください。ダウンロードは成功するが形式エラーが出る場合:そのリンクが Clash 形式でない(他のクライアント専用の形式である)可能性があるため、サービス提供者に Clash 用のサブスクリプションアドレスを問い合わせるか、パネル上で正しい形式のオプションが選択されているか確認してください。
8.6それでも解決しない場合
本章は設定面での高頻度な問題を扱っています。カテゴリ別に整理された追加の Q&A はよくある質問ページ(基礎知識/インストール設定/使い方のコツ/トラブルシューティングの4分類)を参照してください。本文中に登場するプロトコルや機能名は用語集に個別の項目があります。調査を依頼する際は、問題の説明に次の3要素を含めてください:プラットフォームとクライアント名、動作モード、接続パネルで命中したルール。ほとんどの問題はこれで直接特定できます。