클라이언트 설치 파일 / 시스템 및 아키텍처
v2rayN 데스크톱 버전, v2rayNG 및 v2flyNG Android 버전.
먼저 운영체제를 선택한 다음 CPU 아키텍처를 확인하세요. 버전 정보는 클라이언트 카드에 표시되며, 설치 안내는 해당 다운로드 항목 바로 아래에 있습니다.
같은 v2rayN에 두 가지 인터페이스가 있습니다. 처음 설치한다면 Desktop을, 클래식 인터페이스를 계속 사용하려면 WPF를 선택하세요.
7.24.1 · Windows x64
차세대 크로스 플랫폼 UI로, 처음 설치하는 사용자와 데스크톱에서 일관된 사용 경험을 원하는 사용자에게 적합합니다.
Desktop 다운로드 · x64ZIP 압축 파일입니다. 먼저 압축을 푼 다음 안에 있는 설치 프로그램을 실행하세요.
Windows용 클래식 안정 버전입니다. 기존 메뉴 구성에 익숙하고 이전과 같은 방식으로 사용하려는 사용자에게 적합합니다.
WPF 다운로드 · x64둘 다 x64 설치 파일이며 차이는 인터페이스 구현 방식에 있습니다. CPU 아키텍처 차이가 아닙니다.
| 확인 항목 | 선택 기준 | 설치 전 확인 |
|---|---|---|
| 시스템 및 아키텍처 | 이 페이지에서는 Windows x64 패키지를 제공합니다 | 설정 → 시스템 → 정보에서 시스템 종류를 확인하세요. |
| 실행 환경 | 선택한 버전에서 요구하는 런타임을 확인하세요 | 실행할 때 필요한 런타임 구성 요소가 없다는 메시지가 나오면 해당 아키텍처의 구성 요소를 설치하세요. |
| 사용 권한 | 일반적인 시스템 프록시 사용에는 관리자 권한이 필요하지 않습니다 | TUN을 활성화할 때는 클라이언트 안내에 따라 필요한 권한을 부여하세요. |
다운로드가 완료되면 압축 파일을 쓰기 가능한 폴더에 풀고, 압축 프로그램의 미리 보기 창에서 설치 프로그램을 바로 실행하지 마세요. 프로그램이 사용 중이라는 메시지가 나오면 시스템 트레이에서 v2rayN을 종료한 뒤 이전 인스턴스가 실행 중인지 확인하세요. Desktop과 WPF의 설정 저장 위치 및 마이그레이션 방법은 버전에 따라 달라질 수 있습니다. 인터페이스를 바꾸기 전 설정을 내보내고 기존 폴더를 바로 덮어쓰지 마세요.
처음 실행하면 구독이나 서버 정보를 가져와 사용할 설정을 선택한 다음 ‘시스템 프록시 자동 설정’을 지정하세요. 시스템 프록시는 해당 설정을 따르는 앱에만 적용됩니다. 브라우저에서 연결된다고 해서 모든 프로그램의 트래픽이 처리되는 것은 아닙니다. 더 많은 프로그램의 트래픽을 가상 네트워크 어댑터로 처리해야 한다면 TUN 모드 안내를 확인하세요. 첫 실행 단계에서 라우팅, DNS, 네트워크 모드를 한꺼번에 변경하지 마세요.
인터페이스는 실행되지만 연결되지 않는다면 로그에서 구체적인 오류를 먼저 확인하세요. 런타임 구성 요소 누락, 서버 연결 불가, 구독 필드 비호환은 서로 다른 문제입니다. 같은 패키지를 반복 설치해도 서버 정보 오류가 해결되거나 클라이언트에 연결 설정이 추가되지는 않습니다.
v2rayN을 사용하세요. ‘이 Mac에 관하여’에서 칩 이름을 확인한 뒤 해당하는 DMG를 선택하세요.
7.24.1 · macOS
‘이 Mac에 관하여’에 Apple M 시리즈 칩이 표시되면 arm64 설치 파일을 선택하세요.
Apple Silicon 다운로드 · arm64칩에 맞는 네이티브 아키텍처를 우선 선택하세요.
‘이 Mac에 관하여’에 Intel 프로세서가 표시되면 x64 설치 파일을 선택하세요.
Intel 다운로드 · x64기기를 구매한 연도만으로 칩 종류를 판단하지 마세요.
| 확인 항목 | 선택 기준 | 설치 전 확인 |
|---|---|---|
| 칩 | Apple Silicon은 arm64, Intel은 x64 | 시스템 메뉴에서 ‘이 Mac에 관하여’를 여세요. |
| 시스템 버전 | 현재 앱 패키지의 최소 시스템 요구 사항을 확인하세요 | 시스템 버전이 요구 사항을 충족하는지 확인한 뒤 설치하세요. |
| 네트워크 권한 | 시스템 프록시와 TUN은 필요한 권한이 다릅니다 | 해당 기능을 사용할 때만 시스템 권한 요청을 처리하세요. |
DMG를 연 다음 설치 창 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮기고 해당 폴더에서 실행하세요. 마운트된 디스크 이미지에서 앱을 계속 실행하면 업데이트나 권한 처리 방식이 예상과 달라질 수 있습니다. 설치가 끝나면 디스크 이미지를 추출하고, 다운로드한 DMG는 설치 파일로 보관할 수 있습니다.
시스템에서 처음 실행을 차단하면 다운로드 출처와 표시된 안내를 확인한 뒤 시스템이 제공하는 방법으로 처리하세요. 앱 하나를 실행하려고 시스템 보안 기능 전체를 끄지 마세요. ‘호환되지 않음’이 표시되면 먼저 칩 아키텍처와 시스템 버전을 확인하세요. 권한 안내, 아키텍처 불일치, 다운로드 미완료는 각각 다른 방법으로 해결해야 합니다.
설정을 가져온 뒤 기본 네트워크 모드에서 먼저 연결을 확인하세요. 일부 앱은 별도의 프록시 설정을 사용하고, 시스템 프록시를 따르지 않는 앱도 있습니다. 시스템 프록시를 바꾼 뒤에는 대상 앱에서 다시 연결해 테스트하세요. 클라이언트를 종료하기 전 적절한 시스템 프록시 상태로 되돌려야, 중지된 로컬 수신 포트로 시스템 요청이 계속 전달되는 일을 막을 수 있습니다.
먼저 v2rayNG를 선택하세요. V2Fly 코어 호환이 필요한 경우 v2flyNG를 고려할 수 있습니다.
2.2.6 · Android
2015년 이후 출시된 대부분의 스마트폰은 이 패키지를 선택하면 됩니다. 시스템에서 지원하는 ABI를 기준으로 확인하세요.
v2rayNG 다운로드 · arm6464비트 Android 시스템을 실행하는 호환 기기용입니다.
기기 아키텍처를 모를 때 선택하세요. 여러 아키텍처용 실행 파일을 포함해 용량이 더 큰 편입니다.
v2rayNG 다운로드 · 범용 버전범용 버전도 최소 시스템 버전 요구 사항을 충족해야 합니다.
1.10.31 · Android
arm64를 지원하는 Android 시스템용으로, 기존 설정에 V2Fly 호환이 필요한 사용자에게 적합합니다.
v2flyNG 다운로드 · arm64가져오기 전에 프로토콜, 전송 방식, 보안 계층 필드가 지원되는지 확인하세요.
아키텍처를 알 수 없는 기기를 위한 대체 패키지입니다. 연결 가능 여부는 코어 지원에 따라 달라집니다.
v2flyNG 다운로드 · 범용 버전앱을 바꾸기 전에 다른 클라이언트의 VPN 연결을 먼저 종료하세요.
| 확인 항목 | 선택 기준 | 설치 전 확인 |
|---|---|---|
| 아키텍처 | arm64 또는 범용 버전 | 기기의 시스템 아키텍처를 확인하고, 알 수 없다면 범용 버전을 선택하세요. |
| 시스템 호환성 | APK에 명시된 최소 시스템 요구 사항을 확인하세요 | 저장 공간을 충분히 확보하고 다운로드가 완료됐는지 확인하세요. |
| 설치 권한 | 현재 사용 중인 다운로드 앱이나 파일 관리자에만 권한 부여 | 시스템 안내에 따라 설치를 허용하고, 설치 후에는 해당 출처의 권한을 해제할 수 있습니다. |
| 연결 권한 | VPN 모드를 시작할 때 시스템에서 확인합니다 | 권한 안내를 확인하세요. 일반적으로 한 사용자 환경에서는 활성 VPN을 하나만 사용할 수 있습니다. |
휴대전화에 64비트 프로세서가 있어도 시스템이 64비트 앱을 지원한다는 뜻은 아닙니다. arm64 패키지를 설치할 수 없다면 같은 파일을 반복해서 누르지 말고 시스템 ABI를 확인한 뒤 알맞은 범용 버전을 시도하세요. 기존 앱과 충돌한다는 안내가 나오면 서명 출처와 버전 관계를 확인하세요. 안내를 피하려고 기존 앱을 바로 삭제하지 마세요. 삭제하면 로컬 설정도 함께 제거될 수 있습니다.
처음 실행한 뒤 클립보드, QR 코드 또는 구독 그룹 메뉴에서 설정을 가져오고 서버 주소, 포트, 전송 설정을 확인한 다음 VPN을 시작하세요. 시스템에 연결 권한 팝업이 나타나는 것은 VPN 터널을 만드는 단계일 뿐, 원격 서버에 연결되었다는 뜻은 아닙니다. 도메인 이름 확인, 대상 앱 접속, 로그 상태를 각각 확인하세요.
백그라운드 연결이 시스템에 의해 종료된다면 설치 파일을 바로 바꾸기보다 배터리 최적화, 백그라운드 실행 제한, 다른 VPN 앱을 확인하세요. v2rayNG와 v2flyNG는 메뉴 구성과 필드 지원이 완전히 같지 않습니다. 전환하기 전에 원본 구독 설정을 보존하고, 한 클라이언트에서 내보낸 전용 설정 형식이 다른 클라이언트에서도 읽힌다고 가정하지 마세요.
v2rayN GUI 클라이언트를 사용하세요. 먼저 deb와 rpm 중 패키지 형식을 고른 뒤 x64 또는 arm64를 확인하세요.
7.24.1 · Linux
Debian 패키지 관리 체계를 사용하는 호환 배포판용입니다. 시스템 소프트웨어 설치 프로그램으로 여세요.
deb 다운로드 · x64arm64 기기: deb 다운로드 · arm64
RPM 패키지 관리 체계를 사용하는 호환 배포판용입니다. 설치 전에 필요한 종속성을 확인하세요.
rpm 다운로드 · x64arm64 기기: rpm 다운로드 · arm64
| 확인 항목 | 선택 기준 | 설치 전 확인 |
|---|---|---|
| 패키지 형식 | deb 또는 rpm | 시스템 정보와 소프트웨어 관리자에서 배포판의 패키지 체계를 확인하세요. |
| 프로세서 | x64는 amd64 / x86_64, arm64는 aarch64에 해당합니다 | 배포판 이름만으로 아키텍처를 판단하지 마세요. |
| 데스크톱 환경 | GUI 앱을 실행할 수 있는 데스크톱 세션이 필요합니다 | 디스플레이 환경을 확인하고 설치 프로그램에 표시된 종속성이 모두 충족되는지 확인하세요. |
| 시스템 호환성 | 패키지 형식이 같아도 모든 배포판 버전과 호환되는 것은 아닙니다 | 종속성을 충족할 수 없다면 시스템 버전을 먼저 확인하고, 종속성을 강제로 무시하지 마세요. |
deb와 rpm은 소프트웨어 패키지 형식이지 프록시 프로토콜이 아닙니다. 다운로드한 패키지는 배포판에 포함된 소프트웨어 설치 프로그램으로 열고, 표시되는 종속성과 설치 위치를 확인한 뒤 설치하세요. 패키지 이름의 amd64와 x86_64는 일반적인 x64 아키텍처를, arm64와 aarch64는 다른 프로세서 아키텍처를 나타내며 서로 바꿔 쓸 수 없습니다.
Linux 데스크톱 환경마다 시스템 프록시를 사용하는 방식이 다릅니다. 클라이언트에서 시스템 프록시를 설정해도 일부 앱은 자체 네트워크 설정을 사용할 수 있습니다. 대상 앱에서 실제 프록시 경로를 확인한 뒤 TUN이 필요한지 판단하세요. 편의를 위해 GUI 클라이언트 전체를 계속 높은 권한으로 실행하지 말고, 기능에 필요한 권한만 부여하세요.
설치 프로그램에서 종속성을 충족할 수 없다고 표시하면 기존 설정을 보존하고 필요한 종속성의 이름을 확인하세요. rpm의 확장자를 deb로 바꾸거나 종속성을 강제로 건너뛰고 패키지를 반복 설치해도 바이너리 호환 문제는 해결되지 않습니다. 업데이트할 때는 같은 패키지 관리 경로를 유지하세요. 수동으로 압축을 푼 파일과 설치된 앱이 함께 있으면 잘못된 버전이 실행될 수 있습니다.
설치 후
설치 파일은 프로그램을 설치할 뿐, 연결에는 별도의 설정이 필요합니다. 먼저 기본 연결 경로를 확인한 뒤 라우팅과 DNS를 조정하세요.
클라이언트에는 연결 가능한 서버가 포함되어 있지 않습니다. 사용 권한이 있는 구독 주소, 공유 링크 또는 수동 설정을 준비하고, 가져오기 전에 형식과 클라이언트의 지원 여부를 확인하세요. 구독 주소의 경로와 쿼리 매개변수에 접속 정보가 포함될 수 있으므로 공개된 화면 캡처나 문의 기록에 노출하지 마세요.
가져온 뒤 주소, 포트, 프로토콜, 전송 방식, TLS 설정을 확인하세요. 목록에 표시되는 것은 파싱에 성공했다는 뜻일 뿐입니다. 서버 상태, 인증 정보, 전송 방식 조합은 실제로 연결해 확인해야 합니다. 문제를 해결할 때는 변경 전 설정을 하나 보관해 비교할 수 있도록 하세요.
설정 가져오기 및 연결 가이드 보기 →데스크톱에서는 시스템 프록시부터 사용하고, Android에서는 클라이언트의 VPN 모드로 기기 트래픽을 전달합니다. 트래픽 전달 방식은 어떤 앱의 데이터가 클라이언트로 들어갈지를 결정합니다. 라우팅 규칙은 전달된 트래픽을 프록시, 직접 연결, 차단 중 어디로 보낼지 정하며, 두 설정은 서로 다른 기능입니다.
첫 연결에서는 꼭 필요한 설정만 바꾸세요. 접속과 로그가 정상인지 확인한 다음 구독 그룹, 도메인 규칙, DNS 정책을 하나씩 추가하세요. 문제가 생기면 한 번에 한 항목씩 되돌려야 원인을 찾기 쉽습니다. 규칙 순서나 사용자 지정 아웃바운드를 알아보려면 고급 설정을 확인하세요.
라우팅 및 DNS 설정 보기 →설치 파일에는 클라이언트 프로그램만 포함되며, 사용할 수 있는 서버 연결 설정은 제공되지 않습니다. 사용 권한이 있는 구독 링크나 서버 정보를 직접 준비해 가져온 다음, 설정을 선택하고 시스템 프록시 또는 VPN 모드를 지정해야 합니다. 구독 주소에 접속 정보가 포함될 수 있으므로 공개하지 마세요.
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 Desktop 버전을 먼저 선택해 보세요. 클래식 WPF 버전은 Windows에서 안정적으로 사용할 수 있는 기존 인터페이스로, 익숙한 화면을 계속 쓰려는 사용자에게 적합합니다. 둘 다 v2rayN이며, 이 페이지의 Windows 다운로드 항목은 모두 x64 설치 파일입니다. 서로 다른 CPU 아키텍처용으로 오해하지 마세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택해도 되지만, 최종적으로는 시스템에서 지원하는 ABI를 확인해야 합니다. 구형 기기이거나 아키텍처를 알 수 없다면 범용 버전을 선택하세요. CPU가 64비트를 지원해도 시스템이 64비트라는 뜻은 아닙니다. 설치할 수 없거나 패키지를 파싱할 수 없다는 오류가 발생하면 시스템 버전, 남은 저장 공간, 기존 앱의 서명도 함께 확인하세요.
v2rayNG는 Xray 코어를 사용하며 이 페이지에서 우선 추천하는 Android 클라이언트입니다. v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 기존 설정에서 필요한 프로토콜, 전송 방식, 필드 지원 여부를 기준으로 선택하세요. 공유 링크를 가져올 수 있다고 해서 모든 매개변수가 정상 작동하는 것은 아닙니다. 클라이언트를 바꾸기 전에는 기존 설정을 백업하고 다른 앱의 VPN 연결을 종료하세요.
버전 표기와 설치 파일 링크는 목록의 서로 다른 필드를 사용하므로 업데이트 시점이 다를 수 있습니다. 페이지는 각 필드의 값을 따로 표시하며, 파일 이름의 숫자를 버전 표기로 바꾸지 않습니다. 두 값이 다르면 기존 설정을 보존하고, 다운로드 후 앱의 정보 화면에서 버전을 확인한 뒤 업데이트 여부를 판단하세요.
먼저 클라이언트의 내보내기 또는 백업 기능으로 서버 설정, 구독 그룹, 라우팅 규칙, 사용자 지정 DNS 설정을 보존하세요. 실행 중인 이전 프로세스를 종료한 다음 같은 출처와 아키텍처의 새 패키지를 설치하세요. 인터페이스 버전이나 클라이언트를 바꿔 옮길 때 설정 폴더와 모든 필드가 호환된다고 가정하지 마세요. 새 버전이 정상 작동하는지 확인한 뒤 이전 사본을 정리하세요.