v2rayN
Desktop 데스크톱 버전
Desktop 다운로드 · x64차세대 크로스 플랫폼 UI입니다. 처음 설치하거나 여러 데스크톱 운영체제에서 비슷한 조작 환경을 원하는 사용자에게 적합합니다.
일상적으로 사용할 버전 하나만 유지하세요. 두 인스턴스가 같은 로컬 수신 포트를 동시에 사용하지 않도록 주의하세요.
클라이언트 설치 · 플랫폼 및 아키텍처
V2Ray 다운로드
클라이언트와 설치 파일 선택
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 권장합니다. 운영체제와 CPU 아키텍처를 확인한 뒤 알맞은 설치 파일을 선택하세요.
첫 설치 및 구독 가져오기 안내 →Windows：v2rayN
같은 클라이언트의 두 가지 UI입니다. 아래 파일은 모두 x64 설치 패키지입니다. 다운로드한 뒤 압축을 풀고 패키지 안의 설치 프로그램을 실행하세요.
시스템 준비 및 설치 순서
‘설정 → 시스템 → 정보’에서 시스템 종류를 확인해 x64 시스템인지 확인하세요. 두 패키지는 다른 아키텍처용으로 별도 빌드된 버전이 아닙니다. 기기 아키텍처가 다르다면 먼저 시스템의 호환 실행 기능을 확인하세요. ZIP 파일을 쓰기 가능한 폴더에 저장한 뒤 완전히 압축을 풀고 설치 프로그램을 실행하세요. 압축 파일 미리보기에서 바로 실행하지 마세요.
Desktop과 WPF의 주요 차이는 UI 기술과 조작 방식입니다. 구독 정보가 필요 없다는 뜻도, 같은 규칙이 서로 다른 코어에서 항상 같은 결과를 낸다는 뜻도 아닙니다. 처음 사용할 때는 기본 설정을 유지하고 구성을 가져와 연결부터 확인하세요. 기존 사용자는 UI를 바꾸기 전에 구독 그룹, 사용자 지정 라우팅, 개인 설정을 백업하세요. 실행 중인 폴더에 다른 버전의 프로그램을 덮어쓰지 마세요.
프로그램 실행 시 런타임 구성 요소가 없다는 메시지가 나타나면 안내에 따라 아키텍처에 맞는 .NET 데스크톱 런타임을 설치하세요. 배포 패키지에 런타임이 포함되어 있는지는 버전에 따라 다르므로 모든 런타임을 미리 설치할 필요는 없습니다. 실행 직후 종료된다면 보안 소프트웨어의 격리 기록과 설치 폴더의 쓰기 권한도 확인하세요. 일반적인 시스템 프록시 사용에는 관리자 권한을 계속 유지할 필요가 없습니다. 관련 네트워크 기능에서 권한 상승을 명시적으로 요구할 때만 조치하세요.
| 항목 | 이 페이지의 패키지 유형 | 확인 위치 및 요구 사항 |
|---|---|---|
| 시스템 및 아키텍처 | Windows x64 | 시스템 정보에서 시스템 종류를 확인하세요. 최소 시스템 버전은 해당 패키지의 요구 사항을 따릅니다. |
| 설치 형식 | 설치 프로그램이 포함된 ZIP | 압축을 완전히 푼 다음 기존 인스턴스를 종료하고 설치 프로그램을 실행하세요. |
| 런타임 환경 | 실행 안내에 따라 처리 | .NET이 없다는 메시지가 나타나면 필요한 데스크톱 런타임을 설치하고 아키텍처가 맞는지 확인하세요. |
| 저장 공간 및 권한 | 쓰기 가능한 폴더 | 압축 해제와 설치, 설정 저장에 필요한 공간을 확보하고 보안 소프트웨어가 구성 요소를 격리하지 않았는지 확인하세요. |
macOS：v2rayN
‘이 Mac에 관하여’에 표시된 칩 또는 프로세서 이름에 따라 선택하세요. DMG는 설치용 디스크 이미지이지, 앱을 평소 실행할 폴더가 아닙니다.
v2rayN
Apple Silicon
Apple Silicon 다운로드 · arm64‘이 Mac에 관하여’의 칩 항목에 Apple M 시리즈가 표시되면 이 패키지를 선택하세요. 해당 칩에 맞춰 네이티브 빌드되었습니다.
앱을 ‘응용 프로그램’ 폴더로 드래그한 뒤 실행하세요. 업데이트 전에 실행 중인 v2rayN 인스턴스를 종료하세요.
칩 확인 및 첫 실행
화면 왼쪽 상단의 Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. ‘칩 Apple M…’으로 표시되는 기기는 arm64 패키지를, ‘프로세서 Intel…’로 표시되는 기기는 x64 패키지를 사용합니다. 이전 앱을 호환 계층으로 실행했더라도 기존 설치 파일의 아키텍처를 그대로 쓰기보다 하드웨어에 맞는 최신 빌드를 우선 선택하세요. 파일 확장자가 같다고 해서 같은 프로세서에 적합한 프로그램이라는 뜻은 아닙니다.
다운로드한 DMG를 두 번 클릭한 뒤 디스크 이미지 창의 안내에 따라 v2rayN을 ‘응용 프로그램’ 폴더로 드래그하세요. 복사가 끝나면 해당 폴더에서 클라이언트를 실행하고 디스크 이미지를 꺼내세요. 임시로 마운트한 위치에서 계속 실행되는 일을 막고, 이후 업데이트도 쉽게 할 수 있습니다. 시스템 보안 경고가 표시되면 내용을 읽고 앱 출처를 확인하세요. 한 번 설치하기 위해 시스템 전체의 보안 검사를 끄지 마세요.
처음 실행한 뒤 구성을 가져오고 사용할 수 있는 항목을 선택한 다음 시스템 프록시를 설정하세요. 시스템 프록시는 해당 설정을 따르는 앱에만 영향을 줍니다. 모든 프로그램이 같은 경로로 연결된다고 단정하지 마세요. TUN은 네트워크 트래픽을 처리하는 별도의 방식으로, 추가 권한이나 라우팅 조정이 필요할 수 있습니다. 브라우저에서만 프록시를 사용하려면 먼저 시스템 프록시를 확인한 뒤 설정 레퍼런스를 참고해 TUN 사용 여부를 결정하세요.
| 항목 | 선택 기준 | 설치 요구 사항 |
|---|---|---|
| Apple Silicon | Apple M 시리즈 칩 | arm64 DMG를 선택하고 현재 패키지의 요구 사항을 충족하는 macOS 버전인지 확인하세요. |
| Intel | Intel 프로세서 | x64 DMG를 선택하세요. arm64 패키지와 혼용하지 마세요. |
| 실행 위치 | 응용 프로그램 폴더 | 복사가 끝나면 앱을 실행하세요. 앱과 설정 저장에 필요한 공간을 확보하세요. |
| 네트워크 권한 | 기능별로 권한 부여 | 먼저 기본 연결을 확인하세요. TUN 권한과 일반 시스템 프록시 권한은 별도로 처리하세요. |
Android: v2rayNG 및 v2flyNG
먼저 Xray 코어를 사용하는 v2rayNG를 소개하고, 대안으로 V2Fly 코어를 사용하는 v2flyNG를 제공합니다. 두 앱의 설정은 각각 관리해야 합니다.
v2rayNG
arm64 아키텍처
v2rayNG 다운로드 · arm642015년 이후 출시된 일반적인 스마트폰은 대개 이 버전을 선택하면 됩니다. 최종적으로는 시스템에서 지원하는 앱 아키텍처를 기준으로 판단하세요.
앱에 표시되는 버전과 플랫폼 패키지 파일명이 일치하지 않을 수 있습니다. 설치 후 ‘정보’ 페이지에서 실제 버전을 확인하세요.
v2flyNG
클라이언트 UI가 비슷해도 코어 기능이 같다는 뜻은 아닙니다. 다른 코어 전용 설정 필드를 그대로 적용하지 마세요.
APK 설치, 권한 및 백그라운드 실행
먼저 휴대전화 설정의 기기 정보를 확인하거나 시스템에서 제공하는 앱 호환 정보를 통해 아키텍처를 확인하세요. 프로세서가 64비트를 지원하더라도 시스템에서 모든 64비트 앱 설치를 허용하는 것은 아닙니다. ‘앱이 설치되지 않았습니다’라는 메시지가 나오면 시스템 버전, 저장 공간, 기존 앱의 출처도 함께 확인하세요. 범용 버전은 아키텍처 선택의 불확실성을 줄일 수 있지만 서명 충돌이나 낮은 시스템 버전 문제까지 해결하지는 않습니다.
브라우저나 파일 관리자에서 APK를 열면 해당 출처의 앱 설치를 허용하라는 메시지가 표시될 수 있습니다. 현재 사용하는 출처에만 권한을 부여하고, 설치가 끝나면 필요에 따라 권한을 되돌리세요. 업데이트할 때는 기존 앱과 데이터를 유지하는 것이 일반적입니다. 시스템에서 설치된 앱과 충돌한다고 안내해도 바로 삭제하지 마세요. 구독 그룹과 사용자 설정을 먼저 내보내거나 기록하고, 새 패키지와 기존 패키지가 같은 서명 채널에서 배포되었는지 확인하세요. 앱을 삭제하면 로컬 설정이 사라질 수 있습니다.
처음 연결을 활성화하면 Android에서 VPN 연결 권한을 요청합니다. 이 권한은 클라이언트가 로컬 트래픽 처리 경로를 만들기 위해 필요한 시스템 승인일 뿐, 연결 성공을 의미하지는 않습니다. 권한을 허용한 뒤에도 유효한 구성과 사용 가능한 서버가 필요합니다. 화면을 잠근 뒤 연결이 자주 끊긴다면 시스템 배터리 설정에서 백그라운드 제한을 확인하고, 다른 VPN 앱이 연결을 점유하고 있지 않은지 확인하세요. 설정 메뉴 이름은 제조사마다 다를 수 있습니다.
| 항목 | 권장 선택 | 확인할 항목 |
|---|---|---|
| 앱 아키텍처 | 일반적인 기기는 arm64 우선 | 시스템에서 지원하는 앱 아키텍처를 확인하세요. 확실하지 않으면 범용 패키지를 선택하세요. |
| 시스템 버전 | APK 최소 요구 사항 충족 | 최소 요구 사항은 클라이언트 배포 버전에 따라 달라집니다. 기기 구매 연도로 판단하지 마세요. |
| 설치 권한 | 현재 사용하는 브라우저 또는 파일 관리자 | 현재 출처의 앱 설치를 허용하고 설치 공간을 충분히 확보하세요. |
| 연결 권한 | 시스템 VPN 권한 | 첫 연결 시 권한을 허용하고 다른 VPN 앱이 연결을 점유하지 않는지 확인하세요. |
Linux：v2rayN
먼저 배포판에 맞는 deb 또는 rpm을 선택한 다음 프로세서 아키텍처에 따라 x64 또는 arm64를 선택하세요. 아래 파일은 GUI 데스크톱 클라이언트입니다.
v2rayN
Debian / Ubuntu 계열
deb 다운로드 · x64 arm64 기기: deb 다운로드 →deb 패키지 관리 방식을 사용하는 경우 선택하세요. 패키지 이름의 amd64는 일반적으로 x64 아키텍처를 뜻합니다.
RPM 패키지 관리 방식
rpm 다운로드 · x64 arm64 기기: rpm 다운로드 →rpm 패키지 관리 방식을 사용하는 경우 선택하세요. 설치 전에 현재 배포판이 패키지에 포함된 의존성을 충족하는지 확인하세요.
rpm 파일명에는 빌드 대상 정보가 포함되어 있습니다. rpm을 사용하는 모든 배포판에서 같은 의존성 조건을 충족한다는 뜻은 아닙니다.
배포판, 아키텍처 및 데스크톱 환경
시스템의 ‘정보’ 또는 ‘시스템 정보’에서 배포판과 아키텍처를 확인하세요. x86_64와 amd64는 일반적으로 여기의 x64 패키지에, aarch64는 arm64에 해당합니다. deb와 rpm의 차이는 우선 패키지 관리 형식에 있으며 프로세서 종류와는 별개이므로 두 항목을 모두 확인해야 합니다. 확장자만 바꿔 한 종류의 패키지를 다른 종류처럼 사용하지 마세요. 의존성 오류가 발생해도 패키지 관리자의 검사를 강제로 건너뛰지 마세요.
다운로드가 끝나면 파일 관리자에서 설치 패키지를 열어 시스템 소프트웨어 설치 도구로 설치할 수 있습니다. 설치 도구가 패키지의 의존성을 확인하고 필요한 권한을 요청합니다. 의존성을 충족할 수 없다는 메시지가 나오면 같은 파일을 반복해서 설치하지 말고 배포판 버전, 소프트웨어 저장소 상태, 패키지의 빌드 대상을 확인하세요. 이 페이지에서 제공하는 것은 GUI 클라이언트입니다. 데스크톱 세션 없이 원격 터미널만 사용하는 환경에는 이 설치 절차가 적합하지 않습니다.
설치 후 앱 메뉴에서 v2rayN을 실행하고 구성을 가져온 다음 로컬 수신 포트를 확인하세요. 데스크톱 환경마다 시스템 프록시 설정 위치가 다르며, 클라이언트 설정을 모든 앱이 읽는 것도 아닙니다. 먼저 HTTP 또는 SOCKS 프록시를 지원하는 앱에서 연결을 테스트하세요. 기본 설정이 맞는지 확인한 뒤 데스크톱 시스템 프록시나 TUN을 설정하면 됩니다. TUN을 사용할 때는 권한, 라우팅, DNS를 각각 확인해 네트워크 옵션을 한꺼번에 너무 많이 변경하지 마세요.
| 항목 | 선택 기준 | 실행 요구 사항 |
|---|---|---|
| 패키지 형식 | deb 또는 rpm | 배포판의 패키지 관리 방식에 맞고 패키지 의존성을 충족해야 합니다. |
| 프로세서 | x64 또는 arm64 | 시스템 정보에서 확인하세요. 배포판 이름만으로 아키텍처를 추측하지 마세요. |
| 사용 환경 | 그래픽 데스크톱 세션 | GUI 앱을 실행할 수 있는 데스크톱 환경과 관련 의존성이 필요합니다. |
| 네트워크 기능 | 기능별로 권한 설정 | 시스템 프록시와 TUN을 각각 확인하고 여러 클라이언트가 동시에 라우팅을 처리하지 않도록 하세요. |
설치 후 설정 순서
다운로드가 끝났다고 연결 준비까지 완료된 것은 아닙니다. 연결 결과는 구독, 선택한 구성, 프록시 방식, 앱 자체 설정에도 영향을 받습니다.
구성 가져오기
구독 링크와 공유 링크
v2rayN에서 구독 그룹 설정으로 이동해 그룹 이름과 구독 주소를 추가하고 저장한 뒤 업데이트하세요. v2rayNG에서는 메뉴의 구독 관련 항목에서 주소를 추가한 다음 해당 그룹을 업데이트할 수 있습니다. 단일 공유 링크와 전체 구독은 다릅니다. 공유 링크는 보통 하나의 구성을 설명하고, 구독 주소는 여러 항목을 가져오는 데 사용합니다. 먼저 보유한 링크의 종류를 확인한 뒤 맞는 가져오기 방식을 선택하세요.
구독 가져오기 방법 보기 →프록시 방식 선택
시스템 프록시와 라우팅 분할
가져온 뒤 구성을 하나 선택하고 프록시 방식을 설정하세요. 시스템 프록시는 시스템 설정을 따르는 앱의 요청을 클라이언트로 전달할지 결정하고, 라우팅 규칙은 클라이언트가 받은 요청에 어떤 아웃바운드를 사용할지 결정합니다. 서로 다른 설정입니다. 처음 연결을 확인할 때는 규칙을 단순하게 유지하세요. 연결이 되면 도메인, 주소 또는 앱별 분할 규칙을 추가하고 변경 결과를 기록하세요.
routing 설정 보기 →호환 범위 확인
프로토콜 및 코어 기능
VMess, VLESS, Trojan은 프로토콜 선택이며 TLS, REALITY와 전송 설정은 서버와 각각 맞춰야 합니다. 이름이 같다고 설정이 모두 맞는 것은 아닙니다. v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용합니다. VLESS 등의 설정이 호환되지 않으면 실제 코어와 버전의 지원 여부를 확인한 뒤 전송 방식, 보안 설정, 서버 요구 사항을 점검하세요.
코어 및 설정 필드 지원 범위 보기 →트래픽 처리 범위 확대
TUN 모드 및 DNS
시스템 프록시를 사용하지 않는 앱까지 트래픽을 처리해야 할 때 TUN을 고려하세요. 기존 설정을 저장하고 일반 프록시가 작동하는지 확인한 뒤 클라이언트 안내에 따라 권한을 부여하세요. 활성화 후에는 도메인 조회와 연결을 함께 테스트해 DNS 실패를 서버 연결 불가로 오해하지 않도록 하세요. TUN 구현은 클라이언트와 사용하는 코어에 따라 다릅니다. 모든 설정 파일에 같은 필드를 추가한다고 활성화되는 것은 아닙니다.
TUN 설정 지원 범위 보기 →업데이트 전에 보관할 설정
현재 상태를 기록한 다음 프로그램을 교체하세요. 문제가 생겼을 때 설치 변경과 설정 변경을 구분할 수 있습니다.
업데이트 전에 구독 그룹 이름과 업데이트 방식, 로컬 수신 포트, 사용자 지정 라우팅, DNS 설정을 기록하세요. 구독 항목은 다시 가져올 수 있는 경우가 많지만 직접 추가한 구성, 앱별 분할, 사용자 지정 규칙은 구독으로 복구되지 않을 수 있습니다. 백업은 직접 관리하는 안전한 위치에 보관하고 접근 정보가 포함된 링크, 설정 QR 코드, 원본 로그를 공개하지 마세요.
업데이트할 때는 먼저 기존 클라이언트를 완전히 종료하세요. 시스템 트레이나 백그라운드에서 인스턴스가 계속 실행 중인지도 확인해야 합니다. 설치 후 설정 목록이 유지되었는지 확인하고 필요한 네트워크 기능을 하나씩 복원하세요. 클라이언트, 코어, 구독, 라우팅 규칙을 한 번에 모두 바꾸지 마세요. 한 번에 하나씩 변경해야 연결에 영향을 준 원인을 파악할 수 있습니다. 설치 프로그램에서 현재 시스템을 지원하지 않는다고 안내하면 시스템 요구 사항을 확인하세요. 같은 파일을 다시 다운로드하는 것으로 호환성 문제를 해결할 수는 없습니다.
v2rayN, v2rayNG, v2flyNG는 모두 Project V 관련 오픈 소스 생태계의 GUI 클라이언트입니다. 클라이언트는 설정 입력, 구독, 시스템 연동을 담당하고 코어는 연결과 라우팅을 처리합니다. 프로그램이 정상적으로 실행된다고 해서 서버 설정까지 일치하는 것은 아닙니다. 구독 업데이트에 성공해도 모든 항목을 사용할 수 있다는 뜻은 아닙니다. 확인할 때는 가져오기 결과, 선택한 구성, 실제 앱의 접속을 각각 살펴보며 단계별로 점검하세요.
다운로드 및 설치 FAQ
먼저 패키지 유형과 시스템 호환성을 확인한 뒤 구독 및 연결 문제를 점검하세요.
Windows에서는 Desktop과 클래식 WPF 중 무엇을 선택해야 하나요?
처음 설치한다면 차세대 크로스 플랫폼 UI를 사용하는 Desktop 버전을 권장합니다. 기존 Windows 조작 방식이 익숙하다면 안정적인 클래식 WPF 버전을 선택하세요. 두 버전 모두 x64 패키지입니다. 전환하기 전에 구독 그룹과 사용자 설정을 백업하고, 첫 실행 후 로컬 수신 포트를 확인하세요.
Android에서 arm64와 범용 버전 중 무엇을 선택해야 하나요?
2015년 이후 출시된 일반적인 스마트폰은 대개 arm64를 선택하면 됩니다. 다만 기기에서 지원하는 앱 아키텍처를 기준으로 판단하세요. 아키텍처를 모른다면 여러 아키텍처가 포함되어 보통 용량이 더 큰 범용 버전을 선택할 수 있습니다. 설치에 실패하면 시스템 버전, 저장 공간, 기존 앱의 서명도 확인하세요. 오류 메시지만으로 아키텍처 문제라고 단정할 수는 없습니다.
macOS에서 Apple Silicon과 Intel을 어떻게 구분하나요?
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. 칩 항목에 Apple M 시리즈가 표시되면 Apple Silicon을, 프로세서 항목에 Intel이 표시되면 Intel 버전을 선택합니다. DMG를 다운로드해 디스크 이미지를 열고 앱을 응용 프로그램 폴더로 드래그한 다음, 해당 폴더에서 실행하세요.
클라이언트를 설치하면 구독이나 연결 설정도 포함되나요?
설치 파일에는 클라이언트 프로그램만 포함되며, 바로 사용할 수 있는 구독이나 서버 연결 정보는 제공되지 않습니다. 직접 확보했고 사용할 권한이 있는 구독 링크나 공유 링크를 가져온 뒤 구성을 선택하고 프록시 방식을 설정해 연결을 확인하세요. 구독 주소에는 접근 인증 정보가 포함될 수 있으므로 스크린샷이나 문의 글에 공개하지 마세요.
카드에 표시된 버전과 다운로드 파일명이 다르면 어떻게 해야 하나요?
카드의 버전 표시는 앱 수준의 매니페스트 정보를, 파일명은 플랫폼 패키지 항목을 기준으로 하므로 배포 시점에 서로 다를 수 있습니다. 먼저 선택한 클라이언트와 운영체제, 아키텍처가 맞는지 확인하세요. 설치 전에 파일명을 기록해 두고, 설치 후 클라이언트의 정보 페이지에서 실제 버전을 확인하면 됩니다. 카드의 버전 표시만으로 파일명을 추측하거나 다운로드 주소의 버전 번호를 임의로 바꾸지 마세요.