PLATFORM ENTRY

V2Ray 클라이언트 플랫폼

홈에서는 운영체제에 따라 다운로드 경로만 나눕니다. 설치 파일 페이지에서 프로세서 아키텍처, 패키지 형식 및 클라이언트 코어에 맞는 파일을 선택하세요. 데스크톱은 v2rayN을 주로 사용하며, Android에서는 v2rayNG와 v2flyNG 중 선택할 수 있습니다.

Windows

v2rayN 데스크톱 클라이언트를 사용합니다. 설치 파일 페이지에서 최신 데스크톱 인터페이스와 클래식 WPF 버전의 차이를 설명하고, 실행 환경, 압축 해제 설치, 시스템 프록시 활성화 및 포트 충돌 해결 방법을 안내합니다.

다운로드 페이지로 이동

macOS

v2rayN 크로스플랫폼 데스크톱 클라이언트를 사용합니다. 다운로드 전에 기기가 Apple Silicon인지 Intel 프로세서인지 확인하세요. 해당 탭에서 아키텍처 확인, 최초 실행 및 시스템 프록시 설정 방법을 볼 수 있습니다.

다운로드 페이지로 이동

Android

Xray 코어를 사용하는 v2rayNG를 우선 확인하고, V2Fly 코어가 필요하면 v2flyNG를 선택하세요. 설치 파일 페이지는 arm64와 범용 아키텍처로 구분하며, 구독 가져오기, VPN 권한 및 백그라운드 실행 설정을 설명합니다.

다운로드 페이지로 이동

Linux

v2rayN 데스크톱 클라이언트를 사용합니다. 설치 경로는 deb·rpm 패키지와 프로세서 아키텍처별로 나뉘어 일반적인 데스크톱 배포판에 적합합니다. 설치 후에는 데스크톱 환경에서 시스템 프록시를 설정하거나 클라이언트의 TUN 기능을 사용해야 합니다.

다운로드 페이지로 이동

전체 클라이언트 보기 →

CLIENT CAPABILITIES

v2rayN 설정 핵심 단계

클라이언트는 설정과 코어 사이를 연결하는 그래픽 인터페이스일 뿐입니다. 실제 사용 결과는 노드 매개변수, 프로토콜 필드, 라우팅 순서, DNS 경로 및 시스템 트래픽 처리 방식이 함께 결정합니다. 아래에서 자주 문제가 발생하는 네 가지 영역을 나누어 설명합니다.

ROUTING

V2Ray 라우팅

라우팅 규칙은 트래픽을 프록시로 보낼지, 직접 연결할지, 차단할지를 결정합니다. 일반적인 조건에는 도메인, 대상 IP, 포트, 인바운드 태그 및 프로토콜 유형이 포함됩니다. v2rayN에서는 사전 설정 규칙을 사용하거나 사용자 지정 JSON을 불러올 수 있습니다. 설정할 때는 먼저 이해하기 쉬운 소수의 규칙을 만든 뒤 geosite와 geoip 항목을 단계적으로 추가하세요. 규칙이 많다고 매칭이 더 정확해지는 것은 아닙니다. 문제가 발생하면 위에서 아래로 적용되는 매칭 순서, 최종 대체 출구 및 도메인 확인 결과를 점검해 같은 대상이 충돌하는 조건에 동시에 걸리지 않는지 확인하세요.

단순한 글로벌 프록시와 달리 라우팅은 업무별 트래픽을 제어할 수 있습니다. 중국 본토 서비스 직접 연결, 특정 도메인 프록시, 로컬 네트워크 주소 우회 및 광고 도메인 차단을 각각 처리할 수 있으며, 로그에서 실제 규칙이 적용되었는지도 확인하기 쉽습니다.

routing.json

{
  "type": "field",
  "domain": ["geosite:cn"],
  "outboundTag": "direct"
}

전체 설정 가이드 보기 →

OPEN SOURCE ECOSYSTEM

Project V, V2Fly 및 Xray 코어의 관계

