VMess
VMess protocol
VMess는 Project V 생태계의 프록시 프로토콜로, 사용자 ID를 이용해 인증하고 프록시 요청의 캡슐화 방식을 정의합니다. 클라이언트와 서버의 인증 매개변수가 일치해야 하며, 시스템 시간이 크게 어긋나도 인증에 문제가 생길 수 있습니다. VMess를 설정할 때는 전송 방식과 TLS 설정도 확인해야 합니다. 프로토콜 이름만으로 연결 설정 전체가 올바른지 판단할 수는 없습니다.
V2Ray 용어 정리
프로토콜은 요청 형식, 코어는 처리, 클라이언트는 설정을 담당합니다. 먼저 각 개념이 어느 계층에 속하는지 구분한 뒤 구독·라우팅·DNS 설정을 확인하세요.
VMess / VLESS
REALITY
Xray / V2Fly
용어 25개를 6개 범주로 나눴습니다. 범주 링크로 이동하거나 브라우저의 페이지 검색으로 용어를 찾을 수 있으며, 각 카드에는 고유한 앵커가 있습니다.
프로토콜 및 전송
연결을 설정할 때는 프록시 프로토콜, 전송 방식, 전송 보안을 구분해야 합니다. 서로 대체할 수 있는 항목이 아닙니다.
VLESS
VLESS protocol
VLESS는 가벼운 프록시 프로토콜로, 자체적으로 페이로드를 암호화하지 않습니다. 일반적으로 TLS나 REALITY 같은 전송 보안 방식과 함께 사용합니다. VMess와 인증 방식 및 설정 항목이 다르므로 프로토콜 이름만 바꿔서는 변환할 수 없습니다. 가져온 설정의 사용자 ID, 전송 방식, 보안 매개변수를 확인하세요. flow 항목이 있다면 사용하는 코어가 해당 조합을 지원하는지도 확인해야 합니다.
Trojan
Trojan protocol
Trojan은 일반적으로 TLS 연결 안에서 프록시 요청을 전달하고 비밀번호로 인증합니다. 비밀번호가 맞아도 연결에 필요한 조건을 모두 충족한 것은 아닙니다. 서버 이름, 포트, 인증서 검증도 확인해야 합니다. 연결에 실패하면 먼저 서버에서 제공한 설정값을 대조하고, 정상적인 인증서 검증을 유지하세요. 검증을 끄면 인증서 설정 문제가 가려지고 연결 상대를 확인하는 기능도 약해질 수 있습니다.
REALITY
REALITY transport security
REALITY는 Xray 생태계의 전송 보안 방식으로, VLESS와 나란히 쓰이는 독립 프록시 프로토콜은 아닙니다. 일반적인 설정에서는 VLESS로 프록시 요청을 전달하고 REALITY로 전송을 보호합니다. 서버 이름, 공개 키, 짧은 ID, 클라이언트 지문 등의 매개변수를 서버 요구사항에 맞게 입력하고, 클라이언트가 호출하는 코어의 REALITY 지원 여부도 확인해야 합니다.
코어별 지원 범위 확인 →전송 방식
Transport
전송 방식은 네트워크 연결에서 프록시 프로토콜 데이터를 전달하는 방법이며, TCP, WebSocket, gRPC 등이 있습니다. VMess나 VLESS 같은 프록시 프로토콜과는 별도의 설정 계층이고 TLS 암호화 설정과도 다릅니다. WebSocket 경로와 요청 헤더, gRPC 서비스 이름은 연결 조건에 포함될 수 있으므로 비슷한 이름을 보고 추측하지 말고 서버가 지정한 값을 사용하세요.
코어 및 생태계
화면에 옵션이 표시된다고 해서 현재 코어가 해당 설정을 지원하는 것은 아닙니다.
Project V
Project V ecosystem
Project V는 V2Ray 오픈소스 생태계를 이해하는 데 필요한 프로젝트 배경으로, 프록시 처리와 설정, 관련 도구를 아우릅니다. 일상적으로 설치하는 그래픽 클라이언트, 연결을 실제로 처리하는 코어, 중국어 튜토리얼은 각각 역할이 다릅니다. 설정이 다른 경우 자료에서 다루는 클라이언트와 코어가 무엇인지 먼저 확인하고, 생태계 이름을 서로 바꿔 쓸 수 있는 소프트웨어 이름으로 오해하지 마세요.
V2Fly
V2Fly / V2Ray core
V2Fly는 커뮤니티가 관리하는 V2Ray 프로젝트 계열이며, 코어가 프로토콜 파싱, 라우팅 판단, 아웃바운드 연결 등을 처리합니다. 안드로이드 클라이언트 v2flyNG는 이 코어 계열을 사용하므로 해당 설정 동작이 필요한 경우에 적합합니다. 설정 자료는 실제 버전에 맞춰 확인하세요. 다른 코어에 추가된 프로토콜 기능이나 설정 항목을 V2Fly에서도 사용할 수 있다고 가정하면 안 됩니다.
Xray
Xray core
Xray는 V2Ray와 기술적 뿌리를 공유하는 오픈소스 코어 프로젝트로, VLESS와 REALITY 등의 기능을 제공합니다. v2rayNG는 Xray 코어를 사용하며 데스크톱 클라이언트 v2rayN도 적절한 코어를 호출해 연결을 처리할 수 있습니다. 두 코어 계열은 설정이 일부 비슷하지만 프로토콜 지원, 전송 조합, 세부 항목이 완전히 같지는 않습니다. 전환하기 전에 현재 설정의 호환성을 확인하세요.
그래픽 클라이언트
Graphical client
그래픽 클라이언트는 구독 가져오기, 서버 선택, 라우팅 설정, 로그 확인 등의 화면을 제공하고, 코어는 실제 네트워크 처리를 담당합니다. 이 사이트에서 소개하는 클라이언트는 데스크톱용 v2rayN과 안드로이드용 v2rayNG, v2flyNG입니다. 화면 프로그램 업데이트와 코어 업데이트는 별개입니다. 호환성 문제를 확인할 때는 클라이언트 버전, 코어 종류, 사용 중인 설정을 모두 확인하세요.
구독 및 노드
구독으로 설정을 가져온 다음 서버 선택과 연결 시작을 진행해야 합니다.
구독
Subscription
구독은 하나의 주소에서 여러 서버 설정을 가져오는 배포 방식이며, 갱신할 때 클라이언트가 원격 콘텐츠를 다시 읽습니다. 구독 주소에 접근 인증 정보가 포함될 수 있으므로 화면을 공유하거나 로그를 전송하기 전에 전체 주소를 가리세요. 갱신 성공은 설정을 가져와 파싱했다는 뜻일 뿐, 모든 설정으로 연결할 수 있다는 의미는 아닙니다. 갱신에 실패했다면 주소 유효성, 가져오기 경로, 구독 형식을 각각 확인하세요.
구독 관리 안내 보기 →노드
Server profile
노드는 클라이언트 목록에 등록된 프록시 서버 연결용 설정으로, 일반적으로 주소, 포트, 프로토콜, 인증, 전송 매개변수가 포함됩니다. 표시 이름은 항목을 구분하기 위한 것으로 서버 위치나 실제 네트워크 품질을 보장하지 않습니다. 문제를 확인할 때는 메모만 보지 말고 설정 항목과 연결 로그를 살펴보세요. 구독으로 가져온 항목은 갱신 후 교체되거나 삭제될 수도 있습니다.
구독 그룹
Subscription group
구독 그룹은 클라이언트에서 구독 출처와 서버 항목을 정리하는 관리 단위이며, 메모를 붙여 출처를 구분할 수 있습니다. 그룹 이름은 서버 측 정보를 바꾸지 않으며 요청의 아웃바운드를 자동으로 결정하지도 않습니다. 그룹 갱신, 서버 필터링, 정렬 방식은 클라이언트 구현에 따라 다릅니다. 필터를 설정했다면 항목이 필터링된 것인지 구독 자체를 가져오지 못한 것인지 확인하세요.
실제 연결 지연 시간
Real connection latency
실제 연결 지연 시간은 선택한 프록시 설정으로 테스트 대상에 접속해 측정한 시간입니다. 서버 포트만 테스트하는 것보다 실제 요청 경로에 가깝습니다. 연결 설정, 핸드셰이크, 응답 시간의 포함 여부는 클라이언트의 테스트 방식에 따라 다릅니다. 다운로드 속도와 같지 않으며 모든 대상에 연결할 수 있음을 보장하지도 않습니다. 같은 테스트 주소와 네트워크 조건에서 결과를 비교하고, 시간 초과는 로그와 함께 확인하세요.
라우팅 규칙
먼저 요청이 클라이언트로 들어왔는지 확인한 다음 어떤 아웃바운드 규칙이 적용됐는지 살펴보세요.
라우팅 규칙
Routing rule
라우팅 규칙은 도메인, 대상 IP, 포트, 네트워크 유형 등의 조건에 따라 요청의 아웃바운드를 선택합니다. 일반적인 코어는 규칙을 순서대로 확인하므로 처음 일치하는 규칙이 출구를 결정합니다. 따라서 구체적인 예외 규칙을 더 포괄적인 규칙보다 앞에 배치하세요. 도메인 조건의 매칭 여부는 코어가 도메인 정보를 가져올 수 있는지에도 달려 있으므로, 매칭되지 않는 원인을 규칙 순서로만 단정하면 안 됩니다.
규칙 문법 및 우선순위 보기 →트래픽 분기
Traffic routing
트래픽 분기는 조건에 따라 요청을 프록시, 직접 연결, 차단 중 하나로 보내는 정책입니다. 시스템 프록시나 TUN은 트래픽이 처리 경로로 들어오는 방식을 정하고, 트래픽 분기는 들어온 요청이 어떤 경로로 나갈지 결정합니다. 두 개념을 혼동하지 마세요. 앱이 클라이언트에 연결되어 있어도 규칙에 따라 특정 대상은 직접 연결될 수 있습니다. 동작을 확인할 때는 프록시 스위치만 보지 말고 실제로 적용된 아웃바운드를 확인하세요.
GeoIP
IP address datasets
GeoIP는 국가·지역이나 특수 주소 유형별로 정리한 IP 데이터 모음입니다. 자주 사용하는 규칙 표기에는 geoip:cn과 geoip:private가 있습니다. 대상 IP를 기준으로 매칭하며 특정 웹사이트의 서비스나 소유자를 직접 식별하지는 않습니다. 데이터 버전, 주소 할당 변경, DNS 조회 결과에 따라 매칭 결과가 달라질 수 있습니다. 같은 도메인도 서로 다른 주소로 해석되면 규칙 결과가 달라질 수 있습니다.
GeoSite
Domain name datasets
GeoSite는 지역, 서비스, 용도별 도메인 모음으로 라우팅 및 DNS 규칙에 사용할 수 있습니다. 예를 들면 geosite:cn과 같이 표기합니다. IP의 지리적 위치를 조회하는 기능이 아니라 도메인 목록입니다. 태그의 존재 여부와 포함 도메인은 불러온 데이터 파일에 따라 달라집니다. 규칙 오류나 누락이 발생하면 데이터 출처와 태그 이름을 확인하고 해당 도메인이 목록에 포함되어 있는지도 살펴보세요.
DNS 및 네트워크
DNS 조회 경로와 서비스 요청 경로는 다를 수 있으므로 각각 확인해야 합니다.
DNS
Domain Name System
DNS는 도메인을 IP 주소 등의 레코드로 변환하며, 조회가 끝나야 앱이 대상에 연결할 수 있습니다. 운영체제, 브라우저, 프록시 코어가 서로 다른 DNS 경로를 사용할 수 있으므로 한 곳을 변경해도 다른 경로에는 영향을 주지 않을 수 있습니다. 문제를 확인할 때는 조회 실패, 예상과 다른 주소, 연결 실패를 구분하고 DNS 캐시에 이전 결과가 남아 있는지도 살펴보세요.
FakeDNS
Synthetic DNS mapping
FakeDNS는 도메인에 가상 주소를 할당하고 주소와 도메인의 매핑을 저장해 이후 연결에서 도메인 정보를 복원하고 라우팅에 활용할 수 있도록 합니다. 가상 주소는 웹사이트의 실제 서버 주소가 아니므로 일반적인 공용 네트워크 대상으로 사용하면 안 됩니다. 활성화할 때는 DNS 응답과 연결 가로채기 경로가 함께 동작해야 합니다. 비활성화한 뒤에도 앱에 가상 주소가 캐시되어 있다면 캐시를 지우거나 연결을 다시 설정해야 할 수 있습니다.
DNS 누수
DNS leak
DNS 누수는 서비스 요청은 프록시를 통과하지만 DNS 질의는 로컬 네트워크에서 나가는 등, 조회가 예상한 경로를 벗어나는 현상입니다. 누수 여부는 설정에서 의도한 동작을 기준으로 판단해야 하며, 의도적으로 직접 조회하도록 설정한 경우까지 모두 문제로 볼 수는 없습니다. 운영체제 DNS 리졸버, 브라우저 보안 DNS, 클라이언트 DNS 설정, 연결 로그를 함께 확인하세요. 테스트 페이지 하나만으로는 모든 앱의 동작을 파악할 수 없습니다.
DoH
DNS over HTTPS
DoH는 HTTPS로 DNS 질의와 응답을 전달해 전송 중인 조회 내용을 보호합니다. 이는 DNS 질의의 전송 방식을 바꾸는 기능으로, 요청이 자동으로 프록시를 통과하거나 현재 아웃바운드 네트워크에 적합한 결과를 얻도록 보장하지는 않습니다. 브라우저에서 별도의 DoH를 사용하면 시스템 DNS 설정을 우회할 수 있으므로 클라이언트 DNS를 조정할 때 앱 자체의 DNS 설정도 확인해야 합니다.
클라이언트 설정
트래픽 연결과 아웃바운드 정책은 서로 다른 단계입니다. 활성화한 뒤에도 실제 요청이 어떻게 처리되는지 확인하세요.
시스템 프록시
System proxy
시스템 프록시는 시스템이나 시스템 설정을 따르는 앱이 로컬 프록시 주소를 사용하도록 지정합니다. v2rayN의 ‘시스템 프록시 자동 설정’이 이에 해당하지만, 자체 네트워크 설정을 사용하는 앱은 시스템 옵션을 따르지 않을 수 있습니다. 시스템 프록시는 라우팅 모드가 아니며 모든 트래픽을 가로채지도 않습니다. 클라이언트를 종료한 뒤 앱이 인터넷에 연결되지 않으면 시스템 프록시가 중지된 로컬 서비스 주소를 계속 가리키는지 확인하세요.
라우팅 모드
Routing preset
라우팅 모드는 전체 프록시나 중국 본토 우회처럼 클라이언트가 제공하는 규칙 프리셋으로, 이미 수신한 요청의 출구를 정합니다. 전체 프록시 모드여도 모든 앱이 클라이언트에 연결되는 것은 아닙니다. 트래픽 유입 경로는 시스템 프록시, 앱 설정, TUN에 따라 달라집니다. 같은 이름의 프리셋도 클라이언트마다 규칙이 다를 수 있으므로 실제 동작을 확인하려면 구체적인 규칙과 기본 아웃바운드를 살펴보세요.
프록시 모드 비교 보기 →TUN 모드
Virtual network interface
TUN 모드는 가상 네트워크 인터페이스에서 IP 패킷을 받아 프록시 처리 경로로 전달하므로 시스템 프록시를 직접 사용할 수 없는 앱에 적합합니다. 서버 설정을 자동으로 변경하지 않으며 모든 프로토콜이 문제없이 전달되는 것도 아닙니다. 활성화할 때는 권한, 기본 경로, DNS 가로채기, 다른 네트워크 소프트웨어의 영향을 확인하세요. 지원 기능은 클라이언트와 사용하는 구현에 따라 다릅니다.
VPN 모드
Android VPN interface
안드로이드 클라이언트의 VPN 모드는 시스템 VPN 인터페이스를 통해 앱 트래픽을 받으며, 처음 활성화할 때는 보통 사용자 권한이 필요합니다. 시스템에 연결이 표시되어도 인터페이스가 만들어졌다는 뜻일 뿐 원격 서버를 사용할 수 있다는 보장은 아닙니다. 적용 앱 범위, DNS, 라우팅 규칙에 따라 실제 동작이 달라집니다. 같은 인터페이스를 사용하는 다른 앱과 함께 실행할 때는 시스템의 활성 연결 제한도 고려하세요.