PROJECT V / CONFIGURATION GLOSSARY

V2Ray 용어집
프로토콜, 코어와 트래픽 분할

v2rayN이나 v2rayNG에서 낯선 설정을 발견했다면 먼저 어느 계층에 속하는지 확인하세요. 여기서는 자주 쓰는 개념을 6개 범주로 정리했으며, 각 용어 카드 제목 옆 링크를 눌러 해당 항목으로 바로 이동할 수 있습니다.

단계별 클라이언트 설정 방법 →프로토콜 선택 가이드 보기 →

PROTOCOL

프록시 프로토콜

프로토콜은 클라이언트와 서버가 프록시 요청을 주고받고 인증하는 방식을 정합니다. 프로토콜이 같다는 것은 시작점일 뿐이며, 전송 및 보안 설정도 일치해야 합니다.

VMess: Project V 생태계의 프록시 프로토콜로, 사용자 인증과 데이터 보호 기능을 제공하며 UUID 등의 필드가 설정에 자주 등장합니다. 클라이언트와 서버에서 같은 프로토콜을 선택하는 것뿐 아니라 전송 방식과 보안 설정도 맞춰야 합니다. 기기 시간 차이가 인증에 영향을 줄 수 있으므로 연결에 실패하면 로컬 프록시 포트를 바꾸기보다 자동 시간 동기화를 확인하세요.

VLESS: 프록시 프로토콜과 하위 보안 메커니즘을 분리한 경량 프로토콜로, TLS 또는 REALITY와 함께 사용하는 경우가 많습니다. 일반적인 설정에서는 외부 계층이 전송을 보호하므로 이름만으로 전체 연결의 암호화 방식을 판단할 수 없습니다. 새 확장 기능은 양쪽 코어 버전의 지원 여부도 확인해야 합니다. 가져온 뒤에는 UUID, 전송 유형, 보안 유형, flow를 모두 확인하세요. 서버 주소만 점검해서는 충분하지 않습니다.

Trojan: 일반적으로 TLS로 전송을 보호하고 비밀번호로 인증하는 프록시 프로토콜입니다. 비밀번호가 맞더라도 나머지 설정이 올바르다는 보장은 없습니다. 서버 이름, 인증서 검증, 전송 방식도 연결에 영향을 줍니다. 인증서 오류가 발생하면 인증서 검증을 건너뛰는 방식으로 해결하기보다 도메인, 기기 시간, 서버 인증서를 먼저 확인하세요.

Shadowsocks / SS: 암호화 프록시 프로토콜 계열로, 클라이언트에서는 보통 SS라고 줄여 부릅니다. 서버, 포트, 암호화 방식, 키가 주요 설정입니다. 프로토콜 변형에 따라 키 형식과 코어 지원 조건이 다르므로 익숙해 보이는 암호화 방식으로 임의 변경하지 마세요. 가져오기에 실패하면 먼저 구체적인 프로토콜 변형을 확인한 뒤 클라이언트 버전과 공유 형식을 점검하세요.

CORE & PROJECT

코어와 프로젝트

클라이언트는 화면을 제공하고 코어는 연결을 실행합니다. 프로젝트 간 관계를 이해하면 특정 설정의 지원 여부를 판단할 수 있습니다.

Project V: V2Ray의 기원과 관련된 프로젝트 및 도구 생태계를 가리키는 개념으로, 조합 가능한 프록시·전송·라우팅 기능을 강조합니다. 그래픽 인터페이스가 포함된 설치 패키지도 아니고, VMess를 다르게 부르는 말도 아닙니다. 자료를 읽을 때는 프로젝트 생태계, 특정 코어, 코어 관리용 클라이언트 중 무엇을 가리키는지 확인해 서로 다른 계층의 기능을 혼동하지 마세요.

