Desktop은 차세대 크로스 플랫폼 UI이고, WPF는 클래식한 안정 버전입니다. 둘 다 구독 관리와 프록시 설정에 사용하며, 화면 구성과 설정 메뉴 위치가 다릅니다.
처음 사용하는 경우 Desktop을 설치해 구독을 가져오고 연결을 확인한 뒤 라우팅을 조정하는 것이 좋습니다. 기존 WPF 설정을 사용 중이라면 인터페이스를 바꾸기 위해 꼭 옮길 필요는 없습니다. 전환하려면 기존 클라이언트에서 설정을 내보낸 뒤 새 클라이언트로 가져오세요. 프로그램 디렉터리 전체를 서로 덮어쓰지 말고, 두 인터페이스가 설정을 실시간으로 공유한다고 가정하지 마세요.
대부분의 일상적인 작업은 일반 사용자 권한으로 할 수 있습니다. 시스템 프록시에는 보통 관리자 권한이 필요하지 않지만, TUN은 관리자 권한과 가상 네트워크 구성 요소가 필요할 수 있습니다. 먼저 TUN을 끈 상태로 시스템 프록시가 작동하는지 확인한 뒤 필요에 따라 활성화하세요. 두 버전을 동시에 실행하면 수신 포트가 충돌할 수 있으므로 기존 인스턴스를 먼저 종료하세요.
Windows 시스템 및 설치 요구 사항
확인 항목
요구 사항 및 선택
확인 방법
프로세서 아키텍처
이 페이지에서는 x64 설치 파일을 제공합니다
설정 → 시스템 → 시스템 정보에서 시스템 종류 확인
시스템 호환성
현재 설치 프로그램의 안내를 따르세요. 구형 시스템은 실행 환경을 특히 확인해야 합니다.
먼저 시스템을 업데이트한 다음 설치 프로그램이 안내하는 종속 항목을 처리하세요.
실행 권한
일반 프록시와 TUN은 필요한 권한이 다릅니다.
먼저 시스템 프록시를 확인하고, TUN이 필요할 때 안내에 따라 권한을 허용하세요.
압축 파일 미리보기 창에서 프로그램을 바로 실행하지 마세요. 쓰기 가능한 디렉터리에 압축을 풀고 설치를 마친 뒤 앱 바로가기로 실행하세요. 시스템에서 실행 구성 요소가 없다고 알리면 안내에 표시된 구성 요소 이름과 아키텍처를 확인해 설치하세요. 같은 설치 파일을 반복해서 다시 설치해도 종속 항목 누락은 대개 해결되지 않습니다.
macOS: v2rayN Apple Silicon 및 Intel 버전
Apple 메뉴의 ‘이 Mac에 관하여’에서 칩 정보를 확인하세요. Apple M 시리즈라면 Apple Silicon을, Intel 프로세서라면 Intel 버전을 선택하세요. 운영체제 이름이나 컴퓨터 외관만으로 아키텍처를 추측하지 마세요.
Apple M 시리즈에서는 네이티브 arm64 패키지를, Intel 모델에서는 x64 패키지를 사용하세요. 두 패키지는 프로세서에 맞게 구분되며 기능 등급의 차이는 아닙니다.
DMG를 연 다음 앱을 ‘응용 프로그램’ 폴더로 드래그하고 해당 폴더에서 실행하세요. 마운트된 디스크 이미지에서 계속 실행하면 업데이트, 권한 기록, 앱 경로가 일관되지 않을 수 있습니다. 처음 실행할 때 보안 경고가 표시되면 출처와 앱 이름을 확인한 뒤 시스템 설정의 ‘개인정보 보호 및 보안’에서 구체적인 사유를 확인하세요. 기기 전체의 보안 기능을 끄는 방법은 권장하지 않습니다.
구독과 라우팅 설정은 데스크톱 버전 안내를 참고할 수 있지만, 메뉴 위치는 인터페이스 버전에 따라 달라질 수 있습니다. 시스템 프록시를 설정한 뒤 먼저 브라우저에서 확인하고 다른 앱도 시스템 프록시를 따르는지 살펴보세요. 일부 터미널 도구는 별도의 프록시 설정을 사용합니다. 브라우저는 연결되지만 터미널은 연결되지 않는다고 해서 구독이 만료된 것은 아닙니다. 더 많은 앱의 트래픽을 처리해야 한다면 TUN의 권한과 라우팅 영향을 확인하세요.
macOS 시스템 및 설치 요구 사항
확인 항목
요구 사항 및 선택
확인 방법
칩
Apple Silicon은 arm64, Intel은 x64 선택
Apple 메뉴 → 이 Mac에 관하여
시스템 버전
앱에 명시된 최소 시스템 버전을 충족해야 합니다.
‘이 Mac에 관하여’에서 시스템 버전을 확인하고 실행 안내를 함께 살펴보세요.
앱 위치
응용 프로그램 폴더로 복사한 뒤 실행
설치가 끝나면 DMG를 추출한 다음 앱을 실행하세요.
앱이 호환되지 않는다는 안내가 표시되면 먼저 칩에 맞는 패키지를 선택했는지 확인한 뒤 시스템 버전을 확인하세요. 아키텍처가 맞더라도 현재 앱이 모든 구형 시스템에서 실행되는 것은 아닙니다. 시스템을 업그레이드하기 전에 기기 지원 여부를 확인하세요. 앱 파일을 임의로 수정해 명시된 호환성 요구 사항을 우회하지 마세요.
Android: v2rayNG 우선 선택
2015년 이후 출시된 주요 스마트폰은 보통 arm64를 먼저 선택하면 됩니다. 시스템 아키텍처를 확인하기 어렵거나 arm64 패키지가 호환되지 않는다는 안내가 표시되면 범용 버전을 고려하세요. 두 클라이언트는 설정을 별도로 저장하므로 앱을 바꿔도 구독이 자동으로 이전되지는 않습니다.
일반적인 구독 관리와 Xray 관련 설정에 적합합니다. arm64 패키지는 해당 시스템 아키텍처용이며, 범용 버전은 여러 아키텍처에 맞는 파일을 포함합니다.
APK를 다운로드한 뒤 시스템 파일 관리자에서 여세요. 설치 출처 권한을 요청하면 설치에 사용할 브라우저나 파일 관리자에만 권한을 허용하고, 설치가 끝나면 권한을 끌 수 있습니다. 처음 연결할 때는 Android에서 트래픽을 처리하기 위해 VPN 연결 권한을 요청합니다. 앱 이름을 확인한 뒤 허용하세요.
구독을 가져온 뒤 그룹을 업데이트하고 서버를 선택해 연결을 시작하세요. 목록에 항목이 표시된다고 연결된 것은 아닙니다. 백그라운드 연결이 자주 끊기면 배터리 최적화, 백그라운드 활동, 상시 알림 설정을 확인하고 다른 앱이 시스템 VPN을 사용 중인지 살펴보세요. 기능을 더 켜기 전에 기본 연결과 도메인 이름 확인이 되는지 검증하세요.
V2Fly 코어 생태계에 맞는 설정이 필요한 경우에 적합합니다. 앱 이름의 유사성이 아니라 프로토콜과 설정 항목의 호환성을 기준으로 선택하세요.
V2Fly에 맞춘 설정이 있다면 v2flyNG를 대안으로 사용할 수 있습니다. 특히 특정 코어 확장 기능이 포함된 설정은 v2rayNG와 프로토콜 지원이 완전히 같다고 가정하지 마세요. 가져오기에 실패하면 공유 링크 유형, 전송 방식, 보안 옵션을 먼저 확인한 뒤 다른 클라이언트가 필요한지 판단하세요.
다른 앱에서 옮길 때는 구독 주소를 다시 추가한 뒤 라우팅과 DNS 설정을 하나씩 확인하는 것이 좋습니다. 노드 이름이 같아도 모든 항목이 그대로 옮겨졌다는 뜻은 아닙니다. 두 Android 클라이언트를 모두 설치할 수 있지만, 연결을 확인할 때는 한 번에 하나만 실행하세요. 시스템 VPN 전환을 서버 불안정으로 오해할 수 있습니다.
Android 시스템 및 설치 요구 사항
확인 항목
요구 사항 및 선택
권장 사항
시스템 아키텍처
64비트 시스템은 보통 arm64를 선택하고, 확실하지 않으면 범용 버전을 선택하세요.
프로세서 사양만 보지 말고 시스템 아키텍처를 기준으로 선택하세요.
시스템 호환성
해당 APK의 최소 시스템 요구 사항을 충족해야 합니다.
패키지 분석에 실패하면 시스템 버전과 다운로드 상태를 함께 확인하세요.
설치 및 연결 권한
설치 출처 권한 및 시스템 VPN 연결 권한
각 권한은 시스템 안내에 따라 허용하고, 관련 없는 권한은 허용하지 않아도 됩니다.
설치 중 ‘기존 앱과 충돌’한다는 안내가 표시되어도 바로 삭제하지 마세요. 현재 앱의 출처와 서명이 새 패키지와 일치하는지 확인한 뒤 설정을 내보내세요. 재설치가 꼭 필요하다면 구독 주소와 사용자 지정 규칙을 백업했는지 확인하세요. 노드 목록을 캡처해 두는 것만으로는 전체 설정을 복원하기 어렵습니다.
Linux: 배포판에 맞춰 deb 또는 rpm 선택
일반적인 x64 데스크톱은 배포판에 맞는 패키지 형식을 선택하세요. ARM 데스크톱 기기는 아래 arm64 링크를 이용하세요. 패키지 형식은 배포판에 따라, 프로세서 아키텍처는 기기에 따라 결정되므로 두 항목을 모두 맞춰야 합니다.
Debian, Ubuntu 등은 보통 deb를 사용하고, Fedora, RHEL 등은 보통 rpm을 사용합니다. 같은 패키지 형식이라고 해서 모든 배포판 버전에서 종속 항목이 충족되는 것은 아닙니다.
다운로드한 패키지를 시스템 소프트웨어 설치 프로그램으로 열고, 종속 항목과 아키텍처 안내를 확인한 뒤 설치하세요. 현재 rpm 파일명에는 빌드 대상 정보가 포함되어 있으므로 설치 전에 배포판에서 제공하는 런타임 라이브러리로 요구 사항을 충족할 수 있는지 특히 확인해야 합니다. 종속 항목 오류를 피하려고 강제 설치하지 말고, 다른 배포판의 저장소를 현재 시스템에 추가하지 마세요.
이 링크는 그래픽 클라이언트용이며 데스크톱 환경이 있는 기기에서 사용할 수 있습니다. 설치 후 앱 메뉴에서 실행하고 구독과 시스템 프록시를 설정하세요. 시스템 프록시 지원은 데스크톱 환경마다 다르며 터미널 프로그램은 데스크톱 프록시 설정을 따르지 않을 수 있습니다. TUN이 필요하다면 권한과 라우팅을 확인하고, 설치 직후부터 모든 작업을 높은 권한으로 실행하지 마세요.
Linux 시스템 및 설치 요구 사항
확인 항목
요구 사항 및 선택
확인 방법
패키지 형식
배포판에 따라 deb 또는 rpm 선택
시스템 정보나 소프트웨어 관리 프로그램에서 배포판 이름을 확인할 수 있습니다.
프로세서 아키텍처
x64는 amd64 / x86_64, arm64는 aarch64에 해당합니다.
시스템 정보에서 하드웨어 및 운영체제 아키텍처 확인
실행 환경
그래픽 데스크톱 및 설치 패키지에 필요한 종속 항목
시스템 소프트웨어 설치 프로그램으로 종속 항목과 호환성을 확인하세요.
소프트웨어 관리자가 설치를 거부하면 먼저 누락된 종속 항목의 이름을 확인하세요. 노드나 구독을 바로 바꿀 필요는 없습니다. 종속 항목 문제는 앱이 시작되기 전에 발생하므로 서버 연결과는 관련이 없습니다. 시스템 프록시와 TUN은 설치 후 설정하는 항목이므로 클라이언트가 정상적으로 열린 뒤 각각 확인하세요.
설치 후 설정 순서
먼저 연결 하나를 확인한 뒤 규칙을 추가하세요. 설치 파일, 구독, 프록시 모드는 서로 다른 항목이므로 문제를 확인할 때도 각각 따로 살펴봐야 합니다.
구독 또는 공유 링크 가져오기
구독 주소는 보통 구독 그룹에 추가한 다음 저장하고 업데이트해야 합니다. vmess:// 또는 vless://로 시작하는 단일 노드 링크는 대개 클립보드 메뉴에서 가져옵니다. 구독 주소에는 개인 접속 정보가 포함될 수 있으므로 낯선 변환 서비스에 보내지 마세요.
유효한 서버를 선택한 뒤 연결을 활성화하세요. 데스크톱에서는 먼저 시스템 프록시를 사용하고, Android에서는 시스템 안내에 따라 VPN 연결을 설정하세요. 기본 라우팅으로 먼저 기능을 확인하고, 사용자 지정 분할 라우팅과 TUN은 기본 연결이 정상적으로 작동한 뒤 설정하면 문제 원인을 구분하기 쉽습니다.
실제로 사용할 앱으로 접속을 시험하고 로그에 명확한 오류가 있는지 확인하세요. 지연 시간 테스트는 참고 자료일 뿐 실제 요청을 대신할 수 없습니다. 설정이 작동하는지 확인한 뒤 백업을 내보내세요. 업데이트, 기기 변경, 클라이언트 전환 전에 기존 설정을 저장해 구독과 사용자 지정 규칙이 함께 사라지는 일을 방지하세요.
아키텍처 불일치, 설치 실패, 연결 실패는 각각 다른 단계의 문제입니다. 먼저 문제가 발생한 단계를 확인한 뒤 해당 문제를 해결하세요.
클라이언트를 다운로드한 뒤 구독도 준비해야 하나요?
사용 가능한 구독 주소, 단일 노드 공유 링크 또는 기존 설정을 준비해야 합니다. 클라이언트는 설정을 관리하고 연결을 구성하지만, 설치 파일에 사용할 수 있는 서버가 포함되어 있지는 않습니다. 구독 주소는 보통 구독 그룹에서 가져오고, 단일 노드 공유 링크는 클립보드에서 가져옵니다. 두 가져오기 메뉴를 혼동하지 마세요.
Windows에서는 Desktop과 WPF 중 무엇을 선택해야 하나요?
처음 설치한다면 새 세대 크로스 플랫폼 인터페이스를 사용하는 Desktop을 먼저 선택해 보세요. 기존 인터페이스가 익숙하거나 기존 작업 방식을 유지하려면 안정적인 클래식 WPF 버전을 선택할 수 있습니다. 두 버전의 차이는 노드 요금제가 아닙니다. 전환하기 전에 설정을 내보내고, 두 클라이언트가 같은 수신 포트를 동시에 사용하지 않도록 하세요.
Android의 arm64와 범용 버전은 어떻게 다른가요?
2015년 이후 출시된 주요 스마트폰은 보통 arm64를 먼저 선택하면 됩니다. 다만 기기의 시스템 아키텍처를 기준으로 판단하세요. 범용 버전은 여러 아키텍처를 지원하므로 아키텍처를 확인하기 어렵거나 arm64 패키지가 호환되지 않을 때 시도할 수 있습니다. 일부 기기는 프로세서가 64비트를 지원해도 설치된 운영체제는 32비트일 수 있습니다.
클라이언트를 업데이트하면 구독과 라우팅 설정이 사라지나요?
같은 클라이언트를 정상적으로 업데이트하면 대체로 데이터가 유지되지만, 설치 방식이나 서명, 데이터 디렉터리에 따라 결과가 달라질 수 있습니다. 업데이트 전에 클라이언트에서 설정을 내보내고 구독 그룹과 라우팅 설정을 기록해 두세요. 기존 버전을 먼저 삭제하지 마세요. 서명 충돌이 발생하거나 덮어쓰기에 실패하면 백업을 사용할 수 있는지 확인한 뒤 다음 작업을 결정하세요.
설치했는데 연결되지 않으면 어디부터 확인해야 하나요?
먼저 구독 업데이트가 완료됐는지, 유효한 서버를 선택했는지 확인한 다음 시스템 프록시나 연결 스위치가 켜져 있는지 확인하세요. 이어서 클라이언트 로그를 살펴 포트 충돌, 인증 실패, 이름 확인 실패, 연결 시간 초과를 구분합니다. 먼저 시스템 프록시로 연결을 확인하고 프로토콜, 라우팅, TUN 설정을 한꺼번에 변경하지 마세요.
