Desktop은 차세대 크로스 플랫폼 UI이고, WPF는 안정적인 클래식 버전입니다. v2rayN을 처음 사용한다면 Desktop부터 시작할 수 있습니다. WPF 인터페이스에 익숙하다면 클래식 버전을 계속 사용해도 됩니다. UI와 프록시 프로토콜은 별개이므로 인터페이스 이름만으로 특정 프로토콜의 지원 여부를 판단할 수 없습니다.
두 다운로드 모두 x64 압축 파일입니다. 다운로드가 끝나면 파일을 로컬 폴더에 완전히 압축 해제한 뒤 안에 있는 설치 프로그램을 실행하세요. 압축 파일 미리보기에서 바로 실행하지 마세요. 설치 프로그램에서 실행 환경이 없다고 안내하면 해당 릴리스의 안내를 따르고, 출처가 불분명한 곳에서 같은 이름의 구성 요소를 내려받지 마세요.
UI 버전을 바꾸기 전에 설정을 내보내고 실행 중인 기존 인스턴스를 종료하세요. 두 프로그램이 같은 포트를 동시에 사용하면 충돌할 수 있습니다. 알림 영역에 아이콘이 남아 있다면 기존 클라이언트가 완전히 종료됐는지 확인하세요.
시스템 메뉴에서 ‘이 Mac에 관하여’를 열고 칩 또는 프로세서 항목을 확인하세요. Apple 칩으로 표시되면 Apple Silicon을, Intel 프로세서로 표시되면 Intel 버전을 선택하세요. 컴퓨터를 구매한 연도나 외관만 보고 설치 파일을 선택하지 마세요. 세대에 따라 아키텍처가 다를 수 있습니다.
DMG를 다운로드한 뒤 열고 앱을 ‘응용 프로그램’ 폴더로 복사하세요. 그런 다음 해당 폴더에서 앱을 실행합니다. 처음 실행할 때 보안 알림이 표시되면 다운로드가 완료됐는지, 아키텍처가 맞는지 확인한 뒤 ‘개인정보 보호 및 보안’에서 해당 앱에 표시된 안내를 따르세요. 앱 하나를 실행하기 위해 Mac 전체의 보안 기능을 끌 필요는 없습니다.
클라이언트를 실행한 후에도 서버 설정을 가져와야 합니다. 시스템 프록시는 해당 설정을 따르는 앱에만 적용됩니다. 브라우저에서는 연결되는데 특정 프로그램은 계속 직접 연결된다면 설치 파일 문제가 아닐 수 있습니다. 해당 프로그램의 프록시 동작과 클라이언트 라우팅 설정을 확인하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 기기의 운영체제가 해당 아키텍처를 지원하는지 확인하세요. 일부 기기는 프로세서와 운영체제의 비트 수가 서로 다릅니다. 확인하기 어렵다면 여러 아키텍처 구성 요소가 포함된 범용 버전을 선택할 수 있습니다. 설치 파일 크기는 보통 더 큽니다.
v2rayNG는 Xray 코어를 사용하며, 해당 프로토콜 및 전송 기능이 필요한 설정에 적합합니다. 처음 연결을 시작하면 시스템에서 VPN 연결 권한을 요청합니다. 이 권한은 로컬 트래픽을 처리하는 통로를 만드는 데 사용되며, 원격 서버 설정이 자동으로 제공된다는 뜻은 아닙니다.
APK를 설치할 때는 실제로 사용하는 브라우저나 파일 관리자에만 필요한 앱 설치 권한을 허용하세요. 설치가 끝나면 시스템 설정에서 해당 권한을 해제할 수 있습니다. 다른 VPN 앱이 실행 중이라면 연결 충돌을 먼저 해결한 뒤 클라이언트를 시작하세요.
V2Fly 설정과의 호환성이 필요하다면 이 대안 클라이언트를 선택하세요. v2flyNG와 v2rayNG는 서로 다른 코어를 사용하므로 이름이 비슷하다고 설정 항목이 모두 호환되는 것은 아닙니다. 가져오기 전에 설정에 사용된 프로토콜, 전송 계층, 보안 옵션을 확인하세요.
아키텍처 선택 방법은 위와 같습니다. 기기가 지원한다면 arm64를 선택하고, 확인하기 어렵다면 범용 버전을 고려하세요. 범용 패키지는 지원하는 CPU 아키텍처가 더 많을 뿐, 코어에 없는 프로토콜 기능을 추가하거나 운영체제 버전 요구 사항을 우회하지는 않습니다.
다른 클라이언트에서 이전할 때는 호환되는 공유 링크나 구독을 사용해 설정을 다시 가져온 뒤 라우팅과 DNS 옵션을 하나씩 복원하세요. 앱 내부 데이터 폴더는 서로 다른 클라이언트 간에 그대로 옮기는 용도로 적합하지 않습니다.
Android 시스템 확인
확인 항목
설치 파일 및 실행 요구 사항
프로세서 및 운영체제
arm64 패키지를 사용하려면 운영체제가 해당 아키텍처를 지원해야 합니다. 기기를 잘 모른다면 범용 패키지를 선택하기 전에 운영체제 호환성도 확인하세요.
운영체제 버전
APK 설치 프로그램과 현재 릴리스의 요구 사항을 확인하세요. 클라이언트마다 최소 요구 사항이 다를 수 있습니다.
설치 권한
실제로 다운로드에 사용한 앱에만 앱 설치를 허용하고, 기존 앱의 서명 충돌과 여유 저장 공간을 확인하세요.
연결 권한
시작할 때 시스템 VPN 권한을 허용하고 다른 VPN 앱이 동시에 연결을 제어하지 않도록 하세요.
백그라운드 실행
화면이 잠긴 뒤 연결이 끊기면 설치 파일을 계속 바꾸기보다 배터리 최적화, 백그라운드 제한, 클라이언트 로그를 확인하세요.
카드에 표시된 릴리스 버전과 설치 파일 이름은 서로 다른 목록 항목에서 가져왔을 수 있습니다. 파일명만 보고 현재 설치된 버전을 판단하지 마세요. 설치 후 앱 정보에서 버전을 확인할 수 있습니다.
먼저 배포판에 맞는 패키지 형식을 고른 다음 CPU 아키텍처를 확인하세요. Debian·Ubuntu 계열은 보통 deb, Fedora·RHEL 계열은 rpm을 선택합니다. x64는 일반적으로 amd64 또는 x86_64, arm64는 aarch64로 표시되며 서로 바꿔 사용할 수 없습니다.
다운로드한 파일을 배포판의 소프트웨어 설치 프로그램으로 열고 의존성 안내를 확인한 뒤 설치를 진행하세요. 같은 패키지 형식이라도 모든 배포판 버전에서 호환되는 것은 아닙니다. 특히 시스템 라이브러리와 데스크톱 실행 환경 요구 사항을 확인하세요. 의존성이 충족되지 않는다는 안내가 나오면 의존성 검사를 강제로 무시해 문제를 감추지 마세요.
v2rayN은 데스크톱 세션이 필요한 GUI 클라이언트입니다. 설치 후 앱 메뉴에서 실행하고 설정 폴더에 쓰기 권한이 있는지, 로그가 정상인지 확인하세요. 시스템 프록시를 따르는지는 데스크톱 환경과 앱 구현에 따라 다릅니다. TUN 사용에는 권한과 네트워크 라우팅 설정도 필요합니다.
클라이언트는 설정을 관리하고 로컬 프록시 서비스를 실행합니다. 서버 설정은 연결 대상, 사용할 프로토콜, 인증 방식을 결정합니다. 설치를 마쳐도 로컬 프로그램만 준비된 것이며 구독이나 서버 계정이 제공되는 것은 아닙니다. 직접 확보했고 사용 권한이 있는 설정을 사용하고, 선택한 코어가 설정의 프로토콜·전송 방식·보안 옵션을 지원하는지 확인하세요.
Project V는 관련 프록시 도구의 기술 생태계이며, V2Fly와 Xray는 서로 다른 코어 계열입니다. v2rayN은 데스크톱 GUI 관리 기능을 제공하고, Android용 v2rayNG와 v2flyNG는 각각 해당 코어를 사용합니다. GUI와 코어의 역할은 다릅니다. GUI는 설정 관리와 조작 기능을 담당하고, 코어는 프로토콜과 트래픽 처리를 담당합니다. 클라이언트를 바꾸거나 업그레이드할 때는 이름만 비교하지 말고 설정 호환성도 함께 확인해야 합니다.
첫 설치: 설정을 가져온 다음 프록시 방식 선택
구독 링크나 개별 서버 공유 링크를 준비한 뒤 클라이언트에서 해당 가져오기 기능을 사용하세요. 구독은 여러 설정을 그룹별로 관리할 때, 개별 링크는 특정 서버를 가져올 때 적합합니다. 가져온 후 서버 주소, 포트, 프로토콜을 확인하고 사용할 설정을 선택하세요. 가져온 항목이 없다면 시스템 네트워크 설정을 바로 바꾸지 말고 링크 내용과 형식을 먼저 확인하세요.
데스크톱에서 흔히 쓰는 시스템 프록시 모드는 시스템 프록시 설정을 변경하지만, 해당 설정을 따르는 앱만 프록시를 사용합니다. TUN은 가상 네트워크 인터페이스로 조건에 맞는 트래픽을 처리하며 권한, 라우팅, DNS 설정도 영향을 줍니다. 처음 설정할 때는 트래픽 제어 방식을 하나만 켜고 정상 동작을 확인한 뒤 조정하세요. 여러 조건을 한꺼번에 바꾸면 문제 원인을 찾기 어렵습니다.
Android에서 처음 연결을 시작하면 시스템 VPN 권한 요청이 표시됩니다. 권한을 허용한 뒤 클라이언트가 정상적으로 시작됐는지, 올바른 서버를 선택했는지, 로그에 연결 또는 DNS 오류가 기록됐는지 확인하세요. 상태 아이콘은 로컬 서비스의 상태만 나타낼 수 있으며, 모든 앱의 원격 연결이 성공했다는 뜻은 아닙니다.
입문 가이드에서 설정 가져오기, 사용할 설정 선택, 프록시 모드, 로그 확인 순서로 살펴볼 수 있습니다. 설정 항목의 의미를 자세히 알아보려면 V2Ray JSON 설정 매뉴얼을 참고하세요. 먼저 최소한의 설정으로 연결한 다음 복잡한 분기 규칙을 추가하면 각 설정의 영향을 파악하기 쉽습니다.
기존 설정이 있다면 먼저 백업한 뒤 업데이트
업데이트 전에 서버 설정을 내보내고 구독 그룹, 로컬 포트, 라우팅 규칙, DNS 및 사용자 지정 매개변수를 기록하세요. 내보낸 파일과 구독 주소에는 인증 정보가 포함될 수 있으므로 직접 관리하는 위치에 보관하고, 문제 화면을 공유할 때는 관련 항목을 가리세요. 백업은 설정을 복원하기 위한 것이며 인증 정보가 담긴 파일을 공개 문제 첨부 파일로 올려서는 안 됩니다.
백그라운드 프로세스가 이전 파일을 사용하지 않도록 클라이언트를 종료한 뒤 업데이트를 설치하세요. 설치 후 서버 목록과 선택 상태를 확인하고 로컬 서비스를 시작해 로그를 살펴보세요. 다른 클라이언트로 옮길 때는 지원되는 링크나 내보내기 형식으로 설정을 다시 가져오는 것이 좋습니다. 데이터 폴더 전체를 다른 앱에 그대로 덮어쓰지 마세요.
업데이트 후 연결에 문제가 생기면 오류가 발생한 단계를 기록하세요. 앱 실행 실패, 코어 시작 실패, 구독 다운로드 실패, 도메인 이름 조회 실패, 서버 연결 실패는 각각 확인할 대상이 다릅니다. 반복해서 재설치하면 유용한 문제 상황 정보가 사라질 수 있으며, 원격 설정이 만료됐거나 로컬 포트가 충돌하는 문제도 해결되지 않습니다.
다운로드 또는 설치 실패: 단계별 문제 해결
브라우저에서 다운로드가 완료되지 않았다면 먼저 다운로드 기록의 실패 원인과 기기의 여유 공간을 확인하세요. 파일이 완전히 저장되기 전에 열면 파싱 오류나 형식 오류가 발생할 수 있습니다. 파일을 다운로드했는데 설치 프로그램이 실행을 거부한다면 CPU 아키텍처, 운영체제 버전, 설치 권한, 기존 앱의 서명을 확인하세요. 모든 실패를 네트워크 문제로 단정하지 마세요.
설치가 끝났는데 앱이 시작되지 않으면 시스템 안내와 클라이언트 로그를 확인하고 실행 환경, 파일 접근 권한, 설정 폴더의 쓰기 권한을 점검하세요. 앱은 실행되지만 연결되지 않는다면 서버 설정, 시스템 시간, 도메인 이름 조회, 로컬 리스닝 포트를 확인하세요. 다운로드, 설치, 실행, 연결 문제를 구분해 살펴보면 관련 없는 설정을 바꾸는 일을 줄일 수 있습니다.
다운로드 관련 문제
설치 파일 선택 및 업데이트 FAQ
먼저 운영체제와 아키텍처를 확인한 뒤 권한, 의존성, 설정 이전을 점검하세요.
Windows에서는 Desktop과 WPF 중 무엇을 선택해야 하나요?
처음 설치한다면 차세대 크로스 플랫폼 UI를 적용한 Desktop을 선택할 수 있습니다. WPF는 기존 Windows 인터페이스에 익숙한 사용자를 위한 안정적인 클래식 버전입니다. 둘 다 v2rayN이며, UI 선택에 따라 서버 프로토콜이 달라지지는 않습니다. 이전하기 전에 설정을 내보내고, 두 인스턴스가 같은 로컬 포트를 동시에 사용하지 않도록 하세요.
Android arm64와 범용 버전은 어떻게 다른가요?
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 다만 프로세서와 운영체제가 모두 해당 아키텍처를 지원하는지 확인하세요. 아키텍처를 확인하기 어렵다면 여러 아키텍처 구성 요소가 포함된 범용 버전을 선택할 수 있지만, 설치 파일 크기가 더 클 수 있습니다. 압축 해제나 설치에 실패하면 운영체제 버전, 저장 공간, 기존 앱의 서명도 확인하세요.
클라이언트를 다운로드하면 서버 설정도 자동으로 제공되나요?
클라이언트 설치 파일에는 바로 사용할 수 있는 서버 계정이나 구독이 포함되어 있지 않습니다. 설치 후 직접 확보했고 사용 권한이 있는 서버 설정이나 구독 링크를 가져와야 합니다. 그런 다음 서버를 선택하고 프록시 방식을 설정한 뒤 연결 로그를 확인하세요. 구독 주소에는 접속 인증 정보가 포함될 수 있으므로 공개하지 마세요.
macOS에서 앱을 열 수 없다는 메시지가 표시되면 어떻게 하나요?
먼저 ‘이 Mac에 관하여’에서 칩 종류를 확인하고 다운로드가 완료됐는지 점검하세요. DMG를 연 다음 앱을 ‘응용 프로그램’ 폴더로 복사하고, 시스템 설정의 ‘개인정보 보호 및 보안’에 표시된 해당 앱 관련 안내를 따르세요. Mac 전체의 보안 기능을 끄지 마세요. 앱이 손상됐거나 아키텍처가 맞지 않는다는 알림이 나오면 설치 파일과 시스템의 호환성을 다시 확인하세요.
Linux에서는 deb와 rpm 중 무엇을 다운로드해야 하나요?
배포판의 패키지 관리 방식에 맞춰 선택하세요. Debian·Ubuntu 계열은 보통 deb, Fedora·RHEL 계열은 rpm을 사용합니다. x64와 arm64도 구분해야 합니다. 패키지 형식이 맞더라도 시스템 의존성이 충족된다는 뜻은 아니므로, 설치 프로그램이 안내하는 의존성 및 시스템 라이브러리 요구 사항을 확인하세요.
클라이언트를 업데이트하기 전에 무엇을 보관해야 하나요?
먼저 서버 설정을 내보내고 구독 그룹, 라우팅 규칙, 로컬 리스닝 포트, 사용자 지정 설정을 기록하세요. 클라이언트를 종료한 뒤 업데이트를 설치합니다. UI 버전이나 클라이언트가 다르면 설정 폴더를 그대로 덮어쓰지 마세요. 업데이트 후 서버 목록과 로그를 확인하고 시스템 프록시나 TUN을 다시 설정하세요. 백업 파일은 민감한 정보로 취급해야 합니다.