Desktop은 차세대 크로스 플랫폼 인터페이스를 사용하므로 처음 설치한다면 이 버전부터 시작해도 좋습니다. WPF는 Windows의 클래식 인터페이스를 이어가는 안정 버전으로, 기존 메뉴에 익숙한 사용자에게 적합합니다. 두 버전의 주요 차이는 인터페이스와 설정 위치입니다. 같은 구독을 가져오기 위해 두 버전을 모두 설치할 필요는 없습니다.
Windows 시스템 요구 사항
확인 항목
선택 기준
시스템 및 아키텍처
Windows 10 / 11 x64 데스크톱 환경을 대상으로 합니다. ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하세요.
파일 형식
두 다운로드 모두 ZIP 파일입니다. 먼저 압축을 완전히 푼 다음 폴더 안의 설치 프로그램을 실행하세요.
실행 환경
실행할 때 .NET이 없다는 메시지가 표시되면 오류에 나온 런타임 이름과 버전을 확인해 설치하세요.
압축 파일 미리보기 창에서 설치 프로그램을 바로 실행하지 마세요. 파일 하나만 임시로 풀리고 나머지 설치 리소스는 풀리지 않을 수 있습니다. 업그레이드하기 전에 트레이 메뉴에서 기존 버전을 종료하세요. 기본 창만 닫으면 백그라운드에서 계속 실행될 수 있습니다. 새 버전에서 포트가 이미 사용 중이라는 메시지가 나오면 포트를 바꾸기 전에 기존 프로세스가 실행 중인지 확인하세요.
칩이 무엇인지 모르겠다면 Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. ‘칩 Apple M 시리즈’라고 표시되면 Apple Silicon을, ‘프로세서 Intel’이라고 표시되면 Intel을 선택하세요. 두 설치 파일은 용도가 같으며 칩에 맞게 빌드된 점만 다릅니다. 설정은 클라이언트에서 지원하는 방식으로 옮길 수 있습니다.
macOS 시스템 요구 사항
확인 항목
선택 기준
칩
Apple Silicon은 arm64, Intel은 x64에 해당합니다.
시스템 버전
구형 시스템에서는 현재 릴리스의 호환 요구 사항을 먼저 확인하세요. 칩이 맞아도 시스템 버전까지 지원된다는 뜻은 아닙니다.
설치 위치
DMG를 마운트한 뒤 앱을 ‘응용 프로그램’ 폴더로 복사하고 그곳에서 실행하세요.
기존 버전이 실행 중이면 먼저 종료한 다음 ‘응용 프로그램’ 폴더의 기존 사본을 교체하세요. 복사가 끝나면 디스크 이미지를 추출해 다음에 이미지에서 다른 사본을 잘못 실행하지 않도록 하세요. 시스템에서 실행을 차단하면 시스템 버전 불일치, 아키텍처 불일치, 보안 제한 중 어떤 사유인지 확인하세요. 조직에서 관리하는 기기라면 관리자에게 설치 규정을 문의하세요.
기본적으로 Xray 코어를 사용하는 v2rayNG를 권장합니다. 2015년 이후 출시된 일반적인 스마트폰이라면 arm64를 먼저 선택해도 좋습니다. 기기가 32비트 시스템을 사용하거나 시스템에서 arm64-v8a를 지원하지 않는 것이 확인된 경우 범용 버전으로 바꾸세요.
v2flyNG는 v2fly 코어를 사용합니다. 기존 설정에서 이 코어를 명시적으로 요구하는 경우에만 선택하세요. v2rayNG에서 옮길 예정이라면 기존 노드의 프로토콜과 전송 설정을 먼저 확인하세요. 두 클라이언트가 완전히 같은 옵션을 지원한다고 가정하지 마세요.
Android 시스템 요구 사항
확인 항목
선택 기준
시스템 아키텍처
시스템에서 arm64-v8a를 지원하면 arm64를 선택하세요. 확실하지 않다면 범용 패키지를 고려할 수 있습니다.
설치 형식
APK는 시스템 설치 프로그램으로 여세요. 구형 시스템에서 설치할 수 있는지는 해당 릴리스 패키지의 최소 시스템 요구 사항에 따라 달라집니다.
기기 권한
앱 설치 권한과 첫 연결 시 필요한 VPN 권한은 서로 다른 시스템 권한입니다.
휴대폰 프로세서가 64비트를 지원해도 기본 설치된 시스템이 64비트 앱을 지원한다는 뜻은 아닙니다. 설치 프로그램에서 아키텍처가 맞지 않는다고 명확히 안내하면 범용 패키지로 바꾸세요. 기존 버전과 충돌한다는 메시지가 나오면 버전이나 서명 문제부터 확인하세요. 범용 패키지는 더 많은 아키텍처를 지원할 뿐, 낮은 시스템 버전이나 서명 불일치 문제까지 해결하지는 않습니다.
목록에 표시된 버전과 실제 설치 파일 이름이 다를 수 있습니다. 설치 문제를 기록하거나 문의할 때는 선택한 파일 이름, 기기 모델, 시스템 버전, 설치 프로그램의 메시지를 함께 적어 주세요. 처음 연결되지 않는 경우 다른 앱이 시스템 VPN 연결을 사용 중인지도 확인하세요.
Debian 및 Ubuntu 계열에서는 보통 DEB를 선택합니다. RPM 파일 이름의 el10은 Enterprise Linux 10 빌드를 의미합니다. 다른 RPM 계열 배포판에서는 의존성 호환성을 먼저 확인하세요. 패키지 형식에 따라 설치 도구가 달라지고, 아키텍처에 따라 해당 패키지를 기기에서 실행할 수 있는지가 결정되므로 두 조건을 모두 맞춰야 합니다.
Linux 시스템 요구 사항
확인 항목
선택 기준
배포판
먼저 배포판과 버전을 확인한 다음 DEB 또는 호환되는 RPM을 선택하세요.
프로세서 아키텍처
x86_64는 x64, aarch64는 arm64에 해당합니다.
데스크톱 환경
여기서는 그래픽 클라이언트를 제공합니다. 데스크톱 앱이 정상적으로 실행되는 세션에서 설치하고 사용하세요.
uname -m 명령으로 시스템 아키텍처를 확인할 수 있습니다. 가상 머신이나 컨테이너에 설치하는 경우 실제 설치 환경의 패키지 관리자 아키텍처도 확인하세요. 의존성 오류가 발생하면 파일 확장자만 보고 다른 패키지로 바꾸지 말고 패키지 관리자가 표시한 내용을 우선 확인하세요. 설치는 완료됐는데 데스크톱 메뉴에 앱이 보이지 않으면 패키지 관리자의 설치 완료 여부를 확인한 뒤 앱 실행 항목을 찾아보세요.
다운로드 후 확인
첫 설치 및 기존 버전 이전
처음 사용할 때는 프로그램이 정상적으로 실행되는지 확인한 다음 노드를 가져오세요. 기존 버전을 교체할 때는 복구할 수 있는 설정을 보관한 뒤 설치를 진행하세요. 이렇게 하면 문제가 생겼을 때 설치, 설정 불러오기, 네트워크 연결 중 어디서 발생했는지 구분하기 쉽습니다.
다운로드가 끝나면 파일을 저장한 위치에서 열기
파일이 저장된 위치를 확인할 때는 주소 표시줄보다 브라우저의 다운로드 목록을 이용하는 편이 좋습니다. 전송이 완료됐는지 확인한 다음 ‘폴더에서 보기’ 또는 ‘저장 위치 열기’를 선택하세요. 브라우저가 같은 이름의 파일에 번호를 붙일 수 있습니다. 새 파일인지 이전 파일인지 헷갈리면 다운로드 시간과 이 페이지의 버튼 아래 표시된 파일 이름을 비교하세요. 아이콘만 보고 판단하지 마세요.
ZIP은 압축을 풀고, DMG는 마운트하세요. APK와 Linux 패키지는 각 시스템의 설치 프로그램이나 패키지 관리자에 맡기세요. 파일을 열 수 있게 보이도록 확장자를 직접 바꾸지 마세요. 관리 대상 컴퓨터나 휴대폰은 설치 출처, 설치 위치, 네트워크 설정을 제한할 수 있습니다. 제한이 있다면 기기 정책 때문인지 패키지를 잘못 선택했는지 먼저 구분한 뒤 다음 단계를 정하세요. 한 번 설치하기 위해 시스템 전체 정책을 바꾸지 마세요.
업데이트 전에 설정과 프로그램을 따로 보관하기
설치 파일을 다시 다운로드해도 프로그램만 복구할 수 있을 뿐, 직접 추가한 노드나 작성한 라우팅 규칙, 변경한 로컬 포트는 복구되지 않습니다. 라우팅 규칙은 특정 연결을 어떤 출구로 보낼지 결정합니다. 업무용 네트워크나 특정 앱에 맞춰 규칙을 변경한 적이 있다면 업데이트 전에 현재 규칙 구성을 기록해 두세요. 클라이언트에 내보내기 기능이 있으면 우선 사용하되 내보내기 범위를 확인하세요. 노드 목록, 구독 그룹, 프로그램 설정이 모두 같은 파일에 포함된다고 보장할 수 없습니다.
다른 기기로 옮길 때는 내보낸 파일을 본인만 접근할 수 있는 위치에 먼저 저장하세요. 구독 주소에는 보통 접근 권한 정보가 포함되어 있으므로 공개 클라우드 저장소나 단체 채팅으로 전달하지 않는 것이 좋습니다. 주요 옵션 몇 개만 복구하려는 경우에는 노드 주소나 계정 정보는 기록하지 말고 옵션 이름과 현재 값만 적어 두세요. 새 버전이 정상적으로 실행되면 현재 그룹, 선택한 노드, 프록시 상태를 확인하세요. 정상 작동을 확인한 뒤 기존 사본을 정리하면 됩니다.
기본 연결을 확인한 다음 고급 기능 사용하기
처음 연결할 때는 노드 하나와 프록시 방식 하나만 테스트하세요. 데스크톱의 시스템 프록시는 프록시 주소를 시스템에 전달해 해당 설정을 따르는 앱이 사용하도록 합니다. 모든 프로그램이 같은 경로를 이용한다고 보장하지는 않습니다. 휴대폰에서 다른 앱이 시스템 VPN을 사용 중이라면 현재 유지할 연결이 무엇인지 먼저 확인하세요. 테스트할 때는 평소 확인이 필요한 페이지나 앱을 사용하고, 연결에 성공한 설정을 기록한 뒤 항목을 하나씩 조정하세요.
앱은 정상 실행되지만 구독 목록이 비어 있다면 주소가 올바른 그룹에 추가됐는지 확인하고 직접 한 번 업데이트하세요. 목록은 보이지만 페이지가 열리지 않는다면 실제 사용할 노드가 선택됐는지, 관련 프록시 스위치가 켜져 있는지 확인하세요. 라우팅, DNS(도메인 이름을 주소로 변환하는 서비스), 그 밖에 네트워크를 제어하는 옵션을 한 번에 함께 바꾸지 마세요. 항목을 하나씩 바꿀 때마다 원래 상황에서 다시 테스트하면 문제가 생겼을 때 되돌리기 쉽습니다.
다운로드 및 설치 FAQ
Windows 데스크톱 버전과 클래식 WPF 버전을 모두 설치해야 하나요?
하나만 선택하면 됩니다. 처음 설치한다면 데스크톱 버전을 권장합니다. 클래식 인터페이스에 익숙하다면 WPF 버전을 선택할 수 있습니다. 전환하기 전에 실행 중인 버전을 종료하고 설정을 백업하세요. 두 클라이언트를 동시에 실행하면 로컬 포트를 놓고 충돌하거나 서로 시스템 프록시 설정을 덮어쓸 수 있습니다.
Mac에 맞는 설치 파일을 어떻게 확인하나요?
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. M1, M2 또는 이후 모델처럼 Apple 칩이 표시되면 Apple Silicon을, Intel 프로세서가 표시되면 Intel을 선택하세요. 브라우저나 다른 앱이 표시하는 아키텍처가 아니라 이 Mac의 정보를 기준으로 선택해야 합니다.
Android에서 앱을 설치할 수 없다고 합니다. 범용 버전으로 바꿔야 하나요?
기기가 arm64 설치 파일을 지원하지 않으면 범용 버전을 시도해 보세요. 기존 앱과 충돌한다는 메시지가 표시되면 먼저 기존 버전을 어느 배포 경로에서 받았는지 확인하세요. 서명이 다르면 기존 앱 위에 설치할 수 없는 경우가 많습니다. 다시 가져올 수 있도록 설정을 백업하거나 기록한 뒤, 로컬 설정을 잃지 않도록 기존 앱을 삭제할지 결정하세요.
Linux에서 패키지를 설치할 때 의존성이 없다는 메시지가 나오면 어떻게 해야 하나요?
먼저 배포판, 패키지 형식, 아키텍처를 확인한 다음 배포판에 기본 제공되는 패키지 관리자로 패키지를 설치하세요. 특정 의존성을 충족할 수 없다는 메시지가 계속 나오면 의존성 이름과 필요한 버전을 기록하세요. 특히 el10 표시가 있는 RPM은 다른 배포판이나 구형 시스템에 강제로 설치하지 않는 것이 좋습니다.
클라이언트를 설치하면 구독도 자동으로 표시되나요?
아니요. 설치 파일에는 클라이언트 프로그램만 들어 있습니다. 구독은 노드 목록을 가져오는 주소이므로 별도로 가져오거나 기존 기기에서 옮겨야 합니다. 가져온 뒤 해당 구독 그룹을 업데이트하고 목록에서 노드를 선택하세요. 전체 구독 주소를 공개 질문 게시글에 올리지 마세요.
업데이트 후 연결되지 않으면 무엇부터 확인해야 하나요?
새 버전이 기존 설정을 제대로 불러왔는지 먼저 확인한 다음, 선택한 노드와 시스템 프록시 상태를 살펴보세요. 설정이 바뀌었다면 한 번에 하나씩만 이전 상태로 되돌리고, 기존에 접속되던 같은 페이지로 확인하세요. 앱이 열리지 않는다면 구독을 먼저 수정하지 말고 실행 또는 설치 문제부터 점검하세요.