CLIENT PACKAGES / GUI

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

운영체제와 프로세서 아키텍처에 맞는 설치 패키지를 선택하세요. 데스크톱에서는 v2rayN, Android에서는 우선 v2rayNG를 사용하고, V2Fly 코어가 필요하면 v2flyNG를 선택할 수 있습니다.

영구 무료 오픈 소스 한국어 문서 4개 플랫폼
설치 후 구독 가져오기 안내 보기 →

PLATFORM SELECTOR

플랫폼별 설치 패키지 선택

먼저 운영체제를 확인한 뒤 프로세서 아키텍처를 대조하세요. 플랫폼을 전환하면 페이지 주소에도 반영되므로 링크를 다시 열 때 해당 다운로드 영역으로 바로 돌아올 수 있습니다.

WINDOWS PACKAGES

Windows：v2rayN

Windows에서는 Desktop과 WPF 두 가지 x64 설치 경로를 제공합니다. 두 버전 모두 구독 관리, 회선 선택, 시스템 프록시 및 라우팅 설정에 사용할 수 있으며, 주요 차이는 UI 기술과 조작 방식입니다. 최신 클라이언트를 처음 사용한다면 Desktop을, 클래식 Windows 인터페이스가 필요하다면 WPF를 선택하세요.

v2rayN

v2rayN

현재 버전 7.24.1

추천

v2rayN은 데스크톱 플랫폼용 그래픽 클라이언트로, 구독 일괄 업데이트, 서버 필터링, 지연 시간 테스트, 라우팅 분할, DNS 설정 및 TUN 모드를 지원합니다. 설치 후에도 유효한 구독이나 서버 설정을 가져와야 하며, 클라이언트 자체에 회선이 포함되어 있지는 않습니다.

Desktop 데스크톱 버전 차세대 크로스 플랫폼 UI로, 처음 설치하거나 최신 인터페이스를 사용하려는 경우에 적합합니다.
Desktop x64 설치 패키지 다운로드
클래식 WPF 버전 안정적인 클래식 인터페이스로, 이전 버전의 조작 방식에 익숙한 Windows 사용자에게 적합합니다.
WPF x64 설치 패키지 다운로드

Windows 시스템 요구 사항 및 선택

항목권장설명
프로세서x64페이지에서 제공하는 두 Windows 설치 패키지는 모두 x64 버전입니다.
인터페이스 선택Desktop 우선Desktop은 차세대 크로스 플랫폼 인터페이스를 사용하고, WPF는 클래식 Windows 조작 방식을 유지합니다.
설치 권한애플리케이션 폴더에 쓰기 허용설치 프로그램이 실행되지 않으면 시스템 권한과 보안 알림을 확인한 뒤 설치 패키지를 다시 실행하세요.

SELECTION CHECKLIST

다운로드 전 세 가지 확인 사항

클라이언트 이름, 설치 패키지 아키텍처, 구독 설정은 서로 다른 세 가지 계층입니다. 순서대로 확인하면 설치 후 실행되지 않거나 가져온 뒤 연결되지 않는 문제를 줄일 수 있습니다.

01

클라이언트 결정

Windows, macOS, Linux에서는 v2rayN을 선택하세요. Android는 일반적으로 v2rayNG를 사용하고, 설정 요구 사항이나 코어 선호 또는 호환성 테스트가 V2Fly를 명확히 요구할 때만 v2flyNG로 변경하세요. 클라이언트마다 설정 항목과 코어 기능이 다르므로 앱을 업데이트할 때는 제품명을 동일하게 유지해야 합니다.

02

아키텍처 맞추기

데스크톱 기기는 x64와 arm64를 구분해야 하며, macOS는 Apple Silicon 또는 Intel에 정확히 맞춰야 합니다. Android에서 아키텍처를 확인할 수 없다면 범용 버전을 선택할 수 있습니다. 아키텍처는 현재 프로세서에서 설치 패키지를 실행할 수 있는지를 결정할 뿐 기능 수준을 의미하지 않으며, 파일 크기만 보고 판단해서도 안 됩니다.

03

구독 준비

