용어 빠른 찾아보기

V2Ray 용어 사전

클라이언트 화면, 연결 설정, 로그에 표시된 용어를 찾아보세요. 먼저 용어가 어느 계층에 해당하는지 확인한 뒤 관련 설정을 점검하면 됩니다.

프로토콜
연결 양측이 데이터를 주고받는 방식
트래픽 처리
트래픽이 클라이언트로 들어오는 경로
라우팅
코어에 들어온 트래픽이 나가는 경로

프로토콜·전송 방식

프로토콜, 전송 방식, 보안 계층은 각각 별도의 설정 항목입니다. 프로토콜 이름만 맞춰도 나머지 매개변수가 맞는 것은 아닙니다.

VMess

VMess는 Project V 초기에 채택된 프록시 프로토콜입니다. 사용자 ID로 인증하며 프로토콜 계층의 데이터 보호 방식도 정의합니다. WebSocket 같은 전송 방식은 별도 설정 항목이므로 VMess라는 이름만으로 전송 방식을 알 수는 없습니다. 설정이 일치하는 것처럼 보이는데 핸드셰이크에 실패한다면 기기 시간이 동기화되어 있는지도 확인해 보세요.

VLESS

VLESS와 VMess는 서로 다른 프록시 프로토콜이며, 일반적인 설정에서는 UUID로 사용자를 식별합니다. 실제 구성에서는 TLS나 REALITY를 연결 보안 계층으로 함께 사용하는 경우가 많습니다. 프로토콜 이름만 바꾼다고 기존 VMess 노드가 VLESS로 변환되지는 않습니다. 연결 양쪽 모두 같은 설정을 지원하고 사용해야 합니다.

Trojan

Trojan은 TLS와 함께 사용하는 경우가 많은 프록시 프로토콜이며, 보통 비밀번호로 프록시 계층 인증을 수행합니다. TLS 인증서는 서버의 신원을 확인하고 프록시 비밀번호는 사용자의 신원을 확인하므로 서로 대체할 수 없습니다. 로그에 인증서 오류가 먼저 표시된다면 비밀번호를 계속 바꾸기보다 서버 이름과 인증서 상태부터 확인하세요.

REALITY

REALITY는 Xray가 지원하는 연결 보안 방식으로, VLESS와 함께 사용하는 경우가 많습니다. 화면에 VLESS와 REALITY가 각각 표시된다면 전자는 프록시 프로토콜이고 후자는 연결 보안 설정입니다. 노드를 가져올 수 있지만 시작되지 않는다면 현재 선택한 코어와 버전이 해당 필드를 지원하는지 먼저 확인하세요.

코어·클라이언트

화면에서 설정을 관리하고 코어에서 연결을 처리합니다. 클라이언트 이름만 기록하기보다 두 구성 요소의 버전을 함께 적어 두는 편이 유용합니다.

V2Fly

V2Fly는 Project V의 V2Ray 코어 개발을 이어가는 오픈 소스 커뮤니티 프로젝트입니다. 클라이언트 화면에서 이 이름이 커뮤니티가 관리하는 코어를 가리킬 수도 있습니다. 공유 링크 형식의 이름은 아닙니다. 문서에 특정 필드가 Xray용이라고 명시되어 있다면, V2Fly에서 같은 이름의 필드가 똑같이 동작한다고 단정해서는 안 됩니다.

Xray

Xray는 V2Ray 생태계에서 파생된 독립 프록시 코어로, REALITY 등의 기능을 지원합니다. V2Fly와 일부 설정 개념을 공유하지만 프로토콜 기능과 필드 지원은 각 코어의 버전에 따라 달라집니다. 알 수 없는 필드 오류가 발생하면 시작 로그에서 실제로 어떤 코어가 로드되었는지 먼저 확인하세요.

클라이언트

v2rayN, v2rayNG, v2flyNG는 구독 관리, 노드 선택, 모드 전환, 로그 확인 기능을 제공하는 그래픽 클라이언트입니다. 클라이언트는 가져온 내용을 먼저 목록에 저장한 뒤 현재 연결에 사용할 설정을 생성할 수 있습니다. 목록에 항목이 보인다는 것은 가져오기 작업이 이루어졌다는 뜻일 뿐, 원격 서버에 연결할 수 있다는 의미는 아닙니다.

