설정 용어 색인

V2Ray 용어 가이드

실제 설정 상황을 기준으로 프로토콜, 코어, 구독, 라우팅과 네트워크 용어를 설명합니다. VLESS, GeoSite, TUN, FakeDNS 같은 설정 항목은 분류 메뉴에서 빠르게 찾을 수 있습니다.

읽는 순서

먼저 용어가 속한 계층을 확인하세요

노드에 연결할 수 없을 때 프로토콜 매개변수, 프록시 코어, 라우팅 규칙과 시스템 네트워크 설정은 서로 다른 계층에 해당합니다. 먼저 문제가 발생한 계층을 판단한 다음 관련 필드를 확인하면 관계없는 옵션을 반복해서 수정하는 일을 줄일 수 있습니다.

프로토콜과 전송

연결 프로토콜과 보안 매개변수

프로토콜은 클라이언트와 서버가 인증하고 데이터를 교환하는 방식을 결정합니다. 설정을 가져올 때는 프로토콜, 전송 방식과 보안 계층의 전체 조합을 유지해야 하며 서버 주소와 포트만 복사해서는 안 됩니다.

V

VMess

Project V 생태계에서 비교적 이른 시기에 사용된 프록시 프로토콜입니다. 노드 설정에는 보통 사용자 식별자, 서버 주소, 포트, 보안 옵션과 전송 방식이 포함됩니다.

v2rayN에서 VMess 노드를 편집할 때 alterId 같은 호환성 필드가 보일 수 있습니다. 입력 필요 여부는 서버 설정에 따라 다르므로 다른 노드의 매개변수를 그대로 적용해서는 안 됩니다.

V

VLESS

간소화된 인증 구조를 사용하는 프록시 프로토콜로, 자체적으로 추가 데이터 암호화를 담당하지는 않습니다. 실제 설정에서는 TLS, REALITY, TCP, WebSocket 또는 gRPC 같은 전송 및 보안 계층과 함께 구성됩니다.

VLESS 연결을 점검할 때는 사용자 식별자, 흐름 제어, 서버 이름, 전송 유형과 보안 옵션을 함께 확인해야 합니다. 프로토콜 이름만 일치하는지 확인하는 것만으로는 연결을 수립하기에 부족합니다.

T

Trojan

TLS 채널을 기반으로 동작하는 프록시 프로토콜입니다. 클라이언트 설정에는 보통 서버 주소, 포트, 인증 정보, 서버 이름과 인증서 관련 옵션이 필요합니다.

주소에는 접속되지만 프로토콜 연결에 실패한다면 서버 이름이 올바른지, 로컬 시간과 TLS 설정 및 전송 방식이 서버와 일치하는지 확인해야 합니다.

R

REALITY

Xray 생태계의 전송 보안 방식으로, VLESS, TCP와 REALITY를 함께 사용하는 구성이 일반적입니다. 클라이언트에는 보통 공개 키, 짧은 식별자, 서버 이름과 지문 등의 매개변수가 필요합니다.

이 필드들은 하나의 핸드셰이크 설정을 구성하므로 핵심 값 하나라도 일치하지 않으면 연결이 끊길 수 있습니다. 공유 링크나 구독에는 일반적으로 필요한 매개변수가 함께 포함됩니다.

코어와 생태계

Project V, V2Fly와 Xray

그래픽 클라이언트는 구독 관리, 인터페이스 조작과 시스템 설정을 담당하고, 프록시 코어는 프로토콜 연결, 라우팅과 DNS를 담당합니다. 클라이언트와 코어를 구분하면 변경 로그에서 기능의 소속을 이해하기 쉽습니다.

P

Project V

네트워크 프록시 프로토콜, 핵심 프로그램과 설정 도구를 중심으로 형성된 오픈 소스 기술 생태계입니다. VMess, 라우팅 규칙과 다중 아웃바운드 설정 등의 개념은 이 생태계의 발전 과정에서 해당 출처를 확인할 수 있습니다.

