설정 및 문제 해결 용어

V2Ray 용어집

화면에 VLESS, TUN, 실제 연결 지연 시간이 표시되면 먼저 어느 계층의 용어인지 확인하세요. 그런 다음 노드 매개변수, 시스템 설정, 설정 파일 중 무엇을 점검할지 판단할 수 있습니다.

프로토콜 및 전송

노드 설정의 프로토콜, 전송 방식, 보안 계층은 서로 다른 항목이므로 문제를 해결할 때 각각 확인해야 합니다.

VMessProxy protocol
VMess는 Project V 생태계의 프록시 프로토콜입니다. 클라이언트와 서버가 정해진 방식에 따라 사용자를 식별하고 프록시 요청을 처리합니다. 노드를 가져온 뒤 포트 연결은 되지만 접속되지 않는다면 사용자 식별 정보, 전송 방식, 보안 설정뿐 아니라 기기의 시간이 정확한지도 확인하세요.
VLESSProxy protocol
VLESS는 클라이언트를 UUID로 식별하는 프록시 프로토콜이지만, 프로토콜 자체는 데이터를 암호화하지 않습니다. 실제 설정에서는 TLS나 REALITY 같은 보안 계층과 함께 사용하는 경우가 많습니다. VLESS를 올바르게 선택하는 것만으로는 연결되지 않을 수 있으므로 전송 방식과 보안 계층 설정도 서버와 일치해야 합니다.
TrojanTLS-based proxy protocol
Trojan은 일반적으로 TLS 연결에서 비밀번호로 인증합니다. 비밀번호는 프록시 프로토콜의 매개변수이지 인증서 설정이 아닙니다. 로그가 TLS 핸드셰이크나 인증서 확인 단계에서 멈추면 먼저 서버 이름, 인증서, 시스템 시간을 확인한 뒤 비밀번호를 점검하세요.
REALITYTransport security
REALITY는 Xray가 지원하는 보안 계층으로, VLESS와 함께 자주 사용됩니다. 별도의 프록시 프로토콜도 아니고 WebSocket 같은 전송 방식도 아닙니다. 노드에 REALITY가 표시되어 있다면 먼저 사용 중인 코어가 이를 지원하는지 확인하고, 노드 제공 정보에 따라 서버 이름, 공개 키, 짧은 ID 등의 매개변수를 점검하세요.
전송 방식Transport
전송 방식은 프록시 프로토콜의 데이터를 전달하는 방법을 정합니다. 일반 TCP, WebSocket, gRPC 등을 사용할 수 있습니다. 두 노드가 같은 프록시 프로토콜을 사용하더라도 전송 설정은 다를 수 있습니다. 경로나 서비스 이름이 맞지 않는다면 노드 메모나 인증 정보를 바꾸지 말고 해당 전송 설정을 확인하세요.

코어 및 생태계

설정 관리는 인터페이스가, 연결 처리는 코어가 담당합니다. 두 구성 요소의 버전과 지원 범위는 따로 확인해야 합니다.

Project VOpen-source ecosystem
Project V는 V2Ray의 기반이 된 오픈소스 네트워크 프록시 프로젝트입니다. 이후 서로 다른 커뮤니티가 관리하는 코어와 그래픽 클라이언트가 등장했습니다. 따라서 문서에서 'V2Ray'라고만 할 때는 특정 코어를 뜻할 수도 있고 생태계 전반을 가리킬 수도 있습니다. 설정을 확인하기 전에 문서가 어느 쪽을 다루는지 살펴보세요.
XrayXray-core
Xray는 V2Ray 생태계에서 발전한 독립 프록시 코어로, REALITY 등의 기능을 지원합니다. 그래픽 인터페이스에 노드가 표시된다고 해서 현재 코어에서 사용할 수 있다는 뜻은 아닙니다. 호환성 문제를 확인할 때는 실제로 실행 중인 코어와 버전을 먼저 살펴본 뒤 노드에 필요한 기능을 확인하세요.
V2FlyV2Ray community project
V2Fly는 V2Ray 개발을 이어가는 커뮤니티 프로젝트입니다. 이 프로젝트가 관리하는 V2Ray 코어는 설정을 읽고 인바운드 연결을 수신해 아웃바운드 트래픽을 처리합니다. Xray와 공통된 역사를 가지고 있지만, 항목과 기능은 각자 버전에 따라 발전하므로 설정 형식이 비슷하다는 이유만으로 두 코어를 바로 바꿔 쓸 수 있다고 판단해서는 안 됩니다.
코어 설정 참고 자료 보기 →

