클라이언트 / 설치 파일 / 아키텍처 선택
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 선택하세요. 운영체제와 CPU 아키텍처에 맞는 설치 파일을 받은 뒤 구독을 가져오고 프록시를 설정하면 됩니다.
하나의 데스크톱 클라이언트, 두 가지 인터페이스 버전입니다. 사용 방식에 맞춰 선택하세요.
Desktop 버전 / 클래식 WPF 버전
Desktop 버전은 새로운 크로스 플랫폼 UI를 사용하므로 처음 사용하는 사용자나 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하고 싶은 사용자에게 적합합니다. WPF 버전은 익숙한 데스크톱 레이아웃을 유지하는 클래식 안정 버전입니다. 기존 설정과 사용 방식에 익숙하다면 계속 이 버전을 선택할 수 있습니다.
다운로드 파일은 ZIP 압축 파일입니다. 파일 관리자에서 압축을 완전히 푼 다음 설치 프로그램을 실행하고 안내에 따라 설치하세요. 압축 파일 미리보기에서 바로 실행하지 마세요. 두 버전의 설치 경로는 별개이며, 같은 구독을 사용하기 위해 두 버전을 모두 실행할 필요는 없습니다.
설치 후 구독 가져오기 →처음 실행한 뒤 “구독 그룹”에서 기존 구독을 추가하고 업데이트하세요. 서버 목록이 표시되면 서버 하나를 선택해 실제 연결을 테스트하고 마지막으로 시스템 프록시를 설정하세요. 설치가 끝났다는 것은 프로그램이 실행된다는 뜻일 뿐, 브라우저 트래픽이 프록시를 통과한다는 의미는 아닙니다.
설치 프로그램에서 실행 환경이 없다고 안내하면 필요한 런타임 종류와 아키텍처를 확인하세요. 서로 다른 인터페이스 버전의 의존성을 혼동하지 마세요. 실행 후 로그에 수신 포트 사용 중이 표시되면 다른 프록시 클라이언트를 종료한 뒤 로컬 포트 설정을 확인하세요. 재설치만으로 포트 충돌이 해결되는 경우는 드뭅니다.
“이 Mac에 관하여”에서 칩 정보를 확인한 다음 해당 DMG를 선택하세요.
Apple Silicon / Intel
Apple 메뉴에서 “이 Mac에 관하여”를 여세요. Apple 칩 이름이 표시되면 Apple Silicon용 arm64 패키지를, Intel 프로세서가 표시되면 x64 패키지를 선택하세요. 파일 크기보다 아키텍처가 맞는지가 중요합니다. 파일명에 “64”가 있다는 이유로 Intel 버전을 선택할 필요는 없습니다.
다운로드한 DMG를 연 다음 앱을 “응용 프로그램” 폴더로 드래그하고 해당 폴더에서 실행하세요. 마운트된 디스크 이미지에서 계속 실행하면 이미지를 분리한 뒤 앱을 찾지 못하거나 업데이트 파일이 잘못된 위치에 저장될 수 있습니다.
데스크톱 설정 방법 보기 →시스템 보안 알림이 표시되면 먼저 다운로드 출처와 파일 아키텍처를 확인한 뒤 “시스템 설정 → 개인정보 보호 및 보안”의 안내를 확인하세요. 출처를 확인한 경우 Control 키를 누른 채 앱을 클릭하고 “열기”를 선택할 수 있습니다. 앱 하나를 실행하려고 시스템 보안 기능 전체를 끄거나 출처를 알 수 없는 파일에 우회 방법을 적용하지 마세요.
설정을 가져온 뒤 먼저 시스템 프록시로 기본 연결을 확인하고, 필요할 때 TUN을 사용하세요. 두 방식은 트래픽을 처리하는 범위와 필요한 권한이 다릅니다. 다른 네트워크 도구를 사용 중이라면 시스템 프록시와 라우팅을 중복 변경하지 않도록 하나를 종료한 뒤 테스트하세요. 클라이언트를 종료한 후에도 브라우저에서 인터넷에 연결되지 않으면 시스템 네트워크 설정에 수동 프록시가 남아 있는지 확인하세요.
먼저 v2rayNG를 선택하고, V2Fly 코어 호환성이 필요할 때 v2flyNG를 고려하세요.
Android · Xray 코어
2015년 이후 출시된 대부분의 스마트폰은 arm64 버전을 선택하면 됩니다. 단, 프로세서가 64비트를 지원하더라도 운영체제에서 64비트 앱 설치를 허용한다는 뜻은 아닙니다. 기기 아키텍처를 모르거나 arm64 패키지가 호환되지 않는다는 안내가 나오면 범용 버전을 시도해 보세요.
v2rayNG는 Xray 코어를 사용하며 모바일에서 구독 가져오기, 서버 선택, 앱별 프록시 설정을 할 수 있습니다. 처음 연결할 때 시스템 VPN 권한 대화상자가 표시되면 앱 이름을 확인한 후 허용하세요. 이 권한만으로 구독이나 서버가 제공되는 것은 아닙니다.
v2rayNG 구독 가져오기 안내 →Android · V2Fly 코어
V2Fly 코어가 필요하고 기존 설정이 해당 코어와 호환된다면 v2flyNG를 선택할 수 있습니다. v2rayNG와는 별개의 앱입니다. 이름과 인터페이스가 비슷해도 지원 프로토콜, 전송 옵션, 설정 동작이 모두 같은 것은 아닙니다.
다른 앱에서 옮길 때는 원본 구독이나 설정을 다시 가져온 뒤 라우팅, DNS, 앱별 프록시 설정을 확인하세요. 앱의 개인 데이터 폴더를 그대로 복사하지 마세요. 두 앱에 설정을 각각 보관할 수 있지만 연결을 테스트할 때는 한 앱만 VPN 연결을 설정해야 합니다.
시스템에서 앱을 설치할 수 없다고 안내하면 저장 공간과 시스템 호환성 알림을 확인한 뒤 같은 이름의 앱이 이미 설치되어 있는지 확인하세요. 배포 경로가 다른 앱은 서명이 달라 바로 덮어써서 업데이트할 수 없을 수 있습니다. 설정을 내보낼 수 있는지와 구독 출처, 사용자 설정을 저장했는지 확인하기 전에 앱을 삭제하고 다시 설치하지 마세요.
연결 후 화면을 잠근 상태로 시간이 지나면 연결이 끊기는 경우, 시스템의 배터리 최적화 및 백그라운드 실행 제한을 확인하세요. 백그라운드 실행을 계속 허용할지는 연결 필요성과 배터리 소모를 고려해 결정하세요. 일부 앱만 프록시를 통과시키려면 앱별 프록시로 적용 범위를 줄이고 대상 앱이 규칙에 포함되어 있는지 하나씩 확인하세요.
먼저 배포판의 패키지 형식을 확인한 다음 x64 또는 arm64를 선택하세요.
Linux 그래픽 데스크톱 클라이언트
Debian, Ubuntu 및 관련 파생 배포판은 보통 deb를 사용하고, Fedora, RHEL 계열 및 관련 파생 배포판은 보통 rpm을 사용합니다. 패키지 형식을 맞추는 것만으로 충분하지 않습니다. 배포판 버전, 데스크톱 환경, 시스템 의존성도 설치 결과에 영향을 줍니다.
패키지를 두 번 클릭한 뒤 시스템 그래픽 패키지 설치 프로그램에서 의존성과 호환성 안내를 확인하세요. 의존성을 해결할 수 없다는 안내가 나오면 의존성을 무시하고 설치를 강행하기보다 배포판 버전을 먼저 확인하세요. 이 페이지의 클라이언트는 그래픽 데스크톱 환경이 필요합니다.
TUN 모드 설정 알아보기 →클라이언트 실행 후 시스템 프록시가 대상 앱에 적용되는지는 데스크톱 환경과 앱이 시스템 프록시 설정을 사용하는지에 따라 다릅니다. 브라우저가 연결된다고 모든 프로그램의 트래픽이 프록시를 통과하는 것은 아닙니다. 먼저 프록시 설정을 명시적으로 지원하는 앱 하나로 확인한 뒤 필요에 따라 앱별 프록시 또는 TUN을 선택하세요.
TUN을 사용해야 한다면 권한 및 라우팅 안내를 먼저 읽고 현재 시스템에서 다른 도구가 네트워크 트래픽을 중복 처리하지 않는지 확인하세요. 그래픽 데스크톱 세션 전체를 항상 높은 권한으로 실행하지 마세요. 업데이트 후 시스템 프록시가 복원되지 않으면 클라이언트 상태와 데스크톱 네트워크 설정을 확인한 뒤 앱 자체의 프록시 설정도 점검하세요.
설치 파일부터 연결 확인까지
설치 파일은 프로그램 설치 문제를 해결하고, 실제 연결 동작은 구독, 라우팅, 프록시 모드에 따라 달라집니다. 각각 나눠 확인하면 문제를 더 쉽게 찾을 수 있습니다.
운영체제, CPU 아키텍처, 패키지 형식을 먼저 확인하세요. PC나 스마트폰의 제품명만으로 아키텍처를 알 수 없으며 같은 제품군에서도 프로세서가 다를 수 있습니다. 페이지의 조건은 패키지 선택 기준이지 모든 구형 시스템의 호환성을 보장하는 것은 아니므로 설치 프로그램의 안내도 확인하세요.
처음 사용하는 경우 이용 권한이 있는 구독 또는 서버 설정도 준비해야 합니다. 클라이언트와 구독 서비스는 별개입니다. 소프트웨어를 다운로드해도 네트워크 서비스가 제공되는 것은 아니며, 클라이언트를 업데이트해도 구독 기간이 자동으로 연장되지는 않습니다. 서비스 이용 가능 여부는 해당 설정 제공자에게 확인하세요.
구독 그룹, 라우팅 프리셋, DNS, 로컬 수신 포트, 앱별 프록시 규칙을 기록하세요. 가능하면 클라이언트의 내보내기 또는 백업 기능을 사용하세요. 폴더를 직접 백업하려면 데이터에 쓰기 작업이 진행되지 않도록 먼저 클라이언트를 종료하세요.
백업 파일에는 서버 인증 정보와 구독 접속 정보가 들어 있을 수 있으므로 본인이 관리하는 안전한 위치에 보관하세요. 업데이트 전에 기존 프로그램을 종료하고, 완료 후 서버 목록과 라우팅 상태를 확인한 다음 시스템 프록시 또는 TUN을 다시 설정하세요. 같은 수신 포트를 사용하는 구버전과 신버전을 동시에 실행하지 마세요.
구독을 추가한 뒤 한 번 업데이트하고 그룹 필터 때문에 서버가 숨겨져 있지 않은지 확인하세요. 서버를 선택해 실제 연결을 테스트한 다음 해당 프록시 모드를 활성화하세요. 테스트 결과는 그 시점의 연결 상태만 보여 주므로 대상 앱에서 실제로 접속되는지도 확인해야 합니다. 오류가 나면 로그에 표시된 구체적인 메시지부터 확인하세요.
추가 설정이 필요하면 먼저 빠른 시작에서 가져오기와 연결 방법을 확인하고, 라우팅, DNS, TUN은 고급 사용법을 참고하세요. 용어가 낯설다면 용어집을 확인하세요. 한 번에 한 종류의 설정만 변경하고 이전 값을 기록해 두면 쉽게 되돌릴 수 있습니다.
처음 설치한다면 새로운 크로스 플랫폼 인터페이스를 사용하는 Desktop 버전을 권장합니다. 기존의 클래식 창 레이아웃이 익숙하다면 안정적인 WPF 클래식 버전을 선택할 수 있습니다. 두 버전 모두 프록시 설정 관리용이며 함께 설치할 필요는 없습니다. 인터페이스 버전을 바꾸기 전 구독 그룹, 라우팅, 사용자 설정을 백업한 뒤 새 버전에서 지원하는 방식으로 가져오세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64 버전을 선택하면 됩니다. 다만 실제로 지원되는 앱 아키텍처를 기준으로 선택하세요. 범용 버전은 여러 아키텍처를 포함해 기기 아키텍처를 모르거나 arm64 설치에 실패했을 때 시도할 수 있지만, 파일 크기가 더 큰 편입니다. 설치에 실패하면 OS 버전, 저장 공간, 기존 앱과의 서명 호환성도 확인하세요.
클라이언트는 설정을 읽고 트래픽을 전달하는 프로그램이며, 설치 파일에 사용할 수 있는 서버가 포함되어 있지는 않습니다. 사용 권한이 있는 구독 주소나 서버 설정을 준비해 구독 그룹에 추가하고 업데이트하거나 클립보드에서 가져오세요. 구독 링크에는 접속 정보가 들어 있을 수 있으므로 링크 전체나 정보가 노출된 스크린샷을 공개하지 마세요.
먼저 설치 파일이 Mac의 칩 종류와 맞는지 확인하고 앱을 응용 프로그램 폴더로 옮기세요. 다운로드 출처를 확인한 다음 Finder에서 Control 키를 누른 채 앱을 클릭해 “열기”를 선택하거나 “시스템 설정”의 “개인정보 보호 및 보안” 알림을 확인할 수 있습니다. 앱 하나를 실행하려고 시스템 보안 기능 전체를 끄지 마세요. 오류가 계속되면 전체 알림 내용을 기록해 문제를 해결하세요.
구독 그룹, 현재 서버, 라우팅 프리셋, DNS, 사용자 규칙, 로컬 수신 포트를 기록하세요. 가능하면 현재 클라이언트의 내보내기 또는 백업 기능을 사용하세요. 백업 파일에는 민감한 설정이 들어 있을 수 있으므로 본인이 관리하는 안전한 위치에 보관하세요. 기존 클라이언트를 종료한 후 업데이트하고, 완료되면 시스템 프록시, TUN, 라우팅 상태를 다시 확인하세요.
업데이트 배포 중에는 페이지에 표시된 버전과 다운로드 파일명이 잠시 다를 수 있습니다. 파일명은 설치 파일을 식별하는 데 사용하고, 설치된 실제 버전은 클라이언트의 “정보” 또는 “업데이트 확인” 화면에서 확인하세요. 페이지의 버전 표시만으로 업그레이드 완료 여부를 판단하지 마세요. 기존 설정을 유지해야 한다면 먼저 백업한 뒤 새 버전의 마이그레이션 안내를 확인하세요.