· 설정 가이드

왜 GeoSite·GeoIP 데이터 경로가 문제를 만드나

Clash Verge Rev처럼 Mihomo(Clash Meta) 코어를 감싼 클라이언트를 쓰다 보면, 프록시 노드와 구독은 멀쩡한데 도메인 규칙만 자꾸 빗나가거나 GEOIP 줄이 기대와 다른 결과를 내는 상황을 마주칩니다. 이때 원인의 상당 부분은 「규칙 문법을 몰라서」라기보다 지오데이터(geodata) 파일이 어디서 내려받혔는지, 실제 실행 중인 코어가 어느 경로의 geoip·geosite를 읽고 있는지가 서로 어긋나서 생깁니다. 특히 회사망·교육망처럼 특정 CDN이 막힌 환경에서는 자동 업데이트가 조용히 실패하고, 사용자는 화면에서는 아무 일도 없었다고 느낀 채 오래된 카탈로그만 붙잡고 있는 경우가 많습니다.

이 글은 검색 의도를 이렇게 잡고 씁니다. 「Clash Verge Rev GeoSite 설정과 catalog geodata가 서로 다른 이름으로 불릴 때 무엇을 같은 축으로 묶어 생각해야 하는가」, 「프로필의 geox-url과 디스크 위치를 어떻게 맞추면 다음 갱신부터 추적 가능한가」, 「GeoIP·Mihomo geo 데이터를 수동으로 교체했을 때 무엇을 로그로 증명할 수 있는가」입니다. DNS와 스니퍼에 더 가까운 내용은 Fake-IP·DNS 가이드와 스니퍼 가이드를 함께 보시고, 여기서는 지오 파일 자체의 출처·경로·버전에 초점을 맞춥니다.

geoip·geosite·country.mmdb가 하는 일을 한 번에 정리하기

Mihomo 계열에서 자주 등장하는 파일은 다음 세 가지입니다. 이름은 빌드·배포판에 따라 미묘하게 다를 수 있지만, 개념은 동일합니다.

  • geoip.dat · IP 대역이 어느 국가·지역 코드에 속하는지 빠르게 조회할 때 씁니다. GEOIP,CN 같은 줄과, DNS의 fallback-filter에서 geoip 조건을 거는 시나리오와 연결됩니다.
  • geosite.dat · 도메인을 카테고리 묶음으로 관리하는 GeoSite 카탈로그입니다. 프로필 안의 GEOSITE 키워드나 RULE-SET이 참조하는 태그 이름이 이 파일 안의 라벨과 맞아야 기대한 분기가 나옵니다.
  • country.mmdb(혹은 배포본이 안내하는 동등 포맷) · 국가 단위 매핑을 또 다른 경로로 제공하는 경우가 있습니다. 자동 갱신 기능이 일부 파일만 덮어쓴다는 이슈 보고가 과거에 있었으므로, 수동 점검 시 세 파일을 한 세트로 보는 습관이 안전합니다.

중요한 관점은 「파일이 존재한다」가 아니라 실행 중 코어가 방금 그 파일을 읽었다는 증거를 남기는 것입니다. 사용자 폴더에 새 파일을 넣어 두었지만 YAML이 다른 디렉터리를 가리키면, 탐색기에서는 성공한 것처럼 보여도 규칙은 바뀌지 않습니다.

프로필에서 geox-url과 자동 갱신 옵션 읽는 법

작동 중인 설정은 항상 「지금 Verge Rev가 띄운 그 프로필」입니다. 원격 템플릿을 여러 개 두었다면, 편집기에서 열어 둔 파일과 실제 런타임 파일이 다를 수 있으니 외부 컨트롤러에서 활성 프로필 경로를 먼저 확인하는 습관이 좋습니다. Mihomo 쪽에서는 미러 URL을 한 번에 바꾸기 위해 상위 키로 geox-url 블록을 쓰는 패턴이 널리 쓰입니다.

# Example — URLs and keys vary by core version; mirror responsibly.
geox-url:
  geoip: "https://example.com/path/geoip.dat"
  geosite: "https://example.com/path/geosite.dat"
  mmdb: "https://example.com/path/country.mmdb"

geo-auto-update: true
geo-update-interval: 24

