이 글의 목차
클라이언트를 바꿀 때 보존하고 싶은 것은 보통 정상 구독과 직접 수정한 규칙이지 이전 앱이 남긴 모든 파일은 아닙니다. 이전 앱에서 네트워크를 복구하고 새 앱의 간단한 구성으로 연결한 뒤 필요한 수정 사항을 옮기는 식으로 진행하세요. 단계마다 되돌아갈 지점이 명확해져 문제 발생 시 복구하기 쉽습니다.
ClashX의 구독과 사용자 규칙은 이전하고 시스템 권한은 다시 설정하기
Clash Verge Rev로 옮길 때 ~/.config/clash 전체를 복사하지 마세요. 구독, 직접 작성한 규칙과 필요한 DNS/hosts는 옮길 수 있습니다. 시스템 프록시, Enhanced Mode/TUN, 포트와 로그인 항목은 이전 클라이언트의 실행 설정이므로 해제한 뒤 새 클라이언트에서 다시 설정해야 합니다.
마이그레이션 목록
- 현재 구독 URL과 마지막 업데이트 시각
- 사용 중인 config.yaml 또는 사용자 구성 이름
- 직접 작성한 규칙, DNS, hosts와 스크립트
- HTTP, SOCKS, mixed 포트와 시스템 프록시 상태
- Enhanced Mode/TUN, 로그인 항목과 로컬 네트워크 공유 활성화 여부
ClashX의 일반적인 설정 위치는 ~/.config/clash/config.yaml입니다. 이전 클라이언트가 실제 사용하는 디렉터리와 파일명을 확인하고 다르면 아래 백업 명령도 바꾸세요. Provider 캐시와 기록은 이전하지 않아도 되지만 복구에 필요한 원본 설정과 구독 출처는 보관합니다.
ClashX 종료 후 macOS의 직접 연결이 복구되어야 합니다
이전 클라이언트의 네트워크 프록시 끄기
Enhanced Mode/TUN 끄기
이전 버전에 이 기능이 있고 켜져 있다면 먼저 끈 뒤 가상 인터페이스와 라우팅이 복구될 때까지 기다리세요. 기능이 없거나 켜져 있지 않다면 이 단계를 건너뛰세요.
Set as System Proxy 끄기
그런 다음 메뉴 막대에서 Quit을 선택하고 창만 닫지 않습니다.
macOS 네트워크 프록시 보기
현재 네트워크 서비스의 HTTP, HTTPS와 SOCKS가 기존 포트를 계속 가리키면 안 됩니다.
일반 웹페이지 열기
클라이언트 없이도 직접 연결할 수 있는지 확인하세요. 다음 절의 백업을 완료한 뒤 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 화면(중국어 UI에서는 구독을 뜻함)에서 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를 시작하고 기존 구성 선택
시스템 프록시로 먼저 테스트하고 두 클라이언트가 동시에 로그인 시 시작되지 않도록 합니다.