CLIENT PACKAGES
운영 체제, 프로세서 아키텍처와 인터페이스 유형에 맞춰 설치 파일을 선택하세요. 데스크톱 플랫폼에서는 v2rayN을 사용하고, Android에서는 코어 요구 사항에 따라 v2rayNG 또는 v2flyNG를 선택할 수 있습니다.
PLATFORM SELECTOR
먼저 플랫폼을 전환한 뒤 기기 아키텍처와 설치 파일 형식을 확인하세요. 페이지는 플랫폼 앵커를 유지하므로 새로 고침하거나 링크를 공유한 뒤에도 해당 탭으로 돌아올 수 있습니다.
v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 두 버전 모두 x64 아키텍처이며, 주요 차이는 인터페이스 기술과 사용 레이아웃에 있습니다.
데스크톱 버전 Desktop: 차세대 크로스 플랫폼 인터페이스를 사용합니다. 페이지 구조와 설정 메뉴가 다른 데스크톱 시스템과 더 일관적이어서 v2rayN을 처음 사용하거나 최신 데스크톱 인터페이스를 선호하는 사용자에게 적합합니다.
클래식 WPF 버전: 기존 Windows 클라이언트 레이아웃을 유지합니다. 서버 목록, 구독 그룹, 시스템 프록시와 라우팅 설정의 메뉴 위치가 예전 사용 방식에 더 가까워 클래식 인터페이스에 익숙한 사용자에게 알맞습니다.
두 버전 모두 64비트 Windows용입니다. 현재 Windows 데스크톱 앱을 정상적으로 실행할 수 있다면 일반적으로 데스크톱 버전을 먼저 선택하세요. 기존 튜토리얼, 설정 절차 또는 사용 습관이 WPF 인터페이스를 기준으로 한다면 클래식 WPF 버전이 메뉴 위치를 맞추기 쉽습니다.
| 확인 항목 | 적용 안내 | 권장 선택 |
|---|---|---|
| 프로세서 아키텍처 | 이 페이지의 두 설치 파일은 모두 64비트 x86 프로세서용입니다. | x64 |
| 인터페이스 유형 | 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 클래식 Windows 인터페이스를 사용합니다. | 신규 사용자는 데스크톱 버전 우선 |
| 설치 방식 | ZIP 파일을 다운로드한 뒤 먼저 전체 압축을 풀고, 압축 해제한 폴더에서 설치 프로그램을 실행하세요. | 압축 파일 안에서 직접 실행하지 마세요 |
| 실행 권한 | 일반적인 시스템 프록시는 보통 일반 사용자 권한으로 실행됩니다. 시스템 수준의 네트워크 설정을 변경할 때는 관리자 확인을 요청할 수 있습니다. | 기능 안내에 따라 권한 허용 |
먼저 ‘이 Mac에 관하여’에서 칩 이름을 확인하세요. Apple M 시리즈는 arm64, Intel 프로세서는 x64를 선택합니다.
Apple Silicon 버전: Apple M 시리즈 칩이 탑재된 기기용이며, 설치 파일 아키텍처는 arm64로 표시됩니다. 현재 대부분의 신형 Mac에 해당하는 네이티브 아키텍처입니다.
Intel 버전: ‘이 Mac에 관하여’에서 Intel 프로세서로 표시되는 기기용이며, 설치 파일 아키텍처는 x64로 표시됩니다.
DMG를 다운로드한 뒤 디스크 이미지를 열고 시스템 화면의 안내에 따라 앱을 설치하세요. 처음 실행하면 macOS가 인터넷에서 다운로드한 앱임을 알리는 확인 메시지를 표시할 수 있습니다. 파일 출처와 클라이언트 이름을 확인한 후 시스템 안내에 따라 계속 진행하세요. 구독 가져오기, 서버 선택과 시스템 프록시 설정은 클라이언트에서 처리합니다.
| 이 Mac에 관하여 표시 | 설치 파일 아키텍처 | 다운로드 항목 |
|---|---|---|
| Apple M 시리즈 칩 | arm64 |
Apple Silicon 버전 |
| Intel 프로세서 | x64 |
Intel 버전 |
| 설치 파일 형식 | DMG |
디스크 이미지를 연 후 설치 |
| 네트워크 설정 | 시스템 프록시 또는 TUN 모드를 사용하면 시스템 권한 확인이 표시될 수 있습니다. | 실제 사용 모드에 따라 권한 허용 |
v2rayNG를 우선 선택하세요. 기존 V2Fly 설정이 있거나 해당 코어의 동작이 필요할 때는 v2flyNG를 선택할 수 있습니다.
v2rayNG는 Xray 코어를 사용하며, 인터페이스에서 구독 그룹, 단일 공유 링크, 라우팅 규칙과 로컬 프록시 설정을 관리할 수 있습니다. VLESS, VMess, Trojan, Shadowsocks, REALITY 등 주요 설정을 폭넓게 지원해 Android의 일반적인 선택으로 적합합니다.
arm64-v8a: 2015년 이후 출시된 대부분의 Android 스마트폰에 적합합니다. 해당 프로세서 아키텍처 구성 요소만 포함하므로 일반적으로 우선 선택하는 것이 좋습니다.
universal: 범용 버전은 더 다양한 아키텍처를 지원해 파일 크기가 보통 더 큽니다. 기기 아키텍처를 확인할 수 없거나 arm64 설치 시 호환되지 않는다는 메시지가 표시될 때, 또는 여러 아키텍처의 기기에서 같은 설치 파일을 사용해야 할 때 선택하세요.
v2flyNG는 V2Fly 코어를 사용합니다. V2Fly 설정 의미를 유지하거나 해당 구독 내용을 이미 보유했거나, V2Fly 문서를 참고해 라우팅과 전송 매개변수를 설정하려는 사용자에게 적합합니다. v2rayNG와의 주요 선택 차이는 설치 절차가 아니라 코어 계열입니다.
프로세서 아키텍처를 판단하는 방법은 v2rayNG와 같습니다. 일반적인 기기에서는 먼저 arm64-v8a를 선택하고, 아키텍처를 확인할 수 없거나 설치 중 아키텍처 불일치가 발생하면 universal 범용 버전을 사용하세요.
같은 기기에서는 보통 주 클라이언트 하나만 선택하면 됩니다. 두 클라이언트에 동일한 구독을 반복해서 가져오면 시스템 연결 권한, 백그라운드 실행 정책과 현재 활성화된 설정을 파악하기 어려워질 수 있습니다. 코어 동작을 비교해야 할 때만 사용한 클라이언트와 설정 조건을 각각 기록하세요.
| 확인 항목 | 우선 선택 | 추가 안내 |
|---|---|---|
| 2015년 이후 출시된 일반적인 스마트폰 | arm64-v8a |
대부분의 64비트 ARM 프로세서 기기에 해당합니다. |
| 아키텍처를 확인할 수 없음 | universal |
범용 버전은 더 많은 프로세서 아키텍처를 지원합니다. |
| 클라이언트 코어 | v2rayNG는 Xray 사용 | v2flyNG는 V2Fly를 사용하며 설정 요구 사항에 따라 선택할 수 있습니다. |
| 설치 파일 형식 | APK |
파일을 연 뒤 Android 시스템의 설치 절차에 따라 진행하세요. |
| 첫 연결 | 시스템 연결 요청 확인 | 로컬 네트워크 인터페이스를 생성하며, 권한 상태는 시스템에서 통합 관리합니다. |
먼저 배포판의 패키지 관리 체계에 따라 deb 또는 rpm을 선택한 다음, 프로세서에 맞춰 amd64 또는 arm64를 선택하세요.
deb: Debian, Ubuntu 및 Debian 패키지 관리 체계를 사용하는 배포판용입니다. 일반적인 64비트 데스크톱은 amd64, ARM 기기는 arm64를 선택합니다.
rpm: Fedora, RHEL, Rocky Linux, AlmaLinux 등 RPM 패키지 관리 체계를 사용하는 배포판용입니다. 일반적인 64비트 데스크톱은 x86_64, ARM 기기는 aarch64에 해당합니다.
설치 전에 uname -m을 실행해 아키텍처를 확인하세요. x86_64가 출력되면 amd64 deb 또는 x86_64 rpm을, aarch64가 출력되면 arm64 deb 또는 aarch64 rpm을 선택합니다. 패키지 형식은 배포판의 패키지 관리 체계와 일치해야 하며, 파일 이름의 아키텍처만 보고 판단해서는 안 됩니다.
| 시스템 또는 명령 결과 | 패키지 형식 | 아키텍처 선택 |
|---|---|---|
| Debian, Ubuntu 및 파생 배포판 | deb |
amd64 또는 arm64 |
| Fedora, RHEL 계열 배포판 | rpm |
x86_64 또는 aarch64 |
uname -m 결과 x86_64 |
배포판에 맞게 선택 | amd64 deb / x86_64 rpm |
uname -m 결과 aarch64 |
배포판에 맞게 선택 | arm64 deb / aarch64 rpm |
| 데스크톱 세션 | 사용 가능한 그래픽 환경 필요 | 애플리케이션 메뉴에서 v2rayN 실행 |
PACKAGE DECISIONS
설치에 실패하면 먼저 플랫폼, 프로세서 아키텍처와 파일 형식부터 점검하세요. 각각 ‘어떤 시스템에서 실행하는가’, ‘프로세서 명령어 집합은 무엇인가’, ‘어떤 설치 도구가 처리하는가’를 의미합니다.
이 페이지에서 세 이름은 일반적인 64비트 x86 데스크톱 프로세서 환경을 가리킵니다. Windows 버튼은 x64, Debian 계열 패키지는 보통 amd64, RPM 패키지는 보통 x86_64로 표시됩니다. 이름이 다른 것은 플랫폼과 패키지 관리 체계가 다르기 때문이며, 서로 호환되지 않는 세 프로세서 계열을 뜻하지 않습니다.
세 이름 모두 64비트 ARM 아키텍처와 관련 있지만 사용 환경이 다릅니다. macOS와 deb 패키지는 보통 arm64, RPM 패키지는 aarch64, Android APK는 arm64-v8a로 표시됩니다. 현재 플랫폼에 맞는 다운로드 항목을 선택해야 하며, 다른 플랫폼의 같은 아키텍처 파일을 교차 설치해서는 안 됩니다.
DMG는 macOS 디스크 이미지이고, APK는 Android 설치 절차로 처리되며, deb와 rpm은 서로 다른 Linux 패키지 관리 체계에 사용됩니다. 파일 확장자는 시스템의 설치 방식을 결정하고 아키텍처 이름은 프로세서에서 프로그램을 실행할 수 있는지를 결정하므로 두 조건이 모두 맞아야 합니다.
Android arm64 설치 파일은 대상 아키텍처에 필요한 프로그램 구성 요소만 포함해 대부분의 일반적인 스마트폰에 적합합니다. 범용 버전은 더 많은 아키텍처를 지원해 아키텍처를 모르거나 여러 기기에서 같은 설치 파일을 보관해야 할 때 유용합니다. 기기가 64비트 ARM임을 확인했다면 arm64 버전을 우선 사용하세요.
AFTER DOWNLOAD
설치가 완료되었다고 연결까지 끝난 것은 아닙니다. 클라이언트에서 구독 또는 공유 링크, 서버 선택과 프록시 모드를 추가로 설정해야 합니다.
먼저 다운로드한 파일이 현재 플랫폼 탭에 해당하는지 확인하세요. Windows는 x64 ZIP, macOS는 칩에 맞는 DMG, Android는 arm64 또는 범용 APK, Linux는 배포판 패키지 형식과 프로세서 아키텍처를 함께 확인합니다. 시스템에서 파일 형식을 처리할 수 없다고 표시되면 같은 설치 파일을 반복 실행하지 말고 플랫폼이나 패키지 형식을 다시 점검하세요.
Windows ZIP은 먼저 전체 압축을 풀고, macOS는 DMG를 연 뒤 시스템 화면의 안내에 따라 설치하세요. Android는 APK를 열고 시스템 안내에 따라 설치 출처를 확인합니다. Linux는 배포판에 맞는 패키지 도구로 deb 또는 rpm을 처리합니다. 시스템 수준의 네트워크 설정에는 권한 확인이 표시될 수 있으며, 이는 프록시 모드가 네트워크 설정을 변경할 때 발생하는 정상적인 시스템 절차입니다.
클라이언트를 실행한 뒤 구독 그룹에 유효한 구독 주소를 추가하고 업데이트하거나, 클립보드에서 vmess://, vless:// 등의 단일 공유 링크를 가져오세요. 구독은 업데이트 가능한 서버 목록을 관리하고, 공유 링크는 보통 하나의 항목만 설명합니다. 가져온 뒤 목록이 비어 있으면 먼저 수동으로 구독을 업데이트한 다음 주소 형식과 네트워크 연결 상태를 확인하세요.
서버 목록에서 현재 설정을 선택한 뒤 필요에 따라 시스템 프록시 또는 TUN 모드를 활성화하세요. 시스템 프록시는 운영 체제의 프록시 설정을 따르는 앱에 주로 영향을 주고, TUN 모드는 가상 네트워크 인터페이스를 통해 더 다양한 연결을 처리하며 추가 시스템 권한이 필요할 수 있습니다. 처음에는 시스템 프록시부터 사용해 설정이 정상적으로 로드되는지 확인한 뒤 라우팅과 TUN을 조정하는 것이 좋습니다.
DOWNLOAD FAQ
버전 선택, 프로세서 아키텍처, 클라이언트 차이와 첫 실행에 관한 핵심 답변을 정리했습니다.
데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용해 처음 설치하거나 일관된 데스크톱 환경을 원하는 사용자에게 적합합니다. WPF 버전은 클래식 Windows 인터페이스와 사용 흐름을 유지해 예전 레이아웃이나 기존 작업 방식에 익숙한 사용자에게 알맞습니다. 두 버전 모두 x64 설치 파일을 사용하며 구독과 서버 설정의 핵심 개념은 같지만 메뉴 위치와 화면 구성은 다릅니다.
시스템 메뉴에서 ‘이 Mac에 관하여’를 열고 칩 또는 프로세서 항목을 확인하세요. Apple M 시리즈 칩이면 Apple Silicon arm64 버전을, Intel 프로세서면 Intel x64 버전을 선택합니다. 설치 파일 아키텍처를 잘못 고르면 앱이 실행되지 않거나 시스템에서 호환되지 않는다는 메시지가 표시될 수 있습니다.
2015년 이후 출시된 대부분의 Android 스마트폰은 arm64-v8a 설치 파일을 우선 선택합니다. 기기 아키텍처를 확인할 수 없거나 기기가 오래되었거나 arm64 파일을 설치할 수 없다는 메시지가 표시될 때는 universal 범용 버전을 선택하세요. 범용 버전은 기능이 더 많은 것이 아니라 지원하는 프로세서 아키텍처가 더 넓은 버전입니다.
v2rayNG는 Xray 코어를 사용하며 다양한 프로토콜과 전송 옵션을 지원해 Android의 기본 선택으로 적합합니다. v2flyNG는 V2Fly 코어를 사용해 기존 V2Fly 설정이 있거나 해당 코어의 동작을 유지하려는 사용자에게 알맞습니다. 구독 매개변수, 프로토콜 유형과 필요한 전송 기능을 기준으로 선택하면 되며, 같은 기기에서 두 클라이언트를 장기간 동시에 실행할 필요는 없습니다.
Debian, Ubuntu 및 파생 배포판은 deb를, Fedora, RHEL, Rocky Linux, AlmaLinux 등 RPM 패키지 관리 체계를 사용하는 배포판은 rpm을 선택하세요. 그런 다음 uname -m을 실행해 아키텍처를 확인합니다. x86_64는 amd64 deb 또는 x86_64 rpm에, aarch64는 arm64 deb 또는 aarch64 rpm에 해당합니다.
클라이언트 설치 파일은 그래픽 인터페이스와 실행 구성 요소만 제공합니다. 처음 실행한 뒤 유효한 구독 또는 단일 공유 링크를 가져오고 서버 목록을 업데이트한 다음 서버를 선택해 시스템 프록시나 TUN 모드를 필요에 따라 활성화해야 합니다. 서버 항목을 가져왔는데도 연결되지 않으면 현재 선택한 항목, 시스템 시간, 프록시 모드와 라우팅 설정을 추가로 확인하세요.
NEXT STEP
설치가 끝나면 시작 가이드에서 구독 가져오기, 서버 선택, 시스템 프록시, TUN 모드와 연결 확인의 전체 절차를 살펴보세요. VMess, VLESS, Trojan, Shadowsocks 또는 REALITY 설정의 차이를 판단해야 한다면 프로토콜 매뉴얼에서 인증 방식, 전송 조합, 호환 범위와 리소스 사용량을 기준으로 선택하세요.