위 예시는 구조를 보여 주기 위한 것으로, 실제 키 이름·기본값·지원 여부는 설치한 코어 버전 릴리스 노트를 우선합니다. 커뮤니티 미러(jsDelivr, GitHub Releases 등)를 쓸 때는 회사 방화벽이 특정 호스트만 허용하는지, 중간 캐시가 오래된 바이너리를 주고 있지 않은지까지 함께 봐야 합니다. URL을 바꿨는데도 행동이 그대로라면, 다음 절의 「디스크 상 실파일」과 대조하세요.

ℹ️
정렬 포인트: geox-url은 「앞으로 어디에서 받을지」를 적는 곳이고, 이미 내려받은 바이너리가 있다면 그 파일의 실제 경로·수정 시각이 더 우선입니다. 둘을 동시에 적어 두면 나중에 장애 때 원인을 빠르게 가릅니다.

Clash Verge Rev에서 저장 경로를 찾는 현실적인 순서

GUI 클라이언트는 버전마다 메뉴 이름이 조금씩 다르지만, 확인 순서는 공통적입니다. 첫째, 앱 설정에 프로필 디렉터리·리소스 디렉터리·데이터 폴더를 보여 주는 항목이 있는지 살펴봅니다. 둘째, 운영체제별 애플리케이션 지원 폴더(Windows의 AppData, macOS의 Application Support 등) 아래에 생성된 Mihomo·Verge 관련 하위 폴더에서 geoip.dat·geosite.dat·country.mmdb를 검색합니다. 셋째, 같은 이름의 파일이 두 군데 있다면 수정 시각이 최근인 쪽이 실사용 후보입니다.

이 과정에서 가장 흔한 착시는 「앱 내부의 업데이트 버튼을 눌렀다」와 「디스크의 타임스탬프가 갱신됐다」를 동일시하는 것입니다. 버튼은 네트워크 오류나 권한 문제로 조용히 실패할 수 있으므로, 반드시 파일 시스템에서 확인합니다. 여러 프로필을 오가며 테스트한다면 프로필별로 경로가 갈라지는지도 함께 기록해 두세요.

오프라인 수동 갱신을 재현 가능하게 만드는 체크리스트

아래 순서는 「한 번 성공했다」가 아니라 나중에 같은 방법으로 다시 할 수 있다는 기준으로 씁니다.

1) 교체 전 스냅샷 남기기

기존 세 파일을 같은 폴더에 .bak-YYYYMMDD처럼 붙여 복사합니다. 용량은 크지 않아서 보관 부담이 적고, 새 데이터가 이상할 때 즉시 되돌릴 수 있습니다.

2) 신뢰 가능한 출처에서 동일 파일명으로 받기

공식 릴리스나 검증된 규칙 데이터 저장소를 쓰고, 가능하면 릴리스 페이지에 적힌 날짜·커밋 해시를 메모합니다. 브라우저가 자동으로 확장자를 바꾸지 않았는지, 다운로드 관리자가 반쪽 파일을 남기지 않았는지 확인합니다.

3) 덮어쓰기 직후 크기와 수정 시각 확인

파일 크기가 0바이트 근처가 아닌지, 수정 시각이 방금이 맞는지 봅니다. 원격 미러가 HTML 에러 페이지를 내려받은 경우 크기는 작아 보여도 내용이 전혀 다른 물리 파일일 수 있습니다.

4) 코어 재시작 후 로그에서 로드 메시지 확인

재시작 뒤 로그 레벨을 잠시 높여 geodata 관련 라인이 있는지 살펴봅니다. 특정 RULE-SET가 실패했다는 메시지가 반복되면, 이번에 교체한 파일이 아니라 rule-providers URL 쪽일 수 있으니 메시지 텍스트를 그대로 저장해 다음 분기 추적에 씁니다.

⚠️
주의: 출처 불명의 geo 바이너리는 규칙 자체가 조작되었을 위험이 있습니다. 「속도가 빠르다」는 이유만으로 이웃 서버의 무결성이 검증되지 않은 패키지를 그대로 넣지 마세요.

RULE-SET·GEOSITE 이름 불일치를 빠르게 가르는 방법

데이터는 최신인데도 규칙이 안 먹는다면 카탈로그 이름이 빗나간 경우가 많습니다. 예를 들어 커뮤니티 템플릿은 youtube 같은 태그를 전제로 하는데, 실제로 내려받은 geosite 번들에는 다른 네이밍만 포함되어 있을 수 있습니다. 이때는 단순히 파일만 바꾸는 것으로 끝나지 않고 프로필 안의 GEOSITE 라벨을 데이터 소스 문서와 대조해야 합니다.

