클라이언트 설치 파일 / 플랫폼 및 아키텍처
데스크톱에서는 v2rayN을 선택하세요. Android에서는 v2rayNG를 우선 권장하며, V2Fly 코어가 필요한 경우 v2flyNG를 선택할 수 있습니다. 먼저 시스템을 확인한 뒤 CPU 아키텍처에 맞는 파일을 선택하세요.
v2rayN은 Desktop과 클래식 WPF, 두 가지 인터페이스를 제공합니다. 이 페이지의 두 설치 파일은 모두 x64용입니다.
Desktop은 차세대 크로스 플랫폼 UI입니다. 처음 설치하거나 여러 데스크톱 시스템에서 비슷한 사용 환경을 원한다면 적합합니다. 서버 목록, 구독 그룹, 설정은 첫 실행 후 각각 확인해야 합니다. 인터페이스를 바꾼다고 연결까지 자동으로 설정되는 것은 아닙니다.
WPF는 안정적인 클래식 버전입니다. 기존 Windows 조작 방식과 레이아웃에 익숙한 사용자에게 적합합니다. 선택할 때는 인터페이스와 사용 습관을 기준으로 삼으세요. 노드 프로토콜 이름만으로 호환성을 판단할 수 없으며, 사용하려는 코어와 서버 설정이 맞는지도 확인해야 합니다.
두 다운로드 파일은 모두 ZIP 압축 파일입니다. 다운로드가 끝나면 별도의 폴더에 압축을 푼 뒤 설치 프로그램을 실행하세요. 압축 파일 미리보기에서 바로 실행하지 마세요. 폴더 경로는 짧게 유지하고 임시 파일이 정리되는 폴더는 피하는 것이 좋습니다.
| 확인 항목 | 이 페이지에서 제공하는 설치 파일 | 권장 사항 |
|---|---|---|
| 프로세서 | x64, 64비트 Intel / AMD 환경 | 시스템 정보에서 아키텍처를 확인하세요. 다른 아키텍처라면 이 페이지의 x64 파일을 사용하지 마세요. |
| 운영체제 | 보안 업데이트를 계속 제공받는 Windows 10 / 11 환경 권장 | 최소 빌드 요구 사항은 설치 프로그램 안내를 따르세요. 구형 시스템에서는 호환성을 추가로 확인해야 합니다. |
| 실행 구성 요소 | Desktop과 WPF는 필요한 구성 요소가 다를 수 있습니다. | 실행 구성 요소가 없다는 메시지가 표시되면 설치 프로그램에 나온 구성 요소를 설치하세요. 동적 라이브러리 파일을 임의로 복사하지 마세요. |
| 권한 | 시스템 프록시와 TUN의 권한 요구 사항은 다릅니다. | 일반 프록시 설정부터 완료하세요. TUN 등 추가 기능을 사용할 때만 클라이언트 안내에 따라 권한을 허용하세요. |
v2rayN DMG 설치 파일을 제공합니다. Apple Silicon과 Intel용 네이티브 아키텍처 파일이 각각 있습니다.
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. ‘칩’ 항목에 Apple M 시리즈가 표시되면 Apple Silicon을 선택하고, Intel 프로세서라고 표시되면 Intel 파일을 선택하세요. 구매 연도는 참고만 하고, 칩 이름을 기준으로 설치 파일을 고르세요.
DMG를 연 다음 v2rayN을 ‘응용 프로그램’ 폴더로 드래그하고, 해당 폴더에서 실행하세요. 마운트된 디스크 이미지에서 계속 실행하면 이미지를 꺼내거나 업데이트할 때 앱 위치를 혼동할 수 있습니다.
처음 실행할 때 개발자를 확인할 수 없다는 안내가 표시되면, 앱의 출처와 이름을 먼저 확인한 뒤 시스템 설정의 ‘개인정보 보호 및 보안’에서 해당 안내를 살펴보세요. 앱 하나를 실행하기 위해 시스템 전체 보안 기능을 끄지 마세요.
| 확인 항목 | 지원 대상 | 권장 사항 |
|---|---|---|
| Apple Silicon | Apple M 시리즈 칩, arm64 파일 | 칩에 맞는 네이티브 설치 파일을 우선 사용하세요. 클라이언트 설치를 위해 변환 실행을 선택할 필요는 없습니다. |
| Intel | Intel 프로세서, x64 파일 | ‘이 Mac에 관하여’에서 프로세서 이름을 확인하세요. Intel 기기에 arm64 파일을 사용하지 마세요. |
| 시스템 버전 | DMG 안의 앱에 명시된 최소 시스템 버전을 충족해야 합니다. | 구형 macOS에서는 설치 전에 호환성을 확인하세요. 아키텍처가 맞아도 시스템 버전이 요구 사항을 충족하지 않을 수 있습니다. |
| 앱 설치 위치 | ‘응용 프로그램’ 폴더에 설치 권장 | 설치가 끝나면 디스크 이미지를 꺼내고, 고정된 앱 위치에서 실행하고 업데이트하세요. |
Xray 코어를 사용하는 v2rayNG를 우선 권장합니다. V2Fly 코어가 필요한 경우에만 v2flyNG를 선택하세요.
v2rayNG는 Android 기기에서 구독을 가져오고 서버를 관리하며 앱별 프록시 범위를 설정할 때 사용할 수 있습니다. VLESS, REALITY 등의 설정을 사용하는 경우 공유 설정과 클라이언트에 포함된 코어의 지원 여부를 함께 확인하세요. 서버 이름만으로 호환성을 판단할 수 없습니다.
2015년 이후 출시된 일반적인 스마트폰이라면 arm64를 우선 선택할 수 있지만, 일부 기기는 시스템에서 다른 앱 아키텍처만 지원할 수 있습니다. 아키텍처를 확인할 수 없다면 여러 아키텍처를 포함하는 범용 버전을 선택하세요. 범용 버전은 대체로 파일 용량이 더 크며, 정확한 크기는 파일 정보를 확인하세요.
카드의 버전 표시와 설치 파일명은 서로 다른 릴리스 정보에서 가져옵니다. 빌드를 확인하려면 다운로드한 파일명과 설치 후 ‘정보’ 화면을 확인하세요. 위에 표시된 버전만으로 특정 아키텍처 파일의 빌드 번호를 추정하지 마세요.
v2flyNG는 V2Fly 코어를 사용하며, 기존 설정이 이 코어를 기준으로 작성된 경우에 적합합니다. 별도의 클라이언트이므로 v2rayNG의 테마 버전이 아니며, 이름이 비슷하다고 설치 파일을 서로 바꿔 쓸 수 있는 것도 아닙니다. 두 클라이언트의 데이터 폴더와 일부 설정은 따로 관리해야 합니다.
아키텍처 선택 방법은 v2rayNG와 같습니다. 기기에서 지원하는 앱 아키텍처를 확인한 뒤 arm64 또는 범용 버전을 선택하세요. 설정에 REALITY 등 Xray 기능이 포함되어 있다면 화면이 비슷하다는 이유로 바로 가져오지 말고, 필요한 프로토콜과 보안 계층을 먼저 확인하세요.
다른 Android 클라이언트에서 옮길 때는 구독 또는 호환되는 공유 링크를 다시 가져오는 것이 좋습니다. 앱별 프록시, 라우팅, DNS 설정은 서버 설정을 가져온 뒤에도 별도로 확인해야 합니다.
| 확인 항목 | 지원 대상 | 권장 사항 |
|---|---|---|
| arm64 | arm64-v8a 앱을 지원하는 시스템 | 2015년 이후 출시된 일반적인 스마트폰을 우선 고려하되, 최종적으로는 시스템에서 실제 지원하는 아키텍처를 확인하세요. |
| 범용 버전 | 여러 앱 아키텍처 포함 | 아키텍처를 확인하기 어려울 때 선택하세요. 범용 버전도 앱 자체의 최소 시스템 요구 사항을 충족해야 합니다. |
| 시스템 버전 | 선택한 APK에 명시된 최소 Android 버전을 충족해야 합니다. | 설치 파일을 분석할 수 없다면 시스템 버전, 아키텍처, 파일 다운로드 완료 여부를 각각 확인하세요. |
| 연결 권한 | VPN 모드에는 시스템 VPN 권한이 필요합니다. | 앱을 확인한 뒤 권한을 허용하세요. 프록시 전용 모드에서는 앱이 로컬 프록시 포트에 직접 연결해야 합니다. |
| 백그라운드 실행 | 배터리 및 백그라운드 제한은 기기와 시스템에 따라 다릅니다. | 화면을 잠근 뒤 연결이 끊기는 경우에만 기기 설정에서 해당 클라이언트의 백그라운드 실행을 허용하세요. |
Android에서 어떤 코어를 선택할지 모르겠다면 세 클라이언트의 차이를 확인한 뒤 v2flyNG가 필요한지 결정하세요.
v2rayN은 deb와 rpm 형식으로 제공됩니다. 먼저 배포판의 패키지 관리 방식에 맞는 형식을 고른 다음 x64 또는 arm64를 선택하세요.
Debian, Ubuntu 및 관련 배포판은 일반적으로 deb를 사용합니다. Fedora, RHEL 및 관련 배포판은 보통 rpm을 사용합니다. 같은 패키지 형식이라도 패키지 관리 방식이 비슷하다는 뜻일 뿐, 시스템 라이브러리 버전과 현재 패키지의 호환성까지 보장하지는 않습니다.
파일명의 amd64와 x86_64는 모두 x64 아키텍처를 나타냅니다. arm64와 aarch64는 64비트 ARM 환경에 해당합니다. 기기가 모두 64비트라는 이유로 다른 아키텍처용 패키지를 설치하지 마세요.
이 페이지에서는 그래픽 데스크톱 클라이언트를 제공합니다. 설치 후 앱 메뉴에서 실행하고 데스크톱 세션에서 프록시를 설정하세요. 명령줄만 사용하는 서버는 이 그래픽 설치 절차의 대상이 아닙니다. 설정 항목은 별도 문서를 참조할 수 있으며, 독립 코어 패키지를 이 페이지에서 찾을 필요는 없습니다.
| 확인 항목 | 지원 대상 | 권장 사항 |
|---|---|---|
| 패키지 형식 | deb 또는 rpm | 현재 배포판의 패키지 관리 방식에 맞게 선택하세요. 한 형식의 파일 이름만 다른 형식으로 바꾸지 마세요. |
| 프로세서 | x64 및 arm64 설치 파일 제공 | 시스템에서 인식하는 아키텍처를 기준으로 선택하세요. 기기 외관이나 프로세서의 비트 수만으로는 판단하기 어렵습니다. |
| 데스크톱 환경 | 그래픽 앱을 실행할 수 있는 데스크톱 세션 필요 | 프록시 설정이 앱에 적용되는지는 데스크톱 환경과 앱 자체 설정에도 달려 있습니다. |
| 의존성 및 시스템 라이브러리 | 현재 패키지에 명시된 의존성 조건을 충족해야 합니다. | 패키지 관리자로 의존성을 확인하세요. 설치에 실패하면 구체적인 의존성 이름을 기록하고 강제 설치는 피하세요. |
설치 파일에는 클라이언트만 포함됩니다. 서버 매개변수, 구독 정보, 프록시 적용 범위는 별도로 설정해야 합니다.
설치 전에 사용 권한이 있는 구독 링크, 공유 링크 또는 설정 파일을 준비하세요. 구독은 일반적으로 여러 서버를 갱신하는 경로이며, 단일 서버 주소와는 다릅니다. 가져온 뒤 그룹이 표시되는지, 설정 항목이 모두 있는지 확인하고 사용할 서버를 선택하세요. 서버 목록에 항목이 보인다고 시스템 프록시까지 활성화된 것은 아닙니다.
데스크톱에서는 시스템 프록시 모드부터 사용하고, Android에서는 클라이언트 안내에 따라 VPN 권한을 허용하세요. 앱에서 프록시 주소를 직접 입력해야 한다면 클라이언트에 표시된 로컬 수신 주소와 포트를 사용하세요. 원격 서버 포트를 로컬 프록시 포트로 입력하지 마세요. 자세한 순서는 빠른 시작 가이드를 참조하세요.
같은 클라이언트를 업데이트하기 전에 구독 주소, 직접 추가한 설정, 사용자 지정 라우팅, DNS 설정을 저장하세요. 클라이언트에 내보내기 또는 백업 기능이 있다면 해당 기능을 우선 사용하세요. Desktop과 WPF 간에 바꾸거나 Android 클라이언트를 교체할 때 모든 설정이 자동으로 이어진다고 가정하지 마세요.
설치 후 사용할 서버, 라우팅 모드, 로컬 수신 포트를 먼저 확인한 뒤 앱별 프록시나 TUN 등 추가 설정을 복원하세요. 문제가 생기면 한 번에 하나씩 설정을 바꾸고 로그에 표시된 오류를 확인하세요. 구독 주소와 내보낸 설정에는 접근 자격 증명이 포함될 수 있으므로 공개 스크린샷, 공유 문서, 공개 게시물에 올리지 마세요.
먼저 패키지 형식과 아키텍처를 확인한 뒤 설정과 프록시 모드를 점검하세요.
처음 설치한다면 새로운 크로스 플랫폼 인터페이스를 사용하는 Desktop을 선택해 보세요. 기존 Windows 인터페이스와 조작 방식에 익숙하다면 안정적인 클래식 WPF 버전이 적합합니다. 두 버전 모두 실행 중인 서버, 라우팅, 시스템 프록시 설정을 따로 확인해야 합니다. 버전을 바꾸기 전에는 구독과 설정을 백업하세요.
2015년 이후 출시된 일반적인 스마트폰이라면 arm64를 먼저 사용해 볼 수 있지만, 최종적으로는 시스템에서 지원하는 앱 아키텍처를 확인해야 합니다. 범용 버전은 여러 아키텍처를 포함하므로 기기 아키텍처를 모르거나 다른 기기와의 호환성이 필요할 때 적합합니다. 설치 파일이 호환되지 않는다는 메시지가 표시되면 아키텍처와 시스템 버전을 먼저 확인하고, 반복해서 덮어 설치하지 마세요.
설치 파일에는 그래픽 클라이언트만 포함되며, 바로 사용할 수 있는 서버 설정은 제공되지 않습니다. 사용 권한이 있는 구독 링크, 공유 링크 또는 설정 파일을 준비해 가져온 다음, 사용할 서버를 선택하고 필요에 따라 시스템 프록시 또는 VPN 모드를 설정하세요.
구독 주소, 직접 추가한 서버 설정, 사용자 지정 라우팅 및 DNS 설정을 먼저 저장하세요. 클라이언트의 내보내기 또는 백업 기능을 사용하고 현재 프록시 모드도 기록해 두세요. 클라이언트를 바꿀 때는 호환되는 구독이나 공유 링크를 우선 사용하고, 다른 클라이언트의 데이터 폴더를 그대로 덮어쓰지 마세요.
카드에 표시된 버전과 아키텍처별 설치 파일명은 서로 다른 릴리스 정보에서 가져오므로 업데이트 시점이 다를 수 있습니다. 클라이언트, 시스템, 아키텍처를 먼저 확인하세요. 빌드를 정확히 확인하려면 실제 다운로드 파일명과 설치 후 정보 화면을 살펴보세요. 카드의 버전만 보고 해당 파일의 빌드 번호를 판단하지 마세요.