설치 파일운영체제를 먼저, 아키텍처는 다음에 선택
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. 운영체제, CPU, 설치 형식에 맞는 파일을 고른 뒤 구독을 가져오면 됩니다.
네 가지 플랫폼별로 해당 설치 파일을 안내합니다. 카드의 기본 버튼은 일반적으로 권장되는 선택이며, 다른 아키텍처와 클래식 UI는 인접한 항목에서 확인할 수 있습니다.
두 설치 파일 모두 x64 아키텍처입니다. 처음 설치한다면 Desktop을 선택하고, 클래식 UI에 익숙한 경우 WPF를 고려하세요.
Desktop은 차세대 크로스 플랫폼 UI이며, WPF는 익숙한 Windows 데스크톱 레이아웃을 유지하는 클래식 안정판입니다.
압축을 푼 다음 설치하세요. 현재 두 다운로드 항목은 ZIP 파일입니다. 파일을 다운로드한 뒤 파일 탐색기에서 전체 압축을 풀고, 압축 해제 폴더 안의 설치 프로그램과 안내를 확인하세요. 압축 파일 미리보기에서 바로 실행하지 마세요. 현재 계정에 폴더 읽기 및 쓰기 권한이 있는지 확인하고, 보호된 시스템 폴더에 설정을 저장하지 마세요.
Desktop과 WPF의 차이는 주로 UI 기술과 조작 방식에 있으며, 같은 서버를 사용한다고 해서 속도가 반드시 달라지는 것은 아닙니다. 평소의 사용 방식, 시스템 호환성, 필요한 설정 항목을 기준으로 선택하세요. 기존 설정에 규칙이 많다면 먼저 백업을 내보낸 뒤 새 UI에서 항목별로 확인하고, 사용 가능한 설정을 유일한 복사본으로 덮어쓰지 마세요.
| 확인 항목 | 선택 및 조치 |
|---|---|
| CPU 아키텍처 | 이 페이지에서는 x64 파일을 제공합니다. 시스템 설정의 '시스템 정보' 또는 '정보'에서 시스템 종류를 확인하세요. 32비트 시스템에는 이 파일을 설치할 수 없습니다. |
| 시스템 및 런타임 | 지원이 계속되는 64비트 Windows를 사용하세요. 최소 버전과 데스크톱 런타임 요구 사항은 해당 설치 파일 안내를 확인해야 합니다. 실행 오류가 발생하면 안내에 따라 해당 아키텍처의 종속 구성 요소를 설치하세요. |
| 파일 및 권한 | 압축을 풀 수 있는 공간을 충분히 확보하세요. 일반 프록시 사용과 가상 네트워크 어댑터 사용에는 서로 다른 권한이 필요하며, TUN을 켤 때는 권한을 높여야 할 수 있습니다. |
두 번 클릭해도 반응이 없다면 시스템 오류 메시지, 런타임 안내, 클라이언트 로그를 먼저 확인하세요. 항상 관리자 권한으로 실행하는 것을 일반적인 해결책으로 삼지 마세요. v2rayN 시작 직후 종료되는 문제 해결을 참고해 종속 구성 요소 누락, 폴더 권한, 설정 손상 여부를 구분할 수 있습니다.
Apple 메뉴에서 '이 Mac에 관하여'를 여세요. Apple M 시리즈 칩이 표시되면 Apple Silicon을, Intel 프로세서가 표시되면 Intel을 선택하세요.
기기에 맞는 기본 아키텍처 설치 파일을 우선 사용하세요. 기기 외관이나 구입 연도만으로 판단하지 마세요.
응용 프로그램 폴더에서 실행하세요. DMG를 열고 디스크 이미지의 안내에 따라 설치한 뒤 앱을 '응용 프로그램' 폴더로 옮겨 해당 폴더에서 실행하세요. 처음 열 때 시스템 보안 알림이 표시될 수 있습니다. 출처를 확인한 다음 '시스템 설정 → 개인정보 보호 및 보안'에서 이번 실행에 해당하는 허용 항목을 확인하세요.
앱 실행이 허용되었다고 해서 시스템 프록시나 가상 네트워크 어댑터 관련 권한까지 준비된 것은 아닙니다. 설정을 가져온 뒤 먼저 시스템 프록시로 브라우저 연결을 확인하고, 필요한 경우 TUN을 켜세요. 시스템 업데이트, 앱 이동, 재설치 후에는 기존 권한을 다시 확인해야 할 수 있습니다. 조직에서 관리하는 기기는 해당 관리 정책을 따르고 관리자 설정을 우회하지 마세요.
| 확인 항목 | 선택 및 조치 |
|---|---|
| 칩 아키텍처 | Apple M 시리즈는 arm64, Intel 프로세서는 x64를 사용합니다. 해당 아키텍처의 기본 설치 파일을 선택해 아키텍처 변환으로 인한 호환성 변수를 줄이세요. |
| 시스템 버전 | '이 Mac에 관하여'에서 macOS 버전을 먼저 확인하세요. 최소 시스템 버전은 현재 설치 파일의 요구 사항을 따르며, DMG 형식만으로 호환성을 판단할 수 없습니다. |
| 설치 권한 | 응용 프로그램 폴더에 쓸 수 있는 권한이 필요합니다. 첫 실행, 보안 허용, 이후 네트워크 권한은 각각 처리하세요. 시스템 보호 기능 전체를 끄지 마세요. |
'개발자를 확인할 수 없음' 메시지가 표시되거나 실행 후 트래픽을 처리하지 못하면 macOS 앱 허용 설정 및 네트워크 권한 안내를 확인하세요. 먼저 앱이 정상적으로 열리는지 확인한 뒤 프록시와 네트워크 권한을 점검하면 여러 설정을 한꺼번에 변경하지 않아도 됩니다.
v2rayNG를 우선 선택하세요. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택할 수 있습니다. 아키텍처를 모르면 범용 버전을 사용할 수 있지만, 시스템 버전 요구 사항은 충족해야 합니다.
Android에서 일상적으로 사용하기 적합합니다. 구독 그룹으로 설정을 관리하고, VPN 권한으로 트래픽을 전달하며, 앱별 프록시를 설정할 수 있습니다.
arm64 파일에는 해당 아키텍처용 구성 요소만 포함되어 있어 64비트 앱을 지원하는 기기에 적합합니다. 범용 버전은 더 많은 아키텍처를 지원하지만 파일 크기가 더 클 수 있습니다. 일부 스마트폰은 64비트 프로세서를 사용해도 시스템에서 64비트 앱을 지원하지 않을 수 있습니다. 설치에 실패하면 프로세서 이름만 보지 말고 시스템과 앱 아키텍처를 확인하세요.
APK를 열면 현재 브라우저나 파일 관리자에서 앱을 설치하도록 허용하라는 메시지가 표시될 수 있습니다. 이번에 사용할 출처에 필요한 경우에만 권한을 허용하고, 설치가 끝나면 권한을 해제할 수 있습니다. 처음 연결할 때는 시스템 VPN 권한 안내도 표시됩니다. 다른 앱이 VPN 연결을 사용 중이라면 먼저 해당 앱을 중지해야 하는지 확인한 다음 클라이언트에 연결하세요.
V2Fly 코어가 필요하고 설정이 해당 코어와 호환되는 경우에 적합합니다. 선택하기 전에 프로토콜, 전송 방식, 매개변수를 확인하세요. UI가 비슷하다는 이유만으로 지원 범위를 판단하지 마세요.
v2flyNG와 v2rayNG는 서로 다른 코어를 사용하므로 지원하는 프로토콜과 최신 매개변수가 다를 수 있습니다. 구독 항목을 가져오지 못하면 먼저 설정에 필요한 기능을 확인한 다음 클라이언트를 선택하세요. 같은 설정을 반복해서 가져와도 코어에서 지원하지 않는 기능을 사용할 수 있게 되지는 않습니다. 호환성 문제를 해결하려고 설정을 무작정 바꾸지도 마세요.
이전하기 전에 기존 클라이언트의 구독 주소, 수동 설정, 앱별 목록을 보관하세요. 새 클라이언트에는 사용 가능 여부를 알고 있는 설정 몇 개만 먼저 가져와 연결과 DNS 동작을 확인한 뒤 나머지를 옮기세요. 두 클라이언트의 설정은 각각 보관할 수 있지만, 동시에 필요한 연결만 켜야 트래픽을 처리하는 규칙을 파악하기 쉽습니다.
| 확인 항목 | 선택 및 조치 |
|---|---|
| 시스템 및 아키텍처 | '설정 → 휴대전화 정보'에서 Android 버전을 확인하고, 기기가 지원하는 앱 아키텍처에 맞는 파일을 선택하세요. 범용 버전도 오래된 모든 시스템과 호환되는 것은 아닙니다. |
| 설치 조건 | 다운로드와 설치에 필요한 공간을 확보하고, 필요한 경우 현재 설치 출처에서 앱을 설치하도록 허용하세요. 서명 충돌 메시지가 표시되면 먼저 백업하고, 사용할 수 있는 유일한 설정을 바로 삭제하지 마세요. |
| 연결 권한 | 처음 연결할 때 시스템 VPN 권한을 허용해야 합니다. 백그라운드에서 장시간 사용한다면 배터리 최적화 설정을 확인하세요. 연결과 관계없는 권한까지 허용할 필요는 없습니다. |
'앱이 설치되지 않았습니다'라는 메시지가 표시되면 남은 공간, Android 버전, 아키텍처, 기존 앱과의 서명 호환성을 차례로 확인하세요. 기존 앱을 덮어쓰는 중 문제가 발생했다면 먼저 설정을 보존하세요. 설치는 되었지만 백그라운드에서 연결이 끊긴다면 시스템 절전 정책을 확인하세요. 이는 설치 파일 아키텍처와는 별개의 문제입니다.
먼저 배포판에 맞춰 deb 또는 rpm을 선택한 다음 CPU에 따라 x64 또는 arm64를 선택하세요. 이 페이지에서는 그래픽 데스크톱 클라이언트를 제공하며 서버 배포 도구를 대체하지 않습니다.
Ubuntu, Debian 등의 배포판에서는 deb를 선택하고, Fedora 등 RPM 계열 배포판에서는 rpm을 선택하세요. 패키지 종속성이 현재 배포판에 적합한지도 확인해야 합니다.
시스템 소프트웨어 설치 도구로 패키지 파일을 여세요. 설치 도구에서 패키지 아키텍처와 종속성을 확인할 수 있습니다. deb 또는 rpm 확장자가 같다고 해서 다른 배포판에서도 호환되는 것은 아닙니다. 특히 시스템 라이브러리 버전과 패키지 빌드 대상에 유의하세요. 종속성을 충족할 수 없다면 배포판 환경을 먼저 확인하고, 종속성을 무시한 채 강제로 설치하지 마세요.
설치가 끝나면 데스크톱 앱 메뉴에서 실행하고 기본 화면과 로그가 정상적으로 열리는지 확인하세요. 일부 데스크톱 환경에서는 트레이 지원을 추가로 켜야 합니다. 기본 창을 닫은 뒤 트레이 아이콘을 찾을 수 없다면 데스크톱 확장 기능과 클라이언트의 백그라운드 설정을 확인하세요. 자동 시작은 사용자 로그인 후 실행되는 데스크톱 시작 항목으로 설정하고, 그래픽 클라이언트를 관리자 권한 프로세스로 계속 실행하지 마세요.
| 확인 항목 | 선택 및 조치 |
|---|---|
| 배포판 패키지 형식 | Debian 계열은 deb, RPM 계열은 rpm을 주로 사용합니다. 설치 전에 소프트웨어 설치 도구에 표시되는 종속성과 배포판 호환 요구 사항을 확인하세요. |
| CPU 아키텍처 | x86_64와 amd64는 이 페이지의 x64에 해당하고, aarch64는 arm64에 해당합니다. 배포판의 비트 수와 패키지 형식을 혼동하지 마세요. |
| 데스크톱 및 권한 | 사용 가능한 그래픽 데스크톱 환경이 필요합니다. 패키지 설치와 TUN 설정에는 권한이 필요할 수 있지만, 일반적인 UI 사용에 관리자 세션이 필요한 것은 아닙니다. |
데스크톱 앱은 실행되지만 브라우저에서 프록시가 사용되지 않는다면 데스크톱 환경의 프록시 설정과 앱 자체의 프록시 정책을 먼저 확인한 뒤 TUN이 필요한지 판단하세요. 설치부터 자동 시작, 트레이 사용까지의 안내는 Linux deb/rpm 설치 및 로그인 시 자동 시작 안내를 참고하세요.
설치와 연결 확인은 따로 진행하세요. 각 단계를 마친 뒤 다음으로 넘어가면 오류 원인을 더 쉽게 찾을 수 있습니다.
다운로드한 파일이 현재 시스템과 CPU에 맞는지 확인한 다음 패키지 형식에 따라 설치하세요. 처음 실행할 때는 화면, 로그, 필수 권한만 확인하고 DNS, 라우팅, TUN 설정을 한꺼번에 바꾸지 마세요. 앱 자체가 실행되지 않는다면 시스템 종속성과 폴더 권한부터 해결하세요. 구독을 바꿔도 시작 단계의 문제는 해결되지 않습니다.
구독 그룹에 사용 권한이 있는 구독 주소를 추가하고 업데이트한 뒤 가져오기 결과를 확인하세요. 수동 설정은 주소, 포트, 프로토콜, 전송 매개변수를 하나씩 확인해야 합니다. 구독 링크에는 개인 액세스 식별 정보가 포함될 수 있으므로 일반 URL처럼 공개하지 마세요. 가져온 뒤 사용할 서버를 명확히 선택하세요.
데스크톱에서는 먼저 시스템 프록시를 켜고, Android에서는 VPN 권한을 허용하세요. 시스템 프록시는 시스템 설정을 따르는 앱에서만 사용되므로 모든 프로그램에 적용되는 것은 아닙니다. 앱의 접속 결과와 클라이언트 로그를 함께 확인하고, 스위치 색상만으로 연결 성공을 판단하지 마세요. 가상 네트워크 어댑터가 필요하다면 TUN과 관련 라우팅을 별도로 설정하세요.
클라이언트 프로그램, 코어 기능, 구독 내용은 서로 다른 요소입니다. 업데이트로 설정 메뉴나 구성 방식이 바뀔 수 있지만 서버 측 매개변수 오류가 자동으로 해결되지는 않습니다. 업데이트 전 현재 클라이언트, 프록시 포트, 라우팅 모드, 주요 DNS 설정을 기록한 뒤 프로그램을 종료하세요. 설정 파일을 쓰는 중에 덮어쓰지 않도록 주의해야 합니다.
최소한 수동 서버, 구독 그룹, 직접 작성한 라우팅 규칙을 백업하세요. 백업에는 액세스 정보가 포함될 수 있으므로 열람 권한을 제한하고 공개 공유 폴더에는 보관하지 마세요. UI나 클라이언트 간에 이전할 때는 가져오기·내보내기 기능을 우선 사용하고, 새 환경에서 항목이 빠짐없이 옮겨졌는지 확인하세요. 폴더 이름이 같다고 그대로 교체할 수 있다고 가정하지 마세요.
카드의 버전 표시는 앱 수준 정보에서 가져오고, 다운로드 링크는 플랫폼별 설치 파일에 따라 업데이트됩니다. 각 정보의 반영 시점이 달라 파일명과 카드 문구가 다를 수 있습니다. 실제 패키지 버전을 확인할 때는 다운로드한 파일 정보와 설치 후 표시되는 버전을 함께 확인하세요. 한 곳의 문구만 보고 모든 플랫폼의 업데이트가 완료됐다고 판단하지 마세요.
업데이트 후에는 기존의 간단한 설정으로 연결을 먼저 확인한 다음 사용자 지정 규칙을 복원하세요. 문제가 생기면 오류 유형, 시스템 버전, 선택한 패키지 형식을 기록하고 종속성과 권한 변경 사항부터 점검하세요. 세 클라이언트의 코어 구성과 설정 차이를 비교하려면 클라이언트 선택 가이드를, 프로토콜과 네트워크 모드의 의미는 용어집을 확인하세요.
문제가 다운로드, 설치, 실행, 연결 중 어느 단계에서 발생했는지 먼저 확인한 뒤 알맞은 방법으로 해결하세요.
처음 설치한다면 차세대 크로스 플랫폼 UI를 사용하는 Desktop을 권장합니다. 기존 Windows 인터페이스에 익숙하다면 클래식 안정판인 WPF를 선택할 수 있습니다. 두 설치 파일 모두 x64이므로 UI 이름으로 CPU 호환성을 판단하지 마세요. 전환하기 전에 구독, 서버, 사용자 지정 규칙을 내보내고, 사용 중인 설정 폴더를 그대로 공유하지 마세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택할 수 있지만, 기기 시스템이 64비트 앱을 지원하는지 확인해야 합니다. 아키텍처를 모르거나 arm64 설치 파일이 호환되지 않는다고 표시되면 범용 버전을 시도할 수 있습니다. 범용 버전도 클라이언트의 최소 시스템 요구 사항을 충족해야 합니다. 설치 전에 시스템 버전, 저장 공간, 설치 출처 권한을 확인하세요.
클라이언트는 설정 관리와 트래픽 전달 기능을 제공하며, 설치 파일에는 사용할 수 있는 구독이나 서버가 포함되어 있지 않습니다. 사용 권한이 있는 구독 또는 연결 정보를 준비해 가져온 다음 서버를 선택하고, 시스템 프록시를 켜거나 VPN 연결을 허용해야 합니다. 연결에 실패하면 설치 파일을 계속 바꾸기보다 먼저 로그를 확인하세요.
구독 그룹, 직접 추가한 서버, 사용자 지정 라우팅과 DNS 설정을 저장한 다음 클라이언트를 종료하세요. 백업 파일에는 구독 주소와 액세스 정보가 포함될 수 있으므로 안전하게 관리되는 위치에 보관해야 합니다. 업데이트 후 프록시 포트, 라우팅 모드, TUN 설정을 확인하세요. 모든 UI 버전이 같은 설정 폴더를 그대로 사용할 수 있다고 가정하지 마세요.
카드에 표시되는 버전은 앱 수준 버전 정보이며, 실제 패키지 주소는 플랫폼별 설치 파일 정보에서 가져옵니다. 두 정보가 아직 동기화되지 않았을 수 있습니다. 설치 파일의 버전을 확인하려면 실제 다운로드한 파일명과 설치 후 클라이언트에 표시되는 버전을 함께 확인하세요. 카드 문구만으로 모든 플랫폼의 업데이트가 완료됐다고 판단하지 마세요.
먼저 설치 파일 출처와 칩 아키텍처를 확인하세요. 처음 실행을 시도한 뒤 시스템 설정의 개인정보 보호 및 보안에서 시스템이 제공하는 허용 절차를 확인할 수 있습니다. 관리 대상 기기에서는 관리자 승인이 필요할 수 있습니다. 클라이언트를 실행하기 위해 시스템 보호 기능 전체를 끄지 마세요. 이후 네트워크 권한과 시스템 프록시 허용은 각각 확인해야 합니다.