Xray / V2Fly 커널 클라이언트

V2Ray for Windows v2rayN 클라이언트 다운로드 및 설정

구독 가져오기부터 라우팅 규칙까지, v2rayN 데스크톱 및 안드로이드 클라이언트 설정 방법을 살펴보고 필요에 따라 프록시 모드와 커널을 선택하세요.

  • Xray 커널
  • V2Fly 커널
  • GPL-3.0 오픈 소스 클라이언트
  • VMess · VLESS · Trojan · Shadowsocks
CLIENT SETTINGS / 클라이언트 설정

v2rayN 주요 기능

설정 목적에 따라 기능을 살펴보세요. 버전에 따라 메뉴 이름이 달라질 수 있으므로 작업 전에 사용 중인 클라이언트와 커널을 확인하세요.

구독을 사용하면 여러 서버 설정을 한곳에서 업데이트할 수 있습니다. 먼저 구독 그룹 설정에서 이름과 주소를 입력하고 저장한 다음 구독을 업데이트하세요. 이후 해당 그룹에서 서버를 선택하면 됩니다. 링크를 하나씩 붙여 넣는 방식보다 여러 구독 소스를 관리하기 편리하며, 업데이트 실패 범위도 파악하기 쉽습니다. 목록이 비어 있다면 같은 그룹을 반복해서 추가하지 말고 업데이트 로그와 응답 형식, 필터 조건을 확인하세요. 구독 주소에는 보통 접속 정보가 포함되므로 신뢰할 수 있는 기기에만 저장하고, 화면을 공유할 때는 전체 주소를 가리세요.

구독 그룹 설정구독 업데이트서버 필터링

설정 순서는 스위치 개수보다 중요합니다. 먼저 사용할 수 있는 설정을 가져오고 서버를 선택한 다음, 앱 트래픽이 클라이언트로 들어오는 방식을 확인하고 마지막으로 라우팅을 조정하세요. 구독, 트래픽 진입 모드, 라우팅 출구는 서로 다른 계층입니다. 한꺼번에 변경하면 문제를 추적하기 어렵습니다.

프로토콜·구독·라우팅 용어 보기 →
QUICK START / 3단계 빠른 시작

구독 가져오기와 첫 연결

데스크톱에서는 v2rayN을 기준으로 설명합니다. 안드로이드에서 v2rayNG를 사용할 때도 설정 가져오기, 연결 시작, 접속 결과 확인 순서는 같습니다.

01 / IMPORT

구독 그룹 만들기

기기에 맞는 클라이언트를 설치한 뒤 구독 그룹 설정을 여세요. 구독 소스를 쉽게 구분할 수 있는 이름을 입력하고 전체 구독 주소를 붙여 넣어 저장한 다음 구독을 업데이트합니다. 주소는 신뢰할 수 있는 서비스 제공자나 자체 서버 관리자에게 받아야 합니다. 클라이언트는 연결을 관리하는 프로그램이며 사용할 수 있는 서버를 자동으로 만들어 주지는 않습니다.

업데이트가 끝나면 해당 그룹에 서버가 표시되는지 확인하세요. 공유 링크가 하나뿐이라면 클립보드에서 가져오기를 사용하고 구독 주소 입력란에 넣지 마세요. 구독 링크와 단일 노드 링크는 용도가 다르므로 서로 바꾸어 사용하면 가져오기에 실패하거나 목록이 비어 있을 수 있습니다.

처음 설정할 때는 기본값을 유지하세요. 문제를 하나의 그룹과 서버로 한정하면 주소 응답 오류인지, 형식 호환성 문제인지, 연결 매개변수를 다시 확인해야 하는지 판단하기 쉬워집니다.

02 / CONNECT

서버 및 모드 선택

서버 목록에서 하나를 골라 활성 서버로 지정한 뒤 앱에 필요한 트래픽 진입 모드를 설정하세요. 브라우저처럼 시스템 프록시 설정을 따르는 앱은 먼저 시스템 프록시로 연결을 확인할 수 있습니다. 앱 자체에 프록시 설정이 있다면 클라이언트가 실제로 수신 대기 중인 주소와 포트를 앱에 입력해야 합니다.

