GeoIP·GeoSite 데이터베이스 업데이트 가이드: 라우팅 규칙에서 geoip.dat·geosite.dat 사용법

GeoIP와 GeoSite는 무엇을 매칭할까?

geosite.dat에는 태그별 도메인 규칙 집합이 저장됩니다. 항목은 전체 도메인, 도메인 접미사 또는 그 밖에 지원되는 매칭 형식일 수 있습니다. geoip.dat에는 태그별 IP 대역 집합이 저장되며, 국가·지역별 분류와 특정 용도의 주소 분류가 포함되는 경우가 많습니다. 두 파일 모두 바이너리 데이터베이스이므로 일반 도메인 텍스트의 파일명만 바꿔서는 사용할 수 없습니다.

geosite:cn은 “.cn으로 끝나는 모든 도메인”이 아니라 데이터베이스에서 cn이라는 이름으로 정의된 집합입니다. 다른 도메인 접미사가 포함될 수도 있고 새로 개설된 사이트가 아직 등록되지 않았을 수도 있습니다. geoip:cn은 데이터베이스의 IP 대역을 기준으로 매칭하므로 웹사이트 운영 주체 또는 사용자의 위치를 판단할 수는 없습니다.

geoip:private는 사설망 및 특수 용도 주소를 직접 연결하는 규칙에 자주 사용되지만, 모든 로컬 네트워크 도메인을 포함하는 목록은 아닙니다. 예를 들어 192.168.1.1은 IP 대상이고 printer.local은 도메인 대상이므로 후자는 이름 해석도 필요합니다. 특정 주소가 포함되어 있는지는 현재 데이터베이스 내용을 기준으로 확인하세요.

시스템 프록시를 확인한 뒤 업데이트 방법 선택하기

라우팅 규칙은 프록시 코어에 전달된 연결만 처리합니다. macOS 시스템 프록시는 시스템 프록시 설정을 따르는 앱에 주로 적용됩니다. 앱이 시스템 프록시를 우회한다면 GeoSite 규칙을 바꿔도 연결 경로가 달라지지 않을 수 있습니다. TUN은 더 많은 트래픽을 처리할 수 있지만 라우팅, DNS, 제외 항목도 확인해야 합니다. 스위치가 켜져 있다는 이유만으로 모든 요청이 코어에 전달된다고 단정할 수는 없습니다.

데이터베이스 업데이트, 구독 업데이트, 코어 업데이트는 서로 다른 작업입니다. 구독에는 노드 매개변수가, 데이터베이스에는 라우팅에 참조할 수 있는 집합이 들어 있으며, 코어는 설정을 실행합니다. VMess 또는 VLESS 노드로 바꿔도 데이터베이스 태그가 자동으로 수정되지는 않으며, 데이터베이스를 업데이트해도 사용할 수 없는 노드 인증 정보가 복구되지는 않습니다.

v2rayN에서 Geo 파일 업데이트하기

v2rayN 메뉴 이름은 버전과 인터페이스 언어에 따라 다를 수 있습니다. 일반적인 데스크톱 화면에서는 「업데이트 확인」→「Geo files 업데이트」에서 진행합니다. GeoIP와 GeoSite가 별도 항목으로 표시되면 각각 업데이트하세요. 아래 안내는 흔히 볼 수 있는 메뉴를 기준으로 하며, 특정 버전의 메뉴 위치가 모든 플랫폼에서 같다고 가정하지 않습니다.

1. 현재 코어 확인

   메인 화면에서 현재 노드와 실행 로그에 표시된 코어 이름을 확인하세요. 이 문서의 설정 예시는 DAT 데이터베이스를 읽는 Xray 또는 V2Ray용입니다. 현재 설정이 다른 규칙 형식을 사용한다면 그대로 적용하지 마세요.

2. 기존 규칙 보관

   「설정」→「라우팅 설정」을 열어 현재 활성화된 라우팅 프리셋, 규칙 순서, 도메인 전략을 기록하세요. 사용자 지정 규칙을 사용한다면 문제가 생겼을 때 복구할 수 있도록 먼저 기존 내용을 저장해 두세요.

