CLIENT PACKAGES / CURRENT RELEASES

V2Ray 클라이언트 다운로드 및 설치 파일 선택

운영 체제, 프로세서 아키텍처, 인터페이스 유형에 따라 설치 파일을 선택하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 사용하고, v2fly 커널 구현이 필요한 경우 v2flyNG를 선택할 수 있습니다.

v2rayN 7.24.1 v2rayNG 2.2.6 v2flyNG 1.10.31 GUI CLIENTS

PLATFORM SELECTOR

플랫폼별 설치 파일 선택

먼저 현재 기기의 플랫폼으로 전환한 뒤 아키텍처와 패키지 형식을 확인하세요. 플랫폼 탭은 페이지 주소와 동기화되므로 링크를 다시 열어도 해당 다운로드 영역을 바로 복원할 수 있습니다.

WINDOWS / X64

Windows：v2rayN

Windows에서는 Desktop과 클래식 WPF 두 가지 인터페이스를 제공합니다. 처음 설치하면서 다른 플랫폼과 비슷한 데스크톱 구조를 원한다면 Desktop을 선택하세요. 기존 메뉴, 트레이 조작, WPF 레이아웃에 익숙하다면 클래식 WPF를 계속 사용할 수 있습니다. 두 설치 파일 모두 Windows x64용이므로 동시에 설치할 필요는 없습니다.

v2rayN Desktop

현재 버전 7.24.1

추천

차세대 크로스플랫폼 UI를 사용하며 설정 메뉴, 구독 그룹, 라우팅 페이지가 통일된 데스크톱 구조로 제공됩니다. 신규 설치 사용자뿐 아니라 여러 데스크톱 시스템에서 비슷한 조작 흐름을 원하는 사용자에게 적합합니다.

  • 아키텍처x64
  • 인터페이스Desktop
  • 용도신규 설치 및 일상적인 설정
v2rayN Desktop 버전 다운로드

v2rayN 클래식 WPF

현재 버전 7.24.1

클래식 인터페이스

Windows용 클래식 안정 버전으로 익숙한 WPF 창, 메뉴, 트레이 조작을 유지합니다. 기존 설정을 옮기기 전 구독 그룹, 라우팅 모드, 로컬 수신 포트를 기록해 두면 이전 버전과 새 버전의 폴더가 섞여 혼동되는 일을 줄일 수 있습니다.

  • 아키텍처x64
  • 인터페이스WPF
  • 용도기존 조작 방식 유지
클래식 WPF 버전 다운로드

Windows 시스템 요구 사항 및 설치 순서

확인 항목 요구 사항 처리 방법
프로세서 아키텍처 x64 “설정 → 시스템 → 시스템 정보”에서 시스템 종류를 확인하세요. 이 페이지의 Windows 패키지는 64비트 데스크톱 시스템용입니다.
설치 권한 설치 프로그램 실행 가능 시스템에서 권한 확인 창이 나타나면 앱 이름과 작업 내용을 확인한 뒤 설치를 계속하세요.
설정 마이그레이션 기존 설정을 먼저 기록 구독 주소, 그룹, 라우팅 모드, 로컬 포트, 시작 시 자동 실행 상태를 중점적으로 기록하세요.
연결 전제 조건 구독 또는 노드 설정 설치가 끝나면 설정을 가져오고 구독을 업데이트한 뒤 노드를 선택하고 시스템 프록시 또는 TUN 모드를 활성화하세요.

Desktop과 WPF는 클라이언트 인터페이스 선택지이며, 연속해서 모두 설치해야 하는 구성 요소가 아닙니다. 이전 버전에서 마이그레이션할 때는 먼저 실행 중인 클라이언트와 시스템 프록시를 종료한 후 설치하고, 완료 뒤 로컬 수신 포트가 다른 네트워크 도구와 충돌하지 않는지 확인하는 것이 좋습니다.

INSTALLATION ROUTE

설치 파일에서 연결까지