앱이 프록시 설정을 따르지 않는다면 TUN을 고려하세요. 활성화하기 전에 권한 안내를 읽고 다른 가상 네트워크 어댑터나 네트워크 터널이 트래픽을 처리 중인지 확인하세요. 시스템 프록시와 TUN은 트래픽 진입 방식이며 프록시, 직접 연결 등의 라우팅 출구와는 구분해야 합니다.

안드로이드에서 처음 연결을 시작하면 시스템의 네트워크 연결 권한 요청이 표시되는 경우가 많습니다. 권한을 허용한 뒤에도 백그라운드 실행 제한에 유의하세요. 화면을 잠근 뒤 끊기는 문제와 처음부터 연결되지 않는 문제는 각각 다른 원인으로 점검해야 합니다.

03 / VERIFY

접속 및 로그 확인

먼저 정상 접속이 확인된 사이트에 접속하고 클라이언트 로그에 해당 연결이 표시되는지 확인하세요. 지연 시간 테스트는 참고 자료일 뿐입니다. 서버 주소에 응답이 온다고 해서 프로토콜 핸드셰이크, 도메인 조회, 실제 웹 접속까지 성공한 것은 아닙니다. 실제 사용할 앱으로 접속을 확인하세요.

연결에 실패하면 로컬 네트워크, 구독 유효성, 활성 서버, 트래픽 진입 모드, 라우팅, DNS 순서로 확인하세요. 오류가 발생한 시간과 전체 오류 내용을 기록하되 구독 주소, 사용자 ID, 비밀번호는 공개하지 마세요. 한 번에 하나만 바꾸고 같은 대상으로 다시 테스트하세요.

첫 연결이 정상적으로 확인된 뒤 사용자 지정 라우팅과 서버 필터 조건을 추가하세요. 사용을 마치면 클라이언트가 제공하는 방법으로 시스템 프록시를 해제하거나 TUN을 끄세요. 앱이 이미 수신 대기를 중지한 로컬 포트를 계속 가리키는 일을 방지할 수 있습니다.

PLATFORMS / 다운로드

4개 플랫폼클라이언트 선택

먼저 운영체제를 확인한 다음 프로세서 아키텍처와 설치 파일 형식을 확인하세요. 구체적인 시스템 요구 사항과 릴리스 안내는 다운로드 페이지에서 확인할 수 있습니다.

Windows

v2rayN / 데스크톱 · 클래식 WPF 버전

일반적인 데스크톱 사용에는 v2rayN을 먼저 살펴보세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, 클래식 WPF 버전은 Windows 인터페이스를 사용합니다. 두 버전 모두 서버, 구독, 라우팅 관리 기능을 중심으로 하지만 화면 구성, 종속성, 일부 기능의 위치가 다를 수 있습니다. 가이드의 메뉴 이름은 실제 설치한 버전에 맞춰 확인하세요.

다운로드 전에 시스템 설정에서 기기의 아키텍처와 운영체제 정보를 확인하세요. 처음 실행할 때 구성 요소 관련 안내가 나오면 해당 릴리스 패키지 설명에 따라 필요한 종속성을 설치하세요. 실행 구성 요소가 없다는 이유로 구독을 사용할 수 없다고 판단하지 마세요. TUN을 테스트할 때 권한과 가상 네트워크 어댑터 요건을 별도로 확인하면 됩니다. 일반적인 시스템 프록시 테스트는 먼저 진행할 수 있습니다.

다운로드 페이지로 이동

macOS

v2rayN / Apple Silicon · Intel

데스크톱에서는 v2rayN을 사용할 수 있으며, 설치 파일은 Apple Silicon과 Intel 칩에 따라 구분됩니다. 구입 연도만으로 판단하기보다 ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인하는 편이 정확합니다. 기기 아키텍처에 맞는 설치 파일을 선택하면 실행 환경 차이를 줄일 수 있습니다.

