v2rayNG · v2rayN 클라이언트

V2Ray 모바일 안드로이드·데스크톱 클라이언트 다운로드

v2rayN 다운로드 사용 가이드 보기

구독 가져오기부터 라우팅까지 클라이언트 설정 순서대로 진행하고, Xray 코어의 지원 범위를 확인하세요.

오픈소스 그래픽 설정 한국어 문서

클라이언트 다운로드 / 플랫폼

운영체제에 맞는 다운로드 선택

데스크톱에서는 v2rayN, 안드로이드 기기에서는 v2rayNG를 먼저 확인하세요. 설치 파일을 고르기 전에 CPU 아키텍처와 패키지 형식을 확인한 뒤 인터페이스와 코어 지원 범위를 살펴보세요. 같은 구독을 가져올 수 있어도 모든 프로토콜 조합이 현재 기기에서 작동하는 것은 아닙니다.

Windows

v2rayN은 데스크톱용과 클래식 WPF 버전을 제공하며, 각각 크로스 플랫폼 인터페이스와 익숙한 데스크톱 조작 방식을 지원합니다. 처음 설치한다면 두 버전의 차이를 살펴보고 시스템 요구 사항을 확인하세요. 기존 설정이 있는 기기에서는 업그레이드 전에 설정을 내보내고 구독 그룹과 사용자 지정 라우팅을 기록해 두면 인터페이스 이전 문제와 연결 문제를 구분하기 쉽습니다.

다운로드 페이지로 이동

macOS

v2rayN을 사용할 때는 먼저 ‘이 Mac에 관하여’에서 칩 종류를 확인한 뒤 Apple Silicon 또는 Intel용 설치 파일을 선택하세요. 노드를 가져온 후 시스템 프록시는 시스템 설정을 따르는 앱의 트래픽을 로컬 프록시로 보냅니다. 별도로 프록시를 설정하는 앱은 클라이언트 연결 상태만 볼 것이 아니라 앱 자체의 네트워크 옵션도 확인해야 합니다.

다운로드 페이지로 이동

Android

Xray 코어를 사용하는 v2rayNG를 우선 추천하며, V2Fly 코어 기반 v2flyNG는 대안으로 선택할 수 있습니다. 대부분의 최신 스마트폰은 arm64를 선택하면 됩니다. 아키텍처를 모른다면 시스템 정보를 먼저 확인하세요. 처음 연결할 때는 시스템 VPN 권한을 승인해야 합니다. 장시간 백그라운드 실행은 배터리 최적화, 백그라운드 제한, 네트워크 전환의 영향을 받으므로 화면이 켜진 상태에서 연결됐다는 이유만으로 안정적이라고 판단할 수 없습니다.

다운로드 페이지로 이동

Linux

v2rayN은 배포판별 deb 및 rpm 패키지를 제공하며 x64와 arm64를 구분합니다. 패키지 형식, CPU 아키텍처, 데스크톱 환경을 각각 확인하세요. 데스크톱 환경의 시스템 프록시 설정이 터미널이나 백그라운드 서비스에 적용되지 않을 수 있습니다. 연결을 확인할 때는 어떤 앱이 요청을 보냈는지 파악하고 실제로 로컬 프록시를 사용하는지 점검하세요.

다운로드 페이지로 이동

클라이언트 설치와 연결 설정은 별개입니다. 클라이언트를 설치한 뒤에도 유효한 구독 주소나 노드 매개변수가 필요합니다. 클라이언트는 설정을 저장하고 코어를 실행하며 로컬 프록시를 관리하고, 구독은 원격 연결 정보를 제공합니다. 흔히 말하는 ‘V2Ray 구독’은 구독 서비스에 해당하며 설치 파일에 포함된 기능이나 계정이 아닙니다. 가져오기 전에 주소의 출처와 유효 기간, 사용 가능한 기기 범위를 확인하세요.

재현 가능한 설정부터 시작하세요. 처음 설정할 때는 구독 그룹 하나만 가져오고 노드 하나와 기본 라우팅 프리셋을 선택하거나 내용을 정확히 이해한 프리셋을 사용하세요. 원하는 사이트에 정상적으로 접속되는 것을 확인한 다음 사용자 지정 라우팅, 앱별 프록시, 백그라운드 설정을 추가하세요. 문제가 생기면 검증된 조합으로 돌아갈 수 있어 설치 파일, 노드, 코어, 규칙을 한꺼번에 의심하지 않아도 됩니다.

