설정 항목 참고 · 용어 26개

V2Ray 용어 사전:
프로토콜·구독·라우팅 설정

v2rayNG 설정에서 낯선 항목을 발견했다면 먼저 분류별 설명을 확인한 뒤 원래 메뉴로 돌아가 매개변수를 점검하세요. 데스크톱 v2rayN에서 같은 개념을 찾아볼 수도 있습니다. 메뉴 이름은 버전에 따라 조금 다를 수 있습니다.

프로토콜과 전송 방식

노드 편집 화면에서 프로토콜 유형, 인증 항목, 전송 방식, 보안 설정 순으로 확인하세요. 네 가지 설정은 서버와 함께 맞춰야 하며 프로토콜 이름만 바꿔서는 안 됩니다.

프로토콜 기초#

VMess

VMess는 인증과 암호화 기능을 갖춘 프록시 프로토콜이며, 사용자 ID, 암호화 방식, 추가 ID가 주요 설정 항목입니다. 이전 설정을 가져올 때 추가 ID가 서버 요구사항에 맞는지 확인하고 다른 노드의 값을 그대로 사용하지 마세요. 기기 시간이 크게 어긋나면 인증에 영향을 줄 수 있으므로 연결에 실패하면 시스템의 자동 날짜 및 시간 설정을 먼저 켜 보세요.

프로토콜 기초#

VLESS

VLESS는 경량 프록시 프로토콜로, VMess와 같은 데이터 암호화를 자체적으로 제공하지 않아 보통 TLS 또는 REALITY와 함께 사용합니다. 노드 편집 화면에 encryption: none이 표시되어도 연결 전체가 암호화되지 않는다고 단정할 수는 없습니다. 보안 계층 설정도 확인하세요. 지원되는 조합은 코어와 버전에 따라 다르므로 클라이언트 이름만으로 판단하지 마세요.

프로토콜 기초#

Trojan

Trojan은 보통 TLS 연결에서 동작하며 비밀번호로 인증합니다. 노드를 편집할 때 비밀번호, 서버 주소, 포트, TLS 매개변수를 서버 설정에 맞추고, 비밀번호를 사용자 ID 입력란에 넣지 마세요. 핸드셰이크 오류가 발생하면 시스템 시간, 서버 이름, 인증서를 먼저 확인하고 인증서 검증을 끄는 것으로 문제를 대신 해결하지 마세요.

프로토콜 기초#

Shadowsocks

Shadowsocks의 주요 설정 항목은 서버 주소, 포트, 비밀번호, 암호화 방식입니다. 클라이언트와 서버가 같은 암호화 방식을 지원해야 합니다. 일부 최신 방식은 키 형식도 지정하므로 아무 문자열이나 비밀번호로 사용할 수 있는 것은 아닙니다. 가져온 설정에 필요한 항목이 모두 있어도 연결되지 않는다면 로컬 프록시 모드를 계속 바꾸기보다 현재 코어가 해당 방식을 지원하는지 먼저 확인하세요.

프로토콜 기초#

TLS와 SNI

TLS는 연결을 암호화하고 상대방을 인증하며, SNI는 핸드셰이크 중 대상 서버 이름을 지정합니다. 클라이언트에서는 이 항목이 ‘서버 이름’ 또는 serverName으로 표시될 수 있으며, 일반적으로 인증서와 서버 설정에 맞춰야 합니다. 연결 주소에 IP를 사용하더라도 SNI까지 같은 IP로 임의 변경해서는 안 됩니다.

프로토콜 기초#

REALITY

REALITY는 Xray 생태계의 보안 전송 방식으로, VLESS와 동급인 프록시 프로토콜은 아닙니다. 흔히 VLESS와 REALITY를 조합해 사용합니다. 설정을 가져올 때 서버가 제공한 공개 키, 서버 이름, 짧은 ID, 지문 관련 설정을 확인하세요. 일반 TLS 설정은 보안 유형 하나만 바꿔 REALITY로 전환할 수 없으며, 필요한 매개변수를 임의로 추측해서도 안 됩니다.

프로토콜 기초#

전송 방식

노드 편집 화면의 전송 방식은 프록시 프로토콜을 연결에 실어 보내는 방식을 정합니다. TCP, WebSocket, gRPC가 대표적입니다. WebSocket의 경로와 Host, gRPC의 서비스 이름 같은 항목은 서버 설정에 맞춰야 합니다. 프로토콜이 같아도 전송 방식이 다른 두 노드의 항목을 서로 바꿔 쓸 수는 없습니다. 또한 여기서 말하는 화면 분류는 네트워크 계층 교재의 ‘전송 계층’과 완전히 같은 개념이 아닙니다.

코어와 클라이언트

