App Storeで入手する前に確認するClash設定の互換性
まず、手元の設定をクライアントに読み込めるか確認してからインストールしましょう。特定のプロキシプロトコルへの対応、Clashサブスクリプションへの対応、Clash YAML全体の読み込み対応は、それぞれ別の条件です。デスクトップ版のmihomoで同じファイルを読み込めても、iOSクライアントではノードだけを読み込み、ルールやグループを無視したり、一部の項目を認識できなかったりすることがあります。
- 開発元とアプリのページを確認する。開発元が案内するリンクからApp Storeを開くか、App Storeでアプリ名を検索し、開発元名を照合してください。名前やアイコンが似ているだけでは、同じクライアントとは限りません。
- iOSのバージョンを確認する。iPhoneで「設定」→「一般」→「情報」を開き、iOSのバージョンを確認してから、App Storeの詳細ページにある「情報」内の「互換性」と照らし合わせます。現在のストア地域では利用できないと表示される場合は、開発元が案内する配信地域を確認してください。出所の分からないインストールリンクをApp Storeの入口として使わないでください。
- 読み込みに対応する範囲を確認する。サブスクリプションURLだけを持っている場合は、「リモート設定」や「サブスクリプション」の対応情報を確認します。YAMLファイルの場合は、ローカルファイルのインポート方法を確認してください。独自のルール振り分けを使う場合は、
proxy-groups、rules、リモートルールセットへの対応も確認しましょう。
サブスクリプションURLを読み込む:完全な設定か確認する
サービス提供元がClash用、または利用中のクライアントに対応すると明記しているサブスクリプションURLを選びましょう。URLは通常のHTTPSアドレスに見えるため、拡張子から内容を判断することはできません。同じサービスでも、完全な設定、ノード一覧、アカウント管理ページをそれぞれ提供している場合があります。
- サービス提供元のサブスクリプションページでURL全体をコピーし、疑問符以降のパラメーターも残してください。個人用のサブスクリプションURLを公開チャットやスクリーンショット、オンライン変換サイトに貼り付けないでください。URLに、サブスクリプションを直接取得できるトークンが含まれている場合があります。
- クライアントの設定管理画面を開き、新しいリモート設定を追加するか、URLからインポートする項目を選んで、URLを入力欄に貼り付けます。識別用の設定名は任意で付けられますが、サブスクリプションの内容は変わりません。また、これはプロキシサーバーのアドレスではありません。
- 保存して初回更新を実行します。ダウンロードまたは解析が成功したことを確認し、設定に想定したノードとグループが作成されているか確認してください。元の設定にルールが含まれている場合は、ノード一覧だけでなくルールも取り込まれているか確認しましょう。
- 新しい設定を現在の設定に指定します。保存、更新、有効化はそれぞれ別の操作です。一覧に新しい項目が表示されても、接続中の設定が切り替わったとは限りません。
結果を見て、どの段階で失敗したかを切り分けます。ログにHTTP 401または403と明記されている場合は、サブスクリプションの認証情報とサービス提供元のアクセス条件を確認してください。ダウンロードは成功しても解析に失敗する場合は、取得したものがWebページやログイン応答、別のクライアント専用の形式ではないか確認します。新しい設定のテストが終わるまでは、以前使えていた設定を残しておきましょう。
ローカルYAMLを読み込む:「ファイル」から選択する
完全なファイルをiOSの「ファイル」に保存してから、クライアントに読み込みます。「ファイル」→「ブラウズ」で「このiPhone内」または「iCloud Drive」にあるファイルを探してください。雲のダウンロードアイコンが表示されている場合は、開くかダウンロードして、端末から読み取れることを確認します。ファイルが圧縮されている場合は先に展開し、実際の.yamlまたは.ymlファイルを選びます。
- クライアントの設定管理画面でファイルからのインポートを選び、システムのファイル選択画面から対象ファイルを開きます。共有メニューから設定を受け取れるクライアントなら、「ファイル」で対象を長押しし、「共有」からクライアントを選ぶ方法もあります。
- 行番号付きの解析エラーが出た場合は、該当行とその直前の行を確認します。インデントにはスペースを使い、同じ階層のリスト項目は位置をそろえ、
-で始まる項目は対応するフィールドの下に置きます。ファイル名を.yamlに変えても、Webページやノードのテキストが設定ファイルに変換されるわけではありません。 - 読み込み結果を確認してから、現在の設定に指定します。ローカルファイルは通常、読み込み時点のコピーとして扱われます。クライアントが自動同期に明示的に対応していない限り、「ファイル」内の元ファイルを変更した後は再度インポートし、現在の設定が新しい版に切り替わっていることを確認してください。
同じファイルがパソコンでは使えてもiPhoneで読み込めない場合は、YAMLの構文エラーとクライアント側の項目互換性を分けて確認しましょう。たとえば設定がローカルのルールセットを参照している場合、メインのYAMLだけを読み込んでも外部ルールファイルは取り込まれないことがあります。デスクトップの絶対パスもiPhoneではそのまま使えません。エラーを消すためにルール全体を削除するのではなく、まずそのクライアント向けの設定を入手してください。
最小構成の例でルールのインデントを確認する
以下はClash形式のトップレベル項目の例です。ルール一覧の書き方と順序を示すもので、プロキシノードは含まず、接続確認にも使えません。実際の設定を確認するときは、具体的な条件のルールをフォールバックルールより前に置きます。通常、ルールは上から順に評価され、最初に一致したものが適用されます。
mode: rule
rules:
- DOMAIN,example.com,DIRECT
- MATCH,DIRECT
初回接続:iOSによるVPN構成の追加を許可する
まず、読み込んだ設定を選択し、クライアントから接続します。初めてトンネルを起動するとき、iOSからそのクライアントによるVPN構成の追加を許可するか確認されることがあります。表示されたアプリがインストールしたクライアントであることを確認し、「許可」をタップして、必要に応じて認証を完了してください。サブスクリプションやYAMLはクライアントが読み込むデータで、VPN構成はiOSがトンネルを起動するためのシステム設定です。前者をインポートしても、後者の使用許可は自動では付与されません。
- クライアントで接続状態を確認します。未接続のまま、またはすぐに切断される場合は、起動ログを確認し、現在の設定が読み込まれていることと、システムの許可が完了していることを確認してください。
- iOS 18では「設定」→「一般」→「VPNとデバイス管理」→「VPN」を開き、状態を確認できます。画面の項目名が異なる場合は、「設定」で「VPN」を検索してください。接続中なのが今回インストールしたクライアントであり、以前使っていた別のVPNではないことを確認しましょう。
- 初回の確認で「許可しない」を選んだ場合は、クライアントに戻って接続を再度開始し、システムの案内を確認してください。企業や学校の管理対象端末で接続が制限されている場合は、端末管理者にポリシーを確認してください。管理プロファイルを自分で削除しないでください。
接続後の確認:ルールとノードを個別にテストする
VPNが接続済みと表示されるのは、トンネルが起動したことを示すだけです。リモートノード、DNS、ルールによる振り分けがすべて正常とは限りません。まず同じWi-Fi環境で確認し、どの操作で通信が回復したのか分からなくなるため、ノードの変更、モードの切り替え、DNSの変更を同時に行わないでください。
- モードとグループを確認する。ルールモードに対応しているクライアントでは、ルールモードが選択されていることを確認し、プロキシ経由にするグループで利用可能なノードが選ばれているか確認します。
DIRECTが選択されている場合は切り替えてください。グローバルモードでは、Webページが開けてもルールの振り分けが正しいとは判断できません。 - 直結とプロキシをそれぞれ1件ずつテストする。自分のルールから、直結する想定のドメインとプロキシ経由にする想定のドメインを1つずつ選び、新しいリクエストを送ります。クライアントに接続一覧やログがある場合は、ドメインごとに一致したルールと実際の接続先を確認してください。速度テストの結果は測定リクエストの状態を示すもので、対象ドメインへのアクセス確認の代わりにはなりません。
- 症状ごとに一項目ずつ確認する。一部のドメインだけ失敗する場合は、より上にあるルールに一致していないか確認してください。特定のノードだけ接続タイムアウトを繰り返す場合は、モードとネットワークを変えず、同じグループ内の別のノードを試します。複数のドメインで名前解決エラーが出る場合は、まず現在のWi-FiでWebログインが必要か確認し、その後クライアントのDNS設定に互換性があるか調べてください。
- 最後にモバイルデータ通信でテストする。Wi-Fiでの確認が済んだら、同じ設定とノードを維持したままWi-Fiをオフにし、同じドメインへアクセスします。モバイルデータ通信でのみ失敗する場合は、「設定」→「モバイル通信」でクライアントとテスト対象アプリのモバイルデータ通信が許可されているか確認し、ログから名前解決エラーと接続タイムアウトを切り分けてください。
サブスクリプションの更新後に問題が発生した場合は、更新が成功したか、現在の設定が変わったか、以前選択していたノードが削除または改名されていないかを確認してください。問い合わせる際は、iOSとクライアントのバージョン、インポート方法、最初に発生した関連エラーを記録します。共有する前に、サブスクリプションURL、トークン、設定内のアカウント情報を削除してください。