클라이언트 기능

앱 트래픽은 먼저 클라이언트에 전달되고, 코어가 처리 방식을 결정합니다. 연결을 받아들이는 단계와 아웃바운드로 보내는 단계는 나누어 점검해야 합니다.

시스템 프록시System proxy
시스템 프록시는 시스템 프록시 설정을 따르는 앱에 로컬 프록시 연결 지점을 제공합니다. 네트워크 연결을 직접 관리하는 앱은 이 설정을 무시할 수 있으므로, 브라우저에서 연결된다고 해서 모든 앱이 같은 경로를 사용하는 것은 아닙니다. 클라이언트를 종료한 뒤에도 앱이 로컬 포트에 연결하려 한다면 시스템에 프록시 설정이 남아 있는지 확인하세요.
TUN 모드Virtual network interface
TUN 모드는 앱이 직접 프록시를 사용하도록 기다리는 대신 가상 네트워크 인터페이스를 통해 시스템 라우팅에서 전달된 트래픽을 받습니다. 활성화하려면 시스템 권한이 필요할 수 있으며, 실제로 처리되는 트래픽 범위는 라우팅과 제외 설정에 따라 달라집니다. 다른 가상 네트워크 어댑터가 이미 있다면 라우팅을 두고 충돌할 수 있으므로 각 설정의 적용 범위를 따로 확인하세요.
인바운드inbounds
인바운드는 프록시 코어가 연결을 수신하는 방식을 정의합니다. 예를 들어 SOCKS 서비스를 제공할 주소와 포트를 지정합니다. 이 기기의 앱에서 연결할 수 없다면 앱에 입력한 프로토콜과 포트가 인바운드 설정과 일치하는지 먼저 확인하세요. 기기에서만 사용할 연결 지점이라면 보통 루프백 주소에서 수신하면 되며, 모든 네트워크 인터페이스에 바인딩할 필요는 없습니다.
아웃바운드outbounds
아웃바운드는 코어가 연결을 처리하는 방식을 정의합니다. 프록시 서버로 보내거나 직접 연결하거나 차단할 수 있습니다. 라우팅 규칙은 일반적으로 태그를 사용해 아웃바운드를 지정합니다. “인바운드에서 연결을 받았지만 트래픽이 예상한 대로 전송되지 않는” 경우 규칙의 outboundTag와 아웃바운드의 tag를 대조해 보세요.
인바운드 설정 예시 보기 →

라우팅 및 DNS

DNS 해석은 주소를 찾는 방법을 정하고, 라우팅은 연결을 어느 아웃바운드로 보낼지 정합니다. 두 단계는 서로 관련되어 있지만 문제 해결 시 하나로 묶어서는 안 됩니다.

