CLIENT TERMINOLOGY

V2Ray 용어 정리
프로토콜, 코어와 설정 항목

공유 링크에서 연결 설정을 파악해 보세요. 6개 주제별 용어를 찾아보고, 사용할 프로토콜, 처리할 코어, 프록시로 보낼 트래픽을 구분할 수 있습니다.

클라이언트 버전에 따라 설정 이름이 달라질 수 있습니다. 서버 설정, 현재 클라이언트 화면과 선택한 코어의 지원 범위를 기준으로 구성하세요.

직접 설정해 보려면 빠른 시작 가이드 보기 →

PROTOCOLS & TRANSPORT

프로토콜과 전송

프로토콜은 연결 양쪽에서 프록시 데이터를 주고받는 방식을 정하고, 전송 방식은 데이터를 전달하는 방법을 정합니다. 두 설정 모두 서버와 일치해야 합니다.

VMess

PROXY PROTOCOL

VMess는 Project V 생태계의 프록시 프로토콜로, 인증과 데이터 암호화 기능을 제공하며 설정에서 보통 UUID로 사용자를 식별합니다. 과거 자료의 alterId는 이전 버전과의 호환을 위한 항목이므로, 예전 설정을 현재 서버에 그대로 적용해서는 안 됩니다. 기기 시간이 크게 어긋나면 인증에 실패할 수 있으므로 시간 동기화와 클라이언트 로그를 함께 확인하세요.

VLESS

LIGHTWEIGHT PROTOCOL

VLESS는 가벼운 프록시 프로토콜로, 자체적으로 VMess와 같은 데이터 암호화 기능을 제공하지 않아 전송 보호를 위해 TLS 또는 REALITY와 함께 사용하는 경우가 많습니다. 이름이 모두 VLESS인 노드라도 전송 방식과 flow 설정은 다를 수 있습니다. 가져오기에 성공했다고 해서 현재 코어가 모든 조합을 지원하는 것은 아닙니다.

Trojan

TLS-BASED PROTOCOL

Trojan은 보통 TLS로 연결을 보호하고 비밀번호로 사용자를 인증합니다. 클라이언트에서 주소와 포트뿐 아니라 서버 이름, 전송 방식 등의 설정도 맞춰야 합니다. 비밀번호가 맞는데도 연결되지 않는다면 비밀번호만 계속 바꾸기보다 인증서, 기기 시간과 서버 설정을 확인하세요.

전송 방식

TCP / WEBSOCKET / GRPC

전송 방식은 프록시 프로토콜 데이터를 전달하는 설정 계층으로, TCP, WebSocket, gRPC 등이 대표적입니다. 같은 프록시 프로토콜에도 여러 전송 방식을 조합할 수 있지만, 지원 여부는 코어 버전에 따라 다릅니다. WebSocket의 path와 Host, gRPC의 serviceName은 각각 의미가 다르므로 옵션 이름만 바꾸고 나머지 항목을 그대로 두면 안 됩니다.

CORES & ECOSYSTEM

코어와 생태계

클라이언트 이름과 프로토콜 이름은 다릅니다. 코어를 선택하기 전에 연결 설정에 필요한 기능부터 확인하세요.

Project V

ECOSYSTEM

Project V는 V2Ray를 대표로 하는 오픈소스 네트워크 프록시 생태계의 기반입니다. 관련 프로젝트는 프로토콜 처리, 전송과 라우팅을 중심으로 도구 체계를 형성합니다. v2rayN 같은 GUI 클라이언트는 연결 설정을 코어가 실행할 수 있는 구성으로 정리합니다. 생태계 이름을 알면 자료를 찾기 쉽지만, 실제 호환성은 구체적인 프로젝트와 버전을 기준으로 확인해야 합니다.

V2Fly

V2RAY COMMUNITY

V2Fly는 V2Ray 프로젝트의 커뮤니티 생태계를 이어받아 일반적으로 v2fly라고 부르는 코어를 유지 관리합니다. Android 클라이언트 v2flyNG는 이 코어 계열을 기반으로 하며, v2rayNG와 기능 범위가 같다고 단정할 수 없습니다. 설정을 가져올 수 없거나 실행에 실패하면 해당 버전의 프로토콜 및 전송 방식 지원 여부를 확인하세요.

Xray

CORE FAMILY

Xray는 V2Ray 생태계에서 시작해 독립 코어로 발전했으며 VLESS, REALITY 등의 기능을 지원합니다. v2rayNG는 Xray 코어를 사용하고, v2rayN에서 선택할 수 있는 코어는 현재 배포 버전을 기준으로 확인해야 합니다. 두 코어는 일부 설정을 공유하지만 신규 항목, 기본 동작과 기능 조합이 항상 동일한 것은 아닙니다.

클라이언트와 코어

INTERFACE / ENGINE

클라이언트는 구독 관리, 노드 선택, 시스템 프록시 전환 등의 GUI를 제공합니다. 코어는 실제로 프로토콜 처리, 라우팅과 연결을 수행합니다. 화면에 옵션이 보여도 선택한 코어가 해당 기능을 지원한다는 뜻은 아닙니다. 문제를 진단할 때는 “V2Ray가 안 돼요”라고만 적기보다 클라이언트 버전, 코어 종류와 코어 버전을 각각 기록하는 편이 좋습니다.