3. 파일 업데이트 실행

   「업데이트 확인」→「Geo files 업데이트」를 선택하세요. 메뉴에 「GeoIP 업데이트」와 「GeoSite 업데이트」가 따로 있으면 두 항목을 차례로 실행하고 각각의 결과가 표시될 때까지 기다리세요.

4. 코어 다시 불러오기

   다운로드가 끝나면 클라이언트에서 코어를 재시작하세요. 해당 메뉴를 찾지 못하면 클라이언트를 정상 종료한 뒤 다시 실행합니다. 구독만 새로고침하는 것보다 데이터베이스를 다시 읽도록 하는 편이 문제 확인에 효과적입니다.

5. 로드 로그 확인

   데이터베이스 읽기 실패, 집합을 찾을 수 없음, 라우팅 설정 오류가 없는지 확인하세요. 그런 다음 직접 연결이 확실한 대상과 프록시 연결이 확실한 대상을 각각 테스트해 실제 아웃바운드가 예상대로인지 점검합니다.

파일을 직접 다룰 때는 먼저 코어를 중지하고 클라이언트 로그나 리소스 디렉터리 설정에서 실제 파일 위치를 확인하세요. 앱 설치 디렉터리와 사용자 데이터 디렉터리는 다를 수 있으며, macOS에서는 데이터베이스를 앱 번들에 넣는다고 가정해서는 안 됩니다. 교체 후 태그가 누락되면 규칙을 계속 추가하기보다 기존 파일을 복원하는 편이 원인을 찾기 쉽습니다.

geosite:cn과 geoip:private 올바르게 사용하기

아래는 Xray/V2Ray 형식의 routing 설정 일부이며, 단독으로 실행할 수 있는 전체 설정이 아닙니다. 예시에 나오는 direct와 proxy는 전체 설정에 이미 정의된 아웃바운드 태그와 일치해야 합니다. v2rayN은 실행용 설정을 생성하므로 클라이언트의 라우팅 편집기에서 수정하는 것이 좋습니다. 생성 후 곧 덮어써질 임시 파일은 직접 편집하지 마세요.

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

• 도메인 집합은 domain에 지정합니다:geosite:cn은 도메인 집합을 참조합니다. full:example.com은 해당 도메인만 매칭하며 하위 도메인까지 자동으로 포함하지 않습니다.
• IP 집합은 ip에 지정합니다:geoip:private와 geoip:cn을 같은 배열에 넣으면 대상 IP가 두 집합 중 하나에만 포함되어도 매칭됩니다.
• 서로 다른 필드는 일반적으로 모두 충족해야 합니다: 하나의 규칙에 domain과 ip를 함께 지정해도 “도메인 또는 IP 중 하나만 일치하면 된다”는 뜻은 아닙니다. 각각 따로 매칭하려면 규칙을 두 개로 나누세요.
• 화면 입력란과 JSON은 다릅니다: 클라이언트의 도메인 목록 입력란에는 보통 geosite:cn만 입력하면 되며 바깥쪽 JSON을 붙여 넣을 필요는 없습니다. 먼저 입력란이 도메인 목록용인지, IP 목록용인지, 전체 설정 편집기인지 확인하세요.

예시의 example.com은 정확한 도메인 매칭을 보여 주기 위한 값일 뿐입니다. 실제 사용 시에는 원하는 아웃바운드로 보내야 하는 도메인으로 바꾸세요. 마지막 규칙은 TCP/UDP 트래픽을 명시적으로 처리하는 기본 규칙이며, 모든 클라이언트의 기본 동작을 뜻하지는 않습니다. 기본 규칙이 없다면 매칭되지 않은 트래픽은 보통 기본 아웃바운드로 전달되지만, 기본 아웃바운드가 반드시 프록시라고 가정해서는 안 됩니다.

규칙 순서와 DNS 전략 함께 설정하기

