v2rayN
데스크톱 GUI 클라이언트 · x64
데스크톱 버전 Desktop
데스크톱 버전 다운로드 · x64차세대 크로스 플랫폼 UI입니다. 처음 설치하거나 데스크톱 환경에서 일관된 사용 방식을 원한다면 데스크톱 버전부터 시작하세요.
두 설치 파일 모두 ZIP 압축 파일입니다. 먼저 압축을 푼 다음 안에 있는 설치 프로그램을 실행하세요. 압축 파일 미리보기 창에서 바로 실행하지 마세요.
클라이언트 설치 파일
데스크톱에서는 v2rayN, Android에서는 우선 v2rayNG를 선택하세요. 먼저 운영체제를 확인한 다음 해당하는 프로세서 아키텍처와 설치 형식을 고르면 됩니다.
플랫폼별 선택
플랫폼을 전환하면 해당 설치 파일을 확인할 수 있습니다. 데스크톱에서는 같은 클라이언트를 사용하고, Android에서는 코어 호환성에 따라 기본 또는 대체 앱을 선택하세요.
데스크톱 GUI 클라이언트 · x64
데스크톱 버전 Desktop
데스크톱 버전 다운로드 · x64차세대 크로스 플랫폼 UI입니다. 처음 설치하거나 데스크톱 환경에서 일관된 사용 방식을 원한다면 데스크톱 버전부터 시작하세요.
두 설치 파일 모두 ZIP 압축 파일입니다. 먼저 압축을 푼 다음 안에 있는 설치 프로그램을 실행하세요. 압축 파일 미리보기 창에서 바로 실행하지 마세요.
| 확인 항목 | 요구 사항 및 선택 방법 |
|---|---|
| 운영체제 | 보안 지원 기간이 끝나지 않은 Windows 11 x64 사용을 권장합니다. 최소 요구 사항은 다운로드한 버전의 설치 안내를 확인하세요. |
| 프로세서 | 이 페이지에서는 x64 설치 파일을 제공합니다. “설정 → 시스템 → 시스템 정보”에서 시스템 종류를 확인할 수 있습니다. |
| 실행 환경 | 설치 프로그램의 안내에 따라 필요한 실행 환경을 준비하세요. WPF 버전에서 .NET 데스크톱 런타임이 없다는 메시지가 표시되면 필요한 아키텍처와 주 버전에 맞는 런타임을 설치하세요. |
| 폴더 및 권한 | 현재 계정에서 읽고 쓸 수 있는 폴더를 사용하세요. 일반적인 프록시 설정에는 보통 일반 권한이면 충분하며, TUN 기능에는 추가 권한이 필요할 수 있습니다. |
설치 후 클라이언트의 기본 화면을 열어 설정을 정상적으로 저장할 수 있는지 확인한 다음 구독을 가져오세요. 새 인터페이스와 클래식 인터페이스를 모두 설치했다면 두 프로그램이 동시에 실행되어 로컬 포트를 점유하지 않도록 하세요. 설정을 옮길 때는 먼저 내보낸 뒤 구독 그룹과 라우팅 설정을 하나씩 확인하세요. 두 인터페이스의 설정 파일이 서로 완전히 호환된다고 가정해서는 안 됩니다.
시작 창이 잠깐 나타났다가 사라지면 노드를 바꿔 보기보다 오류 메시지와 실행 환경부터 확인하세요. 클라이언트는 열리지만 접속에 실패한다면 서버 매개변수, 시스템 프록시, 라우팅을 점검해야 합니다. 두 문제는 확인을 시작할 지점이 다릅니다.
macOS GUI 클라이언트 · DMG
Apple Silicon
Apple Silicon 다운로드 · arm64Apple M 시리즈 칩을 사용하는 Mac용입니다. 기본적으로 네이티브 arm64 설치 파일을 선택하세요.
왼쪽 위의 Apple 메뉴 → 이 Mac에 관하여를 여세요. “칩 Apple M…”이라고 표시되면 arm64, “프로세서 Intel…”이라고 표시되면 x64를 선택하세요.
| 확인 항목 | 요구 사항 및 선택 방법 |
|---|---|
| 시스템 호환성 | 보안 지원 기간이 끝나지 않은 macOS를 사용하고 설치 파일이 현재 시스템 버전을 지원하는지 확인하세요. 오래된 시스템에서는 앱 실행 안내를 먼저 확인해야 합니다. |
| 프로세서 | Apple Silicon은 arm64, Intel은 x64를 선택하세요. Mac을 구입한 연도로 아키텍처를 추측하지 마세요. |
| 설치 위치 | DMG를 열고 창의 안내에 따라 앱을 “응용 프로그램” 폴더로 옮긴 다음 해당 폴더에서 실행하세요. |
| 시스템 권한 | 시스템 프록시와 TUN에 필요한 권한은 서로 다릅니다. 관련 기능을 사용할 때만 해당 권한 안내를 처리하세요. |
DMG는 디스크 이미지이며 앱을 계속 실행하는 폴더가 아닙니다. 복사가 끝나면 디스크 이미지를 추출하고 “응용 프로그램”에서 클라이언트를 실행하세요. 이렇게 하면 업데이트할 때 이전 디스크 이미지에서 계속 실행되는 일을 방지하고, 시스템 권한 설정에서 같은 앱을 식별하기도 쉽습니다.
처음 실행할 때 시스템 보안 기능에 의해 차단되면 안내를 읽고 “시스템 설정 → 개인정보 보호 및 보안”에서 차단 사유를 확인하세요. 출처와 앱이 맞는지 확인한 뒤 시스템 안내에 따라 진행하세요. 시스템의 보안 보호 기능을 전부 끄는 방법은 일반적인 설치 절차가 아닙니다. 시스템 버전이 호환되지 않는다는 메시지가 표시된다면 권한을 변경해도 해결되지 않으므로 먼저 호환성 문제를 확인하세요.
연결 전에 시스템 프록시를 사용해 브라우저 접속을 확인할 수 있습니다. 앱이 시스템 프록시를 따르지 않아 트래픽을 직접 처리해야 하는 경우에만 TUN을 고려하세요. 권한 부여 실패, 프록시 설정 미적용, 서버 연결 실패는 서로 다른 단계의 문제이므로 클라이언트 로그를 확인해 구분해야 합니다.
Xray 코어 · Android GUI 클라이언트
arm64 설치 파일
v2rayNG 다운로드 · arm642015년 이후 출시된 일반적인 스마트폰은 보통 이 버전을 선택할 수 있습니다. 실제 기기에서 지원하는 앱 아키텍처를 기준으로 선택하세요.
범용 설치 파일
v2rayNG 다운로드 · 범용 버전기기의 아키텍처를 잘 모를 때 선택할 수 있습니다. 여러 아키텍처 구성 요소를 포함해 단일 아키텍처 패키지보다 용량이 큰 편입니다.
처음 연결할 때 Android VPN 연결 권한을 허용해야 합니다. 구독을 가져온 뒤 노드를 선택하고 연결을 시작하세요.
V2Fly 코어 · Android GUI 클라이언트
설정과 코어가 호환될 때만 대체 클라이언트를 선택하세요. 같은 구독을 가져오기 위해 두 앱의 VPN 연결을 동시에 켜지 마세요.
| 확인 항목 | 요구 사항 및 선택 방법 |
|---|---|
| 시스템 호환성 | APK 설치 프로그램에 표시된 최소 Android 버전을 기준으로 하세요. 보안 업데이트를 정상적으로 받을 수 있는 기기라면 시스템 문제를 확인하기도 쉽습니다. |
| 앱 아키텍처 | arm64-v8a는 64비트 ARM 앱 환경에 해당합니다. 프로세서가 64비트를 지원하더라도 시스템에서 모든 64비트 앱 설치를 허용하는 것은 아닙니다. |
| 설치 권한 | APK를 실제로 여는 브라우저나 파일 관리자에만 출처별 앱 설치 권한을 허용하고, 설치가 끝나면 권한을 끌 수 있습니다. |
| 백그라운드 연결 | 처음 연결할 때 VpnService 권한을 허용하세요. 화면이 꺼진 뒤 연결이 끊기면 제조사별 백그라운드 실행 및 배터리 절약 제한을 확인하세요. |
파일 관리자에서 APK를 연 뒤 앱 이름과 설치 안내를 먼저 확인하세요. 같은 이름의 앱이 이미 있는데도 덮어쓸 수 없다면 서명이 다르거나 시스템에서 다운그레이드를 막는 경우가 많습니다. 기존 앱을 바로 삭제하면 로컬 설정도 함께 사라질 수 있으므로 구독과 설정을 먼저 백업한 뒤 이전이 필요한지 판단하세요.
두 Android 클라이언트는 서로 다른 코어를 사용하므로 화면이 비슷하다고 설정까지 완전히 호환되는 것은 아닙니다. 특히 프로토콜 확장, 암호화 매개변수, 새로운 전송 방식은 구독 요구 사항과 맞아야 합니다. 연결된 뒤 앱별 프록시를 설정하고 목록이 “선택한 앱만 프록시 사용”인지 “선택한 앱은 프록시 우회”인지 확인하세요. 반대 규칙을 연결 오류로 오해하지 않도록 주의하세요.
Linux GUI 클라이언트 · deb / rpm
패키지 형식은 배포판에 따라, 프로세서 아키텍처는 기기에 따라 결정됩니다. 두 항목을 모두 맞춰야 하며 파일 확장자만 보고 선택하면 안 됩니다.
| 확인 항목 | 요구 사항 및 선택 방법 |
|---|---|
| 데스크톱 환경 | 그래픽 앱을 실행할 수 있는 데스크톱 세션이 필요합니다. 명령줄만 사용하는 서버에는 이 페이지의 GUI 클라이언트 설치 절차를 적용할 수 없습니다. |
| 프로세서 | amd64와 x86_64는 x64, aarch64는 arm64에 해당합니다. 시스템 정보에서 확인할 수 있습니다. |
| 패키지 관리 체계 | 배포판에 맞는 deb 또는 rpm을 선택하고 시스템 소프트웨어 설치 도구로 필요한 종속성을 확인하세요. |
| 권한 및 네트워크 | 패키지 설치에는 관리자 권한이 필요할 수 있습니다. 평소에는 일반 사용자로 실행하고 TUN을 사용할 때 관련 권한을 설정하세요. |
배포판의 소프트웨어 설치 도구로 패키지를 열면 종속성과 아키텍처가 요구 사항을 충족하는지 미리 확인할 수 있습니다. 라이브러리 버전이 낮다는 메시지가 표시되면 종속성 검사를 억지로 건너뛰지 마세요. rpm이나 deb 확장자가 같더라도 모든 배포판 버전에서 사용할 수 있는 것은 아닙니다.
실행 후 트레이 아이콘이 보이지 않으면 먼저 데스크톱 환경이 해당 상태 표시 영역을 지원하는지 확인하세요. 아이콘이 없다고 프로그램이 실행되지 않는 것은 아닙니다. 데스크톱 환경에 따라 시스템 프록시가 적용되는 범위도 다를 수 있습니다. 먼저 클라이언트의 인바운드가 정상적으로 수신 대기하는지 확인한 다음 앱이 시스템 프록시를 사용하는지 점검하세요. 명령줄 도구와 독립형 네트워크 구성 요소는 별도로 프록시를 설정해야 할 수도 있습니다.
설치 파일은 “운영체제 → 프로세서 아키텍처 → 패키지 형식” 순서로 선택하세요. 운영체제는 프로그램 실행 가능 여부를, 아키텍처는 바이너리 파일과 프로세서·시스템 환경의 호환성을, 패키지 형식은 사용할 설치 도구를 결정합니다. 어느 하나라도 맞지 않으면 파일을 열 수 없거나 앱이 설치되지 않거나 종속성이 충족되지 않는다는 메시지가 표시될 수 있습니다.
x64는 일반적으로 Intel 및 AMD의 64비트 데스크톱 프로세서에 사용되며 arm64는 Apple Silicon, Android 스마트폰 및 일부 Linux 기기에서 주로 사용됩니다. amd64라는 이름이 AMD 프로세서에서만 실행된다는 뜻은 아니며, x86_64도 별도의 아키텍처가 아닙니다. 확실하지 않다면 기기의 외관이나 구입 연도로 판단하지 말고 운영체제의 “시스템 정보”를 확인하세요.
세 클라이언트는 모두 무료 오픈 소스 소프트웨어입니다. Project V는 관련 기술 생태계의 출발점이며 V2Fly와 Xray는 서로 다른 코어 개발 계열입니다. GUI 클라이언트는 코어를 바탕으로 구독 관리, 라우팅 및 프록시 설정 기능을 제공합니다. 앱 이름이 비슷해도 업데이트 주기, 프로토콜 지원, 설정 구조가 완전히 같지는 않으므로 이전하기 전에 실제로 사용하는 기능을 확인하세요.
페이지에 접속할 수 없다면 먼저 로컬 네트워크가 정상인지 확인한 다음 노드 매개변수, 시스템 시간, 오류 로그를 점검하세요. 포트 충돌이 발생하면 다른 클라이언트가 실행 중인지 확인하고, 권한 오류가 발생하면 시스템 권한을 살펴보세요. 원격 연결 시간 초과라면 서버 포트와 전송 설정을 확인하세요. 단계별로 점검하면 모든 문제를 설치 파일 탓으로 돌리는 일을 줄일 수 있습니다.
기본 연결을 확인한 뒤 라우팅 분할, DNS 또는 TUN을 하나씩 설정하세요. 한 번에 변수 하나만 바꾸고 직전의 정상 설정을 보관하면 변경의 영향을 파악하기 쉽습니다. 화면별 설정 방법은 빠른 시작을, 필드와 규칙 구조는 설정 가이드를 참고하세요.
업데이트 전에 중요한 설정을 내보내세요. 특히 직접 관리하는 라우팅 규칙, DNS 설정, 구독 그룹, 서버 매개변수를 백업해야 합니다. 구독에서 노드를 다시 가져올 수는 있지만 클라이언트의 그룹 순서, 우회 목록, 부분 재정의 설정까지 복원되는 것은 아닙니다. 설정 백업은 본인이나 권한이 있는 사용자만 접근할 수 있는 위치에 보관하세요.
새 버전을 설치하기 전에 프록시 연결을 중지하고 기존 프로그램을 종료하세요. 데스크톱에서는 트레이 프로세스까지 종료되었는지 확인해야 파일이나 로컬 포트가 점유되는 일을 막을 수 있습니다. Android에서 덮어쓰기 설치가 안 되면 기존 앱을 바로 삭제하지 말고 서명과 버전 제한부터 확인하세요. 앱을 삭제하면 로컬 데이터도 함께 사라질 수 있습니다.
업데이트가 끝나면 선택한 코어, 인바운드 포트, 시스템 프록시, 라우팅 모드를 확인한 뒤 실제 접속을 테스트하세요. 새 버전이 이전과 다르게 동작하면 보관한 설정과 대조하고, 현재 상태를 덮어쓰도록 구독을 반복해서 가져오지 마세요. 이전 버전으로 되돌릴 때도 새 설정과 기존 설정을 모두 백업해 버전 간 덮어쓰기로 문제가 커지지 않도록 하세요.
다운로드가 끝났다고 설치가 끝난 것은 아니며, 설치가 끝났다고 기존 프로그램이 종료된 것도 아닙니다. 업데이트 후에도 이전 화면이 보인다면 먼저 실행 바로 가기가 어느 앱 폴더를 가리키는지 확인하세요. 압축을 푼 폴더를 여러 개 보관하는 경우 현재 실행 위치와 방금 다운로드한 파일 위치를 구분해야 합니다.
설치 파일에는 클라이언트 프로그램만 포함되며, 사용할 수 있는 서버나 구독은 제공되지 않습니다. 설치 후 사용 권한이 있는 구독 주소 또는 서버 설정을 가져오고 서버를 선택한 다음 시스템 프록시나 적절한 트래픽 처리 방식을 설정해야 합니다. 처음 사용한다면 빠른 시작 페이지를 따라 진행하세요.
먼저 시스템에 표시된 프로세서 아키텍처를 확인하세요. Apple Silicon은 arm64, Intel Mac은 x64를 선택합니다. 이 페이지에서는 Windows용 x64 파일을 제공합니다. Linux는 아키텍처와 deb·rpm 패키지 형식을 모두 확인해야 합니다. 2015년 이후 출시된 일반적인 Android 스마트폰은 대개 arm64를 선택할 수 있지만, 기기에서 지원하는 앱 아키텍처를 기준으로 선택하세요. 확인하기 어렵다면 범용 버전을 선택하면 됩니다.
구독 그룹, 서버 설정, 사용자 지정 라우팅 규칙, DNS 설정을 먼저 백업하고 현재 사용하는 코어와 프록시 모드를 기록해 두세요. 클라이언트를 종료한 뒤 업데이트를 설치하고, 연결이 정상인지 확인할 때까지 기존 설정 백업을 보관하세요. 구독 주소와 내보낸 설정에는 접속 정보가 포함될 수 있으므로 공개적으로 공유하지 마세요.
먼저 설치 파일이 운영체제와 프로세서 아키텍처에 맞는지 확인한 뒤 시스템에 표시된 구체적인 원인을 살펴보세요. Windows에서는 압축이 제대로 풀렸는지, 실행 환경과 폴더 권한이 적절한지 확인합니다. macOS에서는 시스템 설정의 개인정보 보호 및 보안에서 차단 사유를 확인하세요. Android에서는 설치 출처 권한과 기존 앱의 서명을 확인하고, Linux에서는 패키지 형식과 종속성을 점검합니다. 프로그램을 실행하기 위해 시스템 보안 기능을 장기간 꺼 두지 마세요.
구독 형식을 인식할 수 있고, 노드 프로토콜이 지원되며, 전송 매개변수가 호환되어야 합니다. v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용하므로 지원하는 프로토콜과 매개변수가 완전히 같지는 않습니다. 가져오기에 성공해도 모든 노드에 연결할 수 있다는 뜻은 아닙니다. 구독 제공업체의 안내에 따라 클라이언트를 선택하고, 두 앱의 VPN 연결을 동시에 켜지 마세요.