V2Ray는 단일 그래픽 클라이언트의 이름이 아닙니다. 일반적으로 Project V에서 발전한 프로토콜, 코어 및 클라이언트 생태계를 가리키는 말로 사용됩니다. 코어와 인터페이스의 역할을 이해하면 설정 문제가 어느 계층에서 발생했는지 판단하는 데 도움이 됩니다.

Project V에서 코어 제품군으로

Project V는 초기에 V2Ray Core와 설정 체계를 구축했으며, VMess, 인바운드, 아웃바운드, 라우팅 및 전송 계층 등의 개념이 여기서 형성되었습니다. 이후 커뮤니티의 유지보수 방향이 갈라지면서 V2Fly는 v2fly-core를 이어서 관리했고, Xray는 기존 설정 개념과의 호환성을 바탕으로 xray-core를 발전시켰습니다. 두 코어 모두 현재 널리 사용되는 구현이지만 지원하는 프로토콜 확장, 설정 필드 및 릴리스 주기는 완전히 같지 않습니다.

그래픽 클라이언트가 프로토콜 처리를 직접 담당하는 경우는 드뭅니다. v2rayN, v2rayNG 및 v2flyNG는 구독 관리, 노드 편집, 매개변수 생성, 코어 실행, 시스템 프록시 전환 및 로그 표시를 담당하고 실제 데이터 연결은 호출된 코어가 처리합니다. 따라서 같은 노드라도 클라이언트별 코어 유형, 코어 설정 템플릿 및 클라이언트 버전의 호환성에 따라 결과가 달라질 수 있습니다. 문제를 해결할 때는 단순히 “V2Ray에 연결할 수 없다”고 하지 말고 클라이언트 이름, 사용한 코어, 프로토콜 필드 및 오류 로그를 함께 기록하세요.

오픈 소스 라이선스를 통해 개발자는 코드를 검토하고 설정 구현을 연구하며 파생 도구를 만들 수 있습니다. 다만 각 프로젝트의 라이선스 문서, 의존성 및 배포 방식은 별도로 확인해야 합니다. 사이트 문서는 공개된 설정 모델과 실제 클라이언트 인터페이스를 바탕으로 설치, 매개변수 의미 및 문제 해결 순서를 설명하며, 서로 다른 프로젝트를 하나의 소프트웨어 패키지로 혼동하지 않습니다.

V2FLY

v2fly-core

V2Fly 커뮤니티가 유지보수하는 코어는 Project V의 설정 체계를 이어받아 인바운드, 아웃바운드, 라우팅, DNS 및 다양한 전송 방식을 지원합니다. v2flyNG는 이 코어를 Android용 그래픽 인터페이스로 사용하므로 V2Fly 코어 경로를 유지해야 하는 설정에 적합합니다.

XRAY

xray-core

Xray 코어는 기존 V2Ray 설정 개념과 높은 연관성을 유지하면서 VLESS, REALITY 등의 기능을 발전시켰습니다. v2rayN과 v2rayNG는 클라이언트 생태계에서 Xray를 호출하는 경우가 많지만, 실제 지원 범위는 클라이언트와 코어의 조합에 따라 달라집니다.

CLIENTS

세 가지 그래픽 클라이언트

v2rayN은 Windows, macOS 및 Linux 데스크톱 시스템용이며, v2rayNG는 Android용으로 Xray 코어를 주로 사용합니다. v2flyNG 역시 Android용이지만 V2Fly 코어를 사용합니다. 세 클라이언트의 목적은 서로 다르므로 이름이 비슷하다는 이유만으로 선택해서는 안 됩니다.

업데이트 방식

클라이언트, 코어, GeoIP 및 GeoSite 데이터는 서로 다른 구성 요소입니다. 클라이언트 업데이트는 보통 인터페이스와 설정 생성 로직에 영향을 주고, 코어 업데이트는 프로토콜 처리와 동작 방식에 영향을 줍니다. 지리 데이터 업데이트는 라우팅 규칙 매칭에 영향을 줍니다. 라우팅이 잘못될 때는 먼저 데이터 파일을 확인하고, 프로토콜 필드를 인식하지 못할 때는 코어와 클라이언트의 호환성을 점검하세요.

설정 호환성