규칙은 순서대로 검사하며, 매칭되면 해당 아웃바운드를 사용하고 더 “정확한” 다음 규칙을 계속 찾지 않습니다. 일반적으로 명시적인 예외를 먼저 배치하고, 그다음 도메인 집합, IP 집합, 마지막으로 기본 규칙을 둡니다. 모든 TCP/UDP 연결을 처리하는 규칙을 맨 앞에 두면 뒤의 GeoSite·GeoIP 규칙은 해당 연결을 처리할 수 없습니다.

특히 주의하세요. 앞의 예시는 IPIfNonMatch를 사용하며 마지막에 기본 규칙도 설정되어 있습니다. 도메인이 geosite:cn에 매칭되지 않더라도 기본 규칙에 먼저 매칭될 수 있으므로, “GeoSite에 매칭되지 않았다”는 이유만으로 추가 IP 해석이 반드시 진행되는 것은 아닙니다. 이 예시는 도메인 기준 라우팅을 우선하며, IP 규칙은 대상이 처음부터 IP인 연결에도 적용될 수 있습니다.

분류되지 않은 도메인을 해석한 뒤 GeoIP로 라우팅해야 한다면 기본 규칙과 기본 아웃바운드를 다시 설계하거나 IPOnDemand 사용을 검토할 수 있습니다. 이때 규칙 순서도 함께 확인해야 합니다. 전략 이름만 바꾸고 동작이 올바르다고 판단해서는 안 됩니다. 필요 시 해석하는 방식을 쓴다면 지정 프록시로 보낼 도메인 예외를 포괄적인 IP 규칙보다 앞에 배치해 예외가 먼저 처리되도록 하세요.

업데이트 후에도 적용되지 않을 때: 증상별 점검

구독 교체, DNS 변경, 라우팅 전환, 데이터베이스 업데이트를 한꺼번에 하지 마세요. 한 번에 조건 하나만 바꾸고 대상 도메인, 대상 IP, 매칭된 규칙, 아웃바운드 태그를 기록하세요. 그래야 “요청이 코어에 전달되지 않음”, “데이터베이스를 로드할 수 없음”, “규칙이 잘못 매칭됨”을 구분할 수 있습니다.

같은 설정 방식은 Android의 v2rayNG에도 적용할 수 있지만, v2rayNG는 Xray 코어를 사용하므로 메뉴와 리소스 디렉터리는 데스크톱과 다릅니다. v2flyNG는 v2fly 코어를 사용하므로 지원하는 설정 기능과 데이터베이스 로드 방식은 실제 버전에서 확인해야 합니다. 구독을 가져올 수 있다고 해서 모든 클라이언트가 동일한 라우팅 데이터베이스를 공유하는 것은 아닙니다.

• 먼저 입력을 확인하세요: 로그에서 코어가 도메인과 IP 중 무엇을 받았는지 확인하세요. IP만 전달됐다면 도메인 집합은 매칭 과정에 참여하지 않았을 수 있습니다.
• 다음으로 집합을 확인하세요: 현재 데이터베이스에 참조한 태그가 있는지 확인하세요. 다른 출처에서 본 태그 이름을 그대로 복사하지 마세요.
• 마지막으로 아웃바운드를 확인하세요: 직접 연결 규칙에 매칭된 뒤 접속에 실패했다면 DNS나 대상 네트워크 문제일 수 있으며, GeoIP 분류 오류라고 단정할 수는 없습니다.

일상적인 관리는 세 단계로 정리할 수 있습니다. 파일을 업데이트하고 정상적으로 로드됐는지 확인한 다음, 규칙 순서와 도메인 전략을 점검하고, 새 연결로 아웃바운드를 테스트하세요. 데이터베이스는 매칭 집합을 제공하고, 설정은 연결 경로를 정하며, 시스템 프록시와 TUN은 트래픽을 코어로 전달합니다. 이 세 단계를 구분하면 라우팅 문제를 더 빠르게 진단할 수 있습니다.