코어

코어는 클라이언트가 생성한 설정을 읽어 프로토콜 핸드셰이크, 연결 전달, 라우팅 매칭을 처리합니다. 화면은 열리지만 코어가 시작되지 않는다면 노드 지연 시간을 확인하기보다 로그의 첫 번째 오류를 살펴보세요. 로컬 포트를 바인딩할 수 없다는 오류가 표시된다면 원격 노드를 바꿔도 포트 충돌은 해결되지 않습니다.

구독·노드

구독 업데이트, 포트 연결 가능 여부, 프록시 요청 성공은 각각 별개의 문제입니다. 문제를 진단할 때는 어느 단계에서 실패했는지 먼저 기록하세요.

구독

구독을 사용하면 클라이언트가 하나의 주소에서 여러 노드 정보를 가져올 수 있습니다. 직접 업데이트하거나 클라이언트가 정기적으로 새로고침하도록 설정할 수 있습니다. 업데이트 성공은 목록을 받아 파싱했다는 뜻일 뿐, 모든 노드에 연결할 수 있다는 의미는 아닙니다. 업데이트에 실패하면 요청 시간 초과인지, 응답은 받았지만 파싱 후 항목이 없는지 구분해 확인하세요.

노드

노드는 클라이언트에 저장된 원격 연결 설정 하나로, 보통 주소, 포트, 프로토콜, 인증 및 전송 매개변수를 포함합니다. 목록에 표시되는 이름은 메모일 뿐이며, 이름이 같아도 주소나 포트가 다를 수 있습니다. 연결 결과를 비교하기 전에 이름만 보지 말고 같은 설정을 선택했는지 확인하세요.

TCPing

TCPing은 지정한 주소와 포트에 TCP 연결을 시도하고 연결에 걸린 시간을 기록합니다. 테스트에 성공했다면 해당 시점에 TCP 연결을 맺을 수 있었다는 뜻입니다. 프록시 인증 정보를 검증하거나 대상 웹페이지가 열리는지 확인하는 테스트는 아닙니다. UDP를 사용하는 연결 방식은 이 테스트만으로 정상 여부를 판단할 수 없습니다.

실제 연결 지연

실제 연결 지연은 지정한 노드를 거쳐 테스트 주소에 요청을 보내 측정합니다. 결과는 프로토콜 핸드셰이크, 테스트 대상, 측정 방식에 따라 달라집니다. 포트만 검사할 때보다 더 긴 구간을 확인하지만 다운로드 속도는 아니며 모든 웹사이트에 접속할 수 있다는 뜻도 아닙니다. 노드별 결과를 비교할 때는 가능한 한 같은 테스트 주소와 네트워크 환경을 사용하세요.

라우팅·트래픽 분기

먼저 트래픽이 코어에 들어왔는지 확인한 다음 어떤 규칙에 매칭되었는지 살펴보세요. 코어에 들어오지 않은 연결은 규칙을 바꿔도 경로가 자동으로 변경되지 않습니다.

라우팅 규칙

라우팅 규칙은 도메인, IP 주소, 포트 등의 조건을 지정된 아웃바운드 경로에 연결합니다. 일반적인 코어는 설정된 순서대로 규칙을 확인하며, 먼저 매칭된 규칙이 우선 적용됩니다. 새로 추가한 예외 규칙이 적용되지 않는 것 같다면 더 넓은 범위의 규칙 뒤에 배치되어 있지 않은지 확인하세요.

트래픽 분기

트래픽 분기는 연결마다 직접 연결, 프록시, 차단 등 서로 다른 아웃바운드 처리를 적용하는 방식입니다. 같은 웹페이지라도 본문과 이미지가 서로 다른 도메인에서 제공되어 각기 다른 규칙이 적용될 수 있습니다. 페이지는 열리지만 이미지가 표시되지 않는다면 주소창의 도메인만 확인하지 말고 실패한 요청의 대상도 확인하세요.

