데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. 먼저 운영체제와 CPU 아키텍처를 확인한 뒤 설치 파일을 고르면 됩니다. 프로토콜과 구독은 설치 후 설정하세요.
플랫폼별 다운로드 파일을 안내합니다. 클라이언트에는 서버나 구독이 포함되지 않습니다. 구독을 보유한 경우 설치 후 구독 설정 가이드를 참고하세요.
데스크톱 버전과 클래식 WPF 버전 중 하나만 선택하세요. 두 버전을 모두 설치할 필요는 없습니다.
Desktop 버전은 차세대 크로스 플랫폼 UI를 적용해 처음 사용하는 분이나 여러 데스크톱에서 일관된 사용 환경을 원하는 분에게 적합합니다. WPF 버전은 기존 Windows 인터페이스를 유지해 익숙한 화면 구성을 선호하는 분에게 안정적인 선택입니다.
두 다운로드 파일은 모두 ZIP 압축 파일입니다. 다운로드한 뒤 먼저 압축을 완전히 풀고 폴더 안의 파일을 사용해 설치하세요. 압축 프로그램의 미리보기에서 바로 실행하지 마세요.
두 인터페이스 버전의 차이는 주로 화면 구성과 데스크톱 기술에 있습니다. 같은 서버의 연결 품질을 판단하는 기준은 아닙니다. 처음 실행할 때 구독을 가져오고 서버를 선택한 뒤 시스템 프록시를 설정하세요. 시스템 프록시를 따르지 않는 프로그램까지 연결해야 할 때만 TUN 모드를 고려하면 됩니다. 설정 창이 열린다는 이유만으로 프록시가 적용됐다고 판단하지 마세요.
이전 버전에서 설정을 옮길 때는 먼저 내보내고 사용자 지정 라우팅과 로컬 포트를 기록한 다음 기존 프로그램을 종료하세요. 클라이언트 두 개를 동시에 실행하면 수신 포트를 두고 충돌하거나 서로 시스템 프록시 설정을 덮어쓸 수 있습니다. 새 인터페이스에서는 메뉴 위치가 달라질 수 있으므로 가져온 뒤 구독 그룹, 코어 선택, 라우팅 프리셋을 확인하세요. 기존 프로그램 폴더 전체를 그대로 복사하지 마세요.
v2rayN 구독 가져오기 단계 보기 →‘이 Mac에 관하여’에서 ‘칩’ 또는 ‘프로세서’를 확인하세요. 컴퓨터 외관만 보고 판단하지 마세요.
Apple Silicon 기기는 arm64 패키지를, Intel 프로세서가 표시되는 기기는 x64 패키지를 선택하세요. 칩에 맞는 네이티브 빌드를 우선 사용하고, 파일 이름을 통일하려고 다른 아키텍처를 선택할 필요는 없습니다.
다운로드 형식은 DMG입니다. 디스크 이미지를 연 다음 설치 화면의 안내에 따라 앱을 설치하고 응용 프로그램 폴더에서 실행하세요.
v2rayN 데스크톱 인터페이스에서 구독을 저장하고 서버를 선택하며 라우팅을 관리할 수 있습니다. 시스템 프록시는 해당 설정을 따르는 앱에만 적용되며, 모든 프로그램의 연결이 클라이언트를 거친다는 뜻은 아닙니다. 선택한 설정을 브라우저에서 확인한 뒤 실제 앱 사용 방식에 따라 TUN을 활성화할지 결정하세요. 기본 연결을 확인하기 전부터 가상 네트워크 인터페이스와 DNS 설정을 추가하지 마세요.
다른 컴퓨터로 설정을 옮길 때는 권한 범위에 맞게 구독 주소를 다시 가져올 수 있지만, 사용자 지정 파일 경로와 로컬 수신 포트, 시스템 관련 설정은 다시 확인해야 합니다. 가져온 뒤 인터페이스는 정상인데 연결되지 않는다면 로그에서 구체적인 오류를 먼저 확인하세요. 아키텍처 불일치는 주로 설치나 실행에 영향을 주므로 모든 네트워크 문제를 잘못된 칩 패키지 탓으로 돌려서는 안 됩니다.
데스크톱 설정 안내 보기 →일반적인 사용에는 Xray 코어 클라이언트를 선택하고, V2Fly 설정과의 호환성이 필요할 때 대안을 고려하세요.
Xray 코어를 사용하며 Android에서 구독을 관리하거나 관련 프로토콜 기능이 필요한 설정에 적합합니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하세요. 기기 아키텍처를 확인하기 어렵다면 범용 버전을 고려할 수 있으며, 최종적으로는 시스템에서 지원하는 앱 아키텍처를 확인해야 합니다.
설치 파일 형식은 APK입니다. 처음 연결을 설정하면 시스템에서 VPN 연결 권한을 요청합니다. 안내를 읽고 허용하세요.
V2Fly 코어를 사용하므로 관련 설정을 이미 사용 중이며 기존 호환성을 유지하려는 분에게 적합합니다. v2rayNG와 이름만 다른 버전으로 생각해서는 안 됩니다. REALITY 등 특정 기능을 사용하려면 코어 지원 범위를 먼저 확인하세요. 구독을 가져올 수 있다는 것만으로 연결이 가능하다고 판단할 수는 없습니다.
범용 버전은 여러 앱 아키텍처를 지원하지만 파일 크기가 더 큰 편입니다. 패키지 아키텍처 선택과 서버 프로토콜 종류는 서로 다른 문제입니다.
| 확인 항목 | 선택 기준 | 주의 사항 |
|---|---|---|
| 앱 아키텍처 | arm64 우선. 확실하지 않으면 universal을 고려하세요. | 프로세서가 64비트를 지원해도 시스템에서 64비트 앱 설치를 허용한다는 뜻은 아닙니다. |
| 시스템 버전 | APK 설치 프로그램에 표시된 최소 버전 요구 사항을 확인하세요. | 구형 시스템에서는 최신 빌드가 작동하지 않을 수 있습니다. |
| 설치 권한 | 필요한 경우 현재 다운로드 출처의 앱 설치를 허용하세요. | 설치가 끝나면 더 이상 필요하지 않은 설치 권한을 해제할 수 있습니다. |
| 연결 권한 | 클라이언트가 VPN 연결을 설정하도록 허용하세요. | VPN 터널을 사용하는 다른 앱과 충돌할 수 있습니다. |
설치 후 먼저 구독 그룹을 추가하고 업데이트를 실행한 뒤 서버를 선택하세요. 시스템 VPN 권한은 기기의 트래픽을 전달할 권한일 뿐, 구독이 유효하다는 뜻도 서버 설정을 대신한다는 뜻도 아닙니다. 연결을 눌렀을 때 곧바로 끊기면 앱 로그와 VPN 상태를 먼저 확인한 뒤 백그라운드 실행 제한, 배터리 최적화, 다른 VPN 앱의 터널 사용 여부를 살펴보세요.
화면을 끈 뒤 연결이 끊기거나 시스템이 백그라운드 앱을 종료하는 등 문제가 확인될 때만 기기 설정에서 백그라운드 권한을 조정하세요. 모든 권한을 한꺼번에 허용하거나 연결 결과를 비교하려고 클라이언트 두 개를 동시에 실행하지 마세요. v2rayNG와 v2flyNG를 바꾸기 전에는 기존 연결을 끊고 구독의 전송 방식과 보안 계층을 새 코어가 지원하는지 다시 확인하세요.
v2rayNG 구독 가져오기 단계 보기 →deb와 rpm은 서로 다른 패키지 관리 체계에 해당하며, 프록시 프로토콜의 차이가 아닙니다.
일반적인 Intel 및 AMD 데스크톱 기기는 x64를 선택하세요. Debian, Ubuntu 등 deb 패키지 체계를 사용하는 배포판은 deb를, RPM 패키지 체계를 사용하는 배포판은 rpm을 선택하고 현재 배포판이 패키지 종속성을 충족하는지 확인하세요. ARM 데스크톱 기기는 아래의 arm64 파일을 사용하세요.
패키지 형식이 맞더라도 모든 배포판에 설치할 수 있는 것은 아닙니다. 종속성을 충족할 수 없다면 패키지 관리자의 안내를 먼저 확인하고 종속성을 강제로 무시하지 마세요.
데스크톱 환경에 따라 시스템 프록시를 읽는 방식이 다를 수 있습니다. 설치 후 클라이언트에서 유효한 설정을 선택하고 수신 대기가 시작됐는지 확인한 다음, 대상 앱이 데스크톱 프록시를 따르는지 살펴보세요. 일부 프로그램은 자체적으로 프록시를 설정해야 하므로 브라우저에서 연결된다고 다른 앱에도 적용되는 것은 아닙니다. TUN은 가상 네트워크 인터페이스와 권한, 라우팅 설정이 필요하므로 기본 연결을 확인한 뒤 활성화하세요.
업그레이드할 때는 기존 설치와 동일한 패키지 관리 방식을 사용하세요. 파일을 직접 복사하는 방식과 패키지 관리자 설치를 번갈아 사용하지 마세요. 사용자 지정 라우팅과 구독을 백업하고 업그레이드 후 로컬 포트와 실행 사용자를 확인하세요. 종속성 충돌이 발생하면 전체 오류 메시지를 기록하고 배포판 버전을 확인하세요. 패키지 확장자를 바꾸거나 다른 배포판의 종속성을 섞어 검사를 우회하는 것은 권장하지 않습니다.
코어와 설정 호환성 참고 보기 →CONFIGURATION / 설치 후 설정 범위
올바른 설치 파일을 받으면 기기에서 실행할 수 있는지 해결됩니다. 연결할 수 있는지는 구독 항목, 코어 기능, 서버 설정, 로컬 프록시 모드에도 달려 있습니다. 문제를 진단할 때는 이 두 단계를 구분해 불필요한 재설치를 피하세요.
Project V 생태계의 그래픽 클라이언트는 주로 설정과 구독 관리, 시스템 연동을 담당하고 실제 프로토콜 처리는 코어가 맡습니다. V2Fly와 Xray는 기술적 뿌리를 공유하지만 이후 기능 발전 방향은 완전히 같지 않습니다. 따라서 v2rayNG와 v2flyNG 중 무엇을 쓸지는 화면이 비슷한지만 볼 게 아니라 설정에 필요한 기능을 기준으로 선택해야 합니다.
REALITY는 보안 계층 메커니즘이지 독립적인 아웃바운드 프로토콜이 아닙니다. 구독에 VLESS가 있다고 해서 연결에 필요한 조건이 모두 갖춰진 것은 아닙니다. 전송 방식, 보안 계층, 인증 매개변수가 모두 일치해야 합니다. VMess와 VLESS의 차이를 알아보려면 프로토콜 기술 참고 자료를 확인하세요.
첫 테스트에서는 클라이언트 하나, 유효성이 확인된 설정 하나, 프록시 모드 하나만 사용하세요. 시스템 시간이 정확한지, 구독 업데이트가 성공했는지, 설정이 선택됐는지 확인한 뒤 접속을 테스트하세요. 프로토콜과 DNS, 라우팅, TUN을 동시에 바꾸면 연결이 복구되더라도 원인을 파악하기 어렵습니다.
publicKey, shortId 등의 항목을 대조해야 합니다. 설치 파일을 바꿔도 이 매개변수가 자동으로 채워지지는 않습니다.
클라이언트는 무료로 사용할 수 있지만 연결에 필요한 리소스는 별도로 설정해야 합니다. 다음 순서는 처음 설치할 때나 기기를 바꾼 뒤 다시 설정할 때 모두 유용합니다.
먼저 설치 파일 선택, 프로그램 실행, 연결 설정의 세 단계를 구분한 뒤 다음 점검 항목을 정하세요.
처음 사용한다면 차세대 크로스 플랫폼 인터페이스를 적용한 Desktop 버전을 선택할 수 있습니다. 기존 조작 방식에 익숙하다면 클래식하고 안정적인 WPF 버전이 적합합니다. 두 버전 모두 v2rayN 클라이언트이며, 구독의 정상 작동 여부는 코어와 설정 항목에도 영향을 받습니다. 인터페이스 버전을 바꾸기 전에 설정을 백업하고 두 프로그램이 동시에 시스템 프록시를 변경하지 않도록 하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 다만 최종적으로는 기기에서 지원하는 앱 아키텍처를 확인하세요. 구형 기기나 오래된 앱 아키텍처만 지원하는 시스템, 아키텍처를 확인하기 어려운 경우에는 범용 버전을 선택할 수 있습니다. 범용 버전은 여러 아키텍처 구성 요소를 포함해 파일 크기가 더 큰 편이며, 연결 성능이 더 좋다는 뜻은 아닙니다.
아니요. 클라이언트는 설정을 저장하고 연결을 시작하며 라우팅을 관리합니다. 설치 파일에는 바로 사용할 수 있는 구독이나 서버 계정이 포함되어 있지 않습니다. 사용 권한이 있는 구독 링크를 가져오거나 서버 정보를 직접 추가한 뒤 구독을 업데이트하고 설정을 선택해야 합니다. 구독 링크에는 접속 인증 정보가 포함될 수 있으므로 공개적으로 공유하지 마세요.
먼저 구독 그룹, 사용자 지정 라우팅, DNS 설정, 필요한 수동 서버 설정을 저장한 뒤 기존 클라이언트를 종료하세요. 클라이언트에 내보내기나 백업 기능이 있다면 이를 우선 사용하고, 이전 후 설정이 온전히 옮겨졌는지 확인하세요. 백업에 접속 인증 정보가 포함될 수 있으므로 신뢰할 수 있는 위치에 보관하세요. 기존 폴더의 파일 전체를 새 프로그램에 그대로 덮어쓰지 마세요.
먼저 시스템과 설치 파일의 아키텍처가 맞는지 확인한 다음, 시스템 메시지에 표시된 누락 종속성을 살펴보세요. Windows는 x64와 기타 아키텍처를, macOS는 Apple Silicon과 Intel을 구분해야 합니다. Linux에서는 deb와 rpm도 확인하세요. 실행 환경 요구 사항은 빌드마다 달라질 수 있으므로 현재 설치 안내를 따르고, 출처가 불분명한 복구 도구를 반복해서 설치하지 마세요.
먼저 설치 파일을 바꾸는 것은 권장하지 않습니다. 클라이언트가 정상적으로 실행된다면 구독 유효성, 선택한 서버 설정, 시스템 시간, 시스템 프록시 또는 VPN 권한이 제대로 적용됐는지부터 확인하세요. REALITY를 사용하는 경우 publicKey, shortId와 서버 설정도 대조해야 합니다. 클라이언트와 프로토콜, DNS를 한꺼번에 바꾸기보다 로그를 확인하며 하나씩 점검하는 편이 원인을 찾기 쉽습니다.