먼저 운영체제를 선택한 다음 CPU 아키텍처를 확인하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 권장합니다. V2Fly 코어가 필요한 경우 v2flyNG를 고려하세요.
설치 후 구독이나 서버 설정을 가져와야 합니다. 처음 사용한다면 사용 설명서 →를 먼저 확인하세요.
기본 다운로드는 가장 많이 사용하는 아키텍처용입니다. 다른 아키텍처와 UI 버전은 바로 옆에서 확인할 수 있습니다.
Desktop 버전은 차세대 크로스 플랫폼 UI를 사용하며, 클래식 WPF 버전은 익숙한 Windows 인터페이스를 유지합니다. 두 설치 파일 모두 x64 압축 파일입니다. 다운로드한 뒤 압축을 풀고 안에 있는 설치 프로그램을 실행하세요.
처음 설치한다면 Desktop을 선택하세요. 기존 레이아웃을 선호한다면 안정적인 클래식 WPF 버전을 사용할 수 있습니다. 로컬 포트 충돌을 피하려면 두 클라이언트를 동시에 실행하지 마세요.
| 확인 항목 | 설치 전 확인 사항 |
|---|---|
| 운영체제 | 시스템 업데이트를 계속 지원하는 Windows 10 또는 Windows 11을 권장합니다. |
| CPU | 이 페이지에서는 x64 설치 파일을 제공합니다. ARM 기기는 호환성을 별도로 확인하세요. |
| 실행 구성 요소 | 설치 프로그램에서 런타임이 없다고 안내하면 해당 구성 요소를 추가로 설치하세요. |
| 권한 | 일반 시스템 프록시와 TUN 모드는 필요한 권한이 다릅니다. 필요한 기능에 맞춰 활성화하세요. |
설정 → 시스템 → 시스템 정보에서 시스템 종류를 확인하세요. 기기 브랜드만 보고 아키텍처를 판단하지 마세요. 설치 디렉터리에 쓰기 공간이 충분한지 확인하고, 압축 파일을 열어 둔 창에서 바로 프로그램을 실행하지 마세요.
실행 중인 기존 클라이언트를 종료한 다음 다운로드한 파일의 압축을 풀고 설치 프로그램을 실행하세요. 안내에 따라 설치 위치를 선택하고 설치가 끝나면 시작 메뉴에서 v2rayN을 실행합니다. 시스템 보안 경고가 표시되면 파일 출처와 경고 내용을 먼저 확인하세요. 설치를 계속하기 위해 시스템 보호 기능 전체를 끄지 마세요. 런타임 구성 요소가 없다는 안내가 나오면 구성 요소 이름과 아키텍처를 기록한 뒤 설치 프로그램의 지침에 따라 처리하세요.
메인 창에서 구독 그룹 → 구독 그룹 설정을 열고 별칭과 구독 주소를 입력하세요. 저장한 뒤 해당 그룹의 구독을 업데이트합니다. 목록에 항목이 표시되어도 가져오기만 완료된 상태이므로, 사용 가능한 서버를 선택하고 시스템 프록시 자동 구성을 설정해야 합니다. 메뉴 위치는 UI 버전에 따라 달라질 수 있습니다. 차이가 있다면 구독 가져오기 안내를 참고해 항목별로 확인하세요.
WPF 버전에서 Desktop으로 전환하기 전에 기존 그룹, 사용자 지정 라우팅, 기타 설정을 백업하세요. 두 프로그램이 같은 사용자 데이터를 공유한다고 단정하지 마세요. 새 인터페이스를 처음 실행한 뒤 구독이 모두 있는지, 서버가 올바른지, 시스템 프록시 모드가 의도한 대로인지 확인하세요. 그런 다음 기존 프로그램을 종료하고 평소처럼 사용하면 됩니다.
칩에 맞는 DMG를 선택하세요. M 시리즈 칩에는 Apple Silicon 설치 파일을, 이 Mac에 관하여에서 Intel 프로세서로 표시되는 경우에는 Intel 설치 파일을 사용하세요.
Apple 메뉴에서 이 Mac에 관하여를 열어 칩 종류를 확인하세요. 같은 운영체제라도 CPU 아키텍처가 다를 수 있습니다.
| 확인 항목 | 설치 전 확인 사항 |
|---|---|
| 운영체제 버전 | 업데이트가 제공되는 macOS를 사용하세요. 최소 버전은 앱 설치 시 표시되는 안내를 기준으로 합니다. |
| Apple Silicon | M 시리즈 칩에는 arm64 DMG를 사용하세요. |
| Intel | Intel 프로세서에는 x64 DMG를 사용하세요. |
| 시스템 권한 | 네트워크 기능을 처음 사용할 때 표시되는 시스템 권한 안내를 읽고 승인하세요. |
칩과 기본적으로 호환되는 설치 파일을 우선 선택하고, 변환 실행을 기본 해결책으로 삼지 마세요. 앱이 실행되지 않으면 아키텍처, 운영체제 버전, 시스템에 표시된 오류 내용을 먼저 확인하세요.
DMG를 연 다음 창의 안내에 따라 앱을 응용 프로그램 폴더로 옮기고 해당 폴더에서 실행하세요. 디스크 이미지 안에서 계속 실행하지 마세요. 설치가 끝나면 디스크 이미지를 꺼내 이전 사본을 실수로 실행하지 않도록 하세요. 다른 버전이 이미 설치되어 있다면 기존 앱을 종료하고 설정을 백업한 뒤 교체하세요.
처음 실행할 때 시스템에서 차단하면 경고창을 먼저 읽고 시스템 설정 → 개인정보 보호 및 보안에서 관련 기록을 확인하세요. 앱 출처를 신뢰할 수 있다고 확인한 경우에만 시스템에서 제공하는 방법으로 계속 진행하세요. 출처를 알 수 없는 명령으로 보안 설정을 일괄 변경하지 말고, 시스템 수준의 네트워크 권한을 구독 계정과 혼동하지 마세요.
구독을 가져온 뒤 먼저 일반 시스템 프록시로 브라우저 접속을 확인하고, 추가 권한이 필요한 TUN 등의 기능은 그다음에 사용하세요. 브라우저는 되지만 다른 앱이 연결되지 않는다면 앱이 시스템 프록시를 따르는지 먼저 확인하세요. 반복해서 재설치할 필요는 없습니다. 데스크톱 UI 사용법은 전체 매뉴얼의 프록시 모드 항목을 참고하세요.
Xray 코어를 사용하는 Android용 그래픽 클라이언트입니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하세요. 기기 아키텍처가 불분명하거나 전용 설치 파일을 사용할 수 없다면 범용 버전을 고려하세요.
범용 버전은 더 많은 아키텍처를 지원하지만 파일 크기가 더 큰 경우가 많습니다. 실제 호환 여부는 운영체제 버전과 기기의 앱 실행 환경에 따라 달라집니다.
V2Fly 코어가 필요한 설정 환경에 적합합니다. 선택하기 전에 서버에서 사용하는 프로토콜과 전송 방식을 확인하세요. 두 Android 클라이언트는 인터페이스가 비슷하다고 해서 완전히 같은 기능을 제공하는 것은 아닙니다.
설정 호환성을 먼저 확인한 뒤 전환 여부를 결정하세요. Xray 전용 기능을 사용하는 설정이라면 코어의 지원 여부를 확인해야 합니다.
| 확인 항목 | 선택 안내 | 주요 영향 |
|---|---|---|
| 운영체제 버전 | 현재 APK 설치 프로그램에 표시되는 최소 요구 사항을 기준으로 하세요. | 오래된 운영체제에서는 설치 파일을 인식하지 못할 수 있습니다. |
| 아키텍처 | 대부분의 64비트 기기는 arm64를 우선 선택하세요. 확실하지 않으면 기기 사양을 확인하세요. | 아키텍처가 맞지 않으면 설치에 실패할 수 있습니다. |
| 설치 권한 | 이번 설치에 사용할 브라우저나 파일 관리자에만 필요한 권한을 부여하세요. | 설치 출처별로 권한을 관리합니다. |
| 네트워크 연결 권한 | 처음 연결할 때 시스템의 VPN 연결 요청을 확인하세요. | 다른 VPN 앱이 같은 연결 채널을 사용 중일 수 있습니다. |
다운로드한 APK를 파일 관리자에서 열고 시스템 안내에 따라 현재 출처의 앱 설치를 허용하세요. 실제로 사용할 설치 출처에만 권한을 부여하고 다른 앱까지 허용할 필요는 없습니다. 설치가 끝나면 클라이언트를 열고 신뢰할 수 있는 출처에서 받은 구독이나 공유 링크를 가져오세요. 처음 연결하면 시스템에 VPN 연결 요청이 표시됩니다. 승인한 뒤 로컬 트래픽을 처리하는 연결이 설정됩니다.
설치 프로그램에서 서명이 일치하지 않는다고 표시되면 기기에 다른 배포 경로에서 설치한 같은 이름의 앱이 있는지 먼저 확인하세요. 경고를 우회하려고 바로 삭제하지 마세요. 삭제하면 로컬 설정이 사라질 수 있습니다. 구독과 개인 규칙을 백업한 다음 기존 배포 경로에서 업데이트할지 새 설치 파일로 옮길지 결정하세요. 범용 버전은 일부 아키텍처 선택 문제를 해결할 수 있지만 서명 충돌이나 낮은 운영체제 버전 문제는 해결하지 못합니다.
연결된 뒤 백그라운드로 전환하자마자 끊긴다면 시스템의 배터리 관리가 클라이언트의 백그라운드 실행을 제한하는지 확인하고 다른 VPN 앱을 동시에 실행 중인지도 살펴보세요. v2rayNG와 v2flyNG는 설정 및 연결 관리 도구이며 구독 서비스를 제공하지 않습니다. 기존 설정과 코어가 잘 맞는지를 기준으로 선택하세요. 자세한 차이는 클라이언트 선택 가이드에서 확인할 수 있습니다.
배포판에 맞춰 deb 또는 rpm을 선택한 다음 CPU 아키텍처를 확인하세요. 일반적인 Intel·AMD 데스크톱은 x64를 선택하고, ARM 데스크톱은 아래의 arm64 링크를 이용하세요.
deb와 rpm은 소프트웨어 패키지 형식이지, 프록시 모드가 아닙니다. 의존성은 배포판의 패키지 설치 프로그램으로 처리하세요.
| 확인 항목 | 설치 전 확인 사항 |
|---|---|
| 데스크톱 환경 | 그래픽 앱을 실행할 수 있는 데스크톱 세션이 필요합니다. |
| deb 패키지 | deb 패키지 관리 방식을 사용하는 호환 배포판에서 사용할 수 있습니다. |
| rpm 패키지 | 배포판과 패키지 의존성 및 런타임 라이브러리 요구 사항이 맞아야 합니다. |
| CPU | amd64와 x86_64는 x64, aarch64는 arm64에 해당합니다. |
패키지 확장자가 같아도 모든 배포판과 호환되는 것은 아닙니다. 설치 프로그램에서 의존성 부족을 알리면 누락된 구성 요소와 운영체제 버전을 기록하세요. 의존성을 무시하도록 강제로 설치하지 마세요.
시스템 설정의 정보 페이지에서 CPU와 배포판 정보를 확인하세요. 알맞은 패키지를 다운로드한 다음 시스템 패키지 설치 프로그램으로 열어 설치를 완료합니다. 시스템 소프트웨어 디렉터리에 파일을 쓰기 위해 설치 프로그램이 관리자 권한을 요청하는 것은 정상입니다. 하지만 편의를 위해 매번 그래픽 클라이언트 전체를 관리자 권한으로 실행해서는 안 됩니다.
실행한 다음 설정을 가져오고 데스크톱 환경의 네트워크 프록시 설정을 확인하세요. 시스템 프록시를 지원하는 범위는 데스크톱 환경마다 다르며 브라우저, 데스크톱 앱, 터미널이 서로 다른 프록시 설정을 사용할 수도 있습니다. 따라서 브라우저는 연결되지만 터미널은 연결되지 않는다고 해서 서버를 사용할 수 없다고 단정할 수 없습니다. 요청이 클라이언트에 도달하는지 확인한 뒤 라우팅과 원격 연결을 점검하세요.
TUN 모드는 시스템 네트워크 인터페이스와 권한을 사용하므로 일반 프록시가 정상적으로 작동하는지 확인한 뒤 별도로 활성화하는 것이 좋습니다. 설정을 바꾸기 전에 기존 값을 기록해 두고, 네트워크 관리 도구끼리 동시에 라우팅을 변경하지 않도록 하세요. 주로 사용하는 브라우저에만 프록시를 적용하려는 경우 기본 설정만 완료하면 됩니다. 설치 단계에서 모든 기능을 한꺼번에 켤 필요는 없습니다.
설치, 가져오기, 연결 확인을 단계별로 진행하면 문제를 더 쉽게 찾을 수 있습니다.
신뢰할 수 있는 출처에서 구독 주소를 받은 뒤 구독 그룹에 입력하세요. 구독 링크에 접속 정보가 포함될 수 있으므로 전체 링크를 공개 게시판이나 스크린샷에 올리지 마세요. 저장한 뒤 업데이트하고 로그에 성공 결과가 표시되는지 확인하세요. 목록이 비어 있다면 주소와 업데이트 상태부터 점검하세요.
구독 가져오기 방법 보기 →사용 가능한 서버를 먼저 선택한 뒤 시스템 프록시를 활성화하세요. 시스템 프록시는 시스템 설정을 따르는 앱의 트래픽을 클라이언트로 전달하고, 라우팅 규칙은 전달된 연결의 경로를 결정합니다. 두 설정은 별개의 기능이며 트레이 아이콘만 보고 모든 앱의 트래픽이 처리된다고 판단할 수 없습니다.
시스템 프록시와 라우팅 구분하기 →브라우저로 대상 서비스에 접속하면서 클라이언트 로그를 확인하세요. 지연 시간 테스트 결과는 특정 조건에서 측정한 값일 뿐, 실제 서비스 접속이 정상이라는 뜻은 아닙니다. 요청이 로그에 나타나지 않으면 로컬 프록시 설정을 확인하세요. 요청은 표시되지만 오류가 발생한다면 설정값과 서버 상태를 점검하세요.
연결 확인 단계 보기 →먼저 설치 파일을 확인한 다음 설정과 네트워크를 점검하세요.
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 Desktop 버전을 권장합니다. 기존 레이아웃에 익숙하다면 안정적인 클래식 WPF 버전을 선택하세요. 두 버전 모두 유효한 설정을 가져와야 합니다. 전환하기 전에 설정을 백업하고, 로컬 포트 충돌을 막기 위해 두 버전을 동시에 실행하지 마세요.
Windows에서는 설정의 시스템 정보에서 시스템 종류를 확인하세요. macOS에서는 Apple 메뉴의 이 Mac에 관하여에서 칩을 확인할 수 있습니다. Android는 기기 사양을 확인하세요. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택하면 됩니다. Linux에서는 시스템 설정의 정보 페이지에서 CPU 아키텍처를 확인하세요. 실제 기기 정보를 기준으로 선택해야 합니다.
클라이언트 설치 파일에는 서버 연결 설정이 포함되어 있지 않습니다. 신뢰할 수 있는 출처에서 구독 주소나 공유 링크를 받은 뒤 구독 그룹 설정에 저장하고 업데이트하세요. 서버를 선택하고 시스템 프록시를 설정한 다음 로그와 실제 접속 결과를 확인하면 됩니다.
먼저 설치 파일의 아키텍처가 기기와 맞는지 확인하고 저장 공간과 해당 설치 출처에 부여된 권한도 점검하세요. 서명 충돌이 표시되면 기존 설정을 백업하고 설치된 앱의 출처를 확인하세요. 바로 삭제하지 마세요. arm64 버전이 맞지 않으면 범용 버전을 시도해 볼 수 있습니다.
업데이트하기 전에 구독 그룹, 라우팅 규칙, 사용자 지정 설정을 백업하세요. 같은 출처에서 정상적으로 업그레이드하면 대개 설정이 유지되지만, 설치 방법이나 사용자 디렉터리, 앱 서명이 바뀌면 데이터 위치가 달라질 수 있습니다. 업데이트 후 구독 그룹과 프록시 모드를 확인한 다음 평소처럼 사용하세요.
버전 표기와 다운로드 링크는 서로 다른 시점에 업데이트될 수 있습니다. 페이지의 버전 표기는 참고용이므로 실제 설치 버전을 판단하는 유일한 기준으로 삼지 마세요. 설치 후 클라이언트의 정보 화면에서 버전을 확인하세요. 기존 환경을 유지해야 한다면 설정을 백업하고 현재 버전을 기록한 뒤 업그레이드 여부를 결정하세요.