다운로드는 클라이언트 준비만 완료합니다. 이후 설정 가져오기, 노드 선택, 트래픽 전환 방식 설정, 접속 경로 확인이 필요합니다. 순서대로 진행하면 설치 문제, 설정 문제, 네트워크 문제를 구분해 판단할 수 있습니다.

  1. 01

    플랫폼, 아키텍처 및 패키지 형식 확인

    Windows 사용자는 Desktop과 클래식 WPF 중 하나를 선택하세요. Mac 사용자는 칩 항목에 따라 arm64 또는 x64를 선택하고, Android 사용자는 arm64와 Universal 중 우선순위를 판단하세요. Linux 사용자는 배포판의 패키지 체계와 uname -m 출력 결과를 함께 확인해야 합니다. 설치 파일이 열리지 않거나 아키텍처 비호환 메시지가 표시되면 노드 매개변수를 바꾸지 말고 이 단계로 돌아오세요.

  2. 02

    설치 완료 후 시스템 권한 처리

    데스크톱은 시스템 설치 절차에 따라 앱을 배치하고, Android는 시스템 안내에 따라 설치를 완료하세요. 처음 연결할 때 네트워크, VPN 서비스 또는 관련 확장 권한을 요구할 수 있습니다. 이 권한은 클라이언트가 로컬 트래픽 진입점을 만드는 데 사용됩니다. 권한을 부여한 뒤 클라이언트로 돌아와 연결 상태가 변경되었는지 확인하세요.

  3. 03

    구독 또는 단일 노드 설정 가져오기

    클라이언트 자체에는 구독이나 노드가 포함되어 있지 않습니다. 구독 링크는 해당 구독 그룹 메뉴에 추가한 뒤 업데이트하세요. 단일 노드 공유 링크는 클립보드 가져오기 또는 스캔 메뉴로 추가할 수 있습니다. 가져온 뒤 서버 주소, 포트, 프로토콜, 전송 항목이 표시되는지 확인한 다음 다음 단계로 진행하세요.

  4. 04

    노드 및 라우팅 모드 선택

    노드 목록에서 대상 설정을 선택한 뒤 사용 범위에 맞춰 시스템 프록시, TUN, VPN 서비스 또는 클라이언트가 제공하는 해당 모드를 선택하세요. 클라이언트만 실행하고 트래픽 전환 방식을 활성화하지 않으면 브라우저와 다른 앱이 자동으로 클라이언트를 거치지 않는 경우가 많습니다. 분할 라우팅 규칙에 따라 프록시로 보낼 대상, 직접 연결할 대상, 차단할 대상도 달라집니다.

  5. 05

    연결 확인 및 로그 확인

    먼저 확실히 접속 가능한 일반 웹페이지를 열어 DNS 확인, TCP 연결, 브라우저 접속이 정상인지 확인하세요. 그다음 프록시가 필요한 대상에 접속합니다. 실패하면 발생 시간을 기록하고 클라이언트 로그를 확인하세요. 시간 초과, TLS 핸드셰이크, DNS, 라우팅 미일치, 로컬 포트 점유는 서로 다른 문제이므로 로그 키워드에 따라 각각 처리해야 합니다.

PACKAGE DECISIONS

설치 파일 선택 시 확인할 네 가지

모델명이 같다고 해서 설치 파일을 다른 플랫폼이나 아키텍처에서 사용할 수 있는 것은 아닙니다. 다운로드 전에 아래 네 가지를 확인하면 설치 중 발생하는 문제를 크게 줄일 수 있습니다.

PLATFORM

운영 체제가 일치해야 함

Windows 설치 파일, macOS 디스크 이미지, Android APK, Linux deb와 rpm은 각각 해당 시스템에서 처리됩니다. 파일 확장자가 첫 번째 판단 기준입니다. 다른 시스템의 패키지를 현재 기기에 복사해도 실행 가능한 현재 플랫폼용 앱으로 변환되지는 않습니다.

ARCH

프로세서 아키텍처가 일치해야 함

x64, arm64, amd64, aarch64는 자주 사용하는 아키텍처 표기입니다. amd64와 x64는 같은 64비트 데스크톱 계열이고, aarch64와 arm64는 ARM 64비트 아키텍처에 해당합니다. Mac은 “이 Mac에 관하여”, Linux는 uname -m 결과를 기준으로 하며, Android에서 확인할 수 없을 때는 Universal 버전을 사용하세요.

PACKAGE

Linux는 패키지 체계도 확인해야 함

