v2rayN
7.24.1데스크톱 버전과 WPF 버전은 서로 다른 인터페이스 기술을 사용합니다. 처음 설치한다면 Desktop을 우선 선택할 수 있습니다. 클래식 버전에서 업그레이드하면서 기존 작업 흐름을 유지하고 싶다면 WPF를 계속 사용하세요.
CLIENT PACKAGES / STABLE CHANNEL
운영체제, 프로세서 아키텍처 및 인터페이스 유형에 따라 클라이언트를 선택하세요. 데스크톱 플랫폼에서는 v2rayN을 사용하고, Android에서는 커널 생태계에 따라 v2rayNG 또는 v2flyNG를 선택할 수 있습니다.
아래의 네 플랫폼 탭에서 해당 패널로 이동하세요.
데스크톱 기기는 x86_64와 arm64를 구분하고, Android는 arm64 호환 여부를 우선 확인하세요.
실행 중인 기존 버전을 종료하고 설정을 백업한 뒤 설치 또는 업그레이드를 진행하세요.
PLATFORM REGISTRY
플랫폼 탭 선택 내용은 주소 표시줄에 반영됩니다. 플랫폼 표시가 포함된 페이지 주소를 복사하면 해당 다운로드 패널을 바로 열 수 있습니다.
platform: windows / arch: x86_64
Windows에서는 Desktop과 클래식 WPF 두 가지 인터페이스 버전을 제공합니다. Desktop은 최신 크로스플랫폼 UI로, 새로 설치하거나 여러 데스크톱 운영체제에서 사용할 때 비슷한 구조를 유지하기 좋습니다. WPF는 클래식 Windows 레이아웃을 이어가므로 메뉴, 설정 편집 및 트레이 조작이 기존 사용 방식과 가깝습니다. 두 버전 모두 64비트 Windows용이며, 설치 전에 기존 클라이언트를 종료해 로컬 수신 포트가 계속 점유되지 않도록 하세요.
데스크톱 버전과 WPF 버전은 서로 다른 인터페이스 기술을 사용합니다. 처음 설치한다면 Desktop을 우선 선택할 수 있습니다. 클래식 버전에서 업그레이드하면서 기존 작업 흐름을 유지하고 싶다면 WPF를 계속 사용하세요.
| 확인 항목 | 권장 사항 | 처리 방법 |
|---|---|---|
| 프로세서 아키텍처 | 64비트 x86 프로세서 | ‘시스템 정보’의 시스템 종류에서 x64를 확인하세요. |
| 인터페이스 버전 | 새로 설치할 때는 Desktop 우선 | 클래식 메뉴에 익숙하다면 WPF를 선택하되 두 버전을 동시에 실행하지 마세요. |
| 업그레이드 준비 | 트레이에서 기존 클라이언트 종료 | 먼저 구독, 라우팅 및 로컬 설정을 백업한 뒤 설치하세요. |
| 처음 연결하기 | 시스템 프록시 상태 확인 | 설정을 가져오고 노드를 선택한 다음 사용 범위에 맞춰 프록시 모드를 활성화하세요. |
platform: macos / package: dmg
macOS 설치 패키지는 칩 아키텍처에 따라 Apple Silicon과 Intel로 나뉩니다. 시스템 메뉴에서 ‘이 Mac에 관하여’를 열고 ‘칩’ 또는 ‘프로세서’ 항목을 확인하세요. Apple M 시리즈는 arm64를, Intel 프로세서는 x64를 선택합니다. 아키텍처를 잘못 선택하면 정상적으로 실행되지 않는 경우가 많으므로 기기 구매 연도만 보고 추측하지 말고 다운로드 전에 확인해야 합니다.
두 dmg 설치 패키지는 기능상 동일하며 프로세서 아키텍처만 다릅니다. Apple M 시리즈 기기는 arm64 버전을, Intel 기기는 x64 버전을 사용하세요.
| 확인 항목 | 확인 위치 | 선택 결과 |
|---|---|---|
| Apple M 시리즈 | ‘이 Mac에 관하여’에 Apple 칩으로 표시 | Apple Silicon arm64 설치 패키지를 다운로드하세요. |
| Intel 프로세서 | ‘이 Mac에 관하여’에 Intel로 표시 | Intel x64 설치 패키지를 다운로드하세요. |
| 처음 실행할 때 | 시스템 설정의 개인정보 보호 및 보안 | 시스템 안내에 따라 앱 실행 권한과 네트워크 권한을 승인하세요. |
| 프록시 적용 | 클라이언트 시스템 프록시 메뉴 | 노드에 연결한 뒤 활성화하고, 종료하기 전 필요에 따라 원래 상태로 되돌리세요. |
platform: android / package: apk
Android 패널은 클라이언트와 프로세서 아키텍처별로 구성되어 있습니다. v2rayNG는 Xray 커널 생태계를 사용하므로 일반적인 우선 선택이며, v2flyNG는 v2fly 커널을 사용해 해당 설정과의 호환성이 필요할 때 선택할 수 있습니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 시도하고, 아키텍처를 확인할 수 없거나 설치 중 호환되지 않는다는 안내가 나오면 범용 버전을 사용하세요. 두 클라이언트를 각각 설치할 수 있지만 일상적인 연결에서는 VPN 서비스 하나만 활성화해야 합니다.
Android용 그래픽 클라이언트로, Xray 커널 생태계를 사용합니다. 클립보드에서 공유 링크를 가져오고, 구독을 추가하고, 노드를 선택하고, 필요할 때 VPN 연결을 활성화할 수 있습니다.
v2fly 커널을 사용하는 Android 클라이언트로, 해당 커널의 설정 동작이 필요한 경우에 적합합니다. 가져오기 전에 구독 내용이 선택한 커널과 호환되는지 확인하세요.
| 확인 항목 | 우선 선택 | 추가 설명 |
|---|---|---|
| 최신 주류 기기 | arm64 | 현재 널리 사용되는 프로세서 아키텍처에 맞춘 설치 패키지입니다. |
| 아키텍처를 알 수 없음 | 범용 버전 | 기기 정보로 프로세서 유형을 확인할 수 없는 경우에 적합합니다. |
| 클라이언트 선택 | v2rayNG 우선 | v2fly 커널의 설정 동작이 필요할 때만 v2flyNG를 선택하세요. |
| 백그라운드 실행 | 필요한 백그라운드 활동 허용 | 배터리 제한으로 장시간 연결이 끊길 수 있으므로 시스템 설정에서 조정하세요. |
platform: linux / package: deb · rpm
Linux 설치 패키지는 먼저 배포판의 패키지 체계에 따라 선택한 다음 프로세서 아키텍처를 선택하세요. Debian, Ubuntu 및 파생 시스템은 보통 deb를 사용하고, Fedora, RHEL 계열 및 파생 시스템은 보통 rpm을 사용합니다. 일반적인 데스크톱 컴퓨터는 x86_64를, ARM 데스크톱 기기나 개발 보드 환경은 arm64를 선택합니다. 설치 전에 배포판 정보와 시스템 아키텍처 명령으로 교차 확인해 기기 외관만 보고 판단하지 않도록 하세요.
Linux 데스크톱 버전은 deb와 rpm 패키지를 제공하며, 각각 x86_64와 arm64를 지원합니다. 패키지 관리자가 데스크톱 실행 항목과 설치 위치를 처리하지만, 업그레이드 전에는 클라이언트 설정을 내보내는 것이 좋습니다.
시스템 아키텍처가 arm64 또는 aarch64로 표시될 때만 선택하세요. 패키지 체계도 현재 배포판과 일치해야 합니다.
| 시스템 유형 | 패키지 | 아키텍처 확인 |
|---|---|---|
| Debian, Ubuntu 계열 | deb | x86_64는 amd64에 해당하며, ARM 64비트는 arm64에 해당합니다. |
| Fedora, RHEL 계열 | rpm | x86_64는 x86_64를, ARM 64비트는 aarch64를 선택하세요. |
| 데스크톱 세션 | 그래픽 데스크톱 환경 | 설치 후 애플리케이션 메뉴에서 실행하고 트레이 표시 여부를 확인하세요. |
| 시스템 프록시 | 데스크톱 환경에 맞게 설정 | 연결 후 현재 데스크톱 세션에서 시스템 프록시를 사용하는지 확인하세요. |
INSTALLATION NOTES
설치 패키지의 정상 작동 여부는 플랫폼, 아키텍처, 설정 출처 및 시스템 프록시 상태에 크게 좌우됩니다. 먼저 다음 항목을 확인하면 불필요한 재설치와 설정 덮어쓰기를 줄일 수 있습니다.
Windows는 해당 데스크톱 설치 패키지를, macOS는 dmg를, Android는 apk를 사용하며, Linux는 배포판에 따라 deb 또는 rpm을 선택합니다. 파일 형식이 맞지 않으면 운영체제의 일반적인 패키지 설치 절차를 진행할 수 없습니다. Linux 사용자는 현재 배포판이 어느 패키지 관리 체계에 속하는지도 확인해야 하며, 데스크톱 환경 이름만 보고 판단해서는 안 됩니다.
아키텍처는 프로그램에 포함되는 기계 명령어의 종류를 결정합니다. macOS에서는 Apple Silicon이 arm64, Intel이 x64에 해당하고, Android 최신 주류 기기는 대체로 arm64입니다. Linux 일반 데스크톱 컴퓨터는 대부분 x86_64이며 ARM 기기는 arm64 또는 aarch64로 표시됩니다. 아키텍처가 맞지 않으면 설치되지 않거나, 실행 직후 종료되거나, 시스템에서 잘못된 형식이라고 안내하는 경우가 많습니다.
업그레이드 전에 현재 클라이언트 버전, 구독 그룹, 라우팅 모드, 수신 포트 및 시스템 프록시 상태를 기록하세요. 클라이언트 설정에는 직접 추가한 노드, 우회 규칙 및 사용자 지정 DNS 설정이 포함될 수 있어 프로그램 자체보다 다시 정리하기 어렵습니다. 인터페이스 버전을 바꿀 때는 복구 가능한 설정 사본을 각각 저장해야 합니다.
설치하기 전에 트레이나 애플리케이션 메뉴에서 기존 클라이언트를 완전히 종료하세요. 주 창만 닫으면 백그라운드 프로세스가 남을 수 있습니다. 업그레이드 후 연결에 실패하면 먼저 기존 프로세스가 로컬 프록시 포트를 점유하고 있는지 확인한 다음, 새 클라이언트에서 올바른 노드를 선택했는지와 시스템 프록시 또는 TUN이 예상대로 활성화되었는지 확인하세요.
CLIENT SCOPE
이름이 비슷한 클라이언트라도 지원 플랫폼, 커널 생태계 및 인터페이스 목적이 서로 다릅니다. 선택할 때는 먼저 운영체제를 확인하고 다음으로 설정 호환성을 살펴보세요. 같은 기기에 모든 클라이언트를 중복 설치할 필요는 없습니다.
Windows, macOS 및 Linux 데스크톱 시스템에서 사용합니다. 주요 기능은 구독 관리, 노드 선택, 라우팅 규칙, 시스템 프록시, TUN 및 설정 편집입니다. Windows에서는 Desktop과 클래식 WPF 두 가지 인터페이스를 제공하며, macOS와 Linux는 아키텍처 또는 패키지 체계에 맞는 설치 파일을 선택합니다. 데스크톱 사용자는 보통 이 클라이언트 하나만 설치하면 됩니다.
Android의 일반적인 우선 선택 클라이언트로, Xray 커널 생태계를 사용합니다. 구독 주소로 여러 노드를 통합 관리하거나 vmess, vless 등의 공유 링크를 직접 가져올 수 있습니다. 연결은 시스템 VPN 인터페이스를 통해 이루어지며, 처음 실행할 때 관련 권한을 승인해야 합니다. 백그라운드 실행 안정성은 기기의 배터리 정책과 앱 절전 설정에도 영향을 받습니다.
Android용 v2fly 커널 클라이언트로, 구독이나 수동 설정이 해당 커널의 동작에 명확히 의존하는 경우에 적합합니다. 선택하기 전에 설정 제공자가 프로토콜, 전송 계층 및 커널에 대해 안내한 내용을 확인하세요. 특별한 호환성 요구 사항이 없다면 먼저 v2rayNG를 사용하고, 전환할 때는 현재 클라이언트의 VPN 연결을 먼저 끊어야 합니다.
DOWNLOAD FAQ
다음 질문에서는 버전, 아키텍처, 패키지 형식 및 최초 연결 문제를 다룹니다. 설정 가져오기와 라우팅 모드의 전체 절차는 사용 가이드에서 확인하세요.
Desktop은 최신 크로스플랫폼 인터페이스를 사용하는 데스크톱 버전으로, 처음 설치하거나 Windows, macOS, Linux에서 비슷한 화면 구조를 사용하고 싶은 경우에 적합합니다. WPF는 Windows의 클래식 인터페이스 버전으로 메뉴 구성, 트레이 진입점 및 설정 경로가 기존 버전과 가깝습니다. WPF를 오랫동안 사용했고 설정이 안정적이라면 클래식 버전을 계속 사용해도 되며, 새로 설치할 때는 보통 Desktop을 선택합니다. 두 버전은 같은 로컬 프록시 포트를 사용할 수 있으므로 동시에 실행하지 마세요.
화면 왼쪽 위의 시스템 메뉴를 열고 ‘이 Mac에 관하여’로 이동한 뒤 ‘칩’ 또는 ‘프로세서’ 항목을 확인하세요. Apple M 시리즈로 표시되면 Apple Silicon arm64 패키지를, Intel로 표시되면 Intel x64 패키지를 다운로드합니다. 외관이 비슷한 기기라도 프로세서가 다를 수 있으므로 모델명이나 구매 시기만으로 추측하지 마세요. 설치 패키지의 아키텍처가 맞지 않으면 앱이 정상적으로 실행되지 않는 경우가 많습니다.
2015년 이후 출시된 대부분의 Android 스마트폰은 arm64를 우선 선택할 수 있으며, 파일에는 대상 아키텍처에 필요한 내용만 포함됩니다. 기기 정보로 프로세서 아키텍처를 확인할 수 없거나 arm64 패키지 설치 중 호환되지 않는다는 안내가 나오면 범용 버전을 사용하세요. 범용 버전은 지원 범위가 더 넓지만 클라이언트 기능의 목적은 arm64 버전과 다르지 않습니다. v2rayNG와 v2flyNG 중 선택할 때는 구독 설정이 어느 커널 생태계에 맞는지도 확인해야 합니다.
Debian, Ubuntu 및 파생 배포판은 보통 deb를 사용하고, Fedora, RHEL 계열 및 파생 배포판은 보통 rpm을 사용합니다. 형식을 정한 뒤에는 프로세서도 확인해야 합니다. 일반적인 데스크톱 컴퓨터는 대부분 x86_64이고, ARM 데스크톱 기기나 개발 보드는 arm64 또는 aarch64로 표시될 수 있습니다. 패키지 형식과 프로세서 아키텍처는 별개의 조건이므로 어느 하나라도 잘못 선택하면 설치에 실패할 수 있습니다.
대부분의 동일 유형 업그레이드는 바로 진행할 수 있지만, 먼저 기존 클라이언트를 완전히 종료하고 구독, 노드, 라우팅 및 DNS 설정을 백업하세요. Windows에서 WPF에서 Desktop으로 전환하거나, Linux에서 패키지 체계를 바꾸거나, 데스크톱 시스템을 이전할 때는 설정을 별도의 데이터로 취급해야 하며 모든 항목이 자동으로 이전된다고 가정하지 마세요. 업그레이드 후에는 먼저 구독 그룹과 로컬 수신 포트를 확인한 다음 시스템 프록시를 활성화하세요.
설치 패키지에는 클라이언트 프로그램만 포함되어 있습니다. 설치 후 유효한 구독 주소나 노드 공유 링크를 가져오고, 구독을 업데이트하고, 사용 가능한 노드를 선택한 다음 사용 환경에 따라 시스템 프록시 또는 TUN을 활성화해야 합니다. 클라이언트에는 연결됨으로 표시되지만 앱에서 네트워크에 접속할 수 없다면 클라이언트를 반복해서 설치하기보다 노드 설정, 시스템 시간, 로컬 포트, 프록시 모드 및 라우팅 규칙을 차례로 확인하세요.