연결 문제 해결 · Clash 기술 블로그

Clash Verge Rev GEO 업데이트 후 규칙 검증 실패 해결

Clash Verge Rev 서비스 모드에서 GeoData를 업데이트했는데 새 분류의 규칙이 검증에 실패하나요? 앱과 서비스의 데이터베이스를 구분하고 v2.5.10으로 업데이트한 뒤 기존 설정을 다시 활성화해 실제 규칙 일치를 확인하세요. 되돌릴 수 있는 규칙도 보존합니다.

본문 읽기블로그로 돌아가기
  • Clash Verge Rev
  • GeoData
  • 서비스 모드
  • 규칙 검증
  • v2.5.10
이 글의 목차
글 작성자
Clash 공식
게시일
예상 읽기 시간
약 8분

서비스 모드에서 GeoData를 업데이트하고 완료 메시지까지 보았는데 새 GEO 분류가 포함된 설정을 활성화하면 실패할 수 있습니다. 먼저 업데이트한 데이터와 검증에서 읽는 데이터가 각각 무엇인지 구분하세요. 바로 규칙을 삭제하거나 앱을 초기화하지 마세요.

GEO 업데이트가 완료되었는데 새 분류는 왜 검증에 실패하나요?

Clash Verge Rev v2.5.10 정식 릴리스 설명은 서비스 코어가 업데이트한 GEO 데이터베이스가 앱 디렉터리로 동기화되지 않아 새 분류를 사용하는 규칙이 검증에 실패하는 문제를 확인하고 있습니다. 모든 "분류를 찾을 수 없음" 오류가 이 때문인 것은 아니며, 사용 중인 데이터 소스에 필요한 분류가 있다는 보장도 아닙니다.

같은 소스의 새 데이터베이스에 해당 분류가 실제로 있고 서비스 업데이트도 성공했지만 재검증에서 앱의 이전 데이터베이스를 읽는 경우가 이 글의 대상입니다. 완료 알림만 보았고 실제 소스나 파일 내용을 모른다면 실패한 규칙과 최초 오류를 보존하세요. 곧바로 동기화 결함이라고 판단하지 마세요.

실제 상황에 따라 원인 구분하기

확인한 상황다음 단계
서비스 모드 업데이트가 성공했고 새 데이터베이스에 분류가 있음도 확인했지만 기존 설정에서 분류 오류가 계속 발생함이 글에 따라 앱 업데이트와 검증 전 동기화 확인
업데이트 중 다운로드 실패, 시간 초과 또는 파일 오류가 발생함해당 업데이트 오류부터 해결하고 새 데이터베이스가 있다고 가정하지 않음
실제 데이터 소스에 해당 분류가 없거나 규칙의 이름이 잘못됨해당 소스의 분류 목록과 규칙 이름 확인
rule-providers 파일이나 규칙 문법에서 실패함해당 파일, 형식, 최초 오류를 확인하고 GEO 동기화와 구분

서비스 실행 디렉터리와 앱 디렉터리의 데이터는 다를 수 있습니다

서비스 코어는 자체 실행 디렉터리에서 데이터를 업데이트하지만 앱의 사전 검증은 앱 설정 디렉터리를 읽습니다. 서비스에서 새 데이터베이스를 쓸 수 있어도 설정을 다시 활성화할 때 앱이 같은 데이터를 확보했다는 뜻은 아닙니다. 같은 작업만 반복하면 이전 분류 오류가 계속 발생할 수 있습니다.

공식 수정은 파일 사전 검증과 생성된 설정 검증 전에 서비스 데이터베이스를 다시 읽어 오도록 시도합니다. 검증 캐시에도 GEO 파일 크기와 수정 시각을 반영합니다. 따라서 Mihomo 코어만 업데이트하거나 규칙 순서를 한 번 바꾸는 것으로 Clash Verge Rev 앱 업데이트를 대신할 수 없습니다.

자동 동기화에는 조건이 있습니다. 현재 서비스 세션이 GEO 파일을 다시 읽어 오는 기능을 지원해야 하고 앱 디렉터리에 대상 파일이 이미 있어야 하며, 서비스 파일의 수정 시각이 앱 사본보다 반드시 더 늦어야 합니다. 기능이나 세션 또는 로컬 파일이 없으면 건너뛸 수 있습니다. 앱의 로컬 파일이 더 최신이면 서비스의 이전 사본으로 덮어쓰지 않습니다.