rule-providers로 원격 규칙을 당겨 오는 경우도 마찬가지입니다. 파일형 규칙과 GeoSite 카탈로그를 혼동하면 「데이터를 고쳤는데 왜 이 줄만 안 바뀌지?」라는 느낌이 듭니다. 로그에 어떤 파일을 파싱했는지가 찍히면 그 문자열을 기준으로 원인을 좁히세요.

검증: 로그와 규칙 트레이스를 한 세트로 보기

수동 갱신의 성공 정의는 「파일 날짜가 바뀌었다」가 아니라 문제였던 트래픽에서 기대한 정책으로 매칭이 바뀌었다는 재현입니다. 그래서 테스트할 도메인·앱·프로토콜(예: 특정 브라우저 프로필만)을 고정하고, 전후를 한 화면에 남깁니다. TUN을 같이 쓴다면 경로가 더 길어지므로 TUN 모드 가이드의 순서와 충돌이 없는지도 확인합니다.

디버그 로그가 부담스럽다면 최소한 「어떤 규칙 타입이 마지막에 이겼는지」만이라도 남기세요. 나중에 커뮤니티에 질문할 때 질문 품질이 달라집니다.

업데이트가 자주 실패하는 네트워크에서의 미러 전략

자동 갱신이 CDN 단절로 실패하면 지오 파일만 다른 미러로 바꿔도 체감이 크게 달라집니다. 이때 중요한 것은 모든 파일을 서로 호환되는 세트로 맞추는 것입니다. geoip만 새로 geosite만 옛날처럼 어긋나면 증상이 더 혼란스러워질 수 있습니다. 내부 HTTP 프록시를 쓰는 회사라면 프록시 우회 목록에 미러 호스트가 들어가 있는지도 함께 확인하세요.

자주 묻는 질문

버튼 한 번으로 업데이트되는데 왜 YAML까지 손대나요?

GUI 버튼은 편하지만 실패가 조용하거나 특정 파일만 갱신되는 버전 차이가 있었습니다. YAML의 geox-url을 명시해 두면 「어디에서 무엇을 받게 해 두었는지」가 텍스트로 남고, 이후 수동 교체와도 연결하기 쉽습니다.

Geo 데이터와 일반 구독 노드 업데이트는 무엇이 다른가요?

노드 구독은 프록시 엔드포인트 목록이고, geo 파일은 분류표입니다. 후자가 오래되면 노드가 아무리 신선해도 지역 분기는 틀어집니다.

WSL이나 다른 클라이언트와 파일을 공유해도 되나요?

경로 매핑이 정확하고 코어가 동시에 쓰지 않는다면 가능하지만, 잠금 충돌·권한 문제가 나기 쉽습니다. 가능하면 실행 인스턴스마다 독립 폴더를 두고 필요할 때만 같은 바이너리를 복사하는 편이 안전합니다.

문서·설치 안내와 함께 보기

프로필의 전체 구조를 처음 맞춘다면 문서의 설치·구성 안내를 같이 보는 것이 좋습니다. 다운로드와 검증된 패키지 선택은 공식 다운로드 페이지에서 정리되어 있습니다.

정리

Clash Verge Rev GeoSite 설정을 말할 때 UI 스위치만 떠올리기 쉽지만, 실제 분기 품질은 지오데이터 파일의 출처·경로·버전과 프로필이 참조하는 카탈로그 이름이 동시에 맞아야 결정됩니다. geox-url로 미러를 고정하고, 디스크에서 파일 타임스탬프로 자동 업데이트 성공 여부를 교차 확인한 다음, 필요 시 수동 교체로 한 번에 세트를 맞추면 재현 가능한 운영이 됩니다.

반대로 일부 범용 클라이언트는 지오 파일 위치가 추상화되어 있거나 오류 메시지가 단순해, 문제가 DNS나 규칙 문법 쪽으로 오해되기 쉽습니다. 같은 Mihomo 코어라도 어디에 무엇이 적혀 있는지를 텍스트와 파일 시스템 양쪽에서 동시에 보여 주는 흐름이 중요합니다. ClashSky 계열 경험에서는 프로필과 리소스 경로를 분명히 두고, 검증된 바이너리 출처를 고수하는 편이 장기적으로 덜 지치는 선택입니다.

지금 환경에서 경로 정렬과 데이터 검증을 바로 적용해 보고 싶다면 Clash 공식 다운로드 페이지에서 클라이언트를 고르세요. → Clash를 무료로 내려받아 GeoSite·GeoIP 분기를 안정적으로 맞춰 보시길 권합니다.