클라이언트 설치 파일운영체제를 먼저 선택한 다음 아키텍처를 확인하세요
운영체제에 맞는 설치 파일을 선택하세요. 데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 우선 권장하며 v2flyNG도 대안으로 제공합니다.
설치 파일에는 서버 설정이 포함되어 있지 않습니다. 설치 후 이용 권한이 있는 구독 주소나 설정 링크를 가져와야 합니다.
설치 파일 목록
기기에 맞는 설치 파일 하나만 다운로드하세요. 플랫폼을 바꾼 뒤에는 카드 아래의 설치 요건도 확인하세요.
Windows x64 설치 파일은 Desktop 버전과 클래식 WPF 버전으로 나뉩니다. 처음 사용한다면 Desktop을, 기존 메뉴 구성이 익숙하다면 WPF를 선택하세요.
차세대 크로스 플랫폼 UI입니다. 새로 설치하거나 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하고 싶은 경우에 적합합니다.
익숙한 Windows 데스크톱 인터페이스를 유지하는 안정적인 클래식 버전입니다. 기존 설정을 사용 중이라면 업데이트 전에 현재 인터페이스 버전을 확인하세요.
| 확인 항목 | 선택 기준 | 설치 전 확인 |
|---|---|---|
| 운영체제 및 아키텍처 | Windows x64용입니다. 지원이 계속되는 Windows 10 또는 Windows 11 사용을 권장합니다. | 설정 → 시스템 → 정보에서 시스템 종류를 확인하세요 |
| 설치 파일 형식 | 해당 버전의 설치 프로그램이 포함된 ZIP 압축 파일 | 압축을 완전히 푼 다음 안에 있는 설치 프로그램을 실행하세요 |
| 실행 환경 | 런타임 요구 사항은 선택한 버전과 배포 패키지에 따라 다릅니다. | 런타임이 없다는 메시지가 표시되면 안내에 따라 필요한 구성 요소를 설치하세요. |
다운로드한 파일의 저장 위치를 열고 ZIP 압축을 쓰기 가능한 폴더에 완전히 푸세요. 압축 파일 미리보기에서 프로그램을 바로 실행하면 필요한 파일이 예상한 위치에 풀리지 않을 수 있습니다. 실행 중인 이전 클라이언트를 종료한 뒤 설치를 진행하세요. 설치 경로와 설정 저장 위치는 다를 수 있으므로 프로그램 폴더를 복사하는 것만으로는 백업이 완성되지 않습니다.
처음 실행했을 때 서버 목록이 비어 있는 것은 정상입니다. 구독 그룹 → 구독 그룹 설정을 열고 그룹과 구독 주소를 추가한 다음 구독을 업데이트하세요. 서버를 선택한 뒤 하단의 시스템 프록시가 시스템 프록시 자동 설정으로 되어 있는지 확인하세요. 처음 연결을 확인할 때는 시스템 프록시를 사용하고, 연결이 되는 것을 확인한 뒤 필요에 따라 TUN 모드를 설정하세요. 한 번에 여러 설정을 바꾸면 문제 원인을 찾기 어렵습니다.
WPF 버전에서 Desktop으로 전환할 때는 기존 설정과 프로그램을 보존한 뒤 새 인터페이스에서 구독, 라우팅, 리슨 포트를 확인하세요. 두 버전을 동시에 실행하면 로컬 혼합 리슨 포트를 함께 사용하려 할 수 있습니다. 포트 충돌이 발생하면 재설치를 반복하지 말고 다른 인스턴스를 먼저 종료하세요. 자세한 사용 방법은 v2rayN 설정 가이드를 참고하세요.
Apple 메뉴의 이 Mac에 관하여에서 칩 이름을 확인하세요. Apple M 시리즈라고 표시되면 Apple Silicon을, Intel 프로세서라고 표시되면 Intel을 선택하세요.
Apple M 시리즈 칩을 탑재한 Mac용입니다. 호환성 계층을 거칠 때 생길 수 있는 변수를 줄이려면 네이티브 아키텍처를 선택하세요.
Intel 칩을 탑재한 Mac용입니다. 컴퓨터 외관이나 구입 연도만으로 프로세서 아키텍처를 판단하지 마세요.
| 확인 항목 | 선택 기준 | 설치 전 확인 |
|---|---|---|
| 칩 아키텍처 | Apple Silicon은 arm64, Intel은 x64에 해당합니다. | Apple 메뉴 → 이 Mac에 관하여를 여세요 |
| 운영체제 호환성 | 최소 운영체제 버전은 현재 설치 파일의 호환성 안내를 확인하세요. | 현재 macOS 버전을 확인하세요. 칩 아키텍처가 맞더라도 운영체제 호환성이 보장되는 것은 아닙니다. |
| 패키지 형식 및 권한 | DMG 디스크 이미지이며, 응용 프로그램 폴더에 쓰기 권한이 필요합니다. | 응용 프로그램 폴더에 설치하고 처음 실행할 때 시스템 안내를 확인하세요 |
DMG를 연 다음 디스크 이미지 창의 안내에 따라 클라이언트를 응용 프로그램 폴더로 옮기고, 해당 폴더에서 실행하세요. 마운트된 디스크 이미지에서 계속 실행하지 마세요. 업데이트하기 전에 이전 클라이언트를 종료하고 메뉴 막대에서 실행 중인 인스턴스가 없는지 확인한 뒤 앱을 교체하세요. 파일이 사용 중이라는 메시지가 나타나면 백그라운드 프로세스를 확인하고 강제로 덮어쓰지 마세요.
처음 실행할 때 시스템 보안 기능이 실행을 차단하면 다운로드 출처와 앱 이름을 먼저 확인한 뒤 시스템 설정 → 개인정보 보호 및 보안에서 관련 안내를 살펴보세요. 설정 위치는 운영체제 버전에 따라 다를 수 있습니다. 출처를 알 수 없는 터미널 명령을 바로 실행하거나 앱 하나를 실행하기 위해 Mac의 보안 기능 전체를 끄지 마세요.
구독을 가져온 뒤 클라이언트에서 서버를 선택하고 시스템 프록시를 활성화하세요. 웹페이지가 여전히 열리지 않으면 브라우저에 별도의 프록시 확장 프로그램이 있는지, 다른 네트워크 도구가 시스템 프록시 설정을 덮어쓰는지 확인하세요. TUN이 필요하다면 클라이언트 안내에 따라 권한을 설정하세요. 클라이언트를 종료하기 전에 시스템 프록시를 해제하면 프로그램이 종료된 뒤에도 브라우저가 로컬 포트에 연결되는 상황을 예방할 수 있습니다.
Xray 코어를 사용하는 Android 그래픽 클라이언트입니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택하면 되지만, 최종 기준은 기기의 운영체제가 실제로 지원하는 아키텍처입니다.
arm64-v8a를 지원하는 기기에 권장합니다. 단일 아키텍처용으로 구성되어 일반 버전보다 파일 크기가 작은 편입니다.
아키텍처를 확인하기 어려울 때 선택할 수 있는 대안입니다. 여러 아키텍처를 포함하며 arm64 버전과 함께 설치할 필요는 없습니다.
V2Fly 코어 환경이 필요한 경우 사용할 수 있는 Android 대안입니다. 선택하기 전에 현재 설정에서 사용하는 프로토콜과 전송 방식이 이 클라이언트에서 지원되는지 확인하세요.
arm64-v8a를 지원하는 기기용입니다. 다른 클라이언트가 설치되어 있다면 테스트 전에 해당 클라이언트의 연결을 종료하세요.
아키텍처를 확인하기 어려울 때 선택하세요. 클라이언트를 바꾸기 전에 구독 주소를 보관하고, 두 앱이 같은 설정 폴더를 사용한다고 가정하지 마세요.
| 확인 항목 | 선택 기준 | 설치 전 확인 |
|---|---|---|
| 프로세서 및 시스템 아키텍처 | 대부분의 기기는 arm64를 우선 선택하고, 확실하지 않으면 범용 버전을 선택하세요. | 기기 사양을 확인하세요. 일부 기기는 이전 시스템 아키텍처를 사용할 수 있습니다. |
| 운영체제 버전 | 최소 버전 요건은 설치 프로그램에 표시되는 현재 패키지 안내를 확인하세요. | 설정 → 휴대전화 정보에서 Android 버전을 확인하세요 |
| 설치 및 연결 권한 | 현재 사용하는 브라우저나 파일 관리자에서 앱 설치를 허용해야 하며, 연결하려면 VPN 권한이 필요합니다. | 이번 설치에 사용할 앱에만 설치 권한을 허용하고, 설치 후에는 권한을 끌 수 있습니다. |
APK를 다운로드한 뒤 브라우저의 다운로드 목록이나 파일 관리자에서 파일을 여세요. 설치를 허용하라는 안내가 나오면 방금 사용한 브라우저나 파일 관리자에 권한이 부여되는지 확인하세요. 앱이 설치되지 않는다는 메시지가 나오면 아키텍처 비호환, 저장 공간 부족, 이전 버전과 새 버전의 서명 불일치 여부를 먼저 확인하세요. 범용 버전은 일부 아키텍처 선택 문제를 해결할 수 있지만 서명 충돌은 해결하지 못합니다.
v2rayNG를 연 다음 구독 그룹 설정에 구독 주소를 추가하고 저장한 뒤 구독 업데이트를 실행하세요. 목록에 설정이 표시되면 하나를 선택하고 연결 버튼을 누르세요. 처음 연결할 때 시스템 VPN 권한 요청이 나타납니다. 승인해야 기기 전체의 연결을 설정할 수 있습니다. 일반적으로 휴대전화에서는 같은 종류의 VPN 서비스를 여러 개 동시에 사용할 수 없습니다. 테스트 전에 해당 연결을 사용하는 다른 앱을 일시 중지해 권한이 서로 전환되지 않도록 하세요.
화면을 잠근 뒤 연결이 끊기면 설치 파일을 바꾸기보다 앱의 배터리 관리, 백그라운드 실행 제한, 시스템 절전 모드를 먼저 확인하세요. 모바일 네트워크에서만 문제가 발생한다면 Wi-Fi에서도 같은지 비교해 보세요. v2rayNG와 v2flyNG를 비교 테스트할 때는 각 클라이언트에 설정을 따로 가져오고 로그도 각각 확인하세요. 한 코어에서 설정을 읽을 수 있다고 해서 다른 코어가 모든 매개변수를 지원하는 것은 아닙니다.
Linux 데스크톱 환경용입니다. 먼저 배포판에서 deb와 rpm 중 어떤 패키지 형식을 사용하는지 확인한 다음 프로세서가 x86_64인지 aarch64인지 확인하세요.
호환되는 Debian, Ubuntu 등 데스크톱 배포판에서 사용합니다. 패키지 이름의 amd64는 x64 아키텍처를 뜻하며 특정 프로세서 제조사에 한정되지 않습니다.
호환되는 RPM 계열 배포판에서 사용합니다. 파일 확장자만 확인하지 말고 패키지의 요구 사항을 충족하는 종속성과 운영체제 버전인지도 확인하세요.
| 확인 항목 | 선택 기준 | 설치 전 확인 |
|---|---|---|
| 프로세서 아키텍처 | x86_64는 x64, aarch64는 arm64를 선택하세요. | 시스템 정보에서 아키텍처를 확인하세요. 필요한 경우 uname -m을 실행하세요. |
| 배포판 및 패키지 형식 | Debian 계열은 주로 deb, RPM 계열은 주로 rpm을 사용합니다. | 배포판 버전과 패키지 관리자 호환성을 확인하세요. |
| 데스크톱 및 종속성 | 사용 가능한 그래픽 데스크톱과 네트워크 연결, 요구 사항을 충족하는 시스템 라이브러리가 필요합니다. | 시스템 소프트웨어 설치 관리자로 종속성을 처리하고 오류 메시지를 기록하세요. |
아키텍처에 맞는 패키지를 다운로드한 뒤 배포판에 기본 포함된 소프트웨어 설치 관리자로 여세요. 종속성 부족 메시지가 표시되면 누락된 라이브러리 이름과 최소 버전을 기록한 다음 시스템 업데이트가 필요한지 확인하세요. 클라이언트를 설치하려고 종속성 검사를 강제로 건너뛰거나 다른 배포판의 시스템 라이브러리로 현재 환경의 파일을 덮어쓰지 마세요. 아키텍처가 맞더라도 오래된 배포판에는 설치 파일이 요구하는 런타임이 없을 수 있습니다.
설치가 끝나면 앱 메뉴에서 v2rayN을 실행하고 일반 데스크톱 사용자 권한으로 구독을 설정하세요. 시스템 프록시는 보통 현재 데스크톱 세션에만 적용되며 터미널 도구나 모든 앱에 적용되는 것은 아닙니다. 시스템 프록시를 따르는 브라우저에서 먼저 확인한 다음 다른 프로그램의 프록시 설정을 각각 점검하세요. TUN에는 추가 네트워크 권한이 필요합니다. 권한을 올바르게 설정하는 대신 그래픽 클라이언트 전체를 상시 관리자 권한으로 실행하지 마세요.
부팅 후 자동 실행이 필요하다면 수동 실행, 구독 업데이트, 종료 시 정리가 정상적으로 작동하는지 먼저 확인한 다음 데스크톱 환경의 시작 앱 설정을 사용하세요. 업데이트 후 트레이 아이콘이 두 개 나타나면 이전 바로 가기와 새 자동 실행 항목이 함께 남아 있는지 확인하세요. 자세한 데스크톱 설치 방법은 deb/rpm 설치 및 부팅 시 자동 실행을 참고하세요.
설치 전후 확인
설치 문제와 연결 문제를 나누어 점검하세요. 한 번에 하나씩 변경하고 문제를 재현할 수 있는 단서를 남겨 두세요.
현재 클라이언트 이름, 인터페이스 버전, 리슨 포트와 라우팅 모드를 기록하고 클라이언트의 내보내기 또는 백업 기능으로 설정을 저장하세요. 구독 주소에는 접근 자격 증명이 포함될 수 있으므로 백업을 안전한 위치에 보관하세요. 스크린샷이나 문의에 첨부하는 로그에는 전체 주소가 노출되지 않도록 하세요.
이전 프로그램을 종료한 뒤 설치하고 트레이나 백그라운드에 실행 중인 인스턴스가 남아 있지 않은지 확인하세요. 아키텍처, 설치 출처 또는 데스크톱 인터페이스 버전을 바꾸는 경우에는 설정 이전 방법을 먼저 확인하세요. 설치 프로그램 오류가 발생했다고 기존 설정을 바로 삭제하지 마세요. 반복해서 덮어쓰기보다 이전 상태로 되돌릴 수 있는 편이 중요합니다.
구독을 가져온 뒤 서버 목록이 업데이트됐는지 확인하고 설정을 선택해 연결하세요. 구독은 설정을 배포하는 방식이지 클라이언트에 서비스가 포함된다는 뜻이 아닙니다. 구독 주소가 만료됐거나 이용 권한이 끝났거나 설정 형식이 호환되지 않는다면 해당 단계에서 해결해야 합니다.
업데이트에 실패하면 연결할 수 없는지, 주소 접근이 거부됐는지, 내용을 인식할 수 없는지 오류 유형부터 확인하세요. 이미 연결을 사용할 수 있다면 일반 업데이트와 프록시를 사용하지 않는 업데이트 결과를 비교해 볼 수 있습니다. 접근 권한이 노출될 수 있으므로 출처가 불분명한 변환 웹사이트에 구독 주소를 입력하지 마세요.
데스크톱에서는 로컬 리슨이 정상적으로 시작됐는지 확인한 다음 시스템 프록시 자동 설정을 켜세요. Android에서는 VPN 권한과 연결 상태를 먼저 확인하세요. 실제로 접속하려는 웹사이트를 열어 확인하세요. 한 번의 지연 시간 테스트는 특정 테스트 방식만 보여 줄 뿐, 전체적인 접속 결과를 대신하지 못합니다.
브라우저는 정상인데 터미널에서 연결되지 않는다면 터미널의 프록시 설정을 따로 확인하세요. 일부 도메인만 실패하면 라우팅과 DNS를 이어서 점검하세요. 먼저 한 가지 연결 방식으로 기준을 잡고, 여러 클라이언트와 프록시 확장 프로그램을 동시에 사용하지 마세요.
운영체제 버전, 클라이언트 이름, 아키텍처와 오류 원문을 기록하세요. 설치 프로그램이 열리지 않는지, 프로그램이 시작하자마자 종료되는지, 구독 업데이트가 실패하는지, 연결 후 접속이 되지 않는지 구체적으로 설명하세요. 단계별 증상에 따라 점검할 항목이 다릅니다.
포트 충돌은 다른 클라이언트를 먼저 확인하고, 이름 확인 실패는 DNS를, 화면을 잠근 뒤 연결이 끊기는 문제는 백그라운드 제한을 확인하세요. 로그를 공유하기 전에 구독 주소, 접근 자격 증명, 개인 네트워크 정보를 삭제하세요. 증상에 맞는 해결 방법은 문제 해결 가이드에서 확인하고, 모든 문제를 설치 파일 탓으로 돌리지 마세요.
다운로드 및 설치 FAQ
설치 파일에는 클라이언트 프로그램만 포함되어 있으며, 사용할 수 있는 서버 설정은 제공되지 않습니다. 이용 권한이 있는 구독 주소나 설정 링크를 준비해 v2rayN의 구독 그룹에 추가하고 구독을 업데이트하거나 클립보드에서 가져오세요. Android 클라이언트에서는 구독 그룹 설정에 주소를 추가한 다음 구독 업데이트를 실행하면 됩니다.
처음 사용한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 Desktop 버전을 권장합니다. 기존 Windows 메뉴와 사용 방식에 익숙하다면 클래식하고 안정적인 WPF 버전을 선택하세요. 두 버전은 인터페이스가 다를 뿐, 서버 리소스가 함께 제공되는 것은 아닙니다. 전환하기 전에 설정을 백업하고 실행 중인 클라이언트를 종료하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택하면 됩니다. 단, 기기의 운영체제가 실제로 지원하는 아키텍처를 기준으로 하세요. 확인하기 어렵거나 arm64 패키지가 호환되지 않는다고 표시되면 범용 버전을 선택할 수 있습니다. 범용 버전은 여러 아키텍처를 포함해 파일 크기가 더 큰 편이며, 같은 클라이언트의 두 패키지를 동시에 설치할 필요는 없습니다.
일반적으로 설정을 먼저 백업하고 클라이언트를 종료한 뒤, 같은 앱과 설치 출처, 동일한 아키텍처의 버전으로 업데이트하면 됩니다. 기존 설정을 먼저 삭제하지 마세요. Android에서 서명 충돌이 발생하면 덮어쓰기를 반복하거나 곧바로 삭제하지 말고 앱의 설치 출처와 백업 복원 가능 여부부터 확인하세요. 데스크톱 인터페이스 버전 간 설정을 옮길 때는 별도로 이전 방법을 확인해야 합니다.
먼저 설정을 가져왔는지, 서버를 선택했는지 확인한 뒤 로그에서 로컬 포트 충돌이나 연결 오류를 살펴보세요. 데스크톱에서는 시스템 프록시 자동 설정이 켜져 있는지, Android에서는 VPN 권한과 연결 상태를 확인하세요. 프로그램 파일 손상, 아키텍처 불일치 또는 설치 실패가 확인된 경우에만 설치 파일 문제를 우선 점검하세요.
브라우저 다운로드 목록에 작업이 표시되는지, 디스크 공간과 저장 폴더 권한이 충분한지 먼저 확인하세요. 네트워크가 끊겼다면 같은 설치 파일을 다시 다운로드하면 됩니다. 다운로드가 끝나지 않은 파일을 설치 파일로 착각해 실행하지 마세요. 문제가 계속되면 운영체제, 아키텍처, 패키지 형식과 브라우저 오류 메시지를 기록하고 정상적인 다른 네트워크에서 다시 시도하세요.
설치가 끝나면 설정 가이드를 따라 구독을 가져오세요. 증상별 해결 방법은 문제 해결에서 확인할 수 있습니다.