고정된 구현은 Country.mmdb, ASN.mmdb, geoip.dat, geosite.dat, geoip.metadb, GeoSite.dat를 처리합니다. 이는 동기화 대상 파일의 범위이며 모든 기기에서 이 파일을 전부 사용해야 한다는 뜻은 아닙니다. 임의의 사용자 지정 파일명까지 동기화된다는 의미도 아닙니다.

Mihomo의 geodata-mode는 GeoIP에 mmdb와 dat 중 어떤 형식을 사용할지 결정하고 geox-url은 해당 데이터 소스를 지정합니다. 실제 형식과 소스를 먼저 기록하세요. 검증을 통과시키려고 다른 형식의 확장자를 바꾸거나 분류가 다른 데이터베이스로 임의 교체하지 마세요.

작동하는 설정을 보존한 뒤 앱과 기존 소스의 데이터 업데이트하기

현재 Profile, 지속 적용되는 덮어쓰기, 기존 모드와 노드 선택을 저장하고 복원 가능한 사본도 따로 보관하세요. 실패한 전체 규칙, 분류 이름, 데이터 소스와 형식을 기록하고 직접 관리하는 데이터베이스 원본도 보존하세요. 공개 문의에는 민감 정보를 제거한 별도 사본을 사용하고 구독 토큰이나 전체 설정 묶음은 업로드하지 마세요.

이 글에서 확인한 정식 앱 수정 버전은 v2.5.10입니다. 같은 수정이 포함되었다는 근거가 있는 후속 정식 버전이라면 내릴 필요가 없습니다. 참고 자료의 공식 릴리스 소스에서 운영체제와 아키텍처, 기존 설치 방식에 맞춰 업데이트하세요. 이번 웹사이트 유지보수에서는 보관 중인 설치 파일을 교체하지 않습니다.

업데이트와 검증에서 같은 데이터 사용하기

  1. 정상 종료한 뒤 전체 앱 업데이트하기

    먼저 작업을 저장하세요. 네트워크를 중단할 수 있을 때 현재 트래픽 처리 설정을 기록하고 중지한 뒤 트레이에서 앱을 완전히 종료하고 공식 앱 업데이트를 진행하세요. 데이터 디렉터리는 보존하고 서비스 파일을 직접 교체하거나 데이터베이스를 삭제하지 마세요.

  2. 다시 열고 앱과 서비스 상태 확인하기

    실제 앱에 v2.5.10의 수정이 포함되어 있고 기존 설정과 덮어쓰기가 남아 있는지 확인하세요. 먼저 작동한다고 확인된 설정을 활성화해 서비스 코어를 실행한 뒤 데이터를 업데이트하세요. 서비스 비호환이나 시작 실패가 발생하면 해당 오류부터 해결하고 GEO 업데이트를 반복해서 누르지 마세요.

  3. 기존 소스에서 GeoData 업데이트하기

    "설정 → Clash 설정 → GeoData 업데이트"를 선택하세요. 기존 데이터베이스 소스와 형식, 필요한 프록시 경로를 유지하고 업데이트 결과를 기다리세요. 다운로드나 읽기 오류가 발생하면 최초 로그를 보존하고 알림이 닫힌 것을 성공으로 판단하지 마세요.

  4. 실패했던 기존 설정 다시 활성화하기

    직접 관리하는 원본 설정을 저장한 뒤 문제가 발생했던 같은 Profile을 활성화해 앱에서 다시 검증하도록 하세요. "GeoData가 업데이트되었습니다"만 확인하거나 다시 생성되는 실행 YAML을 직접 편집하지 마세요.

  5. 동기화 오류가 계속되면 추가 변경부터 멈추기

    로그에 failed to sync geo database가 나타나면 구체적인 파일과 이후 검증 결과를 기록하세요. 업데이트 알림은 코어의 업데이트 작업을 설명할 뿐입니다. 앱 사본, 분류 존재 여부, 설정 검증까지 모두 성공했다는 증거는 아닙니다.

같은 규칙이 검증을 통과하면 실제 일치 여부도 확인하세요

먼저 실패했던 설정을 저장하고 활성화할 수 있고 최초 분류 오류가 더 이상 나타나지 않으며 규칙의 원래 의미가 유지되는지 확인하세요. GEO 규칙을 삭제하거나 모두 직접 연결로 바꾸거나 문제 분류를 제거해서 "검증 통과"의 비교 의미를 없애지 마세요.

