v2rayN / v2rayNG / v2flyNG
v2rayN 데스크톱 버전은 Windows, macOS, Linux를 지원하고 v2rayNG, v2flyNG는 Android를 지원합니다. 플랫폼을 전환해 설치 파일 진입점을 확인하세요. 각 카드에는 시스템 요구 사항과 설치 단계가 함께 있습니다. 어떤 것을 골라야 할지 모르겠다면 아래 선택 안내를 먼저 보세요.
v2rayN은 데스크톱 버전과 클래식 WPF 버전 두 가지 압축 패키지를 제공합니다. 프로토콜 지원과 코어가 동일하므로 인터페이스 취향에 따라 하나를 고르면 됩니다.
데스크톱에서 가장 먼저 추천하는 클라이언트입니다. VMess, VLESS, Trojan, Shadowsocks 등 프로토콜을 한 화면에서 관리하고 구독 가져오기, 라우팅 분할, 시스템 프록시 스위치를 모두 메인 창에서 처리합니다. 압축 패키지에 코어 파일이 포함되어 있어 압축을 풀고 바로 실행하면 되며 별도의 실행 환경을 준비할 필요가 없습니다.
데스크톱 버전은 macOS, Linux 버전과 같은 레이아웃을 공유하는 새로운 크로스 플랫폼 인터페이스로 설정 항목의 위치가 세 플랫폼에서 동일합니다. 클래식 WPF 버전은 Windows 네이티브 프레임워크를 기반으로 기존 인터페이스를 유지해 오래 사용해 온 사용자의 적응 부담이 적습니다. 두 패키지 모두 꾸준히 유지 관리되므로 하나를 골라 오래 쓰면 됩니다.
현재 버전 7.24.1 · 압축 해제 후 v2rayN.exe 실행
| 운영 체제 | Windows 10 / Windows 11(64비트) |
|---|---|
| 프로세서 아키텍처 | x64 |
| 권한 | 첫 실행 시 시스템 프록시 설정을 기록하기 위해 관리자 권한으로 실행하는 것을 권장합니다 |
| 네트워크 | 구독 주소에 접속할 수 있는 일반 네트워크 연결 |
| 디스크 | 코어 파일과 실행 로그를 위한 여유 공간 |
D:\v2rayN 같은 고정 디렉터리에 압축을 풉니다.v2rayN은 Apple Silicon과 Intel 칩용 dmg 설치 파일을 각각 제공합니다. 칩을 먼저 확인한 뒤 내려받아 아키텍처를 잘못 설치하는 일을 피하세요.
Windows 버전과 같은 프로젝트로 인터페이스 레이아웃과 설정 항목이 동일하며, 같은 구독을 여러 기기에 복사해 사용할 수 있습니다. dmg를 열고 앱을 '응용 프로그램' 폴더로 끌어다 놓으면 설치가 끝나고, 첫 실행 시 시스템 안내에 따라 '개인 정보 보호 및 보안'에서 열기를 허용하면 됩니다.
칩 선택 방법: 화면 왼쪽 위 애플 메뉴 → '이 Mac에 관하여'를 눌러 '칩' 항목을 확인합니다. Apple M 시리즈가 표시되면 arm64 패키지, Intel이 표시되면 x64 패키지를 내려받으세요. 두 패키지의 기능은 같고 컴파일 아키텍처만 다릅니다. 아키텍처를 잘못 설치하면 앱이 실행되지 않으므로 해당 패키지를 다시 내려받으면 됩니다.
현재 버전 7.24.1 · dmg를 열고 '응용 프로그램'으로 끌어다 놓기
| 운영 체제 | macOS 11 이상 |
|---|---|
| 칩 | Apple Silicon은 arm64 패키지, Intel은 x64 패키지 |
| 설치 방식 | dmg를 열고 앱을 '응용 프로그램' 폴더로 끌어다 놓기 |
| 첫 실행 | '시스템 설정 → 개인 정보 보호 및 보안'에서 열기 허용 |
| 권한 | 시스템 프록시 설정을 기록할 때 시스템 팝업에서 확인 |
Android용 클라이언트는 두 가지입니다. v2rayNG는 Xray 코어, v2flyNG는 V2Fly 코어를 기반으로 하며 두 앱을 동시에 설치해 비교할 수 있습니다.
Android에서 가장 먼저 추천하는 클라이언트로 Xray 코어를 기반으로 하며 VMess, VLESS, Trojan 등 프로토콜과 구독 가져오기를 지원합니다. 노드 목록에서 눌러 바로 전환할 수 있고 라우팅 모드는 설정에서 사용 환경에 맞게 고릅니다. 첫 연결 시 VpnService 권한을 허용해야 하며 알림 표시줄에 상시 알림이 나타납니다.
아키텍처 선택 방법: 2015년 이후 주류 기종은 대부분 arm64 아키텍처이므로 arm64-v8a 패키지가 용량이 작고 실행 효율이 높습니다. 기종이 오래되었거나 아키텍처를 모르겠다면 여러 네이티브 라이브러리를 담아 호환 범위가 넓은 universal 통합 버전을 선택하세요. 클라이언트를 배터리 최적화 예외 목록에 추가해 백그라운드에서 시스템이 정리해 연결이 끊기는 일을 막는 것이 좋습니다.
현재 버전 2.2.6 · 첫 연결 시 VpnService 권한 필요
V2Fly 코어를 기반으로 하는 대안 클라이언트로 인터페이스와 조작 방식이 v2rayNG와 비슷하며 구독 주소와 설정 항목을 서로 그대로 사용할 수 있습니다. 특정 기기에서 한쪽에 호환성 문제가 생기면 다른 쪽으로 바꿔 비교하는 것이 문제 해결의 첫 단계입니다.
두 클라이언트는 패키지 이름이 달라 한 기기에 동시에 설치할 수 있습니다. 같은 구독으로 각각 테스트해 연결 결과가 같다면 문제는 클라이언트가 아니라 노드 쪽일 가능성이 큽니다. 일상적으로는 한 가지만 골라 쓰면 되고 두 개를 오래 유지할 필요는 없습니다.
현재 버전 1.10.31 · v2rayNG와 동시 설치 가능
| 운영 체제 | Android 8.0 이상 |
|---|---|
| 프로세서 아키텍처 | 2015년 이후 주류 기종은 arm64-v8a, 확실하지 않으면 universal 통합 버전 |
| 권한 | 첫 연결 시 VpnService 권한을 허용해야 하며 알림 표시줄에 상시 알림이 나타남 |
| 백그라운드 실행 | 배터리 최적화 예외 목록에 추가해 시스템 정리를 피하는 것이 좋음 |
| 네트워크 | 구독 주소에 접속할 수 있는 일반 네트워크 연결 |
v2rayN은 Debian 계열과 Red Hat 계열 배포판을 아우르는 deb와 rpm 두 가지 패키지 형식을 제공합니다. x64가 기본 진입점이고 arm64는 작은 글씨 링크로 안내합니다.
Windows, macOS 버전과 같은 프로젝트로 인터페이스와 설정 항목이 동일합니다. deb는 Debian, Ubuntu, Linux Mint 등에, rpm은 Fedora, RHEL, openSUSE 등에 사용합니다. 설치와 업그레이드, 삭제를 패키지 관리자가 일괄 기록하므로 장기 사용에 적합합니다.
설치 후 애플리케이션 메뉴나 런처에서 v2rayN을 실행하고 구독을 가져와 노드를 선택한 뒤 시스템 프록시를 켜는 흐름은 데스크톱 버전과 같습니다. 실행에는 그래픽 데스크톱 환경(X11 또는 Wayland)이 필요하며, 순수 명령줄 서버 환경에서는 이 그래픽 클라이언트를 그대로 사용하기 어렵습니다.
arm64 아키텍처 설치 파일: deb 패키지 rpm 패키지
현재 버전 7.24.1 · 설치 후 애플리케이션 메뉴에서 실행
| 배포판 | deb：Debian / Ubuntu / Linux Mint；rpm：Fedora / RHEL / openSUSE |
|---|---|
| 프로세서 아키텍처 | x64가 기본 진입점, arm64 설치 파일 별도 제공 |
| 데스크톱 환경 | 그래픽 데스크톱 환경 필요(X11 또는 Wayland) |
| 권한 | 시스템 프록시 설정을 기록할 때 배포판 안내에 따라 권한 승인 |
| 의존성 | 설치 과정에서 패키지 관리자 안내에 따라 런타임 라이브러리 의존성 보완 |
cat /etc/os-release를 실행해 ID와 ID_LIKE 필드를 봅니다.sudo dpkg -i 설치파일.deb, Red Hat 계열은 sudo dnf install ./설치파일.rpm을 실행합니다.설치 파일 형식
내려받기 전에 확장자를 확인하면 잘못 설치해 되돌아오는 수고를 줄일 수 있습니다.
v2rayN의 Windows 패키지는 압축 파일로, 고정 디렉터리에 풀고 메인 프로그램을 실행합니다. 프로그램과 코어, 설정이 모두 그 디렉터리에 저장되므로 새 기기로 옮길 때 디렉터리 전체를 복사하면 그대로 사용할 수 있습니다.
디스크 이미지 형식입니다. 열어서 앱을 '응용 프로그램'으로 끌어다 놓은 뒤 이미지를 추출합니다. 설정 파일은 사용자 디렉터리에 저장되므로 앱 본체를 교체해도 이미 가져온 구독에는 영향이 없습니다.
두 가지 배포판 패키지 형식입니다. deb는 Debian 계열 패키지 관리자에, rpm은 Red Hat 계열에 맡깁니다. 설치와 업그레이드, 삭제가 모두 패키지 관리자에 기록되어 버전 상태를 한눈에 볼 수 있습니다.
Android 설치 파일입니다. arm64-v8a는 최근 주류 기종에 대응하고, universal 통합 버전은 여러 네이티브 라이브러리를 포함해 더 오래된 기기까지 지원합니다. 두 클라이언트는 한 기기에 동시에 설치할 수 있습니다.
선택 안내
세 가지 클라이언트가 네 종류 시스템을 커버합니다. 데스크톱은 한 프로젝트로 모두 해결하고, Android는 대안이 하나 더 있습니다.
다음 단계
설치만으로는 시작일 뿐이고 구독을 가져와야 실제로 사용할 수 있습니다.
다운로드 자주 묻는 질문
패키지 선택, 아키텍처, 권한, 업그레이드는 다운로드 전후에 가장 자주 막히는 지점입니다.
두 패키지는 같은 프로젝트에 속하며 프로토콜 지원과 코어가 동일하고 모두 꾸준히 업데이트됩니다. 데스크톱 버전은 Windows, macOS, Linux가 같은 레이아웃을 공유하는 새로운 크로스 플랫폼 인터페이스로 설정 항목 위치가 세 플랫폼에서 같습니다. 클래식 WPF 버전은 Windows 네이티브 프레임워크를 기반으로 기존 인터페이스를 유지해 오래 사용한 사용자의 적응 부담이 적습니다.
새 인터페이스를 원하면 데스크톱 버전, 기존 조작 습관을 유지하려면 WPF 버전을 선택하세요. 하나를 골라 오래 쓰면 되고 두 패키지를 함께 보관할 필요는 없습니다.
2015년 이후 주류 기종은 대부분 arm64 아키텍처이므로 arm64-v8a 패키지를 우선 선택하세요. 용량이 작고 실행 효율이 높습니다. 기종이 오래되었거나 아키텍처를 모르겠다면 여러 네이티브 라이브러리를 포함해 호환 범위가 넓은 universal 통합 버전을 선택하세요.
두 Android 클라이언트 모두 이 두 패키지를 제공합니다. 잘못 골랐다면 다른 패키지로 다시 설치하면 되고 이미 가져온 구독은 사라지지 않습니다.
화면 왼쪽 위 애플 메뉴를 눌러 '이 Mac에 관하여'를 열고 '칩' 항목을 봅니다. Apple M 시리즈가 표시되면 arm64 패키지, Intel이 표시되면 x64 패키지를 선택하세요. 두 패키지는 인터페이스와 기능에 차이가 없고 컴파일 아키텍처만 다릅니다.
아키텍처를 잘못 설치하면 앱이 실행되지 않습니다. 해당 패키지를 다시 내려받아 교체하면 되고 구독과 설정에는 영향이 없습니다.
배포판 계열을 확인하세요. Debian, Ubuntu, Linux Mint 등은 deb 패키지, Fedora, RHEL, openSUSE 등은 rpm 패키지를 사용합니다. 확실하지 않다면 터미널에서 cat /etc/os-release를 실행해 ID와 ID_LIKE 두 필드를 보면 판단할 수 있습니다.
x64 기기는 카드 위쪽 두 버튼, arm64 기기는 카드 아래쪽 작은 글씨 링크를 사용합니다. 두 아키텍처의 패키지 기능은 동일합니다.
필요 없습니다. v2rayN 설치 패키지에는 실행에 필요한 코어 파일이 포함되어 있고 v2rayNG는 Xray 코어, v2flyNG는 V2Fly 코어를 사용하며 클라이언트가 시작할 때 자동으로 호출하므로 그래픽 인터페이스에서 모든 일상 작업을 처리할 수 있습니다.
코어를 따로 교체하는 것은 설정 파일 필드 대응 관계를 다루는 고급 작업이며 일상적인 사용에서는 처리할 필요가 없습니다.
새 패키지를 원래 디렉터리에 압축 해제하거나 설치하면 클라이언트가 기존 설정 파일을 계속 읽습니다. 구독과 노드는 보통 다시 추가할 필요가 없습니다.
안전을 위해 업그레이드 전에 설정 디렉터리를 복사해 백업해 두면 문제가 생겼을 때 이전 버전으로 빠르게 되돌릴 수 있습니다.