Desktop 버전은 차세대 크로스 플랫폼 UI를 사용하며, 새로 설치하거나 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하고 싶은 분에게 적합합니다. 클래식 WPF 버전은 기존 Windows 인터페이스를 유지하는 안정 버전으로, 기존 메뉴와 설정 위치에 익숙한 분에게 알맞습니다. 인터페이스 버전의 차이는 서버 품질이나 프로토콜 속도 등급을 의미하지 않습니다.
위 다운로드 파일은 ZIP 압축 파일입니다. 다운로드가 완료되면 압축을 완전히 푼 다음 안에 있는 설치 프로그램을 실행하세요. 압축 프로그램의 미리보기에서 바로 실행하지 마세요. 설치 중 실행 구성 요소가 없다는 알림이 표시되면 구성 요소 이름, 아키텍처, 필요한 버전을 확인한 뒤 시스템 안내에 따라 설치하세요. 설치 오류를 해결하려고 구독을 반복해서 바꾸지 마세요.
인터페이스 버전을 바꾸려면 먼저 구독과 사용자 지정 라우팅 규칙을 내보내고, 실행 중인 기존 클라이언트를 종료한 뒤 새 버전을 열어 설정을 확인하세요. 두 인스턴스가 같은 로컬 포트를 사용하면 나중에 실행한 쪽에서 수신 대기 오류가 발생할 수 있습니다. 설치가 끝난 뒤 안내에 따라 시스템 프록시를 활성화하고 사용 환경에 맞는 라우팅 모드를 선택하세요.
Apple Silicon 프로세서는 arm64, Intel 프로세서는 x64를 선택하세요. Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. Apple M 시리즈 칩이 표시되면 첫 번째 항목을, 프로세서에 Intel이라고 표시되면 두 번째 항목을 선택하면 됩니다. 시스템 버전과 칩 아키텍처는 별개입니다. 시스템을 업데이트해도 Intel 기기가 arm64 기기로 바뀌지는 않습니다.
DMG 파일을 다운로드한 뒤 디스크 이미지를 열고, 설치 안내에 따라 앱을 ‘응용 프로그램’ 폴더에 넣은 다음 해당 폴더에서 실행하세요. 처음 실행할 때 시스템 보안 알림이 표시되면 파일 출처와 알림 내용을 확인한 뒤 시스템의 보안 설정에서 처리하세요. 알림 하나를 건너뛰려고 시스템 보안 기능 전체를 끄지 마세요.
다른 데스크톱 운영체제에서 옮겨오는 경우 구독 주소를 먼저 이전한 다음 라우팅과 DNS 설정을 하나씩 복원하는 편이 좋습니다. 파일 경로, 권한, 시스템 프록시 인터페이스는 운영체제마다 다르므로 기존 설정 디렉터리 전체를 그대로 덮어쓰지 마세요. 연결하기 전에 클라이언트 코어가 실행 중인지 확인하고, 필요한 시스템 프록시 방식을 활성화하세요. 테스트가 끝나면 종료할 때 프록시 설정이 원래대로 복구됐는지도 확인하세요.
v2rayNG는 Xray 코어를 사용하는 Android GUI 클라이언트입니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택하면 됩니다. 다만 실제 호환 여부는 프로세서와 시스템에서 지원하는 앱 아키텍처에 따라 달라집니다. 일부 보급형 기기는 프로세서가 64비트를 지원해도 시스템에서 32비트 앱 환경만 제공할 수 있습니다. 확인하기 어렵다면 더 많은 아키텍처를 지원하는 범용 버전을 선택하세요. 설치 파일은 일반적으로 더 큽니다.
APK를 열면 브라우저나 파일 관리자에서 앱 설치 권한을 허용하라는 메시지가 표시될 수 있습니다. 현재 설치에 필요한 권한만 허용하고, 다른 출처의 권한을 불필요하게 확대하지 마세요. 처음 연결할 때 Android에서 VPN 연결 권한을 요청합니다. 클라이언트가 기기의 VPN 인터페이스로 트래픽을 처리하기 위한 시스템 절차이므로 안내를 읽고 승인하세요.
설치가 끝나면 구독을 가져와 설정을 업데이트하고 서버를 선택한 뒤 연결을 시작하세요. 휴대전화 상태 표시줄의 VPN 아이콘은 기기의 인터페이스가 설정됐다는 뜻일 뿐입니다. 실제로 연결되는지 대상 앱에서 확인하세요. 연결이 한동안 유지되다가 끊기면 설정을 모두 삭제하기 전에 배터리 최적화와 백그라운드 제한을 확인하세요.
v2flyNG는 v2fly 코어를 사용하며, 기존 V2Fly 설정 환경을 위한 대안으로 적합합니다. v2rayNG와 이름은 비슷하지만 같은 앱의 테마만 다른 것은 아닙니다. 코어가 지원하는 프로토콜, 전송 방식, 설정 항목이 다를 수 있습니다. 특히 Xray 확장 기능을 사용하는 설정이 다른 환경에서도 그대로 작동한다고 가정하지 마세요.
구독 제공자가 특정 코어 기능을 요구한다면 프로토콜 요건을 먼저 확인한 뒤 클라이언트를 선택하세요. 앱을 바꿀 때는 다른 앱의 내부 데이터를 통째로 복사하지 말고 구독을 새로 가져오는 편이 좋습니다. 두 클라이언트를 비교 테스트할 때는 시스템 연결이 전환되어 결과가 뒤섞이지 않도록 한쪽의 VPN 연결을 먼저 중지하세요.
Debian·Ubuntu 계열 배포판에서는 보통 deb를, RPM 패키지 관리 체계를 사용하는 배포판에서는 rpm을 선택합니다. 하지만 패키지 형식이 맞아도 모든 배포판과 호환되는 것은 아닙니다. 현재 패키지가 요구하는 시스템 라이브러리와 의존성도 충족해야 합니다. 특히 RPM 패키지는 설치 전에 설치 도구가 표시하는 배포 환경과 의존성 안내를 확인하고, 의존성을 강제로 무시하지 않는 것이 좋습니다.
일반적인 Intel·AMD 데스크톱 PC는 패키지명에 amd64 또는 x86_64로 표시된 x64를 선택하세요. 64비트 ARM 데스크톱 기기는 arm64 또는 aarch64 패키지를 사용합니다. amd64는 아키텍처 이름이며 AMD 브랜드 프로세서에서만 실행된다는 뜻은 아닙니다. 배포판 이름만 보고 프로세서 종류를 추측하지 말고 시스템의 정보 또는 하드웨어 정보에서 확인하세요.
다운로드한 패키지를 시스템의 그래픽 소프트웨어 설치 도구에서 열고 의존성 안내를 확인한 뒤 설치하세요. 이 설치 파일은 그래픽 데스크톱 환경용입니다. 라우터나 순수 명령줄 서버에 배포할 때 사용할 패키지는 아닙니다. 처음 실행한 뒤 설정을 가져오고 로컬 수신이 정상인지 확인한 다음 시스템 또는 앱 프록시를 설정하세요.
데스크톱 환경에 따라 시스템 프록시 지원 방식이 다릅니다. 브라우저에서는 연결되는데 다른 앱이 계속 직접 연결된다면 해당 앱이 데스크톱 프록시 설정을 사용하는지 확인하세요. 로컬 프록시 주소를 앱에 직접 지정해야 한다면 클라이언트에 표시된 수신 주소, 포트, 프로토콜을 입력하세요. SOCKS 포트를 HTTP 포트로 사용하지 마세요.
유효한 구독 주소를 준비한 뒤 클라이언트에 구독 그룹을 추가하고 업데이트하세요. 단일 연결 공유 주소를 받았다면 구독 업데이트 주소에 넣지 말고 해당 주소를 가져오는 기능을 사용하세요. 가져온 뒤 서버 설정이 표시되는지 확인하고 하나를 선택해 연결을 시작하세요. 구독 주소에는 로그인 정보가 포함되는 경우가 많으므로 문제를 문의할 때 전체 주소를 공개하지 말고 오류 내용만 공유하세요.
실행, 프록시, 라우팅을 구분하세요
클라이언트 기본 창이 열렸다는 것은 GUI가 실행됐다는 뜻일 뿐입니다. 이어서 코어와 로컬 수신이 정상적으로 시작됐는지 확인하고, 시스템 프록시 또는 Android VPN이 활성화됐는지 살펴본 뒤 라우팅 모드를 확인하세요. 설정은 한 번에 하나씩 바꾸고, 변경할 때마다 바로 확인하세요. 코어, DNS, 라우팅을 동시에 변경하면 원인을 찾기 어려워집니다.
업그레이드 전에 복원 가능한 설정을 보관하세요
기존 클라이언트를 사용 중이라면 현재 버전 계열, 구독 그룹, 사용자 지정 규칙을 기록한 뒤 앱의 내보내기 기능으로 설정을 저장하세요. 클라이언트 간 이전 시에는 전체 내부 설정보다 구독 주소를 옮기는 편이 간편한 경우가 많지만, 대상 코어가 해당 프로토콜을 지원하는지 확인해야 합니다. 로컬 경로, 수신 포트, 권한 설정은 새 시스템에 맞게 다시 점검하세요.
유효한 구독 주소나 서버 연결 정보가 필요합니다. 클라이언트에서 설정을 가져오고 라우팅을 선택해 연결할 수 있지만, 설치 파일에는 사용할 수 있는 서버가 포함되어 있지 않습니다. 구독 출처와 사용 권한을 확인한 뒤 안내에 따라 가져오세요. 구독 주소를 공개된 페이지에 게시하지 마세요.
Windows 데스크톱 버전과 클래식 WPF 버전, 무엇을 선택해야 하나요?
새로 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 Desktop 버전을 먼저 고려해 보세요. 기존 Windows 인터페이스와 메뉴에 익숙하다면 클래식 WPF 안정 버전이 적합합니다. 두 버전은 인터페이스 계열의 차이일 뿐 연결 속도 등급이 아닙니다. 전환하기 전에 설정을 내보내고, 로컬 수신 포트를 두 인스턴스가 동시에 사용하지 않도록 하세요.
Android에서는 arm64와 범용 버전 중 무엇을 다운로드해야 하나요?
2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택하면 됩니다. 다만 구형 기기나 32비트 앱 환경만 제공하는 시스템에서는 호환되지 않을 수 있습니다. 기기의 프로세서와 시스템 아키텍처를 확인하고, 알기 어렵거나 아키텍처 호환 오류가 표시되면 범용 버전을 선택하세요. 범용 버전은 더 많은 아키텍처를 지원하는 대신 설치 파일이 더 클 수 있습니다.
화면에 표시된 버전과 다운로드 파일명이 다르면 어떻게 확인하나요?
카드의 버전 표시는 목록의 latest 필드를, 다운로드 버튼은 해당 플랫폼의 파일 주소를 사용합니다. 서로 별개의 정보이므로 업데이트 시점이 다를 수 있습니다. 파일명만으로 버전을 일괄 변경해 판단하지 마세요. 설치하거나 업그레이드한 뒤 실제 설치 화면이나 클라이언트의 정보 페이지에 표시된 버전을 확인하세요.
클라이언트를 업데이트해도 구독과 라우팅 설정이 유지되나요?
같은 클라이언트의 같은 버전 계열에서 덮어쓰기로 업데이트하면 기존 사용자 데이터가 유지되는 경우가 많습니다. 하지만 버전 계열이나 코어를 바꾸거나 설정 디렉터리를 변경할 때는 호환된다고 단정할 수 없습니다. 업데이트 전에 클라이언트에서 설정을 내보내거나 사용자 데이터를 백업하고, 이전 프로세스를 종료한 뒤 설치하세요. 처음 실행한 다음 구독 그룹, 라우팅 모드, 로컬 포트를 확인하세요.
다운로드한 파일이 설치되지 않을 때 먼저 확인할 항목은 무엇인가요?
파일이 완전히 다운로드됐는지, 프로세서 아키텍처가 맞는지, 시스템이 배포판의 실행 요건을 충족하는지 먼저 확인하세요. Windows ZIP 파일은 압축을 완전히 풀어야 합니다. macOS는 칩 종류와 시스템 보안 알림을, Android는 설치 권한과 기존 앱의 서명 관련 알림을 확인하세요. Linux에서는 패키지 형식과 의존성 오류를 살펴보세요. 시스템에 표시된 오류 문구를 그대로 기록한 뒤 안내에 따라 원인을 찾으세요.