설치 패키지에는 클라이언트 프로그램만 포함됩니다. 처음 실행한 후 유효한 구독 링크, 개별 서버 링크 또는 설정 파일을 가져온 다음 서버 목록을 업데이트해야 합니다. 가져오기가 끝나면 회선을 선택하고 연결한 뒤 실제 웹 페이지 접속과 클라이언트 로그로 설정이 정상인지 확인하세요.

INSTALL NOTES

설치, 업그레이드 및 첫 연결

설치 패키지 다운로드는 첫 단계일 뿐입니다. 기존 설정을 보존하고 구독을 업데이트하며 라우팅 모드를 선택하고 시스템 프록시를 확인해야 클라이언트가 예상대로 작동합니다.

처음 설치

현재 실행 중인 동일한 이름의 클라이언트를 종료한 뒤 설치 프로그램을 실행하세요. 데스크톱 시스템에서 권한 확인이 표시되면 앱 이름과 현재 작업을 확인하세요. Android는 설치 후 앱 목록에서 클라이언트를 실행하고 설치 파일을 반복해서 누르지 마세요. Linux 사용자는 배포판에 맞는 패키지 도구로 deb 또는 rpm을 처리해야 합니다.

클라이언트를 연 후 먼저 구독 관리 또는 가져오기 메뉴로 이동하세요. 구독 주소를 붙여 넣을 때 앞뒤 공백이 포함되지 않았는지 확인하고, QR 코드로 가져올 때는 스캔한 내용이 서버 설정 또는 구독인지 확인하세요. 업데이트 후 목록이 비어 있으면 클라이언트를 반복 설치하기보다 먼저 구독 주소 상태를 점검하세요.

기존 설치 위에 업그레이드

업그레이드 전에 구독 주소, 그룹 이름, 라우팅 모드, DNS 설정 및 사용자 지정 아웃바운드를 기록하세요. 대부분의 경우 새 버전을 바로 설치할 수 있지만, 주요 버전이 달라지면 설정 구조나 메뉴 위치가 변경될 수 있습니다. 업그레이드 후에는 프로그램 실행 여부만 확인하지 말고 구독 존재 여부, 현재 서버 선택 여부, 시스템 프록시가 예상 상태인지도 확인하세요.

업그레이드 후 설정을 읽는 데 문제가 생기면 먼저 클라이언트를 종료하고 이전 설정 폴더가 남아 있는지 확인하세요. 설정을 복원할 때 여러 시기의 설정 파일을 섞어 덮어쓰지 않도록 주의해야 이전 필드가 새 버전의 동작에 영향을 주는 것을 막을 수 있습니다.

CONNECT.SEQUENCE 구독 → 업데이트 → 회선 → 모드 → 연결 → 확인
  1. 구독 가져오기: 클라이언트의 구독 관리 메뉴에서 주소를 추가하고 저장하세요. 용도나 서비스 출처에 따라 이름을 구분해 지정할 수 있습니다.
  2. 목록 업데이트: 구독 업데이트를 실행하고 서버 항목이 실제로 기본 목록에 표시되는지 확인하세요. 업데이트에 실패하면 링크 유효 기간, 네트워크 상태 및 업데이트 방식을 점검하세요.
  3. 회선 선택: 먼저 서버 하나를 선택한 다음 연결을 시작하세요. 지연 시간 측정 결과는 필터링을 돕는 참고 자료일 뿐이며, 실제 사용 가능 여부는 연결 테스트로 확인해야 합니다.
  4. 모드 설정: 필요에 따라 시스템 프록시, TUN 또는 클라이언트가 제공하는 다른 트래픽 가로채기 방식을 선택하고, 라우팅 규칙이 현재 사용 환경에 맞는지 확인하세요.
  5. 연결 확인: 자주 사용하는 사이트에 접속하고 클라이언트 로그를 확인하세요. 일부 도메인만 문제가 있다면 설치 패키지를 바로 바꾸기보다 DNS, 라우팅 일치 여부 및 규칙 데이터를 계속 점검하세요.
전체 사용 가이드 보기 고급 설정 매뉴얼 열기

DOWNLOAD FAQ