CLIENT FEATURES

클라이언트 기능

먼저 트래픽이 클라이언트로 들어오는 방식을 확인한 다음, 들어온 트래픽이 어디로 분기되는지 살펴보세요. 트래픽 유입 방식과 출구 선택은 별개의 단계입니다.

시스템 프록시

SYSTEM PROXY

시스템 프록시는 운영체제 설정을 통해 해당 설정을 따르는 앱의 요청을 로컬 프록시 포트로 보냅니다. v2rayN의 “시스템 프록시 자동 설정”도 이 단계에 해당하며, 모든 프로그램이 이를 사용하는 것은 아닙니다. 앱 자체 프록시, 별도의 네트워크 스택이나 다른 프록시 도구가 실제 경로를 바꿀 수 있으므로 각각 확인해야 합니다.

TUN 모드

VIRTUAL NETWORK INTERFACE

TUN 모드는 가상 네트워크 인터페이스로 트래픽을 전달합니다. 단순한 시스템 프록시보다 더 많은 앱을 처리하는 경우가 많지만, 라우팅, 제외 항목과 구현 방식에 따라 범위가 달라집니다. 추가 권한이 필요할 수 있고 DNS 및 다른 가상 네트워크 어댑터와의 조정도 필요합니다. 데스크톱 클라이언트의 TUN 설정과 Android의 VPN 연결 기능은 화면에 표시된 이름만으로 같은 기능이라고 볼 수 없습니다.

로컬 수신 포트

LOCAL INBOUND

수신 포트는 클라이언트가 기기에서 프록시 요청을 받는 입구로, 원격 노드의 포트와는 다릅니다. 예를 들어 일부 v2rayN 설정은 SOCKS 10808, HTTP 10809를 사용하지만 실제 값은 현재 설정에서 확인해야 합니다. 앱에 프록시를 직접 설정할 때는 주소, 포트와 프록시 프로토콜을 맞추세요. LAN 접근을 허용하기 전에는 접근 제어도 고려해야 합니다.

앱별 프록시

PER-APP ROUTING

앱별 프록시는 앱에 따라 트래픽을 프록시 경로로 보낼지 결정하며 Android 클라이언트에서 자주 사용됩니다. 설정할 때는 “선택한 앱만 프록시 사용”과 “선택한 앱 우회”를 구분해야 합니다. 두 목록의 의미는 서로 반대입니다. 도메인 기반 트래픽 분기와 함께 적용될 수도 있으며, 최종 경로는 클라이언트의 라우팅 규칙에 따라 달라집니다.

ROUTING & DNS

라우팅과 DNS

도메인 조회, 규칙 매칭과 출구 선택은 서로 연결되어 있습니다. 설정이 적용되는지 판단할 때는 스위치 상태만 보지 말고 실제 연결 경로를 확인해야 합니다.

라우팅 규칙과 트래픽 분기

RULE MATCHING

트래픽 분기는 도메인, IP 또는 다른 조건에 따라 요청을 프록시, 직접 연결, 차단 등의 출구로 보냅니다. 규칙에는 보통 적용 순서가 있으므로, 범위가 넓은 규칙을 앞에 두면 뒤의 세부 규칙이 적용되지 않을 수 있습니다. 도메인 정책 IPIfNonMatch는 도메인 규칙에 일치하지 않을 때 DNS 조회를 통해 IP 조건을 추가로 확인하는 방식입니다. 이 설정 자체가 “모두 프록시” 스위치는 아닙니다.

GeoIP와 GeoSite

IP / DOMAIN DATASETS

GeoIP는 IP 주소 범위를, GeoSite는 도메인을 목록으로 묶어 라우팅 규칙에서 참조합니다. 예를 들어 geosite:category-ads-all은 도메인 목록 참조이며, 차단 출구와 함께 설정해야 실제로 차단됩니다. 목록 이름의 존재 여부는 사용하는 데이터 파일에 따라 다르므로 규칙을 업데이트한 뒤 데이터 출처와 코어 호환성도 확인하세요.

FakeDNS

SYNTHETIC DNS MAPPING

FakeDNS는 앱에 합성 주소를 반환하고, 내부적으로 도메인과 주소의 매핑을 유지해 이후 연결에서도 도메인을 기준으로 처리할 수 있게 합니다. 공용 DNS 서버 주소가 아니며, DNS 서버만 바꾼다고 단독으로 활성화되는 기능도 아닙니다. 매핑을 복원할 수 있는 구성 요소로 관련 트래픽이 돌아오지 않으면 DNS 조회는 성공해도 연결에 실패할 수 있습니다.

DNS 유출

UNEXPECTED RESOLUTION PATH