V2Fly: V2Ray 개발을 이어가는 커뮤니티 프로젝트로, 관련 코어와 설정 기능을 유지 관리합니다. v2flyNG는 주로 이 코어를 기반으로 하지만 클라이언트의 설정 이름이 하위 설정 필드와 정확히 일치하지 않을 수 있습니다. V2Fly와 Xray는 각각 발전해 왔으므로 프로토콜 확장이나 전송 옵션이 필요하다면 실제 버전의 지원 여부를 확인하세요. 두 프로젝트의 기능이 완전히 호환된다고 가정할 수 없습니다.

Xray: V2Ray에서 파생되어 발전한 프록시 코어 프로젝트로, 프로토콜 처리, 전송 보안, 라우팅 등을 담당하며 v2rayNG에서 자주 사용합니다. REALITY 등 기능은 구체적인 Xray 버전과 설정을 기준으로 확인해야 합니다. 그래픽 인터페이스에 옵션이 표시된다고 해서 현재 실행 중인 코어가 이를 지원한다는 뜻은 아닙니다. 문제를 진단할 때는 클라이언트와 코어 버전을 모두 기록하세요.

프록시 코어: 로컬 연결을 실제로 수신하고 프록시 요청을 처리하며 라우팅을 실행해 원격 서버에 연결하는 프로그램입니다. v2rayN 같은 그래픽 클라이언트는 설정을 관리하고 실행 매개변수를 생성하며 로그를 보여 주고, 코어는 설정을 실행합니다. 인터페이스가 열려 있어도 코어가 시작되지 않으면 프록시는 작동하지 않습니다. 따라서 화면의 스위치보다 실행 로그의 시작 결과가 문제 진단에 더 유용합니다.

TRANSPORT & SECURITY

전송 계층과 위장

인터페이스에서 전송 방식과 보안 유형이 나란히 표시되더라도 서로 다른 문제를 다룹니다. 어느 항목을 변경하든 서버 설정과 일치해야 합니다.

TCP: 신뢰성 있고 순서가 보장된 바이트 스트림을 제공하며 재전송, 순서 제어, 혼잡 제어 등 기본 기능을 담당하는 전송 계층 프로토콜입니다. 클라이언트 설정의 TCP 또는 raw라는 명칭은 코어 버전에 맞춰 해석해야 하며 암호화 옵션이 아닙니다. 이 전송 방식을 선택한 뒤에도 TLS나 REALITY 사용 여부를 별도로 확인하세요. 안정적인 전송과 안전한 전송은 같은 의미가 아닙니다.

WebSocket / WS: 일반적으로 HTTP 업그레이드로 연결을 설정하는 양방향 통신 방식으로, 프록시 설정에서 전송 방식으로 사용할 수 있습니다. 관련 필드로는 경로와 Host가 있으며 TLS 서버 이름은 별도 계층에 속합니다. 핸드셰이크에 실패하면 경로, 요청 헤더, 리버스 프록시, 인증서 설정을 각각 확인하세요. 모든 도메인 관련 필드에 같은 값을 무조건 입력하지 마세요.

gRPC: HTTP/2 기반 원격 호출 프레임워크로, 일부 프록시 코어에서 전송 방식으로 사용합니다. 클라이언트의 서비스 이름을 서버 설정과 일치시켜야 하며, 앞단의 리버스 프록시도 필요한 HTTP/2 전달을 지원해야 합니다. 연결이 설정된 뒤에도 반복해서 끊긴다면 인증 정보뿐 아니라 중간 장비의 유휴 시간 제한과 연결 유지 설정도 점검하세요.

REALITY: Xray 생태계의 전송 보안 방식으로 VLESS 연결 설정에 자주 쓰이지만, VLESS와 동급인 별도의 프록시 프로토콜은 아닙니다. 인증 정보, 서버 이름, shortId 등은 서버에서 제공한 값에 맞춰 입력해야 하며, 필드 이름은 버전에 따라 달라질 수 있습니다. Vision flow와는 별개의 설정이므로 가져온 뒤 각각 확인하고 서로 대체하지 마세요.

ROUTING

