目次
ClashX がまだ動作している間に、サブスクリプション、ルール、権限を分けて記録する
移行とは、~/.config/clash 全体を Clash Verge Rev へコピーすることではありません。移す必要があるのは、元のサブスクリプション、自分で作成したルール、必要な DNS/hosts です。システムプロキシ、Enhanced Mode/TUN、ポート、ログイン項目は、まず以前のクライアントで解除し、新しいクライアントから改めて権限を付与する必要があります。これにより、移行に失敗した場合でも、どの段階へ戻すべきかを明確にできます。
移行チェックリスト
- 現在のサブスクリプション URL と最終更新時刻
- 使用中の config.yaml またはカスタム設定名
- 手動で作成したルール、DNS、hosts、スクリプト
- HTTP、SOCKS、mixed ポートとシステムプロキシの状態
- Enhanced Mode/TUN、ログイン項目、LAN 共有を有効にしているか
チェックリストで実際に移す必要があるのは、サブスクリプションと自分で作成した内容です。ポート、システムプロキシ、ネットワーク権限は以前のクライアントの実行状態にすぎず、新しいクライアントで改めて設定してください。ClashX の公式リポジトリに記載されたデフォルト設定ディレクトリは ~/.config/clash、デフォルトのファイル名は config.yaml です。Provider のキャッシュと履歴ファイルまで移す必要はありません。
以前の設定と新しいクライアントの作業ディレクトリを分けてバックアップする
BACKUP_DIR="$HOME/Desktop/clash-migration-$(date +%F)"
mkdir -p "$BACKUP_DIR"
cp -a "$HOME/.config/clash" "$BACKUP_DIR/clashx-config"
printf 'Backup saved to: %s
' "$BACKUP_DIR"
# Clash Verge Rev 安装并运行过后，它的 macOS 工作目录位于：
# ~/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev/バックアップにはサブスクリプションの token とノードの認証情報が含まれます。Desktop ディレクトリを公開クラウドストレージまたは Git へ自動共有しないでください。Clash Verge Rev の公式ドキュメントでは、Profiles は Application Support 配下の profiles/ に保存されます。新しいクライアントが独自のファイルを生成してから、そのディレクトリを個別にバックアップし、以前のファイルと新しいファイルが混在しないようにしてください。
ClashX を終了したら、まず macOS を通常の直接接続へ戻す
新しいクライアントのインストールを始める前に、以前のクライアントを終了してもネットワークが正常であることを確認します。これにより、新しいクライアントが起動できなくても、Clash に依存しないロールバック経路が少なくとも一つ残ります。
以前のトラフィック処理を解除する
Enhanced Mode/TUN を無効にする
仮想インターフェースとルートが復旧するまで待ちます。
Set as System Proxy を無効にする
次にメニューバーから Quit を選択します。ウィンドウを閉じるだけでは不十分です。
macOS のネットワークプロキシを確認する
現在のネットワークサービスにある HTTP、HTTPS、SOCKS が、以前のポートを参照していないことを確認します。
通常の Web ページを一つ開く
どのクライアントにも依存せず直接接続できることを確認してから、Clash Verge Rev を起動します。
最初に元のサブスクリプションをインポートし、以前の実行ディレクトリはコピーしない
Clash Verge Rev 2.x では、Profiles ページで URL からインポートするか、ローカル設定をドラッグして追加できます。リモートサブスクリプションは元の URL から改めて追加し、ローカル YAML はコピーを作成してからインポートしてください。クライアントは選択したローカルファイルを独自の profiles ディレクトリへコピーするため、元のファイルを移動してもインポート済みのコピーには影響しません。
初回は、元のリモート設定、固定ノード、システムプロキシだけを使用します。Web ページの閲覧、サブスクリプションの更新、終了後の復元ができれば、新しいクライアント、カーネル、基本権限が正常に機能しています。その後でローカルルールを作り直せば、失敗の範囲を大幅に絞れます。
以前のルールは一項目ずつ移し、キャッシュと補助プログラムは移さない
基本的なサブスクリプションが動作したら、以前の設定を開いて一項目ずつ比較します。一度に一種類の内容だけを移し、サブスクリプションを一度更新して一致結果を確認してください。エラー発生時に、どのカスタム設定が原因かすぐに特定できます。
以前の内容の扱い方
| ClashX 内の内容 | Clash Verge Rev での移行先 |
|---|---|
| リモートサブスクリプション | リモート Profile として追加し直す |
| rules を手動で記述 | Merge/Script または独立したローカル Profile に入れ、サブスクリプション更新後に再検証する |
| カスタム DNS/hosts | 単独で追加してテストし、TUN と同時には移行しない |
| Provider のキャッシュ | 移行せず、新しいカーネルで再ダウンロードする |
| 旧カーネル、ログ、メニューバーアイコン | 移行しない。必要なアイコンだけ個別に対応する |
| 旧ヘルパーサービス | アンインストールまたは停止し、二つのサービスに同時に制御させない |
システムプロキシが一日安定した後、まだ処理されないトラフィックがある場合だけ TUN を有効にする
ターミナル、ゲーム、またはシステムプロキシを参照しないアプリも処理対象にする必要がある場合に限り、Clash Verge Rev からサービスをインストールして TUN を有効にします。macOS ではシステム権限を求められます。許可後、以前失敗した同じプログラムで確認し、ローカルネットワーク、社内 VPN、スリープ復帰も点検してください。
2026 年の Clash Verge Rev では、macOS サービスの IPC と DNS が更新されています。古いチュートリアルにあるサービスコマンドは、現在のバージョンには適用できない場合があります。サービスのインストールとアンインストールには、現在の公式ドキュメントとアプリ内の操作項目を使用してください。
この五項目すべてに合格して初めて、サブスクリプション、ルール、権限の移行が完了します
Web ページが一つ開けても、最短の経路が使えると分かっただけです。移行を完了するには、サブスクリプションの更新、カスタムルール、終了後の復元、スリープ復帰まで確認する必要があります。以下の五項目が一つでも未確認なら、まだ ClashX を削除しないでください。
移行結果
- リモート Profile を手動で更新でき、更新時刻とポリシーグループがいずれも新しいクライアントのものになっている
- サブスクリプション更新後も、カスタムルールが一つ想定どおりのポリシーに一致する
- システムプロキシの有効時には接続記録があり、Clash Verge Rev の終了後は macOS が直接接続へ戻る
- TUN が本当に必要な場合、以前はシステムプロキシを参照しなかったアプリが利用でき、ローカルネットワークと社内 VPN に影響がない
- スリープ復帰後や Wi-Fi の切り替え後も、ClashX を同時に起動しなくてもネットワークが復旧する
新しいクライアントに異常がある場合は、この順序で ClashX へ戻す
ロールバックで最も重要なのは、二つのクライアントに同時にネットワークを制御させないことです。まず Clash Verge Rev の制御を完全に解除してから、以前の設定とアプリを復元します。
ロールバック
Clash Verge Rev の TUN とシステムプロキシを無効にする
メニューから完全に終了し、ネットワークプロキシがそのポートを参照していないことを確認します。
新しいサービスを停止する
サービスに異常がある場合は、現在のバージョンに用意された公式のアンインストール手順を使用し、Profiles のバックアップは削除しません。
~/.config/clash を復元する
ClashX が終了している場合に限り、移行前のバックアップから復元します。
ClashX を起動して以前の設定を選択する
まずシステムプロキシでテストし、二つのクライアントを同時にログイン起動させないようにします。