데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 고려하세요. 운영체제와 프로세서를 확인한 다음 알맞은 설치 파일을 선택하면 됩니다.
Windows x64 · Desktop 데스크톱 버전 / 클래식 WPF 버전
데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용해 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하고 싶은 분에게 적합합니다. 서버, 구독 그룹, 라우팅, 코어 설정은 각각 확인해야 합니다. 인터페이스가 비슷해도 시스템 프록시 작동 방식까지 같은 것은 아닙니다.
WPF 버전은 기존 Windows 인터페이스를 사용해 이전 메뉴 구성에 익숙한 분에게 적합합니다. 두 버전의 차이는 속도 등급이 아닙니다. 실제 연결 성능은 UI 프레임워크보다 서버, 네트워크 경로, 프로토콜 조합, 라우팅 설정의 영향을 크게 받습니다.
| 확인 항목 | 요구 사항 |
|---|---|
| 운영체제 및 아키텍처 | Windows x64 환경용입니다. “설정 → 시스템 → 정보”에서 시스템 종류를 확인하세요. |
| 설치 파일 형식 | ZIP 압축 파일로 제공됩니다. 별도 폴더에 압축을 푼 다음 폴더 구성에 따라 설치 프로그램이나 클라이언트를 실행하세요. |
| 실행 환경 | 필요한 운영체제 버전과 런타임은 배포 패키지에 따라 다릅니다. 런타임이 없다는 안내가 나오면 안내에 맞는 구성 요소를 설치하세요. |
| 권한 및 트래픽 처리 방식 | 일반 시스템 프록시와 TUN은 필요한 권한이 다릅니다. TUN을 사용할 때는 클라이언트 안내에 따라 권한을 허용하세요. |
압축 파일 미리보기 창에서 프로그램을 바로 실행하지 마세요. 압축을 완전히 푼 뒤 실행해야 같은 폴더의 리소스와 설정, 구성 요소를 불러올 수 있습니다. 현재 사용자 계정으로 쓸 수 있는 위치에 설치하세요. 설정 저장에 실패하면 재설치부터 하기보다 폴더 권한을 먼저 확인하세요.
설치가 끝나면 구독이나 서버 설정을 가져온 뒤 사용할 항목을 선택하세요. 시스템 프록시는 시스템 설정을 따르는 앱에만 적용됩니다. 특정 프로그램이 프록시를 거치지 않으면 해당 프로그램의 네트워크 설정을 먼저 확인하세요. Desktop과 WPF 버전을 전환하기 전에 설정을 내보내고 기존 프로그램을 종료한 뒤 시스템 프록시 상태를 정리하세요. 두 프로그램이 동시에 설정을 변경하지 않도록 주의해야 합니다.
macOS · ‘이 Mac에 관하여’에 표시된 칩에 맞춰 선택
‘이 Mac에 관하여’에 Apple M 시리즈 칩이 표시되면 arm64 설치 파일을 선택하세요. 칩에 맞는 네이티브 아키텍처를 우선 사용하고, 기기를 구입한 연도만으로 판단하지 마세요. 같은 시기에 판매된 모델도 프로세서가 다를 수 있습니다.
‘이 Mac에 관하여’에 Intel 프로세서가 표시되면 x64 설치 파일을 선택하세요. 두 DMG 파일은 기능 등급이 아니라 프로세서 아키텍처에 따라 나뉩니다. 앱을 실행할 수 없다는 안내가 나오면 설치 과정에 문제가 있다고 단정하기 전에 아키텍처와 시스템 호환성을 확인하세요.
| 확인 항목 | 요구 사항 |
|---|---|
| 프로세서 | Apple Silicon은 arm64, Intel은 x64를 선택하세요. 시스템 메뉴의 ‘이 Mac에 관하여’에서 확인할 수 있습니다. |
| 패키지 형식 | DMG 디스크 이미지입니다. 이미지를 연 다음 안내에 따라 ‘응용 프로그램’ 폴더에 설치하세요. |
| 시스템 호환성 | 현재 배포 패키지의 실행 요구 사항과 시스템 안내를 확인하세요. 구형 시스템은 호환 여부를 먼저 확인해야 합니다. |
| 시스템 권한 | 사용할 프록시 모드에 따라 시스템 권한을 허용하세요. 네트워크 확장이나 트래픽 처리 권한은 구독을 가져오는 것과 다릅니다. |
설치 후에는 ‘응용 프로그램’에서 클라이언트를 실행하세요. 마운트된 디스크 이미지에서 계속 실행하지 마세요. 보안 안내가 표시되면 다운로드 경로와 안내 내용을 먼저 확인한 뒤 시스템의 ‘개인정보 보호 및 보안’ 설정에서 처리하세요. 앱 하나를 설치하려고 시스템 보안 기능을 전역으로 끄지 마세요.
다른 데스크톱 운영체제에서 설정을 옮길 때 호환되는 서버 매개변수는 재사용할 수 있지만, 로컬 경로, 네트워크 인터페이스, 시스템 프록시, 권한 설정은 다시 확인해야 합니다. 먼저 단일 설정으로 연결을 테스트한 뒤 전체 라우팅 규칙을 복원하면 문제가 서버 설정에서 비롯됐는지, 이 기기의 트래픽 처리 방식에서 비롯됐는지 구분하기 쉽습니다. 클라이언트를 종료하기 전에 시스템 프록시가 원래 상태로 돌아왔는지도 확인하세요.
Android · Xray 코어 · arm64 / 범용 버전
2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택하면 됩니다. 다만 운영체제가 64비트 앱을 지원하는지 확인하세요. 프로세서의 지원 기능과 시스템 실행 환경이 항상 일치하는 것은 아닙니다. 아키텍처 비호환 안내가 나오면 기기 정보를 확인한 뒤 범용 버전을 고려하세요.
범용 버전은 더 많은 아키텍처를 지원하지만 파일 크기가 더 큰 편입니다. 연결 속도가 더 빠르다는 뜻도, 구독 매개변수 오류를 자동으로 해결한다는 뜻도 아닙니다. 처음 실행한 뒤 유효한 설정을 가져오고 시스템의 VPN 연결 요청을 허용해야 합니다.
Android · V2Fly 코어 · 프로토콜 호환성 확인
V2Fly 설정 기능이 필요한 사용자에게 적합합니다. 선택하기 전에 서버에서 요구하는 프로토콜, 전송 방식, 보안 항목을 확인하세요. 클라이언트 이름만으로 호환성을 판단할 수 없습니다. Project V 생태계에 속해 있어도 모든 확장 기능이 동일한 것은 아닙니다.
기기 아키텍처를 모른다면 범용 패키지를 선택할 수 있습니다. v2rayNG에서 옮길 때는 기존 설정을 백업하고 라우팅과 DNS를 하나씩 확인하세요. 설치 파일만 바꾼다고 서로 다른 코어의 전용 설정까지 자동 변환되지는 않습니다.
| 확인 항목 | 요구 사항 |
|---|---|
| 시스템 호환성 | 현재 APK를 지원하는 Android 시스템이 필요합니다. 최소 버전은 설치 프로그램과 배포 요구 사항을 확인하세요. |
| 기기 아키텍처 | 64비트 Android 환경에서는 arm64를 우선 선택하세요. 아키텍처를 모르면 범용 버전을 선택할 수 있지만 시스템 버전 요구 사항은 충족해야 합니다. |
| 설치 권한 | 시스템 안내에 따라 현재 브라우저나 파일 관리자의 앱 설치를 허용하세요. 설치 후에는 해당 권한을 다시 해제할 수 있습니다. |
| 연결 권한 | VpnService로 트래픽을 처리하려면 시스템 VPN 권한이 필요합니다. 같은 사용자 환경에서는 보통 VPN 서비스를 하나만 실행할 수 있습니다. |
| 백그라운드 실행 | 연결을 유지하려면 배터리 최적화와 백그라운드 권한을 적절히 설정하세요. 메뉴 위치는 기기 시스템에 따라 다릅니다. |
설치 프로그램에 ‘앱이 설치되지 않았습니다’라고 표시되면 시스템 버전이 낮은지, 아키텍처가 맞지 않는지, 저장 공간이 부족한지, 서명이 충돌하는지 확인하세요. 범용 버전은 주로 아키텍처 호환 범위를 넓히며 다른 설치 조건까지 해결하지는 않습니다. 기존 설정이 있다면 먼저 백업하세요. 기기에만 저장된 서버 정보를 잃지 않도록 기존 앱을 바로 삭제하지 마세요.
처음 연결할 때 표시되는 VPN 확인 창은 시스템이 트래픽 처리를 허용하는 절차이지 서버 로그인 화면이 아닙니다. 권한을 허용한 뒤 서비스 상태와 로그를 확인하세요. 화면을 잠근 뒤 연결이 자주 끊기면 배터리 최적화와 백그라운드 제한을 확인하고, 일부 앱만 프록시를 거치지 않으면 설치 파일을 바꾸기보다 앱별 프록시의 포함 또는 제외 설정을 살펴보세요.
두 Android 클라이언트에 설정을 각각 저장할 수 있지만, 테스트할 때는 VPN 서비스를 하나만 실행하세요. 코어 차이는 프로토콜 및 코어 참고 자료에서 확인할 수 있습니다. 백그라운드 설정 경로를 자세히 알아보려면 v2rayNG 권한, 배터리 절약 및 앱별 프록시 안내를 읽어보세요.
Linux · 배포판 패키지 형식을 선택한 뒤 x64 또는 arm64 선택
Debian 패키지 관리 방식을 사용하는 시스템에서는 deb를 선택하세요. 파일 이름의 amd64는 일반적인 x64 아키텍처를 뜻하며, 특정 프로세서 브랜드만을 가리키지 않습니다. ARM 데스크톱 기기는 arm64 패키지를 선택하고 배포판에서 필요한 런타임 종속성을 제공하는지 확인하세요.
RPM 패키지 관리 방식을 사용하는 시스템에서는 rpm을 선택하세요. x86_64는 x64, aarch64는 arm64에 해당합니다. 패키지 형식이 맞는 것은 첫 단계일 뿐입니다. 런타임 라이브러리와 배포판 호환성을 확인하고 종속성 문제를 무시한 채 설치를 강행하지 마세요.
| 확인 항목 | 요구 사항 |
|---|---|
| 실행 환경 | 그래픽 데스크톱 환경과 현재 클라이언트의 종속성이 필요합니다. 문자 터미널만 사용하는 환경에는 적합하지 않습니다. |
| 아키텍처 선택 | amd64 / x86_64는 x64, aarch64는 arm64를 선택하세요. 배포판 이름만으로 판단하면 안 됩니다. |
| 패키지 관리 방식 | 배포판에 맞는 deb 또는 rpm을 선택하고 시스템 패키지 설치 프로그램에서 종속성과 호환성 안내를 확인하세요. |
| 네트워크 트래픽 처리 | 데스크톱 시스템 프록시를 앱이 사용하는지는 데스크톱 환경과 앱 자체 설정에 따라 다릅니다. TUN에는 별도 권한이 필요합니다. |
다운로드한 파일을 배포판의 패키지 설치 프로그램으로 열고 종속성 안내를 확인한 다음 설치하세요. 파일 확장자가 맞아도 오래된 런타임 라이브러리나 다른 배포판 버전으로 인해 설치가 실패할 수 있습니다. 패키지 변환이나 종속성 무시는 기본 해결 방법으로 삼지 마세요.
실행 후 먼저 클라이언트에서 단일 설정으로 연결을 확인한 다음 데스크톱 환경의 시스템 프록시를 설정하세요. 브라우저, 다운로드 도구, 기타 앱이 같은 프록시 설정을 사용한다고 단정할 수 없습니다. 클라이언트 연결은 성공했는데 특정 앱이 계속 직접 연결된다면 해당 앱이 어떤 프록시 설정을 사용하는지 확인하세요. TUN을 사용한다면 권한과 네트워크 인터페이스, 기존 네트워크 관리 서비스도 점검해야 합니다.
설치 파일은 프로그램을 실행하는 데 필요한 파일입니다. 서버 설정, 트래픽 유입 경로, 라우팅 규칙은 각각 따로 구성해야 합니다.
구독 URL은 여러 서버 설정을 가져오는 데 사용하고, 단일 공유 링크는 설정 항목 하나를 가져오는 데 사용합니다. 입력란을 잘못 선택하지 마세요. 가져온 다음 프로토콜 유형, 주소, 포트, 전송 방식, 보안 매개변수를 확인하고 항목 하나를 선택해 연결을 테스트하세요. 구독을 업데이트하면 보통 서버 목록이 갱신되지만, 기기의 라우팅, DNS, 프록시 모드까지 동기화되는 것은 아닙니다.
데스크톱 시스템 프록시는 시스템 설정을 따르는 앱에 주로 적용됩니다. Android 클라이언트는 VpnService로 트래픽을 처리하며 앱별 프록시를 설정할 수도 있습니다. 라우팅 규칙은 코어에 들어온 연결을 처리하므로 시스템 프록시나 VPN 권한을 대신하지 않습니다. 먼저 트래픽이 들어오는 경로를 확인한 뒤 어떤 도메인과 주소를 proxy, direct, block으로 보낼지 정하세요.
서비스를 시작한 뒤 대상 앱에서 실제 요청을 보내고 로그로 연결 여부를 확인하세요. 지연 시간 테스트 결과, 화면에 표시되는 실행 상태, 실제 다운로드 속도는 서로 다른 항목을 측정합니다. 시간 초과가 발생하면 시스템 시간, 설정 업데이트, 전송 매개변수, DNS, 로그 순으로 점검하세요. 여러 설정을 한꺼번에 바꾸면 원인을 찾기 어려워집니다.
클라이언트 프로그램, 서버 설정, 로컬 설정은 서로 다른 데이터이므로 업데이트할 때 각각 처리해야 합니다.
업데이트 전에 보존할 서버 설정을 내보내고 라우팅 규칙, DNS, 수신 포트, 앱별 프록시는 별도로 기록하세요. 클라이언트마다 내보내는 범위가 다를 수 있으므로 ‘서버 내보내기’가 전체 백업을 뜻한다고 생각하면 안 됩니다. 백업 파일과 구독 URL에는 접속 정보가 들어 있을 수 있으니 안전한 위치에 보관하세요.
같은 클라이언트는 기존 데이터가 유지된 상태로 덮어쓸 수 있는 경우가 많지만, 시스템 설치 규칙과 앱 서명, 설치 방식에 따라 다릅니다. 서명이나 종속성 안내가 나오면 구체적인 원인을 먼저 확인한 뒤 이전 방법을 결정하세요. 백업하기 전에 기존 프로그램이나 설정 폴더를 삭제하지 마세요.
Project V는 관련 프록시 도구 생태계의 기반입니다. V2Fly는 V2Ray 코어 개발을 이어가며, Xray는 관련 기술 계열에 속하면서 자체 기능을 확장합니다. v2rayN은 데스크톱 설정을 관리하고, Android의 v2rayNG와 v2flyNG는 각 코어의 기능에 맞춰 선택해야 합니다.
이 클라이언트들은 오픈소스 방식으로 배포되며, 구체적인 라이선스 범위는 각 프로젝트와 구성 요소의 안내를 따릅니다. 클라이언트를 선택할 때는 특정 프로토콜 이름 하나의 지원 여부만 보지 말고 프로토콜, 전송 방식, 보안 항목의 조합을 확인하세요. 이전한 뒤에는 단일 설정으로 검증하고 복잡한 규칙을 복원하세요.
먼저 설치 조건을 확인한 다음 연결 설정을 점검하세요. 설치 파일을 바꾸는 것이 모든 문제의 해결책은 아닙니다.