v2rayN
추천Desktop은 차세대 크로스 플랫폼 UI이며, WPF는 익숙하고 안정적인 기존 인터페이스를 제공합니다. 처음 설치한다면 Desktop을, 기존 메뉴 구성이 익숙하다면 WPF를 선택하세요.
다운로드 파일은 ZIP 압축 파일입니다. 별도 폴더에 압축을 푼 다음 안에 있는 설치 프로그램을 실행하세요. 압축 프로그램의 미리보기 창에서 바로 실행하지 마세요.
CLIENT PACKAGES / 클라이언트 설치 파일
V2Ray 클라이언트 다운로드
v2rayN / v2rayNG
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. 운영체제를 고른 다음 프로세서 아키텍처를 확인하세요. 구독과 서버 설정은 별도로 가져와야 합니다.
운영체제별 설치 파일 선택
플랫폼을 전환해도 주소 앵커가 유지되므로 해당 다운로드 항목을 북마크할 수 있습니다. 버튼에 표시된 아키텍처나 인터페이스 버전을 다운로드 전에 다시 확인하세요.
Windows 시스템 및 설치 조건
| 확인 항목 | 선택 기준 |
|---|---|
| 프로세서 | 이 페이지의 두 다운로드 항목은 모두 x64 패키지입니다. 설정 → 시스템 → 시스템 정보에서 시스템 종류를 확인하세요. |
| 운영체제 버전 | 지속적으로 지원되는 Windows 10 또는 11을 권장합니다. 세부 호환 범위는 현재 패키지 안내를 확인하세요. |
| 실행 종속성 | 실행 시 .NET Desktop Runtime이 없다는 메시지가 표시되면 해당 버전에 필요한 아키텍처의 런타임을 설치하세요. |
| 처음 실행 | 일반적인 프록시 설정에는 관리자 권한이 필요하지 않습니다. TUN 등의 기능을 사용할 때는 권한 상승이 필요할 수 있습니다. |
두 버전의 주된 차이는 인터페이스 기술과 조작 방식이지 프록시 프로토콜이 아닙니다. 인터페이스를 바꾼다는 이유만으로 서버 매개변수를 모두 다시 설정하지 마세요. 먼저 백업한 다음 새 버전에서 가져올 수 있는 설정 형식을 확인하세요.
v2rayN
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. Apple 칩이라고 표시되면 Apple Silicon을, Intel 프로세서라고 표시되면 Intel을 선택하세요. 칩에 맞는 패키지를 바로 선택하는 편이 먼저 다운로드해 시험하는 것보다 간편합니다.
DMG를 연 뒤 앱을 ‘응용 프로그램’ 폴더로 옮겨 실행하세요. 마운트된 디스크 이미지를 계속 실행하는 위치로 사용하지 마세요.
macOS 시스템 및 설치 조건
| 확인 항목 | 선택 기준 |
|---|---|
| Apple 칩 | M 시리즈 칩은 arm64에 해당합니다. Apple Silicon 설치 패키지를 우선 사용하세요. |
| Intel 칩 | x64 DMG를 선택하세요. arm64 패키지는 설치하지 마세요. |
| 시스템 호환성 | 현재 릴리스 노트의 최소 시스템 요구 사항을 먼저 확인하세요. 오래된 시스템에서 현재 패키지가 작동한다고 보장할 수 없습니다. |
| 접근 권한 | 시스템 프록시나 TUN을 사용할 때는 해당 기능에 필요한 시스템 권한 요청에 응답하세요. |
시스템 프록시와 앱 내부 프록시는 별도의 설정입니다. 브라우저에서 프록시를 따로 관리하는 확장 프로그램을 사용한다면 시스템 설정을 덮어쓰지 않는지 확인하세요. 설정을 변경하기 전에 기존 값을 기록해 두면 쉽게 복구할 수 있습니다.
v2rayNG
추천일반적인 Android 설정이라면 이 클라이언트를 우선 선택하세요. VLESS, REALITY 등의 매개변수를 사용하기 전에는 현재 코어와 공유 링크의 세부 설정을 확인해야 합니다.
2015년 이후 출시된 대부분의 스마트폰에서는 arm64를 선택하면 됩니다. 기기가 64비트 앱을 지원하지 않거나 아키텍처를 모르면 범용 버전을 고려하세요.
v2flyNG
대안기존 V2Fly 설정을 사용하거나 해당 코어가 필요한 사용자에게 적합합니다. Xray 전용 설정을 그대로 적용하지 말고 프로토콜과 전송 매개변수의 지원 범위를 먼저 확인하세요.
범용 버전은 여러 아키텍처를 지원하므로 보통 파일 크기가 더 큽니다. 기능이 강화된 버전은 아니며 같은 설정의 속도를 자동으로 높여 주지도 않습니다.
Android 시스템 및 설치 조건
| 확인 항목 | 선택 기준 |
|---|---|
| 앱 아키텍처 | arm64는 64비트 앱을 지원하는 ARM 기기에 해당합니다. 프로세서가 64비트를 지원하더라도 운영체제에서 64비트 앱을 허용한다고 단정할 수는 없습니다. |
| 운영체제 버전 | 선택한 앱 패키지의 최소 Android 버전을 확인하세요. 범용 버전도 최소 시스템 버전 제한을 우회할 수 없습니다. |
| 설치 권한 | APK를 여는 데 실제로 사용하는 브라우저나 파일 관리자에 이번 설치를 허용하세요. 설치가 끝나면 권한을 다시 해제할 수 있습니다. |
| 연결 권한 | 처음 연결할 때 시스템 VPN 권한을 승인해야 합니다. 다른 VPN 앱이 같은 연결 슬롯을 사용 중일 수도 있습니다. |
| 백그라운드 실행 | 화면을 잠근 뒤 연결이 끊긴다면 배터리 최적화와 백그라운드 활동 제한을 확인하세요. 처음부터 모든 권한을 완화할 필요는 없습니다. |
v2rayN
Debian이나 Ubuntu 계열은 deb를, RPM 패키지 관리자를 사용하는 배포판은 rpm을 선택하세요. 패키지 형식이 맞는지 확인한 뒤 시스템 라이브러리와 배포판의 호환성도 점검해야 합니다.
amd64와 x86_64는 여기서 같은 x64 아키텍처를 뜻하며, aarch64는 arm64에 해당합니다. 패키지 이름의 차이를 기능이 다른 버전으로 오해하지 마세요.
Linux 시스템 및 설치 조건
| 확인 항목 | 선택 기준 |
|---|---|
| 실행 환경 | 그래픽 데스크톱 세션이 필요합니다. 이 다운로드 항목은 데스크톱 클라이언트용입니다. |
| 프로세서 | x64 기기는 amd64 / x86_64 패키지를, ARM 64비트 기기는 arm64 / aarch64 패키지를 선택하세요. |
| 패키지 설치 | 시스템 소프트웨어 설치 프로그램으로 deb 또는 rpm을 여세요. 패키지 관리자가 종속성과 설치 기록을 처리합니다. |
| 시스템 라이브러리 | 현재 패키지의 종속성 요구 사항을 확인하세요. RPM 파일명의 배포판 빌드 표시는 모든 RPM 기반 시스템에서 사용할 수 있다는 뜻이 아닙니다. |
설치가 완료되었는데 실행되지 않는다면 앱 시작 로그와 패키지 관리자의 안내를 먼저 확인하세요. 종속성이 부족하면 배포판의 소프트웨어 관리 도구로 설치하세요. 다른 시스템의 라이브러리 파일을 복사해 덮어쓰지 마세요.
AFTER INSTALLATION
설치 후: 가져오기, 선택, 확인
다운로드로 프로그램은 설치할 수 있지만 연결에는 설정과 기기 프록시 구성도 필요합니다. 단계를 나눠 진행하면 문제가 생겼을 때 원인을 찾기 쉽습니다.
업데이트하거나 인터페이스를 바꾸기 전에 백업
기존 클라이언트를 사용 중이라면 구독 그룹, 업데이트 주기, 시스템 프록시 모드, 라우팅 규칙, 사용자 지정 DNS를 먼저 기록하세요. 클라이언트에서 내보낸 전체 설정과 개별 공유 링크는 서로 다릅니다. 공유 링크에는 보통 연결 하나에 필요한 매개변수만 들어 있으며 로컬 라우팅이나 환경 설정은 포함되지 않을 수 있습니다. 구독 주소가 포함된 파일을 공개 공간에 올리지 말고 직접 관리할 수 있는 위치에 백업하세요.
업데이트 전에 기존 프로그램을 종료하고 백그라운드 프로세스가 남아 있지 않은지 확인하세요. 설치 후에는 ‘정보’ 화면에서 실제 실행 중인 버전을 확인한 다음 설정이 유지되었는지 점검하세요. Desktop과 WPF를 함께 사용한다면 두 프로그램이 로컬 수신 포트를 동시에 사용하지 않도록 하세요. 데이터 디렉터리 규칙을 확인하기 전에는 두 인스턴스가 같은 설정 디렉터리를 함께 수정하지 않도록 주의하세요.
구독 및 공유 링크 가져오기
데스크톱에서는 구독 그룹이나 클립보드 가져오기를, Android에서는 설정 추가 메뉴에서 해당 방식을 선택하세요. 구독 주소는 여러 설정을 업데이트하는 경로이며 공유 링크는 보통 단일 설정에 해당하므로 각각 맞는 위치에 입력해야 합니다. 구독을 추가한 뒤 업데이트를 실행해야 설정 목록을 가져올 수 있습니다. 결과가 비어 있다면 주소가 완전한지, 만료되지 않았는지, 클라이언트가 응답 형식을 지원하는지 확인하세요.
프로토콜 이름만으로 모든 매개변수가 자동으로 채워지지는 않습니다. VLESS, VMess, Trojan을 사용할 때는 주소, 포트, 인증 정보, 전송 방식, 보안 설정을 함께 맞춰야 합니다. REALITY에는 추가로 일치해야 하는 매개변수가 있습니다. 가져온 뒤 지원하지 않는 필드라는 안내가 나오면 반복해서 삭제하고 재설치하기보다 클라이언트가 사용하는 코어를 확인하세요. 자세한 절차는 v2rayN 및 v2rayNG 사용 안내를 참고하세요.
연결은 최소한의 범위부터 확인
설정 하나를 선택해 연결을 시작한 다음 시스템 프록시나 Android VPN 상태를 확인하세요. 프록시 설정을 따르는 것이 확실한 앱 하나로 테스트하고 프록시 관리 도구를 여러 개 동시에 켜지 마세요. 노드 속도 측정은 특정 테스트 조건의 결과일 뿐 웹 접속, DNS 확인, 대상 앱에서의 실제 연결을 대신하지 않습니다. 테스트가 실패해도 설치 파일을 잘못 골랐다고 단정하기 전에 테스트 유형을 확인하세요.
연결 후 웹페이지가 열리지 않으면 로컬 포트, 시스템 프록시, 기기 시간, 라우팅, DNS 순으로 확인하세요. 로그를 문의에 첨부하기 전에 인증 정보나 구독 주소가 포함된 부분을 가리세요. 프로토콜과 코어 차이는 프로토콜 안내서에서 확인할 수 있습니다. 자주 발생하는 증상은 FAQ에서 찾아보세요. 설정 하나 때문에 클라이언트를 계속 바꾸지 않아도 됩니다.
다운로드 및 설치 FAQ
다음 단계를 정하기 전에 패키지 형식, 아키텍처, 시스템 종속성, 설정 문제를 구분하세요.
Windows에서는 Desktop과 기존 WPF 버전 중 무엇을 선택해야 하나요?
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 Desktop 버전을 권장합니다. 기존 창과 메뉴 구성에 익숙하다면 WPF 버전을 계속 사용할 수 있습니다. 두 버전 모두 프록시 설정을 관리하지만 인터페이스와 실행 종속성이 다릅니다. 전환하기 전에 구독 그룹, 라우팅 규칙, 사용자 지정 설정을 백업하세요.
Android에서는 arm64와 범용 버전 중 무엇을 다운로드해야 하나요?
2015년 이후 출시된 대부분의 스마트폰은 arm64 버전을 우선 선택하면 됩니다. 다만 기기에서 실제로 지원하는 앱 아키텍처를 확인하세요. 아키텍처를 모르면 범용 버전을 선택할 수 있습니다. 앱을 설치할 수 없거나 호환되지 않는다는 메시지가 나오면 아키텍처만 바꾸지 말고 Android 버전과 설치 파일의 다운로드 완료 여부도 확인하세요.
v2rayNG와 v2flyNG는 설정을 그대로 서로 바꿔 사용할 수 있나요?
클라이언트 이름이 비슷하다고 설정까지 완전히 호환되는 것은 아닙니다. v2rayNG는 Xray 코어, v2flyNG는 V2Fly 코어를 사용하며 지원하는 프로토콜, 전송 방식, 보안 매개변수가 다릅니다. REALITY 같은 설정을 사용할 때는 대상 코어의 지원 여부를 먼저 확인한 뒤 설정을 가져와 점검하세요.
설치했는데 설정 목록이 비어 있는 이유는 무엇인가요?
클라이언트 설치 파일에는 프로그램만 포함되며 서버 설정은 제공되지 않습니다. 기존 구독 주소나 공유 링크를 가져온 다음 구독을 업데이트하고 설정을 선택해야 합니다. 구독 주소는 민감한 정보이므로 공개 스크린샷에 노출하지 마세요. 가져오기 방법은 사이트의 안내를 참고하세요.
클라이언트를 업데이트하기 전에 이전 버전을 삭제해야 하나요?
일반적으로 이전 프로그램을 종료하고 설정을 백업한 뒤 설치 프로그램이나 시스템 패키지 관리자의 업데이트 절차를 따르면 됩니다. 먼저 삭제할 필요는 없습니다. Android에서 덮어 설치하려면 앱 서명이 같아야 합니다. 서명 충돌이 발생하면 설정을 내보내고 설치 파일의 출처를 확인하세요. 바로 삭제하면 기기에 저장된 설정이 사라질 수 있습니다.
다운로드 페이지의 버전 표시와 파일명이 다른데 무엇을 기준으로 해야 하나요?
버전 표시는 앱 자체의 버전 정보에서 가져오며, 다운로드 파일은 해당 플랫폼의 설치 패키지 정보에 따라 표시됩니다. 두 정보의 업데이트 시점이 다를 수 있습니다. 다운로드 파일에 해당하는 릴리스 노트와 설치 후 ‘정보’ 화면에 표시되는 버전을 기준으로 확인하세요. 다운로드 주소의 버전 숫자를 직접 바꿔 설치 파일을 찾지 마세요.