운영체제를 먼저 선택한 다음 프로세서 아키텍처를 선택하세요.
데스크톱에서는 v2rayN, Android에서는 우선 v2rayNG를 선택하세요. 기존 V2Fly 설정이 필요하다면 v2flyNG를 사용할 수 있습니다. 설치 파일에는 구독이나 노드가 포함되지 않으므로 설치 후 설정을 가져오고 트래픽 처리 방식을 구성해야 합니다.
클라이언트를 설치했나요? 구독 가져오기 안내 보기 →
Windows x64 설치 파일입니다. 두 가지 인터페이스 중 하나를 선택하고 다운로드한 ZIP 파일의 압축을 완전히 푼 뒤, 안에 있는 설치 프로그램을 실행하세요.
차세대 크로스 플랫폼 UI를 적용했습니다. 처음 설치하는 사용자나 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하려는 분에게 적합합니다.
Desktop 다운로드 · x64 ZIP 압축 파일 · 설치 프로그램 포함전통적인 Windows 화면 구성을 유지하는 클래식 안정 버전입니다. 기존 메뉴와 서버 목록에 익숙하다면 이 버전을 계속 사용할 수 있습니다.
클래식 WPF 다운로드 · x64 ZIP 압축 파일 · 설치 프로그램 포함| 확인 항목 | 설치 전 확인 사항 |
|---|---|
| 운영체제 및 아키텍처 | Windows x64용입니다. ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하세요. ARM 기기에서는 x64 에뮬레이션과 종속성 호환성을 별도로 확인해야 합니다. |
| 실행 종속성 | 설치 프로그램의 안내에 따라 필요한 .NET 런타임 구성 요소를 설치하세요. SDK가 설치되어 있다는 이유만으로 데스크톱 런타임까지 갖춰졌다고 판단하지 마세요. |
| 파일 및 권한 | 쓰기 가능한 폴더에 먼저 압축을 푼 다음 설치를 진행하세요. 시스템 프록시는 일반적인 연결에 사용하며, TUN 드라이버나 네트워크 설정에는 관리자 권한이 필요할 수 있습니다. |
두 버전 모두 v2rayN이며 구독 서비스가 서로 다른 것은 아닙니다. Desktop은 차세대 크로스 플랫폼 인터페이스를 사용하고, 클래식 WPF 버전은 기존 Windows 사용 방식을 유지합니다. 사용 습관과 실제 호환성을 고려해 선택하세요. 인터페이스 차이를 노드 속도 차이로 오해하지 마세요. 연결 결과에는 노드 프로토콜, 원격 서버, 로컬 네트워크가 중요한 영향을 미칩니다.
버전을 전환하기 전에 구독 주소를 저장하고 사용자 지정 라우팅을 내보내세요. 기존 클라이언트를 종료한 뒤 시스템 트레이의 프로세스까지 끝났는지 확인하고 새 버전을 실행하세요. 기존 폴더의 파일을 새 설치 폴더에 통째로 덮어쓰면 설정이나 종속성이 섞일 수 있으니 피하세요. 처음 실행한 뒤 구독을 업데이트하고 노드를 선택한 다음 ‘시스템 프록시 자동 설정’을 구성하세요. 시스템 프록시를 따르지 않는 앱까지 처리해야 한다면 TUN 설정을 확인하세요.
‘Apple 메뉴 → 이 Mac에 관하여’에서 칩 이름을 확인하세요. Apple M 시리즈 칩이면 Apple Silicon, Intel 프로세서면 Intel을 선택합니다.
Apple M 시리즈 칩을 탑재한 Mac용이며 ARM64 아키텍처에 해당합니다.
Apple Silicon 다운로드 · DMG M 시리즈 칩 · ARM64프로세서 이름에 Intel이 표시되는 Mac용이며 x64 아키텍처에 해당합니다.
Intel 다운로드 · DMG Intel 프로세서 · x64| 확인 항목 | 설치 전 확인 사항 |
|---|---|
| 칩 아키텍처 | ‘이 Mac에 관하여’에 표시된 칩 또는 프로세서를 기준으로 선택하세요. 기기 외관, 화면 크기, 구입 연도는 기준이 아닙니다. |
| 운영체제 호환성 | 설치 전에 현재 macOS 버전이 앱의 요구 사항을 충족하는지 확인하세요. 시스템에서 버전이 너무 낮다고 명확히 안내하면 먼저 요구 사항을 확인해야 합니다. |
| 앱 위치 | DMG를 연 다음 앱을 ‘응용 프로그램’ 폴더로 복사하고 해당 폴더에서 실행하세요. 디스크 이미지 안에서 계속 실행하지 않는 것이 좋습니다. |
| 네트워크 권한 | 시스템 프록시와 TUN은 트래픽을 처리하는 서로 다른 방식입니다. TUN은 가상 네트워크 인터페이스를 사용하므로 추가 시스템 권한이 필요할 수 있습니다. |
다운로드가 완료되면 디스크 이미지를 열고 안내에 따라 v2rayN을 ‘응용 프로그램’ 폴더로 옮기세요. 복사가 끝나면 디스크 이미지를 추출해도 됩니다. 처음 실행할 때 시스템에서 차단 안내가 표시되면 구체적인 사유를 먼저 확인하고 앱 출처, 시스템 호환성, 다운로드 완료 여부를 점검하세요. 확인 후에는 시스템이 제공하는 ‘열기 허용’ 절차를 이용하세요. 앱 하나를 실행하려고 기기 전체의 보안 검사를 끄지 마세요.
클라이언트에서 구독 그룹을 추가하고 사용 권한이 있는 구독 주소를 입력한 뒤 업데이트하세요. 노드를 선택한 다음 ‘시스템 프록시 자동 설정’을 활성화합니다. 이 설정은 macOS 프록시 설정을 따르는 앱에만 적용되며 전체 라우팅과는 다릅니다. 개발 도구, 터미널, 일부 데스크톱 앱은 자체 프록시 설정을 사용할 수 있으므로 별도로 설정하거나 라우팅과 권한을 이해한 뒤 TUN을 사용하세요.
종료하기 전에 시스템 프록시를 해제하는 것이 좋습니다. 특히 다른 네트워크 도구로 전환할 때는 꼭 확인하세요. 앱을 종료했는데도 브라우저에서 프록시 서버를 사용할 수 없다고 표시되면 클라이언트를 반복해서 다시 설치하지 말고 시스템 네트워크 설정에서 프록시 주소를 확인하세요. 설치 및 권한 문제를 자세히 확인하려면 전체 플랫폼 설치 및 설정 문서를 참고하세요.
Android 그래픽 클라이언트입니다. VLESS, REALITY 등의 설정을 사용할 때는 현재 클라이언트가 구체적인 설정 매개변수와 호환되는지 먼저 확인하세요.
2015년 이후 출시된 대부분의 스마트폰에서는 우선 이 패키지를 선택하세요. 기기의 운영체제가 ARM64를 지원하는지는 확인해야 합니다.
v2rayNG 다운로드 · arm64 APK 설치 파일 · 64비트 ARM프로세서 아키텍처를 확인하기 어려울 때 선택하세요. 더 많은 아키텍처 구성 요소가 포함되어 있지만 실제 호환 범위는 운영체제 버전에 따라 달라집니다.
v2rayNG 다운로드 · 범용 버전 APK 설치 파일 · 다중 아키텍처
기존 V2Fly 설정을 사용해야 하는 Android 사용자에게 적합합니다. v2rayNG와 코어 계열이 다르므로 화면이 비슷하다는 이유만으로 모든 프로토콜 매개변수를 서로 바꿔 쓸 수 있다고 가정하지 마세요.
ARM64를 지원하는 스마트폰에서 우선 사용하세요. 가져오기 전에 구독의 프로토콜과 전송 설정을 현재 코어가 지원하는지 확인해야 합니다.
v2flyNG 다운로드 · arm64 APK 설치 파일 · 64비트 ARM기기 아키텍처를 확인할 수 없을 때 사용하세요. 설치 전에 시스템의 호환성 안내를 확인하세요.
v2flyNG 다운로드 · 범용 버전 APK 설치 파일 · 다중 아키텍처| 확인 항목 | 설치 전 확인 사항 |
|---|---|
| 설치 권한 | 시스템 안내에 따라 현재 브라우저나 파일 관리자에 앱 설치 권한을 허용하세요. 설치가 끝나면 해당 출처의 설치 권한을 다시 끌 수 있습니다. |
| 기기 아키텍처 | 대부분의 64비트 ARM 스마트폰에서는 arm64를 우선 선택하세요. 구형 기기, 에뮬레이터, 특수 운영체제에서는 아키텍처를 먼저 확인하고 범용 버전을 선택하세요. |
| 연결 권한 | 처음 연결할 때 VPN 권한을 요청합니다. 일반적으로 시스템 VPN 연결을 사용할 수 있는 앱은 한 번에 하나뿐입니다. |
| 백그라운드 실행 | 화면을 잠근 뒤 연결이 끊기면 배터리 최적화, 백그라운드 활동 권한, 제조사별 자동 시작 제한을 확인하세요. |
arm64와 범용 버전은 기능 등급의 차이가 아닙니다. arm64는 해당 아키텍처 구성 요소만 포함하며, 범용 버전은 더 많은 아키텍처를 지원합니다. 범용 버전으로 바꿔도 노드 품질이 좋아지거나 앱의 최소 운영체제 요구 사항이 달라지지는 않습니다. 설치 프로그램에 ‘파싱 실패’가 표시되면 파일 다운로드가 완료됐는지, 운영체제 버전과 아키텍처가 맞는지 확인한 뒤 다시 시도하세요. 설치 문제를 해결하려고 구독을 계속 바꾸지 마세요.
덮어써서 업데이트하기 전에 구독과 사용자 지정 설정을 저장하세요. 앱 이름이 같아도 설치 서명이 같다는 보장은 없으며, 배포 경로가 다른 앱은 바로 덮어쓸 수 없을 수 있습니다. 서명 충돌이 발생하면 출처 차이를 확인하고 백업한 뒤 기존 앱을 삭제할지 결정하세요. 앱을 삭제하면 로컬 설정이 지워질 수 있습니다. v2rayNG와 v2flyNG는 같은 앱의 테마만 다른 버전이 아니므로 전환하기 전에 프로토콜 지원 여부를 다시 확인하세요.
설치 후 구독을 가져와 노드 목록을 업데이트하고 연결을 누른 다음 시스템 VPN 요청을 승인하세요. 연결 상태가 표시되더라도 모든 앱이 프록시를 사용한다는 뜻은 아닙니다. 앱별 라우팅, 우회 목록, 라우팅 규칙에 따라 결과가 달라질 수 있습니다. 테스트할 때는 현재 트래픽 처리 방식을 따르는 앱 하나를 사용하고 여러 네트워크 제어 도구를 동시에 실행하지 마세요.
배포판에 맞춰 deb 또는 rpm을 선택한 뒤 프로세서 아키텍처를 확인하세요. 아래 기본 다운로드는 x64이며 ARM64는 해당 패키지 형식 아래에 있습니다.
Debian, Ubuntu 등 deb 패키지를 사용하는 배포판용입니다. 필요한 종속성은 시스템 패키지 설치 프로그램에서 확인할 수 있습니다.
deb 다운로드 · x64 ARM64 기기: deb 다운로드 · arm64 →rpm 패키지를 사용하는 배포판용입니다. 패키지 형식이 같아도 종속성까지 같은 것은 아니므로 설치 전에 배포판 호환성을 확인하세요.
rpm 다운로드 · x64 ARM64 기기: rpm 다운로드 · arm64 →| 확인 항목 | 설치 전 확인 사항 |
|---|---|
| 데스크톱 환경 | 이 페이지에서는 그래픽 클라이언트를 제공합니다. 데스크톱 앱을 실행할 수 있는 Linux 환경에서 사용하세요. 명령줄 전용 서버용 설치 패키지가 아닙니다. |
| 프로세서 아키텍처 | Intel 및 AMD 기반의 일반적인 64비트 데스크톱은 x64를, 64비트 ARM 기기는 arm64를 선택하세요. |
| 패키지 호환성 | 배포판의 패키지 설치 프로그램으로 deb 또는 rpm을 열어 종속성을 충족할 수 있는지 확인하세요. 강제로 설치하기 위해 종속성 오류를 무시하지 마세요. |
| 프록시 및 권한 | 시스템 프록시의 적용 여부는 데스크톱 앱의 구현 방식에 따라 다릅니다. TUN은 보통 가상 네트워크 인터페이스와 추가 권한이 필요하므로 별도로 설정해야 합니다. |
deb와 rpm은 서로 다른 패키지 체계를 뜻하며 프록시 모드가 다른 것은 아닙니다. 먼저 시스템 설정에서 배포판 정보와 프로세서 종류를 확인한 뒤 해당 파일을 선택하세요. 파일 관리자에서 설치 패키지를 열어 시스템 패키지 설치 프로그램이 종속성을 처리하도록 하세요. 시스템 라이브러리가 호환되지 않는다는 메시지가 나오면 오류 내용을 보관하고 호환 조건을 확인하세요. 다른 배포판의 기본 라이브러리를 섞어 설치하지 마세요.
설치가 끝나면 앱 메뉴에서 v2rayN을 실행하고 구독을 가져와 노드를 업데이트하세요. Linux 데스크톱 환경마다 시스템 프록시 처리 방식이 다릅니다. 일부 앱은 데스크톱 프록시 설정을 사용하고, 다른 앱은 앱 내부에서 별도로 설정해야 합니다. 브라우저는 연결되지만 다른 프로그램은 연결되지 않는다면 해당 프로그램이 프록시 설정을 읽는 방식을 먼저 확인한 뒤 TUN 사용을 고려하세요. 같은 설치 파일을 다시 다운로드해도 트래픽 처리 방식은 달라지지 않습니다.
트레이 아이콘 표시 여부도 데스크톱 환경에 따라 달라집니다. 창은 열리지만 트레이 아이콘이 보이지 않는다면 코어가 실행되지 않았다고 단정하지 말고 데스크톱에서 트레이를 지원하는지 확인하세요. 시스템 종속성, 네트워크 권한, 구체적인 설치 방법은 전체 문서에서 확인할 수 있습니다.
다운로드는 프로그램 설치를 해결하고, 구독과 프록시 설정은 연결 가능 여부를 좌우합니다.
사용 권한이 있는 서비스에서 구독 주소를 받아 클라이언트에 구독 그룹을 만들고 주소를 입력한 다음 업데이트하세요. 그룹 추가와 노드 업데이트는 별개의 작업입니다. 주소만 저장하면 선택할 수 있는 노드가 자동으로 생기지 않습니다. 목록이 비어 있다면 그룹 필터, 구독 만료 여부, 업데이트 로그를 먼저 확인하세요. 출처를 알 수 없는 설정을 평소 사용하는 그룹에 섞지 마세요.
사용할 노드를 선택한 다음 시스템 프록시를 설정하거나 Android VPN 연결을 시작하세요. 시스템 프록시는 앱의 요청을 어디로 보낼지 정하고, 라우팅 규칙은 클라이언트로 들어온 요청을 어떻게 전달할지 정합니다. 서로 다른 설정입니다. ‘중국 본토 우회’ 같은 라우팅 사전 설정은 이미 클라이언트에 들어온 트래픽에만 적용되며 모든 앱의 트래픽을 자동으로 처리하지는 않습니다.
먼저 브라우저로 기본 연결을 확인하고 클라이언트 로그에 설정 또는 핸드셰이크 오류가 있는지 살펴보세요. 기본 연결이 정상인 것을 확인한 뒤 필요에 따라 TUN을 활성화하세요. 처음부터 DNS, 라우팅, 코어, 구독을 한꺼번에 변경하지 마세요. 작동이 확인된 설정을 보관하고 한 번에 한 항목씩 바꿔야 문제가 발생한 단계를 찾을 수 있습니다.
클라이언트 업데이트와 구독 업데이트는 별개의 작업입니다. 전자는 프로그램과 함께 제공되는 구성 요소를 교체하고, 후자는 노드 목록을 새로 고칩니다. 노드가 작동하지 않으면 먼저 구독을 업데이트하고 서비스 상태를 확인하세요. 인터페이스 문제나 프로토콜 호환 문제가 있을 때 클라이언트 버전을 점검하면 됩니다. 반복해서 재설치하는 것을 모든 네트워크 문제의 해결책으로 여기지 마세요.
덮어써서 업데이트하기 전에 구독 그룹, 사용자 지정 라우팅, DNS 옵션, 앱별 라우팅 설정을 저장하세요. 내보낸 파일은 직접 관리할 수 있는 위치에 보관하고 공개 공유 사이트에 업로드하지 마세요. 업데이트 후 기존 설정을 읽을 수 있는지 확인하고, 자주 사용하는 노드 하나를 테스트한 다음 TUN이나 LAN 접근 옵션을 추가로 복원하세요.
문제가 발생하면 로그의 오류 내용을 보관한 뒤 자주 묻는 질문에서 설치, 구독, 연결 단계별로 원인을 찾아보세요. Android 클라이언트를 아직 선택하지 못했다면 클라이언트 비교에서 코어와 프로토콜 설명을 확인하는 편이 설치 파일 크기만 비교하는 것보다 유용합니다.
먼저 설치 조건을 확인한 다음 연결 설정을 점검하세요.
처음 사용한다면 차세대 크로스 플랫폼 인터페이스를 적용한 Desktop 버전을 선택할 수 있습니다. 기존 Windows 화면 구성이 익숙하다면 클래식 WPF 안정 버전이 적합합니다. 둘 다 v2rayN 그래픽 클라이언트입니다. 버전을 전환하기 전에 구독과 사용자 지정 규칙을 백업하고, 로컬 포트를 두 클라이언트가 동시에 사용하지 않도록 기존 클라이언트를 종료하세요.
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. 칩 항목에 Apple M 시리즈가 표시되면 Apple Silicon을, 프로세서 항목에 Intel이 표시되면 Intel 설치 파일을 선택하세요. 기기 크기나 구입 연도가 아니라 실제 칩에 맞춰 선택해야 합니다.
arm64 패키지는 64비트 ARM 환경용입니다. 2015년 이후 출시된 대부분의 스마트폰은 우선 이 버전을 선택하면 되지만, 기기의 운영체제가 해당 아키텍처를 지원하는지 확인하세요. 아키텍처를 확인하기 어렵거나 arm64 패키지가 호환되지 않는다고 표시되면 범용 버전을 시도할 수 있습니다. 범용 버전에는 더 많은 아키텍처 구성 요소가 포함되지만 모든 구형 시스템과 호환되는 것은 아닙니다.
사용 가능한 구독 주소나 노드 설정이 필요합니다. 설치 파일에는 클라이언트 프로그램만 포함되며 노드는 제공되지 않습니다. 설치 후 사용 권한이 있는 구독을 가져와 목록을 업데이트하고 노드를 선택한 다음 시스템 프록시 또는 Android VPN 연결을 설정하세요. 구독 주소에는 접속 정보가 포함될 수 있으므로 공개적으로 공유하지 마세요.
먼저 운영체제, 프로세서 아키텍처, 패키지 형식이 맞는지 확인한 뒤 다운로드 완료 여부와 디스크 공간, 권한 또는 종속성 관련 시스템 안내를 살펴보세요. Windows 압축 파일은 먼저 완전히 압축을 풀어야 합니다. Linux에서는 시스템 패키지 설치 프로그램으로 종속성을 확인하세요. Android에서 업데이트가 충돌하면 설정을 백업한 뒤 앱 서명과 설치 출처를 확인하세요.