v2rayN에서 내보낸 핵심 설정을 확인할 때는 먼저 로컬 리스닝 포트를 찾고, 규칙에 지정된 태그를 따라 실제 아웃바운드를 확인하세요. 이 글에서는 직결과 차단이 함께 있는 예제로 기본 아웃바운드를 읽는 법, DNS 문제와 라우팅 문제를 구분하는 법, 클라이언트 설정을 바꿀지 코어 로그를 확인할지 판단하는 방법을 설명합니다.
V2Ray JSON 예제: 먼저 연결 흐름 살펴보기
설정을 연결 경로로 읽어 보세요. inbounds는 코어가 연결을 받는 지점을 정하고, routing은 연결을 어디로 보낼지 결정하며, outbounds는 연결을 넘겨받은 뒤 처리하는 방식을 지정합니다. log와 dns는 보조 설정이며 모든 연결이 차례로 거치는 단계는 아닙니다.
아래 예제는 V2Fly V2Ray의 기존 JSON 형식을 사용합니다. 원격 계정이나 규칙 데이터 파일은 필요하지 않습니다. 앱이 로컬 SOCKS 포트에 직접 연결해야 이 경로를 이용하며, 코어를 실행하는 것만으로 시스템 프록시가 바뀌지는 않습니다. 포트는 설명을 위한 값이며 v2rayN의 기본 설정을 의미하지 않습니다.
{
"log": {
"loglevel": "warning"
},
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {"auth": "noauth", "udp": false}
}
],
"outbounds": [
{"tag": "direct", "protocol": "freedom"},
{"tag": "reject", "protocol": "blackhole"}
],
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-socks"],
"domain": ["full:example.org"],
"outboundTag": "reject"
}
]
},
"dns": {
"servers": ["localhost"]
}
}
클라이언트에 저장된 앱 설정과 구독 정보, 코어가 시작할 때 읽는 JSON은 서로 다른 데이터입니다. 활성 설정을 바꾼 뒤 v2rayN이 코어 파일을 다시 생성하면 수동 변경 내용이 덮어써질 수 있습니다. 실제로 불러온 설정을 확인하고 파일 이름만으로 어떤 JSON이 적용됐는지 판단하지 마세요.
inbounds와 outbounds: 리스닝 주소와 아웃바운드 프로토콜 확인
앱이 연결되지 않으면 먼저 인바운드를 확인하세요. 예제는 IPv4 루프백 주소 127.0.0.1에서만 수신합니다. 앱에서는 같은 포트를 HTTP 프록시가 아닌 SOCKS5로 설정해야 합니다. noauth는 이 인바운드에서 SOCKS 인증을 요구하지 않는다는 뜻이며, 로컬 네트워크에 그대로 공개하는 용도에는 적합하지 않습니다. udp: false이므로 이 예제로는 SOCKS UDP 전달을 확인할 수 없습니다.
앱 측: SOCKS 인바운드
- listen
127.0.0.1- port
10808- protocol
socks- tag
local-socks
앱은 인바운드 태그가 아니라 리스닝 주소와 포트에 연결합니다.
코어 측: 직결 아웃바운드
- protocol
freedom- tag
direct- 배열 순서
outbounds의 첫 번째 항목
태그는 참조 이름이며, 실제 처리 방식은 프로토콜과 설정으로 결정됩니다.
실제 내보낸 설정에서 vmess 또는 vless 아웃바운드가 보인다면 앱이 연결하는 로컬 포트와 아웃바운드 설정의 원격 서버 포트를 구분하세요. settings의 구조는 프로토콜마다 다르며, streamSettings에는 전송 방식과 보안 설정이 들어갑니다. 원격 서버에 연결할 때는 해당 설정이 상대 측과 일치해야 합니다. 아웃바운드의 프로토콜 필드만 바꾸고 다른 아웃바운드의 설정 구조를 그대로 사용하면 안 됩니다. V2Fly와 Xray는 지원하는 필드와 값이 다를 수 있으므로 실제로 실행 중인 코어와 버전에 맞춰 확인하세요.
routing: 순서대로 규칙을 확인하고, 일치하는 규칙이 없으면 기본 아웃바운드 사용
예제의 일반 아웃바운드 규칙은 배열 순서대로 확인하며, 처음 일치하는 규칙에 따라 연결이 처리됩니다. 한 규칙 안에서 inboundTag와 domain은 모두 충족해야 하는 조건이고, outboundTag는 일치했을 때 수행할 동작입니다. full:example.org는 해당 도메인만 일치하며 하위 도메인은 포함하지 않습니다.
| 코어가 받은 대상 | 예제의 처리 결과 | 판단 기준 |
|---|---|---|
example.org | reject | 지정된 인바운드로 들어오고 전체 도메인이 일치합니다. |
www.example.org | direct | 하위 도메인은 전체 일치 조건에 맞지 않으므로 첫 번째 아웃바운드로 처리됩니다. |
| 앱이 미리 확인한 대상 IP 주소 | direct | 예제에서는 스니핑을 사용하지 않으므로 대상 IP만으로는 이 도메인 규칙과 일치하지 않습니다. |
규칙이 적용되지 않으면 먼저 코어가 도메인과 IP 중 무엇을 받았는지 확인하세요
도메인 규칙을 테스트할 때는 앱이 SOCKS 요청에 도메인 이름을 포함하도록 설정하세요. 앱이 먼저 DNS 조회를 마치고 IP만 코어에 전달한다면, 라우팅 규칙을 바로 완화하지 말고 테스트 방법부터 바꾸세요.
규칙이 여러 개 있는 설정을 읽을 때는 태그 철자뿐 아니라 앞쪽의 포괄적인 규칙이 요청을 먼저 처리하는지도 확인해야 합니다. 예를 들어 특정 inboundTag만 지정한 규칙이 앞에 있으면 해당 인바운드의 연결을 먼저 처리하므로 뒤에 있는 도메인 규칙은 검사되지 않습니다. 어떤 규칙에도 일치하지 않으면 이 예제에서는 outbounds의 첫 번째 항목을 사용합니다. 차단 아웃바운드를 첫 번째 항목으로 옮기면 규칙에 일치하지 않는 연결도 차단됩니다.
dns: 로컬 조회, 라우팅용 조회, 아웃바운드 연결 시 조회 구분하기
dns.servers에는 코어 내장 DNS 모듈이 사용할 DNS 서버를 설정합니다. 여기서 localhost는 로컬 시스템의 이름 조회 방식을 사용한다는 뜻입니다. 루프백 주소에서 별도의 DNS 서버를 실행하라는 의미도, 앱의 DNS 요청을 자동으로 대신 처리한다는 의미도 아닙니다. 이 모듈이 사용되는지는 코어의 라우팅 및 아웃바운드 설정과 함께 확인해야 합니다.
- 앱에서 먼저 DNS 조회: 앱은 SOCKS에 연결하기 전에 IP 주소를 알아낼 수 있습니다. 이 경우 코어의
dns.servers를 바꿔도 이미 완료된 DNS 조회 결과에는 영향을 주지 않습니다. - 라우팅 규칙 매칭을 위한 DNS 조회:
AsIs는 IP 규칙과 일치시키기 위해 도메인을 IP로 변환하지 않습니다.IPIfNonMatch는 도메인 대상으로 처음 규칙을 확인했을 때 일치하는 항목이 없으면 DNS 조회를 한 뒤 IP 규칙을 다시 확인할 수 있습니다. 두 설정은 라우팅 판단 방식을 바꾸며 시스템 DNS 사용 여부를 전환하지는 않습니다. - 아웃바운드 연결을 설정할 때 DNS 조회: 라우팅 단계에서 DNS를 조회하지 않더라도 직결 아웃바운드는 최종적으로 대상 IP에 연결해야 합니다. 도메인 조회가 어디서 이루어지는지는 아웃바운드 설정에 따라 달라지므로 라우팅 정책만으로 판단할 수 없습니다.
문제를 확인할 때는 같은 앱, 같은 인바운드, 같은 테스트 도메인을 사용하세요. 실패가 DNS 조회 단계에서 발생했는지, 아웃바운드가 선택된 뒤 발생했는지 먼저 확인해야 합니다. 로그에 요청이 reject로 들어갔다고 나오면 DNS 서버를 계속 바꾸지 말고 라우팅 규칙을 다시 살펴보세요. 반대로 특정 IP에 접속된다고 해서 도메인 조회가 정상이라는 뜻은 아니며, 해당 도메인으로 접속할 때 TLS 인증이 통과한다는 보장도 없습니다.
log 및 설정 문제 해결: 시작 오류부터 규칙 적용까지 확인하기
예제의 log.loglevel은 warning으로 설정되어 있어 경고와 오류를 먼저 살펴보기에 적합합니다. 하지만 모든 연결의 라우팅 세부 정보가 표시되지는 않습니다. 추가 단서가 필요하면 테스트용 복사본에서 잠시 info로 바꾸고 문제를 한 번 재현한 뒤 원래대로 복구하세요. 코어 로그에는 대상 도메인, 주소, 연결 시간이 포함될 수 있습니다. 외부에 공유하기 전에 민감한 정보를 삭제하고 구독 주소나 계정 관련 필드는 첨부하지 마세요.
- 코어가 시작되지 않음: 먼저 표준 JSON 문법을 확인하세요. 객체의 키와 문자열은 큰따옴표로 감싸고, 마지막 항목 뒤에는 쉼표를 붙이지 않습니다. 그런 다음 코어가 해당 프로토콜, 전송 방식, 필드를 지원하는지 확인하세요. JSON 파서가 읽을 수 있다고 해서 코어에서도 불러올 수 있는 것은 아닙니다.
- 시작은 됐지만 연결이 거부됨: 실제 리스닝 주소와 포트, 프록시 유형을 확인하세요. 주소가 이미 사용 중이라는 로그가 표시되면 v2rayN의 기존 코어 프로세스나 다른 앱이 예제 포트를 사용하고 있는지 살펴보세요. 포트를 바꿀 때는 코어와 테스트 앱의 설정을 모두 변경해야 합니다.
- 앱이 잘못된 아웃바운드로 연결됨: 앱이 실제로 이 SOCKS 인바운드를 사용하는지 확인한 다음
rules를 하나씩 살펴보세요. 인바운드 태그, 대상 형식, 아웃바운드 태그를 대조하고, 일치하는 규칙이 없는 요청은 아웃바운드 배열의 첫 번째 항목으로 처리되는지 확인하세요. - 저장한 설정이 다시 바뀜: 먼저 클라이언트에 영구 저장되는 설정을 수정했는지, 시작할 때 생성되는 임시 파일을 수정했는지 확인하세요. 자주 사용하는 라우팅 규칙은 클라이언트의 라우팅 설정에서 관리하는 것이 좋습니다. 테스트용 JSON은 별도 복사본으로 저장하고 한 번에 한 항목만 바꾼 뒤 로그로 결과를 확인하세요.