클라이언트 설치 파일 / 운영체제 및 아키텍처 선택
먼저 운영체제를 선택한 다음 설치 파일을 고르세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 권장하며 v2flyNG도 대안으로 사용할 수 있습니다.
기존 설정이 있나요? 업데이트 전에 백업하세요. 처음 설치하나요? 다운로드한 뒤 빠른 시작 가이드 →를 확인하세요.
두 다운로드 모두 x64 ZIP 파일입니다. 처음 설치한다면 데스크톱판을, WPF 사용에 익숙하다면 클래식판을 선택하세요.
차세대 크로스 플랫폼 UI를 제공합니다. 처음 사용하거나 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하고 싶은 분에게 적합합니다.
데스크톱판 다운로드 · x64 ZIP 압축 파일 · 다운로드 후 압축 해제익숙한 Windows 데스크톱 레이아웃을 유지하는 안정적인 클래식 버전입니다. 기존 사용 방식과 설정 절차를 이어가고 싶은 분에게 적합합니다.
WPF판 다운로드 · x64 ZIP 압축 파일 · 별도 폴더에 설치두 버전은 화면 구성, 실행 환경, 일부 기능의 위치가 다를 수 있습니다. 기존 설정이 있다면 먼저 백업한 뒤 선택한 버전의 가져오기 방식에 따라 옮기세요. 두 프로그램의 파일을 한 폴더에 섞거나, 인터페이스를 바꾸기 위해 기존 폴더에 덮어쓰지 마세요.
| 확인 항목 | 선택 및 작업 |
|---|---|
| 운영체제 및 아키텍처 | Windows x64용입니다. “설정 → 시스템 → 정보”에서 시스템 종류를 확인하세요. 지원 범위는 현재 패키지 안내를 따릅니다. |
| 실행 환경 | 버전에 따라 필요한 .NET 데스크톱 런타임이 다를 수 있습니다. 실행 중 구성 요소가 없다는 안내가 나오면 필요한 아키텍처와 종류를 확인하세요. |
| 폴더 및 권한 | ZIP 파일을 쓰기 가능한 폴더에 완전히 압축 해제한 뒤 프로그램을 실행하세요. 압축 프로그램 안에서 바로 실행하거나 접근이 제한된 시스템 폴더에 두지 마세요. |
| 초기 설정 | 유효한 구독이나 설정을 준비하고 로컬 포트가 사용 중인지 확인하세요. 일반 시스템 프록시가 작동하는지 확인한 다음 필요할 때 TUN을 활성화하세요. |
처음 실행할 때는 프로그램의 기본 창이 정상적으로 표시되는지 먼저 확인하세요. 라우팅, 포트, 코어 설정을 서둘러 바꾸지 마세요. 설정을 저장할 수 없다는 안내가 나오면 압축 해제 폴더의 권한과 보안 프로그램의 차단 기록을 확인하세요. 관리자 권한이 필요한 기능에만 해당 권한을 사용하고, 모든 실행 문제를 권한 부족으로 단정하지 마세요.
기존 클라이언트를 종료한 뒤 새 프로그램을 실행하면 포트 충돌이나 시스템 프록시 설정의 반복 변경을 줄일 수 있습니다. 자세한 절차는 Windows 설치 및 설정 전체 과정에서 확인하세요. 압축 해제, 실행, 가져오기, 시스템 프록시 활성화 순으로 설정하면 됩니다.
먼저 “이 Mac에 관하여”에서 칩을 확인하세요. Apple M 시리즈라면 Apple Silicon용을, Intel 프로세서라면 Intel용을 선택하세요.
Apple M 시리즈 칩에 적합합니다. 프로세서에 맞는 arm64 패키지를 우선 선택하고, 변환 실행을 기본 설치 방식으로 삼지 마세요.
Apple Silicon 버전 다운로드 DMG 디스크 이미지 · arm64Intel 프로세서가 탑재된 Mac용입니다. 구입 연도만으로 판단하지 말고 시스템에 표시된 프로세서 정보를 확인하세요.
Intel 버전 다운로드 DMG 디스크 이미지 · x64디스크 이미지를 연 뒤 설치 안내에 따라 앱을 “응용 프로그램” 폴더로 옮기고 그 위치에서 실행하세요. 기존 앱을 업데이트할 때는 실행 중인 앱을 종료하고 기존 설정을 백업하세요. 마운트된 디스크 이미지에서 앱을 계속 실행하지 마세요.
| 확인 항목 | 선택 및 작업 |
|---|---|
| 칩 아키텍처 | Apple M 시리즈는 arm64, Intel은 x64를 사용합니다. 시스템 메뉴의 “이 Mac에 관하여”에서 확인하세요. |
| 시스템 호환성 | 현재 운영체제가 설치 파일의 요구 사항을 충족하는지 확인하세요. 구형 시스템에서 실행되지 않으면 먼저 구체적인 호환성 안내를 살펴보세요. |
| 앱 위치 | 앱을 “응용 프로그램” 폴더에 설치하고 해당 위치에서 실행하세요. 업데이트할 때는 기존 프로세스를 종료한 뒤 앱을 교체하세요. |
| 네트워크 권한 | 필요한 경우 네트워크 관련 작업을 허용하세요. 시스템 프록시나 TUN 권한을 요청하면 출처와 용도를 확인한 다음 승인하세요. |
보안 경고가 표시되면 먼저 구체적인 원인을 읽고 시스템 설정의 “개인정보 보호 및 보안”에서 관련 기록을 확인하세요. 운영체제 비호환, 다운로드 미완료, 아키텍처 선택 오류는 서로 다른 문제입니다. 보호 기능을 끄거나 출처가 불분명한 명령을 실행해 일괄 처리하지 마세요.
구독을 가져온 뒤 일반 시스템 프록시로 브라우저 연결을 먼저 테스트하세요. 브라우저는 되지만 다른 앱이 연결되지 않는다면 해당 앱이 시스템 프록시를 따르는지 확인한 후 TUN 사용 여부를 결정하세요. 모드를 바꾸기 전에 정상 작동이 확인된 설정을 보관해 문제가 생기면 복구할 수 있도록 하세요.
먼저 v2rayNG를 선택하세요. V2Fly 코어를 사용하거나 특정 설정의 호환성을 확인해야 할 때 v2flyNG를 고려하세요.
2015년 이후 출시된 대부분의 스마트폰에서는 이 패키지를 우선 선택할 수 있습니다. 최종적으로는 기기에서 지원하는 앱 아키텍처를 기준으로 선택하세요. 대부분의 최신 Android 기기에 적합합니다.
v2rayNG 다운로드 · arm64 APK 설치 파일 · arm64-v8a아키텍처를 확인하기 어려울 때 선택하세요. 더 다양한 아키텍처를 지원해 설치 파일이 보통 더 크지만, arm64 버전보다 기능이 많은 것은 아닙니다.
v2rayNG 다운로드 · 범용 버전 APK 설치 파일 · universalv2rayNG는 Xray 코어를 사용합니다. 설정을 가져온 뒤 기본 네트워크 설정을 유지하고 유효한 설정을 선택하세요. 연결을 시작하고 Android 시스템의 VPN 권한 요청을 승인하면 됩니다. 특정 프로토콜이나 전송 방식의 조합이 지원되는지는 현재 클라이언트와 코어, 서버 설정을 함께 확인해야 합니다.
arm64 앱을 지원하는 기기에 적합합니다. V2Fly 코어가 필요할 때 이 클라이언트를 선택하세요. 네트워크 문제를 진단한다는 이유만으로 모든 설정을 한꺼번에 바꿀 필요는 없습니다.
v2flyNG 다운로드 · arm64 APK 설치 파일 · arm64-v8a아키텍처가 불분명하거나 다른 아키텍처와의 호환성이 필요한 기기에 사용할 수 있습니다. 설치 전에 운영체제 버전이 요구 사항을 충족하는지 확인하고 저장 공간을 충분히 확보하세요.
v2flyNG 다운로드 · 범용 버전 APK 설치 파일 · universalv2flyNG와 v2rayNG는 서로 다른 앱이므로 설정과 권한을 각각 확인해야 합니다. 다른 클라이언트에서 복사한 고급 설정이 그대로 작동한다고 가정하지 마세요. 특히 코어를 바꾼 뒤에는 프로토콜, 전송 방식, 도메인 정책을 다시 점검하세요.
| 확인 항목 | 선택 및 작업 |
|---|---|
| 기기 아키텍처 | 대부분의 기기에서는 arm64를 선택하면 됩니다. 다만 시스템에서 지원하는 앱 아키텍처를 확인하고, 잘 모르겠다면 범용 버전을 시도하세요. |
| 운영체제 버전 | 선택한 APK의 설치 요구 사항을 확인하세요. 파싱 오류가 표시되면 운영체제 호환성과 다운로드 완료 여부를 함께 점검하세요. |
| 설치 권한 | 시스템 안내에 따라 APK를 실제로 여는 브라우저나 파일 관리자에 설치 권한을 부여하세요. 설치 후에는 권한을 해제할 수 있습니다. |
| 연결 권한 | VPN 모드를 처음 실행할 때 시스템 권한을 승인해야 합니다. 한 번에 시스템 VPN 연결을 사용하는 앱 하나만 활성화하세요. |
“앱이 설치되지 않았습니다”라는 안내가 반드시 아키텍처 오류를 뜻하는 것은 아닙니다. 기존 앱의 서명, 설치 출처, 버전과 관련된 문제일 수도 있습니다. 설정을 먼저 백업하고 기존 앱 정보를 확인하세요. 구독과 사용자 지정 규칙을 저장하지 않은 채 바로 삭제하지 마세요. 설치 화면의 버전 정보와 실제 다운로드한 파일을 함께 확인하세요. 페이지에 표시된 버전은 참고용입니다.
연결 후 앱이 백그라운드에서 종료된다면 배터리 최적화, 백그라운드 실행, 네트워크 권한을 확인하세요. 앱별 프록시 설정에 따라 프록시 경로를 사용하는 앱이 달라지므로, 테스트할 때는 먼저 기본 범위가 작동하는지 확인한 다음 제외 규칙을 추가하세요. 다른 VPN 앱이 실행 중이면 먼저 종료해 권한 승인 후 연결이 다른 앱으로 바뀌지 않도록 하세요.
먼저 배포판에 맞는 deb 또는 rpm을 선택한 다음 x64와 arm64 중 알맞은 아키텍처를 확인하세요. 파일 형식과 CPU 아키텍처가 모두 맞아야 합니다.
Debian, Ubuntu 등 deb 패키지 관리 체계를 사용하는 배포판용입니다. 현재 배포판이 의존성 요구 사항을 충족하는지도 확인하세요.
deb 다운로드 · x64 ARM 기기를 사용하나요? deb 다운로드 · arm64 →rpm 패키지 관리 체계를 사용하는 배포판용입니다. 패키지 형식이 같더라도 모든 시스템 버전에서 실행 환경이 충족되는 것은 아닙니다.
rpm 다운로드 · x64 ARM 기기를 사용하나요? rpm 다운로드 · arm64 →의존성은 배포판의 소프트웨어 설치 도구나 패키지 관리자로 처리하는 것이 좋습니다. deb와 rpm을 혼용하거나 확장자 이름을 바꿔 설치하지 마세요. x64의 일반적인 아키텍처 표기는 amd64 또는 x86_64이며, arm64는 aarch64로 표기되기도 합니다.
| 확인 항목 | 선택 및 작업 |
|---|---|
| 배포판 패키지 형식 | 시스템에서 deb와 rpm 중 어떤 형식을 사용하는지 확인한 뒤, 현재 배포판 버전이 패키지 의존성 요구 사항을 충족하는지 살펴보세요. |
| CPU 아키텍처 | 시스템 정보에서 아키텍처를 확인하세요. x86_64는 x64, aarch64는 arm64를 선택해야 합니다. 기기 외형으로 판단하지 마세요. |
| 그래픽 데스크톱 | 이 페이지에서 제공하는 것은 그래픽 클라이언트입니다. 사용 가능한 데스크톱 세션과 관련 그래픽 의존성이 필요하며, 서버 백그라운드 서비스 설치 안내는 아닙니다. |
| 프록시 및 권한 | 시스템 프록시 적용 여부는 데스크톱 환경과 앱에 따라 다릅니다. TUN에는 별도의 네트워크 권한이 필요합니다. |
설치 프로그램에서 의존성이 없다고 표시되면 구체적인 패키지 이름과 버전 조건을 먼저 확인하세요. 의존성을 무시하고 설치를 강행하면 프로그램이 시작 단계에서 실패할 수 있습니다. 배포판마다 시스템 라이브러리 버전이 크게 다르므로 설치 파일의 확장자만으로 호환성을 판단할 수 없습니다.
프로그램을 연 뒤 구독을 가져와 일반 프록시 연결을 테스트하세요. 일부 앱은 데스크톱 환경의 시스템 프록시를 사용하지 않습니다. 브라우저가 연결된다고 해서 모든 터미널 프로그램의 트래픽이 프록시를 통과하는 것은 아닙니다. 앱이 어떤 프록시 경로를 사용하는지 먼저 확인한 뒤 수신 주소, 포트, 라우팅을 점검하세요. 수신 범위를 곧바로 전체 로컬 네트워크로 넓히지 마세요.
설치 프로그램 실행은 첫 단계일 뿐입니다. 먼저 설정을 가져오고 연결을 확인한 다음 라우팅 분기와 고급 모드를 조정하세요.
기존 클라이언트를 사용 중이라면 현재 연결을 끄고 시스템 프록시 상태와 로컬 수신 포트를 기록한 뒤, 클라이언트의 백업 또는 내보내기 기능으로 필요한 설정을 저장하세요. 구독 URL에 접속 정보가 포함될 수 있으므로 안전한 곳에 보관하고, 오류 화면을 공유하기 전에는 관련 내용을 가리세요. 클라이언트를 바꿀 때는 데이터베이스나 캐시 파일을 무작정 복사하지 말고 원본 구독을 다시 가져오는 것이 좋습니다.
같은 클라이언트의 일반 업데이트와 클라이언트 교체는 서로 다른 작업입니다. 업데이트는 대개 기존 설정을 유지하지만, 교체할 때는 설정 항목, 라우팅, 코어 기능이 달라질 수 있습니다. 업데이트 후 기존 그룹, 규칙, 설정을 읽을 수 있는지 확인하고 연결을 테스트하세요. 정상 작동을 확인하기 전에는 기존 백업을 삭제하지 마세요.
클라이언트 설치 파일에는 구독 서비스가 포함되지 않습니다. 사용할 권한이 있는 구독 URL을 준비한 뒤 구독 그룹 설정을 열고 새 그룹을 만들어 전체 주소를 붙여넣으세요. 저장한 다음 업데이트를 실행합니다. 목록이 비어 있다면 같은 URL을 반복해서 가져오기 전에 업데이트 로그를 확인하고, 응답 내용을 현재 클라이언트에서 읽을 수 있는지 점검하세요.
업데이트가 완료되면 사용할 설정을 선택하고 연결을 시작하세요. 노드 테스트는 연결 가능성을 가늠하는 참고 자료이며 실제 앱에서의 검증을 대신하지 않습니다. 특정 설정으로 연결되지 않으면 작동이 확인된 설정과 비교해 볼 수 있습니다. 다만 DNS, 라우팅, 포트, 전송 매개변수를 한꺼번에 바꾸면 어떤 변경이 문제를 해결하거나 일으켰는지 파악하기 어렵습니다.
데스크톱에서는 시스템 프록시가 활성화되어 있고 클라이언트의 로컬 수신 포트와 일치하는지 확인하세요. Android에서는 VPN 권한이 승인됐는지 먼저 확인합니다. 브라우저로 원래 안정적으로 접속되던 페이지를 열어본 뒤 대상 앱을 테스트하세요. 문제가 생기면 클라이언트 로그를 확인해 기기 네트워크 문제, 구독 오류, 연결 매개변수 오류를 구분하세요.
기본 연결이 정상 작동한 다음 TUN, 앱별 프록시, 사용자 지정 라우팅을 하나씩 활성화하세요. 변경할 때마다 한 가지 설정만 바꾸고 복구할 수 있도록 설정을 보관하세요. 클라이언트를 종료한 뒤 네트워크에 문제가 생기면 추가 진단에 앞서 시스템 프록시 주소가 종료된 프로그램을 가리키고 있지 않은지 확인하세요.
설치 파일 선택, 설정 이전, 첫 연결 관련 질문을 모았습니다.
처음 사용한다면 차세대 크로스 플랫폼 인터페이스를 지원하는 데스크톱판을 권장합니다. 기존 Windows 레이아웃에 익숙하다면 WPF판을 선택할 수 있습니다. 두 버전은 설정 위치와 실행 환경이 다를 수 있으므로 전환 전에 설정을 백업하고, 각각 별도 폴더에 설치하세요. 프로그램 파일을 한곳에 덮어쓰지 마세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 다만 기기에서 실제로 지원하는 앱 아키텍처를 확인하세요. 아키텍처를 모르거나 arm64 패키지가 설치되지 않으면 범용 버전을 시도할 수 있습니다. 범용 버전은 더 많은 아키텍처를 지원하며 파일 크기가 더 클 수 있지만, 기능이 더 많은 것은 아닙니다.
클라이언트는 설정을 읽고 연결을 만드는 도구이며, 설치 파일에 구독 서비스가 포함되는 것은 아닙니다. 사용할 권한이 있는 구독 URL이나 서버 설정을 준비한 뒤 구독 그룹에 가져오고, 업데이트한 다음 설정을 선택하세요. 접속 정보가 포함된 구독 URL을 다른 사람에게 공개하지 마세요.
대개 설정을 미리 삭제할 필요는 없습니다. 업데이트 전 연결을 끊고 클라이언트를 종료한 뒤 설정을 백업하세요. 앱, 아키텍처, 설치 방식을 동일하게 유지하는 것이 좋습니다. 데스크톱 버전을 바꾸거나 코어를 교체할 때는 관련 안내를 먼저 읽고 설정을 정상적으로 불러올 수 있는지 확인한 후 이전 파일을 정리하세요.
운영체제, CPU 아키텍처, 파일 형식이 맞는지 확인하고 다운로드가 완료됐는지도 살펴보세요. Windows ZIP 파일은 먼저 압축을 완전히 풀어야 합니다. macOS에서는 Apple Silicon과 Intel용을 구분하고, Linux에서는 배포판에 맞는 패키지 형식을 선택하세요. 보안 경고가 표시되면 구체적인 원인을 확인하고 시스템 보호 기능을 통째로 끄지 마세요.
먼저 프록시를 끄고 기본 네트워크가 정상인지 확인하세요. 그런 다음 구독 업데이트가 완료됐는지, 설정을 선택했는지, 클라이언트가 실행 중인지 점검하세요. 데스크톱에서는 시스템 프록시와 로컬 수신 포트를, Android에서는 VPN 권한을 확인하세요. 그래도 문제가 있으면 문제 진단 페이지의 항목을 차례로 확인하고, 여러 설정을 한꺼번에 바꾸지 마세요.