데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 선택하세요. 운영체제를 확인한 다음 CPU 아키텍처와 설치 형식을 선택하면 됩니다.
설치 링크는 운영체제별로 나뉘며, 버전 정보는 각 클라이언트 카드에서 확인할 수 있습니다.
Desktop 버전은 최신 크로스 플랫폼 UI를 적용해 처음 설치하는 사용자에게 적합합니다. 클래식 WPF 버전은 익숙한 Windows 인터페이스를 유지해 기존 작업 흐름을 이어가려는 사용자에게 안정적인 선택입니다.
쓰기 가능한 폴더에 압축을 완전히 푼 다음, 폴더 안의 설치 프로그램을 실행하세요. 압축 프로그램의 미리보기에서 바로 실행하거나 프로그램 파일 하나만 꺼내 실행하지 마세요.
| 확인 항목 | 요구 사항 및 확인 방법 | 설치 후 확인 |
|---|---|---|
| 운영체제 및 아키텍처 | x64 Windows용입니다. 최소 Windows 버전은 선택한 릴리스 패키지 안내를 확인하세요. | 기본 창이 정상적으로 열리고 로그에 실행 환경 오류가 없는지 확인하세요. |
| 폴더 및 실행 환경 | 쓰기 가능한 폴더를 사용하세요. 설치 프로그램에서 실행 구성 요소가 없다고 안내하면 해당 구성 요소를 설치하세요. | 설정이 저장되는지 확인하고, 임시 압축 해제 폴더에서 계속 실행하지 마세요. |
| 프록시 및 권한 | 일반 시스템 프록시와 TUN은 필요한 권한이 다릅니다. TUN을 활성화하기 전에 관리자 권한을 확인하세요. | 먼저 시스템 프록시로 연결을 확인한 뒤 필요에 따라 TUN을 사용하세요. |
Apple 칩이 탑재된 기기는 Apple Silicon 패키지를, Intel 프로세서 기기는 Intel 패키지를 선택하세요. Apple 메뉴의 ‘이 Mac에 관하여’에서 ‘칩’ 또는 ‘프로세서’를 확인하세요. 컴퓨터를 구매한 연도만으로 추측하지 마세요.
DMG를 연 다음 앱을 ‘응용 프로그램’ 폴더로 옮겨 실행하세요. 설치를 마치면 디스크 이미지를 추출해 마운트된 설치 이미지에서 계속 실행하지 않도록 하세요.
| 확인 항목 | 요구 사항 및 확인 방법 | 설치 후 확인 |
|---|---|---|
| 칩 및 운영체제 | Apple Silicon은 arm64, Intel은 x64를 사용합니다. 최소 운영체제 버전은 릴리스 패키지 안내를 확인하세요. | ‘이 Mac에 관하여’에서 칩을 확인하고 앱이 실행되는지 확인하세요. |
| 앱 폴더 | 앱을 ‘응용 프로그램’ 폴더에 넣고 현재 사용자가 클라이언트 설정을 저장할 수 있는지 확인하세요. | DMG를 추출한 뒤 앱을 다시 실행해 설치 위치가 올바른지 확인하세요. |
| 네트워크 권한 | 시스템 안내에 따라 필요한 권한을 허용하세요. TUN에는 추가 권한이 필요할 수 있습니다. | 시스템 프록시 상태, 선택한 모드, 연결 로그를 각각 확인하세요. |
Android에서는 v2rayNG를 우선 선택하세요. 구독 가져오기, 설정 공유, 라우팅을 지원하며 처음 연결할 때 시스템 VPN 요청을 승인해야 합니다.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 사용합니다. 다만 기기에서 지원하는 앱 아키텍처를 확인하세요. 아키텍처를 확인하기 어렵거나 호환되지 않는다는 안내가 나올 때 universal 버전을 시도하세요.
V2Fly 코어와의 호환성이 필요한 설정에 적합합니다. 선택하기 전에 서버 측 프로토콜과 전송 옵션을 확인하세요. 코어가 다르면 지원 기능도 모두 같다고 볼 수 없습니다.
가져오기 전에 프로토콜, 전송 방식, 보안 설정을 대상 클라이언트가 인식할 수 있는지 확인하세요. 공유 링크를 읽어 들였다고 해서 모든 옵션이 기존 클라이언트와 똑같이 작동하는 것은 아닙니다.
| 확인 항목 | 요구 사항 및 확인 방법 | 설치 후 확인 |
|---|---|---|
| 운영체제 및 아키텍처 | 선택한 클라이언트의 현재 릴리스 패키지에 필요한 최소 시스템 버전을 충족해야 합니다. arm64 지원 여부를 먼저 확인하세요. | 설치가 호환되지 않으면 아키텍처와 시스템 버전을 먼저 확인하고, 같은 패키지를 반복해서 덮어쓰지 마세요. |
| 설치 권한 | 필요한 경우 현재 브라우저나 파일 관리자에 앱 설치를 허용하세요. 설치가 끝나면 해당 권한을 해제할 수 있습니다. | 처음 실행할 때 앱 이름을 확인한 다음 기존 설정을 가져오세요. |
| VPN 및 백그라운드 | 연결하려면 시스템 VPN 권한이 필요합니다. 계속 사용하려면 기기 설정에 따라 배터리 및 백그라운드 제한을 조정하세요. | 다른 VPN 서비스가 동시에 연결을 사용하지 않도록 하고, 연결이 끊길 때 로그를 확인하세요. |
APK가 설치된다는 것은 시스템에서 해당 앱 패키지를 받아들였다는 뜻일 뿐입니다. 실제로 연결하려면 유효한 설정을 가져오고 사용할 항목을 선택한 뒤 VPN 요청을 승인해야 합니다. 휴대전화에서 다른 VPN 앱을 사용 중이라면 기존 연결을 끊고 현재 클라이언트를 실행하세요. 시스템 차원의 연결 충돌을 구독 오류로 오해하지 않도록 주의하세요.
universal 버전은 여러 아키텍처 구성 요소를 포함해 용량이 더 클 수 있지만, 그 때문에 지원 프로토콜이 늘어나는 것은 아닙니다. 화면을 잠근 뒤 연결이 끊긴다면 배터리 최적화, 자동 시작, 백그라운드 실행 제한을 확인하세요. 기본 연결이 되기도 전에 시스템 설정을 한꺼번에 많이 바꾸지 마세요.
Debian, Ubuntu 및 호환 배포판에는 deb를, Fedora, RHEL 계열 및 호환 배포판에는 rpm을 선택하세요. 아래 두 가지 주요 다운로드는 x64 데스크톱용입니다.
같은 rpm 또는 deb 계열이라고 해서 모든 배포판의 의존성이 같은 것은 아닙니다. 패키지 관리자가 표시하는 누락 항목을 확인하고, 의존성을 무시한 채 설치를 강행하지 마세요.
| 확인 항목 | 요구 사항 및 확인 방법 | 설치 후 확인 |
|---|---|---|
| 배포판 및 아키텍처 | deb와 rpm은 배포판에, x64와 arm64는 CPU에 맞춰 선택하세요. 구체적인 호환 범위는 릴리스 패키지 안내를 확인하세요. | 패키지 관리자로 설치 결과를 확인하고 서로 다른 아키텍처의 패키지를 함께 설치하지 마세요. |
| 데스크톱 환경 및 의존성 | 그래픽 앱을 실행할 수 있는 데스크톱 환경과 릴리스 패키지에 필요한 라이브러리가 있어야 합니다. | 앱이 실행되고 현재 사용자의 설정 폴더에 쓸 수 있는지 확인하세요. |
| 네트워크 및 권한 | 시스템 프록시는 데스크톱 환경과 앱의 지원 여부에 따라 다릅니다. TUN에는 적절한 네트워크 권한이 필요합니다. | 일반 프록시 모드로 먼저 연결을 확인하고, 라우팅을 점검한 뒤 트래픽 처리 범위를 조정하세요. |
패키지 설치, 설정 가져오기, 연결 구성은 서로 다른 확인 단계입니다. 순서대로 살펴보면 클라이언트를 반복해서 바꾸는 것보다 원인을 찾기 쉽습니다.
기존 클라이언트가 있다면 구독 주소, 그룹, 라우팅 프리셋, DNS, 로컬 수신 포트를 먼저 기록하세요. 구독으로 복구할 수 없는 수동 설정은 클라이언트에서 지원하는 방법으로 별도 내보내야 합니다. 백업 파일에 접속 정보가 들어 있을 수 있으므로 공개 게시판에 올리지 마세요.
업데이트하거나 인터페이스 버전을 바꾸기 전에 기존 프로그램을 정상 종료하세요. 사용할 수 있는 설정을 하나 보관해 두면 새 버전 실행에 문제가 생겼을 때 설치 문제와 설정 문제를 구분하는 데 도움이 됩니다. 데이터 폴더를 바로 삭제하면 문제를 비교할 기준이 사라집니다.
클라이언트 자체에는 서버 연결 설정이 없습니다. 유효한 구독 URL을 가져온 다음 구독을 업데이트하고, 항목이 인식되었는지 확인한 뒤 사용할 설정을 선택하세요. 그룹 이름만 있고 내용이 없다면 먼저 구독을 제대로 읽어 왔는지 확인해야 합니다.
서로 다른 클라이언트에서 호환되는 구독 내용을 함께 사용할 수는 있지만, 라우팅·DNS·인터페이스 설정과 앱 데이터 폴더를 그대로 덮어쓰는 것은 적절하지 않습니다. 호환되는 공유 형식에서 이전을 시작하고 클라이언트 설정은 항목별로 다시 구성하세요.
데스크톱에서 시스템 프록시를 켜면 해당 설정을 따르는 앱에만 영향을 줍니다. TUN은 가상 네트워크 인터페이스를 통해 적용 조건에 맞는 트래픽을 처리하며, 라우팅 규칙도 함께 필요합니다. 둘은 같은 기능이 아니며 TUN을 켜도 모든 트래픽이 프록시를 통해 나가는 것은 아닙니다.
처음 연결을 확인할 때는 간단한 라우팅을 유지하고 기본 접속을 확인한 다음 DNS, 분할 라우팅, 백그라운드 정책을 조정하세요. Android에서는 VPN 요청을 먼저 승인하고, 데스크톱에서는 로그와 로컬 포트를 확인해 실행 중인 클라이언트끼리 충돌하지 않도록 하세요.
v2rayN, v2rayNG, v2flyNG는 모두 무료 오픈 소스 GUI 클라이언트입니다. 클라이언트는 설정 관리, 구독 업데이트, 연결 제어 인터페이스를 제공하고 코어는 프록시 프로토콜, 전송, 라우팅을 실제로 처리합니다. 서로 연관되어 있지만 소프트웨어에서 담당하는 계층은 다릅니다.
Project V는 V2Ray 생태계를 이해하는 출발점이며, V2Fly와 Xray는 관련 코어 계열입니다. 코어마다 지원하는 프로토콜, 전송 방식, 보안 옵션은 버전에 따라 달라질 수 있습니다. 특정 링크를 가져올 수 있다는 이유만으로 모든 기능이 같다고 판단하지 마세요.
데스크톱에서는 v2rayN을 먼저 선택하세요. Android에서는 일반적으로 Xray를 사용하는 v2rayNG를 추천하며, V2Fly 호환성이 꼭 필요할 때 v2flyNG를 고려하세요. 최종 선택 전 서버 요구 사항과 클라이언트의 실제 지원 기능을 확인하세요. 이름의 길이나 설치 파일 용량만으로 연결 성능을 판단해서는 안 됩니다.
업데이트 전 앱에 표시된 버전 및 변경 사항을 확인한 뒤 일상 설정을 이전할지 결정하세요. 소프트웨어 업데이트가 서버 접속 불가 문제를 자동으로 해결하거나 구독 만료일을 바꾸지는 않습니다. 프로토콜 이름을 이해하려면 먼저 용어를 확인하고 실제 설정의 항목을 살펴보세요.
프로토콜·코어·라우팅 용어 알아보기 →패키지 선택, 설치 권한, 설정 복구 중 문제가 발생한 단계를 먼저 확인하세요.
처음 설치한다면 새로운 크로스 플랫폼 인터페이스를 적용한 Desktop 버전부터 사용해 보세요. 클래식 인터페이스와 기존 사용 흐름을 선호한다면 안정적인 WPF 버전을 선택할 수 있습니다. 두 버전 모두 x64 시스템이 필요합니다. 버전을 바꾸기 전 구독 그룹, 라우팅 규칙, 사용자 설정을 백업하고 기존 클라이언트를 종료한 뒤 새 버전을 실행하세요. 로컬 포트 충돌을 방지할 수 있습니다.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택하면 됩니다. 다만 기기에서 지원하는 앱 아키텍처를 확인하는 것이 가장 정확합니다. 기기와 호환되지 않는다는 안내가 나오거나 아키텍처를 확인하기 어렵다면 universal 버전을 선택하세요. universal 버전은 여러 아키텍처 구성 요소를 포함해 용량이 더 클 수 있지만, 연결 성능이 더 뛰어나다는 뜻은 아닙니다. 구형 기기는 클라이언트의 최소 시스템 요구 사항도 확인해야 합니다.
클라이언트는 설정을 읽어 연결을 구성하지만, 사용할 수 있는 서버 설정을 제공하지는 않습니다. 설치 후 기존의 유효한 구독 URL이나 공유 링크를 가져오거나 직접 설정하고, 구독을 업데이트한 다음 사용할 항목을 선택하세요. 이후 시스템 프록시를 설정하거나 Android VPN 연결을 승인해야 합니다. 기본 라우팅으로 먼저 연결을 확인하고 라우팅 분할과 DNS를 하나씩 조정하면 변경 원인을 파악하기 쉽습니다.
구독 주소, 그룹 정보, 사용자 지정 라우팅 규칙, DNS 설정, 로컬 수신 포트 기록은 반드시 보관하세요. 구독에서 복구할 수 없는 수동 설정도 별도로 내보내야 합니다. 설정 백업에는 접속 정보가 포함될 수 있으므로 안전한 장소에 보관하세요. 업데이트 전에 클라이언트를 종료하고, 업데이트 후 가져온 설정과 프록시 모드, 로그를 확인하세요. 서로 다른 클라이언트의 데이터 폴더 전체를 그대로 덮어쓰지 마세요.
먼저 설치 파일이 운영체제와 CPU 아키텍처에 맞는지 확인하고, 시스템 안내에 나온 차단 사유를 살펴보세요. Windows에서는 보안 알림과 설치 권한을 확인하고, macOS에서는 개인정보 보호 및 보안 설정에서 해당 앱의 차단 기록을 확인하세요. Android에서는 설치 파일을 여는 앱에 필요한 경우에만 권한을 부여하고, Linux에서는 패키지 관리자로 의존성 오류를 확인하세요. 설치를 위해 시스템 보안 기능 전체를 끄지 마세요.
다운로드 목록에서 릴리스 버전과 설치 파일명은 별도 항목이며, 갱신 시점이 다를 수 있습니다. 플랫폼, 아키텍처, 패키지 형식을 먼저 확인한 뒤 설치 후 클라이언트의 정보 화면에서 실제 버전을 확인하세요. 파일명을 근거로 다운로드 URL을 직접 수정하지 마세요. 다운로드가 중단되거나 링크를 일시적으로 사용할 수 없다면 나중에 이 페이지를 다시 열어 보세요. 기존에 정상적으로 사용 중인 설치 파일과 설정은 유지하고 반복해서 덮어쓰지 않는 것이 좋습니다.