v2rayN
Desktop은 새로운 크로스 플랫폼 UI이고, WPF는 클래식 안정 버전입니다. WPF에 익숙하다면 클래식 버전을 계속 사용해도 됩니다. UI를 바꾸기 위해 모든 구독을 다시 정리할 필요는 없습니다.
두 파일 모두 ZIP 압축 파일입니다. 별도의 폴더에 압축을 푼 다음 안에 있는 설치 프로그램을 실행하세요. 압축 파일 미리보기 창에서 바로 실행하지 마세요.
Windows / x64
v2rayN Windows 다운로드
두 가지 UI 중 사용 방식에 맞는 버전을 선택하세요. 처음 설치한다면 Desktop 데스크톱 버전부터 시작해도 좋습니다.
macOS / Apple Silicon 및 Intel
v2rayN macOS 다운로드
‘이 Mac에 관하여’에서 칩 이름을 확인하고 해당하는 DMG 설치 파일을 선택하세요.
v2rayN
칩 항목에 Apple M 시리즈가 표시되면 Apple Silicon을, 프로세서 항목에 Intel이 표시되면 Intel을 선택하세요. 실제 하드웨어에 맞춰 설치 파일을 선택하고, 시스템 버전으로 프로세서 아키텍처를 판단하지 마세요.
DMG를 열고 화면 안내에 따라 ‘응용 프로그램’에 설치하세요. 설치가 끝나면 ‘응용 프로그램’에서 실행하고, 디스크 이미지 안에서 계속 실행하지 마세요.
Android / APK
v2rayNG Android 다운로드
먼저 v2rayNG를 확인하세요. V2Fly 코어 기반 설정 환경이 필요하다면 v2flyNG를 고려하세요.
v2rayNG
대부분의 Android 스마트폰은 arm64를 우선 선택하면 됩니다. v2rayNG는 구독 가져오기, 노드 선택, 앱별 프록시 등 GUI 설정을 지원하므로 일반적인 사용자는 이 클라이언트부터 시작하면 됩니다.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택하면 되지만, 시스템이 64비트 앱을 지원해야 합니다. 아키텍처를 모르면 범용 버전을 선택할 수 있습니다. 파일 용량이 더 크다고 연결 속도가 더 빠른 것은 아닙니다.
v2flyNG
기존 V2Fly 설정을 사용해야 하는 경우에 적합합니다. v2rayNG와는 코어가 다르므로 옮기기 전에 프로토콜과 전송 매개변수를 확인하세요. 화면 구성이 비슷하다고 기능까지 완전히 같다고 볼 수는 없습니다.
아키텍처 선택 방법은 v2rayNG와 같습니다. 두 앱의 데이터는 별도로 저장되므로 앱을 바꾼 뒤에는 설정을 다시 가져오고 라우팅과 앱별 설정을 확인해야 합니다.
설치 권한 및 첫 실행
APK를 다운로드한 다음 브라우저의 다운로드 기록이나 파일 관리자에서 여세요. 시스템에서 이 출처의 앱 설치를 허용하지 않는다고 표시되면 해당 출처의 권한 화면으로 이동해 이번 설치에 필요한 권한을 허용하세요. 권한은 설치 파일을 여는 앱에 적용됩니다. 브라우저로 다운로드한 뒤 파일 관리자에서 연다면 파일 관리자의 권한을 확인해야 합니다.
설치 후 사용 권한이 있는 구독이나 노드 정보를 가져온 다음 설정을 선택해 시작하세요. 처음 실행하면 시스템 VPN 연결 요청이 표시됩니다. 승인해야 로컬 트래픽 제어 채널을 만들 수 있습니다. 상태 표시줄의 연결 아이콘은 채널이 만들어졌다는 뜻일 뿐입니다. 웹페이지를 열어 DNS, 라우팅, 서버 설정이 모두 정상인지 확인하세요.
| 확인 항목 | 요구 사항 및 권장 사항 |
|---|---|
| arm64 설치 파일 | arm64-v8a 앱을 지원하는 Android 시스템에서 사용 가능 |
| 범용 설치 파일 | 아키텍처를 모를 때 사용하세요. 앱의 시스템 요구 사항은 충족해야 합니다 |
| 시스템 호환성 | 현재 APK에 대한 시스템 설치 프로그램의 호환성 판단을 따르세요 |
| 필요한 권한 | 설치 출처 허용, 첫 연결 시 VPN 요청 승인 |
| 백그라운드 실행 | 연결이 자주 끊기면 배터리 최적화와 백그라운드 활동 제한을 확인하세요 |
Linux / deb 및 rpm
v2rayN Linux 다운로드
먼저 배포판에 맞는 패키지 형식을 선택한 뒤 x64와 arm64를 확인하세요.
v2rayN
Debian 및 Ubuntu 계열은 보통 deb를 사용하고, RPM 패키지 관리자를 사용하는 배포판은 rpm을 확인하세요. 아래 기본 다운로드는 x64용입니다. arm64 기기는 아래의 해당 다운로드를 이용하세요.
arm64 기기용 다운로드
deb 다운로드 · arm64
rpm 다운로드 · arm64
다운로드부터 연결까지
설치 및 업데이트 준비
소프트웨어 설치, 설정 가져오기, 네트워크 확인을 나눠서 진행하세요. 문제가 발생한 단계부터 확인하면 됩니다.
처음 설치할 때: 사용할 설정 준비
v2rayN, v2rayNG, v2flyNG는 GUI 클라이언트이며, 설치 파일에는 바로 사용할 수 있는 서버 설정이 포함되어 있지 않습니다. 설치 전에 사용 권한이 있는 구독 주소나 노드 정보를 준비하세요. 구독 링크에는 접근 정보가 포함될 수 있으므로 원본 링크를 공개 댓글에 올리거나 문제 화면 캡처에 넣지 마세요.
가져온 뒤 목록에 설정이 표시되는지 확인하고 하나를 선택해 시작하세요. 첫 연결 테스트에서는 기본 라우팅 규칙이나 내용을 충분히 이해한 규칙을 사용하세요. 처음부터 DNS, 앱별 프록시, 고급 전송 설정을 한꺼번에 바꾸지 마세요. 연결이 확인된 뒤 하나씩 조정하면 문제가 생겨도 이전에 작동하던 상태로 쉽게 돌아갈 수 있습니다.
구독 가져오기 및 연결 단계 보기 →기존 설정이 있다면: 백업 후 업데이트
업데이트 전에 구독 그룹, 라우팅 규칙, 사용자 지정 설정을 내보내고 현재 사용 중인 모드를 기록하세요. 백업 파일에도 서버 정보와 접근 정보가 포함될 수 있으므로 본인이 관리하는 위치에 보관하세요. 노드 목록을 캡처하는 것만으로는 전체 설정을 복구하기 어렵습니다.
데스크톱에서는 먼저 트레이에서 종료하고 프로세스가 끝났는지 확인한 뒤 설치 프로그램을 실행하세요. Android에서 기존 앱 위에 설치할 때 서명 충돌 메시지가 표시되면 이전 앱의 정체와 출처를 먼저 확인하세요. 설치를 계속하려고 바로 삭제하지 마세요. 제거하면 구독, 라우팅, 로컬 설정이 삭제될 수 있습니다.
업데이트 후에는 활성 설정이 계속 선택되어 있는지 확인하고 연결을 다시 테스트하세요. 이전 설정을 가져올 수 있더라도 모든 코어 필드가 계속 적용되는 것은 아닙니다. 사용자 지정 JSON을 사용한다면 설명서를 참고해 필드와 구조를 확인하세요.
JSON 설정 설명서 보기 →오류 발생 시 기록할 정보
클라이언트 이름, 시스템 종류, 기기 아키텍처, 선택한 설치 파일, 전체 오류 메시지를 기록하세요. 프로그램이 시작되지 않으면 설치 프로그램 정보를 먼저 확인하고, 실행된다면 클라이언트 로그를 확인하세요. 로그를 공유하기 전에 구독 주소, 사용자 식별 정보, 서버 인증 정보를 가리고 오류 필드와 주변 내용만 남기세요.
‘다운로드 완료’, ‘설치 성공’, ‘채널 연결’, ‘웹페이지 접속 가능’을 같은 상태로 보지 마세요. 각각 파일 다운로드, 시스템 호환성, 설정 실행, 실제 네트워크 연결 단계에 해당합니다. 어느 단계에서 문제가 생겼는지 구분하면 반복해서 제거하고 다시 설치하는 것보다 원인을 찾기 쉽습니다.
다운로드 관련 자주 묻는 질문
설치 파일 선택 방법
아키텍처, UI 버전, 기존 앱 위에 업데이트하는 방법을 먼저 확인하세요.
Android 스마트폰은 arm64와 범용 중 무엇을 다운로드해야 하나요?
2015년 이후 출시된 대부분의 Android 스마트폰은 arm64를 우선 선택하면 됩니다. 다만 시스템이 64비트 앱을 지원하는지 확인해야 합니다. 기기 아키텍처를 모르거나 설치 중 아키텍처 호환 오류가 발생하면 범용 버전을 선택하세요. 범용 버전은 여러 아키텍처 구성 요소를 포함해 용량이 더 클 수 있지만, 연결 속도가 더 빠르다는 뜻은 아닙니다.
Windows용 Desktop과 WPF 중 무엇을 선택해야 하나요?
Desktop은 새로운 크로스 플랫폼 UI를 사용하므로 처음 설치한다면 먼저 선택해 보세요. WPF는 익숙한 조작 방식과 레이아웃을 선호하는 사용자에게 적합한 클래식 안정 버전입니다. 둘 다 v2rayN입니다. UI 버전을 바꾸기 전에 구독, 라우팅, 사용자 지정 설정을 백업하고 두 인스턴스가 동시에 시스템 프록시를 제어하지 않도록 하세요.
클라이언트를 업데이트하기 전에 이전 버전을 제거해야 하나요?
먼저 구독, 라우팅, 사용자 지정 설정을 내보내고 실행 중인 클라이언트를 종료하세요. Android 앱은 패키지명과 서명이 호환되면 보통 기존 앱 위에 업데이트할 수 있습니다. 서명 충돌 메시지가 표시되면 서둘러 제거하지 말고 설치 출처와 앱의 정체를 먼저 확인하세요. 데스크톱은 설치 프로그램 안내에 따라 업데이트한 뒤 설정과 시스템 프록시 상태를 확인하세요.
클라이언트를 다운로드한 뒤 바로 연결할 수 있나요?
클라이언트는 설정을 읽고 연결을 구성하는 프로그램이며, 설치 파일에는 바로 사용할 수 있는 서버 설정이 포함되어 있지 않습니다. 사용 권한이 있는 구독 주소나 노드 정보를 준비해 가져온 다음 설정을 선택하고 연결을 시작하세요. Android에서는 첫 실행 시 시스템 VPN 연결 요청도 승인해야 합니다.
설치에 실패하면 무엇부터 확인해야 하나요?
먼저 전체 오류 메시지를 기록한 뒤 패키지 형식, 프로세서 아키텍처, 시스템 호환성, 사용 가능한 저장 공간을 확인하세요. Android에서는 현재 브라우저나 파일 관리자의 앱 설치 권한도 확인하고, Linux에서는 소프트웨어 설치 프로그램이 표시한 의존성 정보를 살펴보세요. 다운로드가 완료되지 않았다면 파일을 다시 받은 뒤 실행하세요. 파일 아이콘만 보고 설치 가능 여부를 판단하지 마세요.