v2rayN
Desktop은 최신 크로스 플랫폼 UI를 사용하는 데스크톱 버전이고, WPF는 기존 Windows 인터페이스를 이어가는 안정화 버전입니다. 둘 다 구독을 가져올 수 있으니 익숙한 인터페이스를 선택하면 됩니다.
데스크톱에서는 v2rayN, Android에서는 먼저 v2rayNG를 확인하세요. 설정에 따라 v2flyNG를 선택할 수도 있습니다. 아래에서 운영체제를 고른 뒤 CPU 아키텍처와 설치 파일 형식을 확인하세요.
각 옵션 아래에서 해당 시스템 요구사항과 설치 방법을 확인할 수 있습니다.
Desktop은 최신 크로스 플랫폼 UI를 사용하는 데스크톱 버전이고, WPF는 기존 Windows 인터페이스를 이어가는 안정화 버전입니다. 둘 다 구독을 가져올 수 있으니 익숙한 인터페이스를 선택하면 됩니다.
| 확인 항목 | 요구사항 및 확인 위치 |
|---|---|
| 시스템 유형 | ‘설정 → 시스템 → 정보’에서 64비트 시스템과 x64 프로세서인지 확인하세요. |
| 설치 폴더 | ZIP 파일을 완전히 압축 해제하고 설치 프로그램과 함께 제공된 파일의 폴더 구조를 유지하세요. |
| 실행 환경 | 실행에 필요한 구성 요소가 없다는 안내가 표시되면 구성 요소 이름, 버전, 아키텍처를 확인하세요. |
파일 탐색기에서 ‘모두 압축 풀기’를 선택한 다음, 압축을 푼 폴더에서 설치 프로그램을 실행하세요. 압축 파일 미리 보기에서 바로 실행하지 마세요. 압축 해제 폴더는 찾기 쉬운 위치에 두고 임시 폴더나 동기화 드라이브에서 반복 실행하지 않는 것이 좋습니다. 설치가 끝나면 새로 만든 바로 가기로 실행하고, 기본 창과 알림 영역 아이콘이 정상적으로 열리는지 확인하세요.
WPF에서 Desktop으로 바꿀 때 기존 설치 폴더를 새 폴더에 그대로 덮어쓰지 마세요. 이전 버전에서 구독, 사용자 지정 라우팅, 로컬 포트 설정을 백업한 다음 알림 영역의 기존 인스턴스를 완전히 종료하세요. 버전을 바꾼 뒤 목록이나 규칙이 옮겨지지 않았다면 새 버전의 설정 위치를 확인하고 필요한 항목을 가져오세요. 브라우저가 계속 이전 프록시 포트를 사용한다면 구독을 반복해서 업데이트하기보다 실제 수신 대기 포트를 확인하세요.
‘이 Mac에 관하여’에 Apple M 시리즈 칩이 표시되면 arm64를, Intel 프로세서가 표시되면 x64를 선택하세요. 두 설치 파일 모두 DMG 형식입니다. 모델 출시 연도가 아니라 칩에 맞춰 선택하세요.
| 확인 항목 | 요구사항 및 확인 위치 |
|---|---|
| 칩 | Apple 메뉴의 ‘이 Mac에 관하여’에서 칩 또는 프로세서를 확인하세요. |
| 운영체제 버전 | 같은 화면에서 운영체제 버전을 확인할 수 있습니다. 시스템에서 버전이 너무 오래되었다고 안내하면 다른 아키텍처 패키지를 설치해도 해결되지 않습니다. |
| 설치 권한 | 현재 계정으로 앱을 대상 ‘응용 프로그램’ 폴더에 복사할 수 있는지 확인하세요. |
DMG를 열고 앱을 ‘응용 프로그램’ 폴더로 드래그한 다음 대상 폴더에서 실행하세요. 앱이 제대로 복사된 것을 확인한 뒤 디스크 이미지를 추출하면 됩니다. 디스크 이미지에서 바로 실행하는 것과 ‘응용 프로그램’ 폴더에서 실행하는 것은 다릅니다. 업데이트할 때도 자주 사용하는 폴더의 앱을 교체했는지 확인해 오래된 바로 가기를 실행하지 않도록 하세요.
처음 실행할 때 시스템에서 차단하면 안내 내용을 먼저 확인하세요. 운영체제 버전이 호환되지 않으면 실행 요구사항을 확인하고, 아키텍처가 맞지 않으면 알맞은 패키지를 다시 선택하세요. 조직에서 관리하는 기기라면 해당 기기의 설치 정책을 따라야 합니다. 클라이언트 설치를 위해 시스템 보안 설정을 전반적으로 낮추지 마세요. 앱은 열리지만 트래픽이 프록시를 거치지 않는다면 다음 단계는 설정 확인입니다. DMG를 바꾸기보다 현재 네트워크 서비스의 프록시 설정을 확인하세요.
2015년 이후 출시된 일반적인 스마트폰은 arm64를 먼저 선택할 수 있지만, 기기의 Android 시스템이 arm64-v8a를 지원하는지 확인하세요. 확실하지 않다면 범용 버전을 선택하세요.
기존 설정이 V2Fly에 맞춰져 있는 경우 선택하세요. 클라이언트를 바꾸기 전에 노드의 프로토콜과 전송 매개변수를 새 클라이언트에서 사용할 수 있는지 확인하세요.
| 확인 항목 | 요구사항 및 확인 위치 |
|---|---|
| 앱 아키텍처 | arm64 패키지를 선택하기 전에 Android 시스템이 arm64-v8a를 지원하는지 확인하세요. 프로세서가 64비트인지 여부만으로 판단하면 안 됩니다. |
| 설치 조건 | 운영체제 버전과 기기 관리 정책이 설치를 허용해야 합니다. 권한이 필요한 경우 시스템에서 지정한 설치 출처를 확인하세요. |
| 연결 조건 | 처음 연결할 때 시스템 VPN 권한 요청에 동의해야 합니다. 테스트 중에는 다른 VPN 앱을 일시 중지하세요. |
시스템에 ‘앱이 설치되지 않았습니다’라고 표시되면 같은 이름의 앱이 이미 설치되어 있는지 확인하세요. 기존 앱을 덮어 업데이트하려면 앱 식별자와 서명이 호환되어야 합니다. 범용 패키지로 바꿔도 서명 조건은 달라지지 않습니다. 삭제하기 전에 구독 주소를 다시 가져올 수 있는지 확인하고, 직접 입력한 노드와 앱별 설정을 기록해 두세요. 카드의 배지는 클라이언트 목록에 표시된 정보입니다. APK의 정확한 버전은 다운로드한 파일 이름과 앱 버전 정보에서 확인하세요.
앱은 열리지만 연결을 누르자마자 종료된다면 시스템에 VPN 권한 요청이 표시됐는지 확인하세요. 다른 VPN 앱이 실행 중이면 기존 연결을 정상적으로 끊은 다음 새 클라이언트를 테스트하세요. 연결은 시작됐는데 특정 앱에서 프록시를 사용하지 않는다면 앱별 설정에서 해당 앱이 제외되어 있는지 확인하세요. 설치, 권한 승인, 트래픽 분기는 서로 다른 단계입니다. 문제가 발생한 단계부터 확인하세요.
Debian 및 Ubuntu 계열은 deb를, RPM을 사용하는 배포판은 rpm을 먼저 확인하고 배포판 버전과 종속성도 확인하세요.
| 확인 항목 | 요구사항 및 확인 위치 |
|---|---|
| CPU 아키텍처 | 시스템 정보에서 x86_64는 x64에, aarch64는 arm64에 해당합니다. |
| 배포판 | 패키지 형식을 지원하는 설치 도구가 필요합니다. RPM 파일 이름의 el10은 빌드 대상 정보를 나타내며, 모든 RPM 기반 시스템과 호환된다는 뜻은 아닙니다. |
| 그래픽 환경 | 사용 가능한 데스크톱 세션이 필요하며, 소프트웨어 설치 도구로 시스템 라이브러리 종속성을 확인해야 합니다. |
시스템 소프트웨어 설치 도구에서 해당 deb 또는 rpm 파일을 여세요. 아키텍처가 맞지 않는다는 안내가 표시되면 위에서 다른 아키텍처를 선택하세요. 종속성이 없다는 안내가 표시되면 필요한 종속성 이름과 버전을 기록한 뒤 현재 배포판의 저장소에서 확인하세요. 파일 확장자만 바꿔 형식을 변환하거나 종속성을 무시하고 설치하지 마세요. 설치가 끝나면 평소 사용하는 데스크톱 계정으로 클라이언트를 실행해야 이후에도 같은 사용자 설정을 찾기 쉽습니다.
데스크톱 세션과 터미널 프로세스의 프록시 설정은 서로 공유되지 않을 수 있습니다. 브라우저는 접속되지만 터미널은 직접 연결된다면 터미널 도구가 프록시 설정을 읽는지, 어느 로컬 포트를 사용하는지 먼저 확인하세요. 클라이언트를 종료한 뒤 브라우저에서 연결 오류가 발생한다면 데스크톱 프록시가 더 이상 수신하지 않는 로컬 포트를 계속 가리키는지 확인하세요.
클라이언트가 실행되는지 먼저 확인한 다음 설정과 트래픽을 점검하세요. 서로 다른 문제를 한꺼번에 확인하지 마세요.
하나만 설치하면 됩니다. 처음 사용하는 경우 Desktop으로 시작해 보세요. 기존 Windows 인터페이스에 익숙하거나 WPF용 튜토리얼을 따라야 한다면 WPF를 선택하세요. 버전을 바꾸기 전에 설정을 백업하고, 처음 테스트할 때는 로컬 포트를 서로 차지하지 않도록 하나의 인스턴스만 실행하세요.
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. Apple M 시리즈 칩이 표시되면 Apple Silicon(arm64)을, Intel 프로세서가 표시되면 Intel(x64)을 선택하세요. 기기 이름이나 화면 크기로 아키텍처를 판단할 수는 없습니다. 같은 제품군에도 서로 다른 칩이 탑재될 수 있습니다.
arm64 패키지는 arm64-v8a를 지원하는 기기에 맞춰져 있으며 일반적으로 크기가 더 작습니다. 범용 패키지는 해당 배포본이 지원하는 여러 아키텍처를 포함합니다. 아키텍처를 모르겠다면 범용 버전을 선택해도 되지만, Android 버전 요구사항이 낮아지는 것은 아니며 앱 서명 충돌도 해결되지 않습니다.
먼저 설정을 백업하고 앱, 설치 경로, 패키지 형식이 서로 맞는지 확인하세요. 데스크톱에서는 기존 프로세스를 종료한 뒤 설치 파일 안내에 따라 업그레이드하세요. Android에서 덮어 업데이트하려면 앱 식별자와 서명이 호환되어야 합니다. 서명 충돌이 표시되면 기존 버전을 유지하고 설정을 내보낸 뒤, 바로 삭제하지 마세요.
클라이언트 설치 파일과 구독은 별개입니다. GUI 클라이언트를 실행한 다음 구독 주소나 개별 공유 링크를 가져오세요. 실행 구성 요소는 클라이언트 안내에 따라 확인하면 됩니다. 클라이언트는 열리지만 목록이 비어 있다면 가져오기 메뉴와 구독 업데이트 결과를 확인하세요. 설치 파일을 다시 다운로드할 필요는 없습니다.