이 글의 목차
ClashX가 작동 중일 때 구독, 규칙과 권한을 나누어 먼저 기록
마이그레이션은 ~/.config/clash 전체를 Clash Verge Rev로 복사하는 작업이 아닙니다. 이전해야 할 것은 원본 구독, 직접 작성한 규칙과 필요한 DNS/hosts입니다. 시스템 프록시, Enhanced Mode/TUN, 포트와 로그인 항목은 기존 클라이언트에서 먼저 해제한 뒤 새 클라이언트에서 다시 권한을 부여해야 합니다. 그래야 마이그레이션이 실패했을 때 어느 단계로 돌아갈지 명확히 알 수 있습니다.
마이그레이션 목록
- 현재 구독 URL과 마지막 업데이트 시각
- 사용 중인 config.yaml 또는 사용자 구성 이름
- 직접 작성한 규칙, DNS, hosts와 스크립트
- HTTP, SOCKS, mixed 포트와 시스템 프록시 상태
- Enhanced Mode/TUN, 로그인 항목과 로컬 네트워크 공유 활성화 여부
목록에서 실제로 이전해야 할 것은 구독과 직접 작성한 내용입니다. 포트, 시스템 프록시와 네트워크 권한은 기존 클라이언트의 당시 실행 상태일 뿐이며 새 클라이언트에서 다시 설정해야 합니다. 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가 기존 포트를 계속 가리키면 안 됩니다.
일반 웹페이지 열기
클라이언트 없이도 직접 연결할 수 있는지 확인한 뒤 Clash Verge Rev를 시작합니다.
원본 구독부터 가져오고 기존 실행 디렉터리는 복사하지 않음
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 업데이트가 있었으므로 이전 가이드의 서비스 명령이 더 이상 맞지 않을 수 있습니다. 서비스 설치와 제거는 현재 공식 문서와 앱 내부 메뉴를 기준으로 진행하세요.
다섯 항목을 모두 통과해야 구독, 규칙과 권한 마이그레이션 완료
웹페이지 하나가 열린다는 것은 가장 짧은 경로만 작동한다는 뜻입니다. 실제 마이그레이션에는 구독 업데이트, 사용자 규칙, 종료 후 복구와 잠자기 후 복귀까지 포함됩니다. 아래 다섯 항목 중 하나라도 빠지면 ClashX를 아직 삭제하지 마세요.
마이그레이션 결과
- 원격 Profile을 수동으로 업데이트할 수 있고 업데이트 시각과 정책 그룹이 모두 새 클라이언트에서 제공됨
- 사용자 규칙 하나가 구독 업데이트 후에도 예상 정책에 일치함
- 시스템 프록시를 켜면 연결 기록이 나타나고 Clash Verge Rev 종료 후 macOS가 직접 연결을 복구함
- TUN이 실제로 필요할 때 기존에 시스템 프록시를 읽지 않던 앱을 사용할 수 있고 로컬 네트워크와 회사 VPN은 영향을 받지 않음
- 덮개를 닫았다가 깨우거나 Wi-Fi를 전환한 뒤 ClashX를 함께 시작하지 않아도 네트워크가 복구됨
새 클라이언트에 이상이 있으면 이 순서로 ClashX 복구
롤백할 때 가장 중요한 것은 두 클라이언트가 네트워크를 동시에 인수하지 않도록 하는 것입니다. Clash Verge Rev를 완전히 해제한 뒤 기존 구성과 앱을 복원하세요.
롤백
Clash Verge Rev TUN과 시스템 프록시 끄기
메뉴에서 완전히 종료하고 네트워크 프록시가 해당 포트를 더 이상 가리키지 않는지 확인합니다.
새 서비스 중지
서비스에 이상이 있으면 현재 버전의 공식 제거 메뉴를 사용하고 Profiles 백업은 삭제하지 않습니다.
~/.config/clash 복원
ClashX가 종료된 상태에서만 마이그레이션 백업을 복원합니다.
ClashX를 시작하고 기존 구성 선택
시스템 프록시로 먼저 테스트하고 두 클라이언트가 동시에 로그인 시 시작되지 않도록 합니다.