CONFIGURATION DICTIONARY

V2Ray 용어집

프로토콜 이름부터 로컬 리스닝 포트까지, 실제 설정 과정에서 마주치는 맥락에 맞춰 개념을 설명합니다. 먼저 용어가 어느 계층에 속하는지 확인한 뒤 클라이언트 메뉴, 코어 로그와 튜토리얼을 읽어 보세요.

05 기술 범주

34 핵심 용어

A–Z 영문명 색인

빠른 색인 D F G R T V W X 구독 라우팅 시스템 프록시

01 / PROTOCOL

프로토콜 및 전송

프로토콜은 인증과 데이터 교환 방식을 정의하고, 전송 계층은 연결을 전달하는 방식을 결정합니다. 설정을 가져올 때는 프로토콜 이름만 보지 말고 보안 계층, 전송 방식, 경로와 서비스 이름도 함께 확인해야 합니다.

VMess: Project V 생태계에서 비교적 초기부터 사용된 프로토콜입니다. 설정에는 일반적으로 사용자 식별자, 서버 주소, 포트, 전송 방식 및 보안 매개변수가 포함되며, 핵심 필드 하나라도 일치하지 않으면 핸드셰이크가 완료되지 않을 수 있습니다. 기존 설정에서 자주 보이며, 마이그레이션할 때는 주소와 포트만 복사하지 말고 서버가 제공한 전체 매개변수를 가져와야 합니다.
VLESS: 인증 메커니즘과 전송 보안 계층을 분리한 경량 프로토콜입니다. VLESS 설정의 핵심은 사용자 식별자, 흐름 제어와 하위 전송이며, 실제로는 TLS 또는 REALITY와 함께 사용하는 경우가 많습니다. 설정을 읽을 때 프로토콜, 전송, 보안 필드를 각각 확인해 세 계층의 매개변수를 혼동하지 않도록 해야 합니다.
Trojan: 비밀번호 인증을 사용하고 일반적으로 TLS와 함께 구성하는 프록시 프로토콜입니다. 클라이언트는 서버 주소, 포트, 비밀번호, 서버 이름 및 인증서 관련 설정을 서버와 맞춰야 합니다. 연결이 핸드셰이크 단계에서 종료되면 인증 정보뿐 아니라 시스템 시간, 도메인 입력 및 보안 계층 옵션도 확인해야 합니다.
REALITY: Xray 생태계의 전송 보안 방식으로, VLESS와 함께 사용하는 경우가 많습니다. 일반적인 설정에는 공개 키, 짧은 식별자, 서버 이름, 지문 및 흐름 제어 등의 필드가 나타나며, 서로 독립적인 값이므로 상호 대체할 수 없습니다. 가져온 뒤 클라이언트에 매개변수가 부족하게 표시되면 노드를 계속 바꾸기보다 원본 설정으로 돌아가 항목별로 대조해야 합니다.
TLS: 네트워크 연결에 암호화와 인증을 제공하는 보안 계층입니다. 인증서 이름, 서버 이름, 시스템 시간 및 인증서 신뢰 상태가 TLS 핸드셰이크에 영향을 줍니다. 클라이언트의 ‘인증서 검증 건너뛰기’는 별도 옵션이며, 모든 연결 문제를 해결하는 만능 스위치로 사용해서는 안 됩니다.
WebSocket: HTTP 업그레이드 방식으로 양방향 연결을 구성하는 전송 방식이며, 설정에서는 보통 WS로 줄여 씁니다. 일반적인 매개변수로 경로, 요청 헤더와 호스트 이름이 있으며 서버 진입점과 일치해야 합니다. WebSocket은 전달 방식이지 VMess, VLESS 같은 상위 프로토콜과 같은 개념이 아닙니다.
gRPC: HTTP/2 기반 원격 호출 프레임워크로, 연결의 전송 방식으로도 사용할 수 있습니다. 관련 설정에는 일반적으로 서비스 이름이 포함되며 TLS 같은 보안 계층과 함께 지정됩니다. 서비스 이름은 경로와 비슷해 보이지만 서로 다른 필드이므로, 다른 전송 방식에서 옮길 때 경로 값을 그대로 복사하지 마세요.

02 / CORE

코어 및 클라이언트

클라이언트는 그래픽 인터페이스, 구독 관리와 시스템 통합을 담당하고 코어는 연결 구성과 규칙 실행을 담당합니다. 둘을 구분하면 문제가 화면 설정, 설정 생성 또는 하위 연결 단계 중 어디에서 발생했는지 판단하기 쉽습니다.