그다음 원래 필요했던 시스템 프록시나 TUN으로 해당 규칙에 일치해야 하는 새로운 실제 요청을 보내세요. 클라이언트의 "연결" 페이지에서 새 연결에 일치한 규칙과 실제 출구를 확인하고 실제 작업도 성공하는지 살펴보세요. 기존 장기 연결, 노드 지연 시간 또는 업데이트 알림은 이 검사를 대신할 수 없습니다.

앱을 정상적으로 다시 열고 같은 설정을 활성화해 재확인하세요. 재시작 후 다시 실패하면 새 최초 오류를 보존하고, 다른 소스가 데이터를 다시 덮어썼는지, 서비스에서 다시 읽어 올 수 없는지, 실제로 분류가 없는지 구분하세요. 업데이트 알림 한 번으로 장기 복구를 선언하지 마세요.

문제 해결 확인 목록

  • 실제 Clash Verge Rev 앱에 해당 동기화 수정이 포함되어 있고 기존 서비스 모드가 정상 작동합니다.
  • 실제 데이터 소스와 형식을 알고 있으며 사용하는 데이터베이스에 필요한 분류가 있습니다.
  • 문제가 발생했던 기존 Profile이 다시 검증되고 활성화되며 규칙이 삭제되거나 다른 의미로 바뀌지 않았습니다.
  • 새 실제 요청이 예상한 규칙과 출구에 일치하고 평소 작업이 정상 작동합니다.
  • 정상적으로 다시 연 뒤에도 같은 설정을 활성화할 수 있습니다. 동기화 경고가 있다면 구체적인 원인을 확인했습니다.

이 사이트는 실제 클라이언트를 설치하거나 직접 시험해 해당 문제를 재현하지 않았습니다. 이 글은 공식 릴리스 설명, 고정된 소스 코드와 Mihomo 문서를 근거로 합니다. 웹사이트의 다국어, 소스 수준 검사와 브라우저 검사가 사용자 기기의 데이터베이스 및 실제 트래픽 분기 검증을 대신하지는 않습니다.

계속 실패하면 파일 및 분류 오류에 따라 복원하세요

GeoData 업데이트 자체가 실패함

기존 소스에 접근할 수 있는지, 사용하는 프록시 경로와 최초 다운로드 또는 파일 오류를 확인하고 사용 가능한 원본을 보존하세요. 출처 불명의 데이터베이스를 가져오거나 디스크 전체 권한 또는 시스템 시간을 바꿔 강제로 통과시키지 마세요.

동기화 경고가 있거나 앱 디렉터리에 대상 파일이 없음

구체적인 파일명과 서비스 상태를 보존하고 프로젝트에서 지원하는 절차로 호환되는 서비스 구성 요소와 앱의 로컬 데이터를 점검하세요. 이 수정은 없는 파일을 자동으로 채워 주는 기능이 아닙니다. 서비스 실행 디렉터리에 파일을 직접 넣지 마세요.

업데이트와 동기화 후에도 특정 분류가 없다고 표시됨

데이터 소스의 실제 분류 목록, 이름 철자와 사용 형식을 다시 확인하세요. 소스마다 분류를 서로 바꿔 쓸 수 없으므로 이 결과를 계속 이전 데이터베이스 동기화 문제로 판단하지 마세요.

업데이트 후 원래 작동하던 설정도 사용할 수 없음

현재 상태를 따로 저장하고 업그레이드 전에 검증한 설정, 기존 소스 및 그에 맞는 데이터베이스 사본으로 먼저 복원하세요. 당장은 새 분류를 참조하지 마세요. 앱 버전을 되돌려야 한다면 프로젝트에서 지원하는 방식으로 진행하고 새 프로그램과 이전 프로그램이 유일한 데이터 디렉터리를 동시에 사용하지 않도록 하세요.

당장 앱을 업데이트하거나 데이터를 확인할 수 없다면 직접 검증한 이전 설정으로 작업을 계속하고 보류 중인 규칙은 보존하세요. 이는 작업을 복구하는 방법일 뿐 이전 버전의 동기화 결함이 해결되었다는 뜻은 아닙니다. 모든 GEO 규칙을 영구적으로 끌 필요도 없습니다.

문의할 때는 운영체제, 전체 앱 버전, 서비스 모드, 민감 정보를 제거한 실패 규칙, 데이터베이스 소스와 형식, 업데이트와 동기화 및 검증 각 단계의 결과를 설명하세요. 마지막 오류만 제공하지 말고 민감한 대상이나 전체 로그 묶음을 공개하지 마세요.

참고 자료