deb와 rpm은 확장자만 다른 것이 아니라 서로 다른 패키지 관리 체계에 대응합니다. 시스템 기본 패키지 형식을 사용하면 설치 프로그램이 의존성, 메뉴 항목, 이후 제거를 처리하는 데 유리합니다. 파일 크기나 이름 길이로 패키지 형식을 결정하면 안 됩니다.

CLIENT

클라이언트와 설정 요구 사항을 맞춰야 함

데스크톱에서는 v2rayN을 사용합니다. Android는 기본적으로 v2rayNG를 선택하고, 설정 요구 사항이나 점검 대상이 v2fly 커널을 명확히 가리킬 때만 v2flyNG를 고려하세요. 클라이언트를 바꿔도 만료된 구독, 잘못된 노드 매개변수, 시스템 시간 오차가 자동으로 해결되지는 않습니다.

DOWNLOAD FAQ

설치 파일 다운로드 및 설치 FAQ

버전 선택, 칩 아키텍처, 설치 파일 형식, 최초 연결과 관련된 문제를 정리했습니다. 구독 업데이트, 노드 시간 초과, DNS, 시스템 프록시 문제는 문제 해결 페이지에서 계속 확인할 수 있습니다.

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

Desktop 버전은 차세대 크로스플랫폼 인터페이스를 사용해 통일된 데스크톱 환경을 원하는 신규 설치 사용자에게 적합합니다. 클래식 WPF 버전은 Windows 기본 인터페이스와 기존 사용 방식을 유지해 익숙한 메뉴 구조를 선호하는 사용자에게 알맞습니다. 두 버전 모두 Windows x64용이므로 하나만 설치하면 됩니다. 인터페이스 버전을 바꾸기 전에는 구독 그룹, 라우팅 모드, 로컬 수신 포트를 기록하는 것이 좋습니다.

macOS에서 Apple Silicon 버전과 Intel 버전 중 무엇을 다운로드해야 하나요?

시스템 메뉴에서 “이 Mac에 관하여”를 열고 칩 또는 프로세서 항목을 확인하세요. Apple M 시리즈 칩이면 Apple Silicon arm64 버전을, Intel 프로세서면 Intel x64 버전을 선택합니다. 기기 색상, 화면 크기, 구매 연도만으로 판단하지 마세요. 외관이 비슷한 모델도 아키텍처가 다를 수 있습니다.

Android에서는 arm64와 Universal 중 무엇을 선택해야 하나요?

2015년 이후 출시된 대부분의 Android 스마트폰은 보통 arm64 아키텍처를 사용하므로 arm64 버전을 먼저 선택하는 것이 좋습니다. 기기 아키텍처를 확인할 수 없거나 arm64 설치 파일이 호환되지 않는다고 표시될 때 Universal 버전을 사용하세요. Universal 버전은 호환 범위가 넓지만 모든 기기에서 기본으로 선택해야 하는 것은 아닙니다.

Linux에서는 deb와 rpm 중 어떤 설치 파일을 다운로드해야 하나요?

Debian, Ubuntu 및 파생 배포판은 deb를, Fedora, Rocky Linux, AlmaLinux, RHEL 계열 배포판은 rpm을 사용합니다. 또한 uname -m 출력에 따라 x86_64 또는 arm64 아키텍처를 선택해야 합니다. 배포판 계열을 모르겠다면 먼저 /etc/os-release의 이름과 계열 정보를 확인하세요.

클라이언트를 설치했는데도 바로 연결할 수 없는 이유는 무엇인가요?

클라이언트 설치 후에도 사용 가능한 구독 주소나 단일 노드 설정을 가져오고 대상 노드를 선택한 다음 시스템 프록시, VPN 서비스 또는 해당 트래픽 전환 모드를 활성화해야 합니다. 클라이언트 자체에는 구독이나 노드가 포함되어 있지 않습니다. 노드를 가져왔는데도 연결되지 않으면 먼저 기기 시간, 노드 매개변수, 현재 네트워크, 클라이언트 로그를 확인하세요.

설치 완료 후 다음 단계

구독 가져오기, 노드 선택, 시스템 프록시 설정부터 진행하세요. 구독 실패, 노드 시간 초과, 브라우저와 터미널의 동작 차이가 발생하면 증상에 맞는 문서로 이동해 확인하세요.

빠른 시작 보기 문제 해결 열기