사용자 지정 라우팅 규칙 가이드: domain·ip·geosite 문법과 우선순위

domain, full, regexp, ip, geosite, geoip 규칙의 문법부터 위에서 아래로 적용되는 순서와 자주 발생하는 충돌 해결법까지 살펴봅니다.

이 글의 핵심

v2rayN에서 트래픽 분기를 설정하거나 Xray·V2Fly 설정 파일을 직접 살펴보려는 독자를 위한 안내입니다. 도메인, 대상 IP, 데이터셋의 차이를 알아보고, 규칙 예외와 아웃바운드 태그, DNS 조회 시점을 설정 예제로 하나씩 확인합니다. 테스트 사이트가 열리지 않아도 로그를 통해 요청이 어떤 아웃바운드로 전달됐는지 먼저 파악할 수 있습니다.

domain·full·regexp: 도메인 규칙의 매칭 범위

커널 JSON에서 domain은 규칙 필드이고, domain:은 이 필드에서 사용하는 매칭 접두사입니다. 도메인 필드는 전체 URL이 아니라 호스트 이름을 비교합니다. 설정할 때는 https://, 포트, 경로, 쿼리 매개변수를 빼세요. 같은 호스트에 있는 두 페이지를 이 규칙으로 나눠 라우팅할 수는 없습니다.

domain: 도메인 및 하위 도메인

권장

domain:example.com은 example.com과 api.example.com에 매칭되지만 notexample.com에는 매칭되지 않습니다. 경계는 임의의 문자열 접미사가 아니라 도메인 레이블을 기준으로 합니다.

적합한 경우: 사이트와 하위 도메인 전체에 같은 아웃바운드를 적용할 때

full: 지정한 호스트

full:api.example.com은 이 호스트 이름에만 매칭됩니다. example.com이나 v2.api.example.com에는 적용되지 않습니다. 호스트 하나만 따로 처리하려고 정규식을 작성할 필요는 없습니다.

적합한 경우: 로그인·API·정적 리소스 호스트에 예외를 적용할 때

regexp: 호스트 이름 패턴

정규식 ^img[0-9]+\.example\.com$은 img1.example.com에 매칭되고 img.example.com에는 매칭되지 않습니다. JSON에 넣을 때는 백슬래시를 두 번 써야 합니다. 예: "regexp:^img[0-9]+\\.example\\.com$".

적합한 경우: 여러 호스트가 일정한 번호 패턴을 따르지만 도메인 전체를 허용할 수 없을 때

커널 JSON에서 접두사 없이 입력한 example.com은 부분 문자열로 매칭되므로 notexample.com까지 포함할 수 있습니다. 규칙 범위가 너무 넓다면 접두사를 빠뜨리지 않았는지 먼저 확인하고, 정규식의 시작·끝 앵커가 빠졌거나 마침표를 와일드카드처럼 처리하지 않았는지도 점검하세요. 클라이언트 편집기를 사용한다면 내보낸 커널 설정이 입력한 내용과 일치하는지도 확인해야 합니다.

ip·geosite·geoip: 주소와 데이터셋의 차이

ip는 노드 서버 주소가 아니라 요청 대상 IP에 매칭됩니다. 출발지에 따라 트래픽을 나누려는 경우 이 필드를 재사용할 수 없습니다. geosite:는 domain 배열에, geoip:는 ip 배열에 넣습니다. 두 접두사는 모두 로컬 데이터 파일의 카테고리를 참조하며, 온라인으로 조회하지 않습니다.

항목커널 설정매칭 기준
단일 주소"ip": ["192.0.2.10"]대상 주소 하나만 확인하므로 단일 주소 규칙을 테스트하기 좋습니다.
CIDR 대역"ip": ["192.0.2.0/24", "2001:db8::/32"]접두사는 각각 IPv4 및 IPv6 문서용 주소 대역을 나타냅니다. 실제 정책을 설정할 때는 사용하는 대역으로 바꿔야 합니다.
도메인 집합"domain": ["geosite:cn"]geosite.dat의 항목을 참조하며, .cn으로 끝나는 모든 도메인에 매칭되는 것은 아닙니다.
주소 집합"ip": ["geoip:cn"]대상 IP가 geoip.dat의 해당 카테고리에 속한 주소 대역에 포함되는지 확인합니다.

