v2rayN · v2rayNG · v2flyNG
데스크톱에서는 v2rayN을 사용하세요. Android는 v2rayNG를 우선 추천하며 v2flyNG는 대안으로 선택할 수 있습니다. 먼저 운영체제를 고른 뒤 CPU 아키텍처와 설치 형식을 확인하세요.
설치 파일에는 클라이언트 프로그램만 포함되어 있습니다. 연결하려면 사용할 권한이 있는 구독 주소나 설정이 필요합니다. 기존 설치 기록이 있다면 업데이트 전에 백업하는 것이 좋습니다.
두 버전 모두 x64 설치 파일을 제공합니다. 처음 설치한다면 데스크톱 버전을, 클래식 레이아웃이 익숙하다면 WPF 버전을 선택하세요.
Avalonia 기반의 차세대 크로스 플랫폼 UI입니다. 새로 설치하거나 데스크톱 운영체제가 달라도 비슷한 방식으로 사용하고 싶은 분에게 적합합니다.
Windows용 클래식 UI 버전입니다. 기존 메뉴 위치에 익숙하거나 전통적인 데스크톱 레이아웃을 선호하는 분에게 적합합니다.
여기서 ‘데스크톱 버전’과 ‘WPF 버전’은 UI 프레임워크의 차이를 뜻합니다. 서로 다른 구독 서비스가 아니며, 어느 한쪽이 반드시 더 빠르게 연결되는 것도 아닙니다. 지원되는 프로토콜은 실제 실행 중인 코어, 연결 매개변수, 서버 설정에 따라 달라집니다.
클라이언트 및 버전 차이 보기 →| 확인 항목 | 요구 사항 및 확인 방법 |
|---|---|
| 시스템 및 아키텍처 | 이 페이지에서는 Windows x64 패키지를 제공합니다. ‘설정 → 시스템 → 시스템 정보’에서 시스템 종류를 확인하세요. 최소 지원 버전은 선택한 배포 패키지의 안내를 따릅니다. |
| 실행 환경 | 데스크톱 버전과 WPF 버전은 필요한 런타임이 다를 수 있습니다. 런타임 오류가 나타나면 해당 오류에 맞게 해결하고, 다른 버전의 종속 파일을 설치 폴더에 섞어 넣지 마세요. |
| 폴더 및 권한 | 압축 파일을 쓰기 가능한 폴더에 완전히 풀고, 폴더 안의 설치 프로그램을 실행하세요. 시스템 프록시 설정에는 보통 지속적인 관리자 권한이 필요하지 않지만, TUN으로 트래픽을 처리할 때는 추가 권한이 필요할 수 있습니다. |
다운로드 파일은 ZIP 압축 파일입니다. 압축 프로그램의 미리보기에서 바로 실행하지 마세요. 먼저 파일을 모두 압축 해제한 뒤, 패키지에 포함된 안내에 따라 설치하거나 실행하세요. 그래야 설정, 로그, 부속 파일이 임시 폴더에 흩어지지 않습니다. 이전 버전이 백그라운드에서 실행 중이라면 포트 충돌을 막기 위해 먼저 종료하세요.
처음 실행한 뒤 화면은 정상적으로 표시되지만 웹 페이지에 연결할 수 없다면, 설정을 가져왔는지와 서버를 선택했는지 먼저 확인한 다음 시스템 프록시를 점검하세요. 설치가 끝난 것과 네트워크 트래픽 처리가 설정된 것은 별개입니다. 순서대로 설정하려면 사용 가이드를 참고해 구독 가져오기부터 확인하세요.
시스템 메뉴의 ‘이 Mac에 관하여’에서 칩 또는 프로세서 이름을 확인하세요. Apple Silicon과 Intel용 DMG가 각각 제공됩니다.
‘이 Mac에 관하여’에 Apple M 시리즈 칩이 표시되면 이 패키지를 선택하세요. 기기 모델명이나 구입 연도가 아닌 칩 이름으로 판단하면 됩니다.
‘이 Mac에 관하여’에 Intel 프로세서가 표시되면 이 패키지를 선택하세요. Apple Silicon용과 클라이언트 이름은 같지만 실행 파일의 아키텍처가 다릅니다.
DMG를 열고 앱을 ‘응용 프로그램’ 폴더로 복사한 뒤 실행하세요. 처음에는 일반적인 설정 가져오기와 시스템 프록시 설정부터 마치고 기본 연결이 정상인지 확인하세요. TUN과 사용자 지정 DNS는 그다음에 설정하는 것이 좋습니다.
설치 후 설정 단계 보기 →| 확인 항목 | 요구 사항 및 확인 방법 |
|---|---|
| 칩 아키텍처 | Apple M 시리즈는 arm64, Intel은 x64에 해당합니다. 칩에 맞는 네이티브 패키지를 우선 사용하세요. |
| 시스템 호환성 | 최소 macOS 버전은 현재 배포 패키지의 요구 사항을 확인하세요. 구형 시스템에서 실행되지 않는다면 칩 패키지를 반복해서 바꾸기보다 먼저 시스템 호환성을 확인해야 합니다. |
| 시스템 권한 | 네트워크 트래픽 처리나 보조 구성 요소에 권한이 필요할 수 있습니다. 출처를 확인한 앱에 한해 시스템 안내에 따라 허용하고, 시스템 보안 기능은 계속 활성화해 두세요. |
시스템에서 앱을 열 수 없다는 알림이 표시되면 먼저 전체 메시지를 확인하세요. 아키텍처 불일치, 오래된 시스템 버전, 앱 보안 확인, 파일 손상은 서로 다른 문제입니다. 모든 알림을 같은 원인으로 취급하지 말고, 특정 앱을 실행하기 위해 시스템 보안 검사를 전역으로 끄는 방법도 권장하지 않습니다.
업데이트 전에 실행 중인 클라이언트를 종료한 뒤 앱을 교체하세요. 응용 프로그램 폴더와 사용자 데이터 폴더는 서로 다른 위치입니다. 앱 아이콘을 옮겨도 설정 전체가 함께 이전되는 것은 아닙니다. 다른 컴퓨터로 옮길 때는 클라이언트에서 지원하는 내보내기 기능으로 필요한 정보를 저장하고, 새 환경의 프록시 및 권한 설정을 확인하세요.
먼저 코어를 확인한 다음 CPU 아키텍처를 선택하세요. 일반적으로는 v2rayNG를 권장하며, V2Fly 설정이 필요한 경우에 v2flyNG를 고려하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택하면 됩니다. 일부 기기는 32비트 시스템을 사용할 수 있으므로, 실제 시스템이 지원하는 앱 아키텍처를 확인하세요.
기기 아키텍처를 확인하기 어렵다면 범용 버전을 선택할 수 있습니다. 여러 아키텍처를 지원하는 패키지이지만, 구형 Android 시스템까지 자동으로 지원하는 것은 아닙니다.
Xray 생태계의 설정을 주로 사용하는 Android 사용자에게 적합합니다. 설치 후 구독 또는 연결 정보를 가져온 다음, 시스템 안내에 따라 VPN 연결 권한을 허용하세요. 이 권한은 기기의 트래픽을 처리하기 위한 것이며, 설치 파일에 사용할 수 있는 서버가 포함되어 있다는 뜻은 아닙니다.
V2Fly 코어가 필요한 것이 확실하고 기기에서 arm64를 지원하는 사용자에게 적합합니다. 선택 기준은 다른 클라이언트와 이름이 비슷한지가 아니라 설정 호환성입니다.
기기 아키텍처를 확인하기 어려울 때 적합합니다. 다른 클라이언트에서 가져온 설정도 프로토콜, 전송 방식, 보안 설정, 라우팅 필드를 다시 확인해야 합니다.
Xray 전용 확장 매개변수를 V2Fly에서 그대로 사용할 수 있다고 가정하지 마세요. 구독을 가져올 수 있다는 것은 클라이언트가 해당 정보를 인식했다는 뜻일 뿐, 현재 코어가 모든 연결 매개변수를 처리할 수 있다는 뜻은 아닙니다.
Android 클라이언트 두 가지 비교 →| 확인 항목 | 요구 사항 및 확인 방법 |
|---|---|
| 시스템 및 아키텍처 | 기기에서 arm64 앱을 지원하는지 먼저 확인하세요. 최소 Android 버전은 해당 APK의 설치 요구 사항을 따릅니다. 범용 버전이라고 해서 모든 시스템과 호환되는 것은 아닙니다. |
| 설치 권한 | 시스템 안내에 따라 현재 브라우저나 파일 관리자가 앱을 설치하도록 허용하세요. 설치가 끝나면 해당 설치 권한을 해제할 수 있습니다. |
| VPN 및 백그라운드 실행 | 처음 연결할 때 VPN 권한이 필요합니다. 다른 VPN 앱이 실행 중이라면 충돌 여부를 먼저 확인하세요. 백그라운드에서 자주 연결이 끊길 때는 배터리 최적화 설정을 확인하세요. |
‘앱이 설치되지 않았습니다’라는 메시지가 표시되는 원인은 아키텍처 문제만이 아닙니다. 시스템 버전, 기존 앱의 서명, 저장 공간 부족, 설치 파일 읽기 실패도 원인일 수 있습니다. 업데이트 충돌 메시지가 나오면 현재 설정을 먼저 백업하고 기존 앱의 출처를 확인하세요. 업데이트를 위해 유일한 설정 데이터를 바로 삭제하지 마세요.
Android의 VPN 연결 권한은 시스템의 네트워크 트래픽 처리와 관련이 있습니다. 클라이언트 두 가지를 시험할 때는 한 번에 하나만 실행하고, 다른 클라이언트의 연결을 먼저 끈 뒤 브라우저 접속과 클라이언트 로그를 확인하세요. 일부 앱에서만 문제가 생기면 설치 파일을 바꾸기보다 앱별 프록시 설정을 먼저 살펴보세요.
먼저 deb와 rpm 중 알맞은 형식을 고르고 x64 또는 arm64인지 확인하세요. 데스크톱 클라이언트는 사용 가능한 그래픽 세션이 필요하며, 터미널만 있는 서버 환경용은 아닙니다.
Debian, Ubuntu 등 deb 패키지 관리 방식을 사용하는 배포판에 적합합니다. amd64는 여기서 x64 아키텍처를 가리키며 특정 프로세서 브랜드에 한정되지 않습니다.
rpm 패키지 관리 방식을 사용하고 종속성 버전이 맞는 시스템에 적합합니다. 패키지 확장자가 같아도 모든 배포판에서 사용할 수 있는 것은 아니므로 소프트웨어 설치 프로그램의 종속성 안내를 확인하세요.
다운로드한 뒤 시스템 소프트웨어 설치 프로그램으로 패키지를 열어 설치할 수 있습니다. 종속성을 충족할 수 없다면 배포판과 패키지의 호환성을 확인하고, 종속성을 무시한 채 강제 설치하지 마세요. 이 패키지에서 arm64와 aarch64는 같은 계열의 프로세서 아키텍처를 가리킵니다.
시스템 프록시, 인바운드 및 라우팅 안내 →| 확인 항목 | 요구 사항 및 확인 방법 |
|---|---|
| 패키지 관리 방식 | 배포판에서 기본 지원하는 deb 또는 rpm 형식을 사용하세요. 필요한 시스템 라이브러리는 패키지 메타데이터와 설치 프로그램 안내를 확인해야 합니다. |
| CPU 아키텍처 | x86_64와 amd64는 x64, aarch64와 arm64는 arm64에 해당합니다. 시스템 정보에서 아키텍처를 확인할 수 있습니다. |
| 데스크톱 및 권한 | 그래픽 데스크톱과 필요한 런타임 종속성이 있어야 합니다. 시스템 프록시를 읽을 수 있는지는 앱에 따라 다르며, TUN과 네트워크 인터페이스 관리에는 추가 권한이 필요할 수 있습니다. |
Linux 데스크톱 환경마다 시스템 프록시를 처리하는 방식이 다릅니다. 클라이언트에서 시스템 프록시를 켰는데도 특정 프로그램이 직접 연결한다면, 해당 프로그램이 데스크톱 프록시 설정을 읽는지와 별도의 프록시 옵션이 있는지 확인하세요. 이런 트래픽 처리 범위 문제는 같은 설치 파일을 다시 설치해도 해결되지 않는 경우가 많습니다.
업그레이드할 때는 패키지 관리 방식을 일관되게 유지하고, 파일을 직접 복사하는 방식과 시스템 패키지 설치를 섞지 마세요. 클라이언트 폴더가 여러 개라면 현재 실행 중인 인스턴스와 데이터 폴더, 수신 대기 포트를 먼저 확인한 뒤 설정 손실이나 포트 충돌 여부를 판단하세요.
설치, 설정 가져오기, 트래픽 처리는 서로 독립된 단계입니다. 순서대로 확인하면 설정 문제를 설치 파일 문제로 오해하는 일을 줄일 수 있습니다.
시스템과 아키텍처에 맞는 패키지를 설치하고 화면이 정상적으로 열리는지 확인하세요. 오류가 발생하면 전체 메시지를 기록하고 시스템 호환성, 종속성 누락, 권한 문제를 구분하세요. 여러 구성 요소를 한꺼번에 바꾸지 마세요.
접근 권한이 있는 구독이나 연결 정보를 사용하고, 업데이트한 뒤 사용할 설정을 선택하세요. 구독 주소에 접근 정보가 포함될 수 있으므로 공개 토론 게시판에 올리거나 스크린샷과 함께 공유하지 마세요.
데스크톱에서는 시스템 프록시를 확인하고, Android에서는 안내에 따라 VPN 권한을 허용하세요. 기본 연결을 확인한 뒤 라우팅, DNS, TUN을 조정하세요. 한 번에 하나씩 변경하고 되돌릴 수 있는 설정을 보관하세요.
버전 선택, 아키텍처, 설정 호환성, 백업에 관한 자주 묻는 질문 다섯 가지입니다.
처음 설치한다면 Avalonia 기반의 크로스 플랫폼 UI를 사용하는 데스크톱 버전을 권장합니다. Windows의 클래식 UI와 조작 방식에 익숙하다면 WPF 버전을 선택하세요. 둘 다 v2rayN이며, UI 프레임워크가 다르다고 연결 성능에 우열이 정해지는 것은 아닙니다. 이전하기 전에 구독, 라우팅 규칙, 사용자 설정을 백업하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택하면 됩니다. 다만 시스템에서 64비트 앱을 지원하는지 확인하세요. 아키텍처를 확인하기 어렵다면 범용 버전을 선택할 수 있습니다. 설치 파일이 호환되지 않는다는 메시지가 나오면 같은 파일을 반복해서 설치하지 말고 시스템 버전과 앱 아키텍처를 확인하세요.
모든 설정이 서로 호환된다고 단정할 수는 없습니다. v2rayNG는 Xray 코어, v2flyNG는 V2Fly 코어를 기반으로 합니다. 일반 연결 정보는 가져올 수 있어도, 실제 사용 가능한 프로토콜·전송 방식·확장 필드는 코어 지원 여부와 클라이언트 버전에 따라 다릅니다. 이전한 뒤 설정을 다시 확인하세요.
설치 파일에는 바로 사용할 수 있는 연결 설정이 포함되어 있지 않습니다. 사용할 권한이 있는 구독 주소나 연결 정보를 준비해 가져온 다음, 유효한 설정을 선택하고 시스템 프록시 등 트래픽 처리 방식을 지정하세요. 처음 연결할 때는 DNS와 라우팅을 기본값으로 유지하고, 정상 작동을 확인한 뒤 항목별로 조정하는 것이 좋습니다.
먼저 클라이언트를 종료하고 내보내기 또는 백업 기능으로 구독, 라우팅 규칙, 사용자 설정을 저장하세요. 실제 데이터 폴더도 확인해야 합니다. 기존 설치 파일과 백업을 보관하고, 업데이트 후에는 현재 설정과 시스템 프록시, 로그를 확인하세요. 이전 버전으로 되돌리기 전에는 데이터 형식의 호환성을 확인하고 유일한 백업을 덮어쓰지 마세요.