client packages

V2Ray 클라이언트 다운로드 및 플랫폼 선택

운영체제, 프로세서 아키텍처와 인터페이스 유형에 맞춰 설치 패키지를 선택하세요. 데스크톱에서는 v2rayN을 사용하고, Android에서는 코어 요구 사항에 따라 v2rayNGv2flyNG 중에서 선택할 수 있습니다.

Windows / macOS / Android / Linux 그래픽 클라이언트 한국어 설치 안내
platform

플랫폼별 클라이언트 선택

플랫폼을 전환하면 해당 클라이언트, 설치 패키지 메뉴와 시스템 요구 사항만 표시됩니다. 페이지 주소에도 플랫폼 앵커가 반영되므로 현재 플랫폼 메뉴를 바로 저장할 수 있습니다.

windows packages

Windows:v2rayN

같은 클라이언트에서 두 가지 인터페이스를 제공합니다. 먼저 Desktop 또는 WPF를 선택한 다음 해당 x64 설치 압축 패키지를 다운로드하세요.

v2rayN
우선 추천 7.24.1

v2rayN for Windows

구독 관리, 노드 전환, 라우팅 분기, 시스템 프록시와 TUN 설정에 적합합니다. Desktop은 차세대 크로스 플랫폼 UI를 사용하고, WPF는 Windows 클래식 인터페이스로 기존 설정 메뉴와 사용 흐름에 더 가깝습니다.

우선 추천

Desktop 데스크톱 버전

차세대 크로스 플랫폼 인터페이스로, 처음 설치하거나 데스크톱 환경에서 일관된 화면을 원하는 사용자에게 적합합니다.

Desktop 데스크톱 버전 다운로드
클래식 인터페이스

WPF 버전

Windows의 안정적인 클래식 인터페이스로, 기존 메뉴 구조와 설정 경로에 익숙한 사용자에게 적합합니다.

클래식 WPF 버전 다운로드

Windows 시스템 및 선택 안내

확인 항목 권장 사항 확인 방법
프로세서 아키텍처 현재 메뉴는 x64입니다 ‘설정 → 시스템 → 시스템 정보’를 열고 시스템 종류를 확인하세요.
인터페이스 유형 새로 설치할 때는 Desktop 우선 기존에 WPF를 사용했거나 익숙한 설정 흐름이 있다면 WPF를 계속 선택해도 됩니다.
설치 권한 시스템 안내에 따라 설치를 완료하세요 TUN처럼 시스템 트래픽을 가로채는 기능은 권한 상승이 필요할 수 있습니다.
decision path

설치 패키지 선택 체크리스트

다운로드 실패 외에도 플랫폼, 아키텍처 또는 패키지 형식을 잘못 선택해 설치 문제가 발생하는 경우가 많습니다. 다음 순서로 데스크톱과 모바일 기기를 동일하게 확인할 수 있습니다.

system

기기 브랜드가 아닌 운영체제 확인

먼저 현재 기기에서 실행 중인 운영체제가 Windows, macOS, Android 또는 Linux인지 확인한 뒤 해당 플랫폼 패널로 이동하세요. 듀얼 부팅, 가상 머신과 원격 데스크톱에서는 실제로 클라이언트를 실행하는 시스템을 기준으로 합니다. 예를 들어 Windows 호스트에서 Linux 가상 머신을 실행하고 클라이언트를 가상 머신에 설치한다면 Linux 패키지를, 호스트 시스템에 설치한다면 Windows 패키지를 선택해야 합니다. 플랫폼에 따라 설치 형식, 권한 안내와 시스템 프록시 설정 메뉴가 달라집니다.

architecture

x64, arm64와 Apple Silicon 구분

프로세서 아키텍처에 따라 설치 패키지를 바로 실행할 수 있는지가 결정됩니다. Windows는 현재 x64 데스크톱 패키지를 제공하고, macOS는 Apple Silicon과 Intel로 나뉘며, Android는 arm64와 범용 패키지를 제공합니다. Linux는 x64와 arm64를 모두 지원합니다. 시스템에 따라 아키텍처가 x86_64, amd64, aarch64 또는 arm64로 표시될 수 있으므로 기기의 출시 연도만으로 판단하지 말고 대응 관계에 따라 선택하세요.

package

설치 형식과 인터페이스 경로 확인

Windows의 Desktop과 WPF는 인터페이스 경로의 차이이고, macOS의 두 DMG는 칩 아키텍처의 차이입니다. Android의 arm64와 범용 버전은 대상 아키텍처 범위가 다르며, Linux의 deb와 rpm은 패키지 관리 체계가 다릅니다. 파일 확장자는 버전의 높고 낮음을 나타내지 않으므로 rpm을 deb의 최신 버전으로 보거나 범용 Android 패키지를 더 많은 기능을 제공하는 버전으로 이해해서는 안 됩니다. 운영체제와 아키텍처를 기준으로 선택하세요.