Project V는 특정 그래픽 클라이언트의 이름이 아닙니다. v2rayN, v2rayNG 같은 클라이언트는 관련 코어 기능 위에 조작 인터페이스를 제공하는 독립 프로젝트입니다.

V

V2Fly

Project V의 기술 노선을 이어 가는 커뮤니티 프로젝트 및 코어 제품군입니다. 프로토콜 처리, 라우팅, DNS와 인바운드·아웃바운드 등의 기반 기능을 제공합니다.

v2flyNG는 관련 코어를 사용해 Android 기기의 연결을 처리합니다. 클라이언트 이름, 코어 이름과 노드 프로토콜은 서로 다른 개념이므로 설정을 읽을 때 각각 구분해야 합니다.

X

Xray

V2Ray 설정 체계와 밀접한 코어 생태계로, VLESS, VMess, Trojan, REALITY, 라우팅과 DNS 등의 기능을 지원합니다. v2rayN과 v2rayNG는 Xray 코어를 사용해 연결 설정을 실행할 수 있습니다.

클라이언트 업그레이드와 코어 업그레이드는 항상 같은 작업이 아닙니다. 새 프로토콜 매개변수를 인식하지 못한다면 클라이언트와 코어의 지원 여부를 함께 확인해야 합니다.

C

프록시 코어

프로토콜 핸드셰이크, 연결 전달, DNS 조회와 라우팅 매칭을 담당하는 저수준 프로그램입니다. 그래픽 클라이언트가 설정을 생성하고 코어를 실행한 뒤 로그와 실행 상태를 읽습니다.

코어 실행에 실패해도 클라이언트 인터페이스는 정상적으로 열릴 수 있습니다. 이때는 구독을 반복해서 가져오기보다 로그의 설정 해석, 포트 사용 중 여부와 권한 관련 안내를 먼저 확인해야 합니다.

구독과 노드

설정 출처, 그룹과 지연 시간

구독은 설정을 일괄 제공하고, 노드는 선택 가능한 연결 기록이며, 그룹은 출처를 관리합니다. 업데이트, 필터링과 지연 시간 테스트는 서로 다른 단계에서 이루어집니다.

S

구독

서버에서 제공하는 설정 모음 주소입니다. 클라이언트가 구독을 업데이트하면 내용을 다운로드하고 노드를 해석해 해당 그룹에 저장합니다.

구독 주소가 정상적으로 열려도 클라이언트가 반드시 노드를 해석할 수 있는 것은 아닙니다. 업데이트 결과가 비어 있다면 링크가 완전한지, 지원되는 형식인지, 그룹 필터가 모든 기록을 숨기고 있지는 않은지 확인해야 합니다.

N

노드

클라이언트에 등록된 서버 연결 설정 하나입니다. 보통 주소, 포트, 프로토콜, 인증 매개변수, 전송 방식과 보안 설정이 포함됩니다.

노드 이름은 주로 식별을 위한 것이며 연결 품질을 결정하지 않습니다. 노드를 선택할 때는 실제 연결 지연 시간, 프로토콜 호환성, 대상 지역과 실제 접속 성능을 함께 판단해야 합니다.

G

구독 그룹

여러 구독 출처와 노드 모음을 나누어 관리하는 컨테이너입니다. 각 그룹에는 독립적인 구독 주소, 업데이트 방식, 필터 조건과 현재 선택된 노드를 설정할 수 있습니다.

업데이트에는 성공했지만 서버 목록이 바뀌지 않는다면 현재 확인 중인 그룹이 올바른지 확인해야 합니다. 키워드 필터나 정규식 필터가 새 노드를 제외하고 있지는 않은지도 살펴보세요.

L

실제 연결 지연 시간

실제 프로토콜 연결을 수립해 측정한 응답 시간으로, 기본적인 네트워크 도달성만 확인하는 테스트보다 일상적인 연결 과정에 가깝습니다. 로컬 네트워크, 프로토콜 핸드셰이크와 테스트 대상의 영향을 받습니다.