전체 클라이언트 보기 →

설정 가이드 / 워크플로

구독·라우팅·프록시 설정

그래픽 클라이언트에서는 연결 매개변수, 트래픽 경로, 시스템 프록시 설정이 서로 다른 메뉴에 있습니다. 구독 업데이트는 노드 정보를 새로 가져오고, 라우팅 규칙은 직접 연결과 프록시 중 경로를 정하며, 시스템 프록시는 일부 앱의 요청을 클라이언트로 전달합니다. 서로 연동되지만 대체할 수는 없습니다. 먼저 어느 부분을 바꿔야 하는지 정한 뒤 해당 설정으로 이동하세요.

자주 사용하는 설정 메뉴 다섯 가지를 소개합니다. 클라이언트마다 메뉴 이름은 조금씩 다를 수 있으며, 데스크톱의 시스템 프록시와 Android의 VPN 연결은 서로 다른 방식입니다. 스위치 색상만 보지 말고 실제 접속 결과와 로그를 함께 확인하세요. 프로토콜, 전송 또는 보안 매개변수는 서버에서 제공한 전체 설정을 기준으로 해야 합니다.

그룹을 만든 뒤 구독 업데이트

구독 주소는 여러 노드를 가져오는 데 사용되며, 단일 노드 공유 링크와는 다릅니다. v2rayN에서는 구독 그룹을 만들고 주소를 입력해 저장한 다음 업데이트를 실행하세요. v2rayNG에서는 구독 설정에서 해당 그룹을 선택해 작업합니다. 가져온 뒤 그룹 이름, 노드 프로토콜, 응답 결과를 확인하세요. 주소를 저장했다고 해서 노드를 가져온 것은 아닙니다. 목록이 비어 있으면 클라이언트를 반복해서 재설치하기보다 링크 유효 기간, 응답 형식, 업데이트 시 연결 설정을 먼저 확인하세요. 그룹을 나누어 관리하면 출처별로 구분할 수 있어 업데이트나 삭제의 영향을 파악하기 쉽습니다.

클립보드에서 가져오기구독 그룹구독 업데이트
가이드 보기 →

오픈소스 배경 / 생태계

Project V 생태계와 코어 계열

클라이언트, 코어, 프로토콜은 서로 다른 계층입니다. 세 가지를 구분해 이해하면 다운로드 대상과 호환 범위, 설정 위치를 더 정확하게 판단할 수 있습니다.

V2Fly
V2Ray 코어를 이어받은 커뮤니티 개발 계열입니다.
Xray
독자적인 방향으로 발전하는 코어 분기입니다.
v2rayN
데스크톱 플랫폼용 그래픽 설정 및 관리 도구입니다.
v2rayNG
Xray 코어를 사용하는 Android 클라이언트입니다.
v2flyNG
V2Fly 코어를 사용하는 Android 대안입니다.
오픈소스 라이선스
코어와 그래픽 클라이언트는 각각 별도의 라이선스를 따릅니다.

Project V에서 두 코어로

Project V는 프록시 통신 도구를 중심으로 형성된 오픈소스 생태계이며, V2Ray는 그 핵심 프로젝트 중 하나입니다. V2Fly는 V2Ray 코어의 커뮤니티 개발을 이어 왔고, Xray는 관련 코드 기반에서 출발해 독자적으로 발전하는 분기가 됐습니다. 두 코어는 일부 개념과 설정 방식을 공유하지만 각자 기능을 추가하고 구현을 조정해 왔습니다. 따라서 ‘둘 다 V2Ray 생태계에 속한다’는 말은 역사적 관계를 이해하는 데는 적절하지만, 설정을 완전히 서로 바꿔 쓸 수 있다는 근거는 아닙니다.

코어는 프로토콜, 전송, 보안 핸드셰이크, 라우팅, 아웃바운드 등을 처리하고 그래픽 클라이언트는 이를 조작 가능한 설정 화면으로 제공합니다. ‘지원하지 않는 설정 항목’이나 시작 오류가 발생하면 현재 사용 중인 코어와 기능 범위를 먼저 확인하세요. 그래픽 인터페이스 테마를 바꾸거나 같은 구독을 다시 가져오는 것만으로는 코어 기능 불일치가 해결되지 않는 경우가 많습니다.

