v2rayN 우선 권장
7.24.1두 다운로드 항목 모두 x64 압축 파일입니다. 데스크톱 버전은 차세대 크로스 플랫폼 UI를 사용하고, 클래식 WPF 버전은 Windows 전용의 안정적인 클래식 버전입니다. 처음 사용한다면 데스크톱 버전을 먼저 선택하고, 기존 사용 방식에 익숙하다면 전환 여부를 결정하세요.
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 권장합니다. 먼저 운영체제를 확인한 다음 CPU 아키텍처에 맞는 설치 파일을 선택하세요.
무료 오픈 소스 클라이언트입니다. 연결하려면 사용 권한이 있는 구독 또는 노드 설정을 별도로 가져와야 합니다.
설치 파일 선택
플랫폼 선택은 주소창에 반영되어 저장하거나 공유하기 쉽습니다. 버전 정보는 각 클라이언트 카드에서 확인하고, 다운로드 전에 패키지 형식과 아키텍처도 함께 확인하세요.
두 다운로드 항목 모두 x64 압축 파일입니다. 데스크톱 버전은 차세대 크로스 플랫폼 UI를 사용하고, 클래식 WPF 버전은 Windows 전용의 안정적인 클래식 버전입니다. 처음 사용한다면 데스크톱 버전을 먼저 선택하고, 기존 사용 방식에 익숙하다면 전환 여부를 결정하세요.
| 확인 항목 | 이 페이지의 설치 파일 요구 사항 | 확인 위치 |
|---|---|---|
| 시스템 및 아키텍처 | Windows x64. 지원되는 시스템 버전은 선택한 배포 패키지의 요구 사항을 확인하세요. | 설정 → 시스템 → 시스템 정보에서 시스템 종류 확인 |
| 런타임 | 배포 패키지에 따라 다릅니다. 런타임이 없으면 실행 안내에 따라 해당 아키텍처 구성 요소를 설치하세요. | 최초 실행 안내 및 애플리케이션 오류 메시지 |
| 디렉터리 권한 | 프로그램 및 설정 디렉터리에 쓰기 권한이 필요합니다. 압축 파일은 먼저 전체 압축을 풀어야 합니다. | 압축 해제 대상 폴더의 속성 및 접근 권한 |
먼저 시스템 정보에서 시스템 종류가 x64 기반 프로세서인지 확인하세요. 시스템에 ARM이라고 표시된다면 ‘64비트’라는 문구만 보고 이 페이지의 x64 패키지를 선택하지 마세요. 기기의 앱 호환 조건을 먼저 확인해야 합니다. 이 페이지의 두 항목은 x64 환경용이며, 프로세서 이름만으로 다른 아키텍처의 설치 파일을 추측해서는 안 됩니다.
다운로드가 완료되면 압축 파일 전체를 고정된 쓰기 가능 폴더에 풀고, 그 안의 설치 또는 실행 프로그램을 실행하세요. 압축 프로그램의 미리보기 창에서 바로 실행하거나 실행 파일 하나만 꺼내지 마세요. 프로그램이 같은 폴더의 구성 요소를 읽을 수 있으며, 임시 경로에 압축을 풀면 이후 설정 위치를 찾기 어려울 수 있습니다.
처음 실행할 때는 기본 수신 대기 설정을 유지하고 구독을 가져와 서버를 선택한 다음, 안내에 따라 시스템 프록시를 설정하세요. 데스크톱 버전과 WPF 버전을 동시에 실행하면 로컬 수신 대기 포트를 두고 충돌할 수 있습니다. 버전을 전환하기 전에 기존 프로세스를 종료하고 설정을 저장하세요. 두 프로그램 파일을 같은 폴더에 섞어 덮어쓰지 마세요.
실행할 때 런타임 구성 요소가 없다는 안내가 표시되면 구성 요소 이름, 버전, 아키텍처를 기록한 뒤 설치하세요. 실행 실패를 모두 런타임 문제로 단정하지 마세요. 폴더에 쓰기 권한이 없거나, 파일 압축이 완전히 풀리지 않았거나, 이전 프로세스가 포트를 점유한 경우에도 오류가 발생할 수 있습니다. 자세한 절차는 설치 및 최초 실행 가이드에서 확인하세요. 두 UI의 차이는 데스크톱 버전과 WPF 버전 비교를 참고하세요.
크로스 플랫폼 데스크톱 UI를 사용하며 DMG 설치 파일 두 가지를 제공합니다. Apple 메뉴의 ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인한 뒤 해당 항목을 선택하세요.
| 확인 항목 | 이 페이지의 설치 파일 요구 사항 | 확인 위치 |
|---|---|---|
| 프로세서 | Apple Silicon은 arm64, Intel은 x64에 해당합니다. | Apple 메뉴 → 이 Mac에 관하여 |
| 시스템 버전 | 현재 배포 패키지의 최소 시스템 요구 사항을 충족해야 합니다. 구형 시스템은 호환성을 먼저 확인하세요. | ‘이 Mac에 관하여’에 표시된 macOS 버전 |
| 설치 권한 | 응용 프로그램 폴더에 쓸 권한이 필요합니다. 추가 네트워크 기능은 안내에 따라 권한을 부여하세요. | 시스템 설정의 개인정보 보호 및 보안, 네트워크 관련 설정 |
DMG를 열고 설치 창의 안내에 따라 앱을 응용 프로그램 폴더로 옮긴 다음, 응용 프로그램 폴더에서 실행하세요. 디스크 이미지 안에서 계속 실행하면 이미지를 꺼낸 뒤 프로그램을 찾지 못할 수 있습니다. 설치가 끝나고 설치 창을 닫은 후 해당 디스크 이미지를 꺼내세요. 다운로드한 DMG는 필요에 따라 백업해 두면 됩니다.
시스템 보안 안내가 표시되면 안내가 가리키는 파일이 방금 다운로드한 클라이언트인지 먼저 확인하고, 전체 사유를 살펴본 뒤 시스템에서 제공하는 앱별 처리 방법을 이용하세요. 앱 하나를 실행하기 위해 보안 기능을 전역으로 끄지 마세요. 시스템 버전이 요구 사항을 충족하지 않는다면 권한을 반복해서 부여하기보다 호환성 문제부터 해결해야 합니다.
처음 실행한 뒤 구독을 가져오고 서버를 선택한 다음 연결 로그를 확인하고, 필요한 프록시 방식을 활성화하세요. 시스템 프록시는 해당 설정을 따르는 앱에 주로 영향을 주며, 모든 프로세스가 같은 연결 경로를 사용하는 것은 아닙니다. 브라우저는 접속되지만 다른 앱에서 실패한다면 각 앱의 네트워크 설정을 따로 확인하세요.
Intel 기기에서 Apple Silicon 기기로 옮길 때는 새 기기의 칩에 맞는 프로그램 패키지를 다시 선택해야 합니다. 설정도 클라이언트에서 지원하는 내보내기 및 가져오기 기능으로 이전하세요. 완료 후 로컬 포트, 라우팅, DNS를 다시 확인하고 기존 기기의 네트워크 권한이 그대로 이전된다고 가정하지 마세요. 기본 연결 순서는 구독 가져오기 가이드를 참고하세요.
Xray 코어를 사용합니다. 처음 설치할 클라이언트로 우선 고려해 보세요. 구독을 가져와 설정을 선택한 다음 메인 화면의 연결 버튼을 눌러 연결하면 됩니다.
V2Fly 코어를 사용합니다. 이 코어 환경이 필요한 경우에 적합합니다. 전환하기 전에 구독의 프로토콜, 전송 방식, 매개변수 호환성을 확인하세요.
| 확인 항목 | 이 페이지의 설치 파일 요구 사항 | 확인 방법 |
|---|---|---|
| 시스템 호환성 | Android 버전이 선택한 APK의 요구 사항을 충족해야 합니다. | 설정 → 휴대전화 정보에서 Android 버전 확인 |
| 앱 아키텍처 | arm64 패키지는 시스템에서 해당 ABI를 지원해야 합니다. 범용 버전에는 여러 아키텍처용 구성 요소가 포함됩니다. | 기기 사양을 확인하고, 아키텍처를 모르면 범용 버전을 시도하세요. |
| 설치 권한 | APK를 설치할 때 현재 사용하는 브라우저 또는 파일 관리자에 설치 권한을 부여해야 할 수 있습니다. | 실제로 설치에 사용할 앱에만 권한을 허용하세요. |
| 연결 권한 | 처음 연결할 때 시스템 VPN 요청을 승인해야 합니다. 다른 VPN 앱과 충돌할 수 있습니다. | 시스템 안내를 확인하고 실행 중인 다른 연결을 중지하세요. |
다운로드 기록 또는 파일 관리자에서 APK를 여세요. 시스템에서 설치 권한을 요청하면 현재 사용하는 브라우저나 파일 관리자에만 해당 권한을 허용하고, 설치 후 필요에 따라 권한을 해제할 수 있습니다. 파싱 오류가 표시되면 먼저 다운로드가 완료되었는지 확인하고 Android 버전과 아키텍처를 점검하세요. 파일 확장자를 바꿔 안내를 우회하지 마세요.
arm64는 앱 아키텍처를 나타내며 시스템 버전과는 다릅니다. 일부 기기는 프로세서가 64비트를 지원해도 설치된 시스템은 일부 앱 아키텍처만 지원할 수 있으므로, 구입 연도만으로 판단할 수 없습니다. 범용 버전은 다양한 기기에서 사용할 수 있지만 프로토콜 기능을 늘려 주거나 오래된 시스템 버전 문제를 해결하지는 않습니다.
설치 후 구독을 추가하거나 공유 링크를 가져오고, 설정을 업데이트한 다음 연결할 서버를 선택하세요. 처음 연결 버튼을 누르면 시스템에서 VPN 연결 권한을 요청합니다. 클라이언트가 트래픽을 처리하기 위해 필요한 시스템 권한입니다. 다른 VPN 앱이 실행 중이라면 먼저 중지한 뒤 현재 클라이언트를 실행해 연결이 서로 바뀌는 일을 방지하세요.
연결 후 화면을 잠글 때 자주 끊긴다면 배터리 최적화, 백그라운드 실행, 네트워크 전환 설정을 확인하세요. 현재 클라이언트와 관련된 옵션만 조정하면 되며, 모든 앱을 백그라운드 허용 목록에 추가할 필요는 없습니다. v2rayNG와 v2flyNG의 라우팅, DNS, 고급 매개변수는 각각 확인해야 합니다. 구독을 가져올 수 있다는 이유만으로 동작이 완전히 같다고 볼 수는 없습니다.
그래픽 데스크톱 환경용입니다. 먼저 배포판의 패키지 형식을 확인하고 x64와 arm64 중에서 선택하세요. 패키지 형식이 같더라도 모든 배포판 버전에 바로 설치할 수 있는 것은 아닙니다.
arm64 기기용 대안입니다. 먼저 시스템 아키텍처가 arm64 / aarch64인지 확인한 다음 배포판에 맞게 선택하세요.
| 확인 항목 | 이 페이지의 설치 파일 요구 사항 | 확인 위치 |
|---|---|---|
| 데스크톱 환경 | 그래픽 앱을 실행할 수 있는 데스크톱 세션과 관련 종속성이 필요합니다. | 시스템 설정에서 배포판 및 데스크톱 정보 확인 |
| 패키지 관리 체계 | deb와 rpm은 각각 해당 체계에서 사용하며, 구체적인 종속성은 패키지 관리자가 확인합니다. | 배포판의 소프트웨어 설치 프로그램 및 패키지 정보 |
| CPU 아키텍처 | amd64 / x86_64는 x64를, arm64 / aarch64는 arm64를 선택하세요. | 시스템 정보의 하드웨어 또는 아키텍처 항목 |
| 네트워크 권한 | 일반 프록시와 TUN은 필요한 권한이 다릅니다. 먼저 기본 연결을 확인하세요. | 클라이언트 로그 및 시스템 권한 안내 |
다운로드한 패키지를 배포판의 소프트웨어 설치 프로그램으로 열고 종속성 확인 결과를 살펴보세요. deb와 rpm은 서로 다른 패키징 체계이므로 파일 확장자를 바꿔 서로 전환할 수 없습니다. 종속성 누락이나 버전 충돌이 발생하면 먼저 배포판과 버전이 패키지 요구 사항을 충족하는지 확인하세요. 종속성을 무시하고 설치를 강행하지 마세요.
같은 rpm 체계를 사용하는 배포판이라도 시스템 라이브러리 버전은 다를 수 있습니다. 파일명의 빌드 표시는 모든 rpm 시스템과 호환된다는 보장이 아닙니다. 소프트웨어 설치 프로그램이 설치를 거부하면 전체 안내를 보관하고 아키텍처 불일치, 종속성 버전 부족, 패키지 관리 상태 오류 중 무엇인지 구분한 뒤 다음 조치를 결정하세요.
설치가 끝나면 데스크톱 앱 메뉴에서 v2rayN을 실행하세요. 먼저 설정을 가져오고 서버를 선택한 다음 일반 프록시 연결을 확인하고, 라우팅과 기타 기능은 단계적으로 조정하세요. 데스크톱 환경마다 시스템 프록시를 읽는 방식이 다르며 일부 앱은 자체 설정에서 프록시를 지정해야 합니다. 시스템 프록시 스위치를 모든 프로그램이 따라야 하는 전역 규칙으로 볼 수는 없습니다.
TUN은 추가 권한과 네트워크 라우팅 변경이 필요할 수 있으므로 최초 실행부터 설정하는 것은 권장하지 않습니다. 기본 연결을 확인하기도 전에 복잡한 분할 라우팅과 TUN을 함께 켜면 문제를 찾기 어려워집니다. 업그레이드 전에 현재 설정과 사용자 지정 규칙을 저장하고, 설치 후 데스크톱 실행 항목, 수신 대기 포트, 실제 설정 디렉터리를 확인하세요.
설치를 마친 것은 시작에 불과합니다. 처음부터 네트워크 옵션을 여러 개 바꾸기보다 ‘가져오기, 선택, 연결, 확인’ 순서로 진행하면 문제를 더 쉽게 찾을 수 있습니다.
업데이트 전에 연결을 중지하고 클라이언트를 종료한 뒤 기존 프로세스가 완전히 끝났는지 확인하세요. 현재 버전의 내보내기 또는 백업 기능으로 설정을 저장하고, 설정 디렉터리를 복사해야 한다면 실제 경로부터 확인하세요. 프로그램 디렉터리, 설정 디렉터리, 시스템 설치 디렉터리는 서로 다를 수 있습니다. 설치 파일만 보관하는 것은 설정 백업을 대신할 수 없습니다.
구독 그룹, 사용자 지정 라우팅, DNS, 수신 대기 포트, 앱 프록시 방식은 업데이트 후 연결 동작에 영향을 줄 수 있습니다. 백업할 때 서버 별칭뿐 아니라 규칙과 매개변수도 보관하세요. 백업 파일에는 구독 주소와 노드 인증 정보가 포함될 수 있으므로 안전한 위치에 보관하고 일반적인 문제 해결 자료처럼 공개하지 마세요.
업그레이드 후 기존 구독이 있는지, 활성 서버가 올바른지 먼저 확인한 다음 포트와 라우팅을 점검하세요. 평소 사용에 문제가 없는 것을 확인한 뒤 오래된 파일을 정리하세요. 이전 버전으로 되돌려야 한다면 업그레이드 전에 저장한 백업을 우선 사용하세요. 새 버전에서 저장한 설정을 구버전이 모두 바로 읽을 수 있다고 가정하지 마세요.
v2rayN, v2rayNG, v2flyNG는 Project V, V2Fly, Xray 생태계의 기능을 쉽게 사용할 수 있도록 지원하는 그래픽 클라이언트입니다. 버전 숫자를 서로 비교하기보다 기기 및 설정 호환성을 먼저 살펴보세요. 프로토콜, 라우팅, TUN의 관계를 더 자세히 알아보려면 기초부터 고급까지 전체 가이드를 확인하세요.
처음 설치한다면 차세대 크로스 플랫폼 UI를 사용하는 v2rayN 데스크톱 버전을 먼저 고려해 보세요. 클래식 WPF 버전은 Windows 전용의 안정적인 클래식 버전으로, 기존 인터페이스와 사용 방식에 익숙한 경우에 적합합니다. 두 버전을 동시에 실행하지 마세요. 전환하기 전에 설정을 백업하고 필요한 런타임을 확인하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택할 수 있지만, 시스템에서 64비트 앱을 지원하는지 확인해야 합니다. CPU 아키텍처를 모르거나 arm64 패키지가 호환되지 않는다는 메시지가 표시되면 범용 버전을 시도해 보세요. 범용 버전은 여러 아키텍처용 구성 요소를 포함해 파일 크기가 더 클 수 있지만, 기능이 더 많은 것은 아닙니다.
클라이언트는 설정과 연결을 관리하는 도구이며, 설치 파일에는 사용할 수 있는 서버가 포함되어 있지 않습니다. 사용 권한이 있는 구독 주소나 노드 설정을 준비해 가져온 뒤 서버를 선택하고 시스템 프록시 또는 연결 모드를 설정해야 합니다. 오류가 발생하면 먼저 클라이언트 로그를 확인해 설정, 네트워크, 권한 중 무엇이 문제인지 살펴보세요.
먼저 연결을 중지하고 클라이언트를 종료한 다음, 현재 버전의 내보내기 또는 백업 기능으로 설정을 저장하세요. 데스크톱에서는 실제 설정 디렉터리도 확인해 프로그램 파일만 복사하는 일이 없도록 합니다. 업그레이드 후 구독 그룹, 활성 서버, 수신 대기 포트, 라우팅 규칙을 하나씩 확인하고 기존 백업은 당분간 보관하세요.
먼저 플랫폼, CPU 아키텍처, 패키지 형식을 확인하세요. Windows 압축 파일은 전체 압축을 풀어야 합니다. macOS에서는 Apple Silicon과 Intel을 구분하고, Android에서는 시스템 아키텍처와 설치 권한을 확인하세요. Linux는 배포판에 맞는 deb 또는 rpm 패키지를 선택해야 합니다. 그래도 설치되지 않으면 전체 오류 메시지를 기록하고 시스템 보안 기능을 바로 끄지 마세요.
두 클라이언트는 서로 다른 코어를 사용하므로 설정 호환성은 프로토콜, 전송 방식, 세부 매개변수에 따라 달라집니다. 일반적인 공유 링크는 각각 가져오기를 시도할 수 있지만, 모든 고급 설정을 서로 바꿔 쓸 수 있다고 단정할 수는 없습니다. 전환 전에 기존 구독을 보관하고 새 클라이언트에서 다시 가져온 뒤 라우팅과 DNS 설정을 별도로 확인하세요.