다운로드 센터 / GUI 클라이언트
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. 먼저 운영체제를 확인한 뒤 프로세서 아키텍처에 맞는 파일을 다운로드하세요.
구독 주소가 있나요? 설치 후 구독 가져오기 안내를 따라 진행하세요. 클라이언트와 서버 설정은 별개이며, 설치 프로그램에 사용할 수 있는 서버가 포함되어 있지는 않습니다.
01 / 운영체제 선택
플랫폼별로 많이 사용하는 설치 파일을 먼저 표시하고, 다른 아키텍처용 파일을 이어서 안내합니다. 탭을 전환한 뒤 주소 표시줄의 링크를 복사하면 현재 플랫폼 페이지를 저장할 수 있습니다.
차세대 크로스 플랫폼 UI입니다. 처음 사용한다면 데스크톱 버전으로 시작해 보세요. 다른 데스크톱 운영체제로 옮겨도 인터페이스와 설정 방식을 쉽게 이어갈 수 있습니다.
기존 Windows 인터페이스를 유지하는 안정적인 버전입니다. WPF 메뉴와 조작 방식에 익숙하다면 이 버전을 계속 사용할 수 있습니다.
두 링크 모두 ZIP 압축 파일을 제공합니다. 파일 전체를 별도 폴더에 압축 해제한 다음, 폴더 안의 설치 프로그램을 실행하고 안내에 따라 설치하세요. 압축 프로그램의 미리보기에서 바로 실행하지 말고, 두 버전의 파일을 같은 폴더에 섞어 두지 마세요.
| 항목 | 선택 및 요구 사항 |
|---|---|
| 시스템 환경 | 지원이 계속되는 Windows 10 또는 11을 권장합니다. 자세한 호환 범위는 선택한 클라이언트 빌드의 요구 사항을 확인하세요. |
| 프로세서 | 이 페이지의 두 설치 파일은 모두 x64입니다. “설정 → 시스템 → 시스템 정보”에서 시스템 종류를 확인하세요. |
| 실행 환경 | 실행할 때 데스크톱 런타임이 없다는 메시지가 표시되면 오류에 나온 구성 요소 이름과 아키텍처를 확인하세요. 클라이언트를 반복해서 덮어 설치하지 마세요. |
| 권한 | 일반 시스템 프록시와 TUN에 필요한 권한은 다릅니다. TUN을 사용할 때만 관리자 권한과 가상 네트워크 인터페이스를 확인하세요. |
처음 실행한 뒤 인터페이스가 정상적으로 열리는지 확인하고 설정을 가져오세요. 처음부터 시스템 프록시와 TUN을 동시에 켜지 마세요. 먼저 시스템 프록시를 사용해 해당 설정을 따르는 브라우저의 연결을 확인한 다음, 기본 연결이 정상일 때 앱에 필요한 방식으로 트래픽 처리 범위를 조정하세요.
WPF에서 Desktop으로 전환하기 전에 클라이언트의 내보내기 또는 백업 기능으로 설정을 저장하고, 로컬 수신 포트와 구독 그룹, 사용자 지정 라우팅도 따로 기록해 두세요. 기존 프로그램을 종료한 뒤 새 프로그램을 실행해 같은 포트를 두 클라이언트가 동시에 사용하지 않도록 하세요. 인터페이스를 바꿔도 모든 설정이 자동으로 이전되는 것은 아니므로, 가져온 뒤 현재 서버와 프록시 모드를 확인해야 합니다.
Apple 칩이 탑재된 Mac용입니다. “이 Mac에 관하여”의 “칩” 항목을 확인한 뒤 arm64 빌드를 선택하세요.
Intel 프로세서가 탑재된 Mac용입니다. 기기를 구매한 연도가 아니라 실제 프로세서에 맞춰 선택하세요.
다운로드한 DMG를 열고 앱을 “응용 프로그램” 폴더로 옮긴 다음 해당 폴더에서 실행하세요. 마운트된 디스크 이미지에서 계속 실행하면 업데이트, 권한 기록, 앱 경로가 일관되게 유지되지 않을 수 있습니다.
| 항목 | 선택 및 요구 사항 |
|---|---|
| 시스템 버전 | “이 Mac에 관하여”에서 macOS 버전을 확인하세요. 최소 시스템 요구 사항은 현재 빌드의 설치 안내를 따릅니다. |
| 칩 아키텍처 | Apple Silicon은 arm64, Intel은 x64를 선택하세요. 하드웨어에 맞는 네이티브 빌드를 우선 권장합니다. |
| 설치 위치 | 앱을 “응용 프로그램” 폴더로 옮긴 뒤 실행하세요. 업데이트 전에 실행 중인 기존 앱을 종료하세요. |
| 네트워크 권한 | 시스템 프록시와 TUN은 서로 다른 권한 요청을 표시할 수 있습니다. 현재 작업에 필요한 권한만 허용하세요. |
시스템에서 앱 실행을 차단하면 먼저 안내 메시지를 읽고 보안 확인, 아키텍처 비호환, 낮은 시스템 버전 중 어떤 문제인지 구분하세요. 파일 출처와 설치 위치를 확인한 뒤 시스템에서 제공하는 보안 설정 절차를 따르세요. 앱 하나를 실행하려고 시스템 보호 기능을 전역으로 끄지 마세요.
앱이 실행되면 구독을 가져오고 서버를 선택한 뒤 필요한 프록시 방식을 활성화하세요. 브라우저에서 프록시가 작동하지 않으면 현재 네트워크 서비스의 프록시 설정과 브라우저 자체 연결 옵션을 확인하세요. TUN을 켜기 전에 일반 연결을 먼저 검증해야 권한이나 가상 인터페이스 문제와 서버 설정 문제를 구분할 수 있습니다.
2015년 이후 출시된 대부분의 스마트폰에서 우선 선택할 수 있습니다. 시스템이 64비트 ARM 앱을 지원하는지 확인하세요. 하드웨어가 지원하더라도 시스템에서 지원하지 않을 수 있습니다.
여러 아키텍처를 지원합니다. 기기의 아키텍처를 모를 때 선택할 수 있지만, 단일 아키텍처 빌드보다 설치 파일이 클 수 있습니다.
Android 클라이언트를 처음 사용한다면 v2rayNG를 먼저 선택해 보세요. 설정을 가져온 뒤 처음 연결할 때 VPN 권한 요청이 표시됩니다. 방금 설치한 클라이언트에서 보낸 요청인지 확인한 다음 로컬 VPN 인터페이스 생성을 허용하세요.
V2Fly 코어 계열이 필요하고 arm64 앱을 지원하는 시스템을 사용하는 기기에 적합합니다. 선택하기 전에 구독에서 필요한 기능과 클라이언트의 호환성을 확인하세요.
앱 아키텍처를 확인하기 어려운 기기용입니다. 범용 버전은 아키텍처 선택을 간소화할 뿐, 모든 프로토콜 확장을 지원한다는 뜻은 아닙니다.
v2flyNG는 대안 클라이언트이지 v2rayNG의 다른 설치 파일이 아닙니다. 두 앱은 코어 계열이 다르므로 이름이 비슷하다고 기능까지 같다고 보면 안 됩니다. 전환할 때는 기존 앱의 설정을 보존하고, 새 앱이 필요한 항목을 제대로 인식하는지 확인하세요.
| 항목 | 선택 및 요구 사항 |
|---|---|
| 시스템 호환성 | 시스템이 선택한 APK의 최소 버전 요구 사항을 충족해야 합니다. 설치 프로그램에서 호환되지 않는다고 표시되면 시스템 버전과 아키텍처를 먼저 확인하세요. |
| 앱 아키텍처 | 64비트 ARM 앱을 지원한다면 arm64를 선택하세요. 잘 모르겠다면 범용 버전을 선택한 뒤 설치 프로그램의 안내에 따라 문제를 확인하세요. |
| 설치 권한 | 현재 APK를 여는 브라우저나 파일 관리자에만 앱 설치 권한을 허용하세요. 설치를 마친 뒤에는 권한을 취소할 수 있습니다. |
| VPN 및 백그라운드 실행 | 연결하려면 시스템 VPN 권한이 필요합니다. 백그라운드에서 자주 연결이 끊기면 배터리 최적화, 백그라운드 실행 제한, 다른 VPN 앱을 확인하세요. |
APK를 열고 시스템 설치 프로그램의 안내에 따라 설치하세요. 기존 앱 위에 설치하지 못하더라도 바로 삭제하지 마세요. 앱 이름, 빌드 종류, 서명이 일치하는지 먼저 확인하세요. 앱을 삭제하면 구독과 로컬 설정이 사라질 수 있으므로, 먼저 앱에서 지원하는 방법으로 백업하세요.
일반적으로 시스템에서 활성 상태로 사용할 수 있는 VPN 서비스는 하나뿐입니다. 연결을 제어하는 다른 VPN 앱을 종료한 뒤 시작하세요. 화면이 꺼진 뒤 연결이 끊기고 앱을 열어 두면 정상이라면 구독을 바꾸기 전에 배터리 설정과 백그라운드 제한을 확인하세요. 제조사마다 메뉴 이름이 다를 수 있으므로 시스템 설정에서 앱의 배터리 및 백그라운드 권한을 검색하세요.
Debian, Ubuntu 등 deb 패키지 관리자를 사용하는 배포판용입니다. 시스템 아키텍처를 확인한 뒤 그래픽 소프트웨어 설치 프로그램으로 여세요.
rpm 패키지 관리자를 사용하는 배포판용입니다. 패키지 형식이 같아도 시스템 의존성이 호환된다는 보장은 없습니다. 설치 전에 소프트웨어 설치 프로그램의 의존성 안내를 확인하세요.
이 페이지에서는 데스크톱 GUI 클라이언트를 제공합니다. 그래픽 데스크톱 세션에 로그인되어 있는지 확인한 뒤 설치하고 실행하세요. 원격 터미널만 사용할 수 있는 환경에서는 이 페이지의 데스크톱 안내를 그대로 따르지 마세요.
| 항목 | 선택 및 요구 사항 |
|---|---|
| 패키지 형식 | 배포판의 패키지 관리자에 맞춰 deb 또는 rpm을 선택하세요. 파일 확장자를 바꿔 패키지 형식을 변환하지 마세요. |
| 프로세서 아키텍처 | amd64와 x86_64는 여기서 x64에 해당하고, arm64와 aarch64는 여기서 arm64에 해당합니다. |
| 데스크톱 및 의존성 | 그래픽 데스크톱과 빌드에 필요한 런타임 의존성이 필요합니다. 구체적인 의존성은 시스템 설치 프로그램에서 확인하세요. |
| 프록시 권한 | 데스크톱 환경의 프록시 설정을 앱이 따르는지 항목별로 확인해야 합니다. TUN을 사용하려면 기기와 권한 조건도 확인하세요. |
그래픽 소프트웨어 설치 프로그램에서 패키지를 열고 의존성 목록을 확인한 뒤 설치를 진행하세요. 필요한 의존성 버전이 부족하다는 메시지가 나오면 배포판 호환성과 시스템 소프트웨어 저장소 상태를 먼저 확인하고, 의존성 검사를 강제로 무시하지 마세요. 업데이트할 때도 같은 패키지 관리 방식을 사용해 수동 설치 파일과 패키지 관리자 기록이 뒤섞이지 않도록 하세요.
클라이언트가 실행되더라도 모든 앱이 데스크톱 환경의 프록시 설정을 따르는 것은 아닙니다. 먼저 프록시를 명시적으로 지원하는 앱으로 확인한 뒤 TUN이 필요한지 판단하세요. 브라우저에서는 작동하지만 다른 앱에서 작동하지 않는다면 앱의 프록시 방식과 트래픽 처리 범위를 확인하세요. 클라이언트 자체가 시작되지 않는다면 실행 환경과 권한 안내를 살펴보세요.
02 / 설치 후 다음 단계
먼저 기본 연결을 확인한 뒤 라우팅과 트래픽 처리 범위를 추가하세요. 문제가 생겼을 때 어느 단계에서 발생했는지 파악하기 쉽습니다.
v2rayN에서 “구독 그룹 → 구독 그룹 설정”을 열고 그룹을 추가한 뒤 구독 주소를 저장하고 구독 내용을 업데이트하세요. 인터페이스 버전에 따라 메뉴 이름이 조금 다를 수 있지만 순서는 같습니다. 먼저 구독 주소를 저장하고 목록을 업데이트한 다음 사용할 서버를 선택하세요. Android 클라이언트에서는 설정 추가 메뉴에서 구독이나 설정 링크를 가져올 수 있습니다.
서버 목록이 표시되면 사용할 서버를 지정하고 시스템 프록시 또는 Android VPN 연결을 활성화하세요. 현재 프록시 방식을 따르는 앱을 열어 연결을 확인하세요. 지연 시간 테스트에 성공했다고 모든 앱의 트래픽이 처리되는 것은 아니며, 한 번의 다운로드 속도 측정만으로 장기적인 연결 품질을 판단할 수도 없습니다.
기본 연결이 정상이라면 필요에 따라 중국 본토 우회 등 라우팅을 설정하세요. 라우팅은 클라이언트에 들어온 트래픽을 어떤 아웃바운드로 보낼지 결정하며 모든 앱의 트래픽을 자동으로 클라이언트에 전달하지는 않습니다. 더 많은 앱의 트래픽을 처리해야 한다면 TUN 권한과 충돌 확인 절차를 읽은 뒤 해당 모드를 활성화하세요.
03 / 다운로드 관련 문제
사용할 수 있는 서버 설정이나 구독 주소가 필요합니다. 클라이언트는 설정을 가져오고 아웃바운드를 선택해 프록시를 구성하는 프로그램이며, 서버를 자동으로 제공하지는 않습니다. 설정을 준비했다면 구독을 가져온 뒤 서버를 선택하고 연결을 확인하세요.
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 Desktop을 먼저 선택해 보세요. 기존 인터페이스에 익숙하거나 기존 작업 방식을 유지하려면 WPF가 적합합니다. 둘 다 v2rayN 버전이므로 전환 전에 설정을 백업하고, 두 프로그램이 같은 포트를 동시에 사용하지 않도록 하세요.
arm64는 64비트 ARM 앱을 지원하는 기기용입니다. 2015년 이후 출시된 대부분의 스마트폰은 우선 arm64를 선택해도 됩니다. 범용 버전은 여러 아키텍처를 지원하므로 기기의 아키텍처를 모를 때 적합합니다. 단, 실제로 지원되는 앱 아키텍처는 기기의 시스템을 기준으로 확인해야 합니다.
대개 먼저 백업한 다음 기존 설치 방식대로 업데이트하면 됩니다. 삭제를 기본 절차로 삼지 마세요. 데스크톱에서는 프로그램을 종료한 뒤 업데이트하고, Android에서는 보통 기존 앱 위에 설치할 수 있습니다. 서명이 일치하지 않는다는 메시지가 나오면 패키지 출처와 빌드 종류를 먼저 확인하세요. 앱 데이터를 잃을 수 있으니 바로 삭제하지 마세요.
버전 표기와 설치 파일 경로는 배포 목록의 별도 항목이며 업데이트 시점이 다를 수 있습니다. 설치된 버전은 클라이언트의 정보 화면에서 확인하세요. 파일은 플랫폼, 프로세서 아키텍처, 패키지 형식에 맞춰 선택하고 파일명 숫자만으로 호환성을 판단하지 마세요.
먼저 구독을 가져왔는지, 서버를 선택했는지, 시스템 프록시나 VPN 권한이 활성화되어 있는지 확인한 뒤 실행 로그를 살펴보세요. 패키지가 손상됐거나 아키텍처가 맞지 않는 경우, 프로그램이 시작되지 않는 경우처럼 설치 단계의 문제가 확인될 때 설치 파일을 점검하면 됩니다.
클라이언트는 실행되지만 연결이 원활하지 않나요? 증상에 따라 문제 해결을 확인하세요. 세 클라이언트의 기능을 비교하려면 클라이언트 선택을 살펴보세요.