GeoIP·GeoSite 규칙 데이터 업데이트 방법: dat 파일 출처와 교체 경로, 라우팅 규칙 작성법

geoip.dat와 geosite.dat의 역할부터 v2rayN·v2rayNG 업데이트 메뉴와 수동 교체 경로, geosite·geoip 접두사 규칙 작성 및 문제 해결까지 알아봅니다.

핵심 내용

평소에는 클라이언트에 내장된 Geo 업데이트 기능을 이용하는 것이 좋습니다. 파일을 직접 교체하기 전에 현재 사용 중인 코어가 어떤 파일을 읽는지, 라우팅 규칙에서 어떤 태그를 참조하는지 확인하세요. 교체 후에는 연결을 다시 시작하고 로드 로그를 확인한 다음, 도메인과 IP로 각각 규칙이 적용되는지 테스트합니다.

GeoIP와 GeoSite는 각각 무엇을 매칭하나요?

geoip.dat에는 IP 대역 그룹이 들어 있으며 geoip: 규칙에서 사용합니다. geosite.dat에는 도메인 그룹이 들어 있으며 geosite: 규칙에서 사용합니다. 규칙 데이터는 매칭 조건만 제공하며 트래픽의 목적지를 결정하지는 않습니다. 규칙에 매칭된 트래픽을 직접 연결할지 프록시로 보낼지는 해당 라우팅 규칙에 지정된 아웃바운드에 따라 결정됩니다.

2
개의 데이터 파일: IP 데이터베이스와 도메인 데이터베이스
3
개의 규칙 예시: 도메인, IP, 기본 처리
443
HTTPS의 기본 목적지 포트일 뿐, 분기 조건은 아닙니다

두 가지 요청으로 먼저 테스트

테스트할 때는 대상 그룹에 포함된 것으로 확인된 도메인 하나와 대상 IP 대역에 속하는 것으로 확인된 IP 하나에 각각 접속하세요. 같은 URL을 브라우저에서 한 번 여는 것만으로는 GeoSite가 먼저 매칭됐는지, DNS 조회 후의 주소가 GeoIP에 매칭됐는지 구분할 수 없습니다.

dat 파일 출처: 클라이언트에서 업데이트하거나 직접 교체하기

규칙 데이터가 제대로 작동하려면 두 가지 조건을 충족해야 합니다. 현재 코어에서 파일을 읽을 수 있어야 하고, 파일에 사용 중인 규칙이 참조하는 그룹이 있어야 합니다. 파일명이 같다고 그룹 목록까지 같은 것은 아닙니다. 예를 들어 파일을 교체한 뒤에도 cn 그룹은 남아 있지만, 기존에 사용하던 확장 분류 그룹은 없을 수 있습니다.

클라이언트 내장 업데이트

권장

클라이언트가 현재 설정에 따라 파일을 내려받아 Geo 리소스 디렉터리에 저장하므로 대상 경로를 직접 찾을 필요가 없습니다. 업데이트 주소를 변경한 적이 있다면 설정에서 예상한 데이터 출처를 가리키는지 먼저 확인하세요.

추천 대상: 사용자 지정 분류 없이 평소 사용하는 라우팅 리소스만 업데이트하려는 경우

유지관리 프로젝트에서 dat 파일 받기

IP 데이터베이스는 V2Fly의 geoip 프로젝트에서, 도메인 데이터베이스는 V2Fly의 domain-list-community 프로젝트에서 확인할 수 있습니다. 도메인 데이터베이스의 빌드 결과물은 보통 dlc.dat라는 이름으로 배포됩니다. 호환되는 도메인 데이터베이스를 받았다면 클라이언트 기본 방식으로 불러올 수 있도록 파일명을 geosite.dat로 바꾸세요. 릴리스 안내에서 그룹 구성을 확인할 수 있지만, 프로젝트 소스 압축 파일이나 일반 텍스트 목록은 확장자만 바꾼다고 dat 파일이 되지 않습니다.

