V2Ray 설정 파일 JSON 구조 분석: inbounds·outbounds·routing 의미

V2Ray 설정 JSON을 항목별로 살펴봅니다. log, 로컬 수신을 담당하는 inbounds, freedom/blackhole 출력을 포함한 outbounds, routing 규칙의 적용 순서를 예제와 함께 확인하세요.

핵심 내용

v2rayN에서 구독을 가져온 뒤 코어 설정을 살펴보기 시작한 사용자를 위한 안내입니다. 로컬 인바운드 하나와 아웃바운드 두 개만 있는 JSON으로 포트 설정 위치, 규칙에서 아웃바운드를 참조하는 방법, 규칙에 일치하지 않는 요청의 처리 경로를 알아봅니다. 예제에는 원격 노드가 필요하지 않으며, 실제 사용 중인 설정을 그대로 덮어쓰지 마세요.

최상위 구조: 요청이 인바운드에서 아웃바운드까지 이동하는 과정

앱 요청로컬 인바운드규칙 매칭지정된 아웃바운드

설정을 읽을 때는 구독의 서버 주소보다 앱이 실제로 연결하는 주소와 포트부터 확인하세요. 앱이 요청을 인바운드로 전달하면 코어는 요청에 포함된 대상 정보를 바탕으로 라우팅 규칙을 확인합니다. 규칙이 아웃바운드를 선택하고, 아웃바운드에서 대상에 직접 연결할지, 원격 프록시를 거칠지, 요청을 종료할지 결정합니다.

최소 구성 JSON: 로컬 인바운드 두 개와 아웃바운드 두 개

아래 예제는 V2Ray v4 형식의 JSON 필드를 사용합니다. 앱에서 각각 테스트하기 쉽도록 SOCKS와 HTTP 인바운드를 분리했습니다. 포트 번호는 설명을 위해 선택한 값이며 v2rayN 기본 설정이 아닙니다. 포트가 이미 사용 중이라면 설정 파일과 앱에 입력한 포트를 모두 변경하세요.

10808
예제 SOCKS 수신 포트
10809
예제 HTTP 수신 포트
2
예제 아웃바운드 수
{
  "log": { "loglevel": "warning" },
  "inbounds": [
    {
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "tag": "local-socks",
      "settings": { "auth": "noauth", "udp": false }
    },
    {
      "listen": "127.0.0.1",
      "port": 10809,
      "protocol": "http",
      "tag": "local-http",
      "settings": {}
    }
  ],
  "outbounds": [
    { "protocol": "freedom", "tag": "direct", "settings": {} },
    { "protocol": "blackhole", "tag": "block", "settings": {} }
  ],
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["full:example.org"],
        "outboundTag": "block"
      }
    ]
  }
}

이 설정에는 규칙이 하나뿐입니다. 코어가 받은 대상 도메인이 정확히 example.org이면 block을 선택하고, 나머지 요청은 첫 번째 아웃바운드인 direct로 처리합니다. DNS 분기, 원격 노드, 트래픽 스니핑은 포함하지 않습니다. JSON으로 저장할 때 배열의 마지막 항목 뒤에 쉼표를 붙이지 말고, 코드에 설명 주석을 추가하지 마세요.

inbounds와 log: 앱이 코어에 연결되는지 확인하기

listen은 코어가 연결을 수신할 로컬 주소를 지정합니다. 여기서는 로컬 앱만 연결할 수 있도록 루프백 주소 127.0.0.1을 사용합니다. 연결 문제를 해결하려고 0.0.0.0으로 바꾸지 마세요. 수신 범위가 넓어지며, 이 예제에는 프록시 인증도 설정되어 있지 않습니다.

  1. 인바운드 프로토콜을 확인하세요. 앱에서 HTTP 프록시를 선택했다면 127.0.0.1:10809를 입력하고, SOCKS5를 선택했다면 127.0.0.1:10808을 입력합니다. 로컬 인바운드가 HTTP여도 HTTP 웹사이트만 이용할 수 있는 것은 아닙니다. CONNECT를 지원하는 앱은 이 인바운드를 통해 HTTPS 대상에도 연결할 수 있습니다. 예제에서는 SOCKS 인바운드의 UDP를 비활성화했습니다.
  2. 테스트할 앱이 프록시 설정을 따르는지 확인하세요. 시스템 프록시는 해당 설정을 따르는 앱에 인바운드를 제공할 뿐, 모든 트래픽이 코어를 통과하도록 보장하지 않습니다. 테스트할 때는 프록시를 직접 지정할 수 있는 앱을 우선 사용하세요. 프록시를 우회한 접속 결과를 라우팅 결과로 오해하지 않도록 주의해야 합니다.
  3. 코어 로그를 확인하세요. warning은 경고와 그보다 심각한 문제를 기록하는 일상적인 로그 수준입니다. 문제를 진단할 때는 잠시 debug로 바꾸고 설정을 다시 불러온 뒤 한 번 더 시도한 다음 원래 수준으로 되돌리세요. 포트 바인딩에 실패했다면 먼저 수신 포트 충돌을 해결해야 합니다. 로그에 요청 기록이 없다는 이유만으로 인바운드 실패라고 단정하지 말고, 로그 수준과 앱 설정도 함께 확인하세요.

