目次
クライアントを変えるときに残したいのは、動作するサブスクリプションや自分で編集したルールであり、旧アプリの全ファイルではないはずです。旧アプリでネットワークを元に戻し、新アプリで単純な設定を使って接続してから、必要な変更を移す、という段階に分ければ、問題が出てもどこまで戻すかが明確になります。
ClashX のサブスクリプションと独自ルールは移し、システム権限は設定し直す
Clash Verge Rev へ移る際は ~/.config/clash 全体をそのままコピーしないでください。サブスクリプション、自作ルール、必要な DNS/hosts は移せます。システムプロキシ、Enhanced Mode/TUN、ポート、ログイン項目は旧クライアントの動作設定なので、解除してから新しいクライアントで設定し直します。
移行チェックリスト
- 現在のサブスクリプション URL と最終更新時刻
- 使用中の config.yaml またはカスタム設定名
- 手動で作成したルール、DNS、hosts、スクリプト
- HTTP、SOCKS、mixed ポートとシステムプロキシの状態
- Enhanced Mode/TUN、ログイン項目、LAN 共有を有効にしているか
ClashX の一般的な設定場所は ~/.config/clash/config.yaml です。旧クライアントが実際に使うディレクトリとファイル名を確認し、異なる場合は下のバックアップコマンドも変更してください。Provider のキャッシュや履歴は移行せず、復元に必要な元の設定とサブスクリプションの取得元を残します。
ClashX 終了後、macOS は直接接続に戻る必要がある
旧クライアントのネットワークプロキシを無効にする
Enhanced Mode/TUN を無効にする
旧バージョンにこの機能があり、有効になっている場合は、まず無効にして仮想インターフェースとルートの復旧を待ちます。機能がない、または有効にしていない場合は、この手順を省略してください。
Set as System Proxy を無効にする
次にメニューバーから Quit を選択します。ウィンドウを閉じるだけでは不十分です。
macOS のネットワークプロキシを確認する
現在のネットワークサービスにある HTTP、HTTPS、SOCKS が、以前のポートを参照していないことを確認します。
通常の Web ページを一つ開く
どのクライアントにも依存せず直接接続できることを確認します。次の節のバックアップを済ませてから、Clash Verge Revを起動してください。
以前の設定と新しいクライアントの作業ディレクトリを分けてバックアップする
まず、例で今日の日付を使っているバックアップ先ディレクトリが存在しないことを確認します。同名のディレクトリがある場合は、コード内の名前を未使用のものに変更してください。コマンドは && でつながっているため、ディレクトリ作成や cp に失敗すると停止します。成功後もファイルがすべて保存されたことを確認してから、新しいクライアントを起動します。
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/ に保存されます。新しいクライアントが独自のファイルを生成してから、そのディレクトリを個別にバックアップし、以前のファイルと新しいファイルが混在しないようにしてください。
Profiles（サブスクリプション）で元の設定をインポートし、更新と終了後の復旧を確認
Clash Verge Rev 2.xでは、左側のProfiles画面（中国語ではサブスクリプションの意味）でURLをインポートするか、ローカル設定をドラッグして取り込めます。リモートのサブスクリプションは元のURLで追加し直し、ローカルYAMLはコピーしてからインポートします。ファイルはクライアント自身のprofilesディレクトリへコピーされるため、元ファイルを移動しても取り込み済みのコピーには影響しません。
最初はリモートの元の設定、固定したノード、システムプロキシだけを使います。閲覧、サブスクリプションの更新、終了後の接続復旧ができれば、新しいクライアントとコアは動作し、基本的な権限も使える状態です。その後でローカルルールを作り直すと、エラーの原因を見つけやすくなります。
以前のルールは一項目ずつ移し、キャッシュと補助プログラムは移さない
基本的なサブスクリプションが動作したら、以前の設定を開いて一項目ずつ比較します。一度に一種類の内容だけを移し、サブスクリプションを一度更新して一致結果を確認してください。エラー発生時に、どのカスタム設定が原因かすぐに特定できます。
以前の内容の扱い方
| 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 が更新されています。古いチュートリアルにあるサービスコマンドは、現在のバージョンには適用できない場合があります。サービスのインストールとアンインストールには、現在の公式ドキュメントとアプリ内の操作項目を使用してください。
サブスクリプション更新、独自ルール、スリープ復帰、通信復旧の確認
移行結果
- リモート Profile を手動で更新でき、更新時刻とポリシーグループがいずれも新しいクライアントのものになっている
- サブスクリプション更新後も、カスタムルールが一つ想定どおりのポリシーに一致する
- システムプロキシの有効時には接続記録があり、Clash Verge Rev の終了後は macOS が直接接続へ戻る
- TUN が本当に必要な場合、以前はシステムプロキシを参照しなかったアプリが利用でき、ローカルネットワークと社内 VPN に影響がない
- スリープ復帰後や Wi-Fi の切り替え後も、ClashX を同時に起動しなくてもネットワークが復旧する
新しいクライアントに異常がある場合は、この順序で ClashX へ戻す
ロールバック
Clash Verge Rev の TUN とシステムプロキシを無効にする
メニューから完全に終了し、ネットワークプロキシがそのポートを参照していないことを確認します。
新しいサービスを停止する
サービスに異常がある場合は、現在のバージョンに用意された公式のアンインストール手順を使用し、Profiles のバックアップは削除しません。
~/.config/clash を復元する
ClashX が終了している場合に限り、移行前のバックアップから復元します。
ClashX を起動して以前の設定を選択する
まずシステムプロキシでテストし、二つのクライアントを同時にログイン起動させないようにします。