V2Ray: Project V 생태계의 네트워크 프록시 기술 및 설정 체계로, 관련 프로토콜, 코어와 클라이언트 도구를 통칭할 때 사용합니다. 실제로 문제를 점검할 때는 ‘V2Ray’라는 포괄적인 이름만으로 부족하므로 어떤 클라이언트, 코어 계열과 프로토콜을 사용하는지 확인해야 합니다. 구현마다 메뉴 이름은 다를 수 있지만 설정 계층의 구조는 비슷합니다.
V2Fly: Project V의 기술 방향을 이어가는 커뮤니티 유지보수 코어 제품군으로, 독립적인 버전과 설정 구현을 갖습니다. V2Fly와 Xray는 일부 개념을 공유하지만 프로토콜 지원, 필드 세부 사항과 업데이트 주기는 완전히 같지 않습니다. 클라이언트를 선택할 때는 애플리케이션 이름만 보고 판단하지 말고 실제로 호출하는 코어를 확인해야 합니다.
Xray: V2Ray 설정 체계와 밀접한 코어 제품군으로, VLESS, REALITY 등의 프로토콜과 전송 기능을 지원합니다. Xray는 보통 그래픽 클라이언트가 백그라운드 프로세스로 실행하며, 로그에 설정 해석, 리스닝 포트와 연결 오류를 기록합니다. 고급 매개변수를 수정하기 전에 현재 클라이언트가 이 코어를 사용하는지, 해당 버전이 필드를 지원하는지 먼저 확인하세요.
v2rayN: Windows, macOS 및 Linux용 데스크톱 그래픽 클라이언트입니다. 구독 업데이트, 서버 목록, 라우팅 설정, 시스템 프록시와 코어 관리를 담당하며 화면 옵션을 코어가 읽을 수 있는 설정으로 변환합니다. 데스크톱 버전과 클래식 인터페이스는 메뉴 위치가 다를 수 있으므로 튜토리얼을 읽기 전에 사용 중인 인터페이스 유형을 확인해야 합니다.
v2rayNG: Android용 그래픽 클라이언트로, 일반적으로 Xray 코어를 사용해 연결과 라우팅을 처리합니다. 구독 또는 단일 공유 링크를 가져올 수 있고, 시스템 VPN 인터페이스를 통해 선택한 트래픽을 전달합니다. 백그라운드 제한, 배터리 정책 및 시스템 네트워크 전환이 지속적인 연결에 영향을 줄 수 있으므로 프로토콜 설정과 나누어 점검해야 합니다.
v2flyNG: Android용 V2Fly 코어 클라이언트로, V2Fly 기술 계열이 필요한 설정에 사용할 수 있습니다. 인터페이스 조작은 일반적인 모바일 클라이언트와 비슷하지만 하위 지원 범위는 V2Fly 코어에 따라 달라집니다. 설정을 가져오기 전에 프로토콜과 전송 필드가 해당 코어의 지원 범위에 속하는지 확인해야 합니다.
코어: 설정을 읽고 로컬 리스닝을 열며 원격 연결을 구성하고 프로토콜을 처리한 뒤 라우팅 규칙을 실행하는 백그라운드 프로그램입니다. 그래픽 클라이언트에 ‘실행 중’으로 표시되어도 일반적으로 코어 프로세스가 실행 중이라는 뜻일 뿐, 모든 서버 설정에 연결된다는 의미는 아닙니다. 시작 실패는 먼저 로컬 로그를 확인하고, 특정 노드 문제는 해당 연결에 해당하는 오류 행을 확인해야 합니다.

03 / SUBSCRIPTION

구독 및 노드

구독은 설정 출처이고 노드는 클라이언트에 저장된 개별 서버 기록이며, 테스트 결과는 특정 조건에서 측정한 값입니다. 이 세 가지 개념을 구분하면 ‘업데이트는 성공했지만 연결할 수 없음’과 같은 오판을 줄일 수 있습니다.

