먼저 운영체제를 선택한 다음 CPU 아키텍처를 확인하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 추천합니다. 기존 V2Fly 설정을 사용한다면 v2flyNG를 선택할 수 있습니다.
설치 및 구독 가져오기 가이드두 링크 모두 x64 설치 파일입니다. 처음 설치한다면 Desktop 버전을 우선 선택하세요.
Desktop 버전은 차세대 크로스 플랫폼 UI를 사용합니다. 클래식 WPF 버전은 익숙한 Windows 인터페이스를 유지해 기존 사용 방식에 익숙한 사용자에게 적합합니다.
다운로드한 ZIP 파일을 별도 폴더에 완전히 압축 해제한 뒤, 폴더 안의 설치 프로그램을 실행하세요. 압축 파일 미리보기에서 바로 실행하면 설치 프로그램이 같은 폴더의 리소스를 찾지 못할 수 있습니다.
처음 사용할 때는 두 버전 중 하나만 선택하면 됩니다. 메뉴 배치와 설정 위치는 버전마다 다를 수 있습니다. 가이드에 나온 기능 이름을 기준으로 찾으면 되며, 메뉴 위치가 완전히 같을 필요는 없습니다.
기존 인터페이스에 익숙하다면 WPF 버전을 계속 사용해도 됩니다. 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하고 싶다면 Desktop을 선택하세요. 버전에 따라 인터페이스와 실행 환경은 달라지지만, 설치만으로 사용할 수 있는 서버가 제공되는 것은 아닙니다. 구독, 현재 서버, 라우팅 모드는 별도로 설정해야 합니다.
버전을 바꾸기 전에 기존 서버, 구독 그룹, 사용자 지정 라우팅을 내보내고 이전 프로그램을 종료한 뒤 새 버전을 실행하세요. 클라이언트 두 개를 동시에 실행하면 로컬 수신 포트가 충돌하거나 시스템 프록시 설정이 서로 덮어쓰일 수 있습니다. 포트 사용 중 오류가 발생하면 모든 포트를 바로 변경하기보다 기존 인스턴스가 알림 영역에서 실행 중인지 먼저 확인하세요.
‘이 Mac에 관하여’에서 칩 정보를 확인하고 해당 DMG 설치 파일을 선택하세요.
칩 정보에 Apple M 시리즈가 표시되면 Apple Silicon을, Intel 프로세서가 표시되면 Intel을 선택하세요. 두 링크는 서로 다른 아키텍처용이므로 하나만 설치하면 됩니다.
DMG를 연 뒤 앱을 ‘응용 프로그램’ 폴더로 복사하고 해당 폴더에서 실행하세요. 복사가 끝나면 디스크 이미지를 추출해 임시 마운트 위치에서 계속 실행되지 않도록 할 수 있습니다.
칩과 일치하는 네이티브 아키텍처 패키지를 우선 사용하세요. 호환성 변환을 기본 설치 방식으로 간주하지 마세요. 아키텍처 불일치 안내가 표시되면 칩 정보를 다시 확인하고 다른 링크를 선택하세요.
처음 실행한 뒤 구독을 가져오고 서버 목록에 항목이 표시되는지 확인하세요. 사용할 서버를 선택한 다음 시스템 프록시를 활성화하면 됩니다. 앱 창을 열었다고 프록시가 적용된 것은 아닙니다. 일부 앱은 시스템 프록시를 따르지 않으므로 앱 자체 설정에서 프록시를 지정하거나, 적용 범위를 이해한 뒤 TUN 모드를 고려하세요.
클라이언트를 종료하기 전에 시스템 프록시를 해제한 다음 프로그램을 종료하세요. 클라이언트가 이미 종료됐는데 브라우저가 로컬 프록시 포트에 계속 연결을 시도하면 일반 웹페이지에도 접속할 수 없게 됩니다. 이때는 서버가 작동하지 않는다고 단정하기보다 시스템 네트워크 설정의 프록시 항목을 확인하세요. 설정을 많이 바꿨다면 일반 시스템 프록시 모드로 되돌린 뒤 하나씩 점검하세요.
v2rayNG를 우선 선택하세요. V2Fly 코어가 필요할 때는 v2flyNG를 사용하세요.
Android에서 일상적으로 사용하기 적합하며 구독 관리와 규칙 기반 분기를 지원합니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하세요. 시스템 아키텍처를 모르면 범용 버전을 사용할 수 있습니다.
범용 버전에는 여러 CPU 아키텍처가 포함되어 있어 파일 크기가 더 큰 편입니다. 구형 기기나 특수한 시스템을 사용하는 스마트폰은 프로세서가 64비트를 지원해도 32비트 시스템을 실행할 수 있으므로 실제 시스템 호환성을 확인하세요.
기존 V2Fly 설정을 사용하거나 해당 코어 동작이 필요한 사용자에게 적합합니다. 설치 전에 서버 프로토콜과 전송 설정이 호환되는지 확인하세요. 클라이언트 이름만으로 지원 범위를 판단하지 마세요.
v2rayNG와 다른 코어를 사용하므로 설정 항목과 프로토콜 기능이 완전히 같지는 않습니다. 이전하기 전에 기존 구독과 사용자 지정 규칙을 저장하고, 가져온 후 서버 하나로 먼저 연결을 확인한 다음 복잡한 분기 설정을 복원하세요.
| 확인 항목 | 선택 및 설명 | 문제가 발생하면 |
|---|---|---|
| CPU 아키텍처 | 대부분의 최신 스마트폰은 arm64를 선택하세요. 잘 모르겠다면 범용 버전을 선택하면 됩니다. | 설치 시 호환되지 않는다는 안내가 나오면 먼저 시스템 아키텍처를 확인하세요. |
| 운영체제 버전 | 최소 지원 버전은 현재 APK에 따라 다릅니다. 시스템 설치 프로그램의 안내를 따르세요. | 구형 시스템은 업데이트가 필요할 수 있습니다. 범용 버전으로 낮은 시스템 버전 문제를 해결할 수는 없습니다. |
| 설치 권한 | APK를 실제로 여는 브라우저나 파일 관리자에 설치 권한을 부여하세요. | 설치가 끝나면 해당 출처의 앱 설치 권한을 해제할 수 있습니다. |
| 연결 권한 | 연결을 시작할 때 표시되는 시스템 VPN 권한 요청을 확인하세요. | 다른 VPN 앱이 같은 연결을 사용 중인지 확인하세요. |
다운로드가 끝나면 브라우저의 다운로드 기록이나 파일 관리자에서 APK를 여세요. Android의 앱 출처별 설치 권한은 앱마다 따로 관리됩니다. 브라우저에 권한을 줬더라도 파일 관리자에 자동으로 허용되는 것은 아닙니다. 설치 프로그램에서 서명 충돌을 알리면 기존 설정을 저장하고 설치된 앱의 출처를 확인하세요. 백업 없이 바로 삭제하지 마세요.
처음 연결할 때 시스템 VPN 권한 요청이 표시됩니다. 이는 Android에서 클라이언트가 트래픽을 처리하는 데 필요한 시스템 인터페이스이며, 가져온 서버를 사용할 수 있다는 뜻은 아닙니다. 연결된 뒤 실제 앱으로 작동을 확인하세요. 화면을 잠근 뒤 연결이 자주 끊기면 배터리 최적화, 백그라운드 실행, 절전 모드를 확인하세요. 한 번에 하나씩 설정을 바꿔 개선 여부를 살펴보고 구독, 라우팅, 백그라운드 정책을 동시에 변경하지 마세요.
배포판에 맞춰 deb 또는 rpm을 선택한 다음 CPU가 x64인지 arm64인지 확인하세요.
일반적인 Intel·AMD 데스크톱은 x64를 선택하세요. Debian·Ubuntu 계열은 보통 deb를, Fedora·RHEL 계열은 보통 rpm을 사용합니다. 필요한 의존성은 배포판 패키지 관리자로 확인하세요.
시스템 패키지 설치 프로그램으로 패키지를 열고 의존성과 설치 안내를 확인한 뒤 진행하세요. 패키지 형식이 맞아도 모든 배포판에서 의존성이 충족되는 것은 아닙니다. 설치 프로그램에서 구성 요소가 없다고 표시되면 현재 패키지와 배포판 버전이 호환되는지 먼저 확인하세요.
Linux 데스크톱 환경마다 시스템 프록시 구현 방식이 다릅니다. 클라이언트가 실행되어 로컬 포트를 열어도 일부 앱에서는 프록시 주소와 포트를 직접 입력해야 할 수 있습니다. 프록시 설정을 지원하는 앱 하나로 먼저 확인한 뒤 TUN이 필요한지 판단하세요. 데스크톱의 프록시 스위치만 보고 모든 프로그램이 연결됐다고 단정하지 마세요.
일반 GUI는 설정 폴더의 소유권 문제를 피할 수 있도록 일반 사용자 계정으로 실행하세요. TUN이 꼭 필요하다면 클라이언트 안내에 따라 필요한 권한을 부여하세요. 업데이트 전에 기존 인스턴스를 종료하고 패키지 아키텍처가 설치된 버전과 일치하는지 확인하세요. 설치 후 구독 그룹, 라우팅 규칙, 로컬 포트가 예상대로 유지됐는지 살펴보세요.
설치 파일은 클라이언트를 배포하는 데 필요합니다. 서버 설정, 프록시 모드, 네트워크 확인은 별도로 진행해야 합니다. 아래 순서대로 확인하면 문제가 설치 단계인지 연결 단계인지 구분하기 쉽습니다.
먼저 운영체제를 확인하고 아키텍처와 파일 형식을 살펴보세요. Windows는 ZIP 압축 해제가 필요하고, macOS는 DMG, Android는 APK, Linux는 배포판에 맞는 패키지를 사용합니다. 다른 시스템에서 쓰도록 확장자만 바꾸지 마세요. 브라우저에서 다운로드가 진행 중일 때는 임시 파일을 미리 열지 마세요.
클라이언트에는 사용할 수 있는 서버가 포함되어 있지 않습니다. 구독 주소를 구독 관리에 붙여 넣고 그룹을 저장한 뒤 업데이트하세요. 단일 서버 공유 링크를 사용하는 경우 클립보드에서 가져오면 됩니다. 목록에 항목이 나타나면 사용할 서버를 직접 선택하세요. 구독 업데이트 성공은 설정을 가져왔다는 뜻일 뿐, 모든 서버에 연결할 수 있다는 의미는 아닙니다.
데스크톱에서 처음 사용할 때는 시스템 프록시부터 시작하고, Android에서는 안내에 따라 VPN 연결을 시작하세요. 기본 규칙 분기를 유지한 상태로 실제 웹페이지나 앱에서 먼저 테스트한 다음 TUN, DNS, 사용자 지정 라우팅을 조정하세요. 테스트 중에는 로그도 확인하세요. 로컬 수신 실패와 원격 연결 시간 초과는 서로 다른 단계의 문제이므로 같은 설정을 반복해서 바꾸지 마세요.
연결이 확인되면 서버와 사용자 지정 설정을 내보내고 현재 프록시 방식과 로컬 포트를 기록하세요. 구독 주소, 공유 링크, 내보낸 파일에는 인증 정보가 포함될 수 있으므로 공개 스크린샷이나 대화 기록에 올리지 마세요. 도움을 요청할 때는 오류 메시지와 필요한 환경 정보만 남기고 서버 주소, 사용자 식별 정보, 구독 매개변수는 먼저 삭제하세요.
업데이트를 설치하기 전에 클라이언트의 내보내기 기능으로 설정을 저장하세요. 프로그램 폴더와 설정 폴더가 항상 같다고 가정하거나, 덮어쓰기 설치 시 설정이 자동으로 이전된다고 생각하지 마세요. 시스템 설치 패키지, 포터블 실행 방식, 인터페이스 버전에 따라 저장 위치가 다를 수 있습니다. 복구할 수 있는지 확인한 뒤에만 기존 폴더를 정리하세요.
업데이트가 끝나면 프록시를 활성화하기 전에 현재 서버, 구독 그룹, 로컬 수신 포트를 확인하세요. 새 버전이 시작되지 않으면 시스템 오류 메시지와 로그를 보관하고 연속해서 삭제·재설치하지 마세요. 페이지의 버전 정보는 클라이언트 릴리스 기록을 확인하는 데 사용하며, 실제 다운로드 파일은 버튼에 연결된 설치 패키지를 기준으로 합니다. 설치된 버전은 클라이언트의 ‘정보’ 화면에서 확인할 수 있습니다.
아래 내용은 주로 설치 파일 선택에 관한 안내입니다. 설치 후 연결되지 않는다면 도움말 센터를 확인하세요.
Windows, macOS, Linux 데스크톱에서는 v2rayN을 사용하세요. Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 추천합니다. 기존 V2Fly 설정을 사용하거나 해당 코어 동작이 필요한 Android 사용자는 v2flyNG를 선택할 수 있습니다. 세 클라이언트 모두 사용 가능한 서버 설정이나 구독을 직접 가져와야 합니다.
Desktop 버전은 차세대 크로스 플랫폼 UI를 사용해 처음 설치하거나 데스크톱 환경 간 일관된 사용 방식을 원하는 사용자에게 적합합니다. 클래식 WPF 버전은 기존 Windows 인터페이스에 익숙한 사용자를 위한 안정적인 버전입니다. 두 버전 모두 x64 패키지이므로 처음에는 하나만 선택하세요. 버전을 바꾸기 전에 설정을 내보내야 합니다.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 단, 시스템에서 64비트 앱을 지원하는지 확인하세요. 기기 아키텍처를 모르거나 설치 중 호환성 오류가 발생하면 범용 버전을 선택할 수 있습니다. 범용 버전은 여러 아키텍처를 포함해 파일 크기가 더 큰 편이며, 같은 클라이언트의 두 패키지를 함께 설치할 필요는 없습니다.
클라이언트에는 사용할 수 있는 서버가 포함되어 있지 않습니다. 설치 후 유효한 구독이나 서버 설정을 가져오고, 구독을 갱신한 뒤 사용할 서버를 선택하세요. 그런 다음 시스템 프록시 또는 Android VPN 연결을 활성화해야 합니다. 그래도 연결되지 않으면 로컬 포트, 서버 매개변수, 시스템 시간, 실행 로그 순으로 확인하세요.
서버 설정, 구독 그룹, 사용자 지정 라우팅을 먼저 내보내고 로컬 수신 포트와 프록시 모드를 기록한 다음 기존 클라이언트를 종료하세요. 플랫폼과 버전에 따라 설정 위치가 다를 수 있으므로 클라이언트의 내보내기 기능을 사용해야 합니다. 백업에 구독 주소와 인증 정보가 포함될 수 있으니 안전하게 보관하고, 업데이트 후 정상 작동을 확인한 뒤 기존 설정을 정리하세요.
다운로드에 실패하면 브라우저의 다운로드 기록, 디스크 여유 공간, 네트워크 상태를 확인한 뒤 페이지를 새로고침하고 다시 시도하세요. 설치에 실패하면 파일 다운로드가 완료됐는지, 확장자와 플랫폼이 맞는지 확인하고 아키텍처, 설치 권한, 시스템 안내도 살펴보세요. 호환성 문제를 해결하려고 파일 확장자를 바꾸지 마세요. 설치 후에는 클라이언트의 정보 화면에서 실제 버전을 확인할 수 있습니다.