클라이언트 버전 / 설치 파일 목록

V2Ray 클라이언트 다운로드

데스크톱에서는 v2rayN을, Android에서는 v2rayNG 또는 v2flyNG를 선택할 수 있습니다. 먼저 운영체제를 확인한 뒤 기기 아키텍처와 패키지 형식에 맞는 설치 파일을 선택하세요.

플랫폼
운영체제 4종
클라이언트
오픈 소스 GUI 클라이언트 3종

Windows 클라이언트

X64 / ZIP

시스템 요구 사항 및 패키지 선택

확인 항목요구 사항
시스템지원이 계속 제공되는 64비트 Windows 사용을 권장합니다.
아키텍처두 패키지 모두 x64입니다. ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하세요.
파일ZIP 파일을 먼저 완전히 압축 해제한 다음, 압축 해제한 폴더에서 설치 프로그램을 실행하세요.

압축 파일 미리보기에서 프로그램 하나만 꺼내 실행하지 마세요. 주변 파일도 설치에 필요할 수 있습니다. 실행 시 런타임 구성 요소가 없다는 안내가 표시되면 필요한 구성 요소의 이름과 버전을 기록한 뒤 시스템 안내에 따라 처리하세요.

WPF 버전에서 데스크톱 버전으로 바꾸려면 구독 그룹, 라우팅 옵션, 로컬 포트를 먼저 기록해 두세요. 설치 후 클라이언트를 열어 설정을 확인한 다음 기존 버전을 제거할지 결정하세요. 두 버전이 같은 로컬 포트를 사용하면 나중에 실행한 쪽에서 수신 대기를 시작하지 못할 수 있습니다.

설치 안내 / 설치 전후 확인 사항

패키지 선택, 업그레이드 및 첫 실행

먼저 클라이언트가 정상적으로 실행되는지 확인한 뒤 설정을 가져오세요. 이 순서로 점검하면 설치 문제와 연결 문제를 구분하기 쉽습니다.

01 / 패키지 선택

대상 기기 정보를 기준으로 파일 선택

다른 기기에서 사용할 파일을 다운로드할 때는 현재 브라우저가 실행 중인 기기가 아니라 클라이언트를 실제로 사용할 기기를 기준으로 선택하세요. 다음 세 가지를 확인해야 합니다. 대상 운영체제에서 해당 클라이언트를 실행할 수 있는지, 패키지에 포함된 프로그램의 아키텍처가 대상 시스템과 맞는지, 대상 기기의 설치 프로그램에서 패키지를 열 수 있는지 확인하세요. 하나라도 맞지 않으면 같은 파일을 다시 다운로드해도 문제가 해결되지 않습니다.

파일 확장자는 파일을 여는 방법을 나타냅니다. ZIP은 압축 파일이므로 먼저 압축을 풀어야 하고, DMG는 디스크 이미지입니다. APK는 Android 시스템 설치 프로그램으로 처리하며, deb와 rpm은 서로 다른 패키지 형식입니다. 확장자를 바꿔 형식을 변환하려고 하지 마세요. 브라우저 다운로드가 중단되었다면 먼저 다운로드가 완료됐는지 확인한 뒤 설치 오류가 시스템이나 프로세서 문제인지 판단하세요.

아키텍처 이름은 플랫폼과 함께 살펴봐야 합니다. Windows용 x64 패키지와 Linux용 x64 패키지는 서로 다른 운영체제용입니다. 두 기기 모두 ARM 아키텍처를 사용하더라도 Android용 arm64 APK를 macOS에서 사용할 수는 없습니다. 플랫폼은 기기에서 실행되는 운영체제로 결정하고, 같은 플랫폼 안에서 어떤 패키지를 쓸지는 아키텍처와 형식에 따라 선택하세요.

02 / 업그레이드

프로그램을 교체하기 전에 설정 저장

업데이트 전에 보존할 항목을 확인하세요. 구독 그룹, 직접 추가한 항목, 라우팅 규칙, 로컬 수신 포트, 시스템 프록시 및 시작 시 실행 설정 등이 있습니다. 클라이언트에 내보내기 기능이 있으면 먼저 내보내고, 내보내기에 포함되지 않는 설정은 별도로 기록해 두세요. 구독 주소와 공유 링크에는 접속 정보가 포함될 수 있으므로 공개 스크린샷이나 공유 문서에 올리지 않는 것이 좋습니다.

데스크톱 클라이언트를 교체하기 전에 시스템 트레이나 메뉴 막대에 남아 있는 인스턴스까지 모두 종료하세요. 파일 점유를 줄이고 설치 후 어느 버전이 실행되는지 확인하기 쉬워집니다. 인터페이스나 패키지 형식이 다른 버전으로 바꿀 때는 기존 설정을 보관하고, 새 프로그램에서 필요한 정보를 읽거나 가져올 수 있는지 확인한 후 이전 파일을 정리하세요.