데이터 파일의 버전이나 출처에 따라 카테고리 이름과 집합에 포함된 항목이 달라질 수 있습니다. 규칙을 가져온 뒤 커널에서 카테고리를 불러올 수 없다는 오류가 나면 순서를 바꾸기보다 실제로 로드된 파일과 카테고리 이름부터 확인하세요. 도메인이 특정 사이트 집합에 포함되어도 현재 해석된 IP가 같은 이름의 IP 집합에 속한다는 뜻은 아닙니다. CDN, 듀얼 스택, DNS 응답 변경에 따라 결과가 달라질 수 있습니다.

매칭 우선순위: 예외를 먼저, 넓은 규칙은 나중에

routing.rules는 위에서 아래로 검사하며, 처음 매칭된 규칙의 아웃바운드가 선택됩니다. full:이 domain:보다 구체적이라는 이유만으로 먼저 적용되지는 않습니다. 하나의 규칙에서 domain과 ip 같은 서로 다른 조건 필드는 모두 충족해야 합니다. 반면 하나의 domain 배열에 여러 항목이 있으면 그중 하나만 맞아도 됩니다. “지정 도메인 또는 지정 IP” 조건을 만들려면 같은 아웃바운드를 가리키는 규칙 두 개로 나누세요.

아래 Xray 설정은 로컬 SOCKS 인바운드를 사용합니다. direct와 reject는 사용자 지정 아웃바운드 태그이며 각각 freedom과 blackhole에 연결됩니다. 이 태그는 프로토콜 이름이 아니므로 노드 표시 이름으로 대신할 수 없습니다. 예제는 예약 도메인과 문서용 주소를 사용하므로 구독이나 지역 데이터 파일이 필요하지 않습니다.

{
  "log": {"loglevel": "info"},
  "inbounds": [
    {
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {"auth": "noauth", "udp": true}
    }
  ],
  "outbounds": [
    {"tag": "direct", "protocol": "freedom"},
    {"tag": "reject", "protocol": "blackhole"}
  ],
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {"type": "field", "domain": ["full:api.example.com"], "outboundTag": "direct"},
      {"type": "field", "domain": ["domain:example.com"], "outboundTag": "reject"},
      {"type": "field", "ip": ["192.0.2.0/24"], "outboundTag": "reject"},
      {"type": "field", "network": "tcp,udp", "outboundTag": "direct"}
    ]
  }
}
10808
예제 SOCKS 인바운드 포트
4개
마지막 기본 규칙을 포함한 예제 규칙 수
192.0.2.10
세 번째 규칙에 매칭되는 문서용 주소

정리: 대상 두 개로 규칙 가림 여부 확인

예외 규칙을 추가한 뒤 예외 호스트와 같은 도메인의 일반 호스트를 모두 테스트하세요. 두 호스트가 의도한 대로 서로 다른 아웃바운드로 전달되는지 확인한 다음 범위가 넓은 지역 규칙을 추가합니다. 두 호스트가 같은 아웃바운드로 전달된다면 위쪽에 더 넓은 범위의 규칙이 있는지 먼저 확인하세요.

domainStrategy: 도메인을 IP 규칙에 매칭하는 시점

IP 주소를 직접 입력한 요청은 커널에서 주소를 바로 비교할 수 있습니다. 도메인이 포함된 요청을 라우팅 단계에서 조회할지는 routing.domainStrategy에 따라 달라집니다. 이는 아웃바운드가 선택된 뒤 연결을 위해 수행하는 DNS 조회와는 별개입니다. 라우팅 전략을 변경해도 DNS 서버가 바뀌지는 않으며, 클라이언트가 도메인을 커널에 전달한다는 보장도 없습니다.

도메인 규칙을 먼저 적용하고 매칭되지 않은 도메인에는 주소 규칙을 적용하려면 IPIfNonMatch를 사용하세요. 첫 검사에서 매칭되는 마지막 와일드카드 규칙을 제거하고, 기본 아웃바운드로 사용할 항목을 outbounds의 첫 번째에 배치합니다. 변경 전후에 도메인 입력과 IP 직접 입력을 각각 확인하세요. 애플리케이션이 커널에 전달하기 전에 도메인을 IP로 변환한다면 이 설정으로 IP에서 원래 호스트 이름을 알아낼 수는 없습니다.

v2rayN 라우팅 설정: 저장·전환·테스트

