클라이언트 설치 파일 / 플랫폼 및 아키텍처

V2Ray 클라이언트 다운로드

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. 먼저 운영체제를 확인한 다음 프로세서 아키텍처와 설치 파일 형식을 고르면 됩니다.

설치 순서: 설치 파일 선택 → 클라이언트 설치 → 구독 가져오기 → 프록시 설정

처음 사용하시나요? 입문 가이드 보기 →

데스크톱 클라이언트 / x64

Windows 설치 파일

같은 클라이언트에서 두 가지 UI를 제공합니다. Desktop 버전은 차세대 크로스 플랫폼 UI를 사용하고, WPF는 기존 Windows 데스크톱 레이아웃을 따르는 클래식 안정 버전입니다. 처음 사용하는 경우 Desktop을 권장하며, 기존 WPF 사용 방식이 익숙하다면 클래식 버전을 계속 사용해도 됩니다.

설치 전 확인

Windows 시스템 요구 사항 및 확인 방법
항목요구 사항 및 확인 방법
시스템지원되는 Windows 10/11 환경에서 사용하는 것이 좋습니다. 구체적인 종속성은 설치 프로그램의 안내를 확인하세요.
프로세서이 페이지의 두 설치 파일은 모두 x64입니다. ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하세요.
설치 환경설정 파일을 저장할 수 있는 위치를 확보하세요. 런타임 라이브러리가 없다는 안내가 표시되면 해당 버전의 설치 설명을 따르세요.
권한일반 시스템 프록시와 TUN에 필요한 권한은 다릅니다. TUN을 활성화하기 전에 권한 안내를 확인하세요.

압축 파일 미리보기 창에서 프로그램을 바로 실행하지 마세요. 먼저 별도 폴더에 압축을 완전히 풀고 설치 프로그램을 실행하세요. Desktop과 WPF는 서로 다른 폴더에 설치해 설정 파일이 덮어쓰이지 않도록 하세요. 설치가 끝나면 구독을 가져온 뒤 시스템 프록시 모드를 선택하세요.

선택 기준

아키텍처를 먼저 확인하고 패키지 형식을 선택하세요

다운로드 버튼의 차이는 실행 환경이며, 회선 등급이 아닙니다. 운영체제와 프로세서, 클라이언트 설정 요구 사항에 모두 맞는 설치 파일을 선택하세요.

x64와 ARM64

x64는 Intel·AMD 데스크톱 기기에서 흔히 사용하며 설치 파일에 amd64 또는 x86_64로 표기되기도 합니다. ARM64는 aarch64 또는 arm64-v8a로 표기될 수 있습니다. 두 표기는 프로세서 명령어 집합을 뜻하므로 시스템에 ‘64비트’라고 표시된다는 이유만으로 서로 바꿔 사용할 수는 없습니다. 특히 Android에서는 프로세서가 64비트를 지원해도 현재 기기 시스템에서 64비트 앱 설치를 허용하지 않을 수 있습니다.

아키텍처를 잘못 선택하면 보통 설치 또는 실행 단계에서 오류가 발생합니다. 구독 설정을 반복해서 바꿀 필요는 없습니다. 시스템의 ‘정보’ 페이지에서 기기 정보를 확인한 뒤 해당 플랫폼의 설치 파일을 다시 선택하세요. 범용 APK는 여러 아키텍처를 지원하기 위한 것이며 네트워크 성능을 높여 주지는 않습니다.

클라이언트와 설정의 호환성

v2rayN은 데스크톱용이며 v2rayNG와 v2flyNG는 Android용입니다. v2rayNG는 Xray 코어, v2flyNG는 V2Fly 코어를 사용합니다. 프로토콜과 전송 옵션의 지원 범위는 버전에 따라 달라집니다. 구독에 VMess, VLESS 또는 Trojan이 있다고 해서 모든 확장 설정이 호환되는 것은 아닙니다.

설정 제공업체가 안내한 클라이언트와 버전 요구 사항을 먼저 확인하세요. 가져온 설정에서 지원되지 않는 전송 방식이나 필드가 표시되면 설치 파일의 아키텍처만 바꾸지 말고 호환성을 확인해야 합니다. Project V, V2Fly, Xray는 서로 관련된 오픈 소스 기술 생태계입니다. 실제 설정은 그래픽 클라이언트에서 진행하며, 코어 개념은 사용 안내에서 자세히 확인할 수 있습니다.

설치 후 진행 순서

구독 가져오기 및 프록시 설정

설치 파일에는 클라이언트 프로그램만 포함됩니다. 서버 주소와 인증 정보, 구독 내용은 별도로 준비해야 하며 클라이언트 설치가 완료되어도 연결이 자동으로 설정되지는 않습니다.

