데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. 먼저 운영체제와 프로세서를 확인한 다음 알맞은 설치 파일을 다운로드하세요.
클라이언트는 무료로 제공되며 소스 코드가 공개되어 있습니다. 연결에 사용할 구독 또는 노드 설정은 별도로 준비해야 하며, 프로토콜 지원 여부는 선택한 코어와 설정에 따라 달라집니다.
플랫폼을 선택하면 해당 클라이언트가 표시됩니다. 플랫폼에 맞춰 설치 안내와 시스템 요구 사항도 바뀝니다. 다음에 쉽게 방문할 수 있도록 현재 페이지 주소를 저장해 두세요.
Desktop은 차세대 크로스 플랫폼 UI이고, WPF는 클래식 안정 버전입니다. 처음 설치한다면 Desktop을 먼저 고려하세요. 기존 인터페이스와 사용 방식이 익숙하다면 WPF를 선택할 수 있습니다.
플랫폼 간에 비슷한 사용 경험을 제공하는 인터페이스입니다. ZIP 파일을 다운로드한 뒤 전체 압축을 풀고 안에 있는 설치 프로그램을 실행하세요.
Windows의 클래식 인터페이스를 사용하는 버전으로, 기존 사용 경험이 있는 분에게 적합합니다. 업데이트하거나 인터페이스를 전환하기 전에 기존 구독과 사용자 지정 규칙을 저장하세요.
| 확인 항목 | 선택 기준 | 설치 전 준비 |
|---|---|---|
| 운영체제 및 아키텍처 | 현재 다운로드 항목은 Windows x64 패키지입니다 | 시스템 설정의 ‘정보’ 페이지에서 시스템 종류를 확인하세요. 다른 아키텍처에 이 패키지를 사용하지 마세요. |
| 실행 환경 | 선택한 배포 패키지의 요구 사항에 따라 .NET 등의 종속 항목을 준비하세요 | 실행 환경이 없으면 인터페이스가 시작되지 않을 수 있습니다. 이는 구독 유효성 문제와는 별개입니다. |
| 권한 및 네트워크 | 일반 프록시와 TUN은 필요한 권한이 다릅니다 | 먼저 기본 연결을 확인하세요. TUN이 필요하면 안내에 따라 해당 권한을 부여하세요. |
설치 파일을 로컬에 저장한 다음, 읽기와 쓰기가 가능한 폴더에 압축을 푸세요. 압축 프로그램의 미리보기 창에서 바로 실행하면 함께 필요한 파일이 풀리지 않을 수 있습니다. 설치가 끝나면 클라이언트를 정상적으로 실행하세요. 실행 환경이 없다는 안내가 나오면 구독을 반복해서 가져오지 말고, 안내에 표시된 종속 항목을 먼저 설치하세요.
처음 연결할 때는 트래픽을 전달하는 방식을 하나만 사용하세요. 설정을 가져오고 노드를 선택한 다음 시스템 프록시 자동 설정을 사용해 브라우저가 시스템 설정을 따르는지 확인하세요. 이 단계에서는 TUN을 함께 켤 필요가 없습니다. 일부 앱은 자체 프록시를 사용해 시스템 프록시 변경을 따르지 않으므로 기본 연결이 정상인지 확인한 뒤 별도로 설정하세요.
Desktop과 WPF는 인터페이스 배치가 다를 수 있으므로 예전 스크린샷만 보고 메뉴를 찾지 마세요. 전환하기 전에 유지할 설정을 내보내고 구독 그룹, 라우팅, 로컬 수신 포트를 각각 확인하세요. 설치 폴더를 두 개 모두 유지한다면 평소에는 하나만 실행해 포트와 시스템 프록시 설정이 서로 덮어쓰지 않도록 하세요.
데스크톱 그래픽 인터페이스에서 구독, 노드, 라우팅을 관리할 수 있습니다. ‘이 Mac에 관하여’에서 칩 정보를 확인하고, Apple Silicon은 arm64, Intel 프로세서는 x64를 선택하세요.
Apple Silicon 칩이 탑재된 기기용입니다. 실제 칩에 맞는 네이티브 아키텍처 패키지를 선택하세요. 컴퓨터 외관이나 구입 시기만으로 판단하지 마세요.
| 확인 항목 | 선택 기준 | 설치 전 준비 |
|---|---|---|
| 프로세서 | Apple Silicon은 arm64, Intel은 x64에 해당합니다 | 시스템 메뉴에서 ‘이 Mac에 관하여’를 열어 칩 또는 프로세서 이름을 확인하세요. |
| 운영체제 버전 | 현재 Desktop 배포 패키지의 요구 사항을 충족해야 합니다 | 구형 시스템에서는 앱 호환성 안내를 먼저 확인하세요. 모든 시스템 버전에서 실행된다고 가정하지 마세요. |
| 앱 및 권한 | 로컬 응용 프로그램 폴더에서 실행하고 기능에 필요한 권한을 부여하세요 | 처음 실행할 때 시스템이 차단하면 출처와 시스템 안내를 확인한 뒤 허용 여부를 결정하세요. |
DMG를 연 다음 설치 화면의 안내에 따라 앱을 응용 프로그램 폴더로 옮기고, 해당 폴더에서 실행하세요. 디스크 이미지는 설치용이므로 이미지 안에서 앱을 계속 실행하지 않는 것이 좋습니다. 앱이 시작되면 먼저 구독을 가져오고 목록에 유효한 설정이 표시되는지 확인하세요. 그런 다음 시스템 프록시와 라우팅 프리셋을 설정하고 연결을 단계별로 점검하세요.
시스템 보안 안내와 네트워크 연결 실패는 별도로 해결해야 합니다. 앱을 시작할 때 발생하는 문제는 시스템 설정의 관련 안내를 확인하세요. 클라이언트가 실행된 뒤 연결이 실패한다면 코어 로그와 설정 매개변수를 살펴보세요. 한 번의 확인 절차를 생략하려고 시스템 보안 기능을 전체적으로 끄지 마세요. 권한 문제를 구독 만료 탓으로 돌려서도 안 됩니다.
다른 프록시 도구를 사용한 적이 있다면 전환 전에 기존 도구를 종료하고 시스템 프록시 설정이 남아 있는지 확인하세요. 클라이언트를 종료한 뒤에도 네트워크에 직접 연결되지 않으면 시스템 네트워크 설정의 프록시 항목을 먼저 살펴보세요. 기본 네트워크가 복구되면 새 클라이언트 기능을 하나씩 켜세요. 여러 백그라운드 프로세스가 같은 설정을 동시에 바꾸지 않도록 주의하세요.
Android에서는 우선 추천하는 클라이언트입니다. Android VPN 인터페이스를 통해 트래픽을 처리하며 구독 가져오기와 앱별 설정을 지원합니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택하되, 시스템이 64비트 앱을 지원하는지 확인하세요.
arm64-v8a 아키텍처용입니다. 프로세서와 시스템이 모두 지원한다면 전용 아키텍처 패키지를 우선 사용하세요.
기기 아키텍처를 아직 확인하기 어려울 때 적합합니다. 패키지 크기는 대체로 더 크지만, 설치 후에는 기기에 맞는 구성 요소가 사용됩니다.
v2fly 코어 생태계를 사용해야 할 때 선택할 수 있는 Android 클라이언트입니다. 선택하기 전에 기존 구독의 프로토콜과 전송 매개변수를 해당 코어가 인식할 수 있는지 확인하세요. 코어마다 지원 기능이 완전히 같다고 가정하지 마세요.
64비트 앱을 지원하는 대부분의 Android 기기에서 사용할 수 있습니다. 기존 v2fly 설정을 사용하는 경우 이 아키텍처를 선택하세요.
| 확인 항목 | 선택 기준 | 설치 전 준비 |
|---|---|---|
| 아키텍처 및 시스템 | arm64 패키지를 사용하려면 시스템에서 64비트 앱을 지원해야 합니다 | 하드웨어가 지원하더라도 시스템에서 지원하지 않을 수 있습니다. 확실하지 않다면 기기 정보를 확인하거나 범용 버전을 선택하세요. |
| 설치 권한 | APK를 설치하려면 현재 출처의 앱 설치를 허용해야 합니다 | 사용 중인 브라우저나 파일 관리자에만 필요한 권한을 부여하세요. |
| VPN 인터페이스 | 프록시를 시작할 때 시스템의 VPN 연결 요청을 확인하세요 | VPN 인터페이스를 사용하는 다른 앱과 동시에 실행하지 마세요. |
| 백그라운드 실행 | 절전 정책으로 연결이 끊길 수 있습니다 | 필요에 따라 백그라운드 활동과 배터리 최적화를 설정하고, 재부팅 후 연결 상태를 다시 확인하세요. |
다운로드가 끝나면 알림 창이나 파일 관리자에서 APK를 여세요. 앱이 설치되지 않는다는 안내가 나오면 아키텍처가 맞지 않는지, 시스템 버전이 낮은지, 기존 앱과 새 패키지의 서명이 다른지 먼저 확인하세요. 설정을 보관한 유일한 앱을 바로 삭제하지 마세요. 먼저 구독과 사용자 지정 노드를 내보낸 뒤 재설치 여부를 결정하세요.
처음 프록시를 시작하면 시스템에 VPN 연결 요청이 표시됩니다. 이는 선택한 앱의 트래픽을 로컬 프록시 처리 과정으로 보내기 위한 권한입니다. 설치만으로 원격 서비스가 자동 제공되는 것은 아닙니다. 먼저 설정을 가져오고 노드를 선택한 다음 연결을 허용하세요. VPN 앱을 동시에 사용 중이라면 하나를 먼저 중지해야 합니다.
백그라운드에서 연결이 자주 끊긴다면 시스템이 클라이언트의 백그라운드 활동을 제한하는지, 화면이 꺼진 뒤 네트워크를 중지하는지 확인하세요. 앱별 프록시에서 포함과 제외의 의미도 점검해야 합니다. 적용 범위를 변경한 뒤에는 보통 연결을 다시 설정해야 합니다. 문제를 확인할 때는 기본 범위를 유지하고 사용자 지정 제외 항목을 하나씩 추가하면 원인을 찾기 쉽습니다.
배포판에 맞춰 deb 또는 rpm을 선택한 뒤 프로세서 아키텍처를 확인하세요. 아래 기본 다운로드는 x64입니다. ARM 데스크톱 환경에서는 해당하는 arm64 패키지를 선택하세요.
Debian, Ubuntu 등에서 주로 사용하는 형식입니다. 시스템 소프트웨어 설치 프로그램으로 열고, 종속 항목 안내를 확인한 뒤 설치를 진행하세요.
빌드 요구 사항을 충족하는 RPM 계열 시스템에서 사용할 수 있습니다. 패키지 형식이 맞더라도 배포판 및 시스템 라이브러리 호환성을 확인하세요.
| 확인 항목 | 선택 기준 | 설치 전 준비 |
|---|---|---|
| 패키지 관리 방식 | Debian 계열은 보통 deb, RPM 계열은 보통 rpm을 사용합니다 | 배포판 이름과 소프트웨어 설치 프로그램의 안내를 함께 확인하고 패키지 형식을 혼용하지 마세요. |
| 프로세서 아키텍처 | x64는 amd64 또는 x86_64, arm64는 aarch64에 해당합니다 | 시스템 정보에서 아키텍처를 확인하세요. 배포판 이름만으로 아키텍처를 판단하지 마세요. |
| 데스크톱 및 시스템 라이브러리 | 그래픽 인터페이스와 현재 배포 패키지의 종속 항목 요구 사항을 충족해야 합니다 | 패키지 관리자로 종속 항목을 확인하세요. 오래된 시스템 라이브러리 문제를 종속성 무시로 해결하는 것은 권장하지 않습니다. |
| 프록시 및 권한 | 시스템 프록시 적용 여부는 데스크톱 환경과 앱에 따라 다릅니다 | 먼저 기본 프록시를 확인하세요. TUN 권한과 라우팅은 별도로 설정해야 합니다. |
먼저 데스크톱 환경의 소프트웨어 설치 프로그램으로 패키지를 열고 패키지 관리자가 표시하는 종속 항목을 확인하세요. 시스템 라이브러리 요구 사항을 충족하지 못한다면 현재 시스템에 맞는 배포 패키지인지 먼저 살펴보세요. 설치 형식이 같다는 것은 패키지 관리 방식이 비슷하다는 뜻일 뿐, 서로 다른 배포판에서 바로 호환된다는 의미는 아닙니다.
설치 후 앱 메뉴에서 v2rayN을 실행하고 설정을 가져온 다음 시작 로그를 확인하세요. 브라우저, 데스크톱 앱, 터미널 프로그램은 프록시 설정을 읽는 방식이 다를 수 있습니다. 데스크톱 시스템 프록시가 정상이어도 모든 프로그램이 이를 자동으로 따르는 것은 아닙니다. 먼저 시스템 프록시를 따르는 앱 하나로 연결을 확인한 뒤 다른 앱의 연결 방식을 설정하세요.
TUN을 사용하려면 현재 사용자 권한, 가상 네트워크 인터페이스, 기존 라우팅을 확인하세요. 기능을 시험한다는 이유로 모든 데스크톱 프로그램을 계속 높은 권한으로 실행하지 마세요. 연결 후 로컬 네트워크에 접근할 수 없다면 방금 추가한 라우팅 설정을 먼저 되돌리고 기본 네트워크가 복구되는지 확인한 뒤 우회 규칙을 조정하세요.
설치가 첫 단계입니다. 설정 가져오기, 프록시 활성화, 연결 확인 순서로 진행하면 문제를 쉽게 찾을 수 있습니다.
클라이언트는 로컬에서 설정을 관리하는 도구이며, 구독 주소는 연결 설정을 가져오는 경로입니다. 주소 전체를 복사해 구독 그룹에 소스를 추가한 뒤 업데이트하세요. 단일 노드 공유 링크를 받은 경우에는 클립보드에서 가져오기 등 해당 기능을 사용하세요. 둘 다 링크처럼 보일 수 있지만 가져오는 위치가 다르므로 링크 길이만으로 구분할 수 없습니다.
구독 업데이트가 끝나면 목록에 예상한 설정이 표시되는지 확인한 다음 노드를 선택해 연결하세요. 프로토콜, 전송 방식, 보안 매개변수를 한꺼번에 변경하지 마세요. 서버 설정과 일치해야 합니다. 업데이트 결과가 비어 있다면 프록시 모드를 무작정 바꾸기보다 주소 유효성, 네트워크 연결, 구독 형식을 먼저 확인하세요.
시스템 프록시는 시스템 설정을 따르는 앱이 트래픽을 클라이언트로 전달하는 방식을 정합니다. 라우팅은 클라이언트가 받은 트래픽을 어떻게 분배할지 결정하고, TUN은 트래픽을 전달하는 또 다른 방식입니다. 각각 담당하는 단계가 다릅니다. 데스크톱 클라이언트를 처음 사용한다면 시스템 프록시로 먼저 연결을 확인하고, 기본 연결이 정상인 뒤 더 넓은 범위의 트래픽을 처리할지 검토하세요.
Android 클라이언트는 시스템 VPN 인터페이스를 통해 선택한 범위의 트래픽을 처리하므로 권한과 현재 연결 상태를 확인해야 합니다. 데스크톱과 Android의 메뉴 이름은 다를 수 있지만 점검 방법은 같습니다. 설정이 유효한지, 코어가 정상 실행 중인지, 앱 트래픽이 클라이언트로 들어오는지, 라우팅이 예상대로 적용되는지 확인하세요. 문제를 겹치지 않도록 한 번에 한 단계씩 바꾸세요.
구체적인 메뉴 사용법은 v2rayN 설정 가이드에서 확인하세요. 코어 선택, TUN, 일상적인 관리 방법은 초보자부터 고급 사용자까지를 위한 가이드를 참고하세요. 설정에 문제가 있다면 필요한 오류 정보만 보관하고, 화면을 공유하기 전에 구독 주소와 노드 접속 정보, 개인 네트워크 정보를 가리세요.
업데이트 전에 구독 그룹, 사용자 지정 노드, 라우팅 규칙과 유지할 설정을 내보내세요. 구독을 다시 가져오면 서버 설정은 복원할 수 있지만 로컬 기본 설정까지 모두 자동 복원되지는 않습니다. 직접 추가한 로컬 항목은 별도로 저장하는 것이 중요합니다.
프로그램을 교체하기 전에 현재 프록시를 중지하고 클라이언트를 종료하세요. 인터페이스나 코어를 바꿔 이전할 때는 앱의 가져오기·내보내기 기능을 우선 사용하고, 용도를 알 수 없는 설정 파일을 바로 덮어쓰지 마세요. 새 버전이 실행되면 연결 하나를 먼저 확인한 뒤 사용자 지정 분할 라우팅과 고급 설정을 복원하세요.
새 환경이 정상 작동할 때까지 기존 설정 백업을 보관하세요. 문제가 생기면 오류와 최근 변경 사항을 기록하고, 확실히 작동하는 상태로 되돌린 뒤 하나씩 다시 시도하세요. 백업에 구독이나 접속 정보가 들어 있다면 접근을 제한할 수 있는 안전한 위치에 저장하고 공개 공유 폴더에는 두지 마세요.
먼저 패키지 유형과 실행 환경을 확인한 뒤 연결 설정을 점검하세요.