구독: 서버에서 제공하는 설정 모음 주소입니다. 클라이언트가 요청하고 해석한 뒤 서버 항목을 로컬 목록에 저장합니다. 구독 주소를 추가하는 것은 출처를 등록하는 단계일 뿐이며, 일반적으로 한 번 업데이트를 실행해야 합니다. 업데이트에 실패하면 주소에 접근할 수 없는 경우, 반환 내용이 비정상인 경우, 클라이언트 해석에 실패한 경우를 구분해야 합니다.
노드: 클라이언트 서버 목록에 있는 개별 설정 기록으로, 주소, 포트, 프로토콜, 인증 및 전송 매개변수를 포함합니다. 노드 이름은 식별을 위한 것이며 실제 연결 대상을 결정하지 않습니다. 표시 이름이 다른 두 기록이 같은 서버 매개변수를 사용할 수도 있고, 보안 계층이나 전송 방식이 달라 연결 결과가 완전히 다를 수도 있습니다.
구독 그룹: 여러 구독 출처를 구분하기 위한 관리 단위입니다. 그룹을 사용하면 서버를 각각 업데이트·비활성화·필터링할 수 있어 모든 항목이 하나의 긴 목록에 섞이는 것을 막을 수 있습니다. 그룹 이름을 바꿔도 원격 구독 내용은 일반적으로 변경되지 않지만, 그룹을 삭제하기 전에 클라이언트가 포함된 로컬 기록을 어떻게 처리하는지 확인해야 합니다.
공유 링크: 개별 서버 설정을 특정 URI 형식으로 인코딩한 텍스트로, 호환 클라이언트가 주요 매개변수를 복원하는 데 사용할 수 있습니다. 공유 링크는 단일 기록을 가져오는 데 적합하고, 구독 주소는 여러 설정을 지속적으로 가져오는 데 사용되므로 용도가 다릅니다. 해석에 실패하면 링크 형식, 인코딩 내용 또는 클라이언트 지원 범위가 서로 맞지 않을 수 있습니다.
지연 시간: 로컬 장치와 대상 사이에서 데이터가 한 번 왕복하는 데 걸리는 시간으로, 보통 밀리초로 표시합니다. 테스트에 따라 네트워크 연결 가능성만 확인할 수도 있고 핸드셰이크와 대상 접속까지 포함할 수도 있으므로 결과를 직접 비교해서는 안 됩니다. 탐색 시간이 짧다고 해서 이후 연결이 반드시 안정적인 것은 아닙니다.
실제 연결 지연 시간: 프로토콜 연결을 실제로 구성하고 테스트 대상에 접속해 측정한 시간입니다. 단순한 네트워크 탐색보다 더 많은 단계를 포함해 클라이언트의 업무 연결 구성 과정에 가깝지만, 여전히 특정 테스트 조건에서 얻은 결과일 뿐입니다. 테스트 대상, DNS, 현재 네트워크와 서버 부하가 바뀌면 수치도 달라집니다.

04 / ROUTING

라우팅 및 트래픽 분류

라우팅 시스템은 연결의 도메인, 주소, 포트 또는 프로세스 정보를 읽은 뒤 해당 아웃바운드를 선택합니다. 규칙의 유효성은 내용뿐 아니라 배열 순서와 코어가 원래 대상 정보를 얻을 수 있는지에도 좌우됩니다.

라우팅 규칙: 도메인, 주소, 포트, 네트워크 유형, 프로토콜 또는 프로세스 등의 조건에 따라 트래픽이 사용할 아웃바운드를 결정하는 설정 모음입니다. 규칙은 경로를 선택할 뿐 서버 매개변수를 수정하지 않습니다. 규칙을 작성하기 전에 대상, 매칭 조건과 원하는 아웃바운드를 확인해 지나치게 넓은 조건이 뒤의 세부 규칙을 덮지 않도록 해야 합니다.
트래픽 분류: 서로 다른 대상이나 애플리케이션의 연결을 프록시, 직접 연결 또는 차단 등의 아웃바운드 방식으로 배정하는 처리 과정입니다. 내장 규칙 집합을 사용할 수도 있고 사용자가 조건을 명시해 작성할 수도 있습니다. 접속 경로가 예상과 다르면 먼저 어떤 규칙이 일치했는지 확인한 뒤 해당 규칙이 가리키는 아웃바운드를 점검해야 합니다.
GeoIP: 주소 대역별로 네트워크 주소를 분류한 데이터 집합으로, 라우팅 규칙의 일괄 매칭 조건으로 사용할 수 있습니다. GeoIP는 해석 후 또는 연결 대상의 주소를 매칭하며 도메인 분류와는 다릅니다. 데이터 파일에는 업데이트 시점이 있으므로 주소 할당이 바뀌면 오래된 데이터가 현재 네트워크 상황과 완전히 일치하지 않을 수 있습니다.
GeoSite: 용도, 조직 또는 범주별로 도메인을 정리한 데이터 집합으로, 코어에서 하나의 범주 이름으로 많은 도메인을 매칭할 수 있습니다. GeoSite는 도메인 기준으로 처리하고 GeoIP는 주소 기준으로 처리하며, 라우팅 규칙에 함께 등장하는 경우가 많습니다. 범주 집합은 실시간 온라인 목록이 아니므로 실제 해석 과정과 함께 결과를 판단해야 합니다.
아웃바운드: 코어가 인바운드 연결을 처리한 뒤 선택하는 출구입니다. 일반적인 아웃바운드에는 지정 서버를 통한 프록시 연결, 대상에 대한 직접 연결, 연결 차단 처리가 있습니다. 라우팅 규칙은 최종적으로 특정 아웃바운드 태그를 가리키는 경우가 많으므로 태그 표기와 설정 참조가 일치해야 합니다.
규칙 우선순위: 여러 라우팅 규칙이 같은 연결에 일치할 때 적용하는 판단 순서입니다. 많은 설정은 규칙을 앞에서 뒤로 나열 순서대로 처리하므로, 먼저 일치한 포괄적인 규칙이 뒤의 세부 규칙에 기회를 주지 않을 수 있습니다. 순서를 바꾸기 전에 원래 설정을 기록하고 명확한 대상별로 하나씩 검증해야 합니다.