configure

설치 후 계속해서 설정 가져오기

클라이언트 설치가 끝났다고 연결 경로가 구축된 것은 아닙니다. 유효한 구독을 가져오거나 서버를 직접 추가하고, 구독 목록을 업데이트한 뒤 노드와 프록시 모드를 선택하고 시스템 프록시 또는 필요한 TUN을 설정해야 합니다. 처음 연결할 때는 기본 시스템 프록시 모드로 브라우저 트래픽을 확인한 다음 DNS, 앱별 프록시와 사용자 지정 라우팅을 단계적으로 추가하면 문제 발생 시 원인을 찾기 쉽습니다.

구독 가져오기 및 연결 가이드 보기
after download

다운로드 후 설치 및 첫 실행

플랫폼마다 설치 화면은 다르지만 설정 흐름은 같습니다. 클라이언트 설치, 권한 확인, 구독 가져오기, 노드 선택, 프록시 활성화, 접속 경로 확인 순서로 진행합니다.

01

플랫폼별 설치 완료

Windows에서는 다운로드한 파일의 압축을 풀고 설치 프로그램을 실행한 뒤 선택한 Desktop 또는 WPF 버전에 따라 설치를 완료하세요. macOS에서는 DMG를 열고 앱을 애플리케이션 폴더로 옮깁니다. Android에서는 다운로드한 설치 패키지를 열고 시스템 안내를 따르세요. Linux에서는 배포판에 맞는 패키지 도구로 deb 또는 rpm을 설치하고, 파일 압축만 푼 뒤 내부의 단일 구성 요소를 직접 실행하지 마세요.

02

시스템 권한 확인

클라이언트를 처음 실행하면 네트워크 접근, 방화벽, VPN 가로채기 또는 가상 네트워크 인터페이스 관련 권한을 요청할 수 있습니다. 필요한 권한은 플랫폼과 활성화한 기능에 따라 다릅니다. 시스템 프록시만 사용할 때는 기본 네트워크 권한을 먼저 처리하면 되지만, TUN을 활성화하려면 클라이언트가 가상 네트워크 인터페이스를 생성하고 관리하도록 허용해야 합니다. 권한 안내가 표시되면 해당 기능을 먼저 확인한 뒤 활성화 여부를 결정하세요.

03

구독 가져오기 및 노드 업데이트

구독 관리 화면에서 전체 구독 주소를 추가하고 저장한 뒤 업데이트를 실행하세요. 노드 목록이 나타나면 이름, 프로토콜과 서버 정보가 올바르게 해석되었는지 먼저 확인합니다. 업데이트에 실패하면 구독 주소가 완전한지, 네트워크 요청이 성공했는지, 시스템 시간이 정확한지 확인하세요. 구독 업데이트가 완료되기 전에 프록시 모드를 반복해서 전환하지 마세요.

04

모드 선택 및 연결 경로 확인

사용 가능한 노드를 하나 선택하고 먼저 기본 시스템 프록시 모드로 확인하세요. 브라우저가 클라이언트를 통해 접속되면 라우팅 분기, DNS 또는 TUN을 설정합니다. 클라이언트는 연결된 것으로 표시되지만 앱에 접속할 수 없다면 노드 상태, 시스템 프록시, 로컬 수신 포트, DNS와 앱 자체의 프록시 설정을 순서대로 확인하세요. 여러 옵션을 동시에 변경하면 원인을 찾기 어렵습니다.

package notes

클라이언트 종류와 사용 범위

세 클라이언트는 서로 다른 플랫폼과 코어 경로를 대상으로 합니다. 운영체제, 기존 설정과 평소 관리 방식에 따라 선택하면 되며, 모든 클라이언트를 동시에 설치할 필요는 없습니다.

v2rayN

데스크톱 플랫폼 통합 진입점

v2rayN은 Windows, macOS와 Linux를 지원하며 데스크톱 시스템에서 구독, 서버, 시스템 프록시, 라우팅 규칙과 TUN을 관리하는 데 적합합니다. Windows에서는 Desktop과 WPF 두 가지 인터페이스를 제공하고, macOS와 Linux에서는 크로스 플랫폼 데스크톱 인터페이스를 사용합니다. 여러 데스크톱 기기에서 같은 구독을 사용할 수 있지만 플랫폼별 권한, 시스템 프록시와 설치 방식은 각각 설정해야 합니다.

v2rayNG

Android 일반적인 첫 선택

v2rayNG는 Xray 코어를 사용하며 모바일 환경에서 VPN 가로채기, 앱별 분할 라우팅, 구독 업데이트와 노드 전환을 중심으로 기능을 제공합니다. 일반적인 Android 설정은 v2rayNG부터 시작하면 됩니다. 데스크톱에서 사용하는 구독을 가져온 뒤에도 라우팅과 DNS를 확인하세요. 모바일 데이터, Wi-Fi와 백그라운드 실행 정책에 따라 데스크톱과 다른 동작이 발생할 수 있습니다.