클라이언트의 정보 화면이나 로그에서 실제로 사용하는 코어를 확인하세요. 지원하지 않는 항목이라는 안내가 표시되면 설정을 실행하는 코어부터 확인한 뒤 설정을 조정하거나 클라이언트를 업데이트할지 판단하세요.

코어와 클라이언트#

Project V와 V2Ray

Project V는 모듈형 네트워크 도구 생태계이며, V2Ray는 그 안의 핵심 프로젝트 이름입니다. 일상적인 대화에서는 이런 설정 생태계 전반을 가리키는 말로도 쓰입니다. V2Ray는 단일 프로토콜도, 특정 Android 앱의 정식 이름도 아닙니다. 가이드를 볼 때는 클라이언트, 코어, VMess 같은 구체적인 프로토콜 중 무엇을 가리키는지 확인해 서로 다른 층위의 설명을 혼동하지 마세요.

코어와 클라이언트#

Xray

Xray는 프로토콜 처리, 라우팅 매칭, 연결 설정을 담당하는 코어 계열이며, v2rayNG는 Xray로 설정을 실행합니다. 링크를 가져올 수 있다고 해서 코어가 링크에 포함된 모든 확장 항목을 지원하는 것은 아닙니다. 호환성을 확인할 때는 클라이언트 버전, 코어 버전, 로그 오류를 함께 기록하세요. 특히 REALITY나 최신 전송 설정을 사용할 때 중요합니다.

코어와 클라이언트#

V2Fly

V2Fly는 V2Ray를 이어서 개발하는 커뮤니티 프로젝트입니다. 코어 이름은 보통 v2fly로 표기하며, v2flyNG는 이 코어 계열을 사용하는 Android 클라이언트입니다. Xray와 생태계의 연관성은 있지만 모든 프로토콜 확장과 설정 항목이 완전히 같다는 뜻은 아닙니다. 코어 계열을 바꾸기 전에 기존 노드의 요구사항을 확인하고 복구할 수 있도록 원래 설정을 보관하세요.

코어와 클라이언트#

그래픽 클라이언트

그래픽 클라이언트는 구독, 노드 편집, 모드 전환, 로그 화면을 제공하고 설정 실행은 코어에 맡깁니다. Android에서는 v2rayNG 또는 v2flyNG를, Windows·macOS·Linux에서는 v2rayN을 사용할 수 있습니다. 클라이언트 자체가 노드 서비스는 아니므로 설치 후에도 유효한 연결 설정을 가져와야 합니다. 같은 용어라도 클라이언트에 따라 메뉴 위치가 다를 수 있습니다.

구독과 노드

먼저 구독 그룹 설정에 주소를 저장하고 업데이트를 실행한 뒤 노드 목록을 확인하세요. 구독을 가져오는 단계, 노드 연결 단계, 앱 접속 단계는 각각 별도로 확인해야 합니다.

구독과 노드#

구독 링크

구독 링크는 클라이언트가 노드 설정 모음을 가져오는 주소이며 일반 웹페이지 주소가 아닙니다. v2rayNG의 구독 그룹 설정에 주소를 입력해 저장한 뒤 메뉴에서 업데이트를 실행해야 하는 경우가 많습니다. 링크에 개인 접속 정보가 포함될 수 있으므로 민감 정보로 취급하세요. 스크린샷이나 로그를 공유하거나 도움을 요청할 때는 주소에 포함된 개인 식별 정보를 모두 가려야 합니다.

구독과 노드#

노드

노드는 클라이언트에 저장된 원격 연결 설정으로, 보통 주소, 포트, 인증 정보, 프로토콜, 전송 매개변수를 포함합니다. 목록 이름은 메모용일 뿐 물리적 위치, 회선 품질, 연결 가능성을 보장하지 않습니다. 구독에서 가져오거나 공유 링크 하나를 직접 불러올 수 있습니다. 문제를 확인할 때는 이름만 보지 말고 구체적인 설정 항목과 로그를 살펴보세요.

구독과 노드#

구독 그룹과 업데이트

구독 그룹은 출처가 다른 설정을 분류하며, 업데이트는 원격에서 제공하는 노드 정보를 다시 가져옵니다. 업데이트 후 노드가 추가·삭제되거나 이름이 바뀔 수 있고, 직접 수정한 구독 노드 설정도 덮어써질 수 있습니다. 사용자 지정 매개변수를 계속 보관하려면 먼저 내보내거나 별도 설정으로 저장하세요. 목록이 비어 있다면 업데이트 로그, 주소 유효성, 응답 형식을 확인하세요.

구독과 노드#

지연 시간과 실제 연결 지연

