CLIENT PACKAGES / 클라이언트 설치 파일
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 권장합니다. 먼저 운영체제와 CPU 아키텍처를 확인한 뒤 알맞은 설치 파일 형식을 선택하세요.
SELECT YOUR SYSTEM
아키텍처가 다른 설치 파일은 서로 바꿔 사용할 수 없습니다.
버전 정보는 각 클라이언트 카드에서 확인하세요.
Windows용으로는 두 가지 인터페이스 버전이 제공되며, 모두 x64 설치 파일입니다. 처음 사용하는 경우 데스크톱 버전을 권장합니다. 기존 메뉴와 트레이 조작 방식에 익숙하다면 클래식 WPF 버전을 계속 사용할 수 있습니다. 두 버전 모두 노드, 구독, 라우팅을 관리하며, 일반적인 연결을 위해 둘 다 설치하거나 실행할 필요는 없습니다.
Desktop: 새로운 크로스 플랫폼 UI를 사용합니다. 처음 설치하거나 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하고 싶은 분에게 적합합니다.
클래식 안정 버전: 기존 Windows 조작 환경을 유지합니다. 기존 설정을 옮기기 전에 구독 그룹과 사용자 지정 규칙을 백업하세요.
다운로드 파일은 ZIP 형식입니다. 압축 파일 전체를 별도 폴더에 풀고, 폴더 안의 설치 프로그램 안내에 따라 설치하세요. 압축 파일 미리보기 창에서 프로그램을 바로 실행하지 마세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 시스템 아키텍처 | 이 페이지에서는 x64 파일을 제공합니다. ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하세요. |
| 설치 파일 형식 | ZIP 압축 파일입니다. 다운로드한 뒤 압축을 풀고 안에 있는 설치 프로그램을 실행하세요. |
| 실행 환경 | 구체적인 운영체제 및 런타임 요구 사항은 선택한 설치 프로그램의 안내를 확인하세요. |
| 권한 | 일반 설정과 TUN 기능에 필요한 권한은 다릅니다. 사용할 기능과 시스템 안내에 따라 권한을 허용하세요. |
런타임 관련 안내가 표시되면 안내에 명시된 구성 요소부터 확인하세요. 프로그램이 시작되지 않는 문제를 노드 연결 문제로 오해하지 마세요. 인터페이스 버전을 바꾸면 메뉴 위치가 달라질 수 있으므로 설정 이름으로 찾아보세요.
macOS 설치 파일은 DMG 형식이며 Apple Silicon과 Intel용으로 나뉩니다. 다운로드 전에 시스템 메뉴에서 ‘이 Mac에 관하여’를 열어 ‘칩’ 또는 ‘프로세서’ 항목을 확인하세요. 컴퓨터 이름, 화면 크기, 구입 연도로 아키텍처를 판단할 수는 없습니다.
arm64: Apple M 시리즈 칩에 적합합니다. 칩의 기본 아키텍처와 일치하는 설치 파일을 우선 선택하세요.
Intel: ‘이 Mac에 관하여’에 Intel 프로세서가 표시되는 기기에 적합합니다. 시스템 인터페이스의 외관으로 판단하지 마세요.
DMG를 연 뒤 설치 창의 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮기고 해당 폴더에서 실행하세요. 업데이트할 때는 파일이 사용 중인 상태로 교체되지 않도록 실행 중인 클라이언트를 먼저 종료하세요.
| 확인 항목 | 선택 기준 |
|---|---|
| Apple Silicon | ‘이 Mac에 관하여’에 Apple M 시리즈 칩이 표시되면 arm64를 선택하세요. |
| Intel | ‘이 Mac에 관하여’에 Intel 프로세서가 표시되면 x64를 선택하세요. |
| 운영체제 버전 | 앱 배포 요구 사항과 시스템 설치 안내를 확인하세요. 오래된 시스템에서는 실행되지 않을 수 있습니다. |
| 네트워크 권한 | 시스템 프록시와 가상 네트워크 인터페이스에서 각각 권한을 요청할 수 있습니다. |
처음 실행할 때 시스템 보안 안내가 표시되면 앱의 출처와 구체적인 안내 내용을 먼저 확인한 뒤, 시스템이 제공하는 권한 설정 절차를 따르세요. 앱 하나를 실행하기 위해 시스템 전체의 보안 기능을 끄지 마세요.
Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 권장합니다. V2Fly 코어 환경이 필요하다면 v2flyNG를 선택할 수 있습니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택하면 됩니다. 출시 연도는 참고 기준일 뿐이며 기기마다 아키텍처와 시스템 환경이 다를 수 있으니, 확인이 어려우면 범용 버전을 선택하세요.
대부분의 arm64 기기에 적합합니다. 처음 설치한다면 이 파일을 먼저 다운로드한 뒤 시스템 안내에 따라 설치하세요.
기기 아키텍처를 확인하기 어려울 때 선택할 수 있는 설치 파일입니다. 범용 버전도 시스템 버전 요구 사항을 우회하지는 못합니다.
구독을 가져온 뒤 노드를 선택하세요. 처음 연결을 시작하면 시스템에서 VPN 연결을 요청합니다. 현재 설치한 클라이언트에서 보낸 요청인지 확인한 다음 안내에 따라 허용하세요.
V2Fly 코어가 필요하고 arm64 아키텍처를 사용하는 기기에 적합합니다.
기기 아키텍처를 확인하기 어렵다면 범용 버전을 선택할 수 있습니다. 설치 전에 시스템 호환성 안내도 확인하세요.
코어에 따라 지원하는 프로토콜과 전송 방식이 다를 수 있습니다. 설정을 옮기기 전에 노드의 프로토콜, 전송 방식, 보안 매개변수를 확인하세요. 구독 이름만으로 호환성을 판단하지 마세요.
| 확인 항목 | 설명 | 안내가 표시되면 |
|---|---|---|
| arm64 / 범용 버전 | 대부분의 스마트폰은 arm64를 우선 선택하고, 아키텍처를 확인하기 어렵다면 범용 버전을 선택하세요. | ‘기기와 호환되지 않음’ 안내가 표시되면 아키텍처와 시스템 버전을 모두 확인하세요. |
| 설치 출처 | APK를 브라우저나 파일 관리자에서 엽니다. | 설치를 실행하는 앱에만 권한을 허용하고 설치가 끝난 뒤에는 권한을 해제할 수 있습니다. |
| 기존 앱 | 기존 앱 위에 설치할 수 있는지는 앱 서명과 버전 관계에 따라 달라집니다. | 서명 충돌이 발생하면 먼저 설정을 백업하고 배포 경로를 확인한 뒤 해결하세요. |
| 연결 권한 | 클라이언트는 시스템 VPN 인터페이스를 통해 선택한 트래픽을 처리합니다. | 다른 VPN 앱이 같은 연결을 사용 중일 수 있으므로 먼저 확인하세요. |
Linux에서는 먼저 배포판의 패키지 형식을 확인한 다음 CPU 아키텍처를 확인하세요. Debian 및 Ubuntu 계열은 보통 deb를 선택하고, RPM 패키지 관리 체계를 사용하는 배포판은 rpm을 선택합니다. 패키지 형식이 같아도 의존성이 완전히 같은 것은 아닙니다. 실제 호환성은 배포판, 패키지 의존성, 설치 안내를 기준으로 확인하세요.
Debian / Ubuntu 계열: x64 기기에 적합하며 시스템 패키지 설치 도구로 설치합니다.
RPM 패키지 관리 체계: 선택 전에 배포판과 의존성 요구 사항을 확인하세요. 특히 시스템 라이브러리 호환성 안내에 유의하세요.
설치가 끝나면 데스크톱 앱 메뉴에서 실행하세요. 패키지 관리자가 의존성 누락을 알리면 해당 의존성과 배포판 호환성 문제를 먼저 해결하세요. 설치 검사를 강제로 건너뛰지 마세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 패키지 형식 | 배포판의 패키지 관리 체계에 따라 deb 또는 rpm을 선택하세요. |
| x64 | amd64와 x86_64는 일반적으로 같은 64비트 아키텍처를 가리킵니다. |
| arm64 | arm64와 aarch64는 ARM 64비트 아키텍처를 가리킵니다. |
| 실행 환경 | 지원되는 데스크톱 그래픽 환경과 설치 파일에서 요구하는 시스템 의존성이 필요합니다. |
| 권한 | 패키지 설치와 TUN 사용에는 추가 시스템 권한이 필요할 수 있습니다. |
데스크톱의 시스템 프록시 설정을 모든 앱이 사용하는 것은 아닙니다. 브라우저, 터미널 도구, 백그라운드 서비스에서 각각 확인하세요. TUN을 사용하는 경우에는 가상 네트워크 인터페이스, 권한, 라우팅 설정도 별도로 점검해야 합니다.
INSTALL → IMPORT → CONNECT
설치 파일은 클라이언트를 설치하는 용도입니다. 설정, 권한 허용, 연결 확인은 각각 진행해야 문제가 생긴 단계를 파악할 수 있습니다. 처음 설치할 때 DNS, 사용자 지정 라우팅, TUN 같은 고급 설정을 바로 변경할 필요는 없습니다.
먼저 파일 형식과 기기 아키텍처를 확인하고 시스템에 표시된 구체적인 안내를 기록하세요. 데스크톱에서는 기존 클라이언트를 종료한 뒤 업데이트하고, Android에서는 설치 출처 권한을 확인하세요. 기존 설정이 있다면 먼저 백업해야 합니다. 특히 직접 관리하는 라우팅, 구독 그룹, 로컬 수신 대기 설정을 주의해서 보관하세요.
클라이언트 기본 창이 정상적으로 열리면 구독 설정을 시작하세요. 이 단계에서 아직 네트워크에 연결되지 않는 것은 정상입니다.
신뢰할 수 있는 출처에서 이용 권한이 있는 구독 주소를 받아 클라이언트에 구독 또는 구독 그룹을 추가한 뒤 업데이트하세요. 노드 공유 링크 가져오기는 구독 주소 가져오기와 다른 작업이므로 해당 기능에 맞는 메뉴를 사용해야 합니다. 업데이트 후 그룹에 노드가 있는지 확인하고 하나를 선택해 연결을 점검하세요.
구독 주소에는 접근 토큰이 포함되는 경우가 많습니다. 전체 주소가 보이도록 공개 스크린샷이나 로그를 공유하거나 타사 변환 페이지에 입력하지 마세요.
데스크톱에서는 먼저 시스템 프록시를 사용하고, Android에서는 시스템 연결 요청을 허용하세요. 라우팅 정책에 따라 연결별로 직접 연결할지 프록시를 사용할지 결정됩니다. 시스템 프록시와 TUN은 별개의 설정입니다. 대상 앱에서 먼저 연결을 확인한 뒤 필요한 경우에만 분할 라우팅을 조정하고, 여러 설정을 한꺼번에 바꾸지 마세요.
클라이언트를 종료한 뒤 앱이 인터넷에 연결되지 않는다면 시스템 프록시가 복구됐는지 확인하고, 수동으로 설정한 프록시가 남아 있지 않은지도 점검하세요.
DOWNLOAD FAQ
처음 설치한다면 새로운 크로스 플랫폼 인터페이스를 사용하는 v2rayN 데스크톱 버전을 선택할 수 있습니다. 클래식 WPF 버전은 기존 Windows 방식의 메뉴와 조작 환경을 유지하므로 익숙한 사용자에게 적합합니다. 인터페이스와 시스템 호환성을 고려해 한 가지를 선택하세요. 두 버전을 동시에 실행할 필요는 없으며, 전환하기 전에 설정을 백업하세요.
시스템 메뉴에서 ‘이 Mac에 관하여’를 열어 칩 또는 프로세서 정보를 확인하세요. Apple M 시리즈 칩이면 Apple Silicon arm64, Intel 프로세서이면 Intel x64를 선택합니다. 컴퓨터를 구입한 연도나 외관으로 판단하지 마세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택하면 됩니다. 다만 일부 기기는 다른 아키텍처를 사용하거나 오래된 시스템 환경을 갖고 있습니다. 아키텍처를 확인할 수 없거나 설치 중 호환되지 않는다는 안내가 나오면 범용 버전을 선택하세요. 범용 버전으로도 낮은 시스템 버전, 서명 충돌, 저장 공간 부족 문제는 해결되지 않습니다.
클라이언트는 설정과 연결을 관리하며, 설치 파일에 노드나 구독이 포함되지는 않습니다. 이용 권한이 있는 구독 주소나 노드 설정을 직접 준비한 뒤 가져오고 업데이트해야 노드를 선택할 수 있습니다. 스크린샷이나 로그를 공유할 때는 구독 주소의 토큰과 노드 인증 정보를 가리세요.
먼저 구독 그룹, 사용자 지정 라우팅 및 중요한 설정을 백업한 다음 실행 중인 클라이언트를 종료하세요. 같은 앱이고 서명이 일치한다면 일반적으로 설치 프로그램의 안내에 따라 업데이트할 수 있습니다. 배포 경로를 바꾸거나 인터페이스 버전을 전환하는 경우, 또는 서명 충돌이 발생하면 먼저 마이그레이션 방법을 확인하세요. 이전 버전의 데이터를 바로 삭제하지 마세요.
먼저 운영체제, CPU 아키텍처, 설치 파일 형식을 확인한 다음 시스템 안내, 저장 공간, 설치 권한을 점검하세요. Windows ZIP 파일은 압축을 풀어야 하고 macOS는 칩에 맞는 DMG를 사용해야 합니다. Android에서는 설치 출처 권한과 서명 충돌을, Linux에서는 배포판의 패키지 형식과 의존성을 확인하세요. 구체적인 오류를 기록해 원인을 찾고 프록시 설정을 반복해서 바꾸지는 마세요.