두 버전 모두 서버, 구독 그룹과 프록시 설정을 관리하며, 차이는 주로 인터페이스 프레임워크와 화면 구성에 있습니다. Desktop은 차세대 크로스 플랫폼 UI를 사용하고 WPF는 클래식 데스크톱 구성을 유지합니다. 화면만 바꾸려고 기존 설정을 삭제하지 마세요. 먼저 백업을 내보낸 다음 새 버전에서 구독, 라우팅과 로컬 수신 포트를 확인하세요.
다운로드한 압축 파일을 쓰기 권한이 있는 폴더에 풀고 안에 있는 설치 프로그램을 실행하세요. 압축 프로그램의 미리 보기에서 바로 실행하지 마세요. 처음 실행할 때 필요한 런타임이 없다는 안내가 나오면 설치 안내에 따라 해당 구성 요소를 추가하세요. 시스템 보안 경고가 표시되면 파일 출처와 앱 정보를 먼저 확인하고, 시스템 보호 기능을 전역으로 끄지 마세요.
설치 파일은 칩 아키텍처에 맞춰 선택하세요. 컴퓨터의 출시 연도나 모델명만으로 판단하지 마세요. 화면 왼쪽 위의 시스템 메뉴에서 ‘이 Mac에 관하여’를 여세요. ‘칩’에 Apple M 시리즈가 표시되면 ARM64를, Intel 프로세서가 표시되면 x64를 선택하세요. 기기에 맞는 버전을 사용하면 추가 호환 계층으로 인한 차이를 줄일 수 있습니다.
DMG를 연 뒤 앱을 ‘응용 프로그램’ 폴더로 드래그하고 해당 폴더에서 실행하세요. 마운트된 디스크 이미지에서 계속 실행하면 업데이트와 설정 저장 위치가 헷갈릴 수 있습니다. 시스템에서 실행을 차단한다는 메시지가 나오면 ‘개인정보 보호 및 보안’에서 구체적인 사유를 확인하세요. 출처를 확인한 뒤 시스템에서 제공하는 방법으로 처리하고, 출처가 불분명한 터미널 명령은 실행하지 마세요.
v2rayNG는 Xray 코어를 사용하며, Android 기기에서 구독을 가져오고 서버를 선택하거나 앱별 프록시를 설정할 수 있습니다. APK를 다운로드한 뒤 시스템 설치 프로그램으로 설치하세요. 권한이 필요하다면 현재 사용하는 브라우저나 파일 관리 앱에만 ‘알 수 없는 앱 설치 허용’을 일시적으로 켜고, 설치가 끝나면 권한을 다시 해제할 수 있습니다.
처음 연결을 시작하면 시스템 VPN 권한 대화상자가 표시됩니다. 승인해야 클라이언트가 해당 트래픽을 처리할 수 있습니다. 일반적으로 휴대전화에서 VPN 서비스를 두 개 동시에 사용할 수 없습니다. 다른 VPN, 업무용 프로필의 네트워크 정책 또는 VPN 인터페이스를 사용하는 필터링 앱이 있다면 먼저 충돌 여부를 확인하세요. 앱별 프록시는 적용할 앱의 범위만 바꾸며 서버 설정을 대신하지 않습니다.
v2flyNG는 V2Fly 코어를 기반으로 한 Android용 대안 클라이언트입니다. 화면 테마가 아니라 설정 요구 사항에 따라 선택하세요. 가져오기 방법이 비슷해도 프로토콜 매개변수와 확장 기능이 완전히 같지는 않습니다. 기존 설정에 특정 전송 방식이나 확장 옵션이 포함되어 있다면 옮기기 전에 클라이언트와 코어의 지원 여부를 확인하세요.
두 Android 클라이언트는 설정을 서로 별도로 저장합니다. 전환하기 전에 필요한 정보를 내보낸 뒤 새 클라이언트로 가져오고 라우팅, DNS와 적용할 앱 범위를 확인하세요. 테스트할 때는 다른 클라이언트의 연결을 먼저 끄세요. VPN 서비스 점유를 구독 오류로 오해할 수 있습니다. 내보낸 파일과 구독 링크는 안전하게 보관하세요.
패키지 형식과 CPU 아키텍처는 별도로 확인해야 합니다. Debian 및 Ubuntu 계열은 일반적으로 deb를 사용하고, rpm 패키지 관리자를 쓰는 배포판은 rpm을 선택하세요. 확장자가 같아도 시스템 라이브러리 버전까지 호환되는 것은 아닙니다. 특히 패키지가 현재 시스템보다 최신 런타임을 요구한다면 패키지 관리자의 오류를 확인해 의존성 문제를 해결하세요. 의존성을 무시하도록 강제해 설치하지 마세요.
다운로드한 패키지를 시스템 소프트웨어 설치 프로그램으로 열고 변경 사항을 확인한 뒤 설치 권한을 승인하세요. 설치가 끝나면 앱 메뉴에서 v2rayN을 실행하고 설정을 가져와 일반 프록시 연결부터 확인하세요. 시스템 프록시 지원은 데스크톱 환경마다 다릅니다. 일부 프로그램은 로컬 프록시 주소를 직접 설정해야 하므로 설치 완료가 모든 앱의 트래픽을 처리한다는 뜻은 아닙니다.
그래픽 앱을 실행할 수 있는 데스크톱 세션이 필요합니다. 이 페이지는 명령줄 전용 서비스 설치 안내가 아닙니다.
아키텍처 이름
amd64와 x86_64는 일반적으로 x64에 해당하고, arm64와 aarch64는 ARM64에 해당합니다. 시스템에 표시된 아키텍처를 확인하세요.
패키지 및 의존성
배포판에 맞는 deb 또는 rpm을 선택하고 시스템 패키지 관리자가 의존성을 처리하도록 하세요. 오래된 시스템은 현재 패키지의 실행 조건을 충족하지 못할 수 있습니다.
네트워크 권한
일반 프록시는 먼저 로컬 수신 상태를 확인하세요. TUN과 라우팅 변경에는 추가 권한이 필요합니다. 데스크톱 세션 전체를 항상 높은 권한으로 실행하지 않는 것이 좋습니다.
부팅 시 자동 실행을 설정하기 전에 수동 실행과 연결이 모두 정상인지 확인하세요. 자동 실행 실패와 서버 연결 실패는 따로 점검해야 합니다.
설치 후 확인 순서
설정 가져오기, 연결 및 업데이트
설치 파일은 클라이언트를 설치하는 역할만 합니다. 처음 실행했을 때 서버 목록이 비어 있는 것은 정상입니다. 이용 권한이 있는 구독 주소를 준비해 클라이언트의 구독 관리 메뉴에서 그룹을 만들고 이름과 전체 주소를 입력한 뒤 업데이트하세요. 구독 주소를 서버 주소 입력란에 넣거나 웹페이지의 설명까지 함께 복사하지 마세요. 업데이트 후에도 목록이 비어 있다면 로그를 확인해 주소 오류, 접속 실패, 형식 비호환 중 무엇인지 구분하세요.
먼저 연결 하나를 확인한 다음 분할 라우팅을 조정하세요
서버를 선택한 뒤 데스크톱에서는 시스템 프록시 설정을, Android에서는 VPN 권한을 먼저 확인하세요. 접속 가능한 것으로 확인된 웹페이지를 열어 연결을 테스트한 다음 다른 앱을 확인하세요. 시스템 프록시는 해당 설정을 사용하는 프로그램에만 프록시를 제공합니다. 브라우저는 연결되지만 터미널은 연결되지 않더라도 클라이언트 설치 실패라고 단정할 수 없습니다. 더 많은 앱의 트래픽을 처리해야 한다면 TUN 및 라우팅 설정 안내를 확인하고 한 번에 한 종류의 설정만 변경하세요.
라우팅, DNS와 앱 적용 범위는 요청이 전달되는 경로에 함께 영향을 줍니다. 연결 문제가 생기면 현재 모드와 로그의 오류를 기록한 다음 항목별로 설정을 되돌리거나 조정하세요. 설치 파일, 구독, DNS와 라우팅 모드를 한꺼번에 바꾸면 어떤 조치가 문제를 해결했는지 파악하기 어렵습니다. 클라이언트 실행, 구독 업데이트, 서버 연결은 각각 별도로 확인해야 합니다.
덮어쓰기 업데이트 전에 설정을 백업하세요
업데이트 전에 클라이언트의 백업 또는 내보내기 기능으로 구독 그룹, 사용자 지정 라우팅, DNS와 수신 포트를 기록하세요. 데스크톱에서는 시스템 트레이의 기존 프로세스를 종료한 뒤 설치하고, Android에서는 일반적으로 같은 서명으로 배포된 앱을 덮어쓸 수 있습니다. 서명 충돌 메시지가 나오면 기존 앱을 바로 삭제하지 마세요. 백업을 사용할 수 있는지 확인한 뒤 이전 방법을 결정하세요. 앱을 삭제하면 데이터도 함께 지워질 수 있습니다.
카드에 표시된 버전과 설치 파일 이름은 버전 정보의 서로 다른 항목에서 가져올 수 있어 배포 과정에서 동시에 갱신되지 않을 수 있습니다. 설치 후 실제 버전은 클라이언트의 ‘정보’ 또는 앱 정보 화면에서 확인하세요. 업데이트한 뒤 기존 구독과 라우팅이 유지됐는지 확인하고 연결을 테스트하세요. 정상 작동을 확인한 다음 이전 폴더나 설치 파일을 정리하세요.
다운로드 및 설치 관련 질문
설치 파일 자주 묻는 질문
먼저 운영체제, 아키텍처와 설치 방법을 확인하세요. 연결 설정은 사용 설명서에서, 추가 문제 해결 방법은 도움말 센터에서 확인할 수 있습니다.
클라이언트를 다운로드한 뒤에는 무엇을 준비해야 하나요?
클라이언트는 설정을 관리하고 연결을 시작하는 프로그램이며, 설치 파일에 바로 사용할 수 있는 서버가 포함되지는 않습니다. 이용 권한이 있는 구독 주소나 서버 설정을 준비해 가져온 다음, 구독을 업데이트하고 서버를 선택한 뒤 시스템 프록시 또는 VPN 모드를 설정하세요. 구독 주소에 접속 정보가 포함될 수 있으니 공개하지 마세요.
Windows Desktop 버전과 WPF 버전 중 무엇을 선택해야 하나요?
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 Desktop 버전을 먼저 고려해 보세요. 기존의 익숙한 화면 구성을 선호한다면 안정적인 클래식 WPF 버전을 선택할 수 있습니다. 두 버전 모두 x64 설치 파일입니다. 버전을 바꾸기 전 설정을 백업하고, 두 클라이언트가 같은 포트를 동시에 사용하지 않도록 하세요.
Android에서는 arm64와 범용 버전 중 무엇을 다운로드해야 하나요?
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 최종적으로는 운영체제가 지원하는 앱 아키텍처를 확인하세요. 아키텍처를 모르거나 arm64 설치 파일이 호환되지 않는다고 나오면 범용 버전을 시도할 수 있습니다. 기존 앱 패키지와 충돌한다는 안내가 뜨면 앱 출처와 서명 호환성을 먼저 확인하고, 기존 설정을 바로 삭제하지 마세요.
클라이언트를 업데이트하면 구독과 라우팅 설정이 삭제되나요?
같은 앱을 정상적으로 덮어쓰면 대개 설정이 유지되지만, 버전 차이와 설치 방식, 저장소 권한에 따라 설정 이전에 문제가 생길 수 있습니다. 업데이트 전에 클라이언트의 백업 또는 내보내기 기능으로 구독 그룹, 라우팅, DNS 설정을 보관하세요. 기존 프로세스를 종료한 뒤 설치하고, 연결이 정상인지 확인한 다음 이전 폴더를 정리하세요.
브라우저 다운로드가 중단되거나 설치 파일이 열리지 않으면 어떻게 하나요?
먼저 브라우저 다운로드 기록에서 작업이 완료됐는지, 디스크 공간이 충분한지 확인하세요. 네트워크가 끊겼다면 다시 다운로드하고, 확장자를 바꿔 억지로 열지 마세요. Windows ZIP 파일은 먼저 압축을 풀어야 합니다. macOS DMG는 연 뒤 앱을 응용 프로그램 폴더로 드래그하세요. Android APK는 시스템 설치 프로그램으로 설치하고, Linux에서는 배포판에 맞춰 deb 또는 rpm을 선택하세요.
설치는 완료됐는데 인터넷에 연결되지 않습니다. 설치 파일을 바꿔야 하나요?
계속 재설치하기보다 설정부터 확인하세요. 구독이 업데이트됐고 서버가 선택됐는지 확인한 다음, 시스템 프록시 또는 VPN 권한, 라우팅 모드와 DNS 설정을 점검하세요. 시스템 프록시는 해당 설정을 읽는 앱에만 적용됩니다. 터미널이나 일부 독립 실행형 프로그램은 프록시를 따로 설정해야 할 수 있습니다. 로그에 표시된 오류를 바탕으로 추가 점검을 진행하세요.