outbounds: 프로토콜은 동작을 정하고 태그는 규칙에서 참조합니다

freedom은 코어가 대상에 직접 연결하도록 합니다. 실제 연결은 로컬 네트워크와 DNS 조회 결과의 영향을 받습니다. 앱이 로컬 프록시를 우회하는 것은 아닙니다. 앱은 이미 요청을 코어에 전달했고, 코어가 이를 원격 프록시로 보내지 않을 뿐입니다. blackhole은 일치하는 트래픽을 종료합니다. 앱에는 연결 종료나 요청 실패가 표시될 수 있으며, 명확한 차단 페이지가 나타나는 것은 아닙니다.

protocol
아웃바운드 동작은 프로토콜에 따라 정해집니다. 구독으로 생성된 원격 프록시 아웃바운드는 VMess를 사용할 수 있습니다. 원격 주소와 프로토콜 매개변수는 해당 아웃바운드에 속하며 로컬 수신 설정이 아닙니다. 프로토콜 전용 settings를 freedom 설정에 그대로 옮겨 쓸 수 없습니다.
tag
설정 내부에서 참조하는 이름입니다. direct와 block은 프로토콜 키워드가 아닙니다. block의 이름을 바꾸면 해당 이름을 참조하는 outboundTag도 함께 수정하고, 아웃바운드 태그가 서로 중복되지 않도록 하세요.
배열 순서
규칙에 일치하지 않는 요청은 첫 번째 아웃바운드로 전달됩니다. 이 예제에서 blackhole을 첫 번째로 옮기면 원래 직접 연결될 요청도 종료됩니다.

routing: 규칙은 순서대로 매칭하며 구체성 순으로 정렬하지 않습니다

코어는 routing.rules를 위에서부터 확인하고 조건에 맞는 첫 번째 규칙을 사용합니다. 한 규칙에 inboundTag와 domain이 모두 설정되어 있다면 두 조건을 모두 충족해야 합니다. 예를 들어 예제 규칙에 "inboundTag": ["local-http"]를 추가하면 SOCKS 인바운드로 들어온 동일한 도메인 요청은 해당 규칙에 일치하지 않습니다.

코어가 받은 대상일치 여부예제 아웃바운드
example.org전체 도메인 일치block
www.example.org불일치, 하위 도메인은 전체 도메인과 다름direct
example.com불일치direct
IP 주소를 직접 입력불일치, 예제에서는 대상 도메인을 복원하지 않음direct

정리: 코어가 도메인과 IP 중 무엇을 받았는지 먼저 확인하세요

SOCKS에서 도메인 규칙을 테스트하려면 대상 도메인을 SOCKS5 프록시에 전달하는 옵션을 지원하는 클라이언트를 선택하세요. 앱이 로컬에서 DNS를 조회한 뒤 IP만 전달한다면 규칙을 바꾸기 전에 테스트 인바운드부터 조정하세요. AsIs는 라우팅 매칭을 위해 도메인을 조회하지 않으며, IP에서 원래 도메인을 찾아내지도 않습니다.

루트 도메인과 하위 도메인을 모두 처리하려면 domain:example.org를 사용할 수 있습니다. 앞에 같은 대상을 포함하는 포괄 규칙이 이미 있다면, 예를 들어 해당 도메인과 모든 하위 도메인을 직접 연결하도록 설정했다면 뒤에 있는 full:example.org 차단 규칙은 실행되지 않습니다. 이 예외를 적용하려면 전체 도메인 규칙을 포괄 규칙보다 앞에 두세요.

v2rayN 설정 관련 자주 묻는 질문

JSON을 직접 수정했는데 노드를 바꾸면 원래대로 돌아가는 이유는 무엇인가요?

독립 설정 파일을 수정했는지, v2rayN이 생성한 실행 파일을 수정했는지 먼저 확인하세요. 생성된 파일은 노드를 바꾸거나 코어를 다시 시작할 때 재작성될 수 있습니다. 일반 노드에서 라우팅을 계속 사용하려면 클라이언트의 라우팅 설정을 이용하세요. 전체 JSON을 따로 테스트하려면 별도 사본을 보관하고 해당 코어로 불러오세요.

이 JSON을 구독 주소에 그대로 입력해도 되나요?

아니요. 구독 주소는 노드 목록을 가져오는 데 사용하고, 이 예제는 코어가 읽는 설정 객체입니다. 현재 노드 유형과 코어를 확인한 뒤 v2rayN에서 라우팅을 조정할지, 설정 파일을 별도로 불러올지 결정하세요. 코어마다 필드 이름이 다를 수 있으므로 서로 바꿔 쓸 수 있다고 가정하지 마세요.

수정한 뒤 테스트 도메인 두 곳이 모두 열리지 않습니다. 어디부터 확인해야 하나요?

먼저 코어가 설정을 정상적으로 불러왔는지 확인한 다음, 같은 앱과 같은 프록시 인바운드로 example.com을 테스트하세요. 이 도메인은 direct로 처리되지만, 로컬에서 DNS를 조회하고 대상에 연결할 수 있어야 합니다. 이 동작을 확인한 뒤 example.org을 테스트하세요. 두 페이지가 모두 열리지 않는다는 사실만으로 차단이 적용됐다고 판단할 수는 없습니다.

v2rayN 다운로드