DNS 유출은 조회가 예상한 경로를 벗어나는 현상입니다. 예를 들어 지정된 경로로 DNS를 조회할 예정이었지만 실제로는 다른 리졸버를 사용할 수 있습니다. 브라우저의 암호화 DNS, 시스템 DNS, 클라이언트 DNS와 TUN의 트래픽 처리 범위가 모두 결과에 영향을 줄 수 있습니다. 테스트 사이트에 표시되는 리졸버 이름은 참고 자료일 뿐이므로 설정 및 로그와 함께 판단하고, 지역 표시 하나만으로 결론 내리지 마세요.

SUBSCRIPTIONS & ENDPOINTS

구독과 노드

구독은 여러 연결 설정을 한꺼번에 업데이트하는 방식이며, 공유 링크는 보통 단일 설정을 나타냅니다. 테스트 결과는 특정 대상과 해당 시점의 연결 과정만 보여 줍니다.

구독

CONFIGURATION FEED

구독은 클라이언트가 하나의 주소에서 여러 연결 설정을 가져와 업데이트하는 방식이며, 단일 노드와는 다릅니다. 응답은 줄마다 공유 링크가 들어 있는 Base64 데이터일 수도 있고 다른 설정 형식일 수도 있으므로 클라이언트가 해당 형식을 파싱할 수 있어야 합니다. 구독 주소에는 접근 정보가 포함될 수 있으니 민감 정보로 취급하세요. 업데이트에 실패하면 반복해서 가져오기보다 응답 내용과 형식을 먼저 확인해야 합니다.

노드

CONNECTION PROFILE

노드는 클라이언트의 개별 연결 설정을 흔히 부르는 이름으로, 보통 서버 주소, 포트, 프로토콜, 인증과 전송 보안 설정이 포함됩니다. 노드 이름은 화면에 표시되는 명칭일 뿐 실제 위치, 성능 또는 연결 가능성을 증명하지 않습니다. 같은 서버도 포트와 전송 설정을 달리하면 서로 다른 연결 설정이 될 수 있습니다.

실제 연결 지연 시간

PROXY REQUEST TIMING

실제 연결 지연 시간은 보통 프록시를 통해 테스트 대상에 요청을 보내 측정합니다. DNS 조회, 연결 수립, 보안 핸드셰이크와 대상 응답 시간이 포함될 수 있으며, 구체적인 측정 범위는 구현에 따라 다릅니다. ICMP Ping이나 다운로드 속도와는 다른 지표입니다. 시간 초과는 노드, 테스트 대상 또는 DNS 조회 경로에서 발생할 수 있으므로 결과를 비교할 때는 같은 대상과 조건을 사용하는 것이 좋습니다.

SECURITY & ENCRYPTION

보안과 암호화

연결 가능 여부와 인증 성공 여부는 별개의 문제입니다. 인증서 오류가 발생하면 원인을 찾아야 하며, 검증을 느슨하게 해 알림만 없애서는 안 됩니다.

TLS

TRANSPORT LAYER SECURITY

TLS는 전송 암호화와 인증을 제공하며, 프록시 연결을 보호하는 데 자주 사용됩니다. 정상적인 인증서 검증은 신뢰 체인, 유효 기간과 서버 이름을 확인하며 기기 시간이 잘못되어도 오류가 발생할 수 있습니다. TLS는 해당 연결 구간을 보호할 뿐, 구독 출처나 원격 서비스 또는 모든 앱의 동작까지 보장하지는 않습니다.

SNI

SERVER NAME INDICATION

SNI는 TLS 핸드셰이크에서 대상 서버 이름을 나타내는 확장 기능으로, 클라이언트 설정에서는 serverName 또는 서버 이름 등의 항목으로 표시됩니다. 연결 주소가 IP여도 검증할 이름은 서버에서 제공한 설정에 맞춰 입력해야 합니다. SNI와 WebSocket Host는 서로 다른 계층에 있으므로 한쪽을 바꾸면 다른 쪽도 자동으로 수정된다고 볼 수 없습니다.

REALITY

TRANSPORT SECURITY

REALITY는 Xray 생태계의 전송 보안 방식으로, VLESS와 함께 사용하는 경우가 많습니다. VLESS와 나란히 분류되는 노드 프로토콜은 아닙니다. 서버에서 제공한 서버 이름, 공개 키, shortId 등의 설정을 클라이언트와 맞춰야 하며 fingerprint와 flow도 해당 설정에 따라 확인해야 합니다. 지원 범위는 코어와 클라이언트 버전에 따라 달라지므로 링크 접두어만으로 호환 여부를 판단할 수 없습니다.

allowInsecure

CERTIFICATE VERIFICATION

allowInsecure는 일부 코어 설정에서 TLS 인증서 검증을 건너뛸지 제어하는 항목입니다. GUI에서는 “안전하지 않은 연결 허용” 등으로 표시될 수 있습니다. 이 설정을 켜면 일부 인증서 오류를 우회할 수 있지만 인증이 약해지며 모든 핸드셰이크 문제를 해결하지는 못합니다. 시스템 시간, 서버 이름, 인증서 체인과 서버 설정을 먼저 확인하고, 장기간 활성화하는 것은 권장하지 않습니다.

V2Ray 클라이언트 다운로드