CLIENT FILES / 클라이언트 설치 파일
V2Ray 클라이언트 다운로드
v2rayN 데스크톱 클라이언트, v2rayNG 및 v2flyNG Android 클라이언트입니다. 운영체제를 먼저 선택한 다음 프로세서 아키텍처를 확인하세요.
클라이언트는 무료이며 오픈 소스입니다. 설치 파일에는 연결 설정이 포함되지 않으므로 처음 사용할 때 구독 또는 공유 링크를 별도로 가져와야 합니다.
Windows 클라이언트. Desktop 버전과 클래식 인터페이스.
v2rayN
Windows / x64 / Desktop · WPF
Desktop 버전은 차세대 크로스 플랫폼 UI를 사용합니다. 처음 설치하거나 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하고 싶은 경우에 적합합니다. 클래식 WPF 버전은 Windows용 클래식 안정 버전으로, 익숙한 창 배치를 유지합니다. 두 다운로드 항목은 서로 다른 인터페이스 구현을 위한 것이며 프록시 프로토콜이 다른 것은 아닙니다. 인터페이스 버전만으로 연결 기능을 판단해서는 안 됩니다.
두 설치 파일은 모두 x64 시스템용입니다. Windows의 ‘설정 → 시스템 → 시스템 정보’에서 ‘시스템 종류’를 확인해 사용 중인 아키텍처와 맞는지 확인하세요. 다운로드한 ZIP 파일은 쓰기 가능한 폴더에 압축을 완전히 푼 다음 안에 있는 설치 프로그램을 실행해야 합니다. 압축 미리 보기 창에서 바로 실행하면 관련 파일이 아직 풀리지 않아 실행 또는 경로 오류가 발생할 수 있습니다.
기존 설정이 있다면 Desktop 또는 WPF로 바꾸기 전에 백업을 내보내세요. 두 클라이언트가 동시에 시스템 프록시 설정을 변경하거나 같은 수신 포트를 사용하지 않도록 하세요. 설치 후에는 ‘시스템 프록시 자동 설정’, 활성 서버, 라우팅 설정을 확인하세요. 기본 창이 열렸다는 것은 프로그램이 실행되었다는 뜻일 뿐, 브라우저 트래픽이 프록시를 통과한다는 의미는 아닙니다.
Windows 설치 조건
| 확인 항목 | 선택 및 요구 사항 |
|---|---|
| 운영체제 및 프로세서 | Windows x64. 운영체제 버전과 런타임 구성 요소 요구 사항은 선택한 설치 프로그램의 안내를 확인하세요. |
| 파일 처리 | ZIP 파일을 다운로드한 뒤 압축을 완전히 푸세요. 설치 폴더와 사용자 설정 폴더에 필요한 읽기 및 쓰기 권한이 있어야 합니다. |
| 프록시 권한 | 일반 시스템 프록시와 TUN은 필요한 권한이 다릅니다. TUN을 사용하려면 관리자 권한과 가상 네트워크 인터페이스 구성 요소가 필요할 수 있습니다. |
macOS 클라이언트. 칩에 맞는 DMG를 선택하세요.
v2rayN
macOS / Apple Silicon · Intel
시스템 메뉴에서 ‘이 Mac에 관하여’를 열고 ‘칩’ 또는 ‘프로세서’ 항목을 확인하세요. Apple 칩이라고 표시되면 Apple Silicon, 즉 arm64 설치 파일을 선택합니다. Intel 프로세서라면 Intel, 즉 x64 설치 파일을 선택하세요. 기기를 구매한 연도는 정확한 판단 기준이 아니므로 시스템 리포트에 표시된 실제 하드웨어 정보를 확인하는 것이 좋습니다.
다운로드한 DMG를 열고 디스크 이미지의 안내에 따라 클라이언트를 응용 프로그램 폴더로 옮긴 다음 해당 폴더에서 실행하세요. 마운트된 이미지에서 계속 실행하면 나중에 이미지를 분리하거나 프로그램을 업데이트하고 설정에 접근할 때 경로 문제가 발생할 수 있습니다. 처음 실행할 때 시스템 보안 경고가 표시되면 앱 출처와 경고 내용을 확인한 뒤 시스템 설정의 안내에 따라 처리하세요.
설정을 가져온 뒤에도 시스템 프록시는 해당 설정을 따르는 앱에만 적용됩니다. TUN이 필요하다면 클라이언트 안내에 따라 필요한 권한을 부여하고 다른 네트워크 확장 기능과의 충돌에 유의하세요. 클라이언트를 바꾸거나 사용을 중단하기 전에 시스템 프록시를 원래대로 복구한 다음 프로그램을 종료하세요. 앱을 바로 삭제해도 시스템 프록시 설정이 자동으로 복구되는 것은 아닙니다.
macOS 설치 조건
| 확인 항목 | 선택 및 요구 사항 |
|---|---|
| 칩 아키텍처 | Apple Silicon은 arm64, Intel 프로세서는 x64를 선택하세요. 기기 모델명만으로 추측하지 마세요. |
| 운영체제 버전 | 현재 앱 빌드의 최소 시스템 요구 사항을 충족해야 합니다. 시스템이 오래되었다는 안내가 표시되면 먼저 호환성을 확인하세요. |
| 설치 및 권한 | 응용 프로그램 폴더에 쓰기 권한이 필요합니다. 프록시 설정을 변경하거나 가상 네트워크 인터페이스를 활성화할 때 시스템 승인이 필요할 수 있습니다. |
Android 클라이언트. Xray 우선, V2Fly 대안.
v2rayNG
Android / Xray 코어
v2rayNG는 Xray 코어를 사용하며, Android 기기에서 구독을 가져오고 활성 설정을 선택한 뒤 시스템 VPN 인터페이스로 트래픽을 처리할 수 있습니다. 2015년 이후 출시된 일반적인 스마트폰이라면 arm64를 우선 선택하세요. 기기의 시스템이 다른 아키텍처를 사용하거나 실행 환경을 확인하기 어렵다면 범용 버전을 선택할 수 있습니다. 범용 버전은 더 많은 아키텍처를 지원하기 위한 것으로 arm64 버전보다 기능이 많다는 뜻은 아닙니다.
APK를 다운로드한 뒤에는 브라우저나 파일 관리자가 앱 설치를 허용하도록 설정해야 할 수 있습니다. 출처를 확인한 후 실제 설치를 진행하는 앱에 필요한 권한만 부여하세요. 처음 연결할 때 Android에서 VPN 연결 권한을 요청합니다. 이는 클라이언트가 로컬 가상 네트워크 인터페이스를 만드는 시스템 절차이며, 구독을 가져왔거나 원격 연결에 성공했다는 뜻은 아닙니다.
화면을 잠근 뒤 연결이 끊긴다면 먼저 백그라운드 실행 및 배터리 최적화 제한을 확인한 다음 구독의 유효성을 살펴보세요. 대부분의 기기에서는 일반 VPN 서비스를 한 번에 하나만 사용할 수 있으며, VPN 인터페이스를 사용하는 다른 앱이 클라이언트와 충돌할 수 있습니다. 테스트하기 전에 어떤 앱이 트래픽을 처리하고 있는지 확인해 여러 서비스 사이에서 반복적으로 전환하지 마세요.
v2flyNG
Android / V2Fly 코어
v2flyNG는 V2Fly 코어를 사용하는 Android용 대안 클라이언트입니다. 해당 설정을 이미 사용 중이거나 V2Fly의 동작을 확인해야 하는 경우에 적합합니다. 선택하기 전에 구독의 프로토콜과 전송 설정을 클라이언트 및 코어 버전에서 지원하는지 확인하세요. 가져오기 방식이 비슷하더라도 Xray 전용 설정을 모두 그대로 옮길 수 있는 것은 아닙니다.
arm64와 범용 버전의 선택 방법은 앞서 설명한 Android 설치 파일과 같습니다. 클라이언트를 옮길 때는 다른 앱의 데이터 폴더를 덮어쓰기보다 표준 공유 링크나 구독을 다시 가져온 뒤 라우팅, DNS, 앱별 분기 설정을 하나씩 확인하세요. 두 클라이언트에 설정을 각각 저장할 수 있지만 연결할 때는 VPN 서비스를 하나만 활성화해야 합니다.
Android 설치 조건
| 확인 항목 | 선택 및 요구 사항 |
|---|---|
| 시스템 아키텍처 | 일반적인 64비트 시스템에서는 arm64를 우선 선택하세요. 아키텍처를 모르면 범용 버전을 사용할 수 있으며, 최종적으로는 설치 호환성 안내를 따르세요. |
| 설치 권한 | APK를 설치할 브라우저 또는 파일 관리자에 설치 권한을 허용하세요. 운영체제 버전도 현재 패키지의 요구 사항을 충족해야 합니다. |
| 네트워크 및 백그라운드 실행 | 처음 연결할 때 VPN 권한이 필요합니다. 지속 실행 여부는 시스템의 백그라운드 제한, 배터리 최적화, 다른 VPN 서비스의 영향을 받을 수 있습니다. |
Linux 클라이언트. 패키지 형식과 아키텍처를 차례로 선택하세요.
v2rayN
Linux / deb · rpm / x64 · arm64
deb는 일반적으로 Debian 패키지 관리 체계를 사용하는 배포판에서, rpm은 RPM 패키지 관리 체계를 사용하는 배포판에서 사용합니다. 먼저 배포판이 지원하는 패키지 형식을 확인한 다음 프로세서 아키텍처를 살펴보세요. 파일 이름의 amd64와 x86_64는 모두 일반적인 x64 아키텍처를 의미하며, arm64와 aarch64는 ARM 64비트 아키텍처를 뜻합니다. 확장자만 보고 설치하지 마세요.
이 다운로드 항목은 그래픽 데스크톱 클라이언트용입니다. 사용 가능한 데스크톱 세션과 관련 런타임 의존성이 필요하며, 터미널만 있는 서버 환경을 위한 설치 절차가 아닙니다. 다운로드한 파일은 배포판의 그래픽 소프트웨어 설치 프로그램으로 여세요. 의존성을 충족할 수 없다는 안내가 표시되면 배포판 버전과 패키지 대상 환경을 먼저 확인하고, 의존성 검사를 강제로 무시해 설치하지 마세요.
앱이 시스템 프록시 설정을 읽을 수 있는지는 데스크톱 환경과 앱의 네트워크 구현에 따라 다릅니다. TUN은 가상 네트워크 인터페이스, 권한, 시스템 라우팅도 필요로 합니다. 처음에는 일반 시스템 프록시가 작동하는지 확인한 뒤 필요에 따라 TUN을 활성화하세요. 다른 프록시 서비스가 포트를 사용 중이라면 충돌하는 서비스를 중지하거나 수신 설정을 변경하세요. 그래야 실행 실패를 구독 문제로 오해하지 않습니다.
Linux 설치 조건
| 확인 항목 | 선택 및 요구 사항 |
|---|---|
| 패키지 관리 체계 | 배포판에 맞춰 deb 또는 rpm을 선택하세요. 확장자가 맞더라도 시스템 라이브러리와 의존성 요구 사항을 확인해야 합니다. |
| 프로세서 아키텍처 | x64는 amd64 또는 x86_64, ARM 64비트는 arm64 또는 aarch64에 해당합니다. |
| 데스크톱 및 권한 | 그래픽 데스크톱 세션과 쓰기 가능한 설정 폴더가 필요합니다. 시스템 소프트웨어 설치나 가상 네트워크 인터페이스 생성에는 관리자 권한이 필요할 수 있습니다. |
SECTION 02 / 설치 및 업데이트
설치 파일 선택. 아키텍처, 버전, 설정을 구분하세요.
프로세서 아키텍처와 운영체제는 다릅니다
같은 운영체제라도 서로 다른 프로세서에서 실행될 수 있습니다. 플랫폼을 올바르게 골라도 아키텍처가 맞지 않으면 설치하거나 실행하지 못할 수 있습니다. 시스템 정보를 확인하고 브라우저 모양, 기기 브랜드, 구매 연도로 추측하지 마세요. ‘이 앱을 실행할 수 없습니다’와 같은 메시지가 표시되면 같은 파일을 반복해서 다운로드하기 전에 아키텍처와 런타임 구성 요소를 확인하세요.
버전 표시와 패키지 파일 이름은 별도로 확인하세요
카드 세부 정보에는 목록에 등록된 버전이 표시되고, 각 버튼은 해당 아키텍처의 파일로 연결됩니다. 목록의 버전 항목과 파일 이름이 다를 수 있으므로 설치 프로그램과 클라이언트의 정보 화면을 함께 확인해 실제 설치 버전을 알아보세요. 파일 이름의 버전 숫자는 임의로 바꿔 사용할 수 있는 다운로드 매개변수가 아닙니다. 경로를 직접 수정하면 존재하지 않는 파일로 연결될 수 있습니다.
업데이트 전에 복구할 수 있도록 설정을 보관하세요
프로그램을 업데이트하기 전에 현재 설정을 내보내고 사용자 지정 라우팅을 저장하세요. 구독 링크에는 접근 자격 증명이 포함될 수 있으므로 공개 스크린샷, 채팅, 문서에 올리지 마세요. 연결을 끊고 이전 프로그램을 종료한 뒤 업데이트하면 포트 점유와 파일 쓰기 충돌을 줄일 수 있습니다. 새 버전을 실행한 후에는 활성 설정과 라우팅을 확인하고 평소 사용을 재개하세요.
호환성은 여러 요소에 따라 달라집니다
설치 파일 실행 여부는 운영체제와 의존성에 따라 달라집니다. 공유 링크 가져오기는 클라이언트의 파싱 기능에, 연결 성립 여부는 코어 지원, 매개변수, 원격 서비스 상태에 달려 있습니다. 세 문제를 구분해 확인하세요. Xray와 V2Fly의 기능은 완전히 같지 않습니다. 특정 프로토콜과 전송 방식의 조합을 확인하려면 프로토콜 참고 자료를 살펴본 뒤 클라이언트를 선택하세요.
SECTION 03 / 초기 설정
다운로드 후 설정 순서. 가져오기부터 연결 확인까지.
-
구독 또는 공유 링크 가져오기
설치가 끝나면 먼저 유효한 연결 설정을 준비하세요. 구독 주소와 개별 공유 링크는 입력 방법이 다릅니다. 구독은 보통 구독 그룹에 추가해 업데이트하고, 공유 링크는 클립보드에서 가져올 수 있습니다. 입력 후 선택 가능한 설정 항목이 생성되었는지 확인하세요. 목록이 비어 있으면 형식과 구독 접속 상태를 먼저 확인하고, 곧바로 시스템 프록시를 변경하지 마세요.
-
설정을 선택하고 트래픽 처리 방식을 지정하세요
목록에서 활성 설정을 선택한 다음 시스템 프록시 또는 TUN을 지정하세요. 시스템 프록시는 앱이 프록시 설정을 읽어야 작동합니다. TUN은 가상 네트워크 인터페이스로 트래픽을 처리하므로 권한과 트래픽 처리 범위가 다릅니다. 처음 문제를 확인할 때는 한 가지 방식을 명확하게 선택하고 여러 프록시 도구를 겹쳐 사용하지 마세요. 라우팅 규칙은 요청을 직접 연결, 프록시, 차단 중 어디로 보낼지 결정합니다. 스위치를 켠다고 모든 트래픽이 같은 경로를 사용하는 것은 아닙니다.
-
연결 상태와 앱의 실제 동작을 확인하세요
먼저 클라이언트 로그에서 시작 또는 설정 오류가 있는지 확인하고, 실제 연결을 테스트한 다음 대상 앱의 접속 결과를 살펴보세요. 포트 검사로 확인할 수 있는 것은 일부 경로의 연결 가능성뿐이며, 전체 프록시 연결을 검증할 수는 없습니다. 클라이언트 테스트는 정상이지만 브라우저에 문제가 있다면 클라이언트를 바로 재설치하지 말고 브라우저 프록시, DNS, 라우팅 규칙을 추가로 확인하세요.
빠른 시작 전체 안내 보기 또는 선택 가이드에서 세 클라이언트의 사용 상황을 비교하세요.
SECTION 04 / 다운로드 문제
설치 파일 FAQ. 선택, 업데이트, 실행.
Windows Desktop 버전과 클래식 WPF 버전, 무엇을 선택할까요?
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 Desktop 버전을 먼저 고려해 보세요. 클래식 WPF 버전은 Windows의 익숙하고 안정적인 인터페이스를 유지해 기존 사용 방식에 익숙한 사용자에게 적합합니다. 두 버전 모두 유효한 연결 설정을 가져와야 합니다. 인터페이스 버전을 바꾸기 전에 설정을 내보내고, 화면이 비슷하다는 이유만으로 프로그램 폴더를 덮어쓰지 마세요.
Android에서는 arm64와 범용 버전 중 무엇을 선택해야 하나요?
2015년 이후 출시된 일반적인 스마트폰이라면 arm64를 우선 선택할 수 있지만, 최종적으로는 기기에서 실행 중인 시스템 아키텍처를 확인해야 합니다. 프로세서가 64비트를 지원해도 운영체제가 반드시 64비트로 실행되는 것은 아닙니다. 아키텍처를 확인하기 어렵거나 arm64 패키지가 호환되지 않는다고 표시되면 범용 버전을 사용해 보세요. 범용 버전은 여러 아키텍처를 포함하므로 다운로드 및 저장 공간을 더 차지할 수 있습니다.
클라이언트를 설치한 뒤에도 구독이나 공유 링크가 필요한가요?
네. 설치 파일에는 그래픽 클라이언트와 트래픽 처리 기능만 포함되며, 바로 사용할 수 있는 연결 설정은 제공되지 않습니다. 신뢰할 수 있는 출처에서 구독 또는 공유 링크를 받은 다음 클라이언트로 가져오세요. 가져온 뒤에는 사용할 설정을 선택하고 프록시 방식을 지정한 후, 앱 트래픽이 의도한 대로 프록시를 통과하는지 확인해야 합니다.
업데이트를 설치하기 전에 기존 설정을 어떻게 보관하나요?
먼저 클라이언트에서 설정을 내보내고 사용자 지정 라우팅과 구독 정보를 별도로 저장하세요. 그런 다음 연결을 끊고 프로그램을 종료합니다. 같은 앱과 프로세서 아키텍처를 유지하면서 설치 프로그램의 안내에 따라 업데이트하세요. 다른 클라이언트로 옮길 때 설정 항목의 호환성이 보장되지는 않습니다. 업데이트 후에는 활성 설정, 수신 포트, 시스템 프록시, 라우팅 모드를 확인하고 백업을 바로 삭제하지 마세요.
설치 파일이 열리지 않거나 아키텍처가 호환되지 않는다고 표시되면 어떻게 하나요?
플랫폼, 프로세서 아키텍처, 파일 형식을 먼저 확인하세요. Windows 다운로드 파일은 ZIP 압축 파일이므로 압축을 푼 뒤 안에 있는 설치 프로그램을 실행해야 합니다. macOS는 DMG, Android는 APK를 사용하고 Linux는 배포판에 따라 deb 또는 rpm을 선택합니다. 그래도 설치할 수 없다면 운영체제 버전과 오류 메시지 전체를 기록해 시스템 호환성 문제인지 설치 권한 문제인지 구분하세요.
버전 표시와 설치 파일 이름이 다를 때는 무엇을 기준으로 봐야 하나요?
버전 표시와 아키텍처별 파일 경로는 목록의 별도 항목에서 가져오므로 서로 다를 수 있습니다. 다운로드할 때 플랫폼, 아키텍처, 파일 이름, 설치 프로그램에 표시된 버전을 함께 확인하세요. 설치 후에는 클라이언트의 정보 화면에 표시된 실제 버전을 기준으로 삼으세요. 다른 설치 파일을 찾으려고 다운로드 주소의 버전 숫자를 직접 바꾸지 마세요.
연결 실패, 구독 업데이트, 트래픽 분기 문제는 자주 묻는 질문에서 확인하세요.