01 / 설치 및 실행

프로그램이 정상적으로 열리는지 확인하세요

설치가 끝나면 시스템 앱 목록에서 클라이언트를 실행하세요. Windows에서는 설치 파일의 압축을 완전히 풀고, macOS에서는 앱을 먼저 복사하며, Linux에서는 종속성을 해결하고, Android에서는 설치 권한을 허용해야 합니다. 기본 화면이 나타나기 전에 종료된다면 시스템 호환성, 실행 환경, 파일 권한을 먼저 확인하세요. 이 단계에서는 구독 주소를 바꿔도 대개 해결되지 않습니다.

처음 실행할 때는 기본 수신 설정을 유지하세요. 클라이언트가 사용하는 로컬 포트를 확인하고 다른 프록시 프로그램이 같은 포트를 사용하지 않는지 살펴본 뒤 구독을 가져오세요. 기존 버전 창을 여러 개 동시에 실행하면 현재 적용 중인 설정을 잘못 판단할 수 있습니다.

02 / 구독 및 서버

그룹을 추가한 다음 구독을 업데이트하세요

v2rayN에서는 보통 ‘구독 그룹 설정’에서 그룹을 추가하고 이름과 주소를 입력한 뒤 저장하고 구독을 업데이트합니다. v2rayNG에서는 ‘구독 그룹 설정’에서 주소를 추가한 다음 기본 화면으로 돌아와 구독을 업데이트하세요. 버전에 따라 메뉴 이름이 조금 다를 수 있지만, 주소를 저장한 뒤 서버 목록을 가져오는 순서는 같습니다.

개별 공유 링크와 구독 주소는 서로 다른 형식입니다. 링크를 복사한 뒤 형식에 맞는 가져오기 메뉴를 사용하세요. 업데이트가 끝나면 서버도 직접 선택해야 합니다. 목록이 보인다고 해서 클라이언트가 앱 트래픽을 처리하기 시작한 것은 아닙니다.

03 / 프록시 및 확인

모드를 설정한 뒤 실제 접속을 확인하세요

데스크톱에서는 먼저 시스템 프록시 모드로 시작해 시스템 프록시를 따르는 앱이 로컬 프록시를 사용하도록 설정하세요. 다른 앱까지 적용해야 한다면 TUN 권한과 라우팅, DNS 설정 요구 사항을 확인하세요. Android에서는 연결을 누른 뒤 시스템 VPN 요청을 승인하고, 다른 VPN 서비스가 실행 중인지 확인해야 합니다.

확인할 때는 클라이언트 로그와 실제 앱 접속을 함께 살펴보세요. 지연 시간 테스트는 특정 테스트 방식의 결과일 뿐 전체 접속 여부를 대신할 수 없습니다. 브라우저는 정상인데 특정 앱만 실패한다면 해당 앱이 시스템 프록시를 사용하는지 먼저 확인한 뒤 적용 범위를 조정할지 판단하세요.

단계별로 첫 연결 설정하기 → 데스크톱과 Android의 구독 메뉴 비교하기 →

설정 보관 및 문제 해결

업데이트 전 백업하고 단계별로 문제를 확인하세요

프로그램 업데이트와 구독 업데이트를 구분하세요

클라이언트 다운로드 업데이트는 앱 프로그램을 교체하고, 구독 업데이트는 그룹에 포함된 서버 설정을 새로 가져옵니다. 두 작업은 별개입니다. 구독 만료, 접속 정보 변경, 잘못된 업데이트 주소는 클라이언트를 다시 설치해도 해결되지 않는 경우가 많습니다. 먼저 ‘구독 그룹 설정’의 주소를 확인한 뒤 로그를 살펴 주소 문제인지, 네트워크 요청 실패인지, 지원하지 않는 형식인지 구분하세요.

업그레이드 전 연결을 중지하고 클라이언트를 종료한 다음 앱에서 지원하는 백업 또는 내보내기 기능으로 필요한 설정을 보관하세요. 구독 그룹, 사용자 지정 라우팅, 로컬 수신 포트, DNS, TUN 상태를 기록해 두는 것이 좋습니다. 버전 간 설정을 옮길 때는 먼저 설정 변경 사항을 확인하고 필요한 항목만 가져오세요. 기존 폴더의 파일을 새 버전 폴더에 전부 덮어쓰지 마세요.

문제가 발생한 단계부터 확인하세요

