데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. 먼저 운영체제를 확인한 다음 CPU 아키텍처를 확인하세요.
처음 설치한다면 Desktop판을 먼저 확인하세요. 기존 Windows 인터페이스에 익숙하다면 클래식 WPF판을 선택할 수 있습니다. 두 설치 파일 모두 v2rayN입니다.
차세대 크로스 플랫폼 UI입니다. 처음 사용한다면 이 버전으로 설정을 시작할 수 있습니다.
v2rayN 다운로드 · Desktop x64 · ZIP 압축 파일두 버전의 주요 차이는 인터페이스 기술과 레이아웃입니다. 인터페이스만 보고 사용할 프로토콜을 판단해서는 안 됩니다. 연결 가능 여부는 설정 매개변수와 사용 중인 코어에 따라 달라집니다. 기존 설정이 있다면 먼저 백업한 뒤 전환을 테스트하고, 다른 버전의 설정 폴더 전체를 그대로 덮어쓰지 마세요.
| 확인 항목 | 선택 기준 | 설치 시 유의 사항 |
|---|---|---|
| CPU 아키텍처 | 64비트 Intel / AMD 시스템에서는 이 페이지의 x64 패키지를 선택하세요. | ‘설정 → 시스템 → 시스템 정보’에서 시스템 종류를 확인하세요. 프로세서 브랜드만 보고 판단하지 마세요. |
| 운영체제 버전 | 지원이 계속되는 Windows 10 / 11 사용을 권장합니다. | 최소 요구 사항은 선택한 버전의 설치 안내를 확인하세요. 구형 운영체제에서는 실행되지 않을 수 있습니다. |
| 실행 환경 | 시작할 때 .NET이 없다는 안내가 표시되면 클라이언트 안내에 따라 데스크톱 런타임을 선택하세요. | 런타임 아키텍처는 클라이언트와 일치해야 합니다. 범용 런타임만 설치한다고 요구 사항이 충족되는 것은 아닙니다. |
| 폴더 및 권한 | 현재 사용자가 프로그램 폴더와 설정 폴더를 읽고 쓸 수 있어야 합니다. | 먼저 로컬 폴더에 압축을 푸세요. 압축 파일 미리보기에서 바로 실행하지 마세요. |
이전 버전이 시스템 트레이에서 계속 실행 중이라면 새 버전을 시작하기 전에 기존 프로세스를 종료하세요. 두 프로그램이 같은 로컬 포트를 동시에 사용하면 시작에 실패하거나 앱이 이전 프로세스에 연결될 수 있습니다. 갑자기 종료되는 경우 먼저 런타임, 폴더 쓰기 권한, 설정 호환성을 확인하세요. 문제 해결 순서는 문제 해결을 참고하세요.
Apple 메뉴에서 ‘이 Mac에 관하여’를 열고 ‘칩’ 또는 ‘프로세서’를 확인하세요. Apple M 시리즈는 arm64, Intel은 x64를 선택하세요.
Apple M 시리즈 칩용입니다. 기본 arm64 설치 파일을 사용하세요.
v2rayN 다운로드 · arm64 Apple Silicon · DMG 디스크 이미지컴퓨터를 구입한 연도로 아키텍처를 추정하지 마세요. 같은 시기에 출시된 제품도 칩이 다를 수 있습니다. 시스템에서 다른 아키텍처의 프로그램을 변환 실행할 수 있더라도, 추가 의존성을 줄이려면 기기의 칩에 맞는 설치 파일을 선택하는 것이 좋습니다.
| 확인 항목 | 선택 기준 | 설치 시 유의 사항 |
|---|---|---|
| 칩 종류 | Apple M 시리즈는 arm64, Intel은 x64에 해당합니다. | ‘이 Mac에 관하여’에 표시된 정보를 기준으로 선택하세요. |
| 시스템 호환성 | 현재 빌드가 요구하는 최소 macOS 버전을 충족해야 합니다. | 시스템 버전이 지원되지 않는다는 안내가 나오면 아키텍처를 바꿔 가며 시도하지 말고 먼저 호환성을 확인하세요. |
| 설치 위치 | 앱을 ‘응용 프로그램’ 폴더에 넣으세요. | 마운트된 DMG 이미지에서 앱을 계속 실행하지 마세요. |
| 네트워크 권한 | 시스템 프록시와 TUN은 필요한 권한 범위가 다릅니다. | 실제로 사용할 기능에 필요한 권한만 허용하세요. 구독을 처음 가져오는 데 불필요한 권한은 미리 허용하지 마세요. |
업데이트하기 전에 실행 중인 클라이언트를 종료해 앱을 교체하는 동안 기존 프로세스가 파일을 사용하지 않도록 하세요. 아키텍처를 변경하거나 기기를 옮길 때는 모든 경로, 권한, 로컬 포트를 그대로 사용할 수 있다고 가정하지 말고 필요한 설정을 내보낸 뒤 다시 가져오세요. 자세한 설정 방법은 v2rayN 설정 가이드를 참고하세요.
v2rayNG를 우선 권장합니다. 2015년 이후 출시된 일반적인 스마트폰은 보통 arm64를 선택하면 됩니다. 구형 기기나 에뮬레이터를 사용하거나 아키텍처를 모른다면 범용판을 고려하세요.
v2rayNG는 Xray 코어를 사용합니다. 설정을 가져온 뒤에도 필요한 프로토콜, 전송 방식, 보안 매개변수를 현재 버전에서 지원하는지 확인해야 합니다. QR 코드나 클립보드에서 설정을 가져오는 데 성공해도 설정을 읽었다는 뜻일 뿐, 원격 서버에 연결할 수 있다는 보장은 없습니다.
V2Fly와 Xray는 서로 다른 코어 개발·유지 관리 경로를 따릅니다. 클라이언트를 바꾸기 전에 설정 호환성을 확인하세요. 특히 특정 코어에서만 지원하는 기능을 그대로 옮기지 마세요. 두 클라이언트에서 설정을 각각 관리할 수 있지만, 시스템 VPN 연결을 동시에 사용해서는 안 됩니다.
| 확인 항목 | 선택 기준 | 설치 시 유의 사항 |
|---|---|---|
| 앱 아키텍처 | arm64-v8a를 지원하는 시스템에서는 arm64를 우선 선택하세요. | 프로세서가 64비트를 지원해도 운영체제가 64비트 앱을 지원한다는 뜻은 아닙니다. |
| 운영체제 버전 | 선택한 APK의 최소 Android 버전을 충족해야 합니다. | 설치에 실패하면 먼저 시스템에 표시된 구체적인 오류를 확인하세요. |
| 앱 설치 출처 권한 | APK를 실제로 여는 브라우저나 파일 관리자에만 권한을 허용하세요. | 설치 후에는 해당 출처의 앱 설치 권한을 취소할 수 있습니다. |
| VPN 권한 | 처음 연결할 때 시스템 안내에 따라 확인하세요. | 다른 VPN 앱이 연결을 사용 중인지 확인하세요. |
| 백그라운드 관리 | 기기에 필요한 경우 클라이언트의 백그라운드 실행을 허용하세요. | 클라이언트에 해당하는 배터리 설정만 조정하세요. 배터리 관리를 전체적으로 끌 필요는 없습니다. |
QR 코드와 클립보드는 기존 내용을 가져오는 기능이며 구독 주소를 자동으로 만들지는 않습니다. 카메라 권한은 QR 코드 스캔 등 해당 기능을 사용할 때만 허용하세요. 연결한 뒤 일부 앱만 프록시를 사용하지 않는다면 앱별 라우팅과 제외 목록을 확인하세요. 시스템 VPN 아이콘만 보고 모든 앱의 연결이 확인됐다고 판단하지 마세요.
먼저 배포판에서 사용하는 패키지 형식을 확인한 다음 CPU 아키텍처를 선택하세요. deb와 rpm은 패키지 형식이 다르다는 뜻이지, 클라이언트 기능이 다르다는 뜻은 아닙니다.
패키지 형식이 맞는 것은 첫 단계일 뿐이며, 해당 빌드에 필요한 시스템 라이브러리와 데스크톱 환경도 충족해야 합니다. 특히 rpm은 파일 확장자가 같다고 모든 rpm 배포판과 호환되는 것은 아닙니다. 먼저 그래픽 패키지 설치 프로그램에 표시되는 의존성과 오류 안내를 확인하세요.
| 확인 항목 | 선택 기준 | 설치 시 유의 사항 |
|---|---|---|
| 패키지 형식 | Debian 계열에서는 보통 deb를 사용하고, rpm 계열 배포판에서는 호환되는 rpm을 선택하세요. | 파일 확장자를 바꾸는 것만으로 패키지 형식을 변환할 수 없습니다. |
| CPU 아키텍처 | Intel / AMD 64비트는 x64, 64비트 ARM은 arm64를 선택하세요. | amd64와 x86_64는 일반적으로 같은 종류의 아키텍처를 가리킵니다. |
| 데스크톱 환경 | 그래픽 앱을 실행할 수 있는 데스크톱 세션이 필요합니다. | 이 페이지에서는 그래픽 클라이언트를 제공합니다. 백그라운드 서비스 배포용 패키지가 아닙니다. |
| 의존성 및 권한 | 시스템 라이브러리가 패키지 설치 프로그램에 표시된 요구 사항을 충족해야 합니다. | 설치 권한과 일상적인 실행 권한은 별도로 관리하세요. |
브라우저에서 프록시를 사용하려고 클라이언트 전체를 높은 권한으로 실행하지 마세요. 더 많은 트래픽을 처리해야 한다면 먼저 TUN의 권한, 라우팅, DNS에 미치는 영향을 확인하세요. 시스템 프록시가 켜져 있는데도 앱에서 사용되지 않는다면 앱의 프록시 옵션, 로컬 수신 포트, 환경 변수를 각각 확인하세요. 관련 개념은 라우팅 및 분할 터널링 안내를 참고하세요.
설치, 설정 가져오기, 프록시 설정을 각각 진행하세요. 한 단계가 끝날 때마다 확인하면 문제가 생겼을 때 원인을 찾기 쉽습니다.
클라이언트는 설정을 읽고 관리하는 프로그램이며 원격 서버를 대신하지 않습니다. 사용할 권한이 있는 구독 주소를 준비해 구독 그룹에 추가하고 업데이트하세요. 단일 공유 링크는 해당 가져오기 메뉴를 사용하세요. 웹페이지 주소, 계정 관리 페이지, 안내문 전체를 붙여 넣어도 일반적으로 유효한 설정을 만들 수 없습니다.
설정을 선택한 뒤 데스크톱에서는 시스템 프록시를 설정하고 Android에서는 VPN 연결을 시작하세요. 실제로 사용할 앱으로 결과를 확인하고 클라이언트 오류 로그도 살펴보세요. 스위치가 켜져 있다는 이유만으로 연결이 완료됐다고 판단하지 마세요.
구독 가져오기 단계 확인 →업데이트 전에 현재 사용 중인 설정 출처, 로컬 수신 포트, DNS, 사용자 지정 라우팅을 기록하세요. 클라이언트의 내보내기 또는 백업 기능을 사용하고, 접속 정보가 포함된 내용은 안전하게 보관하세요. 백업을 공개적으로 업로드하거나 토론 게시판에 스크린샷으로 올리지 마세요.
기존 클라이언트를 종료한 뒤 업데이트하세요. 인터페이스나 코어, 주요 버전을 바꿀 때는 파일 전체를 덮어쓰지 말고 새 버전에서 지원하는 방식으로 설정을 다시 가져오세요. 업데이트 후 자주 사용하는 앱부터 확인한 다음 TUN 등 고급 기능을 켤지 결정하세요.
클라이언트와 코어의 차이 알아보기 →처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 Desktop판을 권장합니다. 클래식 WPF판은 Windows 전용 인터페이스로, 기존 레이아웃에 익숙한 경우 안정적으로 사용할 수 있습니다. 둘 다 v2rayN 클라이언트입니다. 전환하기 전에 설정을 백업하고, 두 클라이언트가 같은 로컬 수신 포트를 동시에 사용하지 않도록 하세요.
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. 칩에 Apple M 시리즈가 표시되면 Apple Silicon arm64 패키지를, 프로세서에 Intel이 표시되면 Intel x64 패키지를 선택하세요. 설치에 실패하면 먼저 macOS 버전과 아키텍처를 확인하세요. 시스템 보안 기능을 끄는 방식으로 경고를 우회하지 마세요.
2015년 이후 출시된 일반적인 스마트폰은 arm64를 우선 선택할 수 있지만, 기기 운영체제가 지원하는 아키텍처를 기준으로 선택해야 합니다. 구형 기기나 에뮬레이터를 사용하거나 아키텍처를 모른다면 범용판을 선택하세요. 범용판에 여러 아키텍처 파일이 포함되어 있다고 해서 연결 품질이 더 좋아지는 것은 아닙니다.
v2rayNG는 Xray 코어를 사용하며 이 페이지에서 우선 추천하는 Android 클라이언트입니다. v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 설정의 호환 여부는 코어가 해당 프로토콜, 전송 방식, 보안 매개변수를 지원하는지에 따라 달라집니다. 구독을 가져올 수 있다는 이유만으로 호환된다고 판단할 수는 없습니다.
설치 파일에는 클라이언트 프로그램만 포함되어 있으며, 바로 사용할 수 있는 연결 설정은 제공되지 않습니다. 사용 권한이 있는 구독 주소나 공유 링크를 준비해 가져오고 업데이트한 뒤, 설정을 선택하고 시스템 프록시를 켜거나 Android VPN 권한을 허용해야 합니다. 자세한 단계는 입문 가이드를 참고하세요.
구독 그룹, 사용자 지정 라우팅, DNS, 로컬 포트 등의 설정을 먼저 백업하고 현재 프록시 모드를 기록하세요. 기존 클라이언트를 종료한 뒤 업데이트를 설치하세요. 버전이나 인터페이스, 코어가 다른 설정 파일을 그대로 덮어써도 된다고 가정하지 마세요. 업데이트 후 구독, 수신 포트, 앱 연결 상태를 다시 확인하세요.