ClashXでプロキシの購読URLを追加・更新する方法|Mac設定ガイド
登録前に購読URLとClashXの状態を確認する
ClashXに登録する「購読URL」は、プロキシサービスが発行する設定取得用のリンクです。URLを追加すると、ClashXはサービス提供元から設定データを取得し、ノードやプロキシグループを読み込みます。URLそのものがプロキシサーバーの接続先になるわけではありません。また、通常のWebページのURLやアカウントのログインページを貼り付けても、ClashXで利用できる設定が取得できるとは限りません。
作業を始める前に、サービス提供元の会員ページでClash向けの購読リンクを確認してください。サービスによっては「Clash」「ClashX」「汎用形式」など複数の形式を選択できます。リンクを発行した後に形式を切り替えた場合、以前のURLが無効になったり、異なる設定が返されたりすることがあります。利用条件や更新方法もあわせて確認し、第三者が運営する変換サイトへ認証情報を含むURLを不用意に渡さないでください。
ClashXはmacOSのメニューバーに常駐して操作するクライアントです。画面上にアプリのウインドウが見当たらないときは、メニューバーのClashXアイコンを探します。表示されるメニュー名や設定管理画面は、ClashXの配布版やバージョンによって異なる場合があります。以下では「Config」「Remote Config」などの項目名を目安として説明しますが、実際の画面では同じ意味の「設定」「リモート設定」「購読管理」などを探してください。
ClashXに購読URLを追加する
まずClashXを起動し、メニューバーのアイコンから設定メニューを開きます。一般的な操作の流れは、設定またはConfigの中からリモート設定の管理画面を開き、新しい設定を追加してURLを入力する方法です。利用中のビルドに「Remote Config」や「Manage」という項目があれば、そこから登録画面へ進みます。項目が見つからない場合は、メニュー内のConfiguration、設定の管理、購読など、設定ファイル一覧につながる項目を確認してください。
- 購読リンクをコピーする。サービス提供元の管理画面で、ClashXまたはClash互換形式のURLをコピーします。URLを手入力すると、末尾の記号や大文字・小文字を間違えやすいため、可能な限りコピーして貼り付けます。
- 新しいリモート設定を作成する。ClashXの設定管理画面で追加操作を選び、識別しやすい名前を付けます。名前は端末内の表示用です。たとえばサービス名と契約用途を組み合わせ、同じ提供元の複数リンクを区別できるようにします。
- URLを貼り付けて保存する。購読URLの入力欄にコピーしたリンクを貼り付け、保存または追加を確定します。URLの前後に空白が入っていないか、改行で分割されていないかを確認してください。
- 設定を取得して有効化する。新しく登録した項目を選び、更新またはダウンロード操作を実行します。取得が完了したら、ClashXの現在の設定としてその項目を選択し、ノードやプロキシグループが表示されるかを確認します。
メニューにURLを直接登録する項目がなく、ローカル設定ファイルを読み込む機能だけが表示される場合は、ClashXのバージョンや配布形態が異なる可能性があります。サービス側に設定ファイルのダウンロード機能があるなら、提供元が案内する方法でYAMLを取得し、ClashXのローカル設定として読み込みます。ただし、購読URLの内容をブラウザーで開いて保存する方法は、認証情報の取り扱いやファイル形式の違いがあるため、提供元が手順を明示している場合に限ってください。
読み込み結果と利用する設定を確認する
登録後は、URLが一覧に表示されるだけでなく、設定データの取得が成功しているかを確認します。ノード一覧に複数のサーバー名が表示されるか、プロキシグループに利用可能な選択肢があるかを見てください。設定が登録されていても、現在有効な設定が別のものなら通信には反映されません。メニューバーから使用中の設定名を確認し、追加した設定を選択してからノードを切り替えます。
ClashXのメニューにシステムプロキシの切り替えがある場合は、用途に応じて有効化します。これはmacOSのネットワーク設定を通じて、システムプロキシに対応するアプリの通信をClashXへ渡す機能です。すべてのアプリがシステムプロキシを使うわけではなく、ブラウザー独自のプロキシ設定やVPN、アプリ内のネットワーク設定が優先される場合もあります。接続できないときは、まずClashXで選択中の設定とノードを確認し、次に対象アプリがシステムプロキシを利用しているかを切り分けます。
設定ファイルの更新に成功しても、選択中のノードが利用できるとは限りません。サービス側の障害、ノードの混雑、契約期限、ネットワーク環境によって接続結果が変わります。接続テストや遅延表示が利用できる場合は、複数のノードを確認し、応答のあるものを選んでください。グループの表示名や選択方法は配布される設定によって異なるため、特定の名称がないことだけを理由に設定の取得失敗と判断しないようにします。
mixed-port: 7890
mode: rule
proxies:
- name: "設定例"
type: ...
proxy-groups:
- name: "自動選択"
type: select
proxies:
- "設定例"
rules:
- MATCH,自動選択
上記はClash系設定の構造を示す簡略例で、購読URLや実際に利用できるノード情報ではありません。通常、購読設定の取得後にYAMLを編集する必要はありません。サブスクリプションから配布されたファイルを直接変更すると、次回更新時に変更が上書きされる可能性があります。ポートやルールを変更したい場合は、利用中のClashXが対応する設定編集やオーバーライド機能を確認し、元の設定をバックアップしてから作業してください。
購読設定とノードを更新する
ノードの追加や削除、接続先情報の変更があったときは、登録済みの購読設定を更新します。ClashXのメニューバーから設定管理画面を開き、対象のリモート設定を選んで更新操作を実行してください。アプリによっては設定名を右クリックする、または項目の横にある更新ボタンを使います。更新の完了表示だけで判断せず、最終更新時刻、ノード一覧、エラー表示も確認します。
更新操作は、ノードの接続テストとは別です。更新はサービス側から設定を取得する処理であり、接続テストは取得済みのノードへ通信できるかを調べる処理です。更新が成功してもノードへ接続できないことがあり、逆に古い設定のノードが一時的に通信できる場合もあります。問題の種類を混同しないため、まず更新結果を確認し、その後でノードの状態を調べてください。
| 操作 | 確認する内容 | 次の対応 |
|---|---|---|
| 設定の更新 | 取得の成否、更新時刻、エラーメッセージ | 失敗時はURL、ネットワーク、サービス側の状態を確認 |
| 設定の選択 | ClashXで現在有効な設定名 | 別の設定が選ばれていれば対象を切り替える |
| ノードの確認 | ノード一覧、遅延、接続結果 | 別ノードでも試し、契約状態と提供元の案内を確認 |
| システムプロキシ | macOSのプロキシ状態と対象アプリの経路 | 他のVPNやプロキシ設定との重複を確認 |
自動更新の有無や間隔はClashXの版によって異なり、サービス側で設定が変わるタイミングとも一致するとは限りません。定期的な更新が必要な場合は、画面に自動更新の設定があるかを確認し、重要な変更の後は手動更新も実行します。更新中にClashXを終了したりMacをスリープさせたりすると、取得が中断されることがあります。エラーが出た場合は少し待ってから再試行し、短時間に何度も連続更新しないようにしてください。
URL切れ・設定エラーと安全な管理
「URLを取得できない」「設定の解析に失敗する」といった場合は、原因を段階的に確認します。最初にURLのコピー漏れ、余分な空白、入力ミスを調べます。次にMacがインターネットへ接続できるか、サービスの会員ページで契約が有効か、購読リンクが期限切れになっていないかを確認してください。サービス提供元がURLの再発行やリセットを案内している場合は、古いリンクを何度も試すより、管理画面から新しいリンクを発行する方が確実です。
- HTTPエラーや認証エラー:契約状態、サービス側のアクセス制限、URLの有効期限を確認します。アカウントの認証情報を含むURLを公開の場へ貼らず、提供元へ連絡するときも必要な部分だけを共有してください。
- 解析エラー:ClashX向けの形式を選んでいるかを確認します。別形式の設定、HTMLのエラーページ、空の応答をYAMLとして読み込もうとすると、設定ファイルとして解析できません。
- 更新済みなのにノードが表示されない:取得結果が空ではないか、設定がノード情報ではなくプロバイダー形式を使用していないかを確認します。古いクライアントやコアが設定の機能に対応していない可能性もあります。
- ノードは表示されるが接続できない:異なるノードを試し、ClashXのログや接続テストを確認します。設定の取得成功と、プロキシサーバーへの接続成功は別の段階です。
- 更新が終わらない:Macのネットワーク、DNS、ファイアウォール、サービス側の障害を確認し、時間を置いて再試行します。ほかのプロキシアプリやVPNが通信経路に影響していないかも確認してください。
購読URLは、第三者が設定を取得できる鍵として機能する場合があります。メッセージアプリ、公開フォーラム、画面共有、サポート用ログへURL全体を貼り付けないでください。ログを共有する必要がある場合は、トークン、ユーザー名、パスワード、サーバーアドレスなどを伏せ、エラーの種類と発生時刻を伝えます。誤ってURLを公開した場合は、サービス提供元の管理画面でリンクを再発行または無効化し、新しいURLをClashXへ登録してください。
設定を整理する際は、不要になったリモート設定を削除する前に、現在選択中の設定ではないことを確認します。サービスを解約した後も古い設定が残っていると、意図せず古いノードを使う原因になります。一方、複数の契約を使い分けている場合は、設定名だけでなく提供元と用途を区別して保存すると誤操作を防げます。登録、更新、選択の各段階を分けて確認すれば、ClashXでの購読管理と接続トラブルの切り分けを落ち着いて進められます。