먼저 운영체제를 선택한 다음 CPU 아키텍처를 확인하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 사용하고 v2flyNG는 코어 호환성을 위한 대안으로 선택할 수 있습니다.
세 클라이언트 모두 무료 오픈 소스 소프트웨어입니다. 설치 후 유효한 구독이나 서버 설정을 가져와야 합니다.
같은 클라이언트, 두 가지 인터페이스. 아래 설치 파일은 모두 x64입니다.
Desktop은 차세대 크로스 플랫폼 UI로, 처음 설치하거나 여러 데스크톱 운영체제에서 사용하기에 적합합니다. WPF는 안정적인 클래식 버전으로 기존 사용 방식에 익숙한 경우에 알맞습니다. 먼저 인터페이스를 선택한 뒤 설정을 가져오세요. 두 버전을 동시에 실행할 필요는 없습니다.
다운로드 파일은 ZIP 압축 파일입니다. 압축을 완전히 푼 다음 안에 있는 설치 프로그램을 실행하세요. 압축 파일 미리보기에서 바로 실행하지 마세요.
| 확인 항목 | 선택 및 요구 사항 | 확인 위치 |
|---|---|---|
| 운영체제 | 보안 업데이트를 계속 제공하는 Windows 사용을 권장합니다. 최소 지원 버전은 현재 설치 프로그램의 안내를 확인하세요. | 설정 → 시스템 → 시스템 정보 |
| 프로세서 아키텍처 | 이 페이지에서는 x64 설치 파일을 제공합니다. 설치 전에 시스템 종류와 앱 호환성을 확인하세요. | 시스템 정보 → 시스템 종류 |
| 런타임 환경 | 런타임이 없다는 안내가 표시되면 설치 파일에서 요구하는 환경을 설치한 뒤 다시 시도하세요. | 설치 및 앱 실행 안내 |
설치 디렉터리는 읽기와 쓰기가 가능한 위치에 두고, 다운로드 임시 폴더에 설정을 장기간 보관하지 마세요. 처음 실행한 뒤 기본 창이 정상적으로 열리는지 확인하고 구독을 가져오세요. 시스템 프록시를 설정하면 시스템 프록시를 읽는 앱에 영향을 주지만, 모든 프로그램이 자동으로 프록시를 사용한다는 뜻은 아닙니다. 다른 앱의 트래픽까지 처리하려면 권한과 라우팅 영향을 확인한 뒤 TUN 모드를 별도로 설정하세요.
WPF에서 Desktop으로 전환하기 전에 클라이언트의 내보내기 기능으로 설정을 저장하고 로컬 수신 포트, 구독 그룹, 라우팅 구성을 기록하세요. 다른 버전의 프로그램을 기존 디렉터리에 그대로 덮어쓰지 마세요. 기존 클라이언트를 종료한 다음 새 클라이언트를 실행하면 포트 충돌을 방지하고 두 프로세스가 시스템 프록시 설정을 번갈아 변경하는 문제를 줄일 수 있습니다.
컴퓨터 외관이나 구매 연도가 아니라 이 Mac에 관하여에서 칩 정보를 확인하세요.
Apple M 시리즈 칩은 Apple Silicon을, Intel 프로세서는 Intel 패키지를 선택하세요. 기기 아키텍처에 맞는 버전을 사용하면 추가 호환성 계층으로 인한 시작 및 실행 차이를 줄일 수 있습니다.
DMG를 연 뒤 앱을 응용 프로그램 폴더로 복사하고 해당 폴더에서 실행하세요. 복사가 끝나면 디스크 이미지를 추출해도 됩니다.
| 확인 항목 | 선택 및 요구 사항 | 확인 위치 |
|---|---|---|
| 운영체제 버전 | 보안 업데이트를 계속 제공하는 macOS를 사용하세요. 최소 호환 버전은 앱 안내를 확인하세요. | Apple 메뉴 → 이 Mac에 관하여 |
| 칩 아키텍처 | Apple M 시리즈는 arm64, Intel은 x64를 사용합니다. | 이 Mac에 관하여 → 칩 또는 프로세서 |
| 네트워크 권한 | 프록시를 변경하거나 네트워크 트래픽 처리를 활성화할 때는 시스템 안내에 표시된 권한을 확인하세요. | 시스템 설정 → 네트워크 |
처음 실행할 때 시스템 보안 안내가 표시되면 파일 출처와 선택한 아키텍처, 안내 내용을 먼저 확인한 다음 개인정보 보호 및 보안에서 열기 허용 옵션이 있는지 살펴보세요. 앱 하나를 실행하기 위해 시스템 보안 기능 전체를 끄지 마세요. 파일이 손상되었거나 호환되지 않는다는 안내가 명확하다면 권한을 반복해서 변경하기보다 아키텍처에 맞는 파일을 다시 다운로드하는 편이 낫습니다.
시스템 프록시를 설정한 뒤 현재 네트워크 서비스의 프록시 설정에서 주소와 포트가 클라이언트와 일치하는지 확인하세요. 네트워크를 전환하거나 잠자기에서 깨어난 뒤, 또는 클라이언트를 종료한 뒤 브라우저에 접속할 수 없다면 로컬 프록시 설정이 남아 있는지 먼저 살펴보세요. 평소에는 클라이언트 메뉴에서 종료하고, 업데이트 전에는 기존 프로세스를 종료한 뒤 응용 프로그램 폴더의 파일을 교체하세요.
먼저 아키텍처를 확인하고 코어 호환성을 살펴보세요. 2015년 이후 출시된 일반적인 스마트폰은 arm64를 우선 선택하면 됩니다.
Android에서 우선 권장하는 그래픽 클라이언트입니다. 구독 관리, 노드 선택, 연결을 앱에서 모두 처리할 수 있습니다. VLESS, REALITY 등의 설정을 사용할 때는 서버 매개변수와 현재 코어의 지원 여부도 확인하세요.
앱에 표시되는 버전과 실제 설치 파일명은 일시적으로 다를 수 있습니다. 선택한 파일과 설치 후 정보 화면에 표시되는 실행 버전을 기준으로 확인하세요.
기존 설정이 V2Fly의 동작 방식에 의존하는 경우에 적합합니다. v2rayNG의 인터페이스 테마가 아니며, 두 클라이언트는 코어와 설정 지원 범위가 다릅니다. 가져오기 전에 프로토콜, 전송 방식, 보안 항목을 확인하고 한 클라이언트의 고급 설정 전체를 그대로 옮기지 마세요.
| 확인 항목 | 선택 및 요구 사항 | 확인 위치 |
|---|---|---|
| 시스템 호환성 | 최소 Android 버전은 선택한 APK에 따라 다릅니다. 설치 프로그램의 안내를 확인하세요. | 설정 → 휴대전화 정보 → Android 버전 |
| 기기 아키텍처 | 2015년 이후 출시된 일반적인 스마트폰은 arm64를 선택하세요. 구형 기기이거나 아키텍처를 모르면 범용 버전을 선택하면 됩니다. | 기기 정보 또는 제조사 프로세서 사양 |
| 필요한 권한 | 설치할 때 현재 출처의 앱 설치를 허용하고, 연결할 때 시스템 VPN 요청을 승인하세요. | 앱 설치 프로그램 및 시스템 VPN 대화상자 |
출시 연도는 참고 기준일 뿐입니다. 일부 기기는 64비트 프로세서를 사용해도 시스템의 앱 실행 환경이 다를 수 있으므로 기기 정보와 실제 설치 결과를 기준으로 판단하세요. '앱이 설치되지 않았습니다'라는 메시지가 나오면 여유 공간, 파일 다운로드 완료 여부, 같은 이름의 앱과 서명 충돌이 있는지 먼저 확인하세요. 모든 설치 오류를 프로세서 아키텍처 탓으로 돌리지 마세요.
처음 연결할 때 시스템 VPN 권한 요청이 표시됩니다. 권한을 허용하면 기기 내 트래픽을 처리할 수 있게 되지만 서버 연결에 성공했다는 뜻은 아닙니다. 테스트할 때는 시스템 VPN 통로를 사용하는 앱을 하나만 실행하세요. 백그라운드에서 연결이 끊기면 처음부터 모든 권한을 허용하기보다 제조사별 배터리 관리 설정에서 백그라운드 제한을 확인하세요.
배포판의 패키지 관리 방식에 따라 deb 또는 rpm을 선택한 다음 x64와 arm64를 확인하세요.
Linux 데스크톱 버전은 그래픽 설정 인터페이스를 제공합니다. Debian·Ubuntu 계열은 일반적으로 deb를, Fedora·RHEL 계열은 rpm을 사용합니다. 패키지 형식은 첫 번째 확인 항목일 뿐이며, 같은 형식이라도 배포판에 따라 필요한 라이브러리 버전이 다를 수 있습니다.
Fedora / RHEL 계열
rpm 다운로드 · x64v2rayN-7.24.1-1.el10.x86_64.rpm
ARM 기기: rpm 다운로드 · arm64 →amd64와 x86_64는 여기서 x64에 해당하고, aarch64는 arm64에 해당합니다. 파일명에 배포판 표시가 있다면 대상 시스템이 의존성을 충족하는지도 확인하세요.
| 확인 항목 | 선택 및 요구 사항 | 확인 위치 |
|---|---|---|
| 데스크톱 환경 | 그래픽 앱을 실행할 수 있는 데스크톱 세션이 필요합니다. | 시스템 설정 → 정보 |
| 패키지 형식 및 아키텍처 | deb / rpm은 배포판에 맞추고, x64 / arm64는 프로세서에 맞추세요. | 시스템 정보 및 그래픽 패키지 관리자 |
| 의존성 및 권한 | 패키지 관리자로 의존성을 확인하고, 트래픽 처리에 필요한 추가 권한은 기능에 맞게 설정하세요. | 소프트웨어 설치 프로그램 안내 및 클라이언트 설정 |
패키지를 더블 클릭한 뒤 배포판의 그래픽 소프트웨어 설치 프로그램에서 의존성과 설치 결과를 확인하세요. 의존성 버전이 부족하다는 안내가 나오면 무시하고 강제로 진행하지 말고 패키지 대상 배포판과 현재 시스템 버전을 확인하세요. 설치는 완료됐지만 실행되지 않는다면 오류 메시지에 나온 라이브러리 이름과 버전을 기록하고 문제 해결 안내를 참고하세요. 의존성이 충족되지 않은 상태에서는 반복해서 설치해도 해결되지 않습니다.
Linux의 시스템 프록시 설정은 데스크톱 환경에 따라 다르며, 앱마다 프록시 설정을 읽는 방식도 다를 수 있습니다. 브라우저에서는 접속되지만 다른 프로그램은 연결되지 않는다면 먼저 해당 앱의 네트워크 설정을 확인하세요. 일반 프록시 기능을 사용하려고 그래픽 클라이언트 전체를 장기간 높은 권한으로 실행하지 마세요. TUN 등의 기능에 필요한 권한은 클라이언트 안내에 따라 별도로 설정하세요.
파일 다운로드 완료와 프록시 연결은 별도의 단계입니다. 먼저 클라이언트가 정상적으로 실행되는지 확인한 다음 설정과 트래픽 경로를 점검하세요.
구독 가져오기 및 모드 설정 가이드 →설치 → 설정 가져오기 → 노드 선택 → 프록시 확인
먼저 앱이 정상적으로 열리는지 확인하세요. 시스템 프록시, VPN, 트래픽 처리 권한은 해당 기능을 사용할 때만 설정하면 됩니다. 설치를 마쳤다고 모든 권한을 미리 허용할 필요는 없습니다.
유효한 구독 주소나 서버 설정을 가져오고, 프로토콜과 전송 항목을 클라이언트가 인식하는지 확인하세요. 클라이언트 자체는 계정, 구독, 네트워크 회선을 제공하지 않습니다.
노드 하나를 선택해 실제 연결을 테스트한 다음 필요한 프록시 모드를 활성화하세요. 브라우저로 접속을 확인하고 로그를 참고해 DNS 확인, 핸드셰이크, 라우팅 중 어느 단계에서 실패했는지 살펴보세요.
업데이트 전에 복원 가능한 설정을 보관하고, 업데이트 후에는 범위를 좁혀 먼저 확인하세요.
설정을 내보낼 때 백업에 구독 그룹, 사용자 지정 라우팅, 로컬 포트, 앱 환경설정이 포함되는지 확인하세요. 일부 데이터는 별도 파일에 저장될 수 있으므로 메인 프로그램만 복사해서는 부족합니다. 백업에는 구독 주소와 서버 식별 정보가 포함될 수 있으니 직접 관리하는 안전한 위치에 보관하세요. 공개 게시판에 붙여 넣거나 전체 설정 화면을 일반적인 오류 첨부 파일로 공유하지 마세요.
새 버전을 설치하기 전에 실행 중인 클라이언트를 종료하세요. 데스크톱에서는 시스템 트레이나 메뉴 표시줄도 확인해 백그라운드 프로세스가 종료되었는지 살펴보세요. Android에서 덮어쓰기 설치를 할 때는 기존 앱 데이터를 유지해야 합니다. 설치 출처가 달라지면 서명 제한이 발생할 수 있고, 인터페이스나 코어를 바꾸면 설정 항목이 달라질 수 있습니다. 충돌이 발생하면 먼저 기존 설정을 저장한 뒤 재설치 여부를 결정하세요. 문제 해결을 위해 데이터를 바로 삭제하지 마세요.
업데이트 후 정보 화면에서 실행 버전을 확인하고, 이미 사용 가능한 설정 하나로 연결을 테스트하세요. 시스템 프록시 주소, 수신 포트, 라우팅 구성이 예상치 않게 바뀌지 않았는지 확인한 다음 자동 구독 업데이트를 다시 활성화하세요. 새 버전에서만 문제가 발생한다면 시스템, 아키텍처, 패키지명, 오류 메시지를 기록하고 문제 해결 절차에 따라 하나씩 확인하세요.
설치 파일 선택 오류, 시스템 설치 제한, 연결 설정 문제를 구분해 확인하세요.
처음 사용한다면 차세대 크로스 플랫폼 인터페이스를 적용한 Desktop을 권장합니다. 클래식 인터페이스에 익숙하거나 기존 WPF 사용 방식을 유지하려면 안정적인 WPF 버전을 선택하세요. 두 버전의 차이는 인터페이스 방식이며, 노드 서비스나 네트워크 회선의 차이가 아닙니다. 전환하기 전에 설정을 내보내고 프로그램 디렉터리를 그대로 혼용하지 마세요.
Windows는 설정의 시스템 정보에서 시스템 종류를 확인하세요. Mac은 이 Mac에 관하여에서 칩을 확인하고, Apple M 시리즈는 Apple Silicon, Intel 프로세서는 Intel을 선택하면 됩니다. Linux는 시스템 정보에서 하드웨어 아키텍처를 확인하세요. Android는 기기 정보에서 프로세서를 확인합니다. 2015년 이후 출시된 일반적인 스마트폰은 arm64를 우선 선택하고, 확실하지 않다면 범용 버전을 선택하세요.
먼저 저장 공간, 앱 설치 권한, 설치 파일의 아키텍처를 확인하세요. 같은 이름의 앱이 이미 있다면 서명 출처가 다르거나 현재 버전보다 오래된 설치 파일인지도 살펴봐야 합니다. 바로 삭제하지 말고 설정을 내보내 백업이 정상인지 확인한 다음, 실제 오류 메시지에 따라 조치하세요. 출처가 다른 설치 파일은 덮어쓰기가 되지 않을 수 있습니다.
클라이언트는 설정 관리와 트래픽 전달 기능만 제공하며, 노드 서비스는 포함하지 않습니다. 유효한 구독이나 서버 설정을 가져오고 노드를 선택해 연결한 뒤, 시스템 프록시 또는 VPN 권한이 적용되었는지 확인하세요. 그래도 연결되지 않으면 노드 상태, 라우팅, DNS 순서로 점검하세요.
일반적인 덮어쓰기 업데이트는 앱 데이터를 유지하는 경우가 많지만, 인터페이스 버전이나 설치 출처, 메이저 버전을 바꾸면 설정이 완전히 호환된다고 단정할 수 없습니다. 업데이트 전에 클라이언트에서 설정을 내보내고 구독 그룹, 라우팅 구성, 로컬 포트를 기록하세요. 업데이트 후 노드 하나로 먼저 확인한 다음 자동 업데이트와 사용자 지정 라우팅을 복원하세요.
버전 표시는 앱 업데이트 정보에서 가져오고, 각 설치 파일에는 별도의 파일명이 있어 일시적으로 서로 다를 수 있습니다. 다운로드할 때 플랫폼과 아키텍처, 실제 파일명을 확인하고 설치 후 클라이언트의 정보 화면에서 실행 중인 버전을 확인하세요. 다른 설치 파일을 찾으려고 다운로드 주소의 숫자를 직접 바꾸지 마세요.