v2rayN에서 트래픽 분할 규칙을 조정하거나 V2Ray·Xray 설정을 직접 관리하는 사용자를 위한 안내입니다. 도메인 조건과 IP 조건을 구분하고, 예시 규칙으로 적용 순서를 확인한 다음 매칭 범위, DNS 조회, 설정 미적용 중 어디에 문제가 있는지 살펴봅니다.
도메인 규칙: 단일 호스트, 도메인 하위 트리, 분류 목록
V2Ray·Xray의 필드 규칙에서 도메인 조건은 domain 배열에 작성합니다. 배열 이름과 항목 접두사 모두 domain일 수 있지만 의미는 다릅니다. 전자는 조건 유형을, 후자는 매칭 방식을 지정합니다. 전체 URL을 붙여 넣지 마세요. 라우팅 대상 이름에는 https://, 포트, 페이지 경로가 포함되지 않습니다.
domain: 도메인과 하위 도메인
권장domain:example.com은 example.com과 img.example.com에 매칭되지만 notexample.com에는 매칭되지 않습니다. 접두사를 생략하고 example.com만 입력하면 부분 문자열 매칭이 되어 뒤의 호스트까지 포함될 수 있습니다.
사용 사례: 특정 사이트와 그 하위 도메인에 따라 트래픽을 분리할 때.
full: 완전한 호스트 이름
full:api.example.com은 해당 호스트 이름에만 매칭됩니다. 루트 도메인이나 v2.api.example.com에는 매칭되지 않습니다. 넓은 규칙에서 특정 호스트 하나만 예외로 분리할 때 적합합니다.
사용 사례: 단일 API, 테스트 환경 또는 지정된 호스트.
regexp: 이름 패턴으로 매칭
JSON 배열 항목 "regexp:^img[0-9]+\\.example\\.com$"은 img12.example.com 같은 호스트 이름에 매칭됩니다. 앞뒤 앵커를 사용하면 문자열 전체를 검사합니다. JSON에서는 정규식의 역슬래시 하나를 역슬래시 두 개로 표현해 점이 임의의 문자로 처리되지 않게 합니다.
사용 사례: 번호처럼 규칙은 명확하지만 호스트 이름이 여러 개인 경우.
geosite: 도메인 분류 참조
geosite:cn은 현재 도메인 데이터 파일의 cn 분류를 참조하며, 이름이 .cn으로 끝나는 모든 도메인을 매칭하는 것은 아닙니다. 분류의 존재 여부와 포함 항목은 실제로 불러온 데이터에 따라 달라집니다.
사용 사례: 기존 데이터 세트로 여러 사이트를 관리할 때.
하나의 domain 배열에 들어 있는 항목은 각각 선택적으로 매칭되는 조건이지, 순서대로 실행되는 아웃바운드 동작이 아닙니다. 같은 사이트의 두 호스트를 서로 다른 아웃바운드로 보내려면 규칙을 각각 작성하세요. 한 배열에 넣고 순차 적용을 기대하면 안 됩니다.
IP 규칙: 단일 주소, CIDR, GeoIP 분류
ip 배열은 대상 IP를 매칭합니다. 연결 대상이 처음부터 IP라면 도메인을 먼저 조회할 필요가 없습니다. 대상이 도메인 이름일 때 조회된 IP로 매칭할 수 있는지는 라우팅 정책에 따라 달라집니다. 아래 숫자는 예시 네트워크의 프리픽스 길이이며 속도 측정값이 아닙니다.
192.0.2.17/32는 IPv4 주소 하나만 선택합니다.192.0.2.0/24는192.0.2.0부터192.0.2.255까지의 대상 주소를 포함합니다. CIDR 매칭은 주소 프리픽스를 비교하며, 텍스트의 앞부분을 비교하는 방식이 아닙니다.2001:db8::17/128은 IPv6 주소 하나만 선택합니다. 대상에 IPv4와 IPv6가 모두 있다면 IPv4 항목만으로 다른 주소 체계의 매칭 결과를 추정할 수 없습니다.geoip:cn은 IP 데이터의 해당 분류를 참조하며 도메인 접미사로 판단하지 않습니다.geoip:private는 데이터 파일의 사설 주소 분류를 참조하므로, 구체적인 범위는 해당 파일을 기준으로 확인해야 합니다.
핵심 정리: 먼저 문제를 규칙 하나로 좁혀 보기
분류를 업데이트한 뒤 특정 사이트의 아웃바운드가 바뀌었다면 full:로 호스트 이름을 확인하거나 단일 주소 프리픽스로 실제 대상 IP를 확인하세요. 한 번에 조건 하나만 검증하면 됩니다. 임시 규칙이 매칭되는지 확인한 뒤 분류 파일과 항목을 점검하면 되므로 규칙표 전체를 먼저 재정렬할 필요는 없습니다.
적용 순서: 먼저 매칭된 규칙이 적용됩니다
라우팅은 rules 배열을 위에서 아래로 확인하고, 처음 매칭된 규칙을 적용합니다. full:이 domain:보다 구체적이라고 해서 자동으로 앞에 오지는 않습니다. 하나의 필드 규칙에 domain과 ip를 모두 입력하면 두 조건을 모두 충족해야 합니다. 도메인 또는 IP 중 하나만 매칭되어도 같은 아웃바운드를 사용하려면 규칙을 두 개로 나누세요.
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"domain": ["full:api.example.com"],
"outboundTag": "proxy"
},
{
"type": "field",
"domain": ["domain:example.com"],
"outboundTag": "direct"
},
{
"type": "field",
"ip": ["192.0.2.0/24"],
"outboundTag": "direct"
}
]
}
}
이것은 라우팅 일부 예시이지, 완전한 실행 설정이 아닙니다. proxy와 direct는 현재 outbounds에 있는 태그와 일치해야 합니다. 태그만으로 프록시나 직접 연결 아웃바운드가 생성되지는 않습니다. 예시 도메인과 네트워크는 매칭 과정을 설명하기 위한 것으로, 서비스 접속 여부를 확인하는 용도가 아닙니다.
- 대상이
api.example.com이면 첫 번째 규칙이proxy를 선택합니다. 앞의 두 규칙 순서를 바꾸면 같은 대상이 더 넓은 규칙에 먼저 매칭됩니다. - 대상이
img.example.com이면 첫 번째 규칙은 건너뛰고 두 번째 규칙에서direct가 선택됩니다. - 대상을
192.0.2.17로 직접 지정하면 앞의 두 규칙에는 매칭할 도메인이 없으므로 세 번째 규칙에서direct가 선택됩니다. - 어떤 규칙에도 매칭되지 않으면 V2Ray·Xray는 일반적으로 설정에서 첫 번째 아웃바운드를 사용합니다. 태그 이름만 보고 기본 동작을 추측하지 말고 아웃바운드 순서를 확인하거나, 규칙 끝에 원하는 기본 경로를 명시하세요.
domainStrategy: 도메인을 IP 매칭에 사용하는 시점
routing.domainStrategy는 라우팅 단계에서 매칭을 위해 대상 이름을 조회할지 결정합니다. 직접 연결 아웃바운드의 연결 방식이나 앱 자체의 DNS 설정과는 다릅니다. DNS 요청이 보인다고 해서 IP 규칙에 매칭됐다고 단정할 수는 없습니다.
| 정책 | 조회 시점 | 규칙 우선순위에 미치는 영향 |
|---|---|---|
AsIs | 라우팅 매칭을 위해 대상 이름을 별도로 조회하지 않습니다. | 도메인은 이름으로 판단하고, 원래 IP인 대상은 IP 조건에 매칭될 수 있습니다. |
IPIfNonMatch | 첫 번째 검사에서 매칭되지 않으면 도메인을 조회한 뒤 다시 매칭을 시도합니다. | 첫 번째 검사에서 도메인 조건이나 일반 기본 규칙에 매칭되면 IP 매칭을 위한 추가 검사는 하지 않습니다. |
IPOnDemand | 대상 IP가 필요한 매칭 조건을 만났을 때 필요한 경우 조회합니다. | 앞쪽의 IP 규칙이 조회 결과를 이용해 뒤쪽 도메인 규칙보다 먼저 매칭될 수 있습니다. |
예를 들어 도메인이 명확히 분류되지 않은 요청을 IP 분류에 따라 처리하려면 IPIfNonMatch 사용 시 테스트 트래픽 전체를 잡는 규칙이 끝에 있는지 특히 확인하세요. 첫 번째 검사에서 기본 규칙에 걸리면 IP 규칙을 기본 규칙 앞에 놓는 것만으로는 재검사가 시작되지 않습니다. 필요에 따라 조회 시점이 달라지는 전략을 사용하거나 첫 번째 검사에서 기본 규칙이 매칭을 끝내지 않도록 조정하고, 기본 아웃바운드도 확인하세요.
v2rayN 문제 해결: 현재 구성부터 새 연결까지
아래 설명은 v2rayN 7.x의 일반적인 중국어 인터페이스를 기준으로 합니다. 세부 버전에 따라 메뉴 위치가 다를 수 있습니다. 내장 라우팅 구성은 클라이언트가 코어 설정을 생성하며, 사용자 지정 전체 설정은 실제로 불러온 파일을 확인해야 합니다. 변경 전에 현재 구성을 복사해 두면 한 번에 한 항목씩 비교하기 쉽습니다.
코어 확인
「설정」→「매개변수 설정」에서 코어 관련 옵션을 확인한 뒤, 현재 서버 항목과 시작 로그에 표시된 실제 코어를 대조하세요. 기본 코어 옵션만으로 확인을 대신할 수는 없습니다. 항목에 지정된 코어나 사용자 지정 설정이 다를 수 있습니다. 이 문서의 JSON은 V2Ray·Xray 형식이므로 설정 형식이 다른 코어에 그대로 적용할 수 없습니다.
현재 구성 편집
「설정」→「라우팅 설정」에서 현재 활성화된 구성을 확인하고 해당 규칙 목록에서 순서와 아웃바운드를 점검하세요. 먼저 호스트 하나를 지정한 규칙으로 검증하고, DNS·분류 데이터·기본 아웃바운드를 동시에 바꾸지 마세요. 여러 항목을 함께 변경하면 결과가 달라졌을 때 원인을 파악하기 어렵습니다.
설정 적용 확인
규칙을 저장하고 적용한 뒤 필요한 경우 코어를 다시 시작하세요. 설정 파싱 오류, 분류 누락, 아웃바운드 태그 불일치 알림이 있는지 먼저 확인합니다. 사용자 지정 설정이라면 이전에 내보낸 복사본이 아니라 현재 항목이 실제로 불러오는 파일을 편집했는지도 확인하세요.
새 연결로 검증
기존 연결을 끊고 요청을 다시 보내 로그에서 확인 가능한 대상과 아웃바운드 정보를 살펴보세요. 앱이 기존 연결을 재사용하거나 자체적으로 먼저 조회한 뒤 IP를 인바운드에 전달할 수 있습니다. 이 경우 도메인 규칙이 매칭되지 않아도 순서가 잘못된 것은 아닙니다. 트래픽이 실제로 코어에 들어갔는지 확인한 다음 라우팅이 도메인 이름을 본 것인지 IP 주소를 본 것인지 확인하세요.
전체 필드를 확인하려면 라우팅 설정 참고와 DNS 설정 참고를 살펴보세요. 일부 앱에서만 다르게 작동한다면 먼저 연결 방식과 대상 주소 형식을 비교한 뒤 도메인 정책을 바꿀지 결정하세요.