클라이언트 설치 파일 · 플랫폼 선택
먼저 운영체제를 선택한 다음 프로세서 아키텍처를 고르세요. 데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 우선 추천하며 v2flyNG는 대안으로 사용할 수 있습니다.
처음 설치하시나요? 구독 가져오기 및 연결 가이드 보기 →두 인터페이스 버전 모두 x64 설치 파일입니다. 사용 방식에 맞춰 하나만 선택하면 되며, 둘 다 설치할 필요는 없습니다.
Desktop 버전
v2rayN Desktop 다운로드클래식 WPF 버전
v2rayN WPF 버전 다운로드Desktop 버전은 차세대 크로스 플랫폼 UI를 사용하며, 처음 사용하거나 여러 데스크톱 시스템에서 비슷한 사용 경험을 원하는 분에게 적합합니다. WPF 버전은 익숙한 창 구성과 서버 목록, 메뉴 및 설정 경로를 유지합니다. 인터페이스가 다르더라도 구독이 필요 없는 것은 아닙니다. 두 버전 모두 유효한 서버 구성을 먼저 가져와야 합니다.
이 파일은 ZIP 압축 파일입니다. 모든 파일을 쓰기 가능한 디렉터리에 압축 해제한 다음 안에 있는 설치 프로그램을 실행하세요. 압축 파일 미리보기에서 바로 실행하지 마세요. 업데이트할 때는 알림 영역에서 실행 중인 이전 클라이언트를 종료하세요. 파일이 사용 중이라는 메시지가 나오면 관련 프로세스가 종료되었는지 확인한 뒤 계속 진행하세요.
| 확인 항목 | 요구 사항 및 확인 위치 |
|---|---|
| 시스템 및 아키텍처 | 이 페이지에서는 x64 패키지를 제공합니다. ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하세요. 32비트 시스템에서는 이 설치 파일을 사용할 수 없습니다. |
| 실행 환경 | 운영체제 버전과 데스크톱 런타임이 선택한 버전의 요구 사항을 충족해야 합니다. 런타임이 없다는 오류가 표시되면 오류 메시지에 나온 버전과 아키텍처를 기준으로 확인하세요. |
| 디렉터리 권한 | 압축 해제 및 데이터 디렉터리에 쓸 수 있는 공간이 필요합니다. 임시 압축 폴더에서 실행하지 말고, 실행 중인 프로그램 파일을 덮어쓰지 마세요. |
| 네트워크 권한 | 시스템 프록시와 TUN은 서로 다른 트래픽 경로입니다. 먼저 일반 연결을 확인하고, TUN이 필요할 때 시스템 안내에 따라 권한을 설정하세요. |
실행 직후 종료된다면 팝업 문구를 먼저 기록한 다음 런타임과 디렉터리 권한을 확인하세요. 인터페이스 버전을 번갈아 설치하는 방식으로 문제를 해결하려고 하지 마세요. 시작 직후 종료 문제 해결 방법을 참고할 수 있습니다.
먼저 ‘이 Mac에 관하여’에서 칩 종류를 확인하세요. Apple Silicon과 Intel용 DMG 설치 파일이 각각 제공됩니다.
Apple Silicon
v2rayN 다운로드 · Apple SiliconIntel
v2rayN 다운로드 · IntelApple 메뉴에서 ‘이 Mac에 관하여’를 여세요. ‘칩’ 항목에 Apple M 시리즈 이름이 표시되면 Apple Silicon을 선택하고, Intel 프로세서 이름이 표시되면 Intel을 선택하세요. 제품 외관이나 구매 연도, 화면 크기로 아키텍처를 추측하지 마세요. 같은 제품군이라도 프로세서가 다를 수 있습니다.
다운로드한 DMG를 열고 디스크 이미지의 안내에 따라 앱을 ‘응용 프로그램’으로 옮긴 뒤 그 위치에서 실행하세요. 처음 실행할 때 보안 알림이 표시되면 파일 출처와 안내 내용을 먼저 확인한 다음 ‘시스템 설정 → 개인정보 보호 및 보안’에서 해당 조치를 확인하세요. 앱 하나를 실행하려고 시스템 보안 기능 전체를 끄지 마세요.
| 확인 항목 | 요구 사항 및 확인 위치 |
|---|---|
| 칩 종류 | Apple Silicon은 arm64, Intel은 x64에 해당합니다. 파일 이름으로 기기 종류를 추측하지 말고 ‘이 Mac에 관하여’에서 확인하세요. |
| 시스템 버전 | 현재 앱 빌드의 요구 사항을 충족해야 합니다. 시스템 버전이 호환되지 않는다는 메시지가 나오면 다른 아키텍처를 반복해서 시도하지 말고 기기의 시스템 버전을 먼저 확인하세요. |
| 설치 위치 | 사용 가능한 공간을 충분히 확보하고 ‘응용 프로그램’ 디렉터리에 설치할 권한이 있는지 확인하세요. 앱을 교체하기 전에 실행 중인 기존 앱을 종료하세요. |
| 연결 권한 | 프록시 설정을 처음 변경하거나 TUN을 사용할 때 권한 승인 메시지가 표시될 수 있습니다. 기능과 용도를 확인한 뒤 필요한 권한만 승인하세요. |
앱은 실행되지만 브라우저에서 대상 웹사이트에 접속할 수 없다면 선택한 서버와 시스템 프록시 상태를 먼저 확인하세요. 설치 파일의 아키텍처는 설치와 실행 가능 여부에 영향을 줄 뿐, 연결 설정을 대신 확인해 주지는 않습니다.
먼저 v2rayNG를 살펴보고, 기존 구성에 따라 v2flyNG를 대안으로 고려하세요. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택할 수 있지만, 최종적으로는 기기에서 지원하는 아키텍처를 확인해야 합니다.
arm64
v2rayNG 다운로드 · arm64범용 버전
v2rayNG 다운로드 · 범용 버전v2rayNG는 Xray 코어를 사용하며 Android에서 구독, 공유 링크, QR 코드 구성을 가져오는 데 적합합니다. 처음 선택하는 클라이언트로 사용할 수 있으며, 구성에 사용된 프로토콜과 전송 방식, 보안 매개변수를 확인하세요. 클라이언트가 특정 프로토콜을 지원하더라도 서버의 모든 매개변수 조합을 사용할 수 있다는 뜻은 아닙니다.
APK 다운로드가 완료되면 브라우저의 다운로드 목록이나 파일 관리자에서 파일을 여세요. 시스템에서 현재 출처의 앱 설치를 허용하라고 요청하면 이번 설치에 사용할 브라우저나 파일 관리자에만 해당 권한을 부여하세요. 설치가 끝난 뒤에는 권한을 취소할 수 있습니다. 처음 연결할 때 VPN 연결 요청이 표시되는 것은 시스템 권한 승인 절차입니다. 앱 이름을 확인한 후 계속 진행하세요.
arm64
v2flyNG 다운로드 · arm64범용 버전
v2flyNG 다운로드 · 범용 버전v2flyNG는 v2fly 코어를 사용하며 기존 V2Fly 구성이 필요한 경우 대안으로 적합합니다. v2rayNG와 마찬가지로 Android용 GUI 클라이언트이지만 코어 기능과 지원 매개변수는 완전히 같지 않습니다. 이름만 다른 동일한 설치 파일로 생각하지 마세요. 전환하기 전에 구성 호환성을 항목별로 확인하세요.
두 클라이언트 사이를 전환할 때는 기존 클라이언트의 연결을 먼저 중지한 다음 다른 클라이언트를 실행하세요. 옮겨야 할 설정은 유효한 구독이나 단일 서버 공유 방식으로 다시 가져오는 것이 좋습니다. 앱 전체 백업이 서로 호환된다고 가정하지 마세요. 구독을 업데이트한 뒤에는 선택한 서버, 라우팅, DNS를 다시 확인해 다른 클라이언트의 상태를 기준으로 연결 결과를 판단하지 않도록 하세요.
| 확인 항목 | 요구 사항 및 확인 위치 |
|---|---|
| 프로세서 아키텍처 | arm64 패키지를 사용하려면 시스템이 해당 아키텍처를 지원해야 합니다. 하드웨어가 64비트여도 시스템에서 해당 실행 환경을 제공하지 않을 수 있습니다. 확실하지 않다면 범용 버전을 시도해 보세요. |
| 시스템 호환성 | 설치 프로그램에 표시된 최소 시스템 요구 사항을 확인하세요. 범용 버전은 아키텍처 선택 문제를 해결할 뿐 앱 자체의 시스템 요구 사항을 낮춰 주지는 않습니다. |
| 설치 권한 | 현재 출처에서 앱을 설치하도록 허용하고 저장 공간이 충분한지 확인하세요. 조직의 기기 관리 정책이나 기기 제한으로 설치가 차단될 수 있습니다. |
| 백그라운드 실행 | 연결하려면 시스템 VPN 권한이 필요합니다. 화면을 끈 뒤 연결이 끊긴다면 배터리 최적화와 백그라운드 활동 설정을 확인하세요. 미리 모든 권한을 허용할 필요는 없습니다. |
설치 프로그램에서 서명 충돌을 알리면 기존 앱의 출처와 백업 방법부터 확인하세요. 바로 앱을 삭제하지 마세요. 삭제하면 로컬 설정이 사라질 수 있습니다. 오류 정보를 보관한 뒤 데이터 이전이 필요한지 판단하세요.
먼저 배포판에 맞는 deb 또는 rpm 패키지를 선택한 뒤 x64와 arm64를 확인하세요. 파일 확장자는 패키지 관리 방식에 대응하므로 이름을 바꿔 서로 바꿔 사용할 수 없습니다.
deb · x64
v2rayN 다운로드 · debrpm · x64
v2rayN 다운로드 · rpmdeb 패키지 관리 방식을 사용하는 데스크톱 배포판에서는 deb를, rpm 방식을 사용하는 배포판에서는 rpm을 선택하세요. 패키지 형식을 맞추는 것은 첫 단계일 뿐이며 현재 빌드의 의존성과 시스템 환경 요구 사항도 충족해야 합니다. 특히 rpm 파일은 배포판에서 열 수 있다는 이유만으로 모든 의존성이 충족된다고 볼 수 없습니다.
다운로드한 파일을 시스템의 그래픽 소프트웨어 설치 프로그램으로 열어 아키텍처, 의존성, 설치 확인 내용을 살펴보세요. 설치가 끝나면 앱 메뉴에서 v2rayN을 실행합니다. 데스크톱 환경마다 시스템 프록시를 적용하는 방식이 다를 수 있습니다. 브라우저에서는 연결되지만 다른 프로그램에서 작동하지 않는다면 클라이언트를 다시 설치하기 전에 해당 앱이 데스크톱 프록시 설정을 사용하는지 확인하세요.
| 확인 항목 | 요구 사항 및 확인 위치 |
|---|---|
| 데스크톱 환경 | 이 페이지에서 제공하는 것은 GUI 클라이언트입니다. 해당 데스크톱 앱을 실행할 수 있는 시스템 환경이 필요하며, 서버 백그라운드 서비스 방식으로 설치하는 프로그램이 아닙니다. |
| 아키텍처 이름 | amd64와 x86_64는 이 페이지의 x64에 해당하며, aarch64는 대체로 arm64에 해당합니다. 시스템 정보에서 확인한 뒤 선택하세요. |
| 의존성 및 권한 | 그래픽 패키지 관리자로 누락된 의존성을 확인하고 시스템에서 요구하는 방식으로 설치 권한을 승인하세요. 그래픽 클라이언트를 관리자 권한으로 계속 실행하지 마세요. |
| 프록시 경로 | 데스크톱 시스템 프록시를 모든 앱이 사용하는 것은 아닙니다. 다른 트래픽까지 처리해야 한다면 TUN의 권한 및 라우팅 안내를 확인하세요. |
소프트웨어 설치 프로그램에서 의존성을 충족할 수 없다고 표시되면 누락된 구성 요소 이름과 배포판 버전을 기록한 뒤 지원 환경을 확인하세요. 파일 확장자를 바꾸거나 의존성을 무시하거나 다른 패키지 관리 방식을 섞어 쓰는 것은 적절한 해결 방법이 아닙니다.
처음 설치하는 경우와 기존 설치를 덮어 업데이트하는 경우는 다릅니다. 이미 사용할 수 있는 설정이 있다면 클라이언트의 백업 또는 내보내기 기능으로 구독 그룹, 사용자 지정 라우팅, 유지할 설정을 저장하세요. 백업 파일에 연결 정보가 포함될 수 있으므로 직접 관리할 수 있는 위치에 보관하세요. 서버 별칭만 기억해 두는 것으로는 새 환경에서 설정을 복원하기 어렵습니다.
업데이트 전에 메인 창과 알림 영역의 프로세스를 종료하고 연결이 중지될 때까지 기다린 다음 새 설치 프로그램을 실행하세요. 업데이트가 끝나면 구독이 남아 있는지, 기본 서버가 올바른지, 로컬 포트가 바뀌었는지 확인한 뒤 실제 연결을 테스트하세요. 여러 기기를 사용하더라도 데스크톱의 데이터 디렉터리 전체를 Android 앱에 덮어쓰지 마세요. 클라이언트 간 이전에는 호환되는 구독이나 공유 링크를 이용하는 것이 좋습니다.
세 가지 클라이언트를 비교하려면 클라이언트 비교를 확인하세요. 라우팅 규칙, DNS, TUN 설정 방법은 고급 사용법에서 안내합니다. 기본 연결이 확인된 뒤 항목별로 조정하는 것을 권장합니다.
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 Desktop 버전을 선택할 수 있습니다. 기존 창 구성과 익숙한 사용 흐름을 선호한다면 안정적인 클래식 WPF 버전이 적합합니다. 두 버전 모두 유효한 구성을 가져와야 합니다. 인터페이스 버전을 바꾸기 전에 현재 구성을 백업하고 실행 중인 클라이언트를 종료한 다음 새 버전을 실행하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택해도 되지만, 실제 지원 아키텍처는 기기 시스템에서 확인해야 합니다. 설치 파일이 기기와 호환되지 않는다는 메시지가 나오면 범용 버전을 사용해 보세요. 범용 버전은 여러 아키텍처를 포함하므로 파일 크기가 더 큰 편입니다. 다만 낮은 시스템 버전, 서명 충돌, 저장 공간 부족 문제까지 해결해 주지는 않습니다.
네. 클라이언트는 설정을 읽고 서버를 관리하며 트래픽 경로를 지정하지만, 설치 파일에 바로 연결할 수 있는 서버가 포함되어 있지는 않습니다. 사용할 권한이 있는 구독 주소, 공유 링크 또는 구성 파일을 가져오세요. 구독 주소에 접속 정보가 포함될 수 있으니 공개적으로 공유하거나 문제를 설명하는 스크린샷에 넣지 마세요.
유지 여부는 설치 방식, 데이터 디렉터리, 버전 간 마이그레이션 방식에 따라 다르므로 설치 파일 이름만으로 판단할 수 없습니다. 업데이트 전에 클라이언트의 백업 또는 내보내기 기능으로 설정을 저장하고 현재 데이터 디렉터리를 확인하세요. 이전 버전을 종료한 뒤 업데이트하고, 구독·라우팅·로컬 포트가 정상적으로 복원되었는지 확인한 후 이전 파일을 정리하세요.
먼저 운영체제와 프로세서 아키텍처가 맞는지, 다운로드한 파일이 정상적으로 저장되었는지 확인하세요. Windows 압축 파일은 먼저 풀고, 런타임이 없다는 오류는 안내된 내용에 따라 처리합니다. macOS에서는 칩 종류와 시스템 보안 알림을, Android에서는 설치 프로그램의 호환성 또는 서명 정보를, Linux에서는 그래픽 패키지 관리자의 의존성 안내를 확인하세요. 구체적인 오류 문구를 기록하고 같은 파일을 반복해서 덮어 설치하지 마세요.
먼저 브라우저의 다운로드 목록에서 작업이 일시 중지되었거나 차단되었는지, 저장 위치를 기다리고 있는지 확인하세요. 페이지는 같은 출처의 버전 목록을 읽어 다운로드 주소를 갱신하며, 읽기에 실패하면 페이지에 이미 등록된 설치 파일 링크를 유지합니다. 새로고침한 뒤 다시 시도해 보세요. 그래도 실패하면 선택한 플랫폼과 파일 종류, 브라우저 오류를 기록하고 파일 경로나 확장자를 임의로 바꾸지 마세요.
먼저 플랫폼과 아키텍처를 확인한 뒤 구성을 가져오세요. 업데이트 전에는 복원할 수 있는 백업을 보관하세요.