설치 파일 / 시스템 및 아키텍처
데스크톱에서는 v2rayN, Android에서는 v2rayNG 또는 v2flyNG를 선택하세요. 운영체제와 프로세서 아키텍처를 확인한 뒤 알맞은 설치 파일을 다운로드하면 됩니다.
클라이언트는 구독, 서버 및 프록시 설정을 관리합니다. 사용할 구독 링크나 서버 정보는 별도로 준비해야 합니다. 처음 설치할 때 사용 가이드를 함께 열어 단계별로 설정을 완료하세요.
데스크톱 Desktop 버전은 차세대 크로스 플랫폼 UI를 사용하며, 클래식 WPF 버전은 익숙한 Windows 데스크톱 레이아웃을 유지합니다. 처음 설치한다면 Desktop 버전을 우선 선택하고, 기존 WPF 사용 방식에 익숙하다면 클래식 안정 버전을 계속 사용해도 됩니다.
Desktop · 차세대 크로스 플랫폼 인터페이스
WPF · 클래식 Windows 데스크톱 레이아웃
다운로드 파일은 ZIP 압축 파일입니다. 먼저 전체 압축을 푼 다음 폴더 안의 설치 프로그램을 실행하세요. 압축 파일 미리보기 창에서 바로 실행하지 마세요.
v2rayN 설치 및 구독 가져오기 보기 →| 확인 항목 | 선택 및 요건 | 확인 방법 |
|---|---|---|
| 프로세서 아키텍처 | 이 섹션의 다운로드 파일은 x64입니다 | “설정 → 시스템 → 정보”에서 시스템 종류 확인 |
| 시스템 호환성 | 지원이 계속되는 Windows 사용. 최소 요구 버전은 설치 프로그램 안내 확인 | 시스템 업데이트 상태와 실행 환경 안내 확인 |
| 압축 해제 및 폴더 | 압축을 완전히 풀고 쓰기 가능한 로컬 폴더 선택 | 설치 프로그램과 포함 파일이 같은 압축 해제 폴더에 있는지 확인 |
| 실행 권한 | 일반 프록시는 기본 권한으로 사용하고, TUN에는 추가 권한이 필요할 수 있습니다 | 처음 실행할 때 시스템 프록시를 테스트한 뒤 필요에 따라 TUN 설정 |
컴퓨터 모델보다 “시스템 종류”를 확인하는 편이 설치 파일 선택에 더 정확합니다. x64 기반 프로세서와 64비트 운영체제를 사용한다면 이 섹션의 x64 파일을 선택하세요. 다른 아키텍처 기기는 호환 실행이 가능한지 먼저 확인해야 합니다. 다운로드 페이지가 열린다는 이유만으로 실행 가능하다고 판단하지 마세요. 두 다운로드 경로의 차이는 인터페이스 방식이며, 속도나 서버 성능에 따른 등급 차이가 아닙니다.
설치 프로그램을 실행하기 전에 사용 중인 이전 클라이언트를 종료하세요. 시작할 때 실행 환경이 없다는 안내가 나오면 필요한 구성 요소와 시스템 아키텍처를 확인하고, 다른 컴퓨터의 실행 파일을 임의로 복사하지 마세요. 설치 폴더에 포함된 여러 프로그램과 파일은 각각 용도가 있을 수 있으므로 전체 구조를 유지해야 합니다. 주 프로그램만 다른 폴더로 옮기면 필요한 구성 요소를 찾지 못할 수 있습니다.
v2rayN을 처음 실행하면 구독을 가져오고 서버 설정 하나를 선택한 다음 시스템 프록시를 설정하세요. Desktop과 WPF는 메뉴 구성이 다를 수 있으므로 설명서의 버튼 위치보다 설정 항목 이름을 기준으로 찾는 것이 좋습니다. 버전을 바꾸기 전에는 구독 그룹, 라우팅 및 DNS 설정을 백업하세요. 이전 프로그램을 종료한 뒤 다른 버전을 실행해 시스템 프록시를 동시에 변경하지 않도록 하세요.
“이 Mac에 관하여”에서 칩 정보를 확인하세요. Apple M 시리즈 칩이면 Apple Silicon, Intel 프로세서이면 Intel 버전을 선택합니다. 칩에 맞는 네이티브 아키텍처 패키지를 우선 사용하세요.
Apple M 시리즈 칩용
Intel 프로세서용
DMG를 연 뒤 앱을 “응용 프로그램” 폴더로 복사하고 해당 폴더에서 실행하세요. 업그레이드 전에는 실행 중인 v2rayN을 종료하세요.
데스크톱 클라이언트 설정 단계 보기 →| 확인 항목 | 선택 및 요건 | 확인 방법 |
|---|---|---|
| 칩 아키텍처 | Apple Silicon은 arm64, Intel은 x64 선택 | Apple 메뉴 → 이 Mac에 관하여 |
| 시스템 버전 | 세부 호환 범위는 앱 및 시스템 안내 확인 | 시스템 버전을 확인하고 지원되는 시스템 사용 |
| 앱 위치 | “응용 프로그램” 폴더로 복사한 뒤 실행 | 마운트된 DMG에서 장기간 실행하지 마세요 |
| 네트워크 권한 | 필요에 따라 시스템 프록시 또는 가상 네트워크 기능 허용 | 시스템 설정의 권한 안내 확인 |
구매 연도만으로 아키텍처를 판단하지 마세요. 같은 시기에 나온 기기도 서로 다른 칩을 사용할 수 있습니다. 앱 복사가 끝나면 디스크 이미지를 추출해도 되며, 필요할 때 다시 설치할 수 있도록 다운로드 파일을 보관하세요. 시스템이 실행을 차단하면 안내를 끝까지 읽고 시스템 호환성, 앱 출처 제한, 파일 손상을 구분하세요. 앱 하나를 실행하려고 시스템 보안을 전역으로 해제하는 것은 권장하지 않습니다.
클라이언트가 실행되어도 서버 정보를 가져오고 프록시 모드를 선택해야 합니다. 시스템 프록시는 보통 해당 설정을 따르는 앱에 영향을 줍니다. TUN은 가상 네트워크 인터페이스와 추가 권한이 필요하므로 설치 직후 반드시 켜야 하는 기능은 아닙니다. 먼저 간단한 설정으로 서버 연결을 확인한 뒤 TUN 모드 안내를 참고해 설정을 확장하세요. 이렇게 하면 문제 발생 시 클라이언트와 네트워크 중 원인을 구분하기 쉽습니다.
Android에서는 구독 가져오기, 서버 관리 및 기기의 VPN 연결을 지원하는 v2rayNG를 우선 사용하세요. 2015년 이후의 주요 스마트폰은 대체로 arm64를 선택할 수 있지만 실제 시스템 아키텍처를 확인해야 합니다.
호환되는 64비트 ARM 시스템에 우선 권장
아키텍처가 불분명하면 범용 버전을 고려하세요
버전 표기와 실제 패키지 경로가 동시에 업데이트되지 않을 수 있습니다. 실제 파일명과 설치 후 정보 화면에서 버전을 확인하고 다운로드 주소를 직접 수정하지 마세요.
v2rayNG 사용 가이드 보기 →
V2Fly 코어 계열의 Android 그래픽 클라이언트가 필요하다면 v2flyNG를 선택할 수 있습니다. 사용하기 전에 구독에 포함된 프로토콜과 전송 설정이 현재 버전에서 지원되는지 확인하세요. 인터페이스가 비슷하다는 이유만으로 설정을 그대로 옮기지 마세요.
호환되는 64비트 ARM 시스템용
더 다양한 아키텍처 지원이 필요한 기기에 적합
두 Android 클라이언트에서 설정을 각각 관리할 수 있지만, 연결 테스트 중에는 VPN을 하나만 켜세요. 여러 VPN을 실행하면 시스템이 기존 연결을 교체해 결과를 잘못 판단할 수 있습니다.
코어 계열 및 호환성 알아보기 →| 확인 항목 | 선택 및 요건 | 확인 방법 |
|---|---|---|
| 시스템 아키텍처 | 호환되는 64비트 ARM 시스템은 arm64 선택 | 기기 사양과 시스템 아키텍처 확인. 불분명하면 범용 버전 고려 |
| 시스템 버전 | APK 설치 프로그램에 표시되는 호환 요건을 기준으로 확인 | “설정 → 휴대전화 정보” 및 설치 안내 확인 |
| 설치 권한 | APK를 실제로 여는 앱에 설치 권한 허용 | 시스템 안내에 따라 해당 출처의 설치 권한 설정 |
| 연결 권한 | 처음 연결할 때 시스템 VPN 요청 확인 | 앱 이름을 확인한 뒤 연결 허용 |
| 백그라운드 실행 | 계속 사용하려면 배터리 최적화 및 백그라운드 제한 확인 | 필요에 따라 시스템 앱 설정에서 조정 |
arm64는 실행 아키텍처를 뜻하며 소프트웨어 기능 등급이 아닙니다. 프로세서가 64비트를 지원해도 시스템이 32비트 환경으로 실행되는 기기에는 arm64 패키지를 설치하지 못할 수 있습니다. 범용 버전도 최소 시스템 버전, 서명 충돌 또는 설치 정책 제한을 우회하지는 못합니다. “앱이 설치되지 않았습니다”라는 안내가 나오면 먼저 설치 프로그램의 설명을 확인한 뒤 다른 패키지를 선택할지 판단하세요.
같은 이름의 앱이 이미 설치되어 있으면 업데이트 시 서명이 호환되어야 하는 경우가 많습니다. 시스템에서 충돌을 안내하면 기존 설정을 내보내거나 백업하기 전에는 앱을 삭제하지 마세요. 삭제하면 구독과 사용자 설정이 지워질 수 있습니다. 처음 연결할 때 시스템 VPN 권한은 앱이 네트워크를 처리하도록 허용할 뿐, 원격 서버 연결 성공을 의미하지 않습니다. 웹페이지 접속과 로그도 계속 확인해야 합니다.
먼저 배포판에 맞춰 deb 또는 rpm을 선택한 다음 x64 또는 arm64 아키텍처를 확인하세요. 아래 기본 다운로드 경로는 x64입니다. ARM 데스크톱 기기는 해당 arm64 경로를 사용하세요.
deb 패키지 체계를 사용하는 배포판용
해당 rpm 패키지와 호환되는 배포판용
시스템 소프트웨어 설치 프로그램으로 패키지를 열고 의존성 안내를 확인하세요. 패키지 형식이 같아도 모든 배포판 버전과 호환되는 것은 아닙니다. 특히 rpm 파일명의 대상 배포 환경 정보를 확인하세요.
데스크톱 클라이언트 시작 안내 보기 →| 확인 항목 | 선택 및 요건 | 확인 방법 |
|---|---|---|
| 패키지 형식 | 배포판의 패키지 관리 방식에 따라 deb 또는 rpm 선택 | 시스템 안내와 소프트웨어 설치 프로그램이 지원하는 형식 확인 |
| 프로세서 아키텍처 | amd64 / x86_64는 x64, aarch64는 arm64에 해당 | 시스템 정보의 하드웨어 항목 확인 |
| 데스크톱 환경 | 그래픽 앱을 실행할 수 있는 데스크톱 세션 필요 | 이 페이지는 데스크톱 사용 안내이며 백그라운드 서비스 설치 안내가 아닙니다 |
| 의존성 호환성 | 시스템 라이브러리와 배포판 버전이 설치 파일 요건을 충족해야 합니다 | 소프트웨어 설치 프로그램의 의존성 및 충돌 안내 확인 |
| 프록시 적용 | 시스템 프록시를 따르는지는 데스크톱 환경과 앱 설정에 따라 다릅니다 | 프록시를 사용하는 앱 하나에서 먼저 테스트 |
확장자만 바꿔 deb를 rpm처럼 사용하지 마세요. 시스템에서 파일을 열 수 있다는 이유만으로 의존성 검사를 강제로 무시해서도 안 됩니다. 설치 프로그램에서 의존성 버전이 맞지 않는다고 안내하면 패키지의 대상 환경부터 확인하세요. 같은 패키지 형식이라도 시스템 라이브러리 의존성은 다를 수 있습니다. 호환 범위는 실제 설치 파일과 시스템 환경에 따라 달라지므로 고정된 최소 배포판 목록은 제공하지 않습니다.
Linux 데스크톱의 시스템 프록시를 모든 프로그램이 사용하는 것은 아닙니다. 클라이언트 실행, 서버 선택, 프록시 활성화는 각각 별개의 단계이므로 테스트할 때 하나씩 확인하세요. TUN을 사용할 계획이라면 권한과 라우팅 변경을 확인하고, 종료 후 복구할 수 있도록 활성화 전 상태를 기록하세요. 사용자 지정 라우팅과 DNS는 고급 설정 안내서를 참고하세요. 설치와 복잡한 네트워크 설정을 한 번에 진행하지 않는 것이 좋습니다.
다운로드 전에 세 가지를 확인하면 선택지를 빠르게 좁힐 수 있습니다. 기기의 운영체제, 시스템의 프로세서 아키텍처, 기존 클라이언트 설정을 보존해야 하는지 여부입니다. 운영체제는 플랫폼 경로를, 아키텍처는 패키지를 결정하며, 기존 설정이 있다면 먼저 백업해야 합니다. 이 세 가지를 확인하면 여러 파일을 번갈아 설치하는 일을 줄이고 업데이트 후 기존 구독을 찾지 못하는 문제도 예방할 수 있습니다.
이 페이지에서 x64, amd64, x86_64는 같은 종류의 64비트 데스크톱 아키텍처를 가리킵니다. arm64와 aarch64는 64비트 ARM 아키텍처입니다. 이는 서버 프로토콜이나 연결 속도 등급이 아닙니다. 설치 패키지는 기기의 실행 환경과 일치해야 합니다. Windows용 두 다운로드 모두 x64이며, Desktop과 WPF의 차이는 인터페이스 방식입니다. WPF가 다른 프로세서용 패키지라는 뜻은 아닙니다.
Android 범용 버전은 더 많은 아키텍처를 지원하지만, 모든 기기에 arm64보다 적합한 것은 아닙니다. arm64를 지원하는 스마트폰이라면 해당 패키지를 바로 선택할 수 있습니다. 오래된 기기, 특수한 시스템 또는 아키텍처를 확인하기 어려운 경우 범용 버전을 고려하세요. macOS에서는 “이 Mac에 관하여”의 칩 정보를 확인하고, Linux에서는 패키지 형식과 아키텍처가 모두 맞는지 확인한 뒤 설치하세요.
v2rayN, v2rayNG, v2flyNG는 서버 정보, 구독 및 프록시 옵션을 다루기 쉬운 인터페이스로 제공하는 그래픽 클라이언트입니다. 코어는 실제 연결 처리를 담당하고 서버는 원격 연결 대상입니다. 클라이언트를 다운로드했다고 서버 서비스까지 제공되는 것은 아닙니다. 설치가 끝나도 유효한 연결 정보가 없으면 클라이언트로 연결할 수 없습니다. 따라서 처음 실행한 뒤에도 구독을 가져와야 합니다.
데스크톱 사용자는 보통 v2rayN을 선택합니다. Android 사용자는 Xray 코어 기반 v2rayNG를 우선 고려하고, V2Fly 코어가 필요한 경우 v2flyNG를 선택할 수 있습니다. 코어와 버전에 따라 프로토콜 지원이 다르므로 구독에 특정 전송 방식이나 보안 기능이 포함되어 있다면 설정 호환성을 확인하세요. 프로토콜 이름이 같아도 확장 필드를 모두 그대로 옮길 수 있는 것은 아닙니다. 관련 정의는 용어 안내서에서 확인하세요.
업데이트 전에 현재 클라이언트가 정상 작동하는지 확인하고 사용 중인 프록시 모드를 기록하세요. 클라이언트의 백업 또는 내보내기 기능을 우선 사용해 구독 그룹, 직접 추가한 서버, 사용자 지정 라우팅 및 DNS 설정을 저장하세요. 버전에 따라 설정 저장 방식이 달라질 수 있으므로 제품명이 같다는 이유만으로 덮어쓰기 설치 후 데이터가 유지된다고 보장할 수 없습니다.
백업한 뒤 클라이언트를 종료하고 새 설치 파일을 실행하세요. 데스크톱에서는 창을 닫아도 완전히 종료되지 않고 시스템 트레이에서 계속 실행될 수 있으므로 클라이언트의 종료 메뉴를 사용하세요. Android에서는 VPN 연결을 먼저 끊고 시스템 안내에 따라 업데이트하세요. 업데이트가 끝나면 버전과 설정을 확인하고 정상 작동이 확인된 서버 하나로 테스트한 뒤 다른 고급 설정을 복구하세요.
Desktop에서 WPF로 전환하거나 Android 클라이언트를 다른 제품으로 바꿀 때는 설정 이전 과정으로 생각해야 합니다. 대상 클라이언트가 기존 설정 형식을 가져올 수 있는지 확인하고, 프로토콜, 라우팅 및 DNS 항목이 모두 유지되었는지 살펴보세요. 구독은 다시 가져올 수 있지만 직접 편집한 그룹과 로컬 규칙은 구독과 함께 복구되지 않을 수 있습니다. 따라서 백업과 설정 기록이 중요합니다.
페이지의 버전 표기와 다운로드 경로는 버전 목록의 서로 다른 항목에서 가져오므로 일시적으로 일치하지 않을 수 있습니다. 실제 설치 파일명과 설치 후 정보 화면을 확인하는 편이 정확합니다. 버전 숫자만 보고 파일명을 직접 조합하거나 표기를 맞추려고 여러 패키지를 반복 설치하지 마세요. 현재 정상 작동하는 설정을 먼저 보존하고 업데이트가 필요한지 판단하세요.
업데이트 후 연결에 문제가 생기면 업데이트 전후 설정의 차이를 확인하세요. 시스템 프록시 상태, 선택한 서버, 라우팅 모드 및 DNS는 변경되기 쉬운 항목입니다. 한 번에 하나씩 바꾸고 테스트 결과를 기록하세요. 코어, DNS, TUN 및 서버 설정을 동시에 변경하면 문제를 추적하기 어려워집니다. 자세한 설정 방법은 구독 관리 및 고급 설정을 참고하세요.
먼저 “파일 다운로드 실패”, “프로그램 설치 실패”, “설치 후 연결 실패”를 구분하세요. 다운로드 실패는 브라우저가 파일을 받는 과정에서 발생합니다. 설치 실패는 아키텍처, 시스템 버전, 권한 또는 패키지 의존성 문제인 경우가 많습니다. 연결 실패는 서버 설정과 프록시 상태를 확인해야 합니다. 각 단계의 원인이 다르므로 모든 문제를 재다운로드로 해결하려고 해서는 안 됩니다.
브라우저 다운로드가 완료되었는지 확인하세요. 임시 파일 상태일 수 있습니다. ZIP은 먼저 압축을 풀고, DMG는 시스템 디스크 이미지 도구로 열며, APK는 시스템 설치 프로그램으로 처리하세요. deb와 rpm은 배포판에 맞는 소프트웨어 설치 프로그램을 사용해야 합니다. 파일 형식에 따라 여는 방법이 다르며 확장자를 바꿔도 내용은 바뀌지 않습니다. 브라우저에 다운로드 실패가 표시되면 해당 경로에서 파일을 다시 받으세요.
설치 프로그램의 안내를 빠짐없이 기록하고 아키텍처와 시스템 버전을 먼저 확인하세요. Android에서는 아키텍처 불일치, 서명 충돌, 설치 권한 제한을 구분해야 합니다. Linux에서는 패키지 형식 문제와 의존성 버전 문제를 나누어 확인하세요. 데스크톱에서는 실행 환경 안내도 살펴보세요. 안내를 우회하려고 기존 설정을 삭제하거나 의존성 검사를 강제로 무시하지 말고, 오류가 발생한 단계를 먼저 파악하세요.
기기 자체의 인터넷 연결이 정상인지, 시스템 시간이 맞는지, 구독이 만료되지 않았는지 확인한 다음 선택한 서버와 프록시 모드를 점검하세요. Android에서는 다른 앱이 VPN 연결을 대체하지 않았는지 확인하세요. 데스크톱에서는 프록시를 사용해야 하는 앱이 실제로 시스템 프록시를 따르는지 확인하세요. 연결 아이콘만 보는 것보다 로그의 오류 시간과 해당 요청을 함께 확인하는 편이 도움이 됩니다.
클라이언트가 안정적으로 실행되고 구독도 업데이트되지만 특정 서버만 계속 시간 초과된다면 해당 서버 설정과 서버 측 상태를 먼저 확인하세요. 일부 앱에서만 문제가 발생하면 설치 파일을 바로 바꾸기보다 앱의 프록시 설정, 라우팅 및 DNS를 점검하세요. 증상에 맞는 다음 조치는 도움말 센터에서 확인할 수 있습니다.
서비스 제공자가 전달한 구독 링크나 서버 설정이 필요합니다. 설치 파일에는 그래픽 인터페이스와 실행 구성 요소가 포함되지만, 사용할 수 있는 서버가 자동으로 생성되지는 않습니다. 먼저 설치를 마친 다음 사용 가이드에 따라 설정을 가져오고 서버를 선택한 뒤 알맞은 프록시 모드를 켜세요.
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 Desktop 버전을 우선 선택하세요. 기존 Windows 레이아웃에 익숙하다면 WPF 버전을 사용할 수 있습니다. 두 버전 모두 서버와 구독을 관리하지만 메뉴 위치와 인터페이스 동작은 다를 수 있습니다. 먼저 설정을 백업하고, 테스트 중 두 클라이언트의 시스템 프록시를 동시에 켜지 마세요.
arm64 패키지는 호환되는 64비트 ARM 시스템용입니다. 2015년 이후 출시된 주요 스마트폰이라면 우선 선택할 수 있지만, 실제 기기의 시스템 아키텍처를 확인해야 합니다. 범용 버전은 더 많은 아키텍처를 지원하므로 아키텍처를 알기 어렵거나 여러 기기에서 사용해야 할 때 적합합니다. 프로세서가 64비트를 지원해도 운영체제까지 64비트라는 뜻은 아닙니다.
버전 표기와 실제 설치 패키지 경로는 별도로 관리되므로 업데이트 시점이 맞지 않을 수 있습니다. 선택한 다운로드 경로의 실제 파일명과 설치 후 클라이언트의 정보 화면에서 버전을 확인하세요. 버전 표기만 보고 다운로드 주소를 직접 수정하지 마세요. 업데이트 전에는 설정을 백업하고, 확실하지 않다면 현재 정상 작동하는 버전을 유지하세요.
설정 유지 여부는 클라이언트 버전, 설치 방식, 설정 저장 위치에 따라 달라지므로 덮어쓰기 설치만으로 보장할 수 없습니다. 업데이트 전에 클라이언트의 백업 또는 내보내기 기능을 사용하고 구독 그룹, 라우팅, DNS, 프록시 모드를 기록하세요. 업데이트 후 항목별로 확인하고, 정상 작동이 확인된 서버 하나로 먼저 테스트하세요.
먼저 기기의 네트워크 연결, 시스템 시간, 서버 설정, 시스템 프록시 또는 VPN 상태, 클라이언트 로그를 확인하세요. 설치 성공은 프로그램이 실행된다는 뜻일 뿐 서버에 연결할 수 있다는 의미는 아닙니다. 설치 실패, 파일 누락 또는 실행 오류가 발생한 경우에만 해당 설치 파일을 다시 다운로드하세요.