client packages / platform matrix
데스크톱에서는 v2rayN을 사용하고, Android에서는 v2rayNG를 우선 선택하세요. v2fly 코어가 필요하면 v2flyNG를 사용하면 됩니다. 운영체제, 프로세서 아키텍처, 설치 패키지 형식을 확인한 뒤 해당 플랫폼의 다운로드 페이지로 이동하세요.
platform selector
플랫폼을 전환하면 주소 표시줄의 앵커도 함께 변경됩니다. 현재 페이지 주소를 복사하면 해당 시스템 섹션을 바로 열 수 있습니다. 설치하기 전에 카드에 안내된 버전 차이와 아키텍처 설명을 확인하세요.
download > windows > v2rayN
Windows에서는 Desktop 버전과 클래식 WPF 버전을 제공합니다. 두 설치 패키지는 동일한 제품 구성 체계를 사용하며, 주요 차이는 인터페이스 프레임워크, 실행 환경, 조작 방식에 있습니다. 새로 설치한다면 보통 Desktop 버전을 선택합니다. 클래식 인터페이스에 익숙하거나 기존 환경이 WPF 버전을 기준으로 구성되어 있다면 WPF 버전을 계속 사용해도 됩니다.
v2rayN은 구독 관리, 서버 설정, 시스템 프록시, 라우팅 분기, TUN 설정을 담당하는 데스크톱 그래픽 클라이언트입니다. 다운로드가 끝나면 설치 패키지의 압축을 먼저 풀고 내부 설치 프로그램을 실행하세요. 처음 시작할 때 입문 가이드에 따라 구독을 가져오고 활성 구성을 선택하면 됩니다.
우선 설치
최신 크로스 플랫폼 UI를 사용하며 다른 데스크톱 시스템과 일관된 인터페이스 구조를 제공합니다. 비교적 새로운 Windows 환경과 처음 설치하는 사용자에게 적합합니다.
클래식 인터페이스
전통적인 Windows 인터페이스 프레임워크를 사용하고 메뉴와 설정 경로도 기존 배치를 유지합니다. 기존 사용 경험이 있거나 전통적인 데스크톱 조작 방식을 선호하는 사용자에게 적합합니다.
| 확인 항목 | 권장 사항 | 설치 전 준비 |
|---|---|---|
| 프로세서 아키텍처 | x64 데스크톱 기기 | 시스템 설정의 ‘시스템 종류’에서 64비트 운영체제인지 확인 |
| 인터페이스 버전 | 처음 설치할 때는 Desktop 우선 | WPF 조작 방식에 익숙하다면 클래식 버전 선택 |
| 설정 이전 | 구독 주소와 사용자 지정 규칙을 먼저 기록 | 업그레이드하거나 버전을 변경하기 전에 실행 중인 클라이언트를 종료 |
download > macos > v2rayN
macOS 설치 패키지는 프로세서 아키텍처에 따라 Apple Silicon과 Intel 두 종류로 제공됩니다. 기기 칩과 아키텍처가 일치해야 하며, 그렇지 않으면 설치 프로그램이 실행되지 않을 수 있습니다. 시스템 메뉴에서 ‘이 Mac에 관하여’를 열고 칩 또는 프로세서 항목을 확인한 뒤 다운로드하세요.
macOS용 v2rayN은 구독 업데이트, 구성 선택, 라우팅 규칙, 시스템 프록시 관리를 제공합니다. Apple Silicon과 Intel 설치 패키지의 기능은 동일하며, 선택 기준은 기기의 칩 아키텍처뿐입니다.
M 시리즈 칩
시스템 정보에 Apple M 시리즈 칩으로 표시되는 기기용입니다. arm64 아키텍처로 빌드되었으므로 최근 출시된 Mac 기기에서 우선 선택하세요.
Intel 프로세서
‘이 Mac에 관하여’에서 Intel 프로세서로 명확히 표시되는 기기용입니다. 기기 외관이나 구매 연도만으로 판단하지 말고 시스템 정보를 기준으로 선택하세요.
| 시스템 정보 표시 | 선택할 설치 패키지 | 설치 방법 |
|---|---|---|
| Apple M 시리즈 칩 | Apple Silicon arm64 | dmg를 열고 화면 안내에 따라 애플리케이션을 응용 프로그램 폴더로 이동 |
| Intel 프로세서 | Intel x64 | dmg를 열어 애플리케이션 설치를 완료한 뒤 응용 프로그램 폴더에서 실행 |
| 처음 실행 | 시스템 보안 안내에 따라 확인 | 시작한 뒤 구독을 가져오고 구성을 선택한 다음 프록시 적용 범위를 설정 |
download > android > v2rayNG / v2flyNG
Android 플랫폼에서는 v2rayNG를 먼저, v2flyNG를 다음으로 안내합니다. v2rayNG는 Xray 코어를 사용해 일반적인 구독과 그래픽 설정 과정에 적합하고, v2flyNG는 v2fly 코어를 사용해 다른 코어 생태계를 원하는 경우의 대안이 됩니다. 두 클라이언트 모두 arm64와 범용 설치 패키지를 제공합니다.
v2rayNG는 Android에서 널리 사용하는 그래픽 클라이언트로 Xray 코어를 사용합니다. 구독 주소, 클립보드 내용 또는 매개변수를 직접 입력해 구성을 만들 수 있으며, 라우팅, 앱별 프록시, 연결 로그 등의 설정을 제공합니다.
대부분의 스마트폰에 우선
2015년 이후 출시된 대부분의 Android 스마트폰과 태블릿에 적합하며 arm64-v8a 아키텍처에 맞춰 제공됩니다.
더 넓은 호환 범위
기기 아키텍처를 확인할 수 없거나 arm64 설치 패키지에서 호환되지 않는다는 메시지가 표시될 때 사용하세요. 범용 버전은 더 많은 프로세서 유형을 지원하며 파일 크기도 대체로 큽니다.
v2flyNG는 v2fly 코어를 사용하는 Android 그래픽 클라이언트입니다. v2fly 코어의 동작과 맞춰야 하거나 관련 구성 절차가 이미 있거나, 두 코어 계열의 호환성을 비교하려는 경우 대안으로 사용할 수 있습니다.
주요 아키텍처
대부분의 최신 Android 기기에 적합합니다. 프로세서 정보가 arm64-v8a로 확인되면 이 버전을 바로 선택하세요.
아키텍처 호환
프로세서 아키텍처를 알 수 없거나 arm64 버전을 설치할 수 없을 때 적합합니다.
| 사용 상황 | 권장 클라이언트 | 설치 패키지 선택 |
|---|---|---|
| 일반적인 구독 및 일상적인 연결 | v2rayNG | 대부분의 기기에서는 arm64 우선 선택 |
| v2fly 코어 생태계가 필요한 경우 | v2flyNG | 프로세서가 확인되면 arm64 선택 |
| 아키텍처를 알 수 없거나 호환되지 않는다는 메시지가 표시되는 경우 | 필요한 코어에 맞춰 클라이언트 선택 | 해당 클라이언트의 범용 버전으로 변경 |
download > linux > v2rayN
Linux용 v2rayN은 패키지 형식과 프로세서 아키텍처에 따라 나뉩니다. Debian, Ubuntu 및 파생 배포판은 deb를, Fedora, Rocky Linux, AlmaLinux 등 RPM 패키지 관리 체계를 사용하는 배포판은 rpm을 선택하세요. 일반적인 데스크톱 컴퓨터는 x64를, ARM 기기는 arm64를 사용합니다.
Linux용 v2rayN은 구독 관리, 구성 전환, 라우팅 규칙, 시스템 프록시 설정이 필요한 사용자를 위한 데스크톱 그래픽 인터페이스를 제공합니다. 다운로드 전에 배포판의 패키지 관리 체계와 CPU 아키텍처를 모두 확인해야 하며, 두 조건이 모두 맞아야 정상적으로 설치할 수 있습니다.
Debian / Ubuntu 계열
일반적인 x86_64 데스크톱 컴퓨터와 deb 패키지 체계를 사용하는 배포판에 적합합니다.
Fedora / RPM 계열
x86_64 프로세서와 RPM 패키지 관리 체계를 사용하는 배포판에 적합합니다.
시스템 아키텍처가 aarch64 또는 arm64로 표시되면 아래에서 해당 형식을 선택하세요. x64 기기에 ARM 패키지를 설치하지 마세요.
| 환경 | x64 설치 패키지 | ARM 설치 패키지 |
|---|---|---|
| Debian, Ubuntu 및 파생 배포판 | amd64 deb | arm64 deb |
| RPM 패키지 관리를 사용하는 배포판 | x86_64 rpm | aarch64 rpm |
| 아키텍처 확인 | x86_64는 x64에 해당 |
aarch64는 arm64에 해당 |
package decision path
먼저 플랫폼을 확인하고, 다음으로 프로세서 아키텍처를 확인한 뒤, 같은 플랫폼 안에서 클라이언트 또는 인터페이스 버전을 선택하세요. 이 순서로 점검하면 제품 차이, 패키지 형식, CPU 아키텍처를 혼동하는 일을 줄일 수 있습니다.
Windows와 macOS에서는 v2rayN을 사용하고, Android에서는 v2rayNG와 v2flyNG 중에서 선택하세요. Linux는 배포판의 패키지 관리 체계를 추가로 확인해야 합니다.
데스크톱 컴퓨터는 x64가 일반적이며, Apple M 시리즈와 일부 Linux 기기는 arm64를 사용합니다. 최신 Android 기기도 대부분 arm64를 사용합니다.
Windows에서는 Desktop과 WPF 중 하나를 선택하고, Android에서는 클라이언트 코어 계열을 결정해야 합니다. Linux에서는 deb와 rpm도 구분해야 합니다.
설치 완료는 준비 단계에 불과합니다. 다음으로 구독을 가져오고 구성 목록을 업데이트한 뒤 활성 서버를 선택하고 프록시 적용 범위를 설정하세요.
after installation
클라이언트, 구독, 활성 구성, 프록시 모드는 서로 다른 네 가지 단계입니다. 순서대로 처리하면 문제가 설치, 구성 해석, 시스템 프록시 중 어디에서 발생했는지 더 쉽게 판단할 수 있습니다.
클라이언트를 실행하고 시스템에서 요구하는 권한 확인을 완료하세요. 데스크톱 시스템에서는 애플리케이션 실행을 허용해야 하며, Android는 처음 연결할 때 로컬 연결 서비스를 확인해야 합니다. 이 단계에서는 클라이언트 실행 조건만 처리하고 고급 라우팅 매개변수 변경은 서두르지 마세요.
구독 주소는 여러 서버 구성을 한곳에서 관리할 때 적합하고, 단일 공유 내용은 임시로 가져올 때 편리합니다. 가져온 후 구독 업데이트를 한 번 실행하고 구성 목록에 이름, 주소, 포트, 프로토콜 항목이 표시되는지 확인하세요.
클라이언트 목록에서 사용할 수 있는 구성 하나를 선택해 현재 활성 항목으로 지정하세요. 구독만 가져오고 활성 구성을 선택하지 않으면 클라이언트가 대상 연결을 만들지 못하는 경우가 많습니다. 구성 오류가 발생하면 먼저 프로토콜과 전송 매개변수를 확인하세요.
시스템 프록시는 운영체제의 프록시 설정을 따르는 애플리케이션에 적합합니다. 라우팅 모드는 대상 트래픽의 아웃바운드 방향을 결정하고, TUN 모드는 더 많은 애플리케이션 트래픽을 가로채야 하는 환경에 적합합니다. 처음에는 기본 연결을 완료한 뒤 고급 모드를 단계적으로 활성화하세요.
download faq
다음 질문에서는 버전 계열, 프로세서 아키텍처, 패키지 형식, 최초 설정을 집중적으로 설명합니다. 전체 작업 절차가 필요하다면 입문 가이드나 시스템별 튜토리얼을 확인하세요.
Desktop 버전은 최신 크로스 플랫폼 인터페이스를 사용해 비교적 새로운 Windows 환경에 적합합니다. WPF 버전은 클래식 Windows 인터페이스를 사용해 전통적인 조작 방식이나 기존 설정 습관을 선호하는 사용자에게 알맞습니다. 둘 다 v2rayN이며, 처음 설치한다면 Desktop 버전부터 선택해도 좋습니다. 버전을 변경할 때는 구독 주소, 사용자 지정 라우팅 규칙, 로컬 수신 포트를 먼저 기록해 개인 설정이 누락되지 않도록 하세요.
시스템 메뉴에서 ‘이 Mac에 관하여’를 열고 칩 또는 프로세서 항목을 확인하세요. Apple M 시리즈 칩으로 표시되면 Apple Silicon을, Intel 프로세서로 표시되면 Intel 설치 패키지를 선택합니다. 두 버전의 클라이언트 기능은 동일하며 차이는 컴파일 아키텍처뿐입니다. 기기 구매 연도는 참고만 하고 최종적으로 시스템 정보에 표시된 칩 이름을 기준으로 선택하세요.
2015년 이후 출시된 대부분의 Android 스마트폰은 arm64 아키텍처를 사용하므로 arm64를 우선 선택하세요. 기기 아키텍처를 알 수 없거나 설치 중 호환되지 않는다는 메시지가 표시될 때, 또는 더 다양한 프로세서 유형을 지원해야 할 때 범용 버전으로 변경하면 됩니다. 범용 버전은 보통 더 많은 아키텍처 구성 요소를 포함해 파일 크기가 클 수 있지만, 설치 패키지 아키텍처에 따라 클라이언트 설정 방식이 달라지지는 않습니다.
Android 사용자는 일반적으로 Xray 코어와 비교적 완전한 그래픽 설정을 제공하는 v2rayNG를 먼저 선택합니다. v2fly 코어 생태계가 필요하다면 v2flyNG를 사용할 수 있습니다. 두 클라이언트 모두 구독과 연결 구성을 관리할 수 있지만, 지원되는 프로토콜, 전송 방식, 라우팅 동작은 코어 기능에 따라 달라집니다. 구독을 가져오기 전에 서버 설정과 클라이언트가 지원하는 프로토콜이 일치하는지 확인하세요.
Debian, Ubuntu 및 파생 배포판은 deb를 사용하고, Fedora, Rocky Linux, AlmaLinux 등 RPM 패키지 관리 체계를 사용하는 배포판은 rpm을 사용합니다. 기기 프로세서에 맞춰 x64 또는 arm64도 선택해야 합니다. 시스템 명령 결과가 x86_64이면 x64를, aarch64이면 arm64를 선택하세요.
클라이언트 설치 패키지는 그래픽 관리 및 연결 기능만 제공합니다. 처음 실행한 후 사용 가능한 구독을 가져오거나 서버 매개변수를 직접 입력하고, 활성 구성을 선택한 다음 사용 범위에 따라 시스템 프록시, 라우팅 모드 또는 TUN 모드를 활성화해야 합니다. 구독을 가져온 뒤 목록이 비어 있다면 먼저 구독을 수동으로 업데이트하고 현재 클라이언트가 구독 내용을 해석할 수 있는지 확인하세요.