라우팅과 트래픽 분할

먼저 트래픽을 클라이언트에 어떤 방식으로 전달할지 정하고, 다음으로 어느 아웃바운드를 사용할지 정하세요. 트래픽 가로채기 방식과 라우팅 정책은 별개의 설정입니다.

라우팅 규칙과 트래픽 분할: 도메인, IP, 포트 등의 조건에 따라 연결을 직접 연결, 프록시, 차단 등의 아웃바운드로 보내는 방식입니다. 일반적으로 규칙은 순서대로 적용되므로 포괄적인 규칙을 앞에 두면 뒤의 세부 규칙이 적용되지 않을 수 있습니다. 도메인 전략, DNS 결과, 기본 아웃바운드도 최종 경로에 영향을 줍니다. 규칙 이름만 보고 모든 접속이 같은 경로를 따른다고 판단하지 마세요.

GeoIP: 지역이나 기타 태그에 따라 분류한 IP 주소 목록으로, 라우팅에서 대상 IP를 매칭하는 데 사용합니다. 데이터셋의 분류를 나타낼 뿐 웹사이트의 언어, 운영 주체, 정확한 지리적 위치를 의미하지 않습니다. 동적 IP나 콘텐츠 전송 서비스를 사용하는 사이트는 도메인 규칙도 함께 확인하세요. 데이터 파일 누락, 잘못된 태그, 오래된 데이터로 인해 예상과 다르게 매칭될 수 있습니다.

GeoSite: 서비스, 용도 또는 기타 태그에 따라 정리한 도메인 목록으로, 특정 유형의 웹사이트에 라우팅 정책을 적용할 때 유용합니다. GeoIP를 다른 이름으로 부르는 것이 아닙니다. 코어가 도메인 정보를 가져올 수 있고 해당 태그가 포함된 데이터 파일을 불러와야 적용됩니다. 사이트가 규칙에 매칭되지 않는다면 클라이언트 화면만 업데이트하지 말고 실제 요청 도메인과 규칙 내용을 확인하세요.

TUN 모드: 가상 네트워크 인터페이스로 IP 트래픽을 받아 처리하는 연결 방식으로, 시스템 프록시를 사용하지 않는 앱까지 트래픽을 전달할 때 자주 사용합니다. 실제 적용 범위는 시스템 라우팅, DNS, 권한, 클라이언트 구현에 따라 달라집니다. 스위치를 켠다고 모든 통신이 자동으로 예상대로 처리되는 것은 아닙니다. 활성화 후 DNS 오류나 루프가 발생하면 라우팅 제외 설정과 다른 가상 네트워크 도구와의 충돌을 확인하세요.

시스템 프록시: 운영체제의 프록시 설정을 클라이언트의 로컬 수신 주소로 지정해 해당 설정을 지원하는 앱이 프록시를 사용하게 합니다. 일부 앱은 자체 네트워크 설정을 사용해 시스템 프록시를 무시할 수 있으므로 브라우저에서 접속된다고 다른 프로그램도 같은 경로를 이용하는 것은 아닙니다. 클라이언트를 종료한 뒤 웹페이지에 문제가 생기면 시스템 프록시가 종료된 로컬 포트를 가리키고 있지 않은지 확인하세요.

SUBSCRIPTION & CONFIGURATION

구독과 설정

구독은 설정을 배포하고 공유 링크는 보통 단일 연결을 설명합니다. 가져오기가 완료된 뒤에도 코어 지원 여부와 로컬 실행 설정을 확인해야 합니다.

구독: 하나의 주소에서 연결 설정 묶음을 가져오고 업데이트하는 배포 방식입니다. 클라이언트가 해당 주소에서 반환하는 콘텐츠 형식을 이해해야 합니다. 구독 주소와 웹사이트 로그인 주소는 다르며, 업데이트에 성공해도 모든 설정이 연결되는 것은 아닙니다. 주소에 개인 인증 정보가 포함될 수 있으므로 스크린샷, 오류 로그, 설정을 공유하기 전에 전체 주소를 가리세요.