아래 예제는 데스크톱 버전 v2rayN의 Xray 라우팅 설정을 기준으로 합니다. 버전에 따라 편집 창과 활성화 옵션이 다를 수 있습니다. 앞의 전체 JSON은 독립 실행 예제이므로 단일 규칙의 도메인 입력란에 붙여 넣거나 구독에서 생성된 기존 설정을 통째로 덮어쓰지 마세요.

  1. 기존 설정 보관

    메인 창에서 「설정」→「라우팅 설정」으로 이동해 현재 활성화된 설정과 기존 규칙 순서를 기록해 둡니다. 기존 설정을 수정하기 전에 규칙을 복사해 보관하세요. 테스트에 실패하면 구독을 다시 가져오지 않고 기존 설정으로 전환할 수 있습니다.

  2. 조건을 각각 입력

    테스트할 설정의 규칙 편집 화면에서 full:api.example.com과 domain:example.com을 각각 별도 규칙으로 만들어 IP 입력란이 아닌 도메인 입력란에 넣습니다. 두 규칙에 서로 다른 아웃바운드를 지정하고, 단일 호스트 예외를 전체 도메인 규칙보다 위에 배치하세요.

  3. 테스트 설정 활성화

    저장한 뒤 편집 창만 열어 둔 상태가 아니라 테스트할 설정이 실제로 활성화됐는지 확인합니다. v2rayN에서 규칙을 생성했다면 인터페이스에서 제공하는 아웃바운드 옵션을 사용하고 예제의 reject 태그를 그대로 복사하지 마세요. 설정을 직접 작성했다면 outboundTag가 실제로 존재하는지 확인해야 합니다.

  4. 커널 로그 확인

    실제 로컬 SOCKS 포트를 통해 요청을 두 번 따로 보냅니다. 예제 포트는 10808입니다. curl을 사용한다면 curl --proxy socks5h://127.0.0.1:10808 --max-time 5 https://api.example.com/을 실행한 뒤 대상 호스트를 img.example.com으로 바꾸세요. 문서용 도메인의 웹 페이지가 열리는지를 근거로 삼지 말고 커널 액세스 로그에 기록된 대상과 아웃바운드를 확인하세요.

자주 발생하는 충돌: 규칙은 맞는데 아웃바운드가 예상과 다를 때

full 규칙을 추가했는데 왜 전체 도메인 규칙이 적용되나요?

단일 호스트 규칙을 전체 도메인 규칙 위로 옮기고, 위쪽에 해당 호스트를 포함하는 geosite: 규칙이 있는지도 확인하세요. 설정을 저장하고 올바른 항목을 활성화한 뒤 새 연결을 만들어 예외 호스트와 같은 도메인의 일반 호스트가 각각 어떤 아웃바운드로 전달되는지 확인합니다.

IP를 직접 입력하면 매칭되는데 도메인으로는 안 되나요?

먼저 로그를 확인해 커널이 도메인과 IP 중 무엇을 받았는지 확인하세요. 도메인을 받았다면 domainStrategy를 점검합니다. IPIfNonMatch를 사용 중이라면 첫 검사에서 기본 규칙이나 다른 도메인 규칙이 먼저 매칭됐는지 확인하세요. IP를 받았다면 해당 주소가 실제로 지정한 대역에 속하는지 확인하고, 특히 IPv6 주소를 IPv4 대역과 비교하지 않도록 주의합니다.

geosite 규칙을 복사한 뒤 커널이 시작되지 않는 이유는 무엇인가요?

먼저 시작 로그를 읽고 데이터 파일을 찾지 못한 문제인지, 집합 이름을 찾지 못한 문제인지 구분하세요. 다른 설정 디렉터리에 있는 동명 파일이 아니라 현재 커널이 실제로 사용하는 geosite.dat를 확인해야 합니다. 아웃바운드와 규칙 순서가 정상인지 확인하려면 해당 집합을 같은 용도의 명시적 도메인 규칙으로 잠시 바꿔 테스트할 수 있습니다.

브라우저와 명령줄의 결과가 다른 이유는 무엇인가요?

두 프로그램이 실제로 같은 로컬 인바운드를 거치는지 먼저 확인하세요. socks5h로 테스트하면 curl이 도메인을 SOCKS 프록시에 전달합니다. 브라우저는 다른 프록시 설정을 사용하거나 직결하거나 기존 연결을 재사용할 수 있습니다. 새 요청을 보내고 로그에 기록된 대상과 시간을 대조해 이전 연결의 결과를 새 규칙의 결과로 착각하지 않도록 하세요.

v2rayN 다운로드