설치 후 클라이언트가 정상적으로 실행되는지 먼저 확인한 다음 구독을 가져오세요. 시스템 프록시 적용 여부는 앱이 시스템 네트워크 설정을 따르는지에 따라 달라집니다. 특정 앱이 기존 네트워크를 계속 사용한다면 앱 자체의 프록시 설정을 먼저 확인하세요. 네트워크 확장, 권한 또는 TUN 관련 작업은 현재 릴리스 패키지 안내와 시스템 메시지를 따르세요. 다른 플랫폼의 절차를 그대로 적용하지 마세요.

다운로드 페이지로 이동

Android

v2rayNG / Xray · v2flyNG / V2Fly

안드로이드에서는 Xray 커널을 사용하는 v2rayNG를 먼저 살펴보세요. V2Fly 커널을 사용하려면 v2flyNG를 확인할 수 있습니다. 두 클라이언트의 설정 지원 범위는 각각 확인해야 합니다. 한 클라이언트에서 노드를 가져올 수 있다고 해서 다른 클라이언트도 같은 전송 및 보안 설정을 지원한다고 단정할 수는 없습니다.

최근 출시된 일반적인 기기에서는 보통 arm64 설치 파일을 사용합니다. 아키텍처를 모른다면 범용 패키지와 기기 안내를 확인하세요. 화면 잠금, 네트워크 전환 또는 장시간 백그라운드 실행 중 연결이 끊긴다면 먼저 시스템의 배터리 관리와 백그라운드 제한을 살펴보세요. 모바일 기기의 배터리 사용량은 신호 품질, 연결 수, 앱 활동에도 영향을 받으므로 프로토콜 이름만으로 전력 소모를 판단할 수 없습니다.

다운로드 페이지로 이동

Linux

v2rayN / deb · rpm

Linux 데스크톱에서는 배포판의 패키지 관리 체계에 맞춰 v2rayN을 선택할 수 있습니다. Debian, Ubuntu 등에서는 보통 deb 패키지를, Fedora 등에서는 rpm 패키지를 사용하며 x64와 arm64도 구분해야 합니다. 패키지 형식과 프로세서 아키텍처는 별개의 조건이므로 모두 기기에 맞아야 합니다.

그래픽 인터페이스가 정상적으로 실행되면 로컬 수신 대기 설정과 앱의 프록시 설정을 먼저 확인하세요. 시스템 프록시 지원 범위는 데스크톱 환경마다 다르며 터미널 도구는 데스크톱 설정을 자동으로 따르지 않을 수 있습니다. TUN을 활성화하기 전에 권한, 라우팅 및 기존 네트워크 서비스를 확인해 여러 트래픽 처리 방식이 동시에 작동하지 않도록 하세요. 종속성 설치와 시스템 요구 사항은 선택한 릴리스 패키지 안내를 따르세요.

다운로드 페이지로 이동

하나의 구독을 여러 기기에서 사용할 때는 서비스에서 허용하는 기기 수와 연결 범위도 확인해야 합니다. 클라이언트를 바꾸면 로컬 관리 방식과 연결 구현은 달라지지만 구독 유효 기간, 서버 매개변수 또는 계정 권한은 바뀌지 않습니다. 먼저 한 기기에서 연결을 확인한 다음 나머지 기기를 차례로 설정하는 것이 좋습니다.

전체 클라이언트 보기 →
CORE LINEAGE / 커널 계보

Project V, V2Fly 및 Xray

생태계, 커널, 그래픽 클라이언트를 구분한 뒤 프로토콜 호환성을 확인하세요. 이름이 비슷해도 설정을 그대로 바꿔 쓸 수 있는 것은 아닙니다.

생태계 기반Project V / V2Ray

프로토콜·전송·라우팅의 기술 기반

커널 계열V2Fly · Xray

연결 처리 및 설정 해석

그래픽 관리 도구v2rayN · v2rayNG · v2flyNG

