운영체제에 맞는 클라이언트를 고른 다음 아키텍처와 패키지 형식을 선택하세요. 데스크톱에는 v2rayN, Android에는 v2rayNG를 우선 추천하며 v2flyNG도 대안으로 제공합니다.
이 페이지에서는 x64 설치 파일을 제공합니다. 먼저 “설정 → 시스템 → 정보”에서 시스템 종류를 확인한 뒤 인터페이스 버전을 선택하세요.
Desktop 버전은 차세대 크로스 플랫폼 UI를 사용하고, WPF 버전은 익숙하고 안정적인 클래식 Windows 인터페이스를 유지합니다. 두 버전 모두 연결 설정, 구독, 프록시를 관리하는 용도입니다. 연결 속도가 아니라 사용 습관과 시스템 호환성을 기준으로 선택하세요.
처음 설치한다면 Desktop 버전을 먼저 사용해 보세요. ZIP 파일을 다운로드한 뒤 전체 압축을 풀고 안에 있는 설치 프로그램을 실행하세요.
기존 Windows 조작 방식이 익숙한 사용자에게 적합합니다. 설치 전에 실행 중인 클라이언트를 종료해 수신 포트 충돌을 방지하세요.
| 확인 항목 | 선택 기준 |
|---|---|
| CPU 아키텍처 | 이 페이지의 두 패키지는 모두 x64입니다. 32비트 시스템에서는 바로 사용할 수 없습니다. ARM 기기는 먼저 시스템이 x64 앱 호환을 지원하는지 확인하세요. |
| 시스템 환경 | 시스템 업데이트가 계속 제공되는 Windows 환경에서 사용하는 것을 권장합니다. 구체적인 OS 및 실행 환경 요구 사항은 선택한 설치 프로그램의 안내를 확인하세요. |
| 설치 위치 | 현재 계정에서 접근할 수 있는 위치에 저장하고 압축을 완전히 푼 뒤 실행하세요. 압축 파일 미리 보기 창에서 프로그램을 바로 실행하지 마세요. |
| 권한 및 프록시 | 일반 시스템 프록시와 TUN은 필요한 권한이 다릅니다. 권한 상승이 필요한 기능을 사용할 때만 안내에 따라 권한을 허용하세요. |
설치 후 기본 창을 열고 구독을 가져온 다음 서버를 선택하세요. 브라우저에서 프록시를 사용하려면 “시스템 프록시”에서 “시스템 프록시 자동 구성”을 선택한 뒤 “설정 → 매개변수 설정”에서 로컬 혼합 리스닝 포트를 확인하세요. 포트는 현재 클라이언트에 표시된 값을 기준으로 해야 하며 다른 가이드의 숫자를 그대로 사용하면 안 됩니다. 브라우저에 별도의 프록시 확장 프로그램이 있다면 시스템 설정을 덮어쓰는지도 확인하세요.
이전 버전에서 옮길 때는 구독 그룹과 사용자 지정 라우팅을 먼저 백업한 뒤 기존 프로세스를 종료하세요. 같은 포트를 테스트하기 위해 Desktop과 WPF를 동시에 실행하면 포트 점유와 시스템 프록시 설정이 서로 영향을 줍니다. 새 버전에서 정상적으로 연결되는지 확인한 후 이전 폴더를 정리하세요. 이후 연결 단계는 시스템 프록시 가이드를 참고하세요.
Apple 메뉴에서 “이 Mac에 관하여”를 여세요. Apple 칩이라고 표시되면 Apple Silicon을, Intel 프로세서라고 표시되면 Intel 버전을 선택하세요.
macOS용 v2rayN은 데스크톱 인터페이스를 사용합니다. 설치 파일은 CPU 아키텍처에 따라 구분되며 구독 관리와 라우팅 설정의 기본 원리는 같습니다. 시스템 프록시와 권한 안내는 macOS에서 관리되므로 Windows의 시스템 설정 경로를 그대로 따라 하지 마세요.
Apple 칩이 탑재된 기기용입니다. 칩에 맞는 네이티브 아키텍처를 선택하세요. 이전 가이드를 따라 Intel 패키지를 선택할 필요는 없습니다.
| 확인 항목 | 선택 기준 |
|---|---|
| CPU 아키텍처 | Apple 칩은 arm64, Intel 프로세서는 x64를 선택하세요. “이 Mac에 관하여”에 표시된 정보를 기준으로 확인하면 됩니다. |
| 시스템 환경 | 시스템 업데이트가 계속 제공되는 macOS를 사용하세요. 필요한 최소 버전은 현재 설치 파일이나 앱 실행 시 표시되는 안내를 확인하세요. |
| 설치 형식 | DMG를 연 뒤 창의 안내에 따라 “응용 프로그램”에 설치하세요. 마운트된 디스크 이미지에서 계속 실행하지 마세요. |
| 네트워크 권한 | 사용하려는 기능에 따라 시스템 안내를 처리하세요. 먼저 시스템 프록시를 확인하고, 필요한 경우에만 TUN을 활성화하세요. |
처음 실행할 때 시스템에서 차단되면 시스템 팝업에 표시된 앱 이름, 다운로드 출처, 차단 사유를 먼저 확인한 뒤 “시스템 설정 → 개인정보 보호 및 보안”의 관련 안내를 살펴보세요. 시스템 보안 기능을 일괄 해제하거나 용도를 모르는 터미널 명령을 복사해 안내를 우회하지 마세요. 아키텍처를 잘못 선택한 문제와 권한을 허용하지 않은 문제는 별개이므로 각각 확인해야 합니다.
설치가 끝나면 먼저 기존 설정을 가져오고 서버를 선택하세요. 시스템 프록시를 켜도 일부 앱은 자체 프록시 설정을 계속 사용할 수 있으며, 터미널 프로그램은 시스템 프록시를 자동으로 읽지 않을 수 있습니다. 시스템 설정을 따르는 브라우저에서 테스트하고 클라이언트 로그를 확인하세요. 클라이언트를 더 이상 사용하지 않을 때는 먼저 시스템 프록시를 해제한 다음 앱을 종료해, 시스템이 종료된 로컬 포트를 계속 가리키지 않도록 하세요.
2015년 이후 출시된 대부분의 스마트폰에서는 arm64를 우선 선택하세요. 기기의 아키텍처를 모르면 범용 버전을 사용할 수 있습니다. 최종적으로는 기기 운영체제에서 해당 아키텍처를 지원하는지 확인해야 합니다.
Xray 코어를 사용하는 Android 그래픽 클라이언트입니다. 처음 설정한다면 v2rayNG를 먼저 선택하고 구독에 포함된 연결 정보를 가져오세요. 지원하는 프로토콜과 전송 기능은 현재 클라이언트와 서버 설정이 모두 지원하는 범위에 따라 달라집니다.
arm64-v8a를 지원하는 기기에 적합합니다. 시스템에서 아키텍처가 호환되지 않는다는 메시지가 표시되면 기기 정보를 확인하거나 범용 버전을 선택하세요.
기기의 아키텍처를 아직 확인하기 어려울 때 적합합니다. 더 많은 아키텍처를 지원하며 단일 아키텍처 패키지보다 파일 크기가 큰 편입니다.
V2Fly 코어를 사용하는 Android 대체 클라이언트입니다. 호환되는 설정을 이미 보유했거나 해당 코어 생태계를 사용하려는 경우에 적합합니다. 두 앱이 모든 설정을 동일하게 지원한다고 가정하지 마세요. 전환하기 전에 구독 형식과 전송 설정을 확인하세요.
arm64-v8a를 지원하는 기기에 권장합니다. 설치 후 설정을 별도로 가져와야 하며 다른 앱의 구독이 자동으로 공유되지는 않습니다.
| 확인 항목 | 선택 기준 |
|---|---|
| CPU 및 시스템 아키텍처 | arm64는 arm64-v8a에 해당합니다. 하드웨어가 64비트를 지원하더라도 설치된 시스템에서 64비트 앱 환경을 제공하지 않을 수 있습니다. |
| 시스템 버전 | 최소 Android 버전은 현재 APK를 설치할 때 표시되는 안내를 확인하세요. 범용 버전을 선택해도 OS 버전이 너무 낮은 문제는 해결되지 않습니다. |
| 설치 권한 | APK를 여는 데 사용할 브라우저나 파일 관리자에만 필요한 경우 설치 권한을 허용하고, 설치가 끝나면 해당 출처의 권한을 해제할 수 있습니다. |
| 연결 권한 | 프록시를 시작할 때 시스템 안내에 따라 VPN 연결을 허용하세요. 일반적으로 시스템 VPN 채널을 사용하는 앱 두 개를 동시에 실행할 수 없습니다. |
설치에 성공해도 연결 설정이 자동으로 가져와지는 것은 아닙니다. 클라이언트를 열고 구독 그룹을 추가한 다음 기존 구독 주소를 붙여 넣어 업데이트하고 설정 하나를 선택해 시작하세요. 시스템에서 처음 VPN 권한을 요청하면 현재 클라이언트가 요청한 것인지 확인하세요. 연결 아이콘은 시스템에 로컬 VPN 채널이 만들어졌다는 뜻일 뿐 원격 서버를 사용할 수 있다는 증거는 아닙니다. 실제로 접속해 보고 로그도 확인해야 합니다.
화면을 잠근 뒤 연결이 끊기면 배터리 최적화와 백그라운드 실행 제한을 먼저 확인하세요. 백그라운드 실행 문제를 해결하려고 APK를 반복해서 바꾸지 마세요. 기존 앱과 설치가 충돌한다는 안내가 표시되면 서명이나 설치 출처가 원인일 수 있으므로 설정을 백업한 뒤 삭제가 필요한지 판단하세요. 앱을 바로 삭제하면 앱 내부 데이터가 사라질 수 있습니다. 두 앱을 번갈아 테스트할 때는 같은 노드와 네트워크 조건을 사용해 클라이언트 설정과 서버 문제를 구분하세요.
먼저 배포판에서 사용하는 패키지 형식을 확인한 뒤 CPU 아키텍처를 확인하세요. 파일 확장자와 아키텍처가 모두 맞아야 하며 클라이언트 이름만 보고 선택하면 안 됩니다.
Linux 데스크톱 버전은 deb 및 rpm 설치 파일을 제공합니다. 의존성은 배포판에 내장된 소프트웨어 설치 도구로 처리하는 것이 좋습니다. 설치 후 앱 메뉴에서 실행하세요. 아래 기본 다운로드는 모두 x64용이며 arm64 기기용 링크는 작은 글씨로 표시되어 있습니다.
Debian, Ubuntu 계열 등 deb 패키지 관리 방식을 사용하는 호환 배포판용입니다. 현재 패키지의 의존성 조건을 충족해야 합니다.
rpm 패키지 관리 방식을 사용하며 해당 패키지의 의존성을 충족하는 배포판용입니다. 확장자가 같아도 모든 시스템 버전과 호환되는 것은 아닙니다.
| 확인 항목 | 선택 기준 |
|---|---|
| 데스크톱 환경 | 이 페이지에서는 그래픽 클라이언트를 제공합니다. 데스크톱 앱을 실행할 수 있는 세션 환경이 필요하며 서버용 명령줄 배포 패키지는 아닙니다. |
| 아키텍처 이름 | amd64와 x86_64는 이 페이지의 x64 패키지에 해당하고, arm64와 aarch64는 arm64 패키지에 해당합니다. |
| 배포판 및 의존성 | deb와 rpm은 패키지 형식의 구분일 뿐입니다. 필요한 시스템 라이브러리와 버전 의존성은 패키지 관리자로 확인하세요. 의존성을 무시하고 강제로 설치하는 것은 권장하지 않습니다. |
| 프록시 및 권한 | 데스크톱 시스템 프록시는 해당 설정을 따르는 앱에만 적용됩니다. TUN에는 추가 권한과 환경 지원이 필요하므로 시스템 프록시와 같은 기능으로 보면 안 됩니다. |
설치 프로그램에서 의존성 부족을 보고하면 전체 오류 메시지를 보관하고 사용 중인 배포판 버전이 요구 사항을 충족하는지 확인하세요. 다른 배포판의 시스템 라이브러리를 임의로 복사하지 말고, 확장자를 바꿔 rpm을 deb로 설치하려고 하지 마세요. 그래픽 앱이 실행되지 않으면 모든 실행 문제를 연결 설정 탓으로 돌리기 전에 데스크톱 세션, 파일 접근 권한, 기존 프로세스를 확인하세요.
연결 확인은 범위를 최소화해 시작하세요. 먼저 사용 가능한 설정 하나를 가져와 코어가 실행되는지 확인한 다음 프록시를 사용하도록 명확히 설정된 앱 하나에서 테스트하세요. 데스크톱 프록시, 브라우저 자체 프록시, 터미널 환경 변수는 각각 별도로 적용될 수 있으므로 하나를 바꿔도 나머지 설정은 자동으로 바뀌지 않습니다. 일반 프록시가 정상 작동하는지 확인한 뒤 TUN을 켜세요. 특정 앱만 접속할 수 없다면 클라이언트를 다시 설치하기보다 해당 앱이 프록시 설정을 읽는 방식을 먼저 확인하세요.
설치 후
이미 설정을 사용 중인 기기라면 업데이트 전에 구독 그룹, 사용자 지정 라우팅, DNS 설정, 로컬 포트 기록을 보관하세요. 백업에 연결 정보가 포함될 수 있으므로 직접 관리할 수 있는 위치에 저장하고 공개 게시판에 올리지 마세요. 인터페이스 버전, 설치 출처, 클라이언트 이름을 바꿀 때 설정이 자동으로 이전된다고 가정하지 마세요. 가져온 뒤 항목별로 확인하고 이전 버전을 삭제하세요.
설치 파일은 클라이언트만 제공하며 사용할 수 있는 구독은 포함하지 않습니다. 기존 구독을 추가하고 업데이트한 뒤 서버 하나를 선택해 테스트하세요. Tcping은 대상 포트에 연결할 수 있는지 확인하는 데 쓰이고, 실제 연결 테스트는 프록시 요청에 더 가까운 결과를 보여줍니다. 두 테스트 모두 모든 사이트에 항상 접속할 수 있음을 보장하지는 않습니다. 테스트에 실패하면 구독 유효 기간, 시스템 시간, 노드 설정을 먼저 확인하세요. 라우팅이나 DNS를 바로 변경할 필요는 없습니다.
먼저 일반 시스템 프록시가 정상 작동하는지 확인한 뒤 필요에 따라 분할 라우팅이나 TUN을 설정하세요. 변경할 때마다 설정 항목과 결과를 기록하면 포트, DNS, 라우팅을 동시에 바꿔 원인을 파악하기 어려워지는 일을 막을 수 있습니다. 클라이언트를 종료하기 전에 시스템 프록시가 해제됐는지 확인하세요. 웹페이지에 갑자기 접속할 수 없다면 시스템이 종료된 로컬 포트를 계속 가리키고 있지 않은지도 확인해야 합니다.
설정 방법은 구독 가져오기 및 첫 연결 가이드를 참고하세요. 설치 후 접속할 수 없다면 v2rayN 문제 진단에서 증상에 따라 확인할 수 있습니다.
다운로드 관련 문제
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 Desktop 버전을 먼저 선택해 보세요. 기존 Windows 인터페이스가 익숙하다면 WPF 버전이 적합합니다. 두 버전 모두 연결 설정을 가져와야 합니다. 전환하기 전에 기존 설정을 백업하고, 두 클라이언트에서 시스템 프록시나 TUN 모드를 동시에 켜지 마세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택해 볼 수 있지만, 실제로 지원되는 아키텍처는 기기에서 사용하는 운영체제를 기준으로 확인해야 합니다. 아키텍처를 모르거나 arm64가 호환되지 않는다는 메시지가 표시되면 범용 버전을 선택하세요. 범용 버전은 더 많은 아키텍처를 지원하는 대신 파일 크기가 더 큰 편입니다. 다른 패키지를 설치하기 전에 OS 버전과 사용 가능한 저장 공간을 확인하세요.
버전 표기와 아키텍처별 설치 파일 경로는 매니페스트의 서로 다른 필드에서 가져오므로 업데이트 시점이 다를 수 있습니다. 이 페이지는 매니페스트에 기재된 파일 이름을 그대로 사용하며 버전 표기만으로 주소를 추정하지 않습니다. 설치 후 실제 버전은 클라이언트의 정보 페이지에서 확인하세요. 다운로드 주소의 버전 숫자를 직접 바꾸지 마세요.
클라이언트 설치 파일에는 연결에 필요한 설정이 포함되어 있지 않습니다. 기존 구독이나 노드를 가져온 다음 구독을 업데이트하고 서버를 선택하세요. 앱의 사용 방식에 따라 시스템 프록시나 TUN 모드를 켜면 됩니다. 먼저 노드 하나로 테스트한 뒤 수신 포트, 라우팅 프리셋, 브라우저 프록시 설정을 확인하세요.
구독 그룹, 사용자 지정 라우팅, DNS 설정, 로컬 포트 기록을 보관하고 백업 파일은 직접 관리할 수 있는 위치에 저장하세요. 업데이트 전에 클라이언트를 종료하고, 업데이트 후 설정이 제대로 이전됐는지 확인합니다. 이전 버전과 새 버전을 동시에 실행하지 마세요. 공개 스크린샷에 구독 주소나 연결 정보를 노출하지 않도록 주의하세요.
다운로드가 중단되면 브라우저의 다운로드 기록, 디스크 공간, 현재 네트워크 상태를 확인한 뒤 해당 설치 파일을 다시 다운로드하세요. 설치에 실패하면 오류 메시지를 빠짐없이 기록하고 운영체제, CPU 아키텍처, 패키지 형식이 서로 맞는지 확인합니다. 모든 보안 기능을 끄는 방식으로 문제를 해결하지 마세요. 기존 클라이언트의 프록시 설정이 남아 있는지도 별도로 확인해야 합니다.