코어를 선택할 때는 서버에서 제공한 매개변수 조합을 먼저 확인하고 클라이언트가 해당 매개변수를 빠짐없이 설정할 수 있는지 살펴보세요. REALITY는 연결 보안과 관련된 기술이므로 이름만 보고 독립적인 프록시 프로토콜로 간주해서는 안 됩니다. 일반적인 설정에서는 VLESS 및 구체적인 전송 방식과 함께 사용됩니다. 프로토콜 이름이 같더라도 전송, 보안, 확장 매개변수가 다르면 실제 호환 결과가 달라질 수 있습니다.

그래픽 클라이언트와 라이선스 범위

v2rayN, v2rayNG, v2flyNG는 모두 오픈소스 방식으로 개발되지만 같은 프로그램을 달리 부르는 이름은 아닙니다. v2rayN은 데스크톱 사용 흐름에 맞춰 서버 목록, 구독 그룹, 매개변수 설정 등의 관리 화면을 제공합니다. Android에서는 시스템 VPN 권한, 백그라운드 실행, 앱별 트래픽 범위 등 모바일 운영체제의 기능도 함께 고려해야 합니다. 플랫폼 간에 설정을 옮길 때는 메뉴 위치를 그대로 따라 하기보다 필요한 연결 구성을 옮기세요.

라이선스도 계층별로 살펴봐야 합니다. V2Fly의 v2ray-core는 MIT 라이선스, Xray-core는 MPL 2.0을 사용하며 세 그래픽 클라이언트 프로젝트는 GPL-3.0 계열 라이선스를 따릅니다. 배포 패키지에는 다른 의존성이 포함될 수도 있으므로 사용, 수정, 재배포 전에 해당 프로젝트와 구성 요소의 라이선스 파일을 확인하세요. 오픈소스는 코드의 접근 및 사용 규칙을 뜻하며 구독 서비스, 원격 서버, 네트워크 환경까지 클라이언트 프로젝트가 제공한다는 의미는 아닙니다.

일반 사용자는 기기 플랫폼, 필요한 프로토콜, 설정 유지 관리에 드는 수고를 기준으로 선택하면 됩니다. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 확인하고, V2Fly 설정이 필요한 경우 v2flyNG를 검토하세요. 세 클라이언트의 지원 범위는 클라이언트 비교에서 함께 확인할 수 있습니다. 코어 이름만으로 성능 순위를 매길 필요는 없습니다.

앱·구독·규칙은 각각 업데이트

클라이언트, 구독, 규칙 데이터베이스 업데이트는 서로 다른 문제를 해결합니다. 클라이언트 업데이트는 인터페이스와 설정 처리 로직을 수정하거나 코어 기능을 추가할 수 있습니다. 구독 업데이트는 서버가 제공하는 노드 정보를 새로 가져오고, GeoIP·GeoSite 업데이트는 규칙에서 참조하는 데이터 내용을 바꿉니다. 노드 목록을 새로 고쳤다고 해서 클라이언트나 규칙 데이터베이스까지 업데이트된 것은 아닙니다.

업데이트 전에 사용 가능한 노드, 라우팅 프리셋, 사용자 지정 규칙을 기록하고 필요한 설정 백업을 보관하세요. 업데이트 후에는 기존 사용 흐름에 따라 코어가 시작되는지, 구독이 파싱되는지, 앱이 로컬 프록시를 사용하는지, 대상 사이트의 아웃바운드가 예상과 일치하는지 확인하세요. 한 번에 한 종류만 변경해야 동작이 바뀐 원인을 찾기 쉽습니다. 오래된 가이드의 메뉴 이름은 현재 인터페이스와 다를 수 있으니 설정의 기능을 기준으로 메뉴를 찾으세요.

모바일 연결 품질은 무선 신호, 백그라운드 제한, 절전 정책의 영향도 받으므로 배터리 소모나 연결 끊김의 원인을 특정 프로토콜 하나로 단정할 수 없습니다. 비교하려면 기기, 네트워크, 대상 사이트, 사용 시간을 최대한 동일하게 유지하고 연결 성립과 지속 전송을 따로 살펴보세요. 프로토콜 선택, 코어 차이, 구독 형식은 프로토콜 참고 자료에서 확인한 뒤 현재 조합을 변경할지 결정하세요.

연결 성공부터 일상적인 사용까지

처음 연결에 성공한 뒤에는 브라우저에서 대상 사이트에 접속하기, 로컬 네트워크 기기 이용하기, 자주 사용하는 앱의 백그라운드 네트워크 사용 등 세 가지 상황을 확인하세요. 브라우저에서 페이지가 열렸다는 것은 해당 요청 경로가 작동했다는 뜻일 뿐입니다. 다른 앱은 별도 프록시를 사용하거나 직접 연결하고, 도메인을 다른 방식으로 조회할 수 있습니다. 로컬 네트워크 프린터나 공유 폴더에 접근할 수 없다면 모든 트래픽 모드를 바꾸기보다 사설 주소의 직접 연결 규칙을 확인하세요.