한 번의 측정값은 테스트 당시 상태만 보여 줍니다. 노드를 선택할 때는 여러 번 연속 테스트하고 웹 페이지 열기와 다운로드 과정의 안정성을 함께 판단할 수 있습니다.

라우팅과 트래픽 분기

규칙 매칭과 아웃바운드 방향

라우팅 규칙은 보통 위에서 아래로 검사하며, 일치하면 지정된 아웃바운드로 전달합니다. 규칙 순서, 매칭 범위와 최종 아웃바운드 이름을 함께 확인해야 합니다.

R

라우팅 규칙

도메인, IP, 포트, 프로토콜 또는 프로세스 등의 조건에 따라 트래픽의 아웃바운드 방향을 결정하는 매칭 규칙입니다. 일반적인 결과에는 direct, proxy와 block이 있습니다.

규칙은 일반적으로 목록 순서대로 실행됩니다. 범위가 넓은 규칙을 너무 앞에 배치하면 뒤의 세부 규칙이 적용되지 않을 수 있습니다. 수정 후에는 설정을 다시 불러오고 로그의 매칭 결과를 확인해야 합니다.

S

트래픽 분기

서로 다른 대상의 트래픽을 각기 다른 아웃바운드로 처리하는 설정 방식입니다. 예를 들어 로컬 네트워크에는 direct, 특정 도메인 집합에는 proxy, 명시적으로 차단할 대상에는 block을 사용할 수 있습니다.

트래픽 분기는 프로토콜 유형이 아니라 코어에서 이루어지는 트래픽 결정 과정입니다. 같은 노드라도 라우팅 모드에 따라 실제로 전달되는 트래픽 범위가 달라질 수 있습니다.

G

GeoIP

IP 주소의 지역 또는 미리 정의된 분류에 따라 매칭하는 데이터 집합입니다. 일반적인 규칙에는 geoip:cngeoip:private가 있습니다.

GeoIP 매칭은 대상 IP를 얻은 뒤 이루어지며, 결과는 데이터 파일과 DNS 해석 결과에 따라 달라집니다. 데이터가 오래되면 새로 할당된 일부 주소가 예상대로 분류되지 않을 수 있습니다.

G

GeoSite

도메인 분류별로 정리한 규칙 집합으로, 일반적인 표기에는 geosite:cngeosite:geolocation-!cn이 있습니다. 도메인 규칙을 하나씩 관리해야 하는 부담을 줄이는 데 사용됩니다.

GeoSite와 GeoIP는 매칭 대상이 다릅니다. 전자는 도메인을, 후자는 IP를 처리합니다. 복잡한 설정에서는 둘을 함께 사용할 수 있으며, 순서는 DNS 정책과 맞춰야 합니다.

클라이언트 기능

시스템 프록시, TUN과 구독 업데이트

이 옵션들은 클라이언트가 시스템 트래픽을 받는 방식과 설정을 갱신하는 시점을 결정합니다. 여러 트래픽 인계 방식을 활성화하기 전에 각 방식이 적용되는 애플리케이션 범위를 이해해야 합니다.

S

시스템 프록시

운영 체제가 애플리케이션에 제공하는 프록시 설정입니다. 활성화하면 시스템 프록시 방식을 지원하는 브라우저와 데스크톱 프로그램이 연결을 클라이언트의 로컬 리스닝 포트로 보냅니다.

일부 애플리케이션은 시스템 프록시를 무시하고 자체적으로 연결을 수립합니다. 이런 경우 애플리케이션 내부의 네트워크 옵션을 확인하거나 필요에 따라 TUN 모드 사용을 검토할 수 있습니다.

T

TUN 모드

가상 네트워크 인터페이스를 통해 시스템 트래픽을 인계받아 처리하는 실행 방식입니다. 시스템 프록시 설정을 읽지 않는 애플리케이션도 포함할 수 있으며 더 많은 TCP 및 UDP 트래픽을 통합 처리할 수 있습니다.

