geoip.dat·geosite.dat 업데이트 방법: 라우팅 규칙 파일 출처와 작성법

1. GeoIP와 GeoSite는 무엇을 매칭할까

geosite.dat에는 태그별 도메인 규칙이, geoip.dat에는 태그별 IP 주소 대역이 저장됩니다. 두 파일은 코어가 읽는 바이너리 데이터 파일이지, 노드 목록이나 DNS 서버가 아닙니다. 파일을 업데이트해도 각 집합의 항목만 바뀌며, 규칙의 출구 방향은 자동으로 변경되지 않습니다.

연결 요청은 도메인으로 코어에 전달될 수도 있고, 대상 IP만 전달될 수도 있습니다. 도메인 규칙을 적용하려면 코어가 도메인을 알아야 합니다. IP 규칙은 대상 주소가 있어야 하며, 라우팅 단계에서 도메인을 해석하도록 설정할 수도 있습니다. 브라우저에서 사이트가 열린다고 해서 이번 요청에 도메인 집합과 IP 집합이 모두 사용됐다는 뜻은 아닙니다.

예를 들어 192.168.1.1 같은 로컬 네트워크 관리 주소는 주소 대역으로 바로 판단할 수 있습니다. 도메인으로 접속하는 경우, 해당 도메인이 geosite:cn에 포함돼 있어도 해석 결과는 해외 CDN 주소일 수 있습니다. 두 데이터베이스가 나타내는 속성은 서로 다르므로 대체해서 사용할 수 없습니다.

2. 규칙 파일 출처와 태그 호환성

일반적인 데이터 출처로는 V2Fly의 domain-list-community 도메인 모음, geoip 데이터 프로젝트, Loyalsoldier 등이 관리하는 규칙 데이터 빌드가 있습니다. 원본 프로젝트는 텍스트 목록을 제공할 수 있으며, 코어가 실제로 읽는 .dat 파일은 빌드 결과물입니다. 웹페이지나 원본 도메인 목록의 파일 이름만 geosite.dat로 바꾸지 마세요.

파일 이름이 같다고 해서 태그 구성까지 같은 것은 아닙니다. cn은 대체로 포함되지만, 세부 서비스나 광고 분류, 속성이 붙은 그룹은 일부 데이터 소스에만 있을 수 있습니다. 설정에서 데이터 파일에 없는 태그를 참조하면 해당 규칙만 적용되지 않는 데 그치지 않고 코어가 설정을 불러오지 못할 수도 있습니다.

• 먼저 형식을 확인하세요: 이 글의 geosite:, geoip: 및 JSON 예시는 Xray／V2Fly 라우팅 형식 기준입니다. 다른 규칙 형식에 그대로 적용하면 안 됩니다.
• 태그도 확인하세요: 이름만 보고 분류가 있을 것이라고 추측하지 말고 데이터 출처에서 공개한 분류 목록을 확인하세요.
• 복구 지점을 남겨 두세요: 업데이트 전에 기존 데이터 파일 두 개와 라우팅 설정을 백업하세요. 출처를 바꿀 때는 파일과 규칙을 한 묶음으로 점검해야 합니다.

3. v2rayN에서 Geo 파일을 업데이트하는 순서

데스크톱에서는 먼저 현재 설정이 Xray 코어를 사용하는지 V2Fly 코어를 사용하는지 확인한 뒤 해당 데이터 파일을 처리하세요. 아래 절차는 ‘Geo 파일 업데이트’ 메뉴가 있는 v2rayN 인터페이스를 기준으로 합니다. 버전에 따라 메뉴 위치나 분류가 달라질 수 있으므로 화면의 문구 차이를 파일 손상으로 오해하지 마세요.

1. 라우팅 설정 백업

   ‘설정’ → ‘라우팅 설정’을 열어 현재 활성화된 라우팅 구성과 사용자 지정 규칙을 기록하세요. Geo 파일을 직접 관리하고 있다면 기존 파일도 백업 폴더에 복사해 두세요.

2. 데이터 업데이트

   메인 창에서 ‘업데이트 확인’ → ‘Geo 파일 업데이트’를 선택하세요. 업데이트가 끝나면 geoip.dat와 geosite.dat의 처리 상태를 각각 확인하세요. 노드 구독 업데이트 알림을 규칙 데이터 업데이트 결과로 혼동하지 마세요.

3. 로그 확인

   메인 창의 로그 또는 메시지 영역을 확인하세요. 다운로드에 실패했다면 네트워크와 출처 주소부터 점검하세요. 태그를 불러올 수 없다는 메시지가 표시되면 참조한 이름과 데이터 출처를 확인하고, 라우팅 전체를 바로 삭제하지 마세요.

4. 다시 불러오기

   클라이언트에서 현재 연결을 중지한 뒤 다시 시작해 코어가 데이터를 다시 읽도록 하세요. 업데이트 과정에서 클라이언트가 이미 재시작됐더라도 시작 로그에 Geo 파일 로드 오류가 없는지 확인해야 합니다.

5. 규칙 재검증

   노드, 프록시 모드, DNS 설정은 그대로 두고 데이터 파일만 바꾼 다음 같은 대상을 테스트하세요. 그래야 데이터 업데이트 효과와 다른 설정 변경의 영향을 구분할 수 있습니다.