장기간 사용할 때는 출처를 알 수 없는 규칙을 계속 추가하기보다 구독 그룹 이름을 명확히 하고 설명이 있는 사용자 지정 규칙을 소수만 유지하는 편이 관리하기 쉽습니다. 변경 전 기존 값을 기록하고 변경 후에는 같은 대상으로 다시 테스트하세요. 예상과 다르면 가장 최근 변경을 먼저 되돌린 뒤 관련 로그를 확인하세요. 구독 목록이 비거나 연결이 끊기거나 라우팅 결과가 잘못되면 도움말 센터의 분류에 따라 점검할 수 있습니다. 클라이언트가 설정을 실행하더라도 안정적인 사용에는 유효한 매개변수, 적절한 규칙, 명확한 검증 절차가 필요합니다.

설정 노트 / 아티클

라우팅 규칙과 데이터베이스 업데이트

아래 글 세 편은 게시일 역순으로 정렬되어 있습니다. 규칙 데이터의 출처와 업데이트부터 매칭 문법, Android 라우팅 적용까지 다룹니다. 읽기 전에 클라이언트와 코어를 확인하고 글에서 설명하는 규칙의 용도를 자신의 설정에 맞춰 보세요. 다른 기기의 규칙을 통째로 기존 설정에 덮어쓰지는 마세요.

규칙 데이터

geoip.dat·geosite.dat 규칙 데이터베이스: 역할, 업데이트 방법과 참조 문법

두 규칙 데이터베이스 파일의 출처와 구조를 소개하고 v2rayN 및 v2rayNG의 업데이트 메뉴를 안내합니다. geosite:분류와 geoip:지역 코드의 참조 문법, 업데이트 후 적용 여부를 확인하는 방법도 설명합니다.

규칙을 저장했는데 실제 라우팅 결과가 예상과 다른 경우에 적합합니다. ‘규칙이 데이터를 참조하는 방식’과 ‘현재 데이터에 대상이 포함되어 있는지’를 나눠 확인한 뒤 데이터베이스를 업데이트할지 매칭 조건을 수정할지 결정하세요.

라우팅

Xray 사용자 지정 라우팅 규칙 작성법: domain·full·regexp·ip·geosite 접두사와 매칭 순서

각 매칭 접두사의 차이와 사용 사례를 정리하고 규칙을 위에서 아래로 검사해 처음 일치하는 규칙을 적용하는 원리를 설명합니다. v2rayN에서 사용자 지정 규칙을 작성하고 조정할 때 활용할 수 있는 템플릿도 제공합니다.

특정 도메인이나 주소 규칙을 추가하려는 사용자에게 적합합니다. 매칭 범위와 순서를 확인하고 정확한 도메인, 접미사 매칭, 분류 참조의 차이를 이해해 포괄적인 조건이 정밀한 조건을 가리는 문제를 줄이세요.

라우팅

v2rayNG 라우팅 설정 실전: 로컬 사이트 직접 연결, 해외 사이트 프록시 규칙 조합

라우팅 프리셋부터 시작해 지역에 따라 직접 연결과 프록시 트래픽을 나누는 방법을 안내합니다. 로컬 네트워크 주소, 광고 도메인, 자주 발생하는 오판을 다루고 마지막으로 라우팅이 적용됐는지 확인하는 방법을 설명합니다.

Android에서 구독을 가져온 뒤 트래픽 경로를 조정하려는 사용자에게 적합합니다. 현재 연결이 정상적으로 작동하는 상태에서 시작해 프리셋과 예외 규칙을 차례로 확인하세요. 노드, DNS, 라우팅을 동시에 바꾸면 문제를 추적하기 어렵습니다.

첫 연결을 아직 완료하지 않았다면 가이드에 따라 가져오기, 선택, 실행, 확인 순서로 진행하세요. 이미 연결할 수 있다면 구체적인 문제에 맞춰 규칙 및 코어 관련 글을 읽으면 됩니다. 구독 업데이트 실패와 메인 화면 안내도 글 목록에서 확인할 수 있어 문제 증상에 맞는 항목을 찾기 쉽습니다.

전체 글 보기 →