v2rayN
추천 7.24.1Desktop은 차세대 크로스 플랫폼 UI를 사용합니다. 클래식 WPF 버전은 익숙한 Windows 인터페이스를 유지하는 안정적인 클래식 버전입니다. 처음 설치한다면 Desktop을 권장하며, 기존 인터페이스 사용이 익숙한 경우에는 WPF 버전을 선택하세요.
다운로드가 끝나면 ZIP 파일의 압축을 푼 뒤 안에 있는 설치 프로그램을 실행하세요. 압축 파일 미리보기 창에서 바로 실행하지 마세요.
- 클라이언트 설치 파일 · OS별 선택
- Xray / V2Fly 생태계
V2Ray 클라이언트 다운로드
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 권장합니다. 먼저 운영체제를 확인하고 CPU 아키텍처를 선택하세요.
세 클라이언트 모두 무료 오픈 소스 소프트웨어입니다. 설치 파일은 클라이언트를 설치하는 데 사용하며, 연결에 필요한 구독 URL이나 서버 설정은 별도로 준비해야 합니다.
01 / 설치 파일 선택
OS 및 클라이언트
선택한 플랫폼은 URL에 저장됩니다. 페이지를 공유할 때 해당 OS 섹션으로 바로 이동하는 주소를 사용할 수도 있습니다.
Windows 클라이언트
Windows 시스템 요구 사항 및 설치 조건
| 확인 항목 | 선택 기준 | 확인 방법 |
|---|---|---|
| OS 및 아키텍처 | 이 페이지에서는 Windows x64 설치 파일을 제공합니다. 해당 파일을 지원하는 64비트 Windows가 필요합니다. | 설정 → 시스템 → 시스템 정보에서 시스템 종류와 OS 버전을 확인하세요. |
| 실행 환경 | 최소 OS 버전과 런타임 요구 사항은 설치 프로그램의 확인 메시지를 기준으로 하세요. | 필수 구성 요소가 없다는 메시지가 표시되면 구성 요소 이름을 기록한 뒤 해결하세요. 같은 설치를 반복해서 덮어쓰지 마세요. |
| 설치 경로 및 권한 | 설치 경로에 쓰기 권한이 있어야 합니다. 시스템 프록시 변경이나 TUN 사용 시 필요한 권한은 달라질 수 있습니다. | 먼저 일반 권한으로 실행하고, 권한 요청이 표시될 때만 요청 내용을 확인하세요. |
설치 후 메인 창을 열고 구독 그룹 메뉴를 찾으세요. 그룹을 추가할 때 알아보기 쉬운 별칭을 입력하고 전체 구독 URL을 붙여 넣어 저장합니다. 그런 다음 구독을 업데이트해 서버 설정을 불러왔는지 확인하세요. URL을 입력했다고 업데이트가 완료된 것은 아니므로 화면이나 로그에서 결과를 확인해야 합니다.
서버를 선택한 다음 시스템 프록시를 ‘시스템 프록시 자동 설정’으로 지정하세요. 이 설정은 시스템 프록시를 따르는 앱의 연결을 클라이언트로 전달합니다. 모든 프로그램이 자동으로 연결되는 것은 아닙니다. 먼저 브라우저로 확인하고, 특정 프로그램에서만 작동하지 않을 때 해당 프로그램의 프록시 설정을 살펴보거나 TUN 모드를 알아보세요.
WPF 버전에서 Desktop으로 바꾸기 전에 구독과 사용자 지정 규칙을 백업하세요. 인터페이스가 다르면 메뉴 위치도 달라질 수 있으므로 버튼 이름만 보고 데이터가 이전됐다고 판단하면 안 됩니다. 포트 충돌과 시스템 프록시 설정 덮어쓰기를 줄이려면 기존 인스턴스를 종료한 뒤 다른 버전을 실행하세요.
macOS 클라이언트
v2rayN
7.24.1Apple Silicon 칩에는 arm64, Intel 프로세서에는 x64를 선택하세요. 시스템 메뉴에서 ‘이 Mac에 관하여’를 열어 칩 이름 또는 Intel 프로세서로 표시되는지 확인한 뒤 알맞은 설치 파일을 선택하세요.
DMG를 열고 창의 안내에 따라 ‘응용 프로그램’에 설치한 다음 설치된 위치에서 클라이언트를 실행하세요.
macOS 시스템 요구 사항 및 설치 조건
| 확인 항목 | 선택 기준 | 확인 방법 |
|---|---|---|
| 칩 아키텍처 | Apple Silicon은 arm64, Intel은 x64에 해당합니다. | 시스템 메뉴 → 이 Mac에 관하여 |
| OS 버전 | 설치 파일의 요구 사항을 충족해야 합니다. 오래된 OS에서는 설치 및 실행 시 표시되는 안내를 먼저 확인하세요. | ‘이 Mac에 관하여’에서 macOS 버전을 확인하고 호환되지 않는다는 메시지가 표시되면 전체 내용을 기록하세요. |
| 네트워크 권한 | 시스템 프록시 설정과 TUN 활성화에는 각각 다른 권한 요청이 표시될 수 있습니다. | 시스템 설정 → 개인정보 보호 및 보안, 네트워크 관련 설정 |
처음 실행할 때 시스템이 차단하면 앱 출처와 설치 위치를 확인한 뒤 ‘개인정보 보호 및 보안’에서 허용 옵션이 있는지 살펴보세요. 앱 하나를 실행하기 위해 시스템 전체의 보안 기능을 끄지 마세요. 파일 손상, 아키텍처 불일치, OS 버전 부족 메시지는 각각 원인을 확인해야 하며 모두 같은 권한 문제로 취급하면 안 됩니다.
구독을 가져온 뒤 업데이트하고 사용할 서버를 선택하세요. 시스템 프록시는 앱의 연결을 클라이언트로 전달하고, 라우팅은 전달된 연결을 어떻게 처리할지 정합니다. 브라우저에서는 접속되지만 특정 데스크톱 프로그램에서 안 된다면 해당 프로그램이 시스템 프록시를 사용하는지 먼저 확인하세요.
클라이언트를 종료하기 전에 클라이언트가 설정한 시스템 프록시를 해제할 수 있습니다. 앱이 비정상 종료된 뒤 네트워크 접속에 문제가 생기면 네트워크 설정에 로컬 프록시 주소가 남아 있는지 확인하세요. 클라이언트를 다시 실행하거나 기존 프록시 설정을 복원하는 편이 반복해서 재설치하는 것보다 문제 해결에 효과적입니다.
Android 클라이언트
v2rayNG
추천 2.2.6Xray 코어를 사용하므로 Xray 설정 요구 사항에 맞춰 Android 클라이언트를 선택하세요. 2015년 이후 출시된 대부분의 스마트폰에서는 arm64를 우선 선택할 수 있습니다. 기기 아키텍처를 모른다면 범용 버전을 고려하고, OS에서 해당 앱 버전의 설치를 허용하는지 확인하세요.
매니페스트의 버전 정보와 패키지 이름에 표시된 버전이 일시적으로 다를 수 있습니다. 파일 이름을 바꿔 실제 설치 버전을 추측하거나 변경하지 말고 설치 화면에 표시되는 정보를 기준으로 하세요.
v2flyNG
대안 · V2Fly 코어 1.10.31기존에 V2Fly 설정을 사용하고 있는 경우에 적합합니다. v2rayNG와 코어가 다르므로 두 앱을 이름만 다른 동일한 프로그램으로 보지 말고, 선택 전에 프로토콜, 전송 방식, 보안 매개변수를 확인하세요.
사용 중인 설정이 있다면 기존 앱과 설정을 먼저 백업한 뒤 대체 클라이언트와 호환되는지 테스트하세요.
Android 시스템 요구 사항 및 설치 조건
| 확인 항목 | 선택 기준 | 확인 방법 |
|---|---|---|
| CPU 및 OS | arm64를 사용하려면 OS가 해당 64비트 앱을 지원해야 합니다. 하드웨어가 지원하더라도 OS에서 지원하지 않을 수 있습니다. | 기기 사양과 시스템 정보를 확인하세요. 확실하지 않으면 범용 버전을 사용해 보세요. |
| 설치 조건 | OS 버전이 APK 요구 사항을 충족하고 저장 공간이 충분해야 합니다. | 설정 → 휴대전화 정보. 설치에 실패하면 오류 메시지 전체를 확인하세요. |
| 설치 및 연결 권한 | 앱 설치 출처 권한과 VPN 연결 권한은 서로 다른 권한입니다. | 현재 사용하는 브라우저나 파일 관리 앱에만 설치 권한을 허용하고, 연결 시 표시되는 시스템 팝업을 확인하세요. |
APK 설치 중 현재 출처에서 앱을 설치하도록 허용하라는 메시지가 표시되면 이번에 사용하는 다운로드 앱이나 파일 관리자에만 권한을 부여하세요. 설치가 끝나면 해당 권한을 해제할 수 있습니다. 앱에 ‘설치되지 않음’이 표시되면 아키텍처 외에도 OS 버전, 기존 앱과 서명 충돌 여부, 다운그레이드 시도 여부, 저장 공간을 확인하세요.
클라이언트를 열고 구독 그룹을 추가한 뒤 설정을 업데이트하세요. 서버를 선택하고 연결을 누르면 됩니다. 처음 연결할 때는 보통 시스템에서 VPN 권한을 요청합니다. 이는 클라이언트가 로컬 네트워크 트래픽을 처리하도록 허용하는 것이며, 구독이 유효하다는 뜻도 서버 연결이 확인됐다는 뜻도 아닙니다.
연결 후 일정 시간이 지나면 시스템이 앱을 종료하는 경우 배터리 최적화, 백그라운드 활동, 자동 시작 설정을 확인하세요. 제조사마다 메뉴 이름이 다르므로 실제 기기 화면을 기준으로 살펴보세요. VPN 연결을 사용하는 앱을 여러 개 동시에 실행하면 충돌할 수 있습니다. 구독이 만료된 것으로 오해하지 않도록 문제를 확인할 때는 앱 하나만 연결하세요.
Linux 클라이언트
v2rayN
7.24.1먼저 배포판에 맞춰 deb 또는 rpm을 선택한 다음 기기 아키텍처에 맞는 x64 또는 arm64를 선택하세요. Ubuntu와 Debian 계열은 보통 deb를 사용합니다. RPM 패키지 관리자를 사용하는 배포판에서는 rpm을 선택하고 패키지의 의존성이 현재 배포판과 호환되는지 확인하세요.
이 페이지에서는 그래픽 클라이언트를 제공합니다. 데스크톱 세션이 필요하며, 패키지 형식이 같아도 모든 배포판에서 의존성을 충족하는 것은 아닙니다.
Linux 시스템 요구 사항 및 설치 조건
| 확인 항목 | 선택 기준 | 확인 방법 |
|---|---|---|
| 패키지 형식 | 배포판에서 지원하는 deb 또는 rpm 패키지를 사용하세요. | 배포판의 소프트웨어 센터, 시스템 안내 또는 패키지 관리자에서 확인하세요. |
| CPU 아키텍처 | amd64 / x86_64는 x64에 해당하며 aarch64는 보통 arm64에 해당합니다. | 시스템 정보에서 CPU 아키텍처를 확인하세요. 기기 브랜드만 보고 판단하지 마세요. |
| 데스크톱 환경 및 의존성 | 그래픽 데스크톱 환경과 설치 파일이 요구하는 런타임 의존성이 필요합니다. | 설치 프로그램의 의존성 검사와 실행 오류 메시지를 확인하세요. 누락된 의존성을 무시하고 설치를 강행하지 마세요. |
| 프록시 권한 | 데스크톱 프록시 설정 권한과 TUN 네트워크 장치 권한은 따로 처리해야 합니다. | 데스크톱 환경의 네트워크 설정과 클라이언트가 요청하는 권한을 확인하세요. |
다운로드한 패키지는 배포판의 소프트웨어 설치 프로그램으로 여세요. 의존성과 변경 사항을 먼저 확인한 뒤 설치를 진행하세요. 의존성을 충족할 수 없다는 메시지가 표시되면 현재 배포판에서 사용할 수 있는 패키지인지 먼저 확인하세요. 확장자를 바꿔 rpm을 deb로 변환할 수는 없으며, 패키지 관리자를 우회해 시스템 파일을 강제로 덮어쓰는 것도 권장하지 않습니다.
처음 실행한 뒤 구독을 가져오고 설정을 업데이트한 다음 서버를 선택하세요. Linux의 시스템 프록시 작동 방식은 데스크톱 환경과 앱에 따라 다릅니다. 일부 터미널 프로그램이나 독립 네트워크 도구는 데스크톱 프록시 설정을 자동으로 사용하지 않습니다. 따라서 클라이언트가 실행 중인지와 대상 프로그램이 프록시를 사용하는지는 각각 확인해야 합니다.
TUN을 사용하기 전에 일반 프록시 모드에서 서버 연결을 확인한 다음 네트워크 장치와 라우팅 권한을 설정하세요. 이렇게 하면 서버 설정 문제와 로컬 권한 문제를 구분할 수 있습니다. 데스크톱 트레이에 아이콘이 표시되지 않으면 먼저 데스크톱 환경이 트레이를 지원하는지 확인하세요. 아이콘이 없다고 클라이언트가 실행되지 않았다고 단정하지 마세요.
02 / 설치 파일 이름 쉽게 읽기
아키텍처, 파일 형식, 인터페이스 버전
파일 이름의 각 부분은 서로 다른 정보를 알려줍니다. 파일 형식은 설치 방법을, 아키텍처는 해당 기기에서 프로그램을 실행할 수 있는지를 나타냅니다.
실제 패키지 이름 예시
Desktop-Setup-x64
macos-arm64.dmg
arm64-v8a.apk
amd64.deb
aarch64.rpm
쉽게 설명하면
Desktop은 인터페이스 버전이고 x64는 CPU 아키텍처입니다. 두 항목은 서로 대체할 수 없습니다. arm64, arm64-v8a, aarch64는 모두 64비트 ARM 계열을 가리키지만 플랫폼별 명명 방식이 다릅니다.
확장자에 따라 설치 방법이 달라집니다. DMG는 macOS, APK는 Android용이며 deb와 rpm은 Linux 배포판의 패키지 관리자가 처리합니다. 파일 이름에 있는 숫자의 크기만 보고 설치 파일을 선택하지 마세요.
아키텍처를 모른다면 시스템 정보부터 확인하세요
제품명만으로는 실제 실행 환경을 모두 알 수 없습니다. 같은 제품군의 컴퓨터라도 프로세서가 다를 수 있고, 하드웨어가 64비트를 지원해도 설치된 OS에서 해당 앱을 실행하지 못할 수 있습니다. 시스템 정보에서 CPU와 OS 종류를 확인한 뒤 이 페이지에서 설치 파일을 선택하세요. 여러 버전을 잇달아 다운로드하는 것보다 문제를 파악하기 쉽습니다.
설치 프로그램에서 호환되지 않는다는 메시지가 표시되면 원문을 그대로 보관하세요. 아키텍처 불일치, OS 버전 부족, 런타임 의존성 누락, 앱 서명 충돌은 해결 방법이 서로 다릅니다. 범용 버전은 여러 아키텍처를 포함하는 문제를 해결하는 데 도움이 되지만, 오래된 시스템에 없는 기능을 추가하거나 모든 설치 오류를 해결해 주지는 않습니다.
03 / 설치 후 진행 순서
구독을 가져온 다음 연결 방식을 설정하세요
다운로드는 프로그램 설치를 위한 단계입니다. 구독, 프록시 모드, 라우팅은 설치 후 각각 설정해야 합니다.
자세한 사용법은 입문 가이드를 확인하세요. 권한, 데스크톱 환경, 플랫폼별 문제는 전체 플랫폼 가이드를 참고하세요. 익숙하지 않은 프로토콜이나 설정 이름은 용어집에서 확인한 뒤 매개변수를 변경하세요.
04 / 다운로드 관련 자주 묻는 질문
설치 파일 및 업데이트 문제
다운로드 실패, 설치 실패, 설정 오류를 먼저 구분한 뒤 해당 단계의 문제를 해결하세요.
클라이언트 설치 후에는 무엇을 준비해야 하나요?
사용 가능한 구독 URL 또는 서버 설정이 필요합니다. 클라이언트는 설정을 불러와 실행하며, 설치 파일에 연결 가능한 서버가 포함되어 있지는 않습니다. 구독을 가져온 뒤 설정을 업데이트하고 서버를 선택한 다음 시스템 프록시나 연결 모드를 설정하세요.
Windows 데스크톱 버전과 클래식 WPF 버전 중 무엇을 선택해야 하나요?
처음 사용하는 경우에는 차세대 크로스 플랫폼 인터페이스를 갖춘 데스크톱 버전을 권장합니다. 기존 인터페이스가 익숙하거나 인터페이스 호환성이 필요한 경우에는 클래식 WPF 버전을 선택하세요. 두 버전 모두 직접 설정을 가져와야 합니다. 버전을 바꾸기 전에 설정을 백업하고, 두 인스턴스가 동시에 시스템 프록시를 제어하지 않도록 하세요.
Android arm64 버전과 범용 버전은 무엇이 다른가요?
arm64는 64비트 ARM 기기용입니다. 2015년 이후 출시된 대부분의 스마트폰에서는 우선 선택할 수 있지만, 시스템이 64비트 앱을 지원하는지 확인해야 합니다. 범용 버전은 여러 CPU 아키텍처를 포함하므로 기기의 아키텍처를 모를 때 적합합니다. 설치에 실패하면 OS 버전, 저장 공간, 설치 권한도 확인하세요.
v2rayNG와 v2flyNG는 서로 바꿔 사용할 수 있나요?
이름만으로 호환 여부를 판단할 수 없습니다. v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용하므로 지원하는 프로토콜, 전송 방식, 보안 설정이 다를 수 있습니다. 먼저 서버 요구 사항을 확인하고 구독을 선택한 클라이언트에서 읽을 수 있는지 확인하세요. 기존 설정을 보관한 뒤 옮기는 것이 좋습니다.
클라이언트를 업데이트하면 구독도 자동으로 업데이트되나요?
클라이언트 업데이트와 구독 업데이트는 별개입니다. 전자는 프로그램을 업데이트하고, 후자는 서비스 제공자가 배포한 설정을 다시 가져옵니다. 프로그램 업데이트 후 구독 그룹, 업데이트 설정, 마지막 업데이트 시간을 확인하세요. 서버 정보가 바뀌지 않았다면 구독을 직접 업데이트하고 결과를 확인할 수 있습니다.
다운로드 버튼이 열리지 않거나 다운로드가 중단되면 어떻게 해야 하나요?
먼저 브라우저의 다운로드 기록과 저장 위치를 확인한 다음 네트워크 연결, 남은 저장 공간, 브라우저 알림을 살펴보세요. 이 페이지를 다시 열어 같은 플랫폼과 아키텍처를 선택해 재시도하세요. 다운로드가 완료되지 않았다면 확장자를 바꿔 억지로 설치하거나 관련 없는 클라이언트 버전을 계속 바꿔 받지 마세요.