GeoIP

GeoIP는 라우팅 규칙에서 참조할 수 있는 IP 주소 모음입니다. 예를 들어 geoip:private는 사설 IP 주소 범위를 매칭할 때 자주 사용됩니다. 주소를 기준으로 매칭할 뿐 도메인을 IP로 변환하지는 않습니다. 도메인 연결이 이 규칙에 매칭되는지는 매칭 시점에 코어가 대상 IP를 확보했는지에 따라 달라집니다.

GeoSite

GeoSite는 도메인을 태그별로 분류해 재사용할 수 있는 규칙 목록으로 구성합니다. 일반적으로 geosite: 뒤에 태그 이름을 붙여 참조합니다. 태그의 존재 여부와 포함 도메인은 실제로 로드한 규칙 리소스에 따라 달라집니다. 앱이 대상 IP만 제공하고 코어가 도메인을 확보하지 못했다면 이 규칙으로 IP를 직접 매칭할 수 없습니다.

네트워크·DNS

웹 요청과 도메인 조회는 서로 다른 경로를 사용할 수 있습니다. 프록시를 통한 접속 경로를 확인한 뒤에도 DNS 요청이 어디로 전달되는지 별도로 확인해야 합니다.

시스템 프록시

시스템 프록시는 운영체제가 앱에 제공하는 프록시 설정이며, 그래픽 클라이언트는 보통 이 설정을 로컬 수신 주소로 지정합니다. 앱에 별도의 프록시 설정이 있다면 시스템 설정을 덮어쓰거나 계속 직접 연결할 수도 있습니다. 브라우저는 정상인데 다른 프로그램은 작동하지 않는다면 해당 프로그램이 시스템 프록시를 사용하는지 먼저 확인하세요.

TUN 모드

TUN 모드는 가상 네트워크 인터페이스를 통해 시스템 라우팅에 매칭되는 IP 트래픽을 받으므로 앱마다 시스템 프록시를 읽도록 설정할 필요가 없습니다. 실제로 어떤 트래픽이 인터페이스로 들어오는지는 라우팅 테이블, 제외 항목, 플랫폼 권한에 따라 달라집니다. 활성화한 뒤 로컬 네트워크 서비스에 연결할 수 없다면 해당 네트워크 대역이 처리 범위에 포함되었는지 확인하세요.

FakeDNS

FakeDNS는 앱에 매핑 주소를 반환합니다. 이후 연결이 코어에 들어오면 해당 주소로 원래 도메인을 찾아 규칙에 따라 전달할 수 있습니다. 매핑 주소는 대상 서버의 실제 IP가 아닙니다. 트래픽 처리 모드나 DNS 설정을 바꾼 뒤에도 앱에 이전 주소가 캐시되어 있으면 새 연결에서 기존 매핑을 찾지 못할 수 있습니다.

DNS 누수

DNS 누수는 지정한 DNS 정책을 따라야 하는 쿼리가 예상하지 못한 경로를 거치거나 다른 DNS 리졸버로 전송되는 현상입니다. 웹 요청이 예상한 경로로 나간다고 해서 DNS 요청 경로까지 올바르다고 단정할 수는 없습니다. 진단할 때는 쿼리를 브라우저, 운영체제, 코어 중 어디서 보냈는지 구분하고 예정된 DNS 경로와 비교하세요.

증상별 추가 점검

  • 노드 목록이 비어 있음구독 가져오기 안내를 참고해 주소가 저장되었는지 확인한 뒤 업데이트를 한 번 실행하세요.
  • 연결 후 인터넷에 접속할 수 없음인터넷 연결 문제 해결로 이동해 기본 네트워크 문제와 프록시 연결 문제를 먼저 구분하세요.
  • 예상과 다른 아웃바운드 경로라우팅·트래픽 분기 문제 해결에서 대상 정보, 규칙 순서, 실제 아웃바운드 경로를 확인하세요.

분류 색인으로 돌아가기 ↑