구독, 서버 및 사용자 조작 관리

생태계 기반과 프로젝트 발전

Project V는 V2Ray 기술 생태계를 이해하는 출발점입니다. 인바운드, 아웃바운드, 전송 및 라우팅을 분리하는 구조로 여러 연결 방식을 조합할 수 있습니다. V2Fly는 V2Ray의 커뮤니티 개발을 이어 왔고, Xray는 관련 코드 기반에서 출발해 공통 기능과 함께 독자적인 발전을 거듭했습니다. 따라서 ‘V2Ray 설정’은 생태계의 일반적인 개념을 가리킬 수도 있고 특정 커널이 읽을 수 있는 설정을 뜻할 수도 있습니다. 안내를 읽을 때 문맥을 확인해야 합니다.

이러한 계보를 이해하면 기본 설정 일부가 비슷하면서도 새 기능의 지원 범위는 다른 이유를 알 수 있습니다. 프로토콜 이름은 첫 번째 확인 항목일 뿐이며 전송 방식, 보안 계층 및 선택 매개변수도 함께 살펴봐야 합니다. 예를 들어 REALITY는 보안 계층과 관련된 기술로, VMess·VLESS와 같은 계층의 선택지처럼 단순히 나란히 비교해서는 안 됩니다. 익숙한 약어만 보고 가져오지 말고 전체 조합의 호환성을 확인하세요.

그래픽 클라이언트와 커널의 역할

v2rayN은 데스크톱에서 서버 목록, 구독 관리 및 매개변수 설정 기능을 제공하고 사용자의 선택을 커널이 실행할 수 있는 설정으로 변환합니다. v2rayNG는 Xray 커널을 사용하는 안드로이드 클라이언트이며, v2flyNG는 V2Fly 커널을 사용하는 안드로이드 클라이언트입니다. 세 클라이언트 모두 오픈 소스 프로젝트지만, 같은 이름의 옵션이라도 커널 기능과 플랫폼별 구현에 따라 동작이 다를 수 있습니다.

화면에서 공유 링크를 인식했다는 것은 파싱 단계가 통과했다는 뜻일 뿐입니다. 시작할 때 커널이 생성된 설정을 받아들이는지, 원격 서버가 해당 기능을 지원하는지는 로그와 실제 연결로 확인해야 합니다. 문제를 진단할 때는 클라이언트와 커널 정보를 따로 기록하세요. 클라이언트가 업데이트되었다고 모든 구성 요소가 업데이트된 것은 아닙니다. 여러 커널을 사용하는 경우 현재 노드가 실제로 어떤 실행 파일을 사용하는지도 확인해야 합니다.

오픈 소스 라이선스와 사용 범위

v2rayN, v2rayNG, v2flyNG는 GPL-3.0 오픈 소스 라이선스를 사용합니다. 오픈 소스 라이선스는 코드의 사용, 수정 및 재배포 조건을 규정합니다. 커널과 기타 종속 구성 요소에는 각각 별도의 라이선스가 있으므로 따로 확인해야 합니다. 클라이언트를 무료로 사용할 수 있는지와 원격 서비스에 요금이 부과되는지는 별개의 문제입니다. 클라이언트를 설치한 뒤에도 사용할 권한이 있는 서버 설정이 필요합니다.

오픈 소스 프로젝트는 공개된 코드와 커뮤니티 협업을 통해 발전하지만 실제 동작은 기기 환경, 설정 출처 및 서버 상태에 따라 달라집니다. 사용하기 전에 적용되는 현지 법규, 네트워크 관리 정책 및 서비스 제공자의 약관을 확인하세요. 이 사이트는 다운로드 경로와 한국어 기술 정보를 제공하며 구독 계정을 제공하지 않습니다. 특정 프로토콜을 특정 서비스 품질과 동일시하지 않습니다.

업데이트 방식과 호환성 확인

