Desktop 데스크톱 버전은 새로운 크로스 플랫폼 인터페이스를 사용해 처음 설치하는 사용자에게 적합합니다. 클래식 WPF 버전은 익숙한 Windows 인터페이스를 유지해 기존 사용 방식을 선호하는 사용자에게 알맞습니다. 두 파일 모두 ZIP 형식입니다. 다운로드한 뒤 별도 폴더에 압축을 풀고, 압축을 푼 폴더에서 설치 프로그램을 실행하세요.
설치 프로그램을 실행하자마자 런타임이 없다는 안내가 나오면 팝업에 표시된 이름, 버전, 아키텍처를 확인하세요. 일반 .NET 런타임과 .NET 데스크톱 런타임은 서로 대체할 수 없는 경우가 있습니다. 이전 버전이 설치되어 있다면 기본 창만 닫지 말고 알림 영역에서 클라이언트를 종료하세요.
Windows 시스템 요구 사항
확인 항목
확인 방법
운영체제
지원이 계속되는 64비트 Windows 버전을 사용하는 것이 좋습니다. ‘설정 → 시스템 → 정보’에서 Windows 버전과 시스템 종류를 확인하세요.
아키텍처
여기서는 x64 설치 파일을 제공합니다. 시스템에 x86 또는 ARM이라고 표시된다면 ‘64비트’라는 이유만으로 호환된다고 판단하지 마세요.
실행 환경
설치 안내에 따라 필요한 데스크톱 런타임을 확인하세요. 설치와 첫 실행을 위해 폴더를 읽고 쓸 수 있는 권한도 필요합니다.
‘이 Mac에 관하여’에 Apple M 시리즈 칩이 표시되면 Apple Silicon(arm64)을, Intel 프로세서가 표시되면 Intel(x64)을 선택하세요. 두 설치 파일의 클라이언트 기능은 같습니다. 화면 크기, 모델명, 구입 시기가 아니라 Mac의 칩을 기준으로 선택하면 됩니다.
DMG를 연 뒤 디스크 이미지 창의 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮기고 해당 폴더에서 실행하세요. 앱을 열 수 없다는 안내가 나오면 macOS 버전 비호환, 아키텍처 불일치, 보안 정책 제한 중 무엇이 원인인지 먼저 확인하세요. 앱 하나를 실행하려고 기기 전체의 보안 기능을 끄지는 마세요.
macOS 시스템 요구 사항
확인 항목
확인 방법
칩
Apple Silicon은 arm64, Intel은 x64에 해당합니다.
운영체제 버전
‘이 Mac에 관하여’에서 macOS 버전을 확인하세요. 구형 시스템이라면 선택한 빌드의 최소 지원 버전도 확인해야 합니다.
설치 위치
쓰기 권한이 있는 응용 프로그램 폴더를 사용하세요. 조직에서 관리하는 기기라면 해당 기기의 설치 정책을 따르세요.
같은 Mac에서 업데이트하기 전에 기존 버전을 종료한 뒤 새로 설치한 앱을 실행하세요. Dock에 이전 버전의 아이콘이 남아 있다면 테스트 중 잘못된 버전을 실행하지 않도록 ‘응용 프로그램’ 폴더에서 앱을 다시 여세요.
Android 설치 파일
v2rayNG를 우선 선택하세요. V2Fly 호환성이 필요한 경우에만 v2flyNG를 고려하세요.
Xray 코어를 사용합니다. 2015년 이후 출시된 대부분의 스마트폰은 시스템이 arm64-v8a를 지원한다면 arm64 버전을 선택할 수 있습니다. 일부 기기는 64비트 칩을 사용하더라도 32비트 앱 환경만 제공할 수 있습니다. 지원 아키텍처를 확인하기 어렵다면 범용 버전을 선택하세요.
V2Fly 코어를 사용하며, 설정이 V2Fly와 호환되는지 확인한 경우에 적합합니다. 두 클라이언트는 비슷한 구독 형식을 읽을 수 있지만, 노드가 목록에 표시된다고 해서 해당 전송 방식이나 보안 매개변수까지 모두 지원된다는 뜻은 아닙니다. 이전하기 전에 사용 가능한 것으로 확인된 설정 하나로 연결을 테스트한 다음 나머지 그룹을 옮기세요.
Android 시스템 요구 사항
확인 항목
확인 방법
운영체제 버전
‘설정 → 휴대전화 정보’에서 Android 버전을 확인하세요. 구형 버전은 선택한 빌드의 호환 요구 사항을 기준으로 판단하세요.
앱 아키텍처
arm64-v8a 지원이 확인되면 arm64를 선택하고, 확실하지 않다면 범용 버전을 선택하세요.
설치 권한
브라우저나 파일 관리자에서 APK를 열면 현재 설치 출처에 대한 권한을 별도로 허용해야 할 수 있습니다.
연결 권한
VPN 모드를 처음 사용할 때는 시스템 연결 요청을 승인해야 합니다. 이 권한은 앱 설치 권한과 별개입니다.
표시된 버전 번호는 릴리스 목록을 기준으로 합니다. APK 파일명에 적힌 번호와 다르면 덮어 설치할 때 시스템 설치 화면이나 설치 후 앱 정보에 표시되는 버전을 확인하세요.
Debian 및 Ubuntu 계열은 주로 DEB를 사용합니다. RPM을 사용하는 배포판에서는 패키지의 빌드 대상과 시스템 의존성을 확인하세요. 여기서 제공하는 RPM 파일명에는 el10이 포함되어 있습니다. 시스템이 RPM을 사용하더라도 해당 빌드에 필요한 의존성이 제공된다는 뜻은 아닙니다.
배포판의 소프트웨어 설치 프로그램으로 패키지를 열면 필요한 의존성을 확인할 수 있습니다. 설치 프로그램에서 오류가 발생하면 누락된 항목을 기록하고 배포판과 빌드가 맞는지 확인하세요. 의존성 검사를 무시하고 강제로 설치하지 마세요.
Linux 시스템 요구 사항
확인 항목
확인 방법
배포판
시스템 정보에서 배포판과 버전을 확인한 뒤, 설치된 패키지 관리자가 지원하는 패키지 형식을 확인하세요.
이 패키지는 그래픽 클라이언트용입니다. 일반적인 데스크톱 세션에서 실행하고 패키지 관리자가 표시하는 의존성을 충족해야 합니다.
소프트웨어를 설치할 때는 관리자 권한이 필요할 수 있지만, 평소에는 일반 데스크톱 계정으로 실행하세요. 설치 권한과 클라이언트 실행 권한은 별개입니다.
첫 설치 및 기존 버전 업데이트
처음 설치한다면 기기 조건에 맞는 설치 파일을 선택하세요. 이미 사용 중이라면 먼저 기존 데이터를 유지할 수 있는지 확인해야 합니다. 설치 파일을 고를 때는 운영체제 버전, 아키텍처, 패키지 형식을 확인하고, 업데이트할 때는 현재 앱 버전과 설치 경로, 설정 저장 위치를 점검하세요. 두 과정에서 확인할 내용은 다릅니다. 기기에 설치할 수 있다고 해서 기존 버전을 바로 덮어쓸 수 있는 것은 아닙니다.
먼저 어떤 기기에서 사용할 설치 파일인지 확인하세요
컴퓨터에서 휴대전화용 설치 파일을 받는 경우 컴퓨터가 아니라 휴대전화의 Android 버전과 앱 아키텍처를 기준으로 선택하세요. 다른 컴퓨터용 파일을 고를 때도 대상 기기의 시스템 정보에서 아키텍처를 확인해야 합니다. 같은 제품군의 컴퓨터라도 프로세서가 다를 수 있습니다. 일부 호환 앱이 실행된다고 해서 해당 아키텍처의 모든 설치 프로그램이 작동하는 것은 아니므로 기본 아키텍처에 맞는 파일을 우선 선택하세요.
업데이트 전에 구독과 로컬 설정을 저장하세요
사용 중인 클라이언트, 설치 출처, 구독 그룹을 기록하세요. 클라이언트에 내보내기 기능이 있다면 복구할 설정을 앱 폴더 바깥에 저장하세요. 수동으로 추가한 노드, 라우팅 규칙, 로컬 포트 설정 등은 구독만으로 복원되지 않을 수 있으므로 변경한 항목을 따로 기록해 두세요. 구독 주소에 접근 정보가 포함될 수 있으니 공개 댓글이나 스크린샷, 공유 로그에 올리지 마세요.
같은 출처의 파일로 업데이트한다면 먼저 실행 중인 이전 클라이언트를 종료한 뒤 새 설치 파일의 안내에 따라 진행하세요. 업데이트 후 인터페이스를 열어 기존 그룹, 노드, 규칙이 유지됐는지 확인하고 연결을 테스트하세요. 다른 클라이언트로 바꿔야 한다면 현재 사용할 수 있는 설정 하나를 먼저 가져오세요. 새 클라이언트가 정상 작동하는지 확인할 때까지 기존 환경을 유지하세요.
설치, 가져오기, 연결을 각각 확인하세요
설치 파일이 열리지 않거나 설치 프로그램에서 오류가 발생하면 먼저 운영체제와 아키텍처를 확인하고 오류 안내를 기록하세요. 인터페이스는 열리지만 목록이 비어 있다면 구독 주소와 그룹 업데이트 결과를 확인하세요. 노드는 표시되지만 인터넷에 연결되지 않는 경우에만 노드 연결 상태, 프록시 모드, 라우팅 규칙을 각각 점검하세요. 한 번에 설정 하나만 변경하고 같은 앱으로 다시 테스트해야 어떤 변경이 결과에 영향을 줬는지 확인할 수 있습니다.
설치 파일 관련 자주 묻는 질문
Windows 데스크톱 버전과 클래식 WPF 버전을 모두 설치해야 하나요?
하나만 선택하면 됩니다. 처음 설치한다면 크로스 플랫폼 인터페이스를 사용하는 데스크톱 버전을 권장합니다. WPF에 익숙하다면 클래식 버전을 계속 사용해도 됩니다. 전환하기 전에 기존 클라이언트를 완전히 종료하세요. 두 인스턴스가 동시에 시스템 프록시를 변경하거나 같은 로컬 포트를 사용할 수 있습니다.
Android 범용 버전이 arm64 버전보다 더 안정적인가요?
범용 버전은 더 다양한 프로세서 아키텍처를 지원하며 일반적으로 파일 크기도 더 큽니다. 그렇다고 연결이 더 안정적인 것은 아닙니다. 기기가 arm64-v8a를 지원하는지 확인했다면 arm64 버전을 선택하세요. 지원 아키텍처를 확인하기 어렵다면 범용 버전을 선택할 수 있습니다. 범용 버전도 Android 버전과 앱 서명 등 설치 조건을 충족해야 합니다.
기기에 업데이트를 설치할 수 없다고 표시되는 이유는 무엇인가요?
먼저 Android 버전, 설치 파일의 아키텍처, 저장 공간을 확인하세요. 기존 앱과 충돌한다는 안내가 표시되면 문구 전체를 기록하고, 새 설치 파일이 기존 앱과 같은 앱인지 및 서명이 호환되는지 확인하세요. 기존과 같은 경로에서 받은 파일로 업데이트하는 것이 좋습니다. 앱을 삭제한 뒤 다시 설치해야 한다면 구독과 로컬 설정을 먼저 백업하세요.
클라이언트를 다운로드한 뒤 코어도 따로 받아야 하나요?
처음 설치할 때는 선택한 클라이언트에 포함된 구성 요소를 사용하면 됩니다. 실행 중 구성 요소가 없다는 오류가 나오면 클라이언트 로그에서 구성 요소 이름을 확인하고, 압축 파일이 제대로 풀렸는지 또는 시스템 패키지 관리자가 의존성 누락을 보고하는지 살펴보세요.
설치 후 노드 목록이 비어 있는 이유는 무엇인가요?
설치 파일에는 클라이언트가 포함되어 있습니다. 처음 실행한 뒤 보유한 구독 주소나 노드 설정을 가져오세요. 구독을 사용하는 경우 주소를 저장한 다음 해당 그룹도 업데이트해야 합니다. 노드가 목록에 나타나면 노드를 선택해 연결하고 정상 작동하는지 확인하세요.