다운로드 및 설치 FAQ

아래에서는 버전 선택, 프로세서 아키텍처, 설치 패키지 형식 및 최초 실행과 관련된 문제를 다룹니다. 구독, 라우팅 및 DNS의 전체 사용법은 사용 가이드와 고급 매뉴얼에서 확인할 수 있습니다.

Windows에서는 v2rayN Desktop과 WPF 중 무엇을 선택해야 하나요?

Desktop은 처음 설치하거나 최신 레이아웃을 사용하고 싶거나 여러 데스크톱 시스템에서 비슷한 조작 방식을 유지하려는 사용자에게 적합한 차세대 크로스 플랫폼 인터페이스입니다. WPF는 전통적인 v2rayN 인터페이스와 메뉴 위치에 익숙한 사용자에게 적합한 안정적인 Windows 클래식 버전입니다. 두 버전 모두 구독, 회선, 시스템 프록시 및 라우팅 설정에 사용되며, 선택 기준은 인터페이스 선호도이므로 동시에 설치할 필요는 없습니다.

macOS에서 Apple Silicon과 Intel을 어떻게 구분하나요?

시스템 메뉴에서 ‘이 Mac에 관하여’를 열고 ‘칩’ 또는 ‘프로세서’ 항목을 확인하세요. Apple M 시리즈로 표시되면 Apple Silicon 설치 패키지를, Intel 프로세서로 표시되면 Intel 설치 패키지를 선택합니다. 같은 제품군도 프로세서가 변경된 경우가 있으므로 출시 연도만으로 판단하지 마세요. 아키텍처를 맞추면 클라이언트 기능과 설정 과정은 동일합니다.

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

2015년 이후 출시된 대부분의 Android 스마트폰은 64비트 ARM 프로세서를 사용하므로 arm64를 우선 선택하세요. 기기가 오래되었거나 시스템 정보에서 프로세서 아키텍처를 확인할 수 없거나 arm64 설치 패키지가 호환되지 않는다고 표시될 때는 범용 버전을 사용하세요. 범용 버전은 더 넓은 기기를 지원하지만 설치 패키지 선택이 구독 내용을 바꾸지는 않으며, 연결 가능 여부는 클라이언트 버전, 코어 지원 및 서버 설정에 좌우됩니다.

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

대부분의 Android 사용자는 Xray 코어를 사용하고 일반적인 구독 및 라우팅 환경을 지원하는 v2rayNG를 먼저 선택합니다. v2flyNG는 V2Fly 코어를 사용하므로 기존 V2Fly 설정이 있거나 서비스 안내에서 해당 코어를 지정했거나 설정 호환성을 비교해야 할 때 적합합니다. 두 앱의 설정은 각각 관리해야 하며, 서로 다른 클라이언트의 데이터 폴더를 직접 덮어쓰는 것은 권장하지 않습니다.

Linux에서는 deb와 rpm 중 무엇을 선택해야 하나요?

Debian, Ubuntu 및 파생 시스템은 deb를, Fedora, RHEL 계열과 RPM 패키지 관리 환경은 rpm을 선택하세요. 패키지 형식을 확인한 뒤 프로세서도 판단해야 합니다. 일반 x64 데스크톱은 amd64 또는 x86_64에 해당하는 경로를, ARM 64비트 기기는 arm64 또는 aarch64 경로를 선택합니다. 배포판이 익숙하지 않다면 먼저 시스템의 패키지 관리 안내를 확인하세요.

설치 후 서버 목록이 보이지 않으면 어떻게 하나요?

클라이언트는 서버 설정을 자동으로 생성하지 않습니다. 설치 후 유효한 구독 주소를 추가하거나 개별 서버 링크 또는 인식 가능한 설정 파일을 가져와야 합니다. 구독을 저장한 뒤 수동으로 업데이트하고 서버 항목이 표시되면 하나를 선택해 연결하세요. 업데이트에 실패하면 링크가 완전한지, 구독이 만료되지 않았는지, 현재 네트워크에서 업데이트 주소에 접근할 수 있는지, 프록시를 통해 업데이트해야 하는지를 순서대로 확인하세요.