CLIENT PACKAGES / 플랫폼 및 아키텍처
데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 우선 선택하세요. V2Fly 설정 환경이라면 v2flyNG도 고려할 수 있습니다. 먼저 운영체제를 선택한 다음 CPU 아키텍처와 설치 파일 형식을 확인하세요.
x64 설치 파일 · Desktop / WPF
차세대 크로스 플랫폼 UI입니다. 처음 설치한다면 이 버전부터 사용해 보세요. 통합 데스크톱 인터페이스에서 구독, 서버, 라우팅 설정을 관리할 수 있습니다.
ZIP / x64 / Windows
안정적인 클래식 버전으로 Windows WPF 인터페이스를 사용합니다. 기존 메뉴 위치와 데스크톱 사용 흐름에 익숙한 사용자에게 적합합니다.
ZIP / x64 / Windows
두 다운로드 경로는 서로 다른 인터페이스를 제공하며, 연결 품질의 등급을 뜻하지 않습니다. 연결 결과는 서버 설정, 코어 지원, 네트워크 경로에 따라 달라집니다. 버전을 바꾸기 전 설정을 백업하고 기존 프로세스를 종료해 같은 로컬 수신 포트를 중복으로 사용하지 않도록 하세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 운영체제 | 지원이 계속 제공되는 Windows 데스크톱 환경을 사용하세요. 최소 지원 버전은 선택한 패키지의 설치 안내를 확인해야 합니다. |
| CPU 아키텍처 | 이 페이지의 두 설치 파일은 모두 x64입니다. ‘설정 → 시스템 → 시스템 정보’에서 시스템 종류를 확인할 수 있습니다. |
| 패키지 및 실행 환경 | ZIP 파일을 다운로드한 뒤 압축을 풀고 설치 프로그램을 실행하세요. 실행 환경이 없다는 안내가 나오면 설치 안내에 따라 처리하고, 다른 아키텍처용 구성 요소를 함께 설치하지 마세요. |
| 권한 | 일반 실행과 시스템 프록시 설정은 클라이언트 안내에 따라 진행하세요. TUN을 활성화할 때는 관리자 권한이 필요할 수 있습니다. |
압축 파일은 쓰기 가능한 별도 폴더에 풀고, 압축 파일 미리보기 창에서 바로 실행하지 마세요. 설치 후 유효한 연결 설정을 가져와 작동을 확인한 다음 시작 프로그램에 등록하세요. 다른 프록시 프로그램이 실행 중이라면 어떤 프로그램이 시스템 프록시를 관리하는지 먼저 확인하세요.
‘이 Mac에 관하여’에서 칩 정보를 확인하고 DMG를 선택하세요
‘칩’ 항목에 Apple M 시리즈가 표시되는 기기용입니다. 프로세서에 맞는 네이티브 아키텍처 패키지를 우선 사용하세요. 파일 이름이 다르다는 이유만으로 Intel 패키지로 바꿀 필요는 없습니다.
DMG / arm64 / macOS
‘프로세서’ 항목에 Intel이 표시되는 기기용입니다. 기기의 외관이나 구입 연도로 칩을 판단하지 말고, 다운로드 전에 시스템에서 하드웨어 정보를 직접 확인하세요.
DMG / x64 / macOS
DMG를 열고 설치 창의 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮긴 뒤 해당 폴더에서 실행하세요. 처음 실행할 때 시스템 보안 알림이 표시되면 파일 출처와 앱 이름을 확인하고 시스템에서 안내하는 개별 앱 허용 절차를 따르세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 칩 | Apple 메뉴의 ‘이 Mac에 관하여’에서 Apple Silicon 또는 Intel을 확인하세요. 각각 arm64와 x64에 해당합니다. |
| 운영체제 버전 | 선택한 앱 패키지가 현재 macOS 버전을 지원해야 합니다. 최소 요구 사항은 설치 중 표시되는 호환성 안내를 확인하세요. |
| 설치 위치 | 앱을 ‘응용 프로그램’ 폴더로 옮긴 뒤 실행하세요. 마운트한 디스크 이미지에서 계속 실행하지 않는 것이 좋습니다. |
| 네트워크 권한 | 시스템 프록시나 TUN을 사용할 때 권한 요청이 표시될 수 있습니다. 현재 클라이언트의 요청인지 확인한 다음 필요한 권한만 허용하세요. |
설치가 완료되어도 트래픽이 자동으로 전달되는 것은 아닙니다. 먼저 서버 설정을 확인한 다음 시스템 프록시나 필요한 트래픽 처리 방식을 선택하세요. 다른 네트워크 도구를 사용 중이라면 프록시와 DNS 설정을 기록해 두고, 문제를 확인할 때 여러 프로그램을 동시에 변경하지 마세요.
v2rayNG 우선 · V2Fly 코어 대안은 v2flyNG
2015년 이후 출시된 대부분의 스마트폰에서는 arm64를 먼저 선택하면 됩니다. 다만 프로세서 이름만으로 판단하지 말고 운영체제가 64비트 앱을 지원하는지 확인하세요.
APK / arm64-v8a
앱 아키텍처를 확인하기 어려울 때 선택할 수 있습니다. 범용 패키지는 여러 아키텍처용 구성 요소를 포함해 다운로드 용량이 더 클 수 있으며, 최소 운영체제 요구 사항은 그대로 적용됩니다.
APK / universal
v2rayNG는 Xray 코어를 사용합니다. 연결을 가져온 뒤 서버 주소, 포트, 프로토콜, 전송 옵션을 확인하세요. 처음 연결을 시작하면 Android에서 VPN 연결 권한을 요청합니다. 이 권한은 기기의 트래픽을 처리하기 위한 것으로, 서버 연결 정보가 자동으로 제공되는 것은 아닙니다.
운영체제가 arm64 앱을 지원하고 V2Fly 코어 설정을 사용하려는 기기에 적합합니다. 설치 전에 필요한 프로토콜과 전송 방식이 클라이언트에서 지원되는지 확인하세요.
APK / arm64-v8a
아키텍처를 확인하기 어려운 경우에 사용할 수 있습니다. arm64 패키지와 같은 클라이언트이며, 선택 기준은 기기 호환성이지 서버 속도가 아닙니다.
APK / universal
v2flyNG와 v2rayNG는 같은 코어에 테마만 다른 앱이 아닙니다. 기존 V2Fly 설정을 사용한다면 프로토콜과 필드 지원을 먼저 확인하세요. 연결 정보를 옮긴 뒤 DNS, 라우팅, 트래픽 처리 설정을 다시 점검하고 다른 클라이언트의 설정 파일을 통째로 덮어쓰지 마세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 시스템 호환성 | APK 설치 프로그램에 표시되는 최소 Android 버전과 앱 아키텍처 지원을 확인하세요. |
| 아키텍처 | 64비트 앱을 지원하는 대부분의 기기에서는 arm64를 선택하세요. 확실하지 않다면 범용 버전을 시도할 수 있습니다. |
| 설치 권한 | 설치 파일을 연 브라우저나 파일 관리자에만 필요한 설치 권한을 허용하고, 설치가 끝나면 권한을 취소할 수 있습니다. |
| 트래픽 처리 | 처음 연결할 때 VPN 권한을 확인해야 합니다. 일반적으로 한 번에 하나의 VPN 서비스만 트래픽을 처리해야 합니다. |
| 백그라운드 실행 | 화면을 잠근 뒤 연결이 끊기면 배터리 최적화와 백그라운드 제한을 확인하고 기기 설정에 맞게 조정하세요. |
‘앱이 설치되지 않았습니다’라는 안내가 표시되면 전체 오류 내용을 먼저 확인하세요. 아키텍처 불일치, 낮은 운영체제 버전, 저장 공간 부족, 기존 앱과 서명 불일치 등이 원인일 수 있습니다. 기존 앱을 바로 삭제하지 마세요. 먼저 설정을 내보내고 백업이 정상인지 확인한 뒤 설치 충돌을 해결하세요.
배포판 패키지 형식을 선택한 다음 x64 또는 arm64를 고르세요
DEB 패키지 관리 체계를 사용하는 데스크톱 배포판이라면 이 형식을 선택하세요. 파일 이름의 amd64는 x64 아키텍처를 뜻하며, 해당 아키텍처의 Intel 프로세서에서도 사용할 수 있습니다.
RPM 패키지 관리 체계를 사용하는 데스크톱 배포판이라면 이 형식을 선택하세요. 구체적인 의존성 및 배포판 호환성은 패키지 관리자로 확인해야 하며, 확장자만으로 사용 가능 여부를 판단할 수 없습니다.
배포판의 그래픽 소프트웨어 설치 도구로 설치 파일을 열고, 의존성과 변경 사항을 확인한 뒤 설치를 진행하세요. 앱 메뉴에 v2rayN이 표시되면 데스크톱에서 실행합니다. 실행되지 않는다면 관련 없는 아키텍처의 패키지를 반복해서 바꾸기보다 패키지 관리자가 제공하는 호환성 정보를 먼저 확인하세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 데스크톱 세션 | 그래픽 앱을 실행할 수 있는 데스크톱 환경이 필요합니다. 이 페이지의 패키지는 데스크톱 클라이언트용이며, GUI가 없는 서버에 배포하기 위한 패키지가 아닙니다. |
| 패키지 형식 | Debian·Ubuntu 계열은 보통 DEB를, Fedora 등 RPM 계열은 RPM을 선택하세요. 해당 패키지의 의존성도 확인해야 합니다. |
| CPU 아키텍처 | x64는 amd64 또는 x86_64, arm64는 arm64 또는 aarch64에 해당합니다. 시스템 하드웨어 정보를 기준으로 선택하세요. |
| 권한 및 의존성 | 설치는 그래픽 패키지 관리자가 처리합니다. TUN 및 시스템 네트워크 설정에는 별도 권한이 필요할 수 있습니다. |
설치 후 그래픽 인터페이스, 설정 가져오기, 로컬 수신이 정상인지 확인한 다음 데스크톱 자동 시작을 추가하세요. 시스템 프록시를 앱이 사용하는지는 데스크톱 환경과 앱의 동작에 따라 다릅니다. TUN을 사용하는 경우 권한, 라우팅, 다른 네트워크 도구와의 충돌을 별도로 확인하세요.
설치 파일은 클라이언트를 설치하는 데 사용합니다. 연결 설정, 프록시 모드, 연결 확인은 이후에 각각 진행해야 합니다.
위 단계를 마친 뒤 실제로 사용할 앱에서 연결을 확인하고 클라이언트 로그의 오류 유형을 살펴보세요. 시간 초과, 인증 실패, 도메인 이름 확인 실패는 원인과 해결 방향이 서로 다릅니다. 한 번의 테스트 결과만으로 앱을 삭제하고 다시 설치하지 마세요. 프로토콜, DNS, 라우팅, 프록시 모드를 한꺼번에 바꾸면 문제를 비교할 기준이 사라집니다.
설치 업데이트, 연결 매개변수, 코어 호환성을 따로 확인해 서로 다른 문제를 혼동하지 마세요.
클라이언트를 업데이트한다고 보통 서버를 바꿀 필요는 없지만, 인터페이스와 기본 옵션, 설정 변환 방식은 달라질 수 있습니다. 현재 정상 작동하는 서버, 수신 포트, 라우팅 모드, DNS 설정을 기록하고 실행 중인 클라이언트를 종료한 뒤 설치하세요. 업데이트 후에는 구독이 유지됐는지, 올바른 서버를 선택했는지, 시스템 프록시가 예상대로 설정됐는지 확인하세요.
이전 버전으로 되돌려야 한다면 업데이트 전에 내보낸 백업을 우선 사용하세요. 이전 버전이 새 버전에서 저장한 설정을 모두 인식하지 못할 수 있으므로, 설정 파일을 열 수 있다는 이유만으로 완전히 호환된다고 판단하면 안 됩니다. Desktop과 WPF 간에 옮길 때도 같은 원칙을 적용하세요.
Project V 생태계에는 여러 코어 구현이 있습니다. v2rayNG는 Xray를 기반으로 하며 v2flyNG는 V2Fly를 사용합니다. 데스크톱용 v2rayN의 실제 코어 선택은 클라이언트 인터페이스와 연결 설정을 확인하세요. 프로토콜 이름이 같아도 확장 전송 옵션, TLS 매개변수, 라우팅 필드가 모든 코어에서 완전히 동일하게 지원되는 것은 아닙니다.
서버 설정 요구 사항에 맞춰 클라이언트를 선택한 다음 프로토콜과 전송 방식 지원 여부를 확인하세요. Android의 한 클라이언트에서 다른 클라이언트로 설정 전체를 그대로 덮어쓰지 마세요. 필드의 의미는 설정 필드 문서에서, 용어 차이는 용어 설명에서 확인할 수 있습니다.
프로토콜 및 코어 용어 보기 →먼저 패키지 형식, 아키텍처, 시스템 안내를 확인한 뒤 클라이언트 설정을 살펴보세요.
처음 설치한다면 새로운 크로스 플랫폼 인터페이스를 사용하는 Desktop 버전을 먼저 고려해 보세요. 클래식한 Windows 인터페이스에 익숙하거나 기존 사용 흐름을 유지하려면 안정적인 WPF 버전을 선택할 수 있습니다. 두 버전 모두 유효한 연결 설정을 가져와야 합니다. 인터페이스를 바꾸기 전 구독, 라우팅, 설정을 백업하고, 같은 포트를 점유하지 않도록 두 클라이언트를 동시에 실행하지 마세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택해도 되지만, 최종적으로는 기기의 운영체제가 지원하는 앱 아키텍처를 확인해야 합니다. 64비트 프로세서를 탑재했더라도 운영체제가 32비트 앱만 지원하는 기기가 있습니다. 아키텍처를 확인할 수 없거나 arm64 패키지가 호환되지 않는다고 표시되면 범용 버전을 시도해 보세요. 다만 범용 버전도 모든 구형 운영체제와 호환되는 것은 아닙니다.
클라이언트 설치 파일에는 바로 사용할 수 있는 서버 연결 정보가 포함되어 있지 않습니다. 사용 권한이 있는 구독 주소나 개별 연결 설정을 준비한 뒤 가져오기, 서버 선택, 프록시 모드 설정, 연결 확인을 진행해야 합니다. 구독 주소에는 접속 정보가 포함될 수 있으므로 스크린샷이나 게시판에 공개하지 마세요.
현재 클라이언트의 내보내기 또는 백업 기능으로 구독, 서버, 사용자 지정 규칙을 저장하고 시스템 프록시와 TUN 설정을 기록한 다음 클라이언트를 종료하고 업데이트하세요. 인터페이스나 클라이언트, 코어가 다르면 설정 폴더를 그대로 서로 바꿔 쓸 수 있다고 가정하지 마세요. 업데이트 후 설정과 수신 포트를 확인한 다음 프록시 연결을 다시 활성화하세요.
운영체제, CPU 아키텍처, 패키지 형식이 맞는지 확인하고 다운로드가 완료됐는지도 살펴보세요. Windows 파일은 ZIP 압축 파일이므로 먼저 압축을 풀어야 합니다. macOS는 칩에 맞는 DMG를 선택하고, Android는 앱 설치 권한과 아키텍처 호환성을 확인하세요. Linux에서는 그래픽 패키지 관리자로 의존성을 확인할 수 있습니다. 설치 파일을 열기 위해 시스템 보안 기능 전체를 끄지 마세요.
두 클라이언트는 각각 Xray와 V2Fly 코어를 사용하므로 지원하는 프로토콜, 전송 방식, 확장 필드가 다를 수 있습니다. 일반적인 연결 정보는 클라이언트가 지원하는 방식으로 다시 가져올 수 있지만, 모든 설정이나 원본 JSON이 그대로 이전된다고 볼 수는 없습니다. 이전하기 전에 백업하고 서버 매개변수, TLS, 전송 방식, DNS, 라우팅 규칙을 하나씩 확인하세요.