클라이언트 설치 파일 / 플랫폼 및 아키텍처
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 선택하세요. 운영체제를 확인한 뒤 프로세서와 설치 형식에 맞는 파일을 고르세요.
두 다운로드 모두 x64 설치 파일입니다. Desktop 버전은 크로스 플랫폼 인터페이스를 사용하며, 클래식 WPF 버전은 익숙한 창 레이아웃을 유지합니다.
데스크톱 프록시 클라이언트 · 7.24.1
ZIP 압축 파일입니다. 다운로드한 뒤 별도 폴더에 압축을 풀고, 폴더 안의 설치 프로그램을 실행하세요.
처음 사용하는 경우 Desktop 버전부터 시작해 보세요. 새로운 크로스 플랫폼 UI를 사용해 여러 데스크톱 운영체제에서 비슷한 방식으로 사용할 수 있습니다. WPF는 기존 인터페이스에 익숙한 사용자를 위한 클래식 안정 버전입니다. 두 버전 모두 구독 관리와 프록시 설정을 지원하므로 같은 구독을 가져오기 위해 함께 설치할 필요는 없습니다.
버전을 바꾸기 전에 기존 구독 그룹과 라우팅 설정, 사용자 지정 포트를 기록해 두세요. 두 프로그램을 동시에 자동 시작하도록 설정하면 로컬 수신 포트를 놓고 충돌하거나 서로 시스템 프록시 설정을 바꿀 수 있습니다. 인터페이스 차이는 서버 품질이나 동일한 설정에 제공되는 네트워크 리소스와 관계가 없습니다.
| 확인 항목 | 이 페이지에서 제공하는 파일 | 설치 전 확인 |
|---|---|---|
| 프로세서 아키텍처 | x64 | 설정 → 시스템 → 시스템 정보에서 시스템 종류 확인 |
| 시스템 호환성 | Windows 데스크톱 설치 프로그램 | 설치 프로그램의 안내를 따르세요. 구형 시스템은 실행 환경 지원 여부를 확인해야 합니다. |
| 파일 형식 | 설치 프로그램이 포함된 ZIP 파일 | 압축을 완전히 푼 뒤 실행하세요. 압축 파일 미리보기에서 실행하지 마세요. |
| 권한 | 일반 프록시와 TUN은 필요에 따라 설정 | 설치 프로그램이나 TUN에서 명시적으로 요구하는 경우에만 관리자 권한을 허용하세요. |
설치가 끝나면 먼저 구독을 추가하고 서버가 목록에 표시되는지 확인한 뒤 시스템 프록시 모드를 선택하세요. TUN은 설치에 필수적이지 않습니다. 일반적인 브라우저 사용은 시스템 프록시부터 시작하면 설정 문제를 찾기 쉽습니다.
Apple 메뉴 → 이 Mac에 관하여를 열어 ‘칩’ 또는 ‘프로세서’ 항목을 확인한 다음 해당 설치 파일을 선택하세요.
macOS 데스크톱 클라이언트 · 7.24.1
Apple M 시리즈 칩에는 Apple Silicon, Intel 프로세서에는 Intel을 선택하세요. 두 파일 모두 DMG 형식입니다.
칩 아키텍처는 컴퓨터 외관이 아니라 시스템 정보에서 확인하세요. 다운로드한 디스크 이미지를 열고 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮긴 다음 해당 폴더에서 실행하세요. 디스크 이미지를 마운트한 상태로 계속 사용하거나 업데이트 중 이름이 같은 앱을 여러 위치에 남겨 두지 마세요.
처음 실행할 때 시스템에서 차단하면 파일 출처와 형식, 오류 메시지를 먼저 확인하세요. 그런 다음 ‘시스템 설정 → 개인정보 보호 및 보안’에서 해당 앱과 관련된 조치가 있는지 살펴보세요. 보안 검사를 전역적으로 끄지 마세요. 앱이 열리면 구독과 프록시를 설정하세요. 설치에 성공했다고 프록시 연결까지 완료된 것은 아닙니다.
| 확인 항목 | 선택할 항목 | 확인 방법 |
|---|---|---|
| Apple Silicon | arm64 DMG | ‘이 Mac에 관하여’의 칩 항목에 Apple M 시리즈가 표시됨 |
| Intel | x64 DMG | ‘이 Mac에 관하여’의 프로세서 항목에 Intel이 표시됨 |
| 시스템 호환성 | 현재 앱의 요구 사항을 기준으로 확인 | 시스템 버전이 호환되지 않는다는 안내가 나오면 먼저 운영체제 업데이트 가능 여부를 확인하세요. |
| 앱 위치 | 응용 프로그램 폴더 | 복사가 끝나면 해당 폴더에서 실행한 다음 디스크 이미지를 추출하세요. |
시스템 프록시 설정을 따르는 앱의 트래픽을 프록시로 보내려면 클라이언트에서 해당 프록시 모드를 선택하세요. 특정 앱이 프록시를 사용하지 않는다면 시스템 설정을 읽는 앱인지 먼저 확인하세요. 이 문제만으로 설치 파일을 계속 바꿀 필요는 없습니다.
먼저 v2rayNG를 선택하세요. V2Fly 코어와의 호환성이 필요한 경우 v2flyNG를 고려할 수 있습니다. 두 클라이언트의 설정은 각각 별도로 관리됩니다.
Xray 코어 · 2.2.6
2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택하면 됩니다. 구체적인 선택은 운영체제가 지원하는 ABI를 기준으로 하세요. 아키텍처를 확인하기 어렵다면 범용 버전을 고려할 수 있습니다.
v2rayNG는 Android에서 두루 쓰기 좋은 클라이언트입니다. APK를 설치한 뒤 구독 그룹이나 클립보드에서 설정을 가져오고 사용할 서버를 선택하세요. 처음 연결할 때 시스템에서 VPN 연결 권한을 요청합니다. 이는 클라이언트가 기기의 트래픽을 처리할 수 있도록 허용하는 단계일 뿐, 사용 가능한 원격 서비스가 제공된다는 뜻은 아닙니다.
대부분의 스마트폰에서는 arm64 설치 파일을 사용하면 다운로드 용량을 줄일 수 있습니다. 범용 버전은 더 많은 아키텍처 코드를 포함해 설치 호환성을 높이기 위한 것으로, 같은 서버 설정의 연결 속도를 높여 주지는 않습니다. 구형 기기는 프로세서가 64비트를 지원하더라도 32비트 운영체제를 사용할 수 있으므로 프로세서의 제품명만 보고 판단하지 마세요.
V2Fly 코어 대안 · 1.10.31
기기 아키텍처에 맞춰 선택하세요. 설치와 구독 설정은 v2rayNG와 별도로 관리됩니다.
기존 설정이 V2Fly 코어를 기반으로 한다면 v2flyNG를 선택할 수 있습니다. 두 앱은 이름만 다른 같은 프로그램이 아닙니다. 지원하는 프로토콜과 전송 방식은 각 앱에 포함된 코어 버전에 따라 달라집니다. 가져온 설정의 일부를 인식하지 못한다면 arm64와 범용 버전을 번갈아 설치하기보다 필요한 기능이 지원되는지 먼저 확인하세요.
클라이언트를 바꿔 테스트하기 전에 다른 앱의 연결을 끊으세요. Android VPN 연결은 보통 하나의 앱이 관리하므로 여러 프록시 앱이 동시에 연결을 시도하면 문제를 찾기 어려워집니다. 설정을 옮기려고 기존 앱을 먼저 삭제하지 마세요. 구독과 사용자 지정 규칙이 저장된 것을 확인한 뒤 기존 설치를 정리하세요.
| 확인 항목 | 권장 선택 | 주의 사항 |
|---|---|---|
| 시스템 ABI | arm64 또는 범용 버전 | 하드웨어와 시스템 아키텍처가 다를 수 있으므로 운영체제 지원 여부를 기준으로 선택하세요. |
| 설치 형식 | APK | 현재 브라우저나 파일 관리자에 출처를 알 수 없는 앱 설치 권한 허용 |
| 시스템 호환성 | APK의 시스템 요구 사항에 따라 선택 | 설치 프로그램에서 시스템 버전이 호환되지 않는다고 안내하면 먼저 시스템 정보를 확인하세요. |
| 연결 권한 | 시스템 VPN 권한 | 처음 연결할 때 허용하고, 테스트 전에 다른 VPN 앱을 종료하세요. |
설치 프로그램에 ‘앱이 설치되지 않았습니다’라고 표시되는 경우 기존 앱과 서명, 버전 또는 저장 공간이 맞지 않을 수 있습니다. 기존 설정을 저장하고 오류 내용을 확인하세요. 처음부터 삭제 후 재설치하지 마세요. 앱을 삭제하면 로컬 설정도 함께 사라질 수 있습니다.
먼저 패키지 관리 체계를 확인한 다음 프로세서 아키텍처를 확인하세요. deb와 rpm은 기능이 다른 버전이 아니라 서로 다른 패키지 형식입니다.
Linux GUI 클라이언트 · 7.24.1
Debian 및 Ubuntu 계열은 보통 deb를 사용합니다. RPM 패키지 관리 체계를 사용하는 배포판에는 rpm을 선택하고 패키지 종속성의 호환성을 확인하세요.
시스템의 ‘정보’ 또는 하드웨어 정보에서 프로세서를 확인하세요. 일반적인 Intel 및 AMD 데스크톱은 x64를, arm64 데스크톱은 해당 아키텍처를 선택하면 됩니다. 파일명의 amd64와 x86_64는 모두 x64를 뜻하며, arm64와 aarch64는 ARM 64비트 아키텍처를 가리킵니다.
배포판의 소프트웨어 설치 프로그램으로 패키지를 열어 종속성과 호환성 안내를 확인하는 것이 좋습니다. 파일 확장자가 같아도 모든 배포판에서 설치할 수 있는 것은 아니며, 런타임 라이브러리 버전도 영향을 줍니다. 종속성을 무시하도록 강제하지 마세요. 앱이 정상적으로 실행되면 구독, 시스템 프록시, 라우팅을 차례로 설정하세요.
| 확인 항목 | 해당 패키지 | 설치 전 확인 |
|---|---|---|
| Debian 계열 패키지 관리 | deb | 소프트웨어 설치 프로그램에서 종속성과 배포판 호환성 확인 |
| RPM 패키지 관리 | rpm | 현재 배포판이 패키지 종속성을 충족하는지 확인 |
| 프로세서 아키텍처 | x64 / arm64 | 패키지 아키텍처가 시스템과 일치해야 합니다. |
| 실행 환경 | 그래픽 데스크톱 세션 | 이 페이지는 GUI 클라이언트 안내이며 서버 설치 방법은 다루지 않습니다. |
시스템 프록시를 앱에서 사용하는지는 데스크톱 환경과 앱 자체 설정에 따라 다릅니다. 먼저 프록시 설정을 지원하는 앱으로 테스트한 뒤 TUN이 필요한지 판단하세요. TUN은 추가 권한과 라우팅 설정이 필요하므로 처음 실행할 때 여러 네트워크 옵션을 한꺼번에 변경하지 않는 것이 좋습니다.
설치 전 확인
기기 브랜드만 보지 말고 먼저 어떤 운영체제를 실행하는지 확인하세요. 다음으로 시스템에 표시된 프로세서와 아키텍처 정보를 살펴본 뒤 설치 형식을 선택하세요. 같은 클라이언트의 아키텍처별 패키지는 실행 호환성을 위한 것이며 구독 내용이나 서비스 등급을 바꾸지 않습니다.
다운로드 카드의 버전 번호는 버전 목록을 기준으로 표시되며 실제 파일명에는 릴리스 번호가 포함될 수도 있습니다. 두 정보가 다르면 표시된 숫자를 설치된 버전으로 간주하지 마세요. 설치 후 클라이언트의 ‘정보’ 페이지에서 현재 프로그램 정보를 확인하세요. 숫자를 맞추려고 다운로드 파일명을 직접 바꾸지 마세요.
처음 설정할 때는 한 번에 하나씩 변경하세요. 먼저 프로그램이 열리는지 확인하고, 다음으로 설정을 가져올 수 있는지 확인한 뒤 트래픽이 예상대로 전달되는지 테스트하세요.
데스크톱에서는 ‘구독 그룹’에 그룹을 추가하고 구독 주소를 입력해 저장한 뒤 구독을 업데이트하세요. 주소를 붙여넣는 것은 가져올 출처를 저장하는 단계입니다. 업데이트가 성공한 후에야 선택할 서버가 표시됩니다. 공유 링크를 받았다면 기본 창에서 클립보드 가져오기를 사용하세요. 구독 주소 입력란에 붙여넣지 마세요.
Android에서도 먼저 구독을 설정한 뒤 설정 목록을 업데이트하세요. 클라이언트마다 메뉴 이름은 조금 다를 수 있지만 구독 출처 저장과 구독 내용 가져오기는 별개의 단계입니다. 목록이 비어 있다면 설치 파일 문제라고 단정하지 말고 업데이트 결과부터 확인하세요.
구독 가져오기 단계 보기 →데스크톱에서 ‘시스템 프록시 자동 설정’을 선택하면 시스템 프록시 설정을 따르는 앱이 해당 연결을 사용합니다. 라우팅 옵션은 어떤 연결을 프록시로 보내고 어떤 연결을 직접 연결할지 결정합니다. 시스템 프록시와는 서로 다른 설정입니다. 선택한 구성이 작동하는지 먼저 확인한 뒤 분할 라우팅 규칙을 조정하세요.
TUN은 가상 네트워크 인터페이스를 통해 트래픽을 처리하며 권한, DNS, 라우팅 설정이 필요합니다. 설치에 필수적인 기능도, 모든 연결 문제를 해결하는 옵션도 아닙니다. Android에서 시스템 VPN 인터페이스를 사용할 때는 먼저 해당 인터페이스를 점유한 다른 앱을 종료하세요.
프록시 모드 안내 보기 →기존 클라이언트가 정상적으로 작동한다면 업데이트 전에 유지할 구독 그룹, 직접 추가한 설정, 사용자 지정 라우팅과 포트를 정리하세요. 구독을 다시 가져올 수 있다고 해서 수동으로 수정한 항목까지 자동으로 복원되는 것은 아닙니다. 클라이언트에 내보내기나 백업 기능이 있다면 먼저 사용하고, 백업 파일은 설치 폴더 밖에 보관하세요.
실행 중인 프로그램과 시작 프로그램 등록을 종료한 뒤 설치를 시작하세요. 특히 Desktop 버전과 클래식 버전을 전환할 때 두 인스턴스를 동시에 실행해 같은 포트를 테스트하지 마세요. 설치 후 앱 정보를 확인하고 구독 그룹과 기본 선택이 유지됐는지 살펴본 다음 프록시 모드를 복원하세요. 클라이언트, 구독, DNS, 라우팅을 한꺼번에 변경하면 문제 원인을 찾기 어렵습니다.
Android에서 기존 앱을 덮어쓸 수 없다고 표시되면 바로 삭제하지 말고 버전과 서명 관련 안내를 확인하세요. Linux 업데이트는 기존 패키지 관리 방식을 유지해 설치 출처가 여러 개 남지 않도록 하세요. 새 설치가 실행되지 않는다면 다운로드를 반복하기보다 시스템에 표시된 오류 원문을 기록하는 것이 호환성 문제를 찾는 데 도움이 됩니다.
자주 묻는 질문으로 이동해 증상별로 확인하기 →처음 설치한다면 새로운 크로스 플랫폼 인터페이스를 사용하는 Desktop 버전을 선택해 보세요. 기존 레이아웃이 익숙하다면 클래식 안정 버전인 WPF를 선택할 수 있습니다. 둘 다 v2rayN이므로 동시에 설치할 필요는 없습니다. 버전을 바꾸기 전에 구독 그룹과 사용자 설정을 백업하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택하면 됩니다. 단, 최종적으로는 기기 운영체제가 지원하는 ABI를 기준으로 선택하세요. 아키텍처를 확인하기 어렵거나 64비트 시스템이 아닌 경우 범용 버전을 고려할 수 있습니다. 범용 버전은 더 많은 아키텍처 코드를 포함해 파일 크기가 큰 편이며, 연결 속도가 더 빠르다는 뜻은 아닙니다.
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. 칩 항목에 Apple M 시리즈가 표시되면 Apple Silicon을, 프로세서 항목에 Intel이 표시되면 Intel을 선택하세요. 컴퓨터 외관이나 구입 연도만으로 판단하지 말고 하드웨어에 맞는 파일을 선택하세요.
사용 가능한 구독 주소나 공유 링크를 별도로 준비해야 합니다. 설치 파일에는 클라이언트 프로그램만 포함되며, 바로 사용할 수 있는 서버 설정은 제공되지 않습니다. 데스크톱에서는 ‘구독 그룹’에 주소를 추가하고 저장한 뒤 구독을 업데이트하세요. 공유 링크는 클립보드에서 가져올 수도 있습니다.
업데이트 전에 구독 그룹, 사용자 지정 라우팅, 기타 중요한 설정을 백업하고 기존 클라이언트를 종료한 다음 설치하세요. 기존 클라이언트와 아키텍처, 설치 방식을 유지하는 것이 좋습니다. 인터페이스 버전이나 패키지 형식을 바꿀 때는 모든 설정이 자동으로 옮겨진다고 가정하지 마세요. 업데이트 후 구독 목록, 프록시 모드, 라우팅 설정을 확인하세요.
먼저 운영체제, 프로세서 아키텍처, 파일 형식이 맞는지 확인한 다음 시스템에 표시된 구체적인 오류를 살펴보세요. Windows ZIP 파일은 압축을 풀어야 합니다. Android에서는 다운로드 앱이나 파일 관리자에 출처를 알 수 없는 앱 설치 권한을 허용해야 합니다. Linux에서는 패키지 관리자로 종속성 안내를 확인하세요. 설치를 위해 시스템 보안을 전역적으로 해제하지 마세요.