v2rayN 데스크톱 설치 파일
v2rayNG / v2flyNG Android 설치 파일
먼저 운영체제를 선택하고 프로세서 아키텍처를 확인하세요. 다운로드 항목은 파일 형식별로 나뉩니다. 기존 설정이 있는 기기는 업그레이드 전에 백업을 내보내세요.
처음 설치하시나요? 사용 가이드 보기 →v2rayN은 Desktop과 클래식 WPF 인터페이스를 제공합니다. 아래 파일은 모두 x64 설치 파일이므로, 먼저 시스템 설정에서 기기 유형을 확인하세요.
새로운 크로스 플랫폼 UI로, 처음 사용하는 분이나 데스크톱 운영체제가 달라도 비슷한 방식으로 사용하고 싶은 분에게 적합합니다.
익숙한 Windows 인터페이스를 유지하는 안정적인 클래식 버전입니다. 기존 작업 방식이 정해져 있다면 이 버전을 계속 사용할 수 있습니다.
Desktop과 WPF의 주요 차이는 인터페이스 기술과 화면 구성에 있으며, 서로 무관한 두 프록시 프로토콜이 아닙니다. 구독, 연결 대상, 라우팅은 사용하는 코어의 기능에 맞춰 설정해야 합니다. 창 모양만 보고 특정 프로토콜을 사용할 수 있는지 판단하지 마세요. 필요한 항목이 보이지 않으면 현재 클라이언트와 코어의 호환 범위를 확인하세요.
설치 전에 실행 중인 v2rayN을 종료하세요. 특히 작업 표시줄의 시스템 트레이도 확인해야 합니다. 기존 클라이언트가 설정 파일을 계속 사용 중이면 업그레이드 후 저장되지 않은 설정이 불러와질 수 있습니다. 인터페이스 버전을 바꿀 때는 먼저 설정을 내보낸 뒤 새 버전의 가져오기 기능으로 복원하세요. 서로 다른 버전의 프로그램 폴더 전체를 덮어쓰는 방법은 권장하지 않습니다.
처음 실행한 뒤 구독을 가져오고 서버 정보를 확인한 다음 시스템 프록시를 켤지 결정하세요. 시스템 프록시는 운영체제의 프록시 설정을 따르는 앱에만 영향을 주며, 모든 프로그램의 트래픽이 프록시를 거치는 것은 아닙니다. 브라우저는 연결되는데 특정 앱만 연결되지 않는다면 해당 앱이 시스템 프록시를 사용하는지 먼저 확인한 뒤 다른 트래픽 처리 방식을 검토하세요.
v2rayN 데스크톱 버전을 사용하세요. Apple Silicon과 Intel용 설치 파일은 다르므로 컴퓨터 외관이나 구입 연도로 판단하지 마세요.
처음 실행할 때 출처 또는 실행 권한에 관한 안내가 표시될 수 있습니다. 안내를 읽고 시스템 설정에서 허용하는 범위 내에서 처리하세요. 조직에서 관리하는 기기라면 기기 정책을 따르고, 앱을 실행하려고 시스템 보안 기능을 전역으로 끄지 마세요. 이 컴퓨터에서 앱을 실행할 수 없다는 메시지가 나오면 칩 아키텍처와 시스템 버전을 먼저 다시 확인하세요.
기존 구독을 가져온 뒤 클라이언트가 설정을 읽을 수 있는지 확인하고 필요한 프록시 모드를 켜세요. 시스템 프록시를 변경하면 브라우저와 시스템 네트워크 설정을 사용하는 다른 앱에도 영향을 줄 수 있습니다. 수동 프록시나 다른 네트워크 도구를 사용 중이라면 기존 설정을 기록하고 동시에 변경하지 않도록 주의하세요. 클라이언트를 종료한 뒤에도 인터넷이 연결되지 않으면 시스템 네트워크 설정에 이전 프록시 주소가 남아 있는지 확인하세요.
다른 데스크톱 운영체제에서 옮길 때는 구독을 먼저 동기화한 다음 라우팅과 DNS를 하나씩 이전할 수 있습니다. 구독 링크는 주로 서버 정보를 전달하므로 이 기기의 모든 사용자 설정까지 복사해 주지는 않습니다. 로컬 파일 경로, 네트워크 인터페이스, 권한 관련 설정은 새 기기에서 다시 확인하세요.
우선 Xray 코어를 사용하는 v2rayNG를 선택하세요. V2Fly 설정을 그대로 사용해야 하는 경우에는 v2flyNG를 고려할 수 있습니다. 두 클라이언트의 설정은 각각 별도로 관리됩니다.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택할 수 있지만, 시스템도 64비트 앱을 지원해야 합니다. 아키텍처를 확인할 수 없다면 범용 버전을 선택하세요. 스마트폰 프로세서의 사양만으로 판단하지 마세요.
V2Fly 호환 설정을 이미 사용 중인 경우에 적합합니다. arm64와 범용 버전의 선택 기준은 동일합니다. 클라이언트를 바꾸기 전에 필요한 프로토콜과 전송 설정을 해당 코어가 지원하는지 확인하세요.
| 확인 항목 | 설치 전 확인 | 문제 발생 시 |
|---|---|---|
| 시스템 및 아키텍처 | Android. arm64 파일은 64비트 앱 지원이 필요합니다. | 아키텍처를 모르면 범용 버전을 시도하세요. 최소 시스템 버전은 설치 프로그램 안내를 확인하세요. |
| 설치 파일 형식 | APK. 기기의 설치 프로그램으로 처리됩니다. | 다운로드가 완료됐는지 확인하고, 현재 브라우저 또는 파일 관리자의 앱 설치 권한을 확인하세요. |
| 네트워크 권한 | VPN 모드를 사용하려면 시스템 권한이 필요합니다. | 다른 앱이 현재 VPN 연결을 사용 중인지 확인하세요. |
| 기존 앱 위에 업그레이드 | 동일한 앱은 서명 채널을 유지해야 합니다. | 서명 충돌이 발생하면 먼저 백업하세요. 기존 앱을 바로 삭제하지 마세요. |
APK를 열면 현재 브라우저나 파일 관리자가 앱을 설치하도록 허용하라는 메시지가 표시될 수 있습니다. 이번에 사용할 출처에만 필요한 권한을 허용하고, 설치 후에도 권한이 필요한지 확인하세요. 설치 프로그램에서 앱을 설치할 수 없다고 나오면 아키텍처 비호환, 시스템 버전 미달, 서명 불일치를 먼저 구분하세요. 같은 파일을 반복해서 다운로드하고 설치하지 마세요.
v2rayNG 화면의 버전 표시와 패키지명은 목록에서 버전 필드와 다운로드 항목을 따로 관리하므로 일시적으로 일치하지 않을 수 있습니다. 설치 프로그램에 표시되는 버전과 클라이언트의 “정보” 화면에서 실제 설치 결과를 확인할 수 있습니다. 패키지명의 숫자를 화면에 표시된 버전에 맞춰 직접 바꾸거나, 이 차이만으로 다른 다운로드 주소를 추측하지 마세요.
처음 연결을 시작하면 시스템 VPN 권한 요청이 표시됩니다. 이 권한은 클라이언트가 규칙에 따라 기기 트래픽을 처리하는 데 필요하며, 서버 정보가 올바르다는 뜻은 아닙니다. 구독을 가져오고 설정을 선택한 뒤 서비스를 시작하고, 로그와 실제 앱 접속으로 연결을 확인하세요. 기기에서 다른 VPN 서비스를 사용 중이라면 어느 앱이 연결을 처리할지 먼저 정해야 합니다.
백그라운드 연결 끊김과 설치 파일 아키텍처는 대개 별개의 문제입니다. 화면이 꺼진 뒤 연결이 끊기면 배터리 최적화, 백그라운드 활동 제한, 시스템 정리 정책을 확인하세요. 앱별 프록시는 실제 필요에 따라 설정하고, 로컬에서만 사용해야 하는 앱까지 불필요하게 포함하지 마세요. Mux를 배터리 사용 시간을 늘리는 상시 설정으로 사용해서도 안 됩니다.
v2rayN GUI 클라이언트를 사용하세요. 배포판에 맞춰 deb 또는 rpm을 선택한 다음 x64와 arm64 중 기기 아키텍처를 확인하세요.
다운로드가 완료되면 배포판의 GUI 소프트웨어 설치 프로그램으로 패키지를 열어 패키지 관리자가 의존성과 충돌을 확인하도록 하세요. rpm 파일명의 배포 대상도 호환성 판단에 포함해야 합니다. 시스템에서 rpm을 사용한다는 이유만으로 설치를 강행하지 마세요. 의존성이 없거나 기본 라이브러리 버전이 맞지 않으면 시스템과 배포 파일의 요구 사항을 확인하고 의존성 검사를 건너뛰지 마세요.
설치가 끝나도 데스크톱 환경이 자동으로 프록시를 사용하지는 않습니다. 데스크톱 세션과 앱마다 시스템 프록시를 읽는 방식이 다를 수 있습니다. 먼저 클라이언트에서 유효한 연결 대상을 설정한 뒤, 대상 앱이 데스크톱 프록시 설정을 따르는지 확인하세요. 브라우저, 백그라운드 서비스, 독립 네트워크 앱은 각각 따로 확인해야 할 수 있습니다.
네트워크 트래픽 처리 기능이 필요하다면 먼저 관련 권한 안내를 읽으세요. GUI를 실행하기 위해 클라이언트 전체를 관리자 권한으로 계속 실행하지 마세요. 업그레이드 전에 클라이언트에서 설정을 내보내고 사용자 지정 라우팅, DNS, 로컬 경로 설정을 보관하세요. 복원 후 권한과 파일 위치가 여전히 유효한지 하나씩 확인하세요.
설치 파일은 프로그램과 아키텍처만 결정합니다. 실제 연결 여부는 서버 정보, 프로토콜 호환성, 기기의 프록시 모드에도 달려 있습니다.
구독 그룹, 수동 서버, 라우팅 규칙, DNS, 인터페이스 설정을 보관하세요. 구독 링크만 저장하면 보통 기기의 모든 설정을 복원할 수 없습니다. 백업에는 연결 자격 증명이 포함될 수 있으므로 안전한 곳에 보관하고 공개 게시판에 올리지 마세요.
클라이언트 설치 파일에는 서버 정보가 포함되지 않습니다. 구독, 공유 링크 또는 설정 백업을 가져온 뒤 주소, 포트, 프로토콜, 전송 보안 항목을 확인하세요. 가져오기에 성공했다는 것은 형식을 인식했다는 뜻일 뿐, 원격 서버를 사용할 수 있다는 의미는 아닙니다.
연결 대상을 선택한 뒤 시스템 프록시 또는 VPN 모드를 켜세요. 먼저 대상 앱으로 연결을 확인하고 로그에서 DNS, 핸드셰이크, 라우팅 결과를 살펴보세요. 시작 성공 메시지만으로 앱 요청이 예상한 규칙을 따르는지 알 수는 없습니다.
설치 파일 선택부터 첫 실행까지, 아키텍처·서명·런타임·설정 문제를 구분해 확인하세요.
처음 설치한다면 새 크로스 플랫폼 인터페이스를 적용한 Desktop 버전을 먼저 고려해 보세요. 클래식 인터페이스가 익숙하거나 기존 작업 방식을 유지해야 한다면 안정적인 WPF 버전을 선택할 수 있습니다. 둘 다 v2rayN이므로 시스템 프록시를 동시에 켜지 말고, 버전을 바꾸기 전에 설정을 백업하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 고려할 수 있지만, 시스템이 64비트 앱을 지원하는지 확인해야 합니다. 아키텍처를 모르거나 arm64 설치 프로그램에서 호환되지 않는다는 메시지가 나오면 범용 버전을 시도해 보세요. 범용 버전은 여러 아키텍처 구성 요소를 포함할 뿐, 연결 속도가 더 빠르다는 뜻은 아닙니다.
버전 표기와 파일 다운로드 항목은 목록의 서로 다른 필드에서 가져오므로 일시적으로 일치하지 않을 수 있습니다. 버전 표기만으로 설치 파일의 내용을 추측하거나 다운로드 경로를 직접 수정하지 마세요. 설치할 때는 시스템 설치 프로그램에 표시된 버전을 확인하고, 설치 후에는 클라이언트의 정보 화면에서 실제 버전을 확인하세요.
먼저 클라이언트 설정을 내보내 구독 그룹, 수동 서버, 라우팅 규칙, DNS 설정을 보관하세요. 기존 클라이언트를 종료한 뒤 업그레이드해야 합니다. Android에서는 가능하면 동일한 설치 경로와 서명 채널을 사용하세요. 서명 충돌이 표시되면 바로 앱을 삭제하지 말고 먼저 백업을 완료하세요.
설치 파일에는 클라이언트 프로그램만 포함되며, 바로 사용할 수 있는 서버 설정은 들어 있지 않습니다. 기존 구독이나 유효한 서버 정보를 가져온 다음 연결 대상을 선택하고 프록시 모드를 설정해야 합니다. 연결되지 않으면 먼저 주소, 포트, 프로토콜, 전송 보안 항목을 확인하고 로그를 살펴보세요.
운영체제, 프로세서 아키텍처, 설치 파일 형식, 시스템 버전을 확인한 다음 다운로드가 완료됐는지 살펴보세요. Windows ZIP 파일은 압축을 완전히 푼 뒤 설치 프로그램을 실행해야 합니다. Android에서는 설치 출처 권한과 서명 충돌을, Linux에서는 배포판 의존성을 확인하세요. macOS에서는 시스템 보안 안내를 읽고 조직 또는 기기 정책에 따라 처리하세요.