05 / NETWORK

네트워크 기초

클라이언트는 먼저 로컬 장치에서 애플리케이션 트래픽을 받은 다음 연결을 코어에 넘겨 처리합니다. 시스템 프록시, TUN, DNS와 리스닝 포트는 서로 다른 단계에 있으므로 ‘애플리케이션—로컬 진입점—라우팅—원격 연결’ 순서로 점검해야 합니다.

시스템 프록시: 운영체제가 애플리케이션에 제공하는 프록시 설정 모음입니다. 브라우저처럼 시스템 설정을 따르는 프로그램은 클라이언트가 연 로컬 포트에 자동으로 연결하지만, 일부 터미널 도구·게임 또는 자체 네트워크 스택을 사용하는 프로그램은 별도 설정을 사용할 수 있습니다. 시스템 프록시가 켜졌다는 것은 진입점이 등록되었다는 뜻일 뿐이며, 클라이언트 코어와 서버 연결 상태도 확인해야 합니다.
TUN 모드: 가상 네트워크 인터페이스를 통해 시스템 트래픽을 수신하는 방식으로, 시스템 프록시 설정을 읽지 않는 프로그램에도 적용할 수 있습니다. TUN 모드는 라우팅 테이블, DNS와 애플리케이션 호환성을 함께 처리해야 하므로 일반 시스템 프록시보다 더 많은 시스템 계층 설정이 필요합니다. 일부 애플리케이션에 문제가 생기면 먼저 우회 규칙과 DNS 설정을 확인하세요.
FakeDNS: 도메인에 임시 예약 주소를 할당하고 코어에서 도메인과 해당 주소의 매핑을 관리하는 방식입니다. TUN 환경에서 주소 연결을 수신하더라도 코어가 원래 도메인을 식별해 도메인 규칙을 적용할 수 있도록 하는 데 사용됩니다. FakeDNS는 공용 리졸버가 아니며, 매핑을 동일한 트래픽 처리 경로가 올바르게 인계받아야 합니다.
DNS: 도메인을 네트워크 주소로 변환하는 기본 서비스입니다. V2Ray 클라이언트 설정에는 운영체제 리졸버, 코어 내장 DNS 설정 및 원격 해석 정책이 함께 관련될 수 있습니다. 도메인은 열리지 않지만 주소로는 연결되는 문제를 점검할 때 조회 성공 여부, 반환된 주소와 이후 라우팅 처리를 각각 확인해야 합니다.
DNS 누수: 업무 연결은 예상 경로를 거치지만 도메인 조회는 다른 리졸버가 처리하는 현상입니다. 시스템 해석 설정, 브라우저의 보안 DNS, TUN 적용 범위 또는 코어 DNS 라우팅과 관련되는 경우가 많습니다. 최종 연결 주소만 보지 말고 조회 요청을 실제로 어느 계층이 보내고 처리했는지 확인해야 합니다.
로컬 리스닝 포트: 클라이언트가 로컬 장치에서 열어 애플리케이션의 연결을 기다리는 포트로, SOCKS 또는 HTTP 진입 포트가 이에 해당합니다. 일반적으로 하나의 주소에서 같은 포트를 두 프로세스가 동시에 사용할 수 없으며, 충돌하면 코어가 시작 직후 종료될 수 있습니다. 포트를 변경한 뒤에는 시스템 프록시나 애플리케이션의 해당 설정도 함께 업데이트해야 합니다.
SOCKS 프록시: 애플리케이션 연결 계층에서 동작하는 범용 프록시 인터페이스로, 다양한 상위 프로토콜을 전달할 수 있습니다. 애플리케이션은 대상 주소나 도메인을 SOCKS 진입점에 넘기고 클라이언트 코어가 연결과 라우팅을 처리하게 합니다. 도메인을 사용할 때는 애플리케이션이 로컬에서 먼저 해석하는지, 도메인을 프록시 측에 넘기는지도 확인해야 합니다.
HTTP 프록시: HTTP 요청과 HTTPS CONNECT 터널을 위한 로컬 프록시 인터페이스로, 브라우저와 개발 도구에서 자주 사용합니다. SOCKS 프록시와 프로토콜 형식이 다르므로 확인 없이 포트를 서로 바꿔 입력하면 안 됩니다. 터미널 프로그램이 시스템 프록시를 읽지 않는다면 해당 프로그램의 설정에서 프록시 주소를 직접 지정해야 합니다.