추천 대상: 정해진 규칙 출처를 사용하거나 오프라인으로 파일을 교체하거나 이전 데이터베이스를 복원하려는 경우

한 유지관리 프로젝트에서 다른 프로젝트로 바꾸기 전에 현재 사용 중인 geosite: 및 geoip: 항목을 기록하세요. 배포처의 그룹 설명을 참고해 각 항목을 하나씩 확인합니다. 흔히 쓰이는 cn만 확인하지 말고 사용자 지정 라우팅 템플릿에서 사용하는 확장 태그도 점검하세요.

v2rayN·v2rayNG 업데이트 메뉴와 파일 교체 경로

  1. 현재 라우팅 설정 확인

    현재 활성화된 라우팅 설정과 참조 중인 Geo 태그를 먼저 기록하세요. Geo 리소스 업데이트와 구독 업데이트는 별개입니다. 구독 업데이트가 성공했더라도 노드 목록이 새로고침된 것일 뿐, 규칙 데이터가 교체됐다는 뜻은 아닙니다.

  2. 데스크톱 내장 업데이트

    v2rayN 메인 창에서 「업데이트 확인」을 열고 「Geo 파일」에 해당하는 업데이트 항목을 선택하세요. 영문 인터페이스에서는 Geo files를 찾으면 됩니다. 작업이 끝날 때까지 기다린 뒤 메인 창의 로그를 확인하세요. 다운로드 시간 초과나 파일 저장 실패가 표시되면 해당 문제를 먼저 해결하고 파일이 업데이트됐는지 확인합니다.

  3. 안드로이드 내장 업데이트

    v2rayNG 왼쪽 상단 메뉴에서 「Geo 리소스 파일」로 이동한 다음, 해당 화면에서 다운로드 또는 업데이트 기능을 사용해 리소스를 새로고침하세요. 먼저 연결을 끊고, 업데이트가 끝나면 메인 화면으로 돌아가 다시 연결합니다. 버전이나 인터페이스 언어에 따라 기능이 툴바 아이콘으로 표시될 수 있습니다.

  4. 데스크톱에서 파일 직접 교체

    먼저 v2rayN을 종료하세요. 일반적인 7.x 데스크톱 디렉터리 구성에서는 두 파일이 프로그램 디렉터리 또는 실제 데이터 디렉터리의 bin/ 아래에 있습니다. 현재 실행 중인 인스턴스에서 bin/geoip.dat와 bin/geosite.dat를 찾아 백업 디렉터리에 복사한 다음, 새 파일을 원래 이름으로 해당 위치에 넣으세요. 업그레이드 후 프로그램 디렉터리가 여러 개 남아 있다면 이전 인스턴스의 같은 이름 파일을 덮어쓰지 않도록 주의하세요.

  5. 안드로이드에서 파일 직접 가져오기

    먼저 dat 파일을 시스템 파일 선택기에서 접근할 수 있는 「다운로드」 폴더 등에 저장한 다음, v2rayNG의 「Geo 리소스 파일」 화면에서 로컬 파일 가져오기를 사용하세요. 일반적인 외부 리소스 경로는 Android/data/com.v2ray.ang/files/assets/입니다. 이 경로는 공용 「다운로드」 폴더와 다르며 시스템 접근이 제한될 수 있습니다. 앱 내 가져오기 기능이 있다면 앱을 통해 가져오세요. 앱 디렉터리에 직접 파일을 쓰지 않아도 됩니다.

  6. 연결을 다시 시작해 확인하기

    데스크톱에서는 클라이언트를, 안드로이드에서는 연결을 다시 시작하세요. 코어가 정상적으로 시작되는지 확인한 뒤 같은 도메인과 IP 조합으로 다시 테스트합니다. 수동 업데이트 직후 로드 오류가 발생하면 먼저 백업을 복원한 다음 파일 형식, 저장 경로, 태그를 확인하세요.

라우팅 규칙 작성법: 도메인, IP, 마지막 기본 규칙