지연 시간은 특정 테스트 방식으로 측정한 소요 시간입니다. TCP 연결 테스트와 프록시를 통해 웹페이지에 접속하는 테스트는 측정 대상이 다릅니다. 실제 연결 지연은 보통 프록시 경유로 테스트 주소에 접속해 측정하지만, DNS 조회나 핸드셰이크가 포함되는지는 클라이언트 구현에 따라 다릅니다. 비교할 때는 같은 테스트 방식과 대상 주소를 사용하세요. 수치가 낮다고 다운로드 속도가 빠른 것은 아니며, 테스트 시간 초과가 모든 대상에 접속할 수 없다는 뜻도 아닙니다.

라우팅과 DNS

라우팅 설정에서는 ‘어떤 조건으로 매칭할지’와 ‘매칭 후 어떤 아웃바운드로 보낼지’를 먼저 구분하세요. DNS는 주소를 조회하고 라우팅은 경로를 선택합니다. 서로 영향을 줄 수 있지만 같은 설정은 아닙니다.

라우팅과 DNS#

라우팅 규칙과 트래픽 분할

라우팅 규칙은 도메인, IP, 포트 등의 조건으로 연결을 매칭한 뒤 프록시, 직접 연결, 차단 등의 아웃바운드를 지정합니다. 트래픽 분할은 규칙에 따라 트래픽마다 경로를 다르게 보내는 방식입니다. 일반적인 Xray 라우팅 설정에서는 규칙을 순서대로 확인하므로 먼저 매칭된 규칙이 이후 처리에 영향을 줍니다. 규칙을 추가하기 전에 아웃바운드 태그가 존재하는지 확인하고, 더 구체적인 조건은 적절한 위치에 배치해 포괄적인 규칙이 먼저 매칭되는 일을 막으세요.

라우팅과 DNS#

GeoIP

GeoIP는 카테고리별로 정리된 IP 주소 모음이며 라우팅에서 geoip:private 같은 형식으로 해당 카테고리를 참조할 수 있습니다. 이 정보는 불러온 데이터 파일에 기록된 주소 범위를 나타낼 뿐 실시간 위치 정보가 아니며 서버의 실제 물리적 위치를 증명하지도 않습니다. 도메인 연결이 특정 IP 규칙에 매칭되는지는 조회 결과와 domainStrategy의 영향도 받습니다.

라우팅과 DNS#

GeoSite

GeoSite는 관련 도메인 묶음을 라우팅 조건으로 사용할 수 있도록 카테고리별로 정리한 도메인 모음입니다. 규칙에서 사용하는 카테고리 이름이 현재 데이터 파일에 있어야 합니다. 다른 사람의 카테고리 이름을 복사해도 그대로 사용할 수 있는 것은 아닙니다. 특정 서비스의 트래픽이 예상대로 분할되지 않으면 서비스 표시 이름만 보고 규칙이 적용됐다고 판단하지 말고 실제 접속 도메인과 목록의 범위를 확인하세요.

라우팅과 DNS#

domainStrategy

라우팅의 domainStrategy는 매칭 단계에서 도메인을 처리하는 방식을 정합니다. AsIs는 원래 도메인으로 매칭하고, IPIfNonMatch는 매칭되지 않을 때 IP를 조회하며, IPOnDemand는 IP 규칙 매칭에 필요할 때 조회합니다. 같은 이름의 항목이 다른 설정 위치에 있으면 의미와 선택 가능한 값이 다를 수 있습니다. 단순히 ‘속도 향상’ 여부를 정하는 옵션이 아니며 모든 앱의 DNS 서버를 직접 지정하지도 않습니다.

라우팅과 DNS#

로컬 DNS

로컬 DNS는 클라이언트가 기기에서 도메인 조회 처리에 참여하는 기능입니다. 여기서 ‘로컬’은 모든 응답이 오프라인 캐시에서 나온다는 뜻이 아닙니다. v2rayNG에서 관련 설정을 켜도 실제 조회 전송 방식은 VPN의 트래픽 처리, DNS 라우팅, 업스트림 DNS 설정에 따라 달라집니다. 앱 자체의 암호화 DNS가 별도 경로를 사용할 수도 있으므로 설정이 켜져 있는지만 보지 말고 로그도 함께 확인하세요.

라우팅과 DNS#

FakeDNS

FakeDNS는 앱에 가상 IP를 반환한 뒤 연결이 코어에 도달하면 매핑을 통해 원래 도메인을 복원해 도메인 기반 처리를 유지하는 방식입니다. DNS 요청, 트래픽 처리, 관련 코어 설정이 함께 맞아야 하며 공용 DNS 주소를 입력하는 것만으로 사용할 수는 없습니다. 모드를 전환한 뒤에도 앱에 이전 주소가 캐시되어 있다면 연결을 다시 만들거나 관련 캐시를 지워야 할 수 있습니다.

