v2rayN
데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용하며, 클래식 WPF 버전은 익숙한 Windows 레이아웃을 유지하는 안정적인 선택지입니다. 처음 설치할 때는 둘 중 하나만 선택하면 됩니다.
데스크톱에서는 v2rayN을, Android에서는 v2rayNG 또는 v2flyNG를 선택할 수 있습니다. 먼저 운영체제를 확인한 뒤 기기 아키텍처와 패키지 형식에 맞는 설치 파일을 선택하세요.
데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용하며, 클래식 WPF 버전은 익숙한 Windows 레이아웃을 유지하는 안정적인 선택지입니다. 처음 설치할 때는 둘 중 하나만 선택하면 됩니다.
| 확인 항목 | 요구 사항 |
|---|---|
| 시스템 | 지원이 계속 제공되는 64비트 Windows 사용을 권장합니다. |
| 아키텍처 | 두 패키지 모두 x64입니다. ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하세요. |
| 파일 | ZIP 파일을 먼저 완전히 압축 해제한 다음, 압축 해제한 폴더에서 설치 프로그램을 실행하세요. |
압축 파일 미리보기에서 프로그램 하나만 꺼내 실행하지 마세요. 주변 파일도 설치에 필요할 수 있습니다. 실행 시 런타임 구성 요소가 없다는 안내가 표시되면 필요한 구성 요소의 이름과 버전을 기록한 뒤 시스템 안내에 따라 처리하세요.
WPF 버전에서 데스크톱 버전으로 바꾸려면 구독 그룹, 라우팅 옵션, 로컬 포트를 먼저 기록해 두세요. 설치 후 클라이언트를 열어 설정을 확인한 다음 기존 버전을 제거할지 결정하세요. 두 버전이 같은 로컬 포트를 사용하면 나중에 실행한 쪽에서 수신 대기를 시작하지 못할 수 있습니다.
‘이 Mac에 관하여’에서 칩 또는 프로세서를 확인하세요. Apple M 시리즈는 arm64, Intel 프로세서는 x64를 선택하면 됩니다. 두 파일 모두 DMG 형식입니다.
| 확인 항목 | 요구 사항 |
|---|---|
| 시스템 | 지원이 계속 제공되는 macOS 사용을 권장합니다. 구버전과의 호환 여부는 현재 릴리스 패키지의 안내를 확인하세요. |
| 아키텍처 | Apple Silicon은 arm64, Intel은 x64를 선택하세요. |
| 파일 | DMG 파일을 열고 디스크 이미지의 안내에 따라 앱을 배치하세요. |
복사가 끝나면 대상 위치에서 앱을 실행한 다음 디스크 이미지를 꺼내세요. 앱 아이콘을 마운트된 창에 둔 채 실행하면 이후 실행이나 업데이트에 같은 디스크 이미지가 필요할 수 있습니다.
다른 Mac으로 옮길 때는 이전 컴퓨터에서 받은 패키지가 새 컴퓨터와 호환되지 않을 수 있습니다. 새 기기의 칩을 다시 확인한 뒤 설정을 옮기세요. 앱을 열 수 없다는 안내가 표시되면 macOS 버전 불일치, 아키텍처 선택 오류, 기기 관리 정책 제한 중 무엇이 원인인지 확인하세요. 설치를 위해 시스템 보호 기능을 전체적으로 끄지 마세요.
Xray 코어를 사용합니다. 2015년 이후 출시된 일반적인 스마트폰은 arm64를 먼저 선택해도 됩니다. 기기 정보에서 32비트 앱만 지원한다고 나오거나 아키텍처를 확인하기 어렵다면 범용 버전을 선택하세요.
V2Fly 코어를 사용하며, 기존 설정이 V2Fly 기능과 호환되는지 확인해야 하는 사용자에게 적합합니다. 두 패키지의 클라이언트 기능은 같으므로 기기 아키텍처에 맞춰 선택하세요.
| 확인 항목 | 요구 사항 |
|---|---|
| 시스템 | 기기가 현재 APK에 명시된 최소 Android 버전을 충족해야 합니다. |
| 아키텍처 | 시스템에서 arm64-v8a를 지원하면 arm64를 선택하세요. 확실하지 않다면 범용 버전을 먼저 고려하세요. |
| 설치 방법 | 시스템 설치 프로그램으로 APK를 여세요. 기기 관리 정책으로 설치가 제한되면 관리자에게 문의하세요. |
스마트폰에 64비트 칩이 탑재되어 있어도 시스템이 64비트 앱을 지원하는 것은 아닙니다. 구형 기기에서는 칩 모델보다 시스템에서 사용할 수 있는 앱 아키텍처를 확인하는 편이 패키지 선택에 더 정확합니다. 범용 패키지는 대체로 용량이 더 크며, 클라이언트의 Android 버전 요구 사항을 낮춰 주지는 않습니다.
카드에 표시된 목록 버전과 다운로드 파일명에 표시된 버전이 다르면 시스템 설치 프로그램과 설치 후 앱 정보에서 실제 버전을 확인하세요. 업그레이드가 아니라 다운그레이드로 인식되면 설치를 취소하고 현재 설치된 버전과 선택한 파일을 확인하세요.
다른 클라이언트로 바꾸려면 구독 형식과 프로토콜 지원 여부를 다시 확인해야 합니다. 정보를 가져오는 데 성공했더라도 항목이 인식되었다는 뜻일 뿐, 해당 항목의 모든 전송 옵션을 지원한다는 의미는 아닙니다.
먼저 배포판에 맞는 패키지 형식을 고른 다음 아키텍처에 맞춰 파일을 선택하세요. 파일명의 amd64와 x86_64는 모두 x64를, aarch64는 arm64를 의미합니다.
| 확인 항목 | 요구 사항 |
|---|---|
| 배포판 | Debian·Ubuntu 계열은 보통 deb를, Fedora 및 RHEL 계열은 보통 rpm을 선택합니다. |
| 환경 | 그래픽 데스크톱 세션이 필요하며, 현재 패키지에 명시된 시스템 라이브러리 의존성을 충족해야 합니다. |
| 아키텍처 | 시스템 정보에서 사용 중인 시스템이 x64 또는 arm64인지 확인하세요. |
배포판에서 제공하는 소프트웨어 설치 프로그램으로 로컬 패키지를 여는 것을 권장합니다. 설치 프로그램에서 의존성을 찾을 수 없다고 하면 배포판 버전과 패키지의 빌드 대상을 먼저 확인하세요. 확장자가 같더라도 배포판마다 의존성 이름이나 버전이 다를 수 있습니다.
일부 데스크톱 환경에서는 시스템 프록시를 한곳에서 관리할 수 있지만, 앱마다 별도의 네트워크 설정을 사용하는 경우도 있습니다. 처음 실행한 뒤 클라이언트와 대상 앱이 각각 정상적으로 열리는지 확인하고 프록시 설정이 적용되는지 테스트하세요. 데스크톱 프록시가 특정 앱을 제어하지 않는다고 해서 설치 파일에 문제가 있다고 판단하지 마세요.
먼저 클라이언트가 정상적으로 실행되는지 확인한 뒤 설정을 가져오세요. 이 순서로 점검하면 설치 문제와 연결 문제를 구분하기 쉽습니다.
다른 기기에서 사용할 파일을 다운로드할 때는 현재 브라우저가 실행 중인 기기가 아니라 클라이언트를 실제로 사용할 기기를 기준으로 선택하세요. 다음 세 가지를 확인해야 합니다. 대상 운영체제에서 해당 클라이언트를 실행할 수 있는지, 패키지에 포함된 프로그램의 아키텍처가 대상 시스템과 맞는지, 대상 기기의 설치 프로그램에서 패키지를 열 수 있는지 확인하세요. 하나라도 맞지 않으면 같은 파일을 다시 다운로드해도 문제가 해결되지 않습니다.
파일 확장자는 파일을 여는 방법을 나타냅니다. ZIP은 압축 파일이므로 먼저 압축을 풀어야 하고, DMG는 디스크 이미지입니다. APK는 Android 시스템 설치 프로그램으로 처리하며, deb와 rpm은 서로 다른 패키지 형식입니다. 확장자를 바꿔 형식을 변환하려고 하지 마세요. 브라우저 다운로드가 중단되었다면 먼저 다운로드가 완료됐는지 확인한 뒤 설치 오류가 시스템이나 프로세서 문제인지 판단하세요.
아키텍처 이름은 플랫폼과 함께 살펴봐야 합니다. Windows용 x64 패키지와 Linux용 x64 패키지는 서로 다른 운영체제용입니다. 두 기기 모두 ARM 아키텍처를 사용하더라도 Android용 arm64 APK를 macOS에서 사용할 수는 없습니다. 플랫폼은 기기에서 실행되는 운영체제로 결정하고, 같은 플랫폼 안에서 어떤 패키지를 쓸지는 아키텍처와 형식에 따라 선택하세요.
업데이트 전에 보존할 항목을 확인하세요. 구독 그룹, 직접 추가한 항목, 라우팅 규칙, 로컬 수신 포트, 시스템 프록시 및 시작 시 실행 설정 등이 있습니다. 클라이언트에 내보내기 기능이 있으면 먼저 내보내고, 내보내기에 포함되지 않는 설정은 별도로 기록해 두세요. 구독 주소와 공유 링크에는 접속 정보가 포함될 수 있으므로 공개 스크린샷이나 공유 문서에 올리지 않는 것이 좋습니다.
데스크톱 클라이언트를 교체하기 전에 시스템 트레이나 메뉴 막대에 남아 있는 인스턴스까지 모두 종료하세요. 파일 점유를 줄이고 설치 후 어느 버전이 실행되는지 확인하기 쉬워집니다. 인터페이스나 패키지 형식이 다른 버전으로 바꿀 때는 기존 설정을 보관하고, 새 프로그램에서 필요한 정보를 읽거나 가져올 수 있는지 확인한 후 이전 파일을 정리하세요.
모바일 앱을 업데이트할 때 설치 프로그램에서 서명 충돌을 명확히 안내하면 설치를 반복하지 마세요. 기존 앱을 어디서 설치했는지 확인하고 같은 배포 경로에서 업데이트하는 것을 우선으로 하세요. 설치 경로를 바꿔야 한다면 내보낼 수 있는 로컬 데이터를 먼저 백업하세요. 앱을 삭제하면 앱 전용 저장 공간의 데이터도 함께 지워질 수 있으며, 구독을 다시 가져와도 직접 만든 그룹이나 개별 항목의 수정 내용까지 복구되지 않을 수 있습니다.
처음 실행할 때는 앱이 메인 화면을 표시하는지, 종료 후 다시 실행되는지, 설정을 바꾼 뒤 정상적으로 저장되는지 확인하세요. 창이 열리기 전에 오류가 발생하면 시스템 안내, 설치 파일 이름, 오류가 발생한 단계를 먼저 기록하세요. 클라이언트가 설정을 읽기도 전에 실행에 실패한 상황에서는 구독이나 서버를 바꿔도 대개 도움이 되지 않습니다.
메인 화면이 정상적으로 열리면 빠른 시작 안내에 따라 구독이나 개별 공유 링크를 가져오세요. 가져온 뒤 예상한 그룹과 항목이 표시되는지 확인하고, 한 번에 한 가지씩만 바꿔 테스트하세요. 예를 들어 먼저 항목 하나를 선택한 다음 대상 앱이 시스템 프록시를 사용하는지 확인할 수 있습니다. 클라이언트, 구독, 네트워크 모드를 동시에 바꾸면 어떤 변경이 영향을 줬는지 파악하기 어렵습니다.
항목은 표시되지만 특정 프로토콜이나 전송 설정을 사용할 수 없다면 프로토콜 안내서에서 클라이언트 코어와 설정의 호환성을 확인하세요. 문제를 다른 사람에게 설명할 때는 운영체제 버전, 앱 버전, 패키지 형식, 구체적인 오류 메시지를 남기고 구독 주소, 개인 서버 정보, 로컬 계정 정보는 가리세요. 정확한 오류 메시지가 단순히 ‘연결되지 않음’이라고 하는 것보다 문제를 파악하는 데 도움이 됩니다.
둘 중 하나만 설치하면 됩니다. 데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용하고, 클래식 WPF 버전은 익숙한 Windows 레이아웃을 유지해 기존 사용 방식에 적합합니다. 전환 전 설정을 백업하고 실행 중인 클라이언트를 종료하세요. 두 버전에서 시스템 프록시를 동시에 켜지 마세요.
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. Apple M 시리즈 칩이 표시되면 Apple Silicon 패키지를, Intel 프로세서가 표시되면 Intel 패키지를 선택하세요. macOS 버전명이 아니라 현재 기기의 칩을 기준으로 선택해야 합니다.
범용 패키지는 지원하는 CPU 아키텍처의 범위를 넓혀 줍니다. Android 버전이 낮거나 기기 관리 정책에서 설치를 제한하는 경우, 또는 이전 설치 파일과 서명이 다른 경우에는 설치에 실패할 수 있습니다. 먼저 시스템 안내를 확인하세요. 패키지를 바꾸려면 기존 버전을 삭제해야 하는 경우, 로컬 설정을 먼저 저장하세요.
Debian·Ubuntu 계열은 보통 deb를, Fedora 및 RHEL 계열은 보통 rpm을 선택합니다. 패키지 형식뿐 아니라 아키텍처, 배포판, 의존성 버전도 확인하세요. rpm 파일명의 el10은 빌드 대상에 관한 단서이며, rpm을 사용하는 모든 시스템에 바로 설치할 수 있다는 뜻은 아닙니다.
설치 파일에는 클라이언트 프로그램만 포함되어 있습니다. 서버 정보는 기존 구독이나 개별 공유 링크에서 가져와 설치 후 따로 가져와야 합니다. 먼저 클라이언트가 정상적으로 열리는지 확인한 다음 빠른 시작 안내에 따라 가져오세요. 목록이 비어 있다면 구독을 업데이트했는지, 응답 형식을 클라이언트가 지원하는지 확인하세요.