v2rayNG와 v2flyNG에서는 사이드 메뉴의 ‘라우팅 설정’을 열어 현재 규칙과 사용할 수 있는 데이터 업데이트 메뉴를 확인하세요. Android 클라이언트는 버전에 따라 메뉴가 다릅니다. 별도의 Geo 업데이트 항목이 없다면 해당 버전의 안내에 따라 파일 가져오기나 리소스 업데이트 기능을 사용하세요. 데스크톱의 디렉터리 경로를 그대로 적용하면 안 됩니다. 구독을 업데이트하면 주로 노드 정보가 갱신되므로 Geo 데이터까지 업데이트됐다고 판단할 수 없습니다.

4. geosite:cn과 geoip:private 규칙 작성법

다음은 Xray／V2Fly의 routing 객체 예시입니다. 먼저 사설 주소를 직접 연결하고, 다음으로 도메인 집합을 처리한 뒤, 중국 IP 집합을 보충 규칙으로 사용합니다. 태그 이름은 설치된 데이터 파일에 따라 달라집니다. 규칙은 위에서 아래로 확인하며 처음으로 일치한 규칙이 출구를 결정합니다.

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

일반적으로 한 규칙에 서로 다른 조건이 여러 개 있으면 모든 조건을 충족해야 합니다. 같은 배열에 후보 항목이 여러 개 있으면 그중 하나에 일치하면 됩니다. ‘도메인이 cn에 속하거나 IP가 cn에 속하면 직접 연결’하려면 예시처럼 규칙을 두 개로 나눠야 합니다. 두 필드를 한 규칙에 넣고 ‘또는’ 조건으로 처리할 수는 없습니다.

5. domainStrategy와 DNS가 라우팅에 미치는 영향

routing.domainStrategy는 라우팅 판단 중 도메인을 어떻게 해석할지 정합니다. 클라이언트 전체의 DNS 설정과는 다릅니다. 특히 출구 설정에 있는 이름이 같거나 비슷한 항목과 혼동하지 마세요. 라우팅 단계에서는 사용할 출구를 결정하고, 출구 단계에서는 연결 방법을 결정합니다.

• AsIs: 라우팅 단계에서 IP 규칙을 적용하기 위해 도메인을 능동적으로 해석하지 않습니다. 대상 IP가 이미 있는 요청은 IP 규칙에 매칭될 수 있지만, 모든 도메인이 GeoIP 판정을 거친다고 기대하면 안 됩니다.
• IPIfNonMatch: 도메인이 어떤 규칙에도 일치하지 않으면 IP를 해석한 뒤 계속 판단합니다. 도메인이 앞선 규칙에 이미 매칭됐다면 일반적으로 해당 라우팅 판단을 위해 다시 해석할 필요가 없습니다.
• IPOnDemand: IP 판정이 필요한 규칙을 만나면 바로 해석을 시작할 수 있습니다. IP 규칙을 앞쪽에 두면 라우팅 단계에서 도메인 요청을 DNS로 조회할 가능성이 높아질 수 있습니다.

따라서 예시에서는 IPIfNonMatch를 사용합니다. 알려진 도메인 집합을 먼저 확인하고, 매칭되지 않은 대상은 그다음 IP 분류를 시도합니다. 다만 DNS 조회가 어떤 경로를 통하는지는 DNS 서버, 조회 규칙, 연결 설정에 따라 달라집니다. 데이터 파일 두 개만 업데이트해서는 잘못된 DNS 응답이나 DNS 요청 시간 초과를 해결할 수 없습니다.

6. 수동 교체, 검증 및 자주 발생하는 오류

자동 업데이트에 실패했다면 같은 관리 출처에서 빌드한 파일 두 개를 직접 받을 수 있습니다. 교체 전 코어를 중지하고 현재 코어가 실제로 읽는 리소스 디렉터리를 찾은 다음, 정확한 파일 이름을 유지해 새 파일로 교체하고 다시 시작하세요. 데스크톱 설치형, 포터블 버전, Android 앱의 리소스 위치는 서로 다르므로 모든 환경에 적용되는 공통 경로는 없습니다.

1. 읽는 위치 확인: 클라이언트의 디렉터리 안내, 리소스 설정 또는 로그를 기준으로 확인하세요. 프로그램 디렉터리에 같은 이름의 파일이 있다는 이유만으로 실행 중인 코어가 그 파일을 읽는다고 단정하지 마세요.
2. 다운로드한 파일 확인: 파일이 비어 있거나 로그인 페이지, 오류 안내 페이지 또는 압축 파일이어서는 안 됩니다. 시스템에서 확장자를 숨기는 경우 geosite.dat.dat로 저장되지 않았는지도 확인하세요.
3. 정상 실행 여부 확인: 다시 시작한 뒤 파일을 찾을 수 없음, 데이터 파싱 실패, 집합 태그를 찾을 수 없음 등의 메시지가 표시되는지 확인하세요. 시작에 실패하면 수정 사항을 더 추가하지 말고 먼저 백업을 복원하세요.
4. 실제 라우팅 확인: 앱이 클라이언트 프록시를 실제로 사용하는지 확인한 뒤 로컬 네트워크 대상, 직접 연결할 대상, 프록시로 연결할 대상을 각각 방문하세요. 사용 가능한 접속 로그를 참고해 출구 태그를 확인합니다.