데스크톱 버전과 클래식 WPF 버전은 모두 구독 관리, 서버 선택, 프록시 설정에 사용됩니다. 주된 차이는 인터페이스 기술과 화면 구성입니다. 데스크톱 버전은 새로운 크로스 플랫폼 인터페이스를 적용해 메뉴 구성이 클래식 버전과 다를 수 있으며, WPF 버전은 익숙한 Windows 조작 방식을 이어갑니다. 버전 이름은 서버 품질을 의미하지 않으며, 프로토콜 설정을 확인하는 절차를 대신할 수 없습니다.
다운로드한 압축 파일을 쓰기 가능한 위치에 완전히 푼 뒤 폴더 안의 설치 프로그램을 실행하세요. 압축 프로그램의 미리보기 창에서 바로 실행하면 필요한 파일이 제대로 풀리지 않을 수 있습니다. 업그레이드와 설정 확인을 위해 설치 경로를 안정적으로 유지하는 것이 좋습니다. 실행 환경 관련 안내가 표시되면 설치 프로그램이나 운영체제의 지침을 따르고, 출처를 알 수 없는 사이트에서 대체 파일을 찾지 마세요.
처음 실행한 뒤 구독 그룹을 추가하고 구독을 업데이트하세요. 유효한 서버를 선택한 다음 시스템 프록시 자동 설정을 켜고 라우팅 모드를 지정합니다. 시스템 프록시는 해당 설정을 따르는 앱에만 적용되므로 모든 프로그램이 연결되는 것은 아닙니다. 다른 인터페이스 버전으로 바꾸려면 먼저 백업하고 기존 인스턴스를 종료하세요. 두 인스턴스를 동시에 실행하면 로컬 포트가 충돌하거나 프록시 설정이 서로 덮어쓰일 수 있습니다.
Windows 설치 요구 사항
확인 항목
이 페이지의 설치 파일 요구 사항
확인 방법
CPU 아키텍처
x64 전용이며, 다른 아키텍처용 패키지가 아닙니다
시스템 설정의 ‘시스템 정보’ 또는 ‘정보’에서 시스템 종류를 확인하세요
운영체제
현재 클라이언트와 실행 환경의 지원 범위를 충족해야 합니다
운영체제 버전을 확인하고 설치 중 호환성 및 실행 환경 안내를 살펴보세요
파일 및 권한
압축을 완전히 풀고, 설정 저장 위치에 쓰기 권한이 있으며, 디스크 공간이 충분해야 합니다
설치 폴더와 사용자 설정 폴더가 권한 정책에 의해 제한되지 않는지 확인하세요
이 페이지에서 제공하는 패키지는 x64용입니다. CPU 이름이 비슷하다고 앱 아키텍처까지 같은 것은 아닙니다. 관리되는 업무용 기기라면 회사의 설치 및 프록시 정책도 따라야 합니다.
먼저 시스템 메뉴에서 ‘이 Mac에 관하여’를 열고 칩 또는 프로세서 항목을 확인하세요. Apple Silicon은 arm64, Intel은 x64에 해당합니다. 외관이나 구매 연도, 운영체제 버전으로 아키텍처를 추측하지 마세요. 같은 제품군이라도 프로세서가 다를 수 있습니다. 기기에 맞는 네이티브 패키지를 선택하면 추가 호환 계층에 대한 의존을 줄일 수 있습니다.
다운로드가 끝나면 디스크 이미지를 열고, 패키지 안내에 따라 앱을 응용 프로그램 폴더로 옮긴 뒤 해당 폴더에서 실행하세요. 임시로 마운트한 디스크 이미지에서 앱을 계속 실행하지 마세요. 설치를 마치고 관련 창을 닫은 후에는 이미지를 추출해도 됩니다. 시스템에서 보안 제한 안내가 표시되면 파일 출처와 안내 내용을 먼저 확인하고 시스템에서 제공하는 승인 절차를 따르세요. 앱 하나를 실행하기 위해 시스템 보호 기능 전체를 끄지 마세요.
구독을 가져온 뒤 현재 서버와 라우팅 모드를 확인하고, 사용 중인 네트워크 서비스에 시스템 프록시가 설정됐는지 살펴보세요. Wi-Fi와 유선 네트워크는 프록시 설정이 각각 다를 수 있으므로 네트워크를 바꾼 뒤 다시 확인해야 합니다. TUN 모드에는 추가 권한과 네트워크 트래픽 제어가 필요할 수도 있습니다. 처음에는 시스템 프록시부터 사용하면 설치, 설정, 앱 트래픽 연결 중 어느 단계에서 문제가 생겼는지 구분하기 쉽습니다.
macOS 설치 요구 사항
확인 항목
이 페이지의 설치 파일 요구 사항
확인 방법
칩
Apple Silicon은 arm64, Intel은 x64 선택
‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인하세요
운영체제 버전
현재 데스크톱 버전의 지원 범위에 포함되어야 합니다
운영체제 버전을 확인하고 설치 또는 실행 안내에 따라 호환성을 판단하세요
앱 및 네트워크 권한
앱을 설치할 수 있어야 하며, 필요한 프록시 설정 변경을 허용해야 합니다
시스템 보안 안내와 현재 네트워크 서비스의 프록시 설정을 확인하세요
앱이 열리지 않으면 먼저 아키텍처와 시스템 안내를 확인하세요. 구독 업데이트 실패는 이후의 네트워크 설정 문제일 수 있으므로 설치 파일 선택 문제로 단정하지 마세요.
v2rayNG는 Android에서 우선 추천하는 클라이언트로, Xray 코어를 사용하며 해당 생태계의 설정과 함께 쓰기에 적합합니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 지원하지만, 일부 기기의 운영체제는 이전 아키텍처만 지원할 수 있으므로 실제 지원 여부를 확인해야 합니다. 범용 패키지는 더 많은 아키텍처를 지원하기 위한 것이며, 앱의 운영체제 버전 요구사항까지 우회하지는 않습니다.
다운로드한 설치 파일을 열면 브라우저나 파일 관리자에 ‘출처를 알 수 없는 앱 설치’ 권한을 허용하라는 메시지가 표시될 수 있습니다. 설치를 시작한 앱에 필요한 권한만 허용하고, 설치가 끝나면 원래 설정으로 되돌려도 됩니다. 처음 연결할 때는 클라이언트가 시스템 인터페이스를 통해 앱 트래픽을 받도록 VPN 권한을 승인해야 합니다. 다른 VPN 앱이 실행 중이라면 먼저 중지해 같은 연결 지점을 두고 경쟁하지 않도록 하세요.
설치 후 구독 그룹을 추가해 업데이트하고, 서버를 선택한 다음 연결을 시작하세요. 백그라운드로 전환한 뒤 연결이 자주 끊기면 아키텍처가 다른 패키지를 계속 다시 설치하기보다 배터리 최적화, 백그라운드 실행, 절전 정책을 확인하세요. 구독에는 접속 정보가 포함되므로 스크린샷을 공유할 때 전체 주소를 가리세요. 설치 문제를 설명할 때는 클라이언트 이름, 아키텍처, 오류 메시지만으로도 충분한 경우가 많습니다.
v2flyNG는 V2Fly 코어를 사용하며, 기존 설정이 해당 코어와 호환되는 경우 대안으로 사용할 수 있습니다. 두 Android 클라이언트는 조작 방식이 비슷하지만 프로토콜 지원, 전송 옵션, 설정 항목이 완전히 같지는 않습니다. 특히 Xray 전용 기능을 사용하는 설정은 클라이언트와 코어의 지원 여부를 먼저 확인하세요. 범용 패키지로 바꾼다고 프로토콜 기능이 추가되지는 않습니다.
v2rayNG에서 전환하려면 기존 구독과 설정을 먼저 보관한 뒤 새 클라이언트에서 다시 가져오세요. 시스템 권한은 다른 앱으로 자동 이전되지 않으므로 처음 연결할 때 다시 승인해야 합니다. 테스트 중에는 클라이언트를 하나만 실행하고 ‘구독 업데이트 가능 여부 → 서비스 시작 여부 → 앱의 네트워크 접속 여부’ 순서로 확인하면 설치 호환성과 네트워크 설정 문제를 구분하기 쉽습니다.
Android 설치 요구 사항
확인 항목
설치 및 실행 요구 사항
확인 방법
앱 아키텍처
arm64 패키지는 시스템이 arm64를 지원해야 합니다. 확실하지 않다면 범용 패키지를 고려하세요
기기 정보를 확인하고 설치 프로그램의 아키텍처 호환성 안내를 살펴보세요
운영체제 및 설치 권한
앱의 운영체제 요구 사항을 충족하고 APK 설치를 허용해야 합니다
운영체제 버전과 ‘출처를 알 수 없는 앱 설치’ 권한을 확인하세요
연결 및 백그라운드 실행
VPN 권한을 승인하고 클라이언트가 백그라운드에서 계속 실행되도록 허용해야 합니다
VPN 승인, 배터리 최적화, 다른 VPN 앱의 실행 상태를 확인하세요
‘설치할 수 없음’과 ‘설치 후 연결할 수 없음’은 서로 다른 단계의 문제입니다. 먼저 앱이 정상적으로 실행되는지 확인한 뒤 구독, 전송 설정, 네트워크 권한을 점검하세요.
Linux에서는 배포판의 패키지 관리 방식과 CPU 아키텍처를 모두 확인해야 합니다. DEB 기반 시스템은 보통 deb, RPM 기반 시스템은 보통 rpm을 선택합니다. 파일명에서 x64는 amd64 또는 x86_64, arm64는 aarch64로 표시될 수 있습니다. 확장자만으로 호환성을 판단하지 마세요. 패키지 의존성과 시스템 구성 요소의 버전도 설치 결과에 영향을 줍니다.
다운로드한 파일은 배포판의 소프트웨어 설치 프로그램이나 패키지 관리 도구로 열어 의존성과 설치 기록을 시스템이 처리하도록 하세요. 의존성을 충족하지 못한다는 안내가 나오면 누락된 항목과 버전 요구사항을 먼저 확인하세요. 의존성을 무시해 설치를 강행하거나 다른 배포판의 소프트웨어 저장소를 현재 시스템에 임의로 추가하지 마세요. 이 페이지의 클라이언트는 그래픽 데스크톱용이므로 사용 가능한 데스크톱 세션이 필요합니다. 원격 명령줄만 사용할 수 있는 시스템은 설치 대상이 아닙니다.
실행 후 구독을 가져오고 클라이언트의 로컬 수신 대기 설정과 데스크톱 환경의 프록시 설정을 확인하세요. 데스크톱 환경, 브라우저, 터미널 앱마다 시스템 프록시를 사용하는 방식이 다를 수 있으므로 클라이언트가 실행 중이라고 해서 모든 앱이 연결된 것은 아닙니다. 첫 연결 테스트는 시스템 프록시를 따르는 앱 하나로 진행하세요. TUN이 필요하다면 고급 문서를 참고해 권한, 라우팅, DNS 제어를 확인하고 처음부터 여러 네트워크 설정을 한꺼번에 변경하지 마세요.
Linux 설치 요구 사항
확인 항목
이 페이지의 설치 파일 요구 사항
확인 방법
패키지 관리 방식
배포판에 따라 deb 또는 rpm을 선택하세요
배포판 안내를 확인하고 시스템에 맞는 소프트웨어 설치 도구를 사용하세요
CPU 아키텍처
패키지에 포함된 구성 요소와 일치하는 x64 또는 arm64
시스템 정보를 확인해 amd64, x86_64, aarch64 표기를 구분하세요
데스크톱 및 의존성
사용 가능한 그래픽 데스크톱 세션과 패키지에 명시된 의존성이 필요합니다
소프트웨어 설치 프로그램의 안내를 읽고 그래픽 및 실행 환경 구성 요소를 확인하세요
패키지 형식이 같아도 모든 배포판에서 호환되는 것은 아닙니다. 같은 배포판 계열이라는 추정보다 설치 프로그램이 안내하는 의존성 요구 사항을 우선 확인하세요.
설치 후: 구독 가져오기 및 연결 준비
설치, 구독 가져오기, 트래픽 연결을 각각 확인하세요. 한 단계가 끝난 뒤 다음 단계로 진행합니다.
유효한 구독 또는 서버 정보 준비
클라이언트는 설정을 관리하고 연결을 처리하는 도구이며, 설치만으로 사용할 수 있는 서버가 자동으로 제공되지는 않습니다. 시작하기 전에 직접 확보한 유효한 구독 주소나 적법하게 사용할 수 있는 완전한 서버 정보를 준비하세요. 구독은 여러 설정을 하나의 업데이트 경로로 관리하는 방식이며, 수동으로 가져올 때는 주소·포트·프로토콜·전송 방식·보안 설정을 각각 확인해야 합니다. 어떤 방식을 사용하든 정보가 정확해야 하며 서버 주소 하나만 입력한다고 연결되는 것은 아닙니다.
구독 주소에는 보통 접속 토큰이 포함되므로 계정 정보처럼 안전하게 보관하세요. 그룹을 추가할 때 적는 이름은 로컬에서 구분하기 위한 것이므로 용도나 출처에 맞춰 지정하면 됩니다. 공개 스크린샷에는 전체 주소가 노출되지 않도록 하세요. 그룹을 가져온 뒤에는 업데이트를 실행해야 실제 설정을 불러옵니다. 업데이트 오류가 발생하면 설치 파일 손상을 의심하기 전에 복사한 내용, 구독 유효 기간, 현재 네트워크 연결 상태부터 확인하세요.
클립보드나 QR 코드로 가져올 때도 인식된 프로토콜과 전송 옵션을 확인하세요. 링크를 해석할 수 있어도 확장 필드가 현재 코어에서 지원된다는 보장은 없습니다. REALITY 등의 설정은 서버와 일치해야 하며 다른 설정의 값을 임의로 가져오면 안 됩니다. 용어가 낯설다면 먼저 REALITY 개념 안내를 읽고 서버에서 제공한 정보와 대조해 입력하세요.
서버 연결을 확인하기 전에 앱 트래픽이 연결되는지 확인하세요
데스크톱에서는 보통 시스템 프록시를 사용하고, Android에서는 VPN 모드로 트래픽을 받습니다. 시스템 프록시는 앱의 요청을 로컬 프록시로 전달하는 통로이고, 라우팅 모드는 전달된 요청을 어떤 출구로 보낼지 결정합니다. 서로 다른 단계의 설정입니다. 앱 트래픽이 전달되지 않으면 라우팅 모드만 바꿔도 클라이언트가 처리할 요청을 받지 못할 수 있습니다.
처음 사용할 때는 유효한 서버를 선택하고 트래픽 연결 방식을 켠 뒤 평소 사용하는 앱으로 확인하세요. DNS, TUN, 사용자 지정 아웃바운드, 복잡한 라우팅을 한꺼번에 변경하면 어느 단계에서 문제가 생겼는지 파악하기 어렵습니다. 정상적으로 접속되는 것을 확인한 뒤 필요한 라우팅 규칙을 조정하고 복구할 수 있도록 기본 설정을 저장하세요. 네트워크 설정은 배관과 비슷합니다. 먼저 각 구간이 연결됐는지 확인한 뒤 분기 구조를 추가하세요.
앱에서 네트워크에 연결되지 않으면 클라이언트 서비스가 실행 중인지, 로컬 포트를 다른 인스턴스가 사용하고 있지 않은지, 시스템 시간이 정확한지 확인하세요. 이어서 서버 정보와 구독이 아직 유효한지 살펴봅니다. 데스크톱의 브라우저, 명령줄 도구, 기타 앱은 서로 다른 프록시 방식을 사용할 수 있으므로 한 앱의 결과만으로 전체 네트워크 상태를 판단하지 마세요. 자세한 사용 방법은 빠른 시작 가이드를, 연결 문제는 연결 문제 해결을 참고하세요.
업그레이드 전에 백업하고, 클라이언트 간 이동 시 설정을 다시 확인하세요
업그레이드 전에 현재 설정을 저장하세요. 클라이언트의 백업 또는 내보내기 기능을 우선 사용하고, 구독 그룹·라우팅 예외·DNS 설정·로컬 수신 대기 포트·시작 옵션도 따로 기록하세요. 구독 주소만 보관해서는 사용자 지정 규칙을 모두 복구할 수 없습니다. 폴더 하나만 복사해도 시스템 프록시나 권한 설정까지 포함된다는 보장은 없습니다. 백업 파일에도 접속 정보가 들어갈 수 있으므로 안전한 위치에 보관하세요.
새 버전을 설치하기 전에 기존 인스턴스를 종료하세요. 특히 인터페이스 버전 간에 전환할 때는 기존 인스턴스의 프록시 제어가 중지됐는지 확인한 뒤 새 버전을 실행하고 설정이 제대로 불러와졌는지 살펴보세요. 새 인터페이스의 설정 형식이 다르다면 지원되는 가져오기 방법으로 옮기고, 용도를 알 수 없는 폴더를 그대로 덮어쓰지 마세요. 기존 백업을 보관한 채 구독 업데이트와 앱 접속을 확인한 다음 이전 파일을 정리하세요.
Android 클라이언트를 바꿀 때는 프로토콜 지원과 권한을 다시 확인해야 합니다. 구독 링크를 이전에 활용할 수 있지만 특정 코어에만 해당하는 전송 설정은 그대로 사용할 수 없을 수 있으며, 시스템 VPN 권한도 새로 승인해야 합니다. 데스크톱 플랫폼 간에 옮길 때는 파일 경로, 시스템 프록시 인터페이스, 권한 차이도 확인하세요. 업그레이드 후에는 실제 설정과 앱 접속을 검증해야 합니다. 설치 프로그램에 오류가 없었다는 것만으로 모든 작업이 끝난 것은 아닙니다.
다운로드 및 설치 자주 묻는 질문
먼저 패키지 종류를 확인한 뒤 권한과 설정을 점검하세요. 원래 오류 메시지를 보관하면 같은 시도를 반복하지 않고 문제를 파악하는 데 도움이 됩니다.
Windows에 처음 설치한다면 데스크톱 버전과 클래식 WPF 버전 중 무엇을 선택해야 하나요?
처음 사용한다면 새로운 크로스 플랫폼 인터페이스를 적용한 데스크톱 버전을 권장합니다. 클래식 WPF 버전은 익숙하고 안정적인 Windows 인터페이스를 유지해 기존 사용 방식에 익숙한 분에게 적합합니다. 두 버전은 메뉴 위치가 다를 수 있으므로 전환 전에 설정을 백업하고, 두 인스턴스가 동시에 시스템 프록시를 제어하지 않도록 하세요.
Android에서는 arm64와 범용 버전 중 무엇을 다운로드해야 하나요?
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 다만 실제 선택 기준은 기기의 운영체제가 지원하는 앱 아키텍처입니다. 구형 기기이거나 아키텍처를 확인하기 어렵다면 범용 버전을 선택할 수 있습니다. 운영체제 버전이 앱 요구사항을 충족하지 못하면 범용 패키지로 바꿔도 호환성 문제가 해결되지 않습니다.
클라이언트를 설치하면 바로 연결할 수 있나요?
클라이언트는 설정을 읽고 연결을 처리하는 프로그램이며, 설치 파일만으로 사용할 수 있는 서버 설정이 제공되지는 않습니다. 유효한 구독 주소나 완전한 서버 정보를 준비해 직접 가져와야 합니다. 구독을 업데이트하고 서버를 선택한 다음, 시스템 프록시를 설정하거나 Android VPN 권한을 허용하세요.
업그레이드할 때 구독과 라우팅 설정을 유지하려면 어떻게 해야 하나요?
먼저 현재 클라이언트의 백업 또는 내보내기 기능으로 설정을 저장하고, 라우팅·DNS·로컬 포트 정보도 따로 기록하세요. 기존 인스턴스를 종료한 뒤 업그레이드합니다. 인터페이스 버전이나 클라이언트를 바꿀 때는 새 버전이 지원하는 가져오기 방법을 사용하고, 용도를 알 수 없는 설정 폴더를 그대로 덮어쓰지 마세요.
파일명에 표시된 버전과 카드의 버전이 다르면 어떻게 해야 하나요?
카드의 버전 표시는 앱 버전 정보에서 가져오고, 다운로드 링크는 각 설치 파일의 별도 정보를 사용하므로 일시적으로 차이가 날 수 있습니다. 현재 설치 파일을 확인할 때는 다운로드한 파일명과 설치 후 클라이언트의 정보 화면을 함께 확인하세요. 다운로드 주소에 포함된 버전 번호를 임의로 수정하지 마세요.
다운로드에 실패하거나 설치 파일이 열리지 않을 때 먼저 확인할 사항은 무엇인가요?
먼저 다운로드가 완료됐는지와 디스크 여유 공간을 확인한 다음, 운영체제·CPU 아키텍처·패키지 형식이 맞는지 살펴보세요. Windows ZIP 파일은 먼저 압축을 풀어야 합니다. Android에서는 설치를 시작한 앱에 설치 권한을 허용해야 합니다. 문제가 계속되면 시스템 오류 메시지와 선택한 패키지 이름을 기록하고 설치·연결 문제 해결 안내를 확인하세요.