각 플랫폼 패널에는 해당 시스템에 맞는 그래픽 클라이언트만 표시됩니다. 탭을 전환하면 페이지 주소도 함께 바뀌므로 새로고침하거나 링크를 공유한 뒤에도 해당 플랫폼을 바로 열 수 있습니다.
WINDOWS · X64
Windows용 v2rayN
데스크톱 우선 추천
Windows에서는 Desktop과 클래식 WPF, 두 가지 인터페이스를 제공합니다. 처음 설치하거나 여러 데스크톱 시스템에서 비슷한 방식으로 사용하려면 Desktop을 선택할 수 있습니다. 기존 메뉴, 트레이와 설정 절차에 익숙하다면 WPF를 계속 사용하세요. 두 버전을 동시에 설치할 필요 없이 하나만 선택하면 됩니다.
v2rayN Desktop
추천
현재 버전 7.24.1
Desktop은 차세대 크로스 플랫폼 UI로, 설정 화면과 구독 관리, 라우팅 메뉴가 통일된 레이아웃으로 구성되어 있습니다. 처음 설치하거나 Windows, macOS, Linux에서 비슷한 사용 방식을 유지하려는 사용자에게 적합합니다. 설치 패키지는 ZIP으로 압축된 데스크톱 설치 프로그램이므로 다운로드 후 압축을 풀고 내부의 설치 파일을 실행하세요.
64비트 Windows용입니다. 파일: v2rayN-Desktop-Setup-x64-7.24.1.zip
v2rayN WPF
클래식 인터페이스
현재 버전 7.24.1
WPF는 Windows의 안정적인 클래식 버전으로, 익숙한 메뉴 구조와 서버 목록, 트레이 조작 방식을 유지합니다. 이미 v2rayN을 사용해 왔거나 기존 작업 흐름이 클래식 인터페이스에 맞춰져 있다면 이 버전을 선택하세요. 업그레이드하기 전에 트레이의 기존 프로세스를 종료하고 현재 설정 폴더 위치를 기록해 두세요.
현재 설치 패키지는 x64 장치용입니다. 시스템 설정의 ‘시스템 종류’에서 확인할 수 있습니다.
쓰기 권한
보호된 폴더에 설치할 때 관리자 권한 확인을 요청할 수 있습니다.
업그레이드 준비
먼저 클라이언트와 트레이 프로세스를 종료한 다음 새 버전을 설치하세요. 중요한 구독과 직접 만든 설정은 미리 내보내는 것이 좋습니다.
첫 실행
실행 후 먼저 코어 상태를 확인하고, 구독을 가져온 다음 시스템 프록시 모드를 선택하세요.
MACOS · DMG
macOS용 v2rayN
듀얼 아키텍처
macOS 설치 패키지는 프로세서에 따라 Apple Silicon과 Intel로 나뉩니다. 시스템 메뉴에서 ‘이 Mac에 관하여’를 열고 ‘칩’ 또는 ‘프로세서’ 항목을 확인하세요. Apple M 시리즈로 표시되면 arm64를, Intel로 표시되면 x64를 선택합니다. 아키텍처를 잘못 선택하면 앱이 열리지 않거나 시스템에서 호환되지 않는 앱이라고 안내할 수 있습니다.
v2rayN for macOS
Apple Silicon 우선
현재 버전 7.24.1
Apple Silicon 패키지는 Apple M 시리즈 칩에 맞게 빌드되었으며 최근 Mac에서 일반적으로 사용하는 선택입니다. Intel 패키지는 Intel 프로세서 모델용입니다. 두 설치 패키지의 클라이언트 기능과 설정 방식은 같고, 실행 파일이 지원하는 프로세서 아키텍처만 다릅니다.
Apple M 시리즈는 Apple Silicon을, Intel 프로세서는 Intel을 선택합니다.
설치 방법
DMG를 열고 앱을 ‘응용 프로그램’ 폴더로 옮긴 다음 해당 폴더에서 실행하세요.
시스템 안내
처음 실행할 때 시스템 안내에 따라 앱 실행 권한과 네트워크 설정 권한을 확인하세요.
메뉴 막대 상태
실행 후 메뉴 막대에 클라이언트 아이콘이 표시되는지 확인하고, 구독을 가져온 뒤 시스템 프록시를 설정하세요.
ANDROID · APK
Android 클라이언트
코어에 따라 선택
Android에서는 v2rayNG를 우선 선택합니다. Xray 코어를 사용하므로 일반적인 구독과 최신 프로토콜 설정에 적합합니다. 구독 제공자가 V2Fly 코어를 명시적으로 요구하거나 기존 설정이 해당 구현에 의존할 때는 v2flyNG를 선택하세요. 각 클라이언트에는 arm64와 범용 버전이 있으며, 2015년 이후 출시된 주요 스마트폰은 보통 arm64를 먼저 선택하면 됩니다.
v2rayNG
우선 추천
현재 버전 2.2.6
v2rayNG는 Android에서 널리 사용되는 V2Ray 그래픽 클라이언트로, 구독 가져오기, 노드 선택, 라우팅 설정과 VPN 연결을 관리합니다. arm64 패키지는 주요 64비트 ARM 아키텍처에 필요한 구성 요소만 포함합니다. 범용 버전은 더 다양한 프로세서 유형을 지원하므로 아키텍처를 확인할 수 없거나 arm64 패키지 설치에 실패한 기기에 적합합니다.
v2flyNG는 V2Fly 코어를 사용하며 인터페이스와 모바일 연결 절차는 v2rayNG와 비슷하지만 기반 구현 계열이 다릅니다. 선택 기준은 두 클라이언트를 동시에 실행하는 것이 아니라 구독 설정과 프로토콜 호환 요구 사항이어야 합니다. 클라이언트를 바꿀 때는 구독을 다시 가져오고 라우팅과 로컬 포트 설정을 각각 확인하세요.
2015년 이후 출시된 주요 스마트폰은 보통 arm64를 선택합니다. 아키텍처를 모를 때는 범용 버전을 사용하세요.
설치 권한
브라우저나 파일 관리자에서 APK를 열 때 시스템 안내에 따라 해당 출처의 설치 권한을 허용하세요.
연결 권한
처음 연결하면 VPN 설정 확인 창이 나타납니다. 확인해야 클라이언트가 로컬 전달을 설정할 수 있습니다.
백그라운드 실행
장시간 연결할 때는 기기 시스템 정책에 따라 배터리 최적화와 백그라운드 실행 설정을 조정할 수 있습니다.
LINUX · DEB / RPM
Linux용 v2rayN
데스크톱 클라이언트
Linux 설치 패키지는 배포판의 패키지 형식과 프로세서 아키텍처를 모두 맞춰야 합니다. Debian, Ubuntu 및 파생 배포판은 보통 deb를 사용하고, Fedora, Rocky Linux, AlmaLinux 등 RPM 계열 배포판은 보통 rpm을 사용합니다. 대부분의 데스크톱 컴퓨터는 x64를 선택하며, ARM 데스크톱 장치와 개발 보드는 시스템 아키텍처에 따라 arm64를 선택하세요.
v2rayN for Linux
x64 주요 다운로드
현재 버전 7.24.1
x64는 일반적인 데스크톱 컴퓨터와 워크스테이션에서 널리 사용하는 아키텍처입니다. 먼저 배포판에 맞춰 deb 또는 rpm을 선택한 뒤 시스템 소프트웨어 설치 도구로 설치하세요. 설치가 끝나면 앱 메뉴에서 v2rayN을 실행하고 트레이 또는 데스크톱 상태 영역에 클라이언트가 표시되는지 확인한 다음 구독을 가져오세요.
arm64 패키지는 64비트 ARM Linux를 실행하는 장치용입니다. 다운로드 전에 시스템 정보에서 아키텍처를 확인하세요. aarch64 또는 arm64로 표시되면 이 그룹의 다운로드 링크를 선택합니다. 패키지 형식은 여전히 배포판에 따라 결정하며 Debian 계열은 deb, RPM 계열은 rpm을 사용합니다.
Debian과 Ubuntu 계열은 보통 deb를, RPM 계열 배포판은 보통 rpm을 선택합니다.
프로세서 아키텍처
일반적인 데스크톱 컴퓨터는 대부분 x64이며, aarch64 또는 arm64 시스템은 arm64 패키지를 선택합니다.
데스크톱 환경
클라이언트에는 그래픽 데스크톱과 사용 가능한 상태 영역이 필요합니다. 데스크톱 환경에 따라 트레이 표시 방식이 다를 수 있습니다.
프록시 적용
설정을 가져온 뒤 데스크톱 환경에 맞춰 시스템 프록시 또는 TUN을 선택하고 관련 권한 안내를 확인하세요.
설치 전 확인
설치 패키지 선택 시 확인할 네 가지 기준
설치 문제는 플랫폼, 아키텍처, 패키지 형식 또는 기존 프로세스 점유로 발생하는 경우가 많습니다. 다운로드 전에 아래 네 가지를 확인하면 재설치와 설정 이전을 줄일 수 있습니다.
01
운영체제 확인
v2rayN은 Windows, macOS, Linux 데스크톱에서 사용하며 Android에서는 v2rayNG 또는 v2flyNG를 사용합니다. 데스크톱과 모바일 클라이언트의 설정 화면은 다르지만 모두 구독 링크로 서버 설정을 가져올 수 있습니다. 기기 간 이전 시에는 클라이언트 내부 폴더를 직접 복사하지 말고 같은 구독 소스를 우선 사용하세요.
02
프로세서 아키텍처 확인
Windows의 현재 다운로드 항목은 x64입니다. macOS는 Apple M 시리즈와 Intel을 구분해야 합니다. Android 주요 스마트폰은 대체로 arm64를 사용하며, 아키텍처가 확실하지 않으면 범용 버전을 선택할 수 있습니다. Linux는 x64와 arm64뿐 아니라 배포판의 패키지 관리 체계가 deb인지 rpm인지도 확인해야 합니다.
03
기존 설정 기록
기존 클라이언트를 업그레이드하기 전에 구독 주소, 직접 만든 서버 설정, 라우팅 규칙과 로컬 포트 설정을 저장하세요. 일반적인 버전 업데이트는 기존 설정을 계속 읽지만, 인터페이스 버전이나 설치 폴더, 클라이언트 간에 이전할 때는 설정 폴더가 다를 수 있습니다. 다시 가져올 수 있는 설정 사본을 보관하면 복구가 편리합니다.
04
실행 중인 프로세스 종료
데스크톱 클라이언트는 주 창을 닫아도 트레이나 메뉴 막대에 남아 있을 수 있습니다. 새 버전을 설치하기 전에 클라이언트 메뉴에서 종료하여 프로그램 파일이 사용 중인 상태를 피하세요. 모바일 클라이언트를 덮어쓰기 설치할 때도 먼저 현재 연결을 끊고, 설치가 끝난 뒤 앱을 열어 구독과 라우팅 상태를 확인해야 합니다.
설치 및 첫 실행
설치 패키지에서 첫 연결까지
다운로드는 첫 단계일 뿐입니다. 클라이언트를 실행한 뒤 권한 확인, 구독 가져오기, 노드 선택과 프록시 모드 설정을 완료해야 합니다. 다음 절차는 이 페이지에 소개된 그래픽 클라이언트에 적용됩니다.
A
시스템 설치 완료
Windows ZIP 패키지는 먼저 압축을 푼 다음 설치 프로그램을 실행해야 합니다. macOS에서는 DMG를 열고 앱을 ‘응용 프로그램’ 폴더로 옮기세요. Android에서는 APK를 열고 시스템 안내에 따라 설치를 완료합니다. Linux는 배포판에 맞는 소프트웨어 설치 도구로 deb 또는 rpm을 처리하며, 추가 의존성이 필요하면 패키지 관리자의 안내에 따라 실행하세요.
설치 폴더는 안정적으로 유지하는 것이 좋습니다. 데스크톱에서 폴더를 자주 바꾸면 기존 바로 가기, 설정 경로와 자동 시작 항목이 이전 위치를 가리킬 수 있습니다. 덮어쓰기 업그레이드에서는 기존 설치 방식을 우선 유지하고, Desktop과 WPF 간에 이전할 때는 설정 폴더와 실행 경로를 먼저 확인하세요.
B
첫 실행 권한 처리
그래픽 클라이언트는 설정을 읽고 로컬 수신 포트를 열며, 선택에 따라 시스템 프록시를 변경하거나 VPN 및 TUN 연결을 설정해야 합니다. 시스템에 권한 안내가 나타나면 실행 중인 앱 이름을 먼저 확인한 뒤 현재 작업에 필요한 권한만 허용하세요. 데스크톱에서 설정을 가져오고 편집하는 경우 일부 네트워크 권한은 첫 연결 시에만 나타날 수 있습니다.
Android에서 처음 연결하면 시스템 VPN 설정 확인 창이 표시됩니다. macOS와 Linux에서 TUN을 사용할 때는 추가 권한이 필요할 수 있습니다. Windows에서 보호된 폴더에 설치하거나 시스템 설정을 기록할 때도 권한 확인이 나타날 수 있습니다. 권한 처리를 완료한 뒤 연결을 테스트해야 시스템 거부를 노드 문제로 잘못 판단하지 않습니다.
C
구독 가져오기 및 업데이트
클라이언트에서 구독 관리 메뉴를 열고 서비스 제공자가 안내한 구독 주소를 입력해 저장한 다음 구독 업데이트를 실행하세요. 업데이트가 끝나면 현재 그룹에 서버 항목이 표시되는지 확인합니다. 구독 주소만 저장한다고 선택 가능한 노드가 자동으로 생성되지는 않으므로 처음 추가한 뒤에는 한 번 직접 업데이트해야 합니다.
구독은 중앙 관리되는 설정 소스입니다. 서비스 제공자가 서버나 프로토콜 매개변수를 변경하면 다시 업데이트하여 변경 사항을 반영할 수 있습니다. 직접 만든 노드는 사용자가 항목별로 관리합니다. 두 소스를 같은 클라이언트에서 사용할 수 있지만 그룹을 나누어 관리하면 특정 구독의 업데이트 실패나 설정 필드 호환성 문제를 해결하기 쉽습니다.
D
노드 및 프록시 모드 선택
서버 목록에서 노드 하나를 선택한 뒤 시스템 프록시 또는 TUN을 설정하세요. 시스템 프록시는 시스템 프록시 설정을 따르는 앱을 주로 제어하고, TUN은 더 많은 네트워크 프로그램에 적용되지만 높은 권한이 필요합니다. 처음에는 시스템 프록시로 연결을 테스트하고 구독과 노드가 정상임을 확인한 뒤 앱 범위에 따라 TUN 사용 여부를 결정하는 것이 좋습니다.
라우팅 모드는 어떤 요청을 프록시로 보낼지 결정합니다. ‘LAN 및 중국 본토 우회’는 LAN 접근을 유지하면서 규칙에 따라 트래픽을 분할할 때 일반적으로 사용하며, 전역 프록시는 더 많은 요청을 현재 노드로 보냅니다. 라우팅 모드를 변경한 뒤에는 현재 노드에 다시 연결해야 새 규칙이 적용됩니다.
E
연결 상태 확인
연결 후 먼저 클라이언트 상태 표시줄에서 시스템 프록시, 현재 노드와 라우팅 모드가 예상대로 설정되었는지 확인하세요. 그런 다음 실제로 인터넷 연결이 필요한 앱에서 접속을 테스트합니다. 클라이언트가 실행 중이라는 사실만으로 시스템 트래픽이 제어되는 것은 아닙니다. 시스템 프록시가 꺼져 있거나 VPN 권한이 취소되었거나 노드가 선택되지 않은 경우 앱은 계속 기존 네트워크 경로를 사용할 수 있습니다.
연결에 실패하면 ‘클라이언트 상태—구독 내용—노드 설정—시스템 프록시—로컬 네트워크’ 순서로 점검하세요. 한 번에 하나만 변경하고 변경 후 다시 연결합니다. 이렇게 하면 문제가 설치, 권한, 설정 또는 노드 자체에서 비롯되었는지 판단할 수 있어 여러 설정을 동시에 바꾼 뒤 원인을 놓치는 일을 줄일 수 있습니다.
다음 단계: 구독 가져오기 및 라우팅 설정
튜토리얼에서는 순서에 따라 구독 추가, 서버 선택, 시스템 프록시, 라우팅 모드와 연결 확인 방법을 설명합니다.
여기에서는 다운로드 단계에서 가장 자주 발생하는 선택 문제를 정리합니다. 클라이언트는 설치했지만 구독을 가져오거나 연결을 설정할 수 없다면 설정 튜토리얼과 문제 해결 섹션을 계속 확인하세요.
Windows에서는 v2rayN Desktop과 WPF 버전 중 무엇을 다운로드해야 하나요?
Desktop은 차세대 크로스 플랫폼 인터페이스로, 일관된 데스크톱 환경을 원하는 사용자에게 적합합니다. WPF는 Windows의 클래식 인터페이스로, 기존 사용 방식과 설정 절차를 유지하려는 사용자에게 적합합니다. 두 버전 모두 v2rayN 설정 체계를 사용하므로 함께 설치할 필요는 없습니다. 처음 사용하는 경우 Desktop을 먼저 선택하고, 기존 WPF 설정과 고정된 작업 방식이 있다면 클래식 버전을 계속 사용하세요.
macOS에서 Apple Silicon과 Intel 설치 패키지 중 무엇을 선택해야 하나요?
시스템 메뉴에서 ‘이 Mac에 관하여’를 열고 칩 또는 프로세서 항목을 확인하세요. Apple M 시리즈 칩으로 표시되면 Apple Silicon을, Intel 프로세서로 표시되면 Intel 설치 패키지를 선택합니다. 클라이언트 기능은 같고 설치 패키지 차이는 프로세서 아키텍처에만 해당합니다. 잘못된 아키텍처를 다운로드하면 보통 실행할 때 시스템에서 호환되지 않는다고 안내합니다.
Android에서는 arm64와 범용 버전 중 무엇을 다운로드해야 하나요?
2015년 이후 출시된 주요 Android 스마트폰은 대부분 64비트 ARM 프로세서를 사용하므로 arm64를 우선 선택하면 됩니다. 기기 아키텍처를 모르거나 설치 중 호환성 오류가 표시될 때, 또는 더 다양한 프로세서 유형을 지원해야 할 때는 범용 버전으로 변경하세요. 범용 버전은 더 많은 아키텍처 구성 요소를 포함하므로 파일이 보통 더 크지만 설정과 사용 절차는 같습니다.
v2rayNG와 v2flyNG 중 무엇을 선택해야 하나요?
일반적으로 Xray 코어를 사용하는 v2rayNG를 먼저 선택합니다. 구독 제공자가 V2Fly 코어를 명시적으로 요구하거나 기존 설정이 해당 구현에 의존할 때는 v2flyNG를 선택하세요. 두 클라이언트는 코어 계열과 일부 프로토콜 기능, 설정 호환 범위가 다르므로 구독 요구 사항에 맞춰 선택해야 하며, 동시에 연결하거나 내부 설정 폴더를 공유하는 것은 권장하지 않습니다.
새 버전을 설치하기 전에 기존 설정을 삭제해야 하나요?
일반적인 업그레이드에서는 설정을 그대로 유지할 수 있습니다. 작업 전에 중요한 설정을 내보내거나 구독 주소를 기록하고, 실행 중인 클라이언트를 종료한 뒤 새 버전을 설치하세요. 인터페이스 버전 간에 이전할 때는 먼저 설정을 백업하고 새 버전이 읽는 설정 폴더를 확인해야 합니다. Android는 덮어쓰기 설치 시 앱 데이터가 보통 유지되지만, 필요할 때 다시 가져올 수 있도록 구독 출처도 기록해 두세요.