v2rayN
Windows · x64
Desktop은 차세대 크로스 플랫폼 UI를 사용하며, WPF는 익숙한 Windows 데스크톱 조작 방식을 유지하는 클래식 버전입니다. 처음 설치한다면 Desktop을 먼저 사용해 보세요.
현재 목록 7.24.1 · ZIP 압축 파일
별도 폴더에 압축을 푼 다음 패키지에 포함된 설치 프로그램이나 실행 파일을 실행하세요. 압축 파일 미리보기 창에서 바로 실행하지 마세요.
클라이언트 설치 파일 / 플랫폼 및 아키텍처
V2Ray 클라이언트 다운로드
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. 운영체제와 프로세서를 확인한 뒤 설치 파일을 고르면 됩니다.
- VMess
- VLESS
- Trojan
- Shadowsocks
데스크톱 클라이언트v2rayN · Desktop / WPF
Android 클라이언트v2rayNG / v2flyNG
사용 전 준비구독 주소 또는 서버 설정
운영체제별 선택
설치 파일 및 시스템 요구 사항
추천
Desktop과 WPF 선택하기
두 버전의 주요 차이는 UI 기술과 조작 방식이며, 구독 서비스가 다른 것은 아닙니다. 여러 데스크톱 운영체제에서 비슷한 사용 경험을 원하는 경우 Desktop이 적합합니다. 클래식 메뉴와 설정 위치에 익숙하다면 WPF를 선택하세요. UI나 버전에 따라 안내된 메뉴 위치가 달라질 수 있으므로, 메뉴 이름이 다르면 설정의 기능을 기준으로 찾으세요.
이 페이지에서는 x64 패키지를 제공합니다. 설정 → 시스템 → 시스템 정보에서 시스템 종류를 확인하고, 프로세서와 운영체제가 해당 아키텍처를 지원하는지 확인하세요. 실행 중 런타임이 없다는 메시지가 표시되면 오류 내용에 맞는 .NET Desktop Runtime 버전을 확인하세요. 클라이언트 이름만 보고 임의의 런타임을 설치하지 마세요.
버전을 바꾸기 전에 기존 프로그램을 종료하고 설정을 백업하세요. 새 버전에서 구독 그룹, 라우팅, 로컬 포트가 제대로 작동하는지 확인할 때까지 기존 폴더를 복구할 수 있도록 보관하세요. 두 프로세스가 동시에 시스템 프록시를 제어하지 않도록 하세요.
Windows 설치 전 확인 사항
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 운영체제 및 아키텍처 | 제조사의 지원이 계속되는 Windows를 우선 사용하세요. 이 페이지에서는 x64 패키지를 제공합니다. 최소 운영체제 버전은 설치 안내와 해당 릴리스 정보를 확인하세요. |
| 설치 폴더 | 현재 계정에서 쓰기 가능한 별도 폴더를 사용하고, 실행 중인 프로그램 폴더를 바로 덮어쓰지 마세요. |
| 실행 환경 | 패키지 유형과 실행 안내에 맞춰 런타임을 준비하세요. 런타임이 포함된 패키지와 시스템 런타임에 의존하는 패키지는 요구 사항이 다를 수 있습니다. |
| 프록시 적용 방식 | 일반 시스템 프록시와 TUN은 필요한 권한이 다릅니다. 먼저 시스템 프록시로 기본 연결을 확인한 뒤 필요에 따라 TUN을 검토하세요. |
v2rayN
macOS · Desktop
이 Mac에 관하여에 표시된 칩을 기준으로 선택하세요. Apple Silicon은 arm64, Intel 프로세서는 x64를 사용합니다. 기기 외관이나 구매 연도로 판단하지 마세요.
현재 목록 7.24.1 · DMG 디스크 이미지
이미지를 열고 앱을 응용 프로그램 폴더로 옮긴 다음 해당 폴더에서 실행하세요. 설치가 끝나면 디스크 이미지를 추출할 수 있습니다.
칩을 확인한 뒤 앱을 설치하세요
Apple 메뉴에서 이 Mac에 관하여를 여세요. Apple M 시리즈 칩이 표시되면 Apple Silicon을, Intel 프로세서가 표시되면 Intel을 선택하세요. 변환 계층의 영향을 줄이려면 기기 아키텍처와 일치하는 패키지를 사용하세요. 설치 화면에서 macOS 버전이 맞지 않는다고 안내하면 같은 아키텍처 패키지를 반복해서 바꾸기보다 앱의 시스템 요구 사항을 확인하세요.
처음 실행할 때 시스템 설정 → 개인정보 보호 및 보안에서 앱 출처를 확인해야 할 수 있습니다. 다운로드 출처와 파일 용도를 확인한 뒤에만 시스템 안내에 따라 조치하세요. 전체 보안 기능을 끄는 방법은 권장하지 않습니다. 조직에서 관리하는 기기는 앱 설치와 네트워크 설정이 관리자 정책의 제한을 받을 수 있습니다.
구독을 가져온 뒤 현재 구성을 확인하고 시스템 프록시를 설정하세요. 네트워크 확장 프로그램, 다른 VPN, 수동 프록시가 요청 경로에 영향을 줄 수 있으므로 문제를 확인할 때는 한 번에 한 가지 방식만 사용하세요. 클라이언트를 종료하기 전에 클라이언트가 설정한 프록시를 해제해야 로컬 수신 포트가 닫힌 뒤에도 앱이 이전 포트로 요청을 보내는 일을 막을 수 있습니다.
macOS 설치 전 확인 사항
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 프로세서 | Apple Silicon은 arm64, Intel은 x64를 선택하세요. 이 Mac에 관하여에 표시된 정보를 기준으로 합니다. |
| 운영체제 버전 | 현재 빌드에서 지원하는 macOS를 사용하세요. 최소 버전은 칩 종류만으로 결정되지 않으므로 설치 및 실행 안내를 확인하세요. |
| 앱 위치 | 앱을 응용 프로그램 폴더에 설치하고 실행하세요. 현재 계정에서 설정을 정상적으로 저장할 수 있는지 확인하세요. |
| 네트워크 권한 | 시스템 안내에 따라 실제 필요한 권한을 허용하세요. TUN과 시스템 프록시는 별도로 설정하고, 기존 네트워크 도구와 중복으로 연결을 제어하지 않도록 하세요. |
v2rayNG
Android · Xray
Xray를 코어로 사용하는 Android 클라이언트입니다. 2015년 이후 출시된 대부분의 스마트폰에서는 arm64를 먼저 선택하세요. 기기 아키텍처를 모르면 universal 버전을 선택하면 됩니다.
현재 목록 2.2.6 · APK 설치 파일
목록에 표시된 버전과 패키지 파일 이름이 서로 다를 수 있습니다. 설치 시에는 실제 설치 파일의 정보를 기준으로 확인하세요.
v2flyNG
Android · V2Fly
V2Fly 코어를 사용하는 대체 클라이언트입니다. 해당 코어의 설정이 필요한 경우에 적합합니다. 설정을 가져오기 전에 프로토콜, 전송 방식, 확장 항목의 호환성을 확인하세요.
현재 목록 1.10.31 · APK 설치 파일
클라이언트를 바꾸기 전에 구독과 사용자 지정 규칙을 백업하세요. 다른 클라이언트의 VPN 연결을 종료한 뒤 새 클라이언트를 실행하세요.
APK 설치 및 첫 VPN 권한 승인
다운로드가 끝나면 시스템 파일 관리자에서 APK를 여세요. 출처를 알 수 없는 앱 설치 권한을 요청하면 이번에 사용할 브라우저나 파일 관리자에만 설치를 허용하고, 설치 후에는 원래 설정으로 되돌릴 수 있습니다. 앱이 설치되지 않는 원인은 아키텍처 외에도 시스템 버전, 저장 공간, 기존 앱과의 서명 불일치일 수 있습니다. 기존 설정을 먼저 내보내고, 백업을 찾지 않은 채 앱을 바로 삭제하지 마세요.
arm64는 기기의 앱 실행 환경이 지원하는 아키텍처를 뜻합니다. 프로세서 출시 연도는 참고용일 뿐입니다. 일부 기기는 64비트 프로세서를 사용해도 시스템 앱 실행 환경이 다를 수 있습니다. 확인할 수 없다면 universal 버전을 시도해 볼 수 있지만, 이 버전으로 앱의 최소 시스템 요구 사항을 우회할 수는 없습니다.
처음 연결할 때 시스템 VPN 권한을 묻는 메시지가 표시됩니다. 승인해야 클라이언트가 로컬 네트워크 연결을 제어할 수 있습니다. 백그라운드에서 연결이 끊기면 배터리 최적화, 백그라운드 실행, 절전 정책을 확인하세요. 앱별로 트래픽을 나눌 때는 선택한 목록이 해당 앱을 프록시로 보낼지, 프록시에서 제외할지 확인하세요. 목록에 체크 표시가 있는지만 보지 마세요.
Android 설치 전 확인 사항
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 아키텍처 선택 | 일반적인 기기에서는 arm64를 우선 선택하세요. 확실하지 않다면 universal을 선택하고 실제 시스템 ABI와 앱 호환성을 확인하세요. |
| 운영체제 버전 | 각 APK의 설치 요구 사항을 확인하세요. 두 클라이언트의 최소 시스템 버전은 서로 다를 수 있습니다. |
| 설치 권한 | 현재 파일 출처에서 앱 설치를 허용하세요. 업데이트할 때는 기존 앱과 서명이 일치하는지, 설치 출처가 같은지 확인하세요. |
| 연결 권한 | 시스템 VPN 권한을 승인하고, 시스템 VPN 통로를 사용하는 클라이언트는 한 번에 하나만 실행하세요. |
v2rayN
Linux · Desktop
배포판에 맞는 deb 또는 rpm을 먼저 선택한 다음 프로세서 아키텍처를 고르세요. 아래 기본 설치 파일은 x64용입니다. ARM 데스크톱 기기라면 하단의 arm64 패키지를 선택하세요.
현재 목록 7.24.1 · 배포판 소프트웨어 설치 프로그램으로 열기
패키지 형식 및 배포판 호환성
Debian, Ubuntu 등의 시스템은 일반적으로 deb를 사용하고, Fedora와 일부 엔터프라이즈 배포판은 rpm을 사용합니다. 패키지 형식이 같다는 것은 설치 관리 방식이 비슷하다는 뜻일 뿐, 시스템 라이브러리 버전까지 호환된다는 보장은 없습니다. 특히 rpm 파일 이름에 특정 배포판 빌드 정보가 포함되어 있다면 의존성 안내를 주의 깊게 확인하세요. 의존성을 충족할 수 없다는 메시지가 나오면 설치 프로그램의 오류를 무시하고 강제로 설치하지 마세요.
x64는 deb 패키지에서 amd64, rpm 패키지에서 x86_64로 표시되는 경우가 많습니다. arm64는 rpm 패키지에서 aarch64로 표시되기도 합니다. 이름이 다르다고 기능 수준이 다른 것은 아닙니다. 데스크톱의 설정 → 정보에서 운영체제와 프로세서 정보를 확인한 다음, 해당 패키지를 소프트웨어 설치 프로그램으로 여세요.
데스크톱 환경마다 시스템 프록시를 처리하는 방식이 다르며, 일부 앱은 로컬 프록시 주소를 별도로 설정해야 합니다. TUN은 기기 권한, 라우팅, DNS 설정도 필요하므로 일반 프록시 연결부터 확인하세요. 네트워크 설정 하나를 바꾸기 위해 그래픽 클라이언트를 계속 관리자 권한으로 실행하지 마세요.
Linux 설치 전 확인 사항
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 패키지 관리 형식 | 배포판에 맞는 deb 또는 rpm을 선택하고 소프트웨어 설치 프로그램에서 의존성과 호환성 안내를 확인하세요. |
| 프로세서 아키텍처 | x64는 amd64 / x86_64, arm64는 arm64 / aarch64에 해당합니다. |
| 데스크톱 실행 환경 | 그래픽 앱을 실행할 수 있는 데스크톱 환경과 필요한 시스템 라이브러리가 있어야 합니다. 그래픽 설치 패키지를 서버 전용 구성 요소로 사용하지 마세요. |
| 네트워크 연결 제어 | 데스크톱 환경의 시스템 프록시 동작을 확인하세요. TUN에는 별도의 권한과 라우팅 설정이 필요하며, 다른 네트워크 도구와 중복 설정하지 마세요. |
첫 실행 / 설정 경로
설치가 끝나면
구독을 가져오고 프록시 설정
클라이언트는 프록시 연결을 설정하고 실행하는 그래픽 도구입니다. 설치만으로 연결 정보가 준비되는 것은 아니므로 사용 권한이 있는 구독이나 서버 정보를 먼저 준비하세요.
단계별 사용 안내 보기- 설정을 가져오세요. 데스크톱 v2rayN에서는 구독 그룹을 열고 구독 주소를 입력해 저장한 다음 구독 업데이트를 실행하세요. Android 클라이언트에서는 구독 그룹 설정에 주소를 추가한 뒤 메인 화면으로 돌아와 업데이트하면 됩니다. 예시 주소
https://example.com/sub?token=xxxx는 형식을 설명하기 위한 것으로 실제 연결에는 사용할 수 없습니다. - 라우팅과 구성을 선택하세요. 사용할 구성을 선택했는지 먼저 확인한 다음 적절한 라우팅 모드를 고르세요. “중국 본토 우회”, “전역”, “직접 연결”은 요청을 받은 코어의 아웃바운드 정책을 결정합니다. 전역 모드를 선택해도 모든 앱이 자동으로 로컬 프록시에 연결되는 것은 아닙니다.
- 연결 제어를 켜고 확인하세요. 데스크톱에서는 필요에 따라 “시스템 프록시 자동 설정”을 선택하고, Android에서는 VPN 권한을 승인한 뒤 시작하세요. 먼저 앱 하나로 연결을 시험한 다음 다른 앱도 확인하세요. 문제가 생기면 구독 업데이트, 프로그램 시작, 요청 처리 중 어느 단계에서 오류가 발생했는지 기록하세요. 문제 해결의 단서가 사라지지 않도록 반복해서 삭제하지 마세요.
설치 파일 선택 및 업데이트
다운로드 자주 묻는 질문
Windows에서는 Desktop과 WPF 중 무엇을 선택해야 하나요?
처음 설치한다면 차세대 크로스 플랫폼 UI를 사용하는 Desktop을 먼저 선택해 보세요. WPF는 기존 Windows 조작 방식에 익숙한 사용자를 위한 안정적인 클래식 버전입니다. 두 버전 모두 사용할 구성을 가져와야 합니다. UI를 바꾸기 전에는 설정을 내보내고, 시스템 프록시를 변경하는 클라이언트 두 개를 동시에 실행하지 마세요.
Android에서는 arm64와 universal 중 무엇을 다운로드해야 하나요?
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 되지만, 실제 프로세서와 시스템 ABI를 확인하는 것이 가장 정확합니다. 아키텍처를 모른다면 universal 버전을 선택하세요. 앱이 설치되지 않는다는 메시지가 표시되면 시스템 호환성, 저장 공간, 기존 앱의 서명도 확인하세요. 기존 앱을 처리하기 전에 설정을 먼저 백업하세요.
클라이언트를 다운로드하면 바로 연결할 수 있나요?
설치 파일에는 클라이언트 프로그램만 포함되며, 연결에 사용할 서비스 설정은 제공되지 않습니다. 사용 권한이 있는 구독 주소나 서버 정보를 준비해 가져온 다음, 구성을 선택하고 연결을 시작하세요. 데스크톱에서는 필요에 따라 시스템 프록시나 TUN도 설정해야 합니다. Android에서 처음 연결할 때는 시스템 VPN 권한을 허용해야 합니다.
클라이언트를 업데이트해도 구독과 라우팅 설정이 유지되나요?
설정 유지 여부는 설치 방식, 설정 디렉터리, 버전 간 마이그레이션 방식에 따라 달라지므로 설치 파일 이름만으로 판단할 수 없습니다. 업데이트 전에 설정을 내보내고 사용자 지정 라우팅, 포트, 구독 그룹을 기록해 두세요. 기존 프로그램을 종료한 뒤 설치하고, 처음 실행할 때 설정이 옮겨졌는지 확인한 후 시스템 프록시나 TUN을 켜세요.
v2rayNG와 v2flyNG는 서로 대체해서 사용할 수 있나요?
둘은 서로 다른 Android 클라이언트입니다. v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용합니다. 지원하는 프로토콜, 전송 방식, 설정 항목이 다를 수 있으며, 설정을 가져오는 데 성공해도 모든 매개변수가 작동한다는 뜻은 아닙니다. 서비스 설정에 맞는 클라이언트를 선택하고 VPN 연결을 두 개 동시에 시작하지 마세요.
시스템 프록시를 켰는데도 일부 앱이 직접 연결되는 이유는 무엇인가요?
시스템 프록시는 해당 설정을 따르는 앱에만 적용됩니다. 터미널, 일부 게임, 자체 프록시 설정이 있는 프로그램은 시스템 프록시를 사용하지 않을 수 있습니다. 먼저 클라이언트가 실행 중인지와 로컬 포트가 일치하는지 확인한 다음, 앱 자체의 프록시 설정을 살펴보세요. 더 많은 앱에 적용해야 한다면 TUN을 검토하되, 기존 VPN·가상 네트워크 어댑터·라우팅과 충돌하지 않도록 먼저 확인하세요.