안정적인 클래식 버전으로 Windows WPF 인터페이스를 사용합니다. 기존 레이아웃과 사용 방식에 익숙한 사용자에게 적합합니다.
압축 해제, 설치 및 설정 불러오기
두 설치 파일은 ZIP 압축 파일로 제공됩니다. 다운로드한 파일을 별도 폴더에 먼저 압축 해제한 뒤, 폴더 안의 설치 프로그램을 실행하세요. 압축 파일 미리보기에서 바로 실행하지 마세요. 설치 경로는 변경하지 않는 것이 좋습니다. 프로그램이 설정을 저장해야 한다면 현재 계정에 해당 폴더의 쓰기 권한이 있는지도 확인하세요.
Desktop과 WPF의 차이는 주로 인터페이스 기술과 화면 구성에 있으며, 어느 쪽이 노드 속도가 더 빠른지를 의미하지는 않습니다. 인터페이스를 바꾸기 전에 구독과 사용자 지정 규칙을 백업하고 기존 클라이언트를 종료한 뒤 새 클라이언트를 실행하세요. 두 프로그램을 동시에 실행하면 로컬 수신 대기 포트를 두고 충돌할 수 있습니다. 설정을 가져온 후에는 활성 노드, 시스템 프록시, 라우팅 모드를 다시 확인하세요.
Windows 설치 조건
확인 항목
이 페이지 설치 파일의 조건
확인 위치 및 방법
프로세서 아키텍처
x64
시스템 설정에서 ‘시스템 → 정보’를 열고 시스템 종류를 확인하세요.
시스템 및 실행 환경
선택한 클라이언트 배포 패키지의 요구 사항을 충족해야 합니다
설치 프로그램의 안내에 따라 시스템과 실행 환경을 확인하세요. ‘64비트’라는 정보만으로 호환 여부를 판단할 수는 없습니다.
파일 및 권한
압축을 푼 뒤 설치 프로그램 실행
정상적으로 파일을 저장할 수 있는 폴더를 선택하세요. TUN 기능을 사용하려면 추가 권한이 필요할 수 있습니다.
연결 준비
유효한 노드 또는 구독
설정을 가져오고 노드를 선택한 다음 시스템 프록시를 설정하고 로그를 확인하세요.
시스템 프록시는 시스템 프록시 설정을 따르는 앱에만 적용됩니다. 다른 앱의 트래픽까지 처리해야 한다면 클라이언트에서 지원하는 TUN 기능을 검토하세요. 설치 완료, 서비스 시작, 트래픽 처리 여부는 각각 별도로 확인해야 합니다. 자세한 내용은 Windows 설치 및 설정 가이드를 참고하세요.
macOS 설치 파일
v2rayN은 Apple Silicon과 Intel용 DMG를 제공합니다. 아키텍처는 칩 종류에 따라 선택하며, 구독이나 노드 종류는 선택에 영향을 주지 않습니다.
Intel 프로세서가 탑재된 기기용입니다. 호환 계층을 거치지 않도록 기기에 맞는 네이티브 아키텍처를 선택하세요.
DMG 설치 및 첫 실행
디스크 이미지 파일을 열고 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮긴 다음 해당 폴더에서 실행하세요. 마운트된 디스크 이미지에서 앱을 계속 실행하면 업데이트하거나 이미지를 마운트 해제한 뒤 프로그램을 찾지 못할 수 있습니다. 처음 실행할 때는 시스템 안내를 읽고 앱 이름, 출처, 실행하려는 작업을 확인하세요. 경고를 피하려고 기기 전체의 보안 기능을 끄지 마세요.
구독을 가져온 뒤 노드를 선택하고 클라이언트에서 코어가 정상적으로 시작되는지 확인한 다음 시스템 프록시를 켜세요. 시스템 프록시와 TUN은 트래픽을 처리하는 방식이 다릅니다. 시스템 프록시는 앱이 프록시 설정을 따르는지에 따라 달라지고, TUN은 가상 네트워크 인터페이스와 추가 권한이 필요합니다. 첫 연결에서는 먼저 시스템 프록시 경로를 확인한 뒤 기능을 하나씩 추가하면 권한, DNS, 라우팅 문제를 구분하기 쉽습니다.
macOS 설치 조건
확인 항목
이 페이지 설치 파일의 조건
확인 위치 및 방법
Apple Silicon
arm64 DMG
‘이 Mac에 관하여’에 Apple M 시리즈 칩이 표시됩니다.
Intel 프로세서
x64 DMG
‘이 Mac에 관하여’에 Intel 프로세서가 표시됩니다.
시스템 호환성
배포 패키지 요구 사항과 시스템 안내를 따르세요
아키텍처가 맞는지 확인한 뒤 현재 시스템에서 앱을 실행할 수 있는지도 확인하세요.
네트워크 권한
사용할 기능에 필요한 권한 허용
시스템 프록시 설정을 확인하세요. TUN을 사용할 때는 인터페이스와 권한도 별도로 점검해야 합니다.
업데이트하기 전에 실행 중인 앱을 종료해 이전 버전과 새 버전이 동시에 실행되지 않도록 하세요. 프로그램을 교체한 뒤 설정이 보이지 않는다면 구독을 모두 다시 가져오기 전에 다른 폴더에 있는 복사본을 실행한 것은 아닌지 확인하세요. 플랫폼별 자세한 내용은 macOS 설치 및 설정 가이드를 참고하세요.
Android 설치 파일
v2rayNG는 Xray 코어를 사용하며 우선 추천하는 Android 클라이언트입니다. v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 두 앱은 각각 설치하고 설정도 따로 관리해야 합니다.
아키텍처를 확인하기 어려울 때 선택할 수 있습니다. 여러 아키텍처를 지원하지만 시스템 호환 조건은 여전히 충족해야 합니다.
설치 및 VPN 연결 권한
APK를 다운로드한 뒤 시스템 설치 프로그램에서 파일을 여세요. 브라우저나 파일 관리자에서 앱을 설치하도록 허용해야 한다면 실제로 사용할 출처에만 권한을 부여하세요. 설치가 끝나면 v2rayNG를 열어 구독 그룹을 추가하고 노드 목록을 업데이트합니다. 코어와 호환되는 공유 링크를 가져올 수도 있습니다.
노드를 선택하고 연결을 시작하면 처음 실행할 때 시스템 VPN 권한 요청이 표시됩니다. 이 권한은 로컬 트래픽 처리 인터페이스를 만드는 데 사용되며, 노드 연결이 성공했다는 뜻은 아닙니다. 앱 로그와 실제 접속 결과를 확인하세요. 화면이 꺼진 뒤 연결이 끊긴다면 구독이 만료된 것으로 단정하지 말고 배터리 최적화와 백그라운드 실행 제한을 확인하세요.
아키텍처를 확인하기 어려울 때 선택할 수 있는 대안입니다. 설치 전에 시스템 요구 사항과 기존 앱을 함께 확인하세요.
클라이언트 간 전환 점검
v2flyNG와 v2rayNG는 이름이 비슷하지만 기본 코어가 다릅니다. 구독을 불러올 수 있다고 해서 모든 프로토콜, 전송 매개변수, 코어 확장 필드가 호환되는 것은 아닙니다. 전환할 때는 호환성이 확인된 노드 하나를 먼저 가져와 테스트한 뒤 사용자 지정 DNS와 라우팅 규칙을 옮기세요. 한 앱의 기본 설정 파일을 다른 앱에 그대로 덮어쓰지 마세요.
연결 앱을 바꿀 때는 이전 클라이언트의 VPN 서비스를 먼저 중지한 다음 새 앱을 시작하세요. Android에서는 일반적으로 VPN 서비스를 한 번에 하나만 활성화할 수 있습니다. 여러 앱이 번갈아 트래픽 처리를 요청하면 연결 상태가 반복해서 바뀔 수 있습니다. 두 클라이언트를 비교할 때는 같은 노드, 네트워크, 대상 요청을 사용하고 로그를 함께 확인하세요.
Android 설치 조건
확인 항목
이 페이지 설치 파일의 조건
확인 위치 및 방법
앱 아키텍처
arm64 또는 범용 패키지
프로세서의 제품명만 보지 말고 기기의 시스템에서 지원하는 아키텍처를 기준으로 선택하세요.
시스템 버전
해당 APK의 설치 요구 사항을 충족해야 합니다
기기 설정에서 Android 버전을 확인하고 설치 프로그램의 안내를 읽으세요.
설치 권한
현재 출처에서 앱 설치 허용
시스템 안내에 따라 권한을 허용하세요. 설치가 끝나면 해당 출처의 권한을 다시 해제할 수 있습니다.
연결 및 백그라운드 실행
VPN 권한 및 정상적인 백그라운드 실행
다른 VPN 서비스, 배터리 절약 제한, 클라이언트 로그를 확인하세요.
‘앱이 설치되지 않았습니다’라는 메시지가 표시되면 같은 이름의 앱이 이미 있는지, 설치 서명이 일치하는지, 기기 저장 공간이 충분한지 먼저 확인하세요. 앱을 삭제하고 다시 설치해야 한다면 복원할 수 있는 설정을 먼저 내보내 구독 그룹이 사라지지 않도록 하세요. 자세한 작업 방법은 Android 설치 및 설정 가이드를 참고하세요.
Linux 설치 파일
v2rayN은 deb와 rpm 패키지를 제공합니다. 배포판에 맞는 패키지 형식을 고른 뒤 프로세서 아키텍처에 따라 x64 또는 arm64를 선택하세요.
설치 파일을 배포판의 소프트웨어 설치 프로그램으로 여세요. 의존성과 아키텍처 안내를 확인한 뒤 설치를 진행합니다. 파일 이름을 바꿔 deb와 rpm을 서로 바꿀 수는 없습니다. 같은 패키지 형식이라도 모든 배포판 버전에서 의존성이 충족되는 것은 아닙니다. 설치에 실패하면 오류 내용을 확인해 누락된 구성 요소나 시스템 호환 조건부터 살펴보세요. 의존성을 무시하고 설치를 강행하지 마세요.
v2rayN은 그래픽 데스크톱 클라이언트이며, 이 페이지의 패키지는 그래픽 환경에서 사용하는 경우를 대상으로 합니다. 설치 후 앱 메뉴에서 실행하고 구독을 가져온 다음 로컬 수신 대기 포트를 확인하세요. 데스크톱 환경마다 시스템 프록시를 적용하는 방식이 다를 수 있으므로, 브라우저에서 프록시가 작동한다고 해서 모든 프로그램의 트래픽이 처리되는 것은 아닙니다. TUN을 켜기 전에 현재 클라이언트의 기능, 인터페이스 권한, 기존 네트워크 규칙도 확인하세요.
Linux 설치 조건
확인 항목
이 페이지 설치 파일의 조건
확인 위치 및 방법
패키지 체계
deb 또는 rpm
배포판 문서나 그래픽 소프트웨어 관리자에서 확인하세요.
프로세서 아키텍처
x64 또는 arm64
x86_64와 amd64는 x64에, aarch64는 arm64에 해당합니다.
데스크톱 환경 및 의존성
그래픽 환경과 배포 패키지에 필요한 구성 요소
설치 프로그램의 의존성 안내를 읽고 배포판 버전을 확인하세요.
프록시 및 권한
데스크톱 환경과 사용 모드에 맞게 설정
시스템 프록시, TUN, 앱별 프록시를 각각 확인하세요.
데스크톱 아이콘으로 앱을 열 수 있지만 코어가 시작되지 않는다면 클라이언트 로그에서 구체적인 오류를 확인하세요. 포트 충돌, 호환되지 않는 설정 필드, 권한 부족은 각각 따로 해결해야 합니다. 클라이언트를 반복해서 설치해도 설정 문제는 해결되지 않습니다. 자세한 내용은 Linux 설치 및 설정 가이드를 참고하세요.
설치 후
구독·노드·프록시순서대로 연결 확인
01 / 가져오기
사용자 설정 불러오기
클라이언트 설치 파일에는 사용할 수 있는 노드가 포함되지 않습니다. 유효한 구독이나 공유 링크를 준비해 가져온 다음 노드 목록이 생성되는지 확인하세요. 구독 링크, 공유 링크, 기본 JSON은 가져오는 방법이 서로 다릅니다. 응답 형식이 맞지 않으면 새로고침을 반복하기보다 먼저 형식을 확인하세요.
02 / 시작
노드 및 트래픽 처리 방식 선택
활성 노드를 선택해 서비스를 시작하고 로그에 시작 오류가 없는지 먼저 확인하세요. 데스크톱에서는 시스템 프록시를 설정하고 Android에서는 VPN 연결을 허용합니다. TUN이 필요하다면 권한을 별도로 확인하세요. 처음 설정할 때는 연결 경로 하나만 활성화해 프록시가 여러 겹으로 적용되지 않도록 하세요.
03 / 확인
실제 요청 결과 확인
브라우저 접속과 외부 IP 확인으로 연결을 점검한 뒤 로그에서 요청과 라우팅 기록을 살펴보세요. 시스템에 연결 중이라고 표시되어도 서비스나 인터페이스가 시작되었을 뿐, 원격 노드가 작동한다는 뜻은 아닙니다. 문제가 생기면 노드 연결, 도메인 조회, 앱 트래픽 처리 중 어느 단계의 문제인지 먼저 구분하세요.
처음 설치한다면 새로운 크로스 플랫폼 UI를 사용하는 Desktop 버전부터 사용해 보세요. 기존 Windows 인터페이스와 사용 방식에 익숙하다면 클래식 WPF 버전을 선택할 수 있습니다. 두 버전 모두 노드나 구독을 직접 가져와야 합니다. 전환하기 전에 설정을 백업하고 기존 프로그램을 종료한 다음, 새 프로그램에서 수신 대기 포트와 프록시 설정을 확인하세요.
Android에서는 arm64와 범용 버전 중 무엇을 다운로드해야 하나요?
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 다만 최종적으로는 기기의 시스템에서 지원하는 앱 아키텍처를 확인해야 합니다. 아키텍처를 모르면 범용 버전을 선택할 수 있습니다. 설치 프로그램에서 호환되지 않는다고 표시되면 같은 파일을 반복해서 다운로드하지 말고 시스템 버전, 프로세서 아키텍처, 기존 앱의 서명을 먼저 확인하세요.
macOS에서 Apple Silicon과 Intel 설치 파일은 어떻게 구분하나요?
Apple 메뉴에서 ‘이 Mac에 관하여’를 열고 칩 또는 프로세서 항목을 확인하세요. Apple M 시리즈 칩이면 Apple Silicon용 arm64 패키지를, Intel 프로세서이면 Intel용 x64 패키지를 선택합니다. 구독 형식이나 사용하는 노드가 아니라 이 Mac의 하드웨어에 맞춰 아키텍처를 선택하세요.
클라이언트를 다운로드해 설치하면 바로 연결할 수 있나요?
클라이언트는 설정을 읽고 트래픽을 전달하는 프로그램이며, 설치 파일에는 바로 사용할 수 있는 구독이나 노드가 포함되지 않습니다. 설치 후 유효한 설정을 가져오고 활성 노드를 선택해 서비스를 시작해야 합니다. 이어서 플랫폼에 따라 시스템 프록시를 켜거나 VPN 연결을 허용하세요. 마지막으로 브라우저 요청, 외부 IP, 클라이언트 로그를 확인해 실제 연결 여부를 점검합니다.
업데이트 전에 어떤 설정을 백업해야 하나요?
먼저 구독 그룹, 사용자 지정 라우팅, DNS, 로컬 수신 대기 설정을 백업하고 현재 사용하는 코어와 프록시 모드를 기록하세요. 업데이트 전 실행 중인 클라이언트를 종료하고, 업데이트 후에는 기존 설정이 제대로 불러와졌는지 확인한 다음 연결을 테스트합니다. 구독 주소와 설정에 접근 자격 증명이 포함될 수 있으므로 백업 파일은 안전한 위치에 보관하세요.
Linux에서 deb와 rpm을 서로 바꿔 설치할 수 있나요?
배포판의 패키지 체계에 맞춰 선택해야 하며, 파일 확장자만 바꿔서는 안 됩니다. Debian·Ubuntu 계열은 보통 deb, Fedora·RHEL 계열은 보통 rpm을 사용합니다. x64 또는 arm64 아키텍처도 맞춰야 합니다. 같은 패키지 형식이라고 의존성이 모두 충족되는 것은 아니므로, 설치 중 의존성 누락이 표시되면 배포판 버전과 오류 내용을 먼저 확인하세요.