노드: 클라이언트에서 원격 연결 설정 한 건을 가리킬 때 흔히 쓰는 말로, 보통 서버 주소, 포트, 프로토콜, 인증, 전송, 보안 설정이 포함됩니다. 표시 이름은 메모일 뿐 실제 서버 위치나 연결 품질을 나타내지 않습니다. 이름이 다른 두 설정이 같은 원격 서버를 가리킬 수 있고, 같은 주소에서 포트별로 서로 다른 프로토콜을 제공할 수도 있으므로 구체적인 필드를 확인하세요.

여러 기기 간 설정 공유: 여러 기기에서 같은 구독이나 연결 설정 묶음을 재사용하는 관리 방식으로, 클라이언트 계정이나 자동 클라우드 동기화가 꼭 필요한 것은 아닙니다. 연결 정보는 재사용할 수 있어도 라우팅, DNS, 수신 포트, 권한 설정까지 그대로 적용되는 것은 아닙니다. 데스크톱과 Android에서 트래픽 가로채기 방식을 각각 확인하세요. 구독 제공자가 동시 연결 기기 수를 제한한다면 이용 규칙에 맞춰 연결을 관리해야 합니다.

DNS & NETWORK

DNS와 네트워크 기초

연결 성공, 도메인 확인 성공, 대상 서비스 접속 성공은 각각 다른 단계의 결과입니다. 테스트하기 전에 어느 단계의 결과를 측정하는지 확인하세요.

DNS: 도메인을 IP 주소 등의 레코드로 변환하는 시스템입니다. 조회 결과는 이후 연결과 일부 라우팅 판단에 영향을 줍니다. 운영체제, 브라우저, 프록시 코어가 각각 DNS 조회를 수행할 수 있으므로 한 곳에서 DNS를 변경해도 모든 요청에 적용된다고 볼 수 없습니다. 문제를 진단할 때는 어느 주체가 어떤 경로와 상위 DNS를 사용하는지, 실패 후 폴백이 발생하는지 확인하세요.

FakeDNS: 도메인에 가상 IP를 할당하고 도메인과 가상 주소 간 매핑을 유지해 이후 연결에서 도메인 정보를 복원하는 방식입니다. 가상 주소는 대상 서비스의 실제 공인 IP가 아니므로 트래픽 가로채기, 주소 대역 라우팅, 코어의 매핑 기능과 함께 사용해야 합니다. 활성화하거나 비활성화한 뒤에도 앱에 이전 결과가 남아 있다면 DNS 캐시를 지우거나 관련 앱을 다시 시작해야 할 수 있습니다.

DNS 누수: DNS 조회가 예상한 경로를 벗어나 의도하지 않은 DNS 확인 주체에 전달되는 현상입니다. 판단에 앞서 어떤 DNS 서비스를 사용해야 하는지 명확히 하세요. 브라우저 내장 보안 DNS, 시스템 폴백, 앱 자체 DNS 조회가 실제 경로를 바꿀 수 있습니다. 검사 페이지에 낯선 사업자 이름이 표시되어도 단서일 뿐이므로 상위 DNS의 운영 주체, 클라이언트 로그, 구체적인 설정을 함께 확인하세요.

실제 연결 지연 시간: 프록시 연결을 통해 테스트 대상에 접속해 측정한 시간으로, ICMP ping이나 TCP 연결 시간만 측정한 결과와는 의미가 다릅니다. DNS 조회, 프로토콜 핸드셰이크, TLS, 대상 서버 응답이 측정에 포함되는지는 클라이언트 구현과 테스트 설정에 따라 달라집니다. 비교할 때는 같은 대상과 같은 측정 기준을 사용하세요. 한 번 측정한 시간이 짧다고 다운로드 속도가 빠르거나 모든 웹사이트에 접속할 수 있는 것은 아닙니다.