공유 링크와 구독 형식은 설정을 교환하는 방식일 뿐, 모든 클라이언트가 그 안의 모든 필드를 지원한다는 뜻은 아닙니다. 가져오기에 성공했다는 것은 기본 구조를 인식했다는 의미일 뿐이며, 전송 계층, 보안 계층, SNI, 지문 및 라우팅 설정이 완전한지도 확인해야 합니다. 코어를 바꿔 마이그레이션할 때는 기존 설정을 그대로 덮어쓰지 말고 필드를 하나씩 대조하세요.

로그로 원인 찾기

유용한 로그에는 발생 시각, 연결 단계 및 오류 유형이 포함되어야 합니다. DNS 확인 실패, TCP 연결 시간 초과, TLS 핸드셰이크 실패, 인증 필드 오류 및 라우팅 미매칭은 각각 서로 다른 계층을 가리킵니다. 먼저 오류가 발생한 계층을 확인한 뒤 해당 설정만 수정하면 여러 변수를 동시에 바꿔 새로운 혼란을 만드는 일을 피할 수 있습니다.

QUICK DIAGNOSIS

V2Ray 자주 묻는 질문

아래 질문은 최초 설치 후 가장 혼동하기 쉬운 네 가지 영역을 다룹니다. 체계적인 점검이 필요하면 가이드, 개념 빠른 참조 및 문제 해결 매뉴얼을 계속 확인하세요.

v2rayN에서 구독을 가져온 뒤 노드가 보이지 않는 이유는 무엇인가요?

먼저 ‘구독 업데이트’를 사용했는지, 단순히 새 구독 그룹만 추가한 것은 아닌지 확인하세요. 주소를 복사하는 과정에서 앞이나 뒤의 문자가 누락되지 않았는지도 점검해야 합니다. 그다음 시스템 시간, 현재 네트워크 연결 및 클라이언트 로그를 확인하세요. 요청은 성공했지만 해석 결과가 비어 있다면 반환 형식이 클라이언트 지원 범위와 맞지 않을 수 있습니다. 설정을 전부 반복해서 삭제하지 말고 기존 구독 항목을 유지한 채 하나씩 확인하세요.

구독 가져오기 단계 보기 →

시스템 프록시를 켰는데 일부 프로그램이 계속 직접 연결될 때는 어떻게 하나요?

시스템 프록시는 해당 설정을 읽는 앱에만 적용됩니다. 먼저 대상 프로그램에 별도의 프록시 옵션이 있는지 확인하고 자체 네트워크 스택을 사용하는지도 점검하세요. 더 넓은 범위의 트래픽을 처리해야 한다면 TUN 모드를 검토할 수 있지만, 먼저 일반 프록시 모드에서 노드가 정상 작동하는지 확인하고 여러 네트워크 도구가 동시에 라우팅 테이블을 수정하지 않도록 하세요.

시스템 프록시 및 TUN 개념 보기 →

노드는 연결되지만 웹페이지가 느리게 열릴 때 무엇을 확인해야 하나요?

먼저 DNS 확인이 느린지, 연결 설정이 느린지, 콘텐츠 전송이 느린지 구분하세요. 다른 웹사이트로 교차 테스트하고 로그에서 반복적인 확인이나 재연결이 발생하는지 살펴볼 수 있습니다. 그다음 라우팅 규칙, DNS 조회 경로, 전송 방식 및 로컬 네트워크를 점검하세요. 대상, 시간 및 경로에 따라 결과가 크게 달라질 수 있으므로 단 한 번의 속도 측정 결과에만 의존하지 마세요.

속도 문제 해결 절차 보기 →

VMess, VLESS 및 Trojan은 어떻게 선택해야 하나요?

프로토콜은 서버 설정과 일치해야 하며 클라이언트에서 임의로 서로 바꿀 수 없습니다. 선택할 때 서버가 제공한 프로토콜, 포트, 사용자 식별자, 보안 계층 및 전송 매개변수를 확인하세요. 완전한 구독을 받았다면 직접 수정하는 것보다 그대로 가져오는 편이 일반적으로 안전합니다. 수동 설정이 필요하다면 원본 자료와 필드를 하나씩 대조하세요.

프로토콜 개념 빠른 참조 보기 →

FIELD NOTES