클라이언트 설치 파일 / 4개 플랫폼
데스크톱에서는 v2rayN을 선택하세요. Android는 v2rayNG를 권장하며, V2Fly 코어가 필요하다면 v2flyNG를 선택하세요.
먼저 운영체제를 선택한 다음 CPU 아키텍처를 확인하세요. 세 클라이언트는 모두 무료 오픈 소스 소프트웨어입니다. 구독 주소와 노드 설정은 별도로 준비해야 합니다. 설치 파일 이름, 클라이언트 버전, 코어 버전은 각각 다른 정보이므로 플랫폼·아키텍처·파일 형식에 맞춰 선택하세요.
v2rayN은 하나, 인터페이스는 두 가지입니다. 처음 설치한다면 Desktop부터 사용해 보세요.
차세대 크로스 플랫폼 UI입니다. 처음 설치하거나 여러 데스크톱 운영체제에서 비슷한 인터페이스를 사용하고 싶다면 적합합니다.
v2rayN 다운로드 · Desktopx64 · ZIP 설치 파일
익숙한 Windows 인터페이스와 사용 방식을 유지하는 안정적인 클래식 버전입니다. 기존 사용 방식에 익숙하다면 계속 선택해도 좋습니다.
v2rayN 다운로드 · WPFx64 · ZIP 설치 파일
| 확인 항목 | 선택 기준 |
|---|---|
| 시스템 아키텍처 | 이 페이지의 Windows 설치 파일은 x64입니다. ‘설정 → 시스템 → 정보’에서 ‘시스템 종류’를 확인하세요. |
| 운영체제 버전 | 시스템 업데이트가 제공되는 Windows 10 또는 11을 권장합니다. 구형 운영체제는 현재 클라이언트와 런타임의 호환 조건을 먼저 확인하세요. |
| 설치 권한 | 일반 시스템 프록시와 TUN은 다릅니다. 가상 네트워크 어댑터 관련 기능을 사용할 때는 관리자 권한이 필요할 수 있습니다. |
ZIP 파일을 다운로드한 뒤 일반 폴더에 압축을 풀고 안에 있는 설치 프로그램을 실행하세요. 압축 파일 미리보기에서 바로 실행하지 마세요. 설치 위치는 파일을 읽고 쓸 수 있는 곳으로 지정하세요. 기존 버전이 있다면 로컬 수신 포트를 두 프로그램이 동시에 사용하지 않도록 트레이에서 v2rayN을 먼저 종료하세요.
처음 실행한 뒤 상단의 ‘구독 그룹’ 메뉴에서 ‘구독 그룹 설정’을 열고 그룹 이름과 구독 주소를 추가한 다음 구독을 업데이트하세요. 서버 목록에 노드가 표시되면 하나를 선택해 활성 서버로 지정합니다. 마지막으로 트레이 메뉴에서 시스템 프록시를 설정하세요. 클라이언트만 실행하고 활성 노드를 지정하거나 앱 트래픽을 전달하도록 설정하지 않으면 브라우저는 기존 연결 방식을 계속 사용할 수 있습니다.
Desktop과 WPF는 메뉴 배치가 다를 수 있으며, 프로그램 파일만 복사해서 설정을 옮기는 것은 권장하지 않습니다. 구독 그룹, 라우팅 선택, 로컬 포트를 기록한 뒤 현재 버전의 백업 또는 내보내기 기능으로 설정을 보관하세요. 런타임 구성 요소가 없다는 안내가 나오면 설치 프로그램의 지침에 따라 필요한 항목을 확인하세요. 다른 인터페이스 버전을 반복해서 설치하는 방식으로 해결하지 마세요.
‘이 Mac에 관하여’에서 칩을 확인한 다음 해당 DMG를 선택하세요.
‘이 Mac에 관하여’에 Apple M 시리즈 칩이 표시되면 arm64를 선택해 칩에 맞는 설치 파일을 사용하세요.
v2rayN 다운로드 · Apple Siliconarm64 · DMG
‘이 Mac에 관하여’에 Intel 프로세서가 표시되면 x64를 선택하세요. 컴퓨터를 구입한 연도만으로 아키텍처를 판단하지 마세요.
v2rayN 다운로드 · Intelx64 · DMG
| 확인 항목 | 선택 기준 |
|---|---|
| 칩 아키텍처 | Apple 메뉴 → 이 Mac에 관하여에서 ‘칩’ 또는 ‘프로세서’ 항목을 확인하세요. |
| 운영체제 버전 | 현재 클라이언트가 지원하는 macOS 버전을 사용하세요. 구형 시스템에서는 실행 시 안내되는 최소 버전을 확인해야 합니다. |
| 네트워크 권한 | 시스템 프록시와 TUN은 서로 다른 트래픽 처리 방식입니다. 네트워크 확장이나 권한 상승이 필요할 때는 먼저 시스템 권한 안내를 확인하세요. |
DMG를 연 다음 앱을 ‘응용 프로그램’ 폴더로 복사하고 그 위치에서 실행하세요. 마운트된 디스크 이미지에서 계속 실행하면 업데이트, 권한 기록, 실행 위치가 혼동될 수 있습니다. 시스템에서 실행을 차단하면 다운로드 출처와 시스템 안내를 확인한 뒤 ‘시스템 설정 → 개인정보 보호 및 보안’에서 관련 기록을 살펴보세요. 한 번 설치하기 위해 시스템 전체의 보안 기능을 끄지 마세요.
구독을 가져온 뒤 활성 노드를 선택하고 프록시를 설정하세요. ‘시스템 설정 → 네트워크’에서 현재 네트워크 서비스를 선택한 다음 ‘세부사항 → 프록시’로 이동하면 시스템 프록시의 로컬 주소와 포트가 클라이언트에 표시된 값과 일치하는지 확인할 수 있습니다. 앱 자체의 프록시 설정이 시스템 설정을 덮어쓸 수도 있습니다. 브라우저가 연결된다고 해서 모든 프로그램이 프록시를 사용하는 것은 아닙니다.
업데이트 전에 메뉴 막대의 클라이언트를 종료한 뒤 ‘응용 프로그램’ 폴더의 기존 앱을 교체하세요. 새 버전을 실행했는데 설정이 비어 있다면 원래 앱이 있던 위치와 같은 사용자 계정으로 실행했는지 먼저 확인하세요. 권한 요청이 반복되면 DMG나 이전 복사본에서 실행 중인지 살펴보세요. 구분하기 어려운 앱 복사본을 여러 개 남기지 마세요.
먼저 클라이언트를 선택한 다음 arm64 또는 범용 버전을 고르세요. 두 앱은 각각 별도로 설정을 관리합니다.
일반적인 Android 사용에 권장합니다. 구독 관리와 노드 가져오기를 지원하고, 시스템 VPN 인터페이스로 트래픽을 처리합니다. 지원 프로토콜은 앱에 포함된 코어에 따라 다릅니다.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택하면 됩니다. 아키텍처가 확실하지 않다면 범용 버전을 선택하세요. 기기의 시스템에서 실제로 지원하는 ABI를 기준으로 해야 합니다.
V2Fly 설정이 필요한 사용자에게 적합합니다. v2rayNG와는 별도의 앱입니다. 클라이언트를 바꾸기 전에 노드 프로토콜과 전송 설정이 새 코어에서 인식되는지 확인하세요.
arm64는 64비트 ARM 시스템용입니다. 범용 버전은 더 많은 아키텍처를 지원하지만 설치 파일 크기가 더 클 수 있습니다.
| 확인 항목 | 선택 기준 |
|---|---|
| 시스템 호환성 | 현재 APK에 대한 Android 설치 프로그램의 호환성 안내를 따르세요. 프로세서가 64비트를 지원해도 시스템에 64비트 실행 환경이 제공된다는 뜻은 아닙니다. |
| 설치 권한 | APK를 실제로 여는 브라우저나 파일 관리자에 ‘알 수 없는 앱 설치’ 권한을 허용하세요. 설치가 끝나면 권한을 다시 해제할 수 있습니다. |
| VPN 인터페이스 | 처음 연결할 때 시스템 VPN 권한을 허용해야 합니다. 일반적으로 같은 VPN 인터페이스를 사용하는 다른 앱과 동시에 트래픽을 처리할 수 없습니다. |
APK를 다운로드한 뒤 다운로드 기록이나 파일 관리자에서 여세요. 휴대전화마다 설정 메뉴 이름은 조금씩 다를 수 있습니다. ‘설정’에서 ‘알 수 없는 앱 설치’를 검색하고, 파일을 여는 앱에만 권한을 허용하세요. 설치 프로그램에 ‘앱이 설치되지 않았습니다’라고 표시되면 저장 공간, 시스템 버전, CPU 아키텍처, 기존 앱의 서명을 먼저 확인하세요. 기존 앱을 바로 삭제하지 마세요.
v2rayNG의 사이드 메뉴에서 ‘구독 그룹 설정’을 열어 주소를 추가한 뒤 메인 화면 메뉴에서 구독을 업데이트할 수 있습니다. 노드 공유 링크가 있다면 추가 메뉴의 클립보드 가져오기 기능도 사용할 수 있습니다. 노드가 표시되면 눌러 선택하고 연결 버튼을 누른 다음 시스템에 표시되는 VPN 연결 요청을 승인하세요. 구독 업데이트가 완료된 것과 서비스에 연결된 것은 별개이므로 각각 확인해야 합니다.
백그라운드에서 연결이 끊긴다면 시스템의 ‘앱 정보’에서 배터리 및 백그라운드 활동 제한을 확인하세요. 일부 기기는 화면을 잠근 뒤 네트워크 활동을 제한합니다. 관련 권한을 조정하기 전에 앱을 화면에 띄운 상태에서 연결이 안정적인지 먼저 확인하세요. v2flyNG로 전환할 때는 구독 주소나 호환되는 공유 링크를 다시 가져와야 합니다. 앱별 데이터는 두 클라이언트 간에 자동으로 동기화되지 않습니다.
배포판에 맞는 deb 또는 rpm을 고른 뒤 x64인지 arm64인지 확인하세요.
Debian, Ubuntu 등 deb 패키지 관리 방식을 사용하는 배포판용입니다. 기본 다운로드는 일반적인 Intel/AMD 64비트 데스크톱 아키텍처에 맞춰져 있습니다.
v2rayN 다운로드 · x64 deb ARM 기기: arm64 deb 다운로드 →RPM 패키지 관리 방식을 사용하는 배포판용입니다. 패키지에 특정 시스템 라이브러리 버전이 필요할 수 있으며, 형식이 맞더라도 모든 배포판에 설치되는 것은 아닙니다.
v2rayN 다운로드 · x64 rpm ARM 기기: arm64 rpm 다운로드 →| 확인 항목 | 선택 기준 |
|---|---|
| 패키지 관리 형식 | 시스템 소프트웨어 센터나 배포판 안내에서 deb와 rpm 중 어떤 형식을 사용하는지 확인하세요. 데스크톱의 겉모습만으로 판단하면 안 됩니다. |
| 프로세서 아키텍처 | x64는 amd64 / x86_64, arm64는 aarch64에 해당합니다. 시스템의 ‘정보’ 또는 하드웨어 정보에서 확인하세요. |
| 데스크톱 및 종속성 | 그래픽 데스크톱 환경과 설치 프로그램이 요구하는 시스템 라이브러리가 필요합니다. 소프트웨어 관리자에서 종속성 검사 결과를 확인하세요. |
다운로드한 패키지를 시스템 소프트웨어 설치 프로그램으로 열고 종속성 및 호환성 안내를 읽은 뒤 설치를 진행하세요. 종속성을 충족할 수 없다는 오류가 나오면 배포판 버전이 패키지 요구 사항에 맞는지 먼저 확인하세요. 종속성을 무시하도록 강제하지 말고, RPM 형식이 같다는 이유만으로 다른 배포판에도 설치할 수 있다고 단정하지 마세요.
v2rayN을 실행한 뒤 구독을 가져오고 활성 노드를 선택하세요. Linux 데스크톱의 시스템 프록시는 보통 데스크톱 환경에서 관리되며, 앱마다 설정을 따르는 정도가 다릅니다. GNOME에서는 ‘설정 → 네트워크 → 네트워크 프록시’에서 확인할 수 있습니다. 다른 데스크톱 환경에서는 해당 네트워크 프록시 설정을 찾으세요. 터미널 프로그램이나 자체 네트워크 스택을 사용하는 앱은 별도로 설정해야 할 수 있습니다.
TUN은 가상 네트워크 장치와 권한을 사용하므로 시스템 프록시와 혼동하면 안 됩니다. 처음 테스트할 때는 한 가지 트래픽 처리 방식만 사용해 로컬 포트, 노드, 라우팅이 정상인지 확인한 뒤 다른 기능을 추가하세요. 업데이트 전에는 기존 프로세스를 종료하고 설정을 백업하세요. deb와 rpm을 바꾸거나 다른 아키텍처를 선택해도 정상적인 설정 이전을 대신할 수 없으며 노드 서비스 자체의 연결 문제도 해결되지 않습니다.
설치는 준비 단계일 뿐입니다. 구독, 노드, 트래픽 처리 순으로 확인하면 문제를 더 쉽게 찾을 수 있습니다.
구독 주소가 온전한지 확인하고 업데이트 후 목록에 예상한 노드가 표시되는지 살펴보세요. 업데이트에 실패하면 먼저 로그를 확인해 주소 만료, 네트워크 요청 실패, 형식 파싱 오류를 구분하세요. 오류를 숨기려고 같은 그룹을 반복해서 가져오지 마세요.
구독 가져오기 단계 보기 →구독 그룹은 활성 노드가 아닙니다. 서버를 선택한 다음 연결을 시작하고, 로그에서 수신 포트 충돌, 누락된 프로토콜 필드, 핸드셰이크 오류를 확인하세요. 목록에 표시된 이름은 메모일 뿐, 서비스가 정상 작동한다는 뜻은 아닙니다.
연결 및 확인 단계 보기 →시스템 프록시는 앱이 해당 설정을 따르는 경우에만 적용되고, TUN은 가상 네트워크 어댑터로 트래픽을 처리합니다. 실제로 어떤 방식을 사용 중인지 확인한 다음 라우팅 규칙을 점검하세요. 특정 사이트가 직접 연결되는 것은 분할 라우팅의 결과일 수 있으므로 페이지가 열리는지만으로 판단하지 마세요.
전체 플랫폼 설정 가이드 보기 →사용 가능 여부는 클라이언트 인터페이스 버전, 코어의 프로토콜 지원, 서버 설정에 따라 달라집니다. Project V, V2Fly, Xray는 관련 기술 생태계에 속하지만 설정에서 서로 마음대로 바꿔 쓸 수 있는 이름은 아닙니다. 특수한 전송 방식이나 보안 설정을 사용 중이라면 노드를 옮기기 전에 대상 클라이언트의 코어가 이를 지원하는지 확인하세요. 세 클라이언트의 차이는 클라이언트 비교에서 확인할 수 있습니다.
설치 파일 선택, 업데이트, 첫 연결에 관한 내용을 정리했습니다. 그 밖의 네트워크 문제는 자주 묻는 질문을 확인하세요.
클라이언트는 설정을 관리하고 트래픽을 전달하는 프로그램이며, 설치 파일에 노드 서비스가 포함되는 것은 아닙니다. 사용할 권한이 있는 구독 주소나 노드 공유 링크를 준비해 클라이언트에 가져오세요. 구독 주소에 접속 정보가 포함될 수 있으니 공개 게시물이나 스크린샷에 노출하지 마세요.
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 제공하는 Desktop을 권장합니다. WPF는 익숙한 Windows 사용 방식을 선호하는 사용자를 위한 클래식 안정 버전입니다. 둘 다 v2rayN이며, 이 페이지의 설치 파일은 모두 x64입니다. 인터페이스 버전을 바꾸기 전에 설정을 백업하고 클라이언트를 두 개 동시에 실행하지 마세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 다만 최종적으로는 시스템에서 지원하는 ABI를 기준으로 해야 하며, 프로세서 이름만으로 판단하면 안 됩니다. 아키텍처를 확인하기 어렵다면 범용 버전을 선택하세요. 설치 중 파싱 오류가 발생하면 Android 버전, 다운로드 완료 여부, 기존 앱과 서명이 같은지도 확인하세요.
먼저 설정을 백업하고 기존 클라이언트를 종료하세요. 같은 앱이며 서명, 아키텍처, 설치 방식이 일치하면 대체로 덮어써서 업데이트할 수 있습니다. Android에서 서명 충돌이 발생해도 앱 데이터가 사라질 수 있으니 바로 삭제하지 마세요. 설치 경로를 확인하고 설정을 내보내세요. 데스크톱에서 설치 위치나 인터페이스 버전을 바꿀 때도 기존 설정을 보관해야 합니다.
바로 다시 다운로드하지 말고 노드, 구독, 트래픽 처리 방식을 먼저 확인하세요. v2rayN 서버 목록에서 활성 노드를 확인하고 하단 로그를 살펴본 뒤 시스템 프록시를 점검하세요. Android에서는 VPN 연결을 허용하고 서비스가 실행 중인지 확인합니다. 포트 충돌, 만료된 구독, 시스템 시간 오류, 잘못된 TLS 설정은 재설치로 해결되지 않습니다.