라우팅과 DNS#

DNS 누수

DNS 누수는 도메인 조회가 예상한 경로로 전송되지 않는 현상을 말합니다. 예를 들어 프록시를 거쳐야 하는 조회가 다른 경로로 처리되는 경우입니다. 클라이언트의 DNS 설정, 조회에 사용하는 아웃바운드, 브라우저나 앱 자체의 암호화 DNS를 확인하세요. 테스트 페이지에 표시된 리졸버 이름은 참고 정보일 뿐이며 리졸버 위치가 실제 연결 경로와 같은 것은 아닙니다. 설정과 로그를 함께 확인하세요.

시스템 프록시와 TUN

먼저 앱 트래픽이 클라이언트로 들어오는지 확인한 다음 노드와 라우팅을 점검하세요. 트래픽 처리 범위와 프록시 경로는 별개의 설정입니다. VPN이나 TUN으로 들어온 트래픽도 규칙에 따라 직접 연결될 수 있습니다.

시스템 프록시와 TUN#

시스템 프록시

시스템 프록시는 운영체제가 앱에 제공하는 프록시 주소와 포트 설정입니다. 데스크톱 v2rayN은 이 설정을 이용해 해당 설정을 따르는 앱을 로컬 프록시에 연결할 수 있습니다. 일부 앱은 자체 네트워크 스택이나 별도의 프록시 설정을 사용하므로 시스템 프록시를 자동으로 따르지 않습니다. 브라우저에서는 접속되지만 다른 앱에서는 안 될 때는 노드 장애로 단정하기 전에 트래픽 처리 범위를 확인하세요.

시스템 프록시와 TUN#

VPN과 TUN 모드

Android 클라이언트는 보통 시스템 VPN 서비스를 통해 선택한 트래픽을 처리하며, 처음 실행할 때 시스템 권한을 승인해야 합니다. 데스크톱 v2rayN의 TUN 모드는 가상 네트워크 인터페이스로 트래픽을 처리합니다. 둘 다 별도의 상용 VPN 서비스에 연결한다는 뜻은 아니며, 최종 경로는 노드와 라우팅 규칙에 따라 결정됩니다. 데스크톱에서 TUN을 사용하려면 추가 권한이 필요할 수 있으며 다른 네트워크 트래픽 처리 도구와 충돌하지 않는지도 확인하세요.

시스템 프록시와 TUN#

앱별 프록시

앱별 프록시는 앱마다 트래픽을 클라이언트 처리 대상으로 보낼지 결정하며, 보통 Android의 VPN 모드와 함께 사용합니다. 설정을 열면 먼저 ‘선택한 앱만 포함’인지 ‘선택한 앱 제외’인지 확인하세요. 두 모드에서는 같은 앱을 선택해도 의미가 반대입니다. 앱이 클라이언트로 들어온 뒤에도 라우팅 규칙에 따라 처리되므로, 선택됐다고 모든 연결이 프록시 노드를 거치는 것은 아닙니다.

시스템 프록시와 TUN#

로컬 인바운드와 아웃바운드

인바운드는 로컬 SOCKS 또는 HTTP 리스너처럼 앱에서 코어로 전달된 트래픽을 받습니다. 아웃바운드는 원격 프록시, 직접 연결 또는 다른 방식으로 트래픽을 내보냅니다. 라우팅은 outboundTag 등의 항목으로 아웃바운드 태그를 참조합니다. 이 태그는 설정 내부의 식별자이지 프로토콜 이름이 아닙니다. 로컬 리스닝 포트를 바꾸면 프록시를 수동으로 설정한 앱에서도 포트를 변경해야 합니다. 기기에서만 사용할 때는 리스닝 범위를 제한하세요.

용어별 설정 메뉴

항목의 의미를 파악한 뒤 해당 설정 단계로 돌아가 확인하세요. 기존 설정을 보관하고 한 번에 한 항목만 바꾸며 로그에 표시된 실제 오류를 기록하세요.

구독 가져오기와 연결 확인

노드 목록이 비어 있는 상태에서 설정하려면 구독 주소 저장, 업데이트, 노드 선택, 연결 확인 순서로 진행하세요. 먼저 고급 라우팅을 바꿀 필요는 없습니다.

사용 설명서 보기

클라이언트 선택과 오류 해결

먼저 기기 플랫폼과 코어 요구사항을 확인한 뒤 클라이언트를 선택하세요. 구독 목록이 비거나 앱이 시작되지 않거나 앱이 프록시를 사용하지 않을 때는 증상에 맞는 문제 해결 항목을 확인하세요.