두 다운로드 모두 ZIP 압축 파일입니다. 다운로드가 끝나면 먼저 압축을 푼 뒤, 폴더 안의 설치 프로그램과 안내에 따라 진행하세요. 압축 파일 미리보기 창에서 바로 실행하지 마세요.
Desktop은 차세대 크로스 플랫폼 UI입니다. 처음 설치한다면 이 버전으로 시작할 수 있습니다. 구독 그룹, 서버 선택, 설정은 모두 그래픽 인터페이스에서 관리합니다. WPF는 안정적인 클래식 버전입니다. 기존 레이아웃에 익숙하거나 클래식한 사용 방식을 이어가고 싶다면 WPF를 선택하세요. 두 버전은 서로 다른 구독 서비스가 아닙니다. 같은 구독을 사용할 수 있는지는 프로토콜과 현재 코어의 지원 여부에 따라 달라집니다.
다운로드하기 전에 「설정 → 시스템 → 시스템 정보」를 열어 시스템 종류를 확인하세요. 이 페이지의 Windows 다운로드는 모두 x64 패키지이므로 컴퓨터 외관만 보고 아키텍처를 판단해서는 안 됩니다. 설치 후 구독을 업데이트하고 서버와 라우팅 모드를 선택한 다음 시스템 프록시를 활성화하세요. 두 버전을 동시에 실행해 시스템 프록시를 변경하지 마세요. 한쪽을 종료할 때 다른 버전의 프록시 설정에도 영향을 줄 수 있습니다.
Windows 설치 조건
확인 항목
선택 및 준비
프로세서
x64 시스템 및 프로세서가 필요합니다. 시스템 정보에서 확인하고 x64 패키지를 다른 아키텍처의 기본 설치 파일로 사용하지 마세요.
시스템 환경
현재 릴리스 버전이 사용 중인 Windows 버전을 지원하는지 확인하세요. 런타임 구성 요소는 설치 프로그램의 안내에 따라 준비하면 됩니다.
디렉터리 권한
읽기와 쓰기가 가능한 위치에 압축을 풀고 설정 파일에 필요한 권한을 유지하세요. 업그레이드 전에는 실행 중인 클라이언트를 종료하세요.
프록시 권한
일반 시스템 프록시와 TUN은 필요한 권한이 다릅니다. TUN을 활성화하기 전에 클라이언트 안내에 따라 필요한 권한을 부여하세요.
M 시리즈 칩이면 Apple Silicon을, Intel 프로세서라면 x64를 선택하세요. 구입 연도만으로 칩 종류를 추측하지 마세요.
시스템 메뉴에서 「이 Mac에 관하여」를 여세요. 칩 항목에 M 시리즈 이름이 표시되면 arm64 패키지를, Intel 프로세서가 표시되면 x64 패키지를 다운로드하세요. 기본 아키텍처에 맞는 패키지를 선택하면 호환성 계층으로 인한 변수를 줄일 수 있습니다. 두 설치 파일은 같은 클라이언트의 아키텍처별 빌드이므로 한 컴퓨터에 둘 다 설치할 필요는 없습니다.
DMG를 연 뒤 창의 안내에 따라 앱을 「응용 프로그램」으로 옮기고 해당 위치에서 실행하세요. 처음 실행할 때 보안 안내가 표시되면 앱 출처와 다운로드 과정을 먼저 확인한 다음 시스템 설정에서 해당 앱에 적용할 수 있는 조치를 살펴보세요. 앱 하나를 실행하기 위해 시스템 전체의 보안 기능을 끄지 마세요. 실행 후 구독을 가져와 업데이트가 완료됐는지 확인하고 프록시를 설정하세요.
macOS 시스템 프록시는 일반적으로 네트워크 서비스별로 적용됩니다. Wi-Fi, 유선 연결 또는 다른 네트워크 환경으로 전환한 뒤 브라우저에서 예상한 프록시가 적용되지 않으면 현재 네트워크 서비스의 프록시 설정을 확인하세요. 클라이언트를 종료하기 전에 클라이언트가 설정한 시스템 프록시를 해제해야 로컬 프록시 포트가 닫힌 뒤에도 앱이 이전 포트에 계속 연결을 시도하는 상황을 막을 수 있습니다. 더 많은 앱의 트래픽을 처리해야 한다면 TUN 권한 및 라우팅 안내를 확인하세요.
macOS 설치 조건
확인 항목
선택 및 준비
프로세서
Apple Silicon은 arm64, Intel은 x64를 사용하세요. 「이 Mac에 관하여」에 표시된 정보를 기준으로 선택하세요.
시스템 호환성
설치 전에 현재 빌드가 요구하는 macOS 버전을 확인하세요. 오래된 시스템은 칩 패키지만 바꿔서는 호환성 문제를 해결할 수 없습니다.
앱 위치
앱을 「응용 프로그램」으로 옮긴 뒤 실행하세요. 마운트된 디스크 이미지에서 계속 실행하지 마세요.
네트워크 설정
필요한 네트워크 설정 변경을 허용하세요. 트래픽 처리 범위를 이해한 뒤에만 TUN을 활성화하세요.
Android 클라이언트
v2rayNG를 우선 사용하세요. 기존 V2Fly 설정이 있다면 필요에 따라 v2flyNG를 선택할 수 있습니다.
Xray 코어를 사용합니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 시스템의 64비트 앱 지원 여부를 확인하고, 확인하기 어렵다면 범용 버전을 선택하세요.
v2rayNG에서는 Android 그래픽 인터페이스에서 구독 업데이트, 설정 선택, 연결을 관리할 수 있습니다. 처음 설치한 뒤 APK를 설치하고 구독 설정을 열어 메모와 전체 구독 주소를 입력하세요. 저장한 다음 구독을 업데이트하고 구성 목록으로 돌아가 사용할 서버를 선택하세요. 주소를 붙여넣기만 하고 업데이트하지 않으면 연결할 수 있는 설정이 자동으로 생성되지 않습니다.
처음 연결할 때 시스템 VPN 권한 대화상자가 나타납니다. 승인해야 기기의 트래픽을 처리하는 로컬 연결이 만들어집니다. 이는 Android 클라이언트의 작동 방식일 뿐, 구독을 사용할 수 있다는 뜻은 아닙니다. 기기에서 다른 VPN 앱도 실행 중이라면 하나를 먼저 종료한 뒤 테스트하세요. 백그라운드에서 연결이 자주 끊긴다면 v2rayNG의 배터리 최적화 및 백그라운드 실행 제한을 확인하고, 지속 연결에 필요한 항목만 조정하세요.
v2fly 코어를 사용합니다. 이 대안 클라이언트를 선택하기 전에 구독의 프로토콜 및 전송 설정을 확인하세요.
v2flyNG는 V2Fly 코어 환경이 필요한 경우에 적합합니다. 클라이언트 이름이 비슷하다고 코어 기능까지 완전히 같은 것은 아닙니다. 구독에 최신 프로토콜, 전송 방식 또는 특정 확장이 포함되어 있다면 실제 코어의 지원 여부를 확인하세요. 연결 문제를 모두 해결하는 방법으로 클라이언트를 바꾸기보다는 업데이트 결과와 연결 로그부터 살펴보는 편이 좋습니다.
다른 클라이언트에서 옮길 때는 기존 구독 링크를 다시 추가한 다음 라우팅과 DNS 설정을 확인하세요. 두 앱의 데이터 디렉터리는 별개이므로 v2flyNG를 설치해도 다른 앱의 설정이 자동으로 모두 옮겨지지 않습니다. 비교 테스트가 필요하다면 기존 앱의 연결을 끊은 뒤 새 클라이언트에서 연결을 시작하세요. 두 VPN 세션이 서로 대체되어 서버 문제로 오인하는 일을 방지할 수 있습니다.
Android 설치 조건
확인 항목
선택 및 준비
앱 아키텍처
64비트 앱을 지원한다면 arm64를 우선 선택하세요. 아키텍처가 분명하지 않으면 범용 버전을 선택하고 프로세서 이름만으로 판단하지 마세요.
시스템 호환성
Android 버전은 해당 릴리스 빌드의 설치 요구 사항을 충족해야 합니다. 범용 버전은 아키텍처 선택을 돕기 위한 것으로, 모든 구형 시스템과 호환되는 것은 아닙니다.
설치 권한
시스템 안내에 따라 현재 브라우저나 파일 관리자가 앱을 설치하도록 허용하세요. 설치가 끝나면 해당 출처의 설치 권한을 다시 끌 수 있습니다.
연결 권한
처음 연결을 시작할 때 시스템 VPN 권한을 승인하세요. 지속적으로 실행해야 한다면 백그라운드 및 배터리 관리 설정을 확인하세요.
Linux 클라이언트
배포판에 맞는 deb 또는 rpm을 선택한 다음 x64와 arm64 중 올바른 아키텍처를 확인하세요.
deb는 Debian 및 Ubuntu 계열, rpm은 Fedora 및 RHEL 계열에서 주로 사용합니다. 패키지 형식이 맞는지 확인한 다음 배포판 버전과 종속성의 호환성도 확인하세요.
먼저 시스템 정보에서 배포판 이름과 CPU 아키텍처를 확인하세요. 일반적으로 amd64와 x86_64는 이 페이지의 x64에 해당하고, aarch64는 arm64에 해당합니다. 데스크톱이나 개발 보드라는 이유만으로 아키텍처를 판단하지 마세요. 다운로드 후 배포판의 소프트웨어 설치 프로그램으로 패키지를 열어 종속성을 처리하세요. 라이브러리 버전이 맞지 않는다는 안내가 나오면 빌드가 대상으로 하는 배포판을 먼저 확인하고 종속성 경고를 무시하지 마세요.
Linux 데스크톱 환경마다 시스템 프록시가 적용되는 범위가 다릅니다. 프록시를 설정하면 브라우저는 데스크톱 프록시를 사용할 수 있지만, 일부 터미널 도구나 독립 실행형 앱은 자체 네트워크 설정을 계속 사용할 수 있습니다. 따라서 설치 성공, 인터페이스가 정상적으로 열리는 것, 모든 앱이 프록시를 이용하는 것은 각각 따로 확인해야 합니다. 먼저 시스템 프록시를 따르는 앱 하나로 테스트한 다음 추가 설정이 필요한지 판단하세요.
TUN이 필요하다면 문서에서 가상 네트워크 인터페이스 권한, 라우팅 및 DNS 설정을 확인하세요. 처음부터 데스크톱 프록시, 네트워크 관리 서비스, 방화벽 규칙을 한꺼번에 변경하지 마세요. 복원할 수 있는 기본 상태를 유지하고 기능을 하나씩 활성화하세요. 업그레이드 전에 기존 프로세스를 종료하고 설정을 백업하면 패키지 관리자가 업데이트를 마친 뒤에도 이전 프로세스가 로컬 포트를 점유하는 상황을 막을 수 있습니다.
Linux 설치 조건
확인 항목
선택 및 준비
패키지 형식
배포판에 맞춰 deb 또는 rpm을 선택하세요. 파일 확장자를 바꿔 패키지 형식을 변환하지 마세요.
CPU 아키텍처
x64는 amd64 또는 x86_64 빌드, arm64는 arm64 또는 aarch64 빌드를 사용하세요.
데스크톱 및 종속성
사용 가능한 그래픽 데스크톱과 현재 빌드에 필요한 종속성이 있어야 합니다. 누락된 항목은 시스템 설치 프로그램의 안내에서 확인하세요.
네트워크 권한
일반 데스크톱 프록시와 TUN은 별도로 설정하세요. TUN에 필요한 권한은 클라이언트와 배포판의 요구 사항에 따라 처리하세요.
설치 후
설치 파일에서 구독 연결까지
클라이언트를 설치한 뒤에도 구독, 서버 선택, 프록시 설정이 필요합니다. 순서대로 진행하면 문제가 발생한 단계를 찾기 쉽습니다.
업그레이드 전에 설정 백업
업그레이드하기 전에 현재 클라이언트의 구독 그룹, 라우팅 모드, 로컬 수신 포트를 기록하세요. 사용자 지정 라우팅, 직접 추가한 서버, 인터페이스 설정은 구독 링크에 포함되지 않을 수 있습니다. 구독 주소만 저장하는 것으로 전체 설정 백업을 대신할 수는 없습니다. 클라이언트의 내보내기 기능을 사용하거나 문서에 따라 설정 디렉터리를 백업하고, 본인만 접근할 수 있는 위치에 보관하세요. 백업한 뒤 이전 클라이언트를 종료하고 새 버전을 설치하거나 실행하세요.
처음 사용할 때 설치를 마치기 위해 고급 설정을 대거 변경할 필요는 없습니다. 다른 네트워크 도구와 포트가 충돌하지 않도록 기본 로컬 수신 설정을 유지하세요. 포트가 이미 사용 중이라는 안내가 나오면 이전 프로세스가 시스템 트레이나 백그라운드에 남아 있는지 확인하세요. 여러 인스턴스를 연달아 실행해 해결하려 하지 마세요. 설치 방식이 크게 바뀌는 경우 기존 설정을 백업해 두고 새 버전이 정상적으로 시작된 뒤 이전 디렉터리를 정리하세요.
구독을 가져온 뒤 업데이트 결과 확인
구독 그룹 설정을 열고 알아보기 쉬운 메모와 전체 주소를 입력하세요. 복사 과정에서 공백이나 줄바꿈이 섞이지 않았는지 확인하고 주소의 매개변수는 삭제하지 마세요. 저장은 업데이트할 구독 주소를 등록하는 단계일 뿐입니다. 서버 설정을 가져오려면 구독을 직접 업데이트해야 합니다. 업데이트에 실패하면 클라이언트 안내에서 주소에 접근할 수 없는 문제, 콘텐츠 형식 불일치, 계정 상태 문제를 구분하세요. 관련 없는 클라이언트를 반복해서 재설치하지 마세요.
구독 주소에는 대개 접속 인증 정보가 포함되므로 계정 정보처럼 안전하게 보관하세요. 다른 사람에게 문제를 문의할 때는 주소 매개변수, 계정 식별 정보 및 민감한 내용을 가리고 오류 유형과 필요한 환경 정보만 남기세요. 클라이언트가 무료라는 것과 구독 서비스의 요금은 별개입니다. 소프트웨어를 설치해도 서비스 계정이 만들어지거나 사용할 수 있는 서버가 자동으로 제공되지는 않습니다.
마지막으로 프록시 적용 범위와 라우팅 모드 확인
서버를 선택한 뒤 시스템 프록시 또는 Android 연결을 활성화하세요. 데스크톱의 시스템 프록시는 해당 설정을 사용하는 앱에만 영향을 주므로 기기의 모든 트래픽이 처리되는 것은 아닙니다. 라우팅 모드는 클라이언트로 들어온 요청을 직접 연결, 프록시 또는 차단 중 어떤 방식으로 처리할지 결정합니다. 일부 웹사이트나 앱만 작동하지 않는다면 요청이 클라이언트에 도달했는지 먼저 확인하고 규칙 적용 결과를 살펴보세요. 모든 문제를 구독 탓으로 돌리지 마세요.
TUN이 필요하다면 권한 및 DNS 안내를 먼저 읽으세요. TUN은 더 넓은 범위의 트래픽을 처리하지만, 만료되거나 작동하지 않는 구독을 복구하지 못하며 올바른 라우팅 규칙을 대신할 수도 없습니다. 확인 과정에서는 한 번에 설정 하나만 바꾸고 전후 결과를 기록하세요. 문제가 생기면 방금 변경한 설정을 되돌리는 편이 클라이언트를 계속 바꾸는 것보다 원인을 찾기 쉽습니다.
처음 사용한다면 차세대 크로스 플랫폼 인터페이스를 적용한 Desktop 버전을 선택하세요. WPF는 익숙한 클래식 인터페이스를 선호하는 사용자에게 적합한 안정적인 기존 버전입니다. 둘 다 v2rayN이므로 동시에 실행해 같은 시스템 프록시를 제어하지 마세요. 전환하기 전에 설정을 백업하세요.
Android에서는 arm64와 범용 버전 중 무엇을 다운로드해야 하나요?
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 다만 시스템에서 64비트 앱을 실행할 수 있는지 확인하세요. 아키텍처를 모르거나 arm64 설치 시 호환되지 않는다는 안내가 표시되면 범용 버전을 선택하세요. 범용 버전은 여러 아키텍처 구성 요소를 포함해 파일 크기가 더 클 수 있지만, 연결 속도가 더 빠르다는 뜻은 아닙니다.
클라이언트를 다운로드하면 구독 링크도 자동으로 제공되나요?
클라이언트는 설정을 관리하고 연결을 시작하는 도구이며, 설치 파일 자체가 구독 서비스는 아닙니다. 사용 권한이 있는 구독 링크를 준비해 구독 그룹에 추가한 다음 구독을 업데이트하세요. 구독 주소에는 접속 인증 정보가 포함될 수 있으므로 공개하지 마세요.
클라이언트를 업그레이드할 때 이전 버전을 삭제해야 하나요?
먼저 이전 버전을 종료하고 구독 그룹, 라우팅 규칙 및 기타 설정을 백업하세요. 기존 버전을 바로 덮어쓸 수 있는지는 설치 방식과 이전·새 버전의 마이그레이션 요구 사항에 따라 다르므로 항상 가능하다고 가정하지 마세요. 설치 방식이나 인터페이스 버전을 변경한다면 별도 디렉터리를 사용하고 새 버전의 안내에 따라 설정을 가져오는 것이 좋습니다.
페이지에 표시된 버전과 설치 파일 이름이 다른 이유는 무엇인가요?
페이지의 버전 표시와 설치 파일 경로는 버전 목록에서 별도로 관리되는 항목이므로 일시적으로 서로 다를 수 있습니다. 다운로드 주소의 버전 번호를 직접 수정하지 마세요. 설치 후 클라이언트의 정보 화면에서 실제 버전을 확인하고 필요한 기능에 따라 업데이트 여부를 판단하세요.
설치했는데도 웹페이지가 열리지 않으면 무엇을 확인해야 하나요?
먼저 구독을 업데이트했는지, 사용할 수 있는 서버를 선택했는지 확인한 다음 시스템 프록시 또는 Android VPN 연결이 활성화되어 있는지 살펴보세요. 데스크톱에서 시스템 프록시만 설정하면 일부 앱은 해당 설정을 사용하지 않을 수 있습니다. 더 많은 트래픽을 처리해야 한다면 TUN 문서를 확인하세요. 문제를 점검하는 동안 프록시 클라이언트는 하나만 실행하고 로그를 보며 항목별로 확인하세요.