v2rayN의 「설정」→「라우팅 설정」에서 현재 사용 중인 라우팅 설정을 편집할 때 도메인 조건에는 geosite:cn, IP 조건에는 geoip:private를 입력하세요. 두 조건을 각각 독립적인 직접 연결 조건으로 쓰려면 규칙을 두 개로 나눕니다. 한 줄을 줄이려고 둘을 같은 규칙에 넣지 마세요. Xray 필드 규칙에서는 서로 다른 매칭 필드가 모두 충족되어야 하며, 둘 중 하나만 충족하는 방식이 아닙니다.

아래는 Xray 설정의 routing 객체 예시이며 완전한 설정 파일은 아닙니다. direct와 proxy는 기존 아웃바운드의 실제 태그와 일치해야 합니다. 클라이언트 입력 화면에서 편집한다면 각 항목을 해당 필드에 입력하세요. JSON 전체를 도메인 입력란에 붙여 넣지 마세요.

{
  "domainStrategy": "IPIfNonMatch",
  "rules": [
    {
      "type": "field",
      "domain": ["geosite:cn"],
      "outboundTag": "direct"
    },
    {
      "type": "field",
      "ip": ["geoip:private"],
      "outboundTag": "direct"
    },
    {
      "type": "field",
      "network": "tcp,udp",
      "outboundTag": "proxy"
    }
  ]
}

업데이트 후 자주 발생하는 오류와 라우팅 문제 해결

파일을 바꾼 뒤 코어에서 dat 파일을 찾지 못한다고 하나요?

시작 로그에서 찾지 못한 파일이 geoip.dat인지 geosite.dat인지 확인하세요. 현재 실행 중인 인스턴스의 파일을 교체했는지, 압축을 푼 뒤 디렉터리가 한 단계 더 생기지 않았는지, 전체 파일명 끝에 불필요한 .txt 또는 .dat 확장자가 붙지 않았는지 확인합니다. 수정 후 클라이언트를 다시 시작하세요. 다운로드 폴더에 파일이 있는지만 확인해서는 안 됩니다.

파일이 있는데도 그룹을 찾을 수 없다고 하나요?

로그에서 정확한 태그명을 찾은 뒤 해당 태그가 도메인 데이터베이스와 IP 데이터베이스 중 어느 쪽에 속하는지 확인하세요. 먼저 기존 데이터베이스를 복원하거나 유효하지 않은 참조를 제거해 코어가 정상적으로 시작되게 합니다. 그런 다음 새 출처에 같은 의미의 그룹이 있는지 확인하세요. 그룹의 의미를 확신할 수 없다면 해당 규칙을 명시적인 도메인이나 IP 대역으로 작성하세요.

업데이트에 성공했는데도 이 URL이 이전 경로로 나가나요?

현재 연결에서 사용하는 라우팅 설정을 확인한 다음, 해당 규칙보다 앞에서 이미 매칭되는 규칙이 있는지 살펴보세요. 기존 테스트 연결을 종료하고 다시 시도하세요. 기존 연결은 생성 당시의 아웃바운드를 계속 사용할 수 있습니다. 접속 로그를 확인할 수 있다면 요청의 도메인이나 IP를 아웃바운드 태그와 대조하세요. 웹페이지가 열리는지만으로 판단하지 마세요.

PC와 휴대폰의 규칙이 같은데 결과가 다른가요?

먼저 두 기기에서 사용하는 dat 파일 출처와 활성 라우팅 설정을 비교하세요. 구독 주소만 비교해서는 안 됩니다. 테스트 트래픽이 두 기기의 클라이언트를 실제로 통과하는지도 확인하세요. 데스크톱에서는 앱이 시스템 프록시를 사용하는지 또는 TUN이 트래픽을 처리하는지 확인하고, 안드로이드에서는 해당 앱이 VPN 처리 대상에 포함됐는지 확인합니다. 마지막으로 로그의 목적지 주소를 비교하세요. 두 기기에서 DNS 조회 결과가 다를 수 있습니다.

v2rayN 클라이언트플랫폼별 다운로드 안내 보기