데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. 운영체제를 고른 다음 칩 아키텍처와 설치 패키지 형식을 확인하세요.
다운로드 전 준비설치 패키지에는 클라이언트 프로그램이 포함되어 있습니다. 처음 연결하려면 사용 권한이 있는 구독 주소나 공유 링크도 필요합니다. 기존 설정이 있다면 이전 클라이언트에서 먼저 백업하세요.
구독 가져오기 방법 보기 →같은 클라이언트, 두 가지 인터페이스. 처음이라면 Desktop을 선택하고, 클래식한 화면이 익숙하다면 WPF를 선택하세요.
Desktop 데스크톱 버전 차세대 크로스 플랫폼 UI
Desktop 버전 다운로드 · x64처음 설치하거나 여러 데스크톱 운영체제에서 비슷한 화면을 사용하고 싶은 경우에 적합합니다. ZIP 압축 파일을 다운로드한 뒤 별도 폴더에 압축을 풀고, 패키지에 포함된 설치 프로그램을 실행하세요.
클래식 WPF 버전 안정적인 클래식 버전
클래식 WPF 버전 다운로드 · x64기존 Windows 데스크톱 레이아웃을 유지해 이전 메뉴에 익숙한 사용자에게 적합합니다. 두 버전은 화면 배치가 다를 수 있으므로, 안내를 읽을 때는 ‘구독 그룹’, ‘시스템 프록시’처럼 기능 이름을 기준으로 찾아보세요.
Windows의 ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하세요. 이 페이지의 설치 파일은 모두 x64 패키지이므로 컴퓨터 브랜드만으로 아키텍처를 판단하지 마세요. 최신 64비트 Windows 데스크톱 환경에서 현재 클라이언트를 사용하는 것이 좋습니다. 구형 시스템은 앱 프레임워크와 런타임 요구 사항도 확인해야 합니다. 압축 파일이 풀린다는 이유만으로 호환된다고 판단할 수는 없습니다.
처음 설치할 때는 클라이언트를 실행할 위치를 명확히 지정하세요. 압축 프로그램의 임시 미리보기 창에서 바로 실행하면 설정 저장, 구성 요소 호출, 업그레이드 과정에서 경로 문제가 생길 수 있습니다. 시스템에서 런타임 환경 설치를 요구하면 안내를 읽고 필요한 구성 요소를 확인한 뒤, 시스템에서 지원하는 방식으로 설치하세요.
기존 버전에서 이전할 때는 먼저 설정을 내보내고 시스템 트레이에서 이전 프로세스를 종료하세요. Desktop과 WPF를 동시에 실행할 필요는 없습니다. 두 프로세스가 같은 로컬 수신 포트를 사용하면 나중에 실행한 프로그램에서 프록시를 제공하지 못할 수 있습니다. 설정을 가져온 뒤 유효한 항목을 선택하고 시스템 프록시를 설정한 다음 브라우저에서 연결을 확인하세요. 테스트를 마칠 때 시스템 프록시가 원래대로 복원되었는지도 확인하세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 시스템 환경 | Windows 10 / 11 x64 환경을 권장합니다. 구체적인 최소 요구 사항은 현재 설치 패키지의 안내를 확인하세요. |
| 프로세서 아키텍처 | 이 페이지에서는 x64 패키지를 제공합니다. 설치 전에 시스템 정보에서 ‘시스템 종류’를 확인하세요. |
| 런타임 환경 | 설치 프로그램의 안내에 따라 필요한 프레임워크나 런타임 라이브러리를 설치하세요. 누락된 구성 요소 안내를 무시하지 마세요. |
| 프록시 및 권한 | 일반 시스템 프록시와 TUN은 작동 방식이 다릅니다. TUN을 사용하려면 높은 권한과 가상 네트워크 어댑터 구성 요소가 필요할 수 있습니다. |
Apple 메뉴에서 ‘이 Mac에 관하여’를 열고 ‘칩’ 또는 ‘프로세서’ 항목에 따라 선택하세요.
Apple Silicon M 시리즈 칩
Apple Silicon 버전 다운로드‘이 Mac에 관하여’에 Apple M 시리즈 칩이 표시되면 arm64를 선택하세요. 칩에 맞는 빌드를 사용하면 아키텍처 변환으로 인한 호환성 문제를 줄일 수 있습니다.
Intel x64 아키텍처
Intel 버전 다운로드‘이 Mac에 관하여’에 Intel 프로세서가 표시되면 이 버전을 선택하세요. 구입 연도만으로 칩을 추측하지 마세요. 같은 시기에 출시된 기기라도 아키텍처가 다를 수 있습니다.
DMG 파일을 다운로드해 디스크 이미지를 연 다음, 창의 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮겨 실행하세요. 마운트된 이미지에서 클라이언트를 계속 실행하지 마세요. 이미지를 꺼내면 경로가 더 이상 유효하지 않을 수 있습니다. 처음 열기 전에 Apple Silicon과 Intel 중 올바른 버전을 선택했는지 다시 확인하세요. 아키텍처 불일치와 시스템 보안 안내는 서로 다른 문제이므로 따로 해결해야 합니다.
시스템에서 처음 실행을 차단하면 다운로드 경로와 앱의 신원을 먼저 확인한 다음 ‘시스템 설정 → 개인정보 보호 및 보안’에서 관련 안내를 읽으세요. 확인된 해당 실행 요청만 처리하면 됩니다. 클라이언트 설치를 위해 시스템 보안 기능을 전역으로 끌 필요는 없습니다. 시스템 버전이 오래되었다는 안내가 나오면 다른 아키텍처 패키지를 반복해서 다운로드하지 말고 앱의 실제 호환 요구 사항을 확인하세요.
구독을 가져온 뒤에는 일반 시스템 프록시로 먼저 연결을 확인하세요. 시스템 프록시는 해당 설정을 따르는 앱에만 적용되며, 터미널 프로그램이나 자체 프록시 설정이 있는 앱은 별도로 구성해야 할 수 있습니다. TUN이 필요하다면 권한 안내를 읽고 같은 기능을 사용하는 다른 네트워크 도구가 있는지 확인하세요. 네트워크 환경을 바꾼 뒤 접속에 문제가 생기면 프록시를 중지하고 일반 네트워크가 정상인지 확인한 다음 연결을 다시 시작하세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 칩 종류 | Apple M 시리즈는 arm64, Intel 프로세서는 x64를 선택하세요. |
| 시스템 버전 | ‘이 Mac에 관하여’에서 버전을 확인하고, 현재 앱에서 안내하는 최소 시스템 요구 사항을 따르세요. |
| 설치 위치 | ‘응용 프로그램’ 폴더에 설치하세요. 임시로 마운트한 디스크 이미지에서 계속 실행하지 마세요. |
| 네트워크 권한 | 실제로 사용할 프록시 방식에 맞춰 권한을 설정하세요. TUN 권한은 일반 시스템 프록시와 별도로 확인해야 합니다. |
먼저 v2rayNG를 확인하세요. V2Fly 호환성이 필요한 경우에만 v2flyNG를 고려하세요.
arm64 일반적인 스마트폰에 권장
v2rayNG 다운로드 · arm642015년 이후 출시된 일반적인 스마트폰이라면 arm64를 먼저 고려할 수 있지만, 휴대전화가 실제로 64비트 시스템을 실행하는지 확인해야 합니다. 프로세서가 64비트를 지원하더라도 기기 펌웨어가 같은 아키텍처를 사용한다고 단정할 수는 없습니다.
범용 버전 다중 아키텍처 패키지
v2rayNG 다운로드 · 범용 버전시스템 아키텍처를 아직 확인할 수 없는 기기에 적합합니다. 범용 패키지는 용량이 더 큰 편입니다. 아키텍처 선택 문제는 해결하지만 시스템 버전이나 앱 서명 요구 사항을 우회하지는 않습니다.
arm64
v2flyNG 다운로드 · arm6464비트 ARM 시스템용입니다. 기존 설정에서 V2Fly와의 호환성이 명확히 필요한 사용자에게 적합합니다. V2Ray 생태계에 속한다는 이유만으로 정상 작동 중인 클라이언트를 바꿀 필요는 없습니다.
범용 버전
v2flyNG 다운로드 · 범용 버전다양한 아키텍처의 기기를 위한 대안입니다. 선택하기 전에 구독에 사용된 프로토콜과 기능이 현재 코어에서 지원되는지 확인하세요. 서로 다른 코어의 기능 목록이 완전히 같다고 가정해서는 안 됩니다.
APK를 열면 Android에서 현재 브라우저나 파일 관리자가 앱을 설치하도록 허용하라는 메시지가 표시될 수 있습니다. 실제로 사용하는 앱에 설치 권한을 부여하면 됩니다. 설치가 끝난 뒤에는 이 권한을 해제할 수 있습니다. ‘앱이 설치되지 않았습니다’라는 메시지가 나오면 시스템 버전, 저장 공간, 패키지 아키텍처를 확인한 다음 서명이 다른 같은 이름의 앱이 이미 설치되어 있는지 살펴보세요.
기존 설정이 있다면 서명 충돌을 없애려고 바로 앱을 삭제하지 마세요. 원래 앱에서 복원 가능한 백업을 저장한 뒤 이전 방법을 결정하세요. 구독 주소와 공유 링크에는 접속 정보가 포함될 수 있으므로 백업 파일도 민감한 자료로 취급해야 합니다. v2rayNG와 v2flyNG는 이름이 비슷하지만 사용하는 코어가 다릅니다. 가져오기에 성공한 뒤에도 프로토콜과 전송 설정이 호환되는지 확인하세요.
처음 연결을 시작하면 기기 트래픽을 처리하기 위해 Android에서 VPN 연결 요청을 표시합니다. 앱 이름을 확인한 뒤 허용하고, 같은 VPN 채널을 사용하는 다른 앱은 동시에 실행하지 마세요. 화면을 잠근 뒤 연결이 끊기면 배터리 최적화와 백그라운드 활동 제한을 확인하세요. 먼저 앱을 화면에 띄운 상태에서 연결을 확인한 다음 백그라운드 설정을 조정하면 문제를 더 쉽게 파악할 수 있습니다.
| 확인 항목 | 선택 기준 |
|---|---|
| 시스템 및 아키텍처 | 기기 설정에서 Android 버전을 확인하세요. arm64에는 64비트 ARM 시스템이 필요하며, 최소 시스템 버전은 설치 프로그램의 요구 사항을 따릅니다. |
| 설치 권한 | 실제로 사용하는 브라우저나 파일 관리자가 앱을 설치하도록 허용하세요. 설치 후에는 권한을 해제할 수 있습니다. |
| 연결 권한 | 처음 연결할 때 시스템 VPN 요청을 승인하세요. 동시에 다른 VPN 앱을 실행하지 마세요. |
| 백그라운드 실행 | 화면을 켠 상태에서 연결이 정상인지 확인한 뒤 필요에 따라 배터리 최적화, 백그라운드 활동, 자동 시작 설정을 조정하세요. |
배포판에 맞춰 deb 또는 rpm을 고른 다음 기기 아키텍처에 따라 x64 또는 arm64를 선택하세요.
deb 설치 패키지 Debian / Ubuntu 계열
deb 다운로드 · x64 arm64 기기: deb 다운로드 →deb 패키지 관리 체계를 사용하는 경우 선택하세요. 설치 전에 시스템 설정에서 프로세서와 시스템 정보를 확인하세요. 패키지 이름의 amd64는 일반적인 x64 데스크톱 아키텍처를 뜻하며 특정 프로세서 브랜드에만 해당하지 않습니다.
rpm 설치 패키지 Fedora / RHEL 계열
rpm 다운로드 · x64 arm64 기기: rpm 다운로드 →rpm 패키지 관리 체계를 사용하는 경우 선택하세요. 패키지 형식은 첫 단계일 뿐이므로 배포판 버전과 의존성 요구 사항도 확인해야 합니다. 여기서 aarch64와 arm64는 같은 종류의 64비트 ARM 아키텍처를 가리킵니다.
먼저 시스템의 ‘설정’ 또는 ‘정보’ 페이지를 열어 배포판, 버전, 프로세서 아키텍처를 확인하세요. 호환되는 패키지를 다운로드한 뒤 배포판에 포함된 소프트웨어 설치 프로그램으로 열고, 의존성과 권한 안내를 확인한 다음 설치를 진행하세요. 이 클라이언트는 GUI 데스크톱 환경용입니다. 패키지를 다운로드할 수 있다고 해서 모든 최소 구성 시스템에서 실행할 수 있는 것은 아닙니다.
설치 프로그램에서 의존성 누락, 버전 미충족, 아키텍처 오류를 알리면 진행을 멈추세요. 의존성을 무시하거나 패키지 형식을 반복해서 변환해 설치를 시도하지 마세요. rpm 또는 deb를 사용하더라도 배포판마다 기본 런타임 라이브러리가 다를 수 있습니다. 현재 빌드의 요구 사항을 배포판이 충족하는지 먼저 확인하세요.
실행한 뒤 구독을 가져오고 항목을 선택해 로컬 프록시 연결을 확인하세요. Linux 데스크톱 환경마다 시스템 프록시를 적용하는 방식은 다를 수 있습니다. 브라우저가 데스크톱 설정을 따르기도 하고 자체 설정을 유지하기도 합니다. 특정 앱만 접속할 수 없다면 클라이언트를 바로 재설치하지 말고 해당 앱의 프록시 옵션부터 확인하세요. TUN에는 추가 네트워크 권한이 필요하므로 일반 프록시가 정상 작동하는지 확인한 뒤 활성화하는 것이 좋습니다.
| 확인 항목 | 선택 기준 |
|---|---|
| 데스크톱 환경 | GUI 앱을 실행할 수 있는 데스크톱 환경과 현재 빌드에서 요구하는 기본 런타임 라이브러리가 필요합니다. |
| 패키지 관리 체계 | Debian / Ubuntu 계열은 보통 deb, Fedora / RHEL 계열은 보통 rpm을 선택합니다. |
| 아키텍처 대응 | x64는 amd64 / x86_64, arm64는 arm64 / aarch64에 해당합니다. |
| 의존성 및 권한 | GUI 설치 프로그램으로 의존성을 확인하세요. TUN 권한은 일반 앱 실행 권한과 별도로 처리해야 합니다. |
설치가 끝나면 먼저 연결을 확인한 다음 규칙을 세부 조정하세요. 한 번에 한 종류의 설정만 바꾸면 로그와 실제 결과를 비교하기 쉽습니다.
첫 설정 단계별 안내 →아키텍처, 인터페이스, 설정은 서로 다른 문제입니다. 먼저 어느 단계에서 막혔는지 파악한 다음 적절한 해결 방법을 선택하세요.
사용 권한이 있는 구독 주소나 단일 공유 링크가 필요합니다. 클라이언트는 설정을 읽고 연결을 처리하지만, 설치 패키지에 바로 사용할 수 있는 원격 서비스가 포함되어 있지는 않습니다. 구독 주소에는 보통 접속 정보가 들어 있으므로 공개 스크린샷이나 채팅, 문제 해결 로그에 노출하지 마세요.
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 Desktop 버전을 먼저 고려하세요. 클래식한 Windows 화면에 익숙하다면 안정적인 WPF 버전을 선택할 수 있습니다. 두 버전 모두 연결과 구독 관리에 사용됩니다. 이전하기 전에 백업하고, 처음에는 한 버전만 실행해 로컬 포트 충돌을 방지하세요.
arm64 패키지는 64비트 ARM 시스템용입니다. 2015년 이후 출시된 일반적인 스마트폰이라면 우선 이 버전을 선택할 수 있지만, 실제 기기의 시스템 아키텍처를 확인해야 합니다. 범용 패키지는 여러 아키텍처를 지원하는 대신 용량이 더 큰 편입니다. 기기와 호환되지 않는다는 메시지가 나오면 먼저 시스템 아키텍처를 확인한 뒤 범용 패키지를 고려하세요.
먼저 클라이언트의 백업 또는 내보내기 기능을 이용해 구독 그룹, 라우팅 프리셋, 사용자 설정을 저장한 다음 실행 중인 이전 클라이언트를 종료하세요. 가능한 한 기존 설치 방식을 그대로 사용해 업그레이드하세요. Android는 덮어쓰기 설치 시 앱 서명이 같아야 합니다. 서명 충돌이 발생해도 바로 삭제하지 말고 설정을 백업했는지 먼저 확인하세요.
설치가 끝났다고 설정까지 적용된 것은 아닙니다. 먼저 구독을 가져와 유효한 항목을 선택하고, 클라이언트를 실행한 뒤 시스템 프록시 또는 VPN 권한을 확인하세요. 시스템 프록시는 해당 설정을 따르는 앱에만 적용됩니다. 계속 실패하면 로그에서 포트 충돌, DNS, 핸드셰이크 관련 메시지를 확인하고 하나씩 점검하세요. 여러 설정을 동시에 바꾸지 마세요.
먼저 배포판의 패키지 관리 체계를 확인하세요. Debian·Ubuntu 계열은 보통 deb, Fedora·RHEL 계열은 보통 rpm을 사용합니다. 그런 다음 프로세서 아키텍처가 x64인지 arm64인지 확인하세요. 패키지 형식이 맞아도 시스템 의존성이 충족된다는 뜻은 아닙니다. 설치 프로그램에서 런타임 라이브러리가 없다고 알리면 배포판 버전과 패키지 의존성을 확인하고 오류를 무시하지 마세요.