v2flyNG

v2fly 코어 대안

v2flyNG는 설정에서 v2fly 코어를 명시적으로 요구하거나 기존 환경이 v2fly 동작을 기준으로 구성된 경우에 적합합니다. v2rayNG와 마찬가지로 일반적인 구독과 노드 설정을 처리할 수 있지만 지원 세부 사항, 기본 옵션과 업데이트 주기는 다를 수 있습니다. 클라이언트를 바꾸기 전에 구독에 포함된 프로토콜과 전송 설정을 대상 클라이언트가 지원하는지 확인하세요.

download faq

다운로드 및 설치 자주 묻는 질문

다음 질문은 설치 패키지 선택, 아키텍처 확인, 클라이언트 종류와 첫 연결 과정에 관한 내용입니다.

Windows에서는 v2rayN Desktop과 WPF 중 무엇을 다운로드해야 하나요?

Desktop은 처음 설치하거나 데스크톱 환경에서 일관된 인터페이스를 원하거나 여러 데스크톱 시스템을 오갈 사용자에게 적합한 차세대 크로스 플랫폼 인터페이스입니다. WPF는 Windows의 클래식 인터페이스로, 기존 v2rayN 메뉴와 작업 흐름에 익숙한 사용자에게 적합합니다. 두 버전 모두 구독 가져오기, 노드 선택, 시스템 프록시와 라우팅 설정을 지원합니다. 버전을 바꾸기 전에 구독 주소와 사용자 설정을 저장하세요.

macOS에서 Apple Silicon과 Intel 설치 패키지는 어떻게 구분하나요?

시스템 메뉴에서 ‘이 Mac에 관하여’를 열고 ‘칩’ 또는 ‘프로세서’ 항목을 확인하세요. Apple M 시리즈 칩이면 Apple Silicon arm64 버전을, Intel 프로세서이면 Intel x64 버전을 선택합니다. 칩 아키텍처는 시스템 외관과 직접적인 관련이 없고 같은 모델군에도 세대별 차이가 있을 수 있으므로 실제 시스템 표시를 기준으로 하세요.

Android에서는 arm64와 범용 버전 중 무엇을 다운로드해야 하나요?

2015년 이후 출시된 대부분의 Android 스마트폰은 arm64를 우선 선택하면 됩니다. arm64 패키지는 해당 아키텍처에 필요한 구성 요소만 포함하므로 아키텍처가 확실한 기기에 적합합니다. 아키텍처를 확인할 수 없거나 설치 중 호환되지 않는다는 메시지가 표시되거나 다른 프로세서 아키텍처를 사용하는 경우에는 해당 클라이언트의 범용 버전을 선택하세요. 범용 버전은 호환 가능한 아키텍처의 범위를 넓힐 뿐 기능이 더 많은 것은 아닙니다.

v2rayNG와 v2flyNG 중 무엇을 선택해야 하나요?

일반적인 Android 사용이라면 Xray 코어를 사용하는 v2rayNG부터 선택하세요. 기존 설정이 v2fly 코어에 의존하거나 현재 환경에서 v2fly 동작을 유지해야 한다면 v2flyNG를 선택합니다. 두 클라이언트의 구독, 라우팅과 DNS 설정 메뉴는 완전히 같지 않으므로 한 클라이언트에서 다른 클라이언트로 옮긴 뒤 설정을 다시 확인해야 합니다. 노드 목록이 표시되는지만 확인해서는 안 됩니다.

Linux에서는 deb와 rpm 중 어떤 설치 패키지를 선택해야 하나요?

Debian, Ubuntu 및 파생 배포판은 보통 deb를 선택하고, Fedora, Rocky Linux, AlmaLinux처럼 RPM 패키지 관리 체계를 사용하는 배포판은 rpm을 선택합니다. 패키지 형식을 정한 뒤 프로세서 아키텍처도 확인해야 합니다. x86_64 또는 amd64는 x64를, aarch64 또는 arm64는 arm64를 선택하세요. 패키지 형식이 맞아도 아키텍처가 다르면 정상적으로 설치되거나 실행되지 않습니다.

클라이언트를 설치했는데 왜 바로 연결되지 않나요?

설치 패키지는 클라이언트 프로그램만 배포합니다. 실행 후 유효한 구독을 가져오거나 서버를 직접 추가하고, 노드 목록을 업데이트한 뒤 사용 가능한 노드와 프록시 모드를 선택하고 시스템 프록시 또는 TUN을 활성화해야 합니다. 처음 설정할 때는 시스템 프록시로 브라우저 접속을 확인하고 기본 경로가 정상인 것을 확인한 뒤 복잡한 라우팅, DNS와 전체 트래픽 가로채기 설정을 추가하세요.

클라이언트 다운로드