다운로드가 완료되지 않으면 브라우저 다운로드 기록과 남은 공간, 네트워크 연결을 확인하세요. 설치 실패 시에는 시스템 버전과 아키텍처, 패키지 형식, 이전 버전과 서명이 일치하는지 살펴보세요. 실행되지 않으면 런타임 종속성과 권한을 확인하고, 실행은 되지만 연결되지 않을 때 구독과 서버 선택, 시스템 프록시, 라우팅, DNS를 확인하세요. 정확한 오류 메시지를 보관하면 막연히 ‘열리지 않는다’고 설명하는 것보다 원인을 찾기 쉽습니다.

다른 클라이언트로 전환할 때는 기존 프로그램을 종료하고 이전 시스템 프록시 설정을 정리하세요. 새 클라이언트의 로컬 포트가 다를 수 있으므로 앱에 직접 입력한 프록시 설정도 함께 바꿔야 합니다. 테스트가 끝나면 의도한 프록시 또는 VPN 서비스만 실행 중인지 확인하세요. 여러 연결 경로가 동시에 사용되면 접속 결과가 달라질 수 있습니다.

구독 문제는 구독 업데이트 실패 문제 해결을 참고하세요. 플랫폼별 권한과 라우팅 차이는 전체 플랫폼 설치 및 설정 안내에서 하나씩 확인할 수 있습니다. 다운로드 단계에서 모든 고급 설정을 미리 바꿀 필요는 없습니다. 먼저 기본 설정으로 연결한 뒤 사용자 지정 규칙을 하나씩 추가하세요.

다운로드 FAQ

설치 파일 선택 및 업데이트

Windows Desktop 버전과 클래식 WPF 버전 중 무엇을 선택해야 하나요?

처음 설치한다면 차세대 크로스 플랫폼 UI를 사용하는 Desktop 버전을 선택해 보세요. 기존 Windows 데스크톱 레이아웃에 익숙하다면 클래식 안정 버전인 WPF가 적합합니다. 각 버전의 실행 환경을 확인하고, 두 설치 파일을 같은 폴더에 압축 해제하지 마세요.

Android에서는 arm64와 범용 버전 중 무엇을 다운로드해야 하나요?

2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 사용해 볼 수 있지만, 시스템이 64비트 앱을 지원하는지 확인해야 합니다. 기기 아키텍처를 모르거나 arm64 파일이 설치되지 않으면 범용 버전을 선택하세요. 범용 버전은 여러 아키텍처를 포함해 파일 크기가 더 클 수 있으며, 연결 속도가 더 빠르다는 뜻은 아닙니다.

설치 파일을 다운로드했는데도 연결할 수 없는 이유는 무엇인가요?

클라이언트에는 바로 사용할 수 있는 서버 설정이 포함되어 있지 않습니다. 사용 권한이 있는 구독 주소나 공유 링크를 가져와 업데이트하고 서버를 선택한 다음, 시스템 프록시를 설정하거나 Android VPN 연결을 시작해야 합니다. 마지막으로 로그와 실제 앱 접속으로 연결 여부를 확인하세요.

클라이언트를 업데이트하기 전에 어떤 설정을 보관해야 하나요?

먼저 연결을 중지하고 기존 클라이언트를 종료한 뒤, 클라이언트의 백업 또는 내보내기 기능으로 구독 그룹과 사용자 지정 라우팅, 필요한 설정을 저장하세요. 백업에는 민감한 설정이 포함될 수 있으므로 안전한 곳에 보관해야 합니다. 업데이트 후에는 수신 대기 포트, 시스템 프록시 상태, 라우팅 모드를 확인한 다음 평소처럼 사용하세요.

macOS에서 앱을 열 수 없다는 메시지가 표시되면 어떻게 해야 하나요?

먼저 다운로드한 파일이 칩에 맞는지 확인하고 앱을 ‘응용 프로그램’ 폴더로 드래그하세요. 출처를 확인한 뒤 ‘시스템 설정’의 ‘개인정보 보호 및 보안’에서 ‘그래도 열기’ 옵션이 제공되는지 확인할 수 있습니다. 앱이 손상되었거나 위험하다는 경고가 표시되면 이를 우회하지 말고 다시 다운로드한 후 호환성을 확인하세요.

Linux의 deb, rpm, arm64 패키지는 어떻게 선택하나요?

먼저 배포판에 맞는 패키지 형식을 선택하세요. Debian·Ubuntu 계열은 보통 deb, Fedora·RHEL 계열은 보통 rpm을 사용합니다. 다음으로 프로세서가 x86_64인지 ARM64인지 확인하세요. 패키지 형식이 같아도 모든 배포판 버전과 호환되는 것은 아니므로 패키지 관리자가 표시하는 종속성과 시스템 라이브러리 요구 사항을 확인해야 합니다.