모바일 앱을 업데이트할 때 설치 프로그램에서 서명 충돌을 명확히 안내하면 설치를 반복하지 마세요. 기존 앱을 어디서 설치했는지 확인하고 같은 배포 경로에서 업데이트하는 것을 우선으로 하세요. 설치 경로를 바꿔야 한다면 내보낼 수 있는 로컬 데이터를 먼저 백업하세요. 앱을 삭제하면 앱 전용 저장 공간의 데이터도 함께 지워질 수 있으며, 구독을 다시 가져와도 직접 만든 그룹이나 개별 항목의 수정 내용까지 복구되지 않을 수 있습니다.

03 / 실행

네트워크보다 프로그램 상태부터 확인

처음 실행할 때는 앱이 메인 화면을 표시하는지, 종료 후 다시 실행되는지, 설정을 바꾼 뒤 정상적으로 저장되는지 확인하세요. 창이 열리기 전에 오류가 발생하면 시스템 안내, 설치 파일 이름, 오류가 발생한 단계를 먼저 기록하세요. 클라이언트가 설정을 읽기도 전에 실행에 실패한 상황에서는 구독이나 서버를 바꿔도 대개 도움이 되지 않습니다.

메인 화면이 정상적으로 열리면 빠른 시작 안내에 따라 구독이나 개별 공유 링크를 가져오세요. 가져온 뒤 예상한 그룹과 항목이 표시되는지 확인하고, 한 번에 한 가지씩만 바꿔 테스트하세요. 예를 들어 먼저 항목 하나를 선택한 다음 대상 앱이 시스템 프록시를 사용하는지 확인할 수 있습니다. 클라이언트, 구독, 네트워크 모드를 동시에 바꾸면 어떤 변경이 영향을 줬는지 파악하기 어렵습니다.

항목은 표시되지만 특정 프로토콜이나 전송 설정을 사용할 수 없다면 프로토콜 안내서에서 클라이언트 코어와 설정의 호환성을 확인하세요. 문제를 다른 사람에게 설명할 때는 운영체제 버전, 앱 버전, 패키지 형식, 구체적인 오류 메시지를 남기고 구독 주소, 개인 서버 정보, 로컬 계정 정보는 가리세요. 정확한 오류 메시지가 단순히 ‘연결되지 않음’이라고 하는 것보다 문제를 파악하는 데 도움이 됩니다.

설치 FAQ / 자주 묻는 질문

다운로드 및 설치 FAQ

Windows 데스크톱 버전과 클래식 WPF 버전을 모두 설치해야 하나요?

둘 중 하나만 설치하면 됩니다. 데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용하고, 클래식 WPF 버전은 익숙한 Windows 레이아웃을 유지해 기존 사용 방식에 적합합니다. 전환 전 설정을 백업하고 실행 중인 클라이언트를 종료하세요. 두 버전에서 시스템 프록시를 동시에 켜지 마세요.

macOS용 Apple Silicon 패키지와 Intel 패키지는 어떻게 구분하나요?

Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. Apple M 시리즈 칩이 표시되면 Apple Silicon 패키지를, Intel 프로세서가 표시되면 Intel 패키지를 선택하세요. macOS 버전명이 아니라 현재 기기의 칩을 기준으로 선택해야 합니다.

Android 범용 패키지를 설치하면 모든 설치 오류가 해결되나요?

범용 패키지는 지원하는 CPU 아키텍처의 범위를 넓혀 줍니다. Android 버전이 낮거나 기기 관리 정책에서 설치를 제한하는 경우, 또는 이전 설치 파일과 서명이 다른 경우에는 설치에 실패할 수 있습니다. 먼저 시스템 안내를 확인하세요. 패키지를 바꾸려면 기존 버전을 삭제해야 하는 경우, 로컬 설정을 먼저 저장하세요.

Linux에서는 deb와 rpm 중 무엇을 선택해야 하나요?

Debian·Ubuntu 계열은 보통 deb를, Fedora 및 RHEL 계열은 보통 rpm을 선택합니다. 패키지 형식뿐 아니라 아키텍처, 배포판, 의존성 버전도 확인하세요. rpm 파일명의 el10은 빌드 대상에 관한 단서이며, rpm을 사용하는 모든 시스템에 바로 설치할 수 있다는 뜻은 아닙니다.

클라이언트를 설치했는데 목록에 서버가 없는 이유는 무엇인가요?

설치 파일에는 클라이언트 프로그램만 포함되어 있습니다. 서버 정보는 기존 구독이나 개별 공유 링크에서 가져와 설치 후 따로 가져와야 합니다. 먼저 클라이언트가 정상적으로 열리는지 확인한 다음 빠른 시작 안내에 따라 가져오세요. 목록이 비어 있다면 구독을 업데이트했는지, 응답 형식을 클라이언트가 지원하는지 확인하세요.

V2Ray 클라이언트 다운로드