v2rayN
두 버전 모두 v2rayN입니다. Desktop은 차세대 크로스 플랫폼 UI를 사용하고, WPF는 Windows 사용자에게 익숙한 조작 방식을 이어가는 클래식 안정 버전입니다.
운영체제를 선택한 다음 아키텍처를 확인하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 추천합니다. 설정에 따라 v2flyNG를 선택할 수도 있습니다.
클라이언트는 영구 무료입니다. 구독과 노드 설정은 별도로 준비해야 합니다.
두 버전 모두 v2rayN입니다. Desktop은 차세대 크로스 플랫폼 UI를 사용하고, WPF는 Windows 사용자에게 익숙한 조작 방식을 이어가는 클래식 안정 버전입니다.
| 확인 항목 | 선택 기준 |
|---|---|
| 프로세서 아키텍처 | 두 패키지 모두 x64이며, 호환되는 64비트 Windows 환경에서 사용할 수 있습니다. |
| 시스템 호환성 | 시스템 업데이트가 계속 제공되는 Windows 사용을 권장합니다. 최소 지원 버전은 선택한 배포 패키지의 요구 사항을 확인하세요. |
| 실행 환경 | 배포 패키지에 따라 필요한 런타임이 다를 수 있습니다. 구성 요소가 없다는 알림이 표시되면 구성 요소 이름을 확인한 뒤 해결하세요. |
| 권한 | 일반 프록시 설정과 TUN은 필요한 권한이 다릅니다. 처음 설치할 때 TUN을 미리 활성화할 필요는 없습니다. |
다운로드가 완료되면 ZIP 파일의 내용을 쓰기 가능한 폴더에 완전히 압축 해제한 다음 설치 프로그램을 실행하세요. 압축 파일 미리보기 창에서 바로 실행하면 필요한 파일이 제대로 풀리지 않을 수 있습니다. 설치가 끝나면 시작 메뉴나 설치 폴더에서 클라이언트를 열고, 먼저 기본 창이 정상적으로 표시되는지 확인한 뒤 구독을 가져오세요.
Desktop과 WPF를 함께 설치할 필요는 없습니다. 기존 클라이언트를 사용 중이라면 구독 그룹, 라우팅, DNS 설정을 먼저 보관하세요. UI 버전을 전환할 때 모든 설정이 자동으로 옮겨진다고 가정하지 마세요. 두 버전을 비교하려면 실행 중인 클라이언트를 먼저 종료해 로컬 수신 포트가 중복 사용되지 않도록 하세요. 포트 충돌이 발생하면 시스템 트레이에 다른 프로세스가 남아 있는지 확인하세요.
설정을 가져온 뒤 노드를 선택하고 시스템 프록시를 설정하세요. 시스템 프록시는 해당 설정을 따르는 앱에 주로 적용되며 모든 프로그램의 트래픽을 자동으로 처리하지는 않습니다. 웹페이지 접속을 테스트한 다음 필요에 따라 라우팅을 조정하세요. 자세한 GUI 설정 방법은 Windows 설치 및 버전 선택 가이드를 확인하세요.
먼저 ‘이 Mac에 관하여’에서 칩 정보를 확인하세요. Apple M 시리즈라면 Apple Silicon을, Intel 프로세서라면 Intel 패키지를 선택하세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 칩 종류 | Apple M 시리즈는 arm64, Intel은 x64 패키지를 선택하세요. |
| 운영체제 버전 | 현재 배포 패키지의 요구 사항을 충족하는 macOS를 사용하세요. 최소 버전은 설치 프로그램의 안내를 확인하세요. |
| 설치 파일 형식 | DMG 디스크 이미지입니다. 파일을 연 다음 창의 안내에 따라 앱을 복사하세요. |
| 시스템 권한 | 처음 실행하거나 네트워크 설정을 변경할 때 시스템 설정에서 권한을 승인해야 할 수 있습니다. |
다운로드한 DMG를 열고 클라이언트를 응용 프로그램 폴더로 옮긴 다음 해당 폴더에서 실행하세요. 마운트된 디스크 이미지에서 프로그램을 계속 실행하면 업데이트, 경로 참조 또는 시스템 권한 기록에 혼선이 생길 수 있습니다. 앱 복사가 끝나면 디스크 이미지를 추출할 수 있습니다. 설치 파일과 복사된 앱은 서로 다른 항목입니다.
시스템에서 첫 실행을 차단하면 먼저 앱 이름과 다운로드 출처를 확인한 뒤 시스템 설정의 ‘개인정보 보호 및 보안’ 알림을 살펴보세요. 설치하려는 앱이 확실한 경우에만 허용하세요. 한 번 설치하기 위해 시스템 전체의 보안 기능을 끄면 안 됩니다. 시스템 버전이 호환되지 않는다는 알림이 표시되면 다른 칩용 설치 파일을 반복해서 시도하기보다 현재 macOS 버전을 먼저 확인하세요.
클라이언트를 연 뒤 구독을 가져오고 목록을 업데이트한 다음 노드를 선택하세요. 시스템 프록시와 TUN은 서로 다른 트래픽 처리 방식입니다. 처음 테스트할 때는 한 가지 방식만 사용하고 브라우저 접속이 정상인지 확인한 뒤 설정을 추가하세요. 이전에 다른 네트워크 도구를 사용했다면 먼저 연결을 중지하고 시스템 프록시가 이전 로컬 주소를 가리키는지 확인한 다음 현재 클라이언트 문제인지 판단하세요.
Android에서 우선 추천하는 클라이언트입니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택하면 되지만, 최종적으로는 기기 시스템에서 지원하는 ABI를 확인하세요.
V2Fly 코어가 필요한 설정에 적합합니다. 노드 이름만 보고 호환 여부를 판단하지 말고, 노드의 프로토콜과 전송 방식 조합이 지원되는지 먼저 확인하세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 시스템 아키텍처 | arm64 패키지를 사용하려면 시스템이 arm64-v8a를 지원해야 합니다. 프로세서가 64비트여도 운영체제까지 64비트라는 뜻은 아닙니다. |
| 운영체제 버전 | 선택한 APK의 최소 Android 버전을 충족해야 합니다. 자세한 내용은 시스템 설치 프로그램의 안내를 확인하세요. |
| 설치 권한 | APK를 여는 브라우저나 파일 관리자에만 출처를 알 수 없는 앱 설치 권한을 부여하세요. |
| 연결 권한 | 처음 연결할 때 시스템 VPN 권한을 승인해야 합니다. 동시에 다른 VPN 연결을 실행하지 마세요. |
다운로드가 완료되면 시스템 다운로드 목록이나 파일 관리자에서 APK를 여세요. 출처를 알 수 없는 앱 설치 권한을 요청하면 파일을 여는 앱을 확인한 뒤 권한을 부여하세요. 설치 후에는 이 권한을 취소할 수 있습니다. ‘앱이 설치되지 않았습니다’라는 메시지가 나오면 상세 오류를 먼저 확인하세요. 흔한 원인은 Android 버전이 낮거나 아키텍처가 맞지 않는 경우, 기존 앱과 새 패키지의 서명이 다른 경우입니다.
설정을 백업하지 않은 상태에서 기존 클라이언트를 바로 삭제하지 마세요. 서명 충돌이 발생하면 복구할 설정을 먼저 내보내고 구독 URL에 다시 접근할 수 있는지 확인한 다음 재설치 여부를 결정하세요. arm64와 범용 버전은 프록시 모드가 아니라 패키징 범위가 다른 설치 파일입니다. 패키지를 바꿔도 구독 만료, 서버 접속 불가, 프로토콜 매개변수 불일치가 자동으로 해결되지는 않습니다.
처음 연결하기 전에 구독을 가져와 업데이트하고 노드를 선택한 다음 연결 버튼을 누르세요. 시스템에서 VPN 연결을 요청하면 권한을 승인하세요. 백그라운드로 전환할 때 연결이 끊긴다면 배터리 최적화, 백그라운드 실행 권한, 기기 제조사의 절전 설정을 확인하세요. v2rayNG와 v2flyNG를 동시에 연결하지 않는 것이 좋습니다. 클라이언트를 바꾸기 전에 기존 연결을 중지해 네트워크 처리 상태를 잘못 판단하지 않도록 하세요.
먼저 배포판의 패키지 관리 체계를 확인한 다음 CPU 아키텍처를 확인하세요. deb와 rpm은 성능 등급이 아니므로 파일 확장자만 보고 설치를 시도하면 안 됩니다.
| 확인 항목 | 선택 기준 |
|---|---|
| 데스크톱 환경 | GUI 클라이언트이므로 앱을 실행할 수 있는 Linux 데스크톱 세션이 필요합니다. |
| 패키지 관리 체계 | Debian·Ubuntu 계열은 보통 deb, RPM 계열은 rpm을 선택하고 배포판의 의존성 호환성을 확인하세요. |
| 아키텍처 표기 | amd64와 x86_64는 x64에 해당하며, arm64와 aarch64는 64비트 ARM에 해당합니다. |
| 권한 및 의존성 | 설치하려면 패키지 관리 권한이 필요합니다. TUN에는 별도의 네트워크 권한이 필요하며, 의존성은 패키지 관리자가 확인합니다. |
시스템 설정의 기기 정보에서 아키텍처를 확인한 다음 배포판의 소프트웨어 설치 프로그램으로 다운로드한 파일을 여세요. 설치 프로그램에 의존성, 충돌 또는 지원되지 않는 패키지 형식이 표시되면 먼저 해당 내용을 해결하세요. 오류를 무시하고 설치를 강행하지 마세요. 오래된 배포판은 시스템 구성 요소가 현재 패키지의 요구 사항을 충족하지 못할 수 있으며, 다른 패키지 형식으로 바꾼다고 문제가 해결되는 것은 아닙니다.
설치가 끝나면 앱 메뉴에서 v2rayN을 실행하세요. 창이 나타나지 않으면 데스크톱 환경에 표시된 오류를 확인하고 이미 클라이언트 프로세스가 실행 중인지 살펴보세요. 시스템 트레이 표시 방식은 데스크톱 환경마다 다르므로 트레이 아이콘이 없다고 프로그램이 실행되지 않은 것은 아닙니다. 앱 창과 시스템 프로세스 상태를 함께 확인하세요.
Linux 데스크톱의 시스템 프록시 설정을 모든 앱이 사용하는 것은 아닙니다. 구독을 가져온 뒤 시스템 프록시를 지원하는 앱으로 먼저 연결을 확인하고, 앱 내 프록시나 TUN이 필요한지 판단하세요. 네트워크 처리 방식을 바꾸기 전에 기존 설정을 기록하세요. 여러 프록시 도구를 함께 사용한다면 다른 도구를 먼저 중지해 로컬 포트와 라우팅 규칙이 서로 영향을 주지 않도록 하세요.
설치 완료는 클라이언트를 사용할 준비가 되었다는 뜻일 뿐입니다. 노드 설정, 프록시 적용 방식, 라우팅 규칙을 각각 확인하세요. 여러 설정을 한꺼번에 바꾸지 말고 순서대로 진행하는 것이 좋습니다.
입문 가이드 전체 보기 →클라이언트 업데이트, 구독 업데이트, 노드 전환은 서로 다른 작업입니다. 클라이언트 업데이트는 프로그램과 포함 구성 요소를 변경하고, 구독 업데이트는 서비스 제공자가 배포한 노드 설정을 다시 가져옵니다. 노드 전환은 현재 사용할 아웃바운드만 선택하는 작업입니다. 연결에 실패하면 먼저 문제가 어느 단계에 있는지 구분하세요. 처음부터 재설치할 필요는 없습니다. 노드 하나만 작동하지 않는다면 같은 구독의 다른 노드와 비교한 뒤 로그의 구체적인 오류를 확인하세요.
업그레이드 전에 현재 정상적으로 작동하는 설정을 기록하고 구독 URL, 사용자 지정 라우팅, DNS 설정을 저장하세요. 내보낸 설정에 인증 정보가 포함될 수 있으므로 개인적으로 관리할 수 있는 위치에 보관하고 공개 게시판에 올리지 마세요. 로그를 공유할 때도 구독 URL, 사용자 식별 정보, 서버 인증 정보를 가리고 필요한 오류 내용만 남기세요.
업그레이드할 때는 먼저 연결을 중지하고 프로그램을 종료하세요. 설치가 끝나면 구독 그룹과 기본 모드가 유지되었는지 확인하세요. 기존 노드로 먼저 테스트해 정상 작동을 확인한 뒤 새 기능을 사용해 보세요. 클라이언트 업데이트, 노드 전환, DNS 변경, TUN 활성화를 한꺼번에 하면 문제가 생겼을 때 원인을 찾기 어렵습니다. 재설치를 반복하기보다 한 항목씩 바꾸고 되돌릴 수 있도록 기록을 남기는 편이 문제 해결에 효과적입니다.
세 클라이언트 중 무엇을 선택할지 모르겠다면 클라이언트 비교를 먼저 확인하세요. 연결은 되지만 분할 라우팅, TUN, DNS를 조정하려면 사용 설명서를 참고하세요. 다운로드 페이지는 설치 파일 선택에 중점을 두므로 처음 설치할 때 모든 고급 설정을 마칠 필요는 없습니다.
처음 설치한다면 차세대 크로스 플랫폼 UI를 사용하는 Desktop 버전을 먼저 고려해 보세요. WPF는 익숙한 기존 조작 방식을 선호하는 Windows 사용자에게 적합한 안정적인 클래식 버전입니다. 두 버전 모두 x64 패키지이므로 하나만 설치하면 됩니다. 전환하기 전에 구독과 사용자 설정을 백업하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택해도 되지만, 최종적으로는 시스템에서 지원하는 ABI를 확인해야 합니다. 기기가 32비트 시스템이거나 아키텍처를 확인할 수 없다면 범용 버전을 시도해 보세요. 설치에 실패하면 Android 버전, 다운로드 완료 여부, 서명이 다른 기존 앱이 설치되어 있는지도 확인하세요.
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. 칩에 Apple M 시리즈가 표시되면 Apple Silicon을, 프로세서에 Intel이 표시되면 Intel 패키지를 선택하세요. DMG를 연 다음 창의 안내에 따라 클라이언트를 응용 프로그램 폴더로 옮기고 해당 폴더에서 실행하세요.
클라이언트는 설정을 관리하고 연결을 만드는 프로그램이며, 설치 파일에 구독 서비스가 포함되지는 않습니다. 유효한 구독 URL이나 노드 공유 링크를 직접 준비해 클라이언트에 가져온 뒤 업데이트하고, 노드와 프록시 모드를 선택하세요. 구독 URL에는 접속 정보가 포함되어 있으므로 공개적으로 공유하지 마세요.
먼저 구독 그룹, 사용자 지정 라우팅, DNS 설정 및 기타 개인 설정을 내보내거나 백업하고 현재 프록시 모드를 기록하세요. 그런 다음 연결을 중지하고 클라이언트를 종료하세요. 업그레이드 후 설정이 유지되었는지 확인하고, 기존 노드와 모드로 먼저 테스트하세요. 여러 항목을 동시에 변경하지 않는 것이 좋습니다.
다운로드가 완료되었는지, 파일 형식이 운영체제와 일치하는지, CPU 아키텍처가 맞는지 먼저 확인하세요. Windows용 ZIP은 압축을 완전히 풀어야 합니다. macOS에서는 시스템 설정의 ‘개인정보 보호 및 보안’ 알림을 확인하고, Android에서는 설치 출처 권한과 기존 앱의 서명을 살펴보세요. Linux에서는 패키지 관리자가 표시한 의존성 충돌을 확인하고 오류를 무시한 채 설치하지 마세요.
연결이나 설정에 문제가 있나요? 도움말 센터를 확인하세요.