라우팅 규칙routing.rules
라우팅 규칙은 대상 도메인, IP, 포트 등의 조건에 따라 연결에 사용할 아웃바운드를 선택합니다. V2Ray와 Xray는 일반적으로 설정된 순서대로 규칙을 확인하고 먼저 일치하는 규칙을 적용합니다. 특정 규칙이 계속 적용되지 않는다면 그 앞에 더 넓은 범위의 규칙이 연결을 먼저 처리하는지 확인하세요.
트래픽 분기Traffic routing
트래픽 분기는 연결을 서로 다른 아웃바운드로 보내는 방식입니다. 예를 들어 로컬 네트워크 연결은 직접 연결하고 나머지는 다른 아웃바운드로 보낼 수 있습니다. 이 설정은 관련 처리 경로에 들어온 트래픽에만 적용됩니다. 테스트 결과가 예상과 다르면 먼저 트래픽이 코어에 전달되었는지 확인한 뒤 분기 조건을 점검하세요.
GeoIPgeoip:
GeoIP는 지역이나 주소 유형별로 IP 대역을 분류해 한 규칙으로 여러 주소를 매칭할 수 있게 합니다. 데이터 파일에서 주소를 어떻게 분류했는지를 나타낼 뿐, 서버의 실제 위치를 확인해 주는 것은 아닙니다. 규칙 결과가 예상과 다르면 최종 매칭된 IP와 현재 사용하는 데이터 파일을 함께 확인하세요.
GeoSitegeosite:
GeoSite는 도메인을 범주별로 모아 둔 목록으로, 라우팅 규칙에서 목록 이름을 참조해 여러 도메인을 매칭할 수 있습니다. 분류 이름과 포함 범위는 데이터 세트에 따라 달라지므로, 이름만 보고 특정 도메인이 반드시 포함된다고 판단해서는 안 됩니다. 도메인 하나를 정확히 매칭해야 한다면 별도의 도메인 규칙을 설정하세요.
FakeDNSSynthetic IP mapping
FakeDNS는 먼저 앱에 가상 IP를 반환하고, 해당 IP와 원래 도메인의 매핑을 보관합니다. 이후 이 매핑을 인식하는 코어에 연결이 전달되면 코어가 도메인을 복원해 규칙 매칭에 사용할 수 있습니다. DNS 응답에는 이 방식을 적용했더라도 이후 연결이 해당 코어에서 처리되지 않으면 앱이 연결에 실패할 수 있습니다.
DNS 유출DNS leak
DNS 유출은 쿼리가 예상하지 못한 경로로 전달되어 의도하지 않은 DNS 서버에서 처리되는 현상입니다. 테스트 페이지에 낯선 DNS 서버가 표시된다는 사실만으로 설정 오류라고 단정할 수는 없습니다. 먼저 어느 서버가 쿼리를 처리하기를 원하는지 확인하세요. 원인을 찾을 때는 앱 내장 암호화 DNS, 운영체제 설정, 코어의 DNS 설정을 나누어 점검할 수 있습니다.
라우팅 규칙과 매칭 순서 보기 →

구독 및 노드

구독 업데이트, 포트 테스트, 프록시를 통한 요청 전송은 각각 별개의 단계입니다. 한 단계가 성공해도 다음 단계까지 통과했다는 뜻은 아닙니다.

구독Subscription
구독은 클라이언트에서 노드 정보를 일괄 가져오고 업데이트하는 데 사용하는 소스이며, 보통 링크로 제공됩니다. 업데이트 성공은 클라이언트가 정보를 가져와 처리했다는 뜻일 뿐, 모든 노드에 연결할 수 있다는 의미는 아닙니다. 구독 링크에는 접근 정보가 포함될 수 있으므로 스크린샷이나 로그를 공유하기 전에 전체 링크를 가리세요.
노드Server profile
노드는 클라이언트에 프록시 엔드포인트와 연결 매개변수를 기록한 설정 항목입니다. 보통 주소, 포트, 프로토콜, 보안 설정이 포함됩니다. 메모 이름은 설정을 구분하는 용도일 뿐, 이름이 같은 항목이 같은 서버를 가리킨다는 보장은 없습니다. 업데이트 후 같은 이름의 항목이 생기면 구독 그룹과 연결 매개변수를 비교한 뒤 어느 항목을 유지할지 결정하세요.
TcpingTCP connect test
Tcping은 TCP 연결에 걸리는 시간을 기준으로 포트 연결 가능 여부를 확인합니다. 일반적으로 프록시 프로토콜 인증은 확인하지 않으며 해당 노드를 통해 대상 웹사이트에 접속하지도 않습니다. Tcping은 정상이지만 프록시 요청이 실패한다면 포트 결과만으로 노드 사용 가능 여부를 판단하지 말고 프로토콜, 보안 계층, 프록시 아웃바운드를 점검하세요.
실제 연결 지연 시간Proxied request latency
실제 연결 지연 시간은 선택한 프록시 아웃바운드로 테스트 대상에 접속한 뒤 클라이언트 구현 방식에 따라 요청 소요 시간을 측정합니다. 테스트 주소, 연결 재사용 여부, 대상 서버의 응답에 따라 결과가 달라질 수 있으며 다운로드 속도를 나타내는 지표도 아닙니다. 여러 노드를 비교할 때는 같은 테스트 대상과 방식을 사용하세요.