CONFIGURATION GLOSSARY
V2Ray 용어집: 프로토콜, 코어, 구독과 라우팅
설정 파일 필드와 클라이언트 설정을 바탕으로 주요 용어의 정확한 의미, 조합 관계, 문제 확인 위치를 설명합니다. 프로토콜, 코어, 클라이언트 기능을 별도로 분류해 서로 다른 계층의 개념을 혼동하지 않도록 구성했습니다.
5개 범주
설정 계층별 정리
30개 용어
주요 설정 항목 포함
엔지니어링 정의
실제 역할 설명 포함
PROTOCOL & SECURITY
프로토콜·암호화
프로토콜, 인증 식별자, 보안 계층은 서로 다른 설정 계층에 속합니다. 일반적인 완성 노드는 이 매개변수들을 전송 방식과 함께 조합해야 합니다.
- VMess
- Project V 생태계에서 클라이언트와 서버가 통신하는 프로토콜로, 사용자 인증, 시간 검증, 데이터 전송 형식을 포함합니다. 일반적으로 TCP, WebSocket, HTTP/2 등의 전송 방식과 함께 사용합니다. 클라이언트와 서버의 사용자 식별자, 전송 유형, 보안 설정은 서로 일치해야 합니다.
- VLESS
- 인증과 전송 계층 설정을 분리한 경량 프로토콜입니다. VLESS 자체는 콘텐츠를 암호화하지 않으며, 실제 배포에서는 TLS나 REALITY 같은 보안 계층과 함께 사용하는 경우가 많습니다. 설정을 확인할 때 UUID, 흐름 제어, 전송 방식, 보안 계층 필드를 각각 점검해야 합니다.
- Trojan
- 비밀번호로 인증하고 일반적으로 TLS 연결 위에서 동작하는 프록시 프로토콜입니다. 클라이언트 설정에서는 서버 주소, 포트, 비밀번호, 전송 보안, 도메인 정보를 함께 확인해야 합니다. TLS 핸드셰이크 실패와 비밀번호 오류는 로그에서 서로 다른 단계의 문제로 나타납니다.
- REALITY
- Xray가 제공하는 전송 보안 구현으로, VLESS와 함께 사용하는 경우가 많습니다. 설정에는 공개 키, 짧은 ID, 서버 이름, 흐름 제어 등의 필드가 포함되며 클라이언트와 서버의 값이 일치해야 합니다. 이는 연결 보안 계층이므로 VLESS 프로토콜 자체와 같은 개념으로 보면 안 됩니다.
- TLS
- 암호화된 연결을 만들고 통신 상대를 검증하는 범용 보안 프로토콜입니다. V2Ray 설정에서는 인증서 도메인, 서버 이름, 시스템 시간, 인증서 체인이 핸드셰이크 결과에 영향을 줍니다. 인증서 오류가 발생하면 먼저 도메인과 시간을 확인한 뒤 클라이언트 로그의 핸드셰이크 정보를 살펴보세요.
- UUID
- 16진수 문자와 하이픈으로 구성된 범용 고유 식별자입니다. VMess와 VLESS 설정에서는 UUID로 사용자를 식별하는 경우가 많으며, 형식이 잘못되었거나 양쪽 값이 다르면 인증에 실패합니다. UUID는 서버 주소가 아니며 비밀번호, 포트, 전송 매개변수를 대신할 수도 없습니다.
CORE & ECOSYSTEM
코어·생태계
그래픽 클라이언트와 코어는 서로 다른 소프트웨어 계층입니다. 클라이언트는 화면과 설정 관리를 담당하고, 코어는 프로토콜, DNS, 라우팅, 연결 처리를 담당합니다.
- Project V
- 네트워크 프록시 프로토콜, 라우팅 기능, 확장 가능한 전송 구성 요소를 중심으로 형성된 오픈 소스 기술 생태계입니다. V2Ray, V2Fly 및 관련 클라이언트 문서의 여러 개념이 이 체계에서 비롯되었습니다. 특정 그래픽 클라이언트의 이름이 아니라 프로젝트와 기술 계보를 가리킵니다.
- V2Fly
- V2Ray의 기술 노선을 이어가는 커뮤니티 유지 프로젝트이자 코어 제품군입니다. 프로토콜 처리, 인바운드·아웃바운드, DNS, 라우팅 등의 기반 기능을 제공하며 그래픽 클라이언트에서 호출할 수 있습니다. 설정 호환 범위는 사용 중인 클라이언트에 포함된 구체적인 코어 버전을 기준으로 확인해야 합니다.
- Xray
- V2Ray 설정 체계와 밀접한 관련이 있는 오픈 소스 코어 제품군입니다. Xray는 VLESS, REALITY, 라우팅 및 다양한 전송 조합을 지원하며, 실제 사용 가능한 필드는 코어와 클라이언트 버전에 따라 달라집니다. “Xray 코어”는 연결 설정을 실행하는 핵심 프로그램을 뜻하며 구독 서비스를 의미하지 않습니다.
- v2rayN
- Windows, macOS, Linux용 그래픽 클라이언트입니다. 구독 관리, 서버 목록, 시스템 프록시, 라우팅 규칙, 코어 실행 등 데스크톱 환경의 작업을 담당합니다. 연결 문제가 발생하면 화면 설정, 생성된 설정, 하위 코어 오류를 구분해야 합니다.
- v2rayNG
- Android용 그래픽 클라이언트로, 일반적으로 Xray 코어를 사용해 연결을 처리합니다. 주요 기능으로 구독 업데이트, 노드 전환, 라우팅 모드, 앱별 프록시, 연결 로그 등이 있습니다. 모바일 네트워크와 무선 네트워크를 전환한 뒤에는 시스템 라우팅 변화가 현재 연결에 영향을 줄 수도 있습니다.
- v2flyNG
- Android용 그래픽 클라이언트로 V2Fly 코어 노선을 사용합니다. 구독과 단일 노드 설정을 가져올 수 있어 V2Fly 코어 호환성이 필요한 환경에 적합합니다. v2rayNG와 비교할 때는 코어 제품군, 설정 호환 범위, 클라이언트 기능 차이를 중점적으로 확인해야 합니다.
SUBSCRIPTION & NODE
구독·노드
구독은 설정을 배포하고, 노드는 선택 가능한 연결 기록이며, 속도 측정은 서로 다른 계층의 회선 성능을 확인하는 수단입니다.
- 구독 링크
- 서버에서 제공하며 노드 설정을 일괄적으로 가져오는 주소입니다. 클라이언트가 구독을 업데이트할 때 이 주소에 요청을 보내 내용을 해석합니다. 주소 만료, 인증 매개변수 오류, 네트워크 문제로 업데이트가 실패할 수 있습니다. 구독을 성공적으로 가져왔다는 것은 클라이언트가 설정을 읽었다는 뜻일 뿐, 모든 노드가 연결된다는 의미는 아닙니다.
- 노드
- 클라이언트에서 선택할 수 있는 서버 연결 설정입니다. 일반적으로 주소, 포트, 프로토콜, 인증 정보, 전송 방식, 보안 계층 등의 매개변수를 포함합니다. 노드 이름은 식별을 위한 값일 뿐이며 실제 연결 결과는 내부 필드가 결정합니다.
- 구독 그룹
- 서로 다른 구독 출처를 구분하고 노드 모음을 관리하기 위한 클라이언트의 구성 방식입니다. 업데이트, 정리, 자동 선택 작업은 대개 그룹 단위로 수행되므로 문제를 확인할 때 먼저 현재 그룹을 확인해야 합니다. 그룹을 삭제하면 해당 출처의 노드 기록이 함께 제거될 수 있으므로 작업 전에 로컬 노드와 구독 노드를 구분해야 합니다.
- 지연 시간
- 데이터가 로컬에서 목적지까지 갔다가 돌아오는 데 걸리는 시간으로, 보통 밀리초 단위로 표시합니다. 테스트 방식마다 측정하는 네트워크 구간이 다르므로 단일 지연 시간 수치만으로 실제 전송 속도를 판단할 수 없습니다. 지연 시간은 로컬 네트워크, 회선 혼잡, 테스트 대상에 따라서도 달라집니다.
- 실제 연결 지연 시간
- 프록시 노드를 통해 실제 프로토콜 연결이나 대상 요청을 완료한 뒤 측정한 소요 시간입니다. 일반적인 네트워크 계층 탐색보다 더 많은 핸드셰이크 단계를 포함하므로 노드가 실제 연결을 수립할 수 있는지 판단하는 데 적합합니다. 테스트가 시간 초과되면 로그를 통해 DNS 조회, 전송 연결, 프로토콜 인증, 보안 핸드셰이크 중 어느 단계에서 실패했는지 확인해야 합니다.
- 다운로드 속도 측정
- 일정한 크기의 데이터를 전송해 처리량을 확인하는 테스트 방식입니다. 결과는 노드의 출구, 대상 서버, 회선 혼잡, 로컬 네트워크, 측정 시간대의 영향을 함께 받습니다. 속도 측정은 실제 트래픽을 발생시키며, 한 번의 결과만으로 장기적인 안정성을 판단할 수도 없습니다.
ROUTING & SPLIT
라우팅·트래픽 분기
라우팅 규칙이 먼저 트래픽 특성을 식별한 다음 요청을 지정된 아웃바운드로 전달합니다. 도메인 규칙, IP 규칙, 아웃바운드 태그를 하나의 연결된 흐름으로 점검해야 합니다.
- 라우팅 규칙
- 도메인, IP, 포트, 프로토콜 또는 출처에 따라 트래픽을 매칭하고 아웃바운드를 지정하는 규칙 모음입니다. 규칙 순서와 아웃바운드 태그가 일치해야 하며, 그렇지 않으면 매칭 결과가 예상과 달라질 수 있습니다. 문제를 확인할 때는 먼저 요청이 실제로 매칭된 규칙을 찾은 뒤 해당 규칙이 가리키는 아웃바운드를 점검해야 합니다.
- 트래픽 분기
- 라우팅 조건에 따라 요청을 직접 연결, 프록시, 차단 등 서로 다른 아웃바운드로 보내는 처리 방식입니다. 분기가 올바른지는 접속 결과, 클라이언트 로그, DNS 조회 경로를 함께 확인해야 합니다. 시스템 프록시 모드만 바꾼다고 코어 내부의 라우팅 규칙이 자동으로 수정되지는 않습니다.
- GeoIP
- IP 주소가 속한 지역이나 네트워크 범위별로 구성한 규칙 데이터입니다. 라우팅 엔진은 도메인을 조회해 얻은 IP를 GeoIP로 매칭할 수 있지만, 데이터 버전과 업데이트 주기에 따라 적용 범위가 달라집니다. 주소 범위를 다루는 기능이므로 도메인 분류 규칙을 직접 대신할 수는 없습니다.
- GeoSite
- 용도나 지역별로 정리한 도메인 목록 규칙 데이터입니다. GeoSite는 도메인 계층을 매칭하며 GeoIP와는 다릅니다. 두 기능을 함께 사용해 도메인과 주소 조건을 모두 다루는 경우가 많습니다. 규칙 이름을 사용할 수 있는지는 클라이언트가 로드한 데이터 파일에 따라 달라집니다.
- 아웃바운드 태그
- 설정에서 특정 아웃바운드 처리기를 식별하는 이름입니다. 라우팅 규칙은 태그를 통해 직접 연결, 프록시, 차단 아웃바운드를 참조하므로 태그 표기가 다르면 규칙이 예상대로 전달되지 않습니다. 로그를 확인할 때도 아웃바운드 태그로 요청의 최종 경로를 확인하는 경우가 많습니다.
- 규칙 우선순위
- 여러 라우팅 조건이 동시에 일치할 수 있을 때 적용하는 판단 순서입니다. 대부분의 설정은 규칙을 나열된 순서대로 확인하므로 더 구체적인 조건을 더 넓은 조건보다 앞에 두는 것이 일반적입니다. 순서를 바꾼 뒤에는 설정을 다시 로드하고 명확한 테스트 도메인으로 결과를 확인해야 합니다.
CLIENT FEATURES
클라이언트 기능
시스템 프록시, 가상 네트워크 인터페이스, DNS 처리 방식에 따라 트래픽이 코어로 들어가는 경로가 결정됩니다. 앱이 시스템 설정을 읽는지는 트래픽 가로채기 범위를 판단하는 핵심 기준입니다.
- 시스템 프록시
- 운영체제가 프록시 설정을 지원하는 앱에 제공하는 네트워크 매개변수입니다. 시스템 프록시를 켜도 모든 프로그램이 이를 사용하는 것은 아니며, 시스템 설정을 무시하는 앱은 별도 설정이나 다른 트래픽 가로채기 방식을 사용해야 합니다. 클라이언트를 종료하기 전 시스템 프록시를 복원하면 더 이상 수신 대기하지 않는 로컬 포트가 남는 문제를 피할 수 있습니다.
- TUN 모드
- 가상 네트워크 인터페이스로 시스템 트래픽을 받은 뒤 클라이언트 코어가 처리하는 동작 모드입니다. 시스템 프록시를 읽지 않는 프로그램까지 더 넓게 적용할 수 있지만 권한, 라우팅 테이블, DNS 설정을 올바르게 처리해야 합니다. 활성화한 뒤 로컬 네트워크에 문제가 생기면 가상 인터페이스, 라우팅 충돌, 다른 네트워크 도구의 사용 여부를 확인해야 합니다.
- FakeDNS
- 앱에 예약 주소를 반환하고 이후 연결 단계에서 원래 도메인 매핑을 복원하는 DNS 처리 방식입니다. 라우팅 매칭에 사용할 도메인 정보를 보존하는 데 도움이 되지만 주소 풀, 캐시, 폴백 설정이 서로 맞아야 합니다. 모드를 끄거나 전환한 뒤에는 이전 캐시가 잠시 테스트 결과에 영향을 줄 수 있습니다.
- DNS 누출
- 도메인 조회가 예상한 해석 경로를 따르지 않고 다른 DNS 해석기로 전달되는 현상입니다. 문제를 확인할 때 시스템 DNS, 클라이언트 DNS, 라우팅 규칙, 브라우저 자체의 DNS 설정을 함께 점검해야 합니다. 테스트 결과는 현재 트래픽 가로채기 모드와 함께 판단해야 하며, 설정과 분리해 단정해서는 안 됩니다.
- 인바운드 포트
- 클라이언트가 로컬 컴퓨터에서 수신 대기하며 앱의 프록시 요청을 받는 포트입니다. SOCKS와 HTTP 인바운드는 서로 다른 포트를 사용할 수 있으며, 앱에 잘못 입력했거나 포트가 이미 사용 중이면 연결에 실패합니다. 앱을 수동으로 설정할 때는 주소가 원격 노드가 아니라 일반적으로 로컬 컴퓨터를 가리키는지도 확인해야 합니다.
- 클라이언트 로그
- 코어 시작, 설정 로드, DNS 조회, 라우팅 매칭, 연결 오류를 기록하는 텍스트 출력입니다. 장애를 확인할 때는 오류가 발생한 시각 전후의 기록을 살펴보고 클라이언트 화면 로그와 코어 로그를 구분해야 합니다. 로그를 공유하기 전 구독 주소, 인증 필드, 전체 노드 설정이 포함되어 있는지 확인해야 합니다.