먼저 운영체제를 고른 다음 아키텍처를 선택하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 권장하며 v2flyNG는 코어 대안으로 선택할 수 있습니다.
두 설치 항목 모두 x64 시스템용입니다. 처음 설치한다면 데스크톱 버전을, 클래식한 사용 방식이 익숙하다면 WPF 버전을 선택하세요.
차세대 크로스 플랫폼 UI로, 처음 사용하는 경우나 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하려는 경우에 적합합니다.
안정적인 클래식 버전으로 WPF 인터페이스를 사용합니다. 기존 서버 목록과 설정 레이아웃에 익숙한 사용자에게 적합합니다.
다운로드 파일은 ZIP 압축 파일입니다. 먼저 전체 압축을 푼 뒤 압축 파일 내부 구조에 맞춰 설치 프로그램을 실행하세요. 압축 파일 미리보기 창에서 바로 실행하지 마세요.
| 확인 항목 | 선택 기준 | 안내 |
|---|---|---|
| 시스템 아키텍처 | x64 Windows | ‘설정 → 시스템 → 시스템 정보’에서 시스템 종류를 확인하세요. PC 브랜드만으로 판단하지 마세요. |
| 시스템 호환성 | 현재 릴리스가 지원하는 Windows | Windows 버전 및 실행 환경 요구 사항은 설치 프로그램과 릴리스 안내를 따릅니다. 오래된 시스템은 먼저 호환성을 확인하세요. |
| 설치 환경 | 쓰기 가능한 폴더와 충분한 저장 공간 | 압축을 완전히 푼 뒤 안내에 따라 실행 환경을 준비하세요. 두 인터페이스 버전의 프로그램 파일을 같은 폴더에 덮어쓰지 마세요. |
| 권한 범위 | 일반 사용과 TUN은 별도로 설정 | 일반 설정에는 미리 관리자 권한이 필요하지 않습니다. 가상 네트워크 어댑터 기능을 사용할 때 클라이언트 안내에 따라 필요한 권한을 부여하세요. |
데스크톱 버전과 WPF 버전의 가장 큰 차이는 인터페이스 프레임워크입니다. 이를 근거로 특정 버전이 어떤 프로토콜에서 반드시 더 빠르다고 판단해서는 안 됩니다. 실제 프로토콜 지원 여부는 선택한 코어와 버전에 따라 달라집니다. 기존 설정을 이전하려면 내보내기 또는 백업 기능으로 서버, 구독 그룹, 라우팅 규칙을 먼저 보존한 뒤 새 인터페이스에서 가져오세요. 프로그램 파일 복사만으로 데이터 이전이 끝난다고 생각하지 마세요.
설치가 끝나면 클라이언트가 정상적으로 실행되는지 확인한 뒤 설정을 가져오세요. 브라우저에서 프록시를 사용하려면 시스템 프록시 상태를 확인하고, 시스템 프록시를 따르지 않는 앱의 트래픽까지 처리하려면 TUN 모드를 검토하세요. 두 기능의 트래픽 처리 범위는 다릅니다. 설치가 완료됐다고 모든 앱의 트래픽이 이미 바뀐 것은 아닙니다.
‘이 Mac에 관하여’에서 프로세서를 확인하세요. Apple Silicon과 Intel은 아키텍처가 다르므로 하드웨어에 맞는 설치 파일을 선택하는 것이 좋습니다.
Apple M 시리즈 칩용입니다. ‘이 Mac에 관하여’의 ‘칩’ 항목에서 기기를 확인하세요.
Intel 프로세서 탑재 기기용입니다. 기기 정보에 Intel이라고 표시되면 이 설치 파일을 선택하세요.
DMG를 연 뒤 창의 안내에 따라 ‘응용 프로그램’ 폴더에 설치하세요. 처음 실행할 때 표시되는 권한 및 네트워크 관련 안내를 각각 확인하세요.
| 확인 항목 | 선택 기준 | 안내 |
|---|---|---|
| Apple Silicon | ARM64 DMG | 기기 정보에 Apple M 시리즈 칩이 표시되면 해당 네이티브 아키텍처 패키지를 선택하세요. |
| Intel 프로세서 | x64 DMG | 기기 정보에 Intel이라고 표시되면 해당 패키지를 선택하세요. 기기 외관으로 아키텍처를 판단하지 마세요. |
| 시스템 버전 | 현재 릴리스의 요구 사항 충족 | 시스템이 오래됐다는 안내가 표시되면 호환성 요구 사항을 먼저 확인하세요. 같은 패키지를 다시 다운로드해도 시스템 제한은 바뀌지 않습니다. |
| 기능 권한 | 필요한 기능에만 권한 부여 | TUN을 사용하려면 추가 승인이 필요할 수 있습니다. 앱 설치와 가상 네트워크 어댑터 활성화는 별개의 단계입니다. |
Mac이라고 해서 모두 같은 바이너리 프로그램을 사용할 수 있는 것은 아닙니다. 일반적으로 네이티브 아키텍처 패키지를 선택하는 것이 가장 간단하며, 이전 설치 방식을 유지하려고 다른 아키텍처 패키지를 우선 선택하지 마세요. 설치가 끝나면 ‘응용 프로그램’에서 실행해 정상 작동을 확인한 뒤 구독을 가져오고 라우팅을 설정하세요. 이렇게 하면 설치 문제와 연결 문제를 구분해 점검할 수 있습니다.
시스템에서 앱 실행을 차단하면 안내에 표시된 원인을 먼저 확인하세요. 출처 제한, 호환성, 권한 중 무엇이 문제인지 파악한 다음 시스템에서 제공하는 앱별 설정으로 처리하세요. 기기 전체의 보안 기능을 바로 끄지 마세요. 다른 아키텍처의 칩을 탑재한 컴퓨터로 바꾸더라도 지원되는 내보내기 기능으로 설정을 옮길 수 있지만, 프로그램은 새 기기에 맞는 설치 파일로 다시 설치해야 합니다.
v2rayNG를 우선 사용하세요. V2Fly 코어가 필요한 경우 v2flyNG를 선택하세요. 두 앱 모두 프로토콜 및 구독 호환성을 각각 확인해야 합니다.
2015년 이후 출시된 대부분의 휴대전화에서 우선 선택할 수 있습니다. 단, 시스템이 64비트 ARM 앱을 지원하는지 확인하세요.
더 다양한 프로세서 아키텍처를 지원하므로 아키텍처를 알기 어렵거나 여러 기기에서 사용해야 할 때 적합합니다.
Android VPN 인터페이스를 통해 트래픽을 처리하며, 처음 연결할 때 시스템 권한을 확인해야 합니다.
64비트 ARM 앱을 지원하는 기기용으로, V2Fly 코어 호환성이 필요한 설정에 적합합니다.
프로세서 아키텍처를 확인하기 어려울 때 고려할 수 있습니다. 설치 가능 여부는 시스템 버전 등에도 좌우됩니다.
Xray 전용 기능이 V2Fly에서도 지원된다고 단정하지 마세요. 가져오기 전에 설정에 필요한 기능을 확인하세요.
| 확인 항목 | 선택 기준 | 안내 |
|---|---|---|
| 프로세서 및 시스템 | arm64 또는 범용 버전 | 휴대전화 프로세서가 64비트를 지원하더라도 시스템이 64비트 앱을 지원한다는 뜻은 아닙니다. 기기의 시스템 지원 여부를 확인하세요. |
| 설치 권한 | 설치 파일을 여는 앱에 권한 부여 | APK를 여는 브라우저나 파일 관리자에만 필요한 권한을 부여하고, 설치 후에는 권한을 해제할 수 있습니다. |
| 시스템 호환성 | 앱의 현재 요구 사항 충족 | 패키지를 파싱할 수 없다면 시스템 버전과 아키텍처, 남은 저장 공간, 다운로드 완료 여부를 확인하세요. |
| 트래픽 처리 | Android VPN 권한 | 일반적으로 VPN 인터페이스를 사용하는 앱은 한 번에 하나만 활성화할 수 있습니다. 다른 네트워크 도구가 사용 중인지 확인하세요. |
APK는 앱 설치 파일입니다. 설치 후에는 구독이나 서버 정보를 가져와야 합니다. 처음 연결할 때 시스템에서 VPN 연결을 허용할지 묻는데, 이 권한은 기기 내 트래픽을 처리할 수 있도록 하는 것이며 사용 가능한 서버에 연결됐다는 뜻은 아닙니다. 먼저 선택한 설정을 확인한 뒤 알림 표시줄과 클라이언트 로그를 점검하세요. 권한을 허용한 것과 연결을 확인한 것을 혼동하지 마세요.
arm64 패키지는 여러 아키텍처를 포함한 범용 패키지보다 용량이 작은 편이지만, 패키지 크기로 기능의 완전성을 판단할 수는 없습니다. 설치 중 기존 앱과 충돌한다는 안내가 표시되면 같은 앱인지, 서명 출처가 같은지 먼저 확인하고 설정을 백업한 뒤 처리하세요. 원인을 모른 채 앱을 삭제하지 마세요. 로컬에 저장된 구독, 서버, 라우팅 설정도 함께 삭제될 수 있습니다.
모바일 운영체제의 백그라운드 제한은 연결 유지에 영향을 줄 수 있습니다. 화면이 꺼진 뒤 연결이 끊기거나 앱이 백그라운드에서 종료되는 문제가 실제로 발생할 때만 배터리 최적화와 백그라운드 실행 권한을 확인하세요. 설치 단계에서 모든 권한을 한꺼번에 허용할 필요는 없습니다. v2rayNG와 v2flyNG는 각각 호환성 확인에 사용할 수 있지만, 현재 적용 중인 설정을 혼동하지 않도록 두 앱의 트래픽 처리를 동시에 켜지 마세요.
먼저 배포판의 패키지 체계에 따라 deb 또는 rpm을 선택한 뒤 프로세서가 x64인지 ARM64인지 확인하세요. 배포판 종류와 프로세서 아키텍처는 서로 별개의 조건입니다.
Debian, Ubuntu 계열 등 deb 패키지 체계를 사용하는 호환 배포판용입니다.
해당 패키지의 의존성 요구 사항을 충족하는 rpm 계열 배포판용입니다. 설치 전에 시스템 호환성을 확인하세요.
시스템 패키지 설치 프로그램으로 해당 패키지를 여세요. 파일 확장자가 같더라도 모든 배포판에서 의존성과 실행 환경이 충족되는 것은 아닙니다.
| 확인 항목 | 선택 기준 | 안내 |
|---|---|---|
| 그래픽 환경 | 데스크톱 앱을 실행할 수 있는 시스템 | 이 페이지에서는 로컬 데스크톱에서 사용하는 그래픽 클라이언트를 제공합니다. 서버 서비스용 패키지로 설치하지 마세요. |
| 패키지 관리 체계 | deb 또는 rpm | 배포판의 기본 패키지 체계에 맞는 형식을 선택하고, 수동으로 패키지를 섞어 설치하기보다 시스템 설치 프로그램에서 의존성을 확인하세요. |
| 프로세서 아키텍처 | x64 또는 ARM64 | x64는 amd64 또는 x86_64로, ARM64는 arm64 또는 aarch64로 표시되기도 합니다. |
| 실행 의존성 | 패키지에서 지정한 요구 사항 충족 | 의존성을 충족하지 못하면 배포판 버전과 패키지 호환 범위를 먼저 확인하세요. 의존성을 무시하고 설치하지 마세요. |
deb와 rpm은 소프트웨어 패키지 형식을 나타낼 뿐, 프록시 프로토콜 지원 기능을 직접 결정하지 않습니다. 두 배포판이 모두 rpm을 사용하더라도 기반 라이브러리와 의존성 버전이 달라 같은 패키지를 설치하지 못할 수 있습니다. 설치 프로그램에서 의존성 오류가 발생하면 오류 내용을 보관하고 시스템 버전과 아키텍처를 확인하세요. 확장자를 바꾸거나 파일 이름을 변환해 해결하려고 하지 마세요.
설치가 끝나면 데스크톱 앱 메뉴에서 v2rayN을 실행하고 일반 사용자 권한으로 설정을 가져오세요. 시스템 프록시가 앱에 적용되는지는 데스크톱 환경과 앱의 프록시 지원 여부에 따라 달라집니다. TUN을 사용하려면 추가 네트워크 권한과 라우팅 설정이 필요합니다. 먼저 일반 프록시를 확인한 뒤 필요할 때 TUN을 켜고 문제 범위를 단계적으로 좁히세요. DNS, 라우팅, 권한을 한꺼번에 바꾸면 원인을 찾기 어려워집니다.
프로그램 설치, 설정 가져오기, 트래픽 처리를 각각 확인하세요. 각 단계가 정상적으로 끝난 뒤 다음 단계로 진행하세요.
클라이언트는 연결 대상을 제공하지 않습니다. 이용 권한이 있는 구독을 확보한 뒤 구독 그룹에 주소를 추가하고 업데이트하세요. 공유 링크가 하나뿐이라면 클라이언트의 클립보드 가져오기 기능을 사용하세요. 구독 링크에는 계정 정보가 포함될 수 있으므로 민감한 데이터로 취급하고 공개 게시판이나 스크린샷에 노출하지 마세요.
가져온 뒤 프로토콜 종류와 전송 방식, 보안 계층이 제대로 인식됐는지 확인하세요. VLESS, VMess, Trojan은 서로 다른 설정 유형이므로 이름만 바꿔 서로 변환할 수 없습니다. 생소한 항목이 있다면 설정 제공자의 안내와 선택한 코어의 지원 범위를 확인하고, 이름이 비슷하다는 이유로 값을 임의로 입력하지 마세요.
프로토콜 및 코어 기술 참고 자료 보기 →목록에서 사용할 서버를 선택한 뒤 시스템 프록시를 켜거나 모바일 연결을 시작하세요. 시스템 프록시는 시스템 프록시 설정을 따르는 앱을 주로 처리하고, TUN은 가상 네트워크 인터페이스를 통해 더 넓은 범위의 트래픽을 처리합니다. 둘은 단순한 속도 설정이 아닙니다. 필요한 범위를 충족하는 최소한의 방식부터 사용하고 앱 동작에 따라 조정하세요.
연결을 확인할 때는 원하는 사이트에 접속되는지뿐 아니라 클라이언트 로그와 라우팅 규칙이 적용되는지도 살펴보세요. 목록의 지연 시간 테스트만으로 전체 접속이 정상이라고 판단할 수 없으며, 한 번의 실패만으로 설치 파일을 원인으로 지목해서도 안 됩니다. 설정, 서버, DNS, 라우팅, 앱의 프록시 설정 순서로 확인하면 반복해서 재설치하는 것보다 원인을 찾기 쉽습니다.
단계별 첫 연결 방법 보기 →프로그램 업데이트와 데이터 이전은 별개입니다. 인터페이스, 기기 또는 코어를 바꾸기 전에 설정 저장 방식을 확인하세요.
먼저 클라이언트에서 지원하는 내보내기 또는 백업 기능을 사용해 구독 그룹, 수동으로 추가한 서버, 사용자 지정 라우팅을 보존하세요. 구독을 다시 가져올 수 있다고 해서 수동으로 수정한 항목까지 자동으로 복구되는 것은 아닙니다. 사용 중인 코어, DNS 정책, 시스템 프록시 모드, TUN 설정도 기록해 두면 업데이트 후 하나씩 대조할 수 있습니다.
파일이 사용 중이지 않도록 업데이트를 시작하기 전에 클라이언트를 종료하세요. 설치 방식에 따라 사용자 데이터 저장 위치가 다를 수 있으므로 프로그램을 제거해도 설정이 반드시 남는다고 가정하지 말고, 프로그램 폴더 복사만으로 전체 백업이 끝났다고 생각하지도 마세요. 새 기기로 이전할 때는 신뢰할 수 있는 방법으로만 설정 파일을 옮기고 민감한 내용은 안전하게 보관하세요.
업데이트된 클라이언트를 처음 실행하면 구독 그룹과 서버 목록이 남아 있는지 확인한 다음 활성 서버와 기본 라우팅, 시스템 프록시 상태를 점검하세요. 코어 업데이트로 설정 항목이나 동작 방식이 바뀔 수 있습니다. 설정을 가져올 수 있다고 모든 기능이 이전과 동일하게 작동하는 것은 아니므로 로그와 실제 접속으로 확인하세요.
특정 앱에서만 문제가 발생한다면 설치 파일을 바꾸기 전에 해당 앱이 시스템 프록시를 따르는지 확인하세요. 같은 구독을 가져왔는데 두 클라이언트의 동작이 다르다면 코어 지원 범위와 구독 해석 방식을 비교하세요. 설정이 제대로 복구되고 연결이 정상인지 확인한 뒤 이전 설치 파일과 임시로 내보낸 민감한 데이터를 정리하세요.
설치 파일 선택, 시스템 권한, 업데이트와 백업 방법을 안내합니다.
클라이언트는 설정과 트래픽 전달을 관리하며, 설치 파일에 사용할 수 있는 서버가 포함되지는 않습니다. 이용 권한이 있는 서버 설정이나 구독을 직접 준비해 가져온 다음 서버를 선택하고 시스템 프록시 또는 TUN 모드를 설정해야 합니다. 구독 주소는 민감한 정보이므로 공개하지 마세요.
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 데스크톱 버전을 권장합니다. 클래식 레이아웃과 기존 조작 방식에 익숙하다면 WPF 버전을 선택하세요. 두 버전은 메뉴 위치와 설정 저장 방식이 다를 수 있으므로 이전하기 전에 설정을 내보내고, 프로그램 폴더를 그대로 섞어 사용하지 마세요.
arm64 패키지는 64비트 ARM 앱을 지원하는 기기용이며, 2015년 이후 출시된 대부분의 휴대전화에서 우선 선택할 수 있습니다. 범용 버전은 더 다양한 프로세서 아키텍처를 지원하지만 용량이 더 큰 편입니다. 기기 출시 연도만으로 아키텍처를 단정할 수는 없습니다. arm64를 설치할 수 없다면 먼저 시스템의 64비트 앱 지원 여부를 확인한 뒤 범용 버전을 고려하세요.
먼저 운영체제 종류, 프로세서 아키텍처, 저장 공간, 시스템 호환성을 확인한 뒤 경고의 구체적인 원인을 살펴보세요. Android에서는 설치 파일을 실제로 여는 앱에만 필요한 설치 권한을 부여하고, 데스크톱에서는 앱별 안내에 따라 처리하세요. 설치를 위해 기기 전체의 보안 기능을 끄거나 원인을 모른 채 설치를 계속 강행하지 마세요.
먼저 클라이언트에서 설정을 내보내거나 백업하고, 사용 중인 코어와 라우팅 구성, DNS 설정을 기록하세요. 그런 다음 클라이언트를 종료하고 업데이트합니다. 프로그램 폴더에 모든 사용자 데이터가 있다고 단정하지 마세요. 업데이트 후에는 구독 그룹, 활성 서버, 시스템 프록시, TUN 상태를 확인하고 연결이 정상인지 점검한 뒤 이전 파일을 정리하세요.
페이지의 버전 표시와 다운로드 주소는 버전 목록의 서로 다른 항목을 참조하므로 목록이 갱신되는 동안 잠시 다를 수 있습니다. 파일 이름은 패키지 종류를 확인하는 용도일 뿐, 설치된 버전을 판단하는 근거로 삼아서는 안 됩니다. 설치 후 클라이언트의 정보 화면에서 실제 버전을 확인하세요. 차이가 있다면 앱 이름과 플랫폼, 아키텍처부터 확인하세요.