업데이트에 따라 인터페이스 배치, 설정 필드, 커널 동작 또는 시스템 종속성이 달라질 수 있습니다. 업그레이드 전에 해당 릴리스 안내를 읽고 기존 설정을 백업하세요. 업그레이드 후에는 이전과 같은 대상으로 연결 및 라우팅을 확인해야 합니다. 기기 간 설정을 옮길 때는 대상 클라이언트가 지원하는 공유 링크나 구독 형식을 우선 사용하세요. 설정 파일 전체를 그대로 복사하면 다른 플랫폼 전용 경로, 수신 대기 또는 라우팅 설정이 포함될 수 있습니다.

구독 형식도 모두 호환되는 것은 아닙니다. 단일 노드 공유 링크, 인코딩된 링크 목록, 전체 설정 파일은 용도가 서로 다릅니다. 형식이 맞지 않으면 먼저 제공자에게 적합한 형식으로 내보낼 수 있는지 문의하세요. 접속 정보가 포함된 구독을 낯선 온라인 변환 서비스에 맡기면 주소 노출 범위가 커집니다. 변환이 필요하다면 유지해야 하는 필드를 먼저 확인한 뒤 대상 커널의 지원 여부를 살펴보세요.

현재 문제가 ‘구독 업데이트 실패’, ‘브라우저는 되지만 다른 앱은 안 됨’, ‘TUN을 켠 뒤 로컬 네트워크에 접속할 수 없음’이라면 바로 재설치하지 말고 증상에 따라 문제 계층을 먼저 찾으세요. 도움말 센터는 기본 개념, 설치 및 설정, 활용 팁, 문제 해결 순으로 구성되어 있어 설정 과정에서 빠르게 참고할 수 있습니다.

도움말 센터로 이동 →
FIELD NOTES / 설정 가이드

구독 관리와 라우팅 실전

자주 쓰는 기능부터 설정 원리까지 살펴봅니다. 문제를 재현한 다음 글에서 안내하는 순서대로 하나씩 확인하세요.

구독 그룹 관리: v2rayN 서버 필터링 및 여러 서비스의 노드 정리 방법

v2rayN에서 여러 구독 그룹을 만들고 키워드로 서버를 필터링하며 중복 항목을 정렬하는 방법을 소개합니다. 여러 서비스의 노드 목록을 보기 좋고 관리하기 쉽게 정리할 수 있습니다.

구독 소스가 많거나 서버 이름이 중복되거나 업데이트 후 노드를 찾기 어려운 경우에 유용합니다. 원본 구독 내용과 로컬 필터링 결과를 구분한 다음 정리 방법을 조정하세요. 숨겨진 서버를 업데이트 과정에서 사라진 것으로 오해하지 않도록 주의하세요.

글 읽기 →

V2Ray 사용자 지정 라우팅 규칙: domain·ip·geosite 문법과 우선순위

domain, full, regexp, ip, geosite 규칙 작성법을 하나씩 설명하고, 규칙이 위에서 아래로 적용되는 순서와 프록시·직접 연결·차단의 선택 기준을 안내합니다.

정상적으로 연결한 뒤 특정 도메인이나 로컬 네트워크 주소의 경로를 따로 설정하려는 사용자에게 적합합니다. 대상과 규칙 위치를 확인하고 도메인 조회 정책이 이후 주소 매칭에 어떤 영향을 주는지 살펴보세요.

글 읽기 →

V2Ray 초보자 질문 10가지: 클라이언트 선택, 구독 가져오기, 연결 문제 점검

초보자가 자주 묻는 10가지 질문에 답합니다. 클라이언트 선택, 구독 가져오기, 모드 전환 및 연결 실패 시 점검 순서를 다루며 각 항목에 관련 페이지를 안내합니다.

설치 후 다음에 무엇을 해야 할지 막막한 사용자에게 적합합니다. 클라이언트와 서비스의 차이부터 살펴보고 트래픽 진입 모드, 라우팅 출구, 서버 설정의 기본 관계를 이해한 뒤 세부 설정으로 넘어가세요.

글 읽기 →