활성화하려면 보통 시스템 권한이 필요하며 다른 가상 네트워크 도구와 인터페이스 또는 라우팅 충돌이 발생할 수 있습니다. 로컬 장치에 접근할 수 없다면 로컬 네트워크와 사설 주소 우회 규칙을 확인해야 합니다.

F

FakeDNS

도메인에 임시 가상 IP를 할당하고 이후 연결에서 원래 도메인 정보를 복원하는 DNS 처리 방식입니다. TUN 모드와 함께 사용해 라우팅이 도메인 기준으로 분류되도록 하는 경우가 많습니다.

FakeDNS 주소는 클라이언트 내부 매핑에서만 의미가 있습니다. 매핑 범위, 라우팅 또는 DNS 설정이 일치하지 않으면 도메인은 해석되지만 연결이 완료되지 않을 수 있습니다.

A

구독 자동 업데이트

클라이언트가 설정된 주기에 따라 구독 내용을 다시 가져와 그룹을 갱신합니다. 노드 변화를 동기화하는 기능이며, 만료된 구독 주소나 잘못된 콘텐츠 형식을 자동으로 수정하지는 않습니다.

업데이트 후 목록에도 그룹 필터, 정렬과 중복 제거 규칙이 적용됩니다. 중요한 설정이 변경되었다면 먼저 수동으로 한 번 업데이트하고 클라이언트 로그를 확인할 수 있습니다.

네트워크와 시스템

DNS, TCP와 UDP

프록시 설정은 운영 체제의 네트워크 기능을 기반으로 동작합니다. 도메인 해석은 대상 주소를 결정하고, TCP와 UDP는 서로 다른 데이터 전송 방식을 나타냅니다.

D

DNS

도메인을 IP 주소로 변환하는 기본 네트워크 서비스입니다. 클라이언트에서 조회 서버, 도메인 매칭 규칙, 조회 유형과 DNS 트래픽의 아웃바운드 경로를 설정할 수 있습니다.

웹 페이지는 열리지 않지만 IP로 직접 접속할 수 있다면 DNS를 점검해야 합니다. 시스템 캐시, 클라이언트 로그와 브라우저 자체 DNS 설정도 확인해야 합니다.

D

DNS 누수

도메인 조회가 예상한 경로로 전송되지 않아 조회 흐름과 연결 트래픽의 라우팅 정책이 서로 달라지는 현상입니다. 시스템 DNS, 브라우저 독립 DNS와 클라이언트 DNS가 동시에 작동할 때 흔히 발생합니다.

처리할 때 어느 계층이 해석을 담당할지 정한 다음 시스템 프록시, TUN, DNS 아웃바운드와 브라우저 설정을 일관되게 확인해야 합니다. DNS 주소 하나만 바꾼다고 경로 불일치가 반드시 해결되지는 않습니다.

T

TCP

신뢰성 있고 순서가 보장된 바이트 스트림을 제공하는 전송 계층 프로토콜입니다. 웹 접속, 파일 전송과 대부분의 프록시 전송 조합에서 TCP를 사용합니다.

설정에서 TCP는 하위 전송 방식을 의미할 수도 있고, 라우팅 규칙에서 매칭해야 하는 네트워크 유형을 의미할 수도 있습니다. 필드를 읽을 때는 해당 필드가 속한 설정 계층을 함께 확인해야 합니다.

U

UDP

데이터그램 기반 전송 계층 프로토콜로, DNS, 실시간 통신과 일부 애플리케이션 트래픽에서 UDP를 사용합니다. TCP와 같은 연결 확인 및 재전송 기능은 제공하지 않습니다.

특정 애플리케이션 기능에 문제가 있지만 일반 웹 페이지는 정상이라면 노드, 코어, 라우팅과 TUN 설정에서 UDP를 허용하는지 확인할 수 있습니다. 클라이언트 인터페이스의 UDP 옵션도 현재 실행 모드에 맞춰야 합니다.

V2Ray 클라이언트 다운로드