Desktop 버전은 차세대 크로스 플랫폼 UI를 사용합니다. 처음 설치하는 사용자나 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하고 싶은 사용자에게 적합합니다. 클래식 WPF 버전은 Windows용으로 설계된 익숙하고 안정적인 버전으로, 기존 창 배치와 조작 방식을 선호하는 사용자에게 적합합니다. 두 버전은 UI와 사용 방식이 다를 뿐, 구독 서비스의 품질 차이가 있는 것은 아닙니다.
다운로드 파일은 ZIP 압축 파일입니다. 다운로드한 뒤 쓰기 가능한 폴더에 압축을 완전히 풀고 설치 프로그램을 찾아 안내에 따라 설치하세요. 압축 파일 미리보기에서 바로 실행하거나 파일 하나만 꺼내고 나머지 파일을 빠뜨리지 마세요. 기존 버전이 실행 중이라면 먼저 클라이언트를 종료한 다음 설치해야 파일 점유나 프록시 설정 중복을 피할 수 있습니다.
설치가 끝나면 구독 그룹 설정을 열어 구독 주소를 추가하고 저장한 뒤 구독을 업데이트하세요. 목록에 설정이 표시되어도 시스템 트래픽이 프록시를 통과하는 것은 아닙니다. 사용할 설정을 선택하고 사용 환경에 맞게 시스템 프록시를 설정해야 합니다. TUN은 이후에 선택할 수 있습니다. 먼저 기본 연결을 확인한 뒤 가상 네트워크 어댑터 권한과 라우팅을 설정하세요.
‘설정 → 시스템 → 정보’에서 시스템 유형을 확인하세요. 이 페이지의 두 설치 파일은 모두 x64이며 32비트용이 아닙니다.
시스템 호환성
현재 설치 프로그램이 요구하는 운영체제와 런타임을 기준으로 확인하세요. 구형 운영체제는 호환성을 먼저 확인하고 파일 확장자만으로 판단하지 마세요.
파일 및 권한
압축을 풀 수 있는 폴더와 충분한 설치 공간이 필요합니다. 설치 프로그램, 시스템 프록시, TUN에 필요한 권한은 서로 다를 수 있습니다.
네트워크 설정
첫 실행 전에 구독 주소나 공유 링크 전체를 준비하세요. TUN을 켜기 전에 기존 VPN이나 가상 네트워크 어댑터와 충돌하는지 확인해야 합니다.
설치 프로그램에서 런타임이 없다는 안내가 나오면 구체적인 메시지에 따라 필요한 환경만 설치하세요. 이름만 보고 여러 구성 요소를 임의로 설치하지 마세요. 앱은 실행되지만 연결되지 않는다면 설정 단계의 문제일 가능성이 높습니다. 구독 업데이트 결과, 활성 설정, 시스템 프록시 상태부터 확인하세요.
macOS：v2rayN
‘이 Mac에 관하여’에서 칩 정보를 확인한 뒤 Apple Silicon 또는 Intel에 맞는 버전을 선택하세요.
시스템 메뉴에서 ‘이 Mac에 관하여’를 여세요. M 시리즈와 같은 Apple 칩이 표시되면 Apple Silicon용 arm64 패키지를, Intel 프로세서가 표시되면 x64 패키지를 선택하세요. 아키텍처는 기기의 칩을 기준으로 판단하며 브라우저 종류, 시스템 언어, 구독 프로토콜과는 관계가 없습니다. 두 파일은 모두 DMG 디스크 이미지이므로 둘 다 설치할 필요는 없습니다.
다운로드한 디스크 이미지를 열고 이미지 창의 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮긴 다음 해당 폴더에서 실행하세요. 마운트된 이미지에서 앱을 계속 실행하지 마세요. 설치를 마치고 앱이 정상적으로 실행되면 이미지를 추출할 수 있습니다. 업데이트할 때는 실행 중인 클라이언트를 먼저 종료하고 기존 설정을 유지한 채 앱을 교체하세요. 이전 프로세스와 새 파일이 동시에 사용되는 일을 방지할 수 있습니다.
처음 실행할 때 시스템 보안 경고가 표시되면 다운로드 경로와 파일 형식을 확인하고 시스템이 안내하는 원인을 읽어 보세요. 출처가 확인된 앱에만 필요한 권한을 부여하고, 앱 하나를 실행하기 위해 시스템 전체의 보안 기능을 끄지 마세요. 조직에서 관리하는 기기라면 설치 및 네트워크 확장 권한이 관리자에 의해 제한될 수 있으므로 기기 정책을 따르세요.
v2rayN의 시스템 프록시와 TUN은 트래픽을 처리하는 방식이 서로 다릅니다. 먼저 시스템 프록시로 브라우저 연결을 확인한 뒤 다른 앱에도 TUN을 적용할지 결정하세요. 구독 그룹, 라우팅, DNS 설정은 별도로 구성해야 합니다. 칩에 맞는 패키지를 선택하면 설치와 실행 문제는 해결할 수 있지만 연결 설정을 대신하지는 않습니다.
Apple Silicon은 arm64, Intel은 x64를 선택하세요. ‘이 Mac에 관하여’에 표시된 칩 또는 프로세서 정보를 기준으로 판단하면 됩니다.
시스템 호환성
현재 앱 패키지가 설치된 macOS 버전을 지원하는지 확인하세요. 앱이 실행되지 않으면 시스템에 표시된 오류 메시지 전체를 저장해 문제 해결에 활용하세요.
설치 위치
앱을 설치할 폴더에 쓰기 권한이 있어야 합니다. DMG가 마운트되었다고 앱 설치까지 완료된 것은 아닙니다.
프록시 권한
시스템 프록시와 TUN에는 추가 권한이 필요할 수 있습니다. 관리 대상 기기라면 조직의 네트워크 설정 요구 사항을 먼저 확인하세요.
앱은 정상적으로 실행되는데 일부 프로그램이 계속 직접 연결된다면 해당 프로그램이 시스템 프록시를 따르는지 먼저 확인하세요. 이런 트래픽 처리 방식의 차이를 칩 패키지를 잘못 선택한 문제로 오해하지 마세요. TUN, DNS, 라우팅에 관한 내용은 전체 문서의 해당 항목을 참고하세요.
Android: v2rayNG와 v2flyNG
먼저 v2rayNG를 선택하세요. V2Fly 코어와의 호환성이 필요한 경우 v2flyNG를 고려하면 됩니다.
v2rayNG는 Xray 코어를 사용하며, 이 페이지에서 우선 추천하는 Android 클라이언트입니다. 2015년 이후 출시된 주류 스마트폰은 대개 arm64 패키지를 선택할 수 있지만, 프로세서가 64비트를 지원한다고 해서 기기 시스템도 64비트 앱을 실행할 수 있는 것은 아닙니다. 일부 기기는 32비트 시스템을 사용합니다. 앱 아키텍처를 확인하기 어렵다면 범용 버전을 선택하세요. 출시 연도만으로 판단해서는 안 됩니다.
APK를 다운로드한 뒤 브라우저 다운로드 기록이나 파일 관리자에서 열어 설치하세요. 시스템에서 현재 브라우저나 파일 관리자에 앱 설치 권한을 요청할 수 있습니다. 실제로 사용하는 앱에만 권한을 부여하세요. 앱이 설치되지 않는다면 시스템 호환성, 저장 공간, 기존 버전과의 서명 충돌을 먼저 확인하세요. 기존 클라이언트 데이터를 바로 삭제하지 마세요.
처음 실행한 뒤 구독 그룹을 추가하고 전체 주소를 붙여 넣어 업데이트한 다음 사용할 설정을 선택하세요. 연결을 시작하면 시스템에서 VPN 연결 권한을 요청합니다. 이 권한은 트래픽을 처리하기 위한 것이며 구독이 유효하다는 뜻은 아닙니다. 연결 후에는 실제로 사용할 서비스를 열어 확인하세요. 상태 표시줄 아이콘만으로 연결 성공 여부를 판단할 수 없습니다.
v2flyNG는 V2Fly 코어를 사용합니다. 해당 코어의 동작 방식이 필요하거나 호환되는 설정을 이미 갖춘 사용자에게 적합합니다. v2rayNG의 다른 아키텍처 버전이 아니라 별도의 클라이언트입니다. 두 앱은 지원하는 코어 기능이 다를 수 있으며, 특정 프로토콜 확장이 포함된 설정은 호환성을 미리 확인해야 합니다. 이름이 비슷하다고 서로 바꿔 쓸 수 있는 것은 아닙니다.
arm64와 범용 버전의 선택 방법은 위와 같습니다. 클라이언트를 바꾸기 전에 기존 구독 주소와 필요한 설정을 보관하고, 새 앱을 설치한 뒤 다시 가져와 확인하세요. 두 앱을 모두 유지한다면 연결을 시작하기 전에 다른 앱의 VPN 서비스를 중지하세요. 트래픽 처리 충돌을 구독 오류로 오해할 수 있습니다. 대체 클라이언트는 실제 필요에 따라 선택하고, 시험 삼아 데이터를 반복해서 옮길 필요는 없습니다.
Debian, Ubuntu 등 deb 패키지 관리 체계를 사용하는 배포판에서는 보통 deb를 선택합니다. RPM 패키지 관리 체계를 사용하는 배포판에는 rpm을 선택하세요. 같은 패키지 형식을 사용해도 의존성과 시스템 버전이 완전히 호환되는 것은 아닙니다. 특히 RPM 패키지는 특정 배포판 계열을 대상으로 할 수 있습니다. 설치 전에 패키지 설치 프로그램의 의존성 및 호환성 안내를 확인하고 오류를 무시한 채 설치를 강행하지 마세요.
일반적인 Intel 또는 AMD 64비트 데스크톱 PC는 파일 이름에 amd64 또는 x86_64가 표시된 x64 패키지를 선택하세요. 64비트 ARM 시스템을 실행하는 기기에는 파일 이름에 arm64 또는 aarch64가 표시된 arm64 패키지를 선택하면 됩니다. 아키텍처는 프로세서 브랜드가 아니라 현재 실행 중인 시스템을 기준으로 판단하세요. 이 페이지에서 제공하는 것은 그래픽 클라이언트이므로 사용 가능한 데스크톱 세션이 필요합니다.
다운로드한 파일을 배포판의 소프트웨어 설치 프로그램으로 열고 안내에 따라 설치하세요. 추가 의존성이 필요하다는 메시지가 나오면 먼저 배포판의 패키지 저장소를 사용할 수 있는지 확인한 뒤 의존성을 처리하세요. 앱이 설치되었는데도 열리지 않는다면 시작 오류와 데스크톱 환경 정보를 보관하고 문서에 따라 문제를 해결하세요. 파일 권한만 바꿨다고 호환성 문제가 해결된 것은 아닙니다.
Linux는 데스크톱 환경에 따라 시스템 프록시를 읽는 방식이 조금씩 다릅니다. 클라이언트에서 시스템 프록시를 설정한 뒤 실제로 사용하는 앱이 해당 설정을 따르는지 확인하세요. TUN을 사용하면 더 많은 트래픽을 처리할 수 있지만 가상 네트워크 어댑터 권한, 라우팅, DNS 설정이 필요합니다. 기본 설정이 작동하는지 확인한 뒤 활성화하고 기존 네트워크 관리 도구 설정도 살펴보세요.
배포판에 따라 deb 또는 rpm을 선택하세요. 패키지 형식뿐 아니라 필요한 시스템 버전과 의존성도 확인해야 합니다.
프로세서 아키텍처
x64는 amd64 또는 x86_64, arm64는 aarch64에 해당합니다. 패키지와 실행 중인 시스템의 아키텍처가 일치해야 합니다.
데스크톱 환경
그래픽 앱을 실행할 수 있는 데스크톱 세션과 설치 프로그램이 요구하는 런타임 라이브러리가 필요합니다.
설치 및 네트워크 권한
시스템 패키지 설치에는 보통 관리자 권한이 필요합니다. TUN을 사용하려면 가상 네트워크 어댑터와 네트워크 설정에 필요한 권한도 갖춰야 합니다.
먼저 설치를 완료하고 기본 화면을 연 뒤 구독을 가져오세요. 의존성이 해결되지 않았다면 설치 문제부터 해결해야 합니다. DNS, 라우팅, 구독 설정을 동시에 바꾸면 원인을 파악하기 어려워집니다.
설치 후 진행 순서
구독 가져오기 및 연결 확인
설치 완료는 준비 단계일 뿐입니다. 먼저 설정이 작동하는지 확인한 다음 트래픽 처리 방식을 조정하세요.
연결 설정 준비
클라이언트는 설정을 관리하고 연결을 시작하는 도구이며, 설치 파일에는 바로 사용할 수 있는 구독이 포함되어 있지 않습니다. 서비스 제공업체에서 받은, 사용 권한이 있는 구독 주소나 공유 링크를 준비하세요. 구독 주소에는 개인 접속 인증 정보가 포함될 수 있습니다. 복사할 때 전체 매개변수를 유지하고 공개적으로 공유하거나 스크린샷에 전체 주소를 노출하지 마세요.
구독 링크와 단일 공유 링크는 가져오기 메뉴가 다를 수 있습니다. 데스크톱에서는 보통 구독 그룹 설정에서 구독을 관리하고, Android에서는 구독 그룹 관련 메뉴에서 추가합니다. 단일 공유 링크는 해당 클립보드 가져오기나 스캔 메뉴를 이용하세요. 가져온 뒤 업데이트를 실행하고 현재 클라이언트 코어가 해당 설정 형식을 지원하는지 확인하세요.
활성 설정을 선택한 뒤 데스크톱에서는 먼저 시스템 프록시를 켜고, Android에서는 연결을 시작해 VPN 권한을 허용하세요. 실제로 사용할 서비스를 열어 요청이 정상적으로 이루어지는지 확인하세요. 앱이 실행 중으로 표시되는 것만으로 대상 앱의 트래픽이 선택한 설정을 사용한다고 볼 수는 없습니다.
일부 데스크톱 프로그램이 시스템 프록시를 사용하지 않는다면 TUN을 고려하세요. 활성화 전에 기존 네트워크 설정을 기록하고 권한, 라우팅, DNS 요구 사항을 확인하세요. 테스트할 때는 한 번에 설정 하나만 변경하세요. 문제가 생기면 방금 켠 기능을 끄고 기본 연결이 복구되는지 확인한 뒤 원인을 더 살펴보세요.
클라이언트를 업데이트하기 전에 현재 앱의 백업 또는 내보내기 기능을 확인하고 구독 그룹, 라우팅 규칙, DNS, 사용자 설정을 저장하세요. UI 버전이나 클라이언트가 다르면 설정 파일을 모두 그대로 가져올 수 있는 것은 아닙니다. 마이그레이션할 때는 앱에서 지원하는 가져오기 방법을 따르세요. 디렉터리 전체를 복사한다고 모든 설정이 적용되는 것은 아닙니다.
현재 패키지 형식과 설치 위치를 기록하고 실행 중인 클라이언트를 종료한 뒤 TUN을 끄고 업데이트하세요. 완료 후 구독 그룹이 유지되었는지 확인하고 구독을 업데이트한 다음 활성 설정을 점검하세요. 백업에는 서비스 주소와 접속 인증 정보가 들어 있을 수 있으므로 안전한 곳에 보관하세요. 다른 사람에게 도움을 요청할 때는 민감한 정보를 가린 오류 메시지와 필요한 환경 정보만 공유하세요.
v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 클라이언트 생태계에 속합니다. Project V, V2Fly, Xray는 관련 기술을 이해하는 데 중요한 배경이지만, 클라이언트 이름과 코어 이름, 구독 서비스는 서로 다른 개념입니다. 설치 파일을 고를 때는 운영체제와 아키텍처를 확인하고, 연결할 때는 프로토콜과 설정, 네트워크 환경을 확인하세요. 두 종류의 문제를 나누어 살펴보면 원인을 더 쉽게 찾을 수 있습니다.
Desktop 버전은 차세대 크로스 플랫폼 UI를 사용하고, 클래식 WPF 버전은 Windows에 맞춘 익숙하고 안정적인 UI를 사용합니다. 처음 설치한다면 Desktop 버전을, 기존 창 배치와 조작 방식에 익숙하다면 WPF 버전을 선택하세요. 두 설치 파일 모두 x64이므로 설치 전에 시스템 유형을 확인해야 합니다.
macOS와 Android에서 arm64 패키지는 어떻게 고르나요?
macOS에서는 ‘이 Mac에 관하여’에서 칩을 확인하세요. Apple Silicon은 arm64, Intel은 x64를 선택하면 됩니다. Android는 기기 사양에서 운영체제가 지원하는 앱 아키텍처를 확인하세요. 2015년 이후 출시된 주류 스마트폰은 대개 arm64를 선택할 수 있지만, 일부 기기는 여전히 32비트 시스템을 사용합니다. 확인하기 어렵다면 범용 버전을 선택하세요.
다운로드했는데도 구독이나 연결 설정이 필요한 이유는 무엇인가요?
클라이언트는 설정 관리와 연결 기능을 제공하며, 설치 파일에는 바로 사용할 수 있는 서비스 구독이 포함되어 있지 않습니다. 사용 권한이 있는 구독 주소나 공유 링크를 준비해 가져온 다음 구독을 업데이트하세요. 이후 사용할 설정을 선택하고 시스템 프록시나 연결 모드를 지정해야 합니다.
설치할 수 없거나 앱이 열리지 않을 때 먼저 확인할 사항은 무엇인가요?
운영체제, CPU 아키텍처, 패키지 형식이 서로 맞는지 먼저 확인한 뒤 운영체제나 설치 프로그램의 전체 오류 메시지를 살펴보세요. Windows ZIP 파일은 먼저 압축을 완전히 풀어야 합니다. Android는 설치 권한을, Linux는 의존성과 배포판 호환성을 확인하세요. 설치 단계의 문제를 해결하려고 구독을 계속 바꾸지는 마세요.
클라이언트를 업데이트하기 전에 어떤 설정을 백업해야 하나요?
먼저 클라이언트의 백업 또는 내보내기 기능으로 구독 그룹, 라우팅, DNS 등의 설정을 저장하고 현재 사용 중인 패키지 형식을 기록하세요. 클라이언트를 종료하고 TUN을 끈 뒤 업데이트하세요. 백업 파일에는 구독 인증 정보가 들어 있을 수 있으므로 안전한 곳에 보관하고 공개하지 마세요.
다운로드 버튼을 눌렀는데 다운로드가 완료되지 않으면 어떻게 하나요?
브라우저의 다운로드 기록에서 연결 실패, 다운로드 차단, 파일 저장 여부를 먼저 확인하세요. 기기의 남은 저장 공간과 네트워크 상태를 확인한 뒤 다시 시도하세요. 조직 네트워크 정책으로 제한된 경우 관리자에게 문의해야 합니다. 다운로드 실패와 구독 업데이트 실패는 서로 다른 단계의 문제이므로 각각 확인하세요.