클라이언트 설치 파일
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 추천합니다. 운영체제를 먼저 선택한 뒤 프로세서 아키텍처에 맞는 설치 파일을 다운로드해 기기와 패키지가 맞지 않는 상황을 피하세요.
기기에 맞는 버전 선택
플랫폼 선택은 주소창에 저장되므로 현재 페이지 링크를 복사할 수 있습니다.
두 링크 모두 x64 압축 파일입니다. 다운로드 후 압축을 완전히 푼 다음 안에 있는 설치 프로그램을 실행하세요.
차세대 크로스 플랫폼 UI를 적용했습니다. 처음 설치하거나 여러 데스크톱 운영체제에서 비슷한 인터페이스를 사용하고 싶다면 적합합니다.
데스크톱 버전 다운로드 · x64v2rayN-Desktop-Setup-x64-7.24.1.zip
기존 Windows 인터페이스를 사용하는 클래식 안정 버전입니다. 기존 메뉴 구성에 익숙하거나 같은 사용 방식을 유지하고 싶다면 선택하세요.
클래식 WPF 버전 다운로드 · x64v2rayN-Setup-x64-7.24.1.zip
두 버전의 주요 차이는 인터페이스 기술과 구성입니다. 같은 서버를 사용한다고 해서 어느 한쪽이 반드시 더 빠른 것은 아닙니다. 처음 설정할 때는 한 버전만 실행해 로컬 포트 충돌을 방지하세요.
| 확인 항목 | 다운로드 전 확인 |
|---|---|
| 시스템 아키텍처 | 이 페이지에서는 x64 패키지를 제공합니다. 「설정 → 시스템 → 시스템 정보」에서 시스템 종류를 확인하세요. |
| 실행 환경 | 설치 프로그램의 시스템 및 런타임 안내를 따르세요. 구성 요소가 없으면 안내에 따라 설치하세요. |
| 폴더 권한 | 설정 폴더에 쓰기 권한이 있는지 확인하세요. 미리 보기 창에서 압축 파일을 바로 실행하지 마세요. |
| 프록시 권한 | 일반 시스템 프록시와 Tun은 필요한 권한이 다릅니다. 먼저 기본 프록시 연결부터 확인하세요. |
먼저 압축 파일을 별도 폴더에 풀고 설치 프로그램을 실행하세요. 처음 실행하면 창이 정상적으로 표시되는지 확인하고 런타임 안내도 살펴보세요. 서버 목록이 비어 있다고 클라이언트를 반복해서 재설치할 필요는 없습니다. 보통은 아직 설정을 가져오지 않은 상태입니다.
「구독 그룹 설정」에서 구독 주소를 추가하고 저장한 뒤 「프록시를 사용하지 않고 구독 업데이트」를 실행하세요. 구독 서비스에서 프록시를 통한 업데이트를 명시적으로 요구한다면 상황에 맞게 설정을 조정하세요. 유효한 설정을 선택한 다음 「시스템 프록시」에서 「시스템 프록시 자동 설정」을 클릭하고 브라우저로 연결을 테스트하세요.
클래식 WPF 버전에서 Desktop 버전으로 바꾸기 전에 설정을 내보내고 라우팅 모드를 기록하세요. 기존 버전을 종료한 다음 새 버전을 실행하고, 다른 프로그램이 로컬 수신 포트를 사용 중인지 확인하세요. 프록시가 필요하지 않을 때는 클라이언트를 종료하기 전에 시스템 프록시를 해제해야 브라우저가 중지된 로컬 포트에 계속 연결하는 일을 막을 수 있습니다.
첫 설치 및 초기 설정 보기 →시스템 메뉴에서 「이 Mac에 관하여」를 열고 칩 또는 프로세서 이름에 맞는 DMG를 선택하세요.
「이 Mac에 관하여」에 Apple 계열 칩이 표시되면 이 패키지를 선택하세요. 해당 칩 아키텍처에 맞는 네이티브 앱입니다.
Apple Silicon 버전 다운로드v2rayN-macos-arm64.dmg
「이 Mac에 관하여」에 Intel 프로세서가 표시되면 이 패키지를 선택하세요. 컴퓨터 외관이나 구매 연도만으로 판단하지 마세요.
Intel 버전 다운로드v2rayN-macos-64.dmg
다운로드한 DMG를 열고 앱을 「응용 프로그램」 폴더로 옮긴 다음 해당 폴더에서 실행하세요. 복사가 끝나면 디스크 이미지를 추출해도 됩니다.
| 확인 항목 | 다운로드 전 확인 |
|---|---|
| 칩 종류 | Apple Silicon은 arm64, Intel은 x64에 해당합니다. |
| 운영체제 호환성 | 현재 설치 파일의 호환성 안내를 확인하세요. 오래된 운영체제에서는 실행 가능 여부를 먼저 살펴봐야 합니다. |
| 설치 위치 | 앱을 「응용 프로그램」 폴더로 복사하세요. 디스크 이미지에서 계속 실행하지 마세요. |
| 시스템 권한 | 프록시 설정을 변경하거나 Tun을 켤 때 시스템 승인 또는 관리자 권한이 필요할 수 있습니다. |
앱 복사를 마친 뒤 클라이언트를 실행하세요. 시스템 보안 경고가 표시되면 다운로드 출처와 경고 내용을 먼저 확인하세요. 실행을 허용해야 한다면 「시스템 설정 → 개인정보 보호 및 보안」에서 관련 항목을 살펴보세요. 앱 하나의 실행 문제를 해결하려고 시스템 보안 기능 전체를 끄지 마세요.
앱을 연 뒤 유효한 구독을 가져오고 서버 설정이 목록에 표시되는지 확인한 다음 시스템 프록시를 설정하세요. 모든 데스크톱 앱이 시스템 프록시를 따르는 것은 아니므로 브라우저로 기본 연결을 먼저 테스트해야 합니다. 특정 앱에서만 문제가 계속되면 해당 앱의 프록시 설정을 확인하거나 Tun 사용을 검토하세요.
업그레이드 전에 실행 중인 앱을 종료하고 구독 및 라우팅 설정을 보존한 다음 앱 파일을 교체하세요. 업데이트 후 화면은 열리지만 웹페이지에 접속할 수 없다면 프로토콜을 바로 바꾸지 말고 시스템 프록시 상태와 로컬 포트를 먼저 확인하세요. 클라이언트를 종료한 뒤 네트워크에 문제가 생겨도 시스템 프록시가 로컬 주소를 가리키고 있는지 우선 살펴보세요.
데스크톱 설정 단계 보기 →2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택하면 됩니다. 아키텍처를 모른다면 범용 버전을 선택하고 기기의 실제 호환성을 확인하세요.
64비트 앱을 지원하는 일반적인 Android 기기에 적합합니다. 프로세서의 홍보 명칭만 보지 말고 기기의 아키텍처를 확인해 선택하세요.
v2rayNG 다운로드 · arm64v2rayNG_2.3.11_arm64-v8a.apk
더 다양한 프로세서 아키텍처를 지원합니다. 기기 정보를 확인하기 어렵거나 arm64 패키지가 호환되지 않는다고 표시될 때 시도해 보세요.
v2rayNG 다운로드 · 범용v2rayNG_2.3.11_universal.apk
카드의 버전 정보와 플랫폼별 파일 주소는 따로 업데이트될 수 있습니다. 다운로드 파일 이름은 링크 아래에서 확인하고 실제 설치 버전은 클라이언트의 「정보」 화면에서 확인하세요.
v2fly 코어가 필요한 사용자 중 64비트 앱을 지원하는 기기에 적합합니다. 구독의 프로토콜 매개변수가 지원되는지 먼저 확인하세요.
v2flyNG 다운로드 · arm64v2flyNG_1.10.31-fdroid_arm64-v8a.apk
아키텍처를 확인하기 어려운 기기를 위한 대안입니다. 기기와 설치 파일이 호환된다고 해서 모든 구독 및 프로토콜 조합을 처리할 수 있는 것은 아닙니다.
v2flyNG 다운로드 · 범용v2flyNG_1.10.31-fdroid_universal.apk
v2rayNG와 v2flyNG는 서로 다른 코어 생태계를 사용합니다. 이름이 비슷하다고 모든 설정을 그대로 바꿔 쓸 수 있는 것은 아닙니다.
| 확인 항목 | 다운로드 전 확인 |
|---|---|
| 앱 아키텍처 | arm64는 시스템이 64비트 앱을 지원해야 합니다. 확실하지 않다면 범용 버전을 고려하세요. |
| 설치 권한 | 시스템 안내에 따라 현재 브라우저나 파일 관리자가 앱을 설치할 수 있도록 일시적으로 허용하세요. |
| 시스템 버전 | 설치 프로그램의 호환성 안내를 따르세요. 범용 버전으로 오래된 시스템의 호환성 문제를 해결할 수는 없습니다. |
| 연결 권한 | 처음 연결할 때 시스템 VPN 요청을 확인하세요. 다른 VPN 앱이 동시에 연결을 관리하지 않도록 주의하세요. |
설치 후 사이드 메뉴를 열어 「구독 그룹 설정」으로 이동하고 이름과 구독 주소를 추가하세요. 저장한 뒤 메인 화면으로 돌아가 구독을 업데이트하면 됩니다. 버전에 따라 메뉴 위치가 조금 다를 수 있지만, 먼저 그룹을 저장하고 콘텐츠를 업데이트해야 합니다. 주소만 붙여넣고 업데이트하지 않으면 서버 목록에 표시되지 않습니다.
유효한 설정을 선택한 뒤 연결 버튼을 누르세요. 시스템에서 VPN 권한을 요청하면 현재 클라이언트에서 보낸 요청인지 확인하세요. 상태 표시줄의 연결 아이콘은 시스템 연결 통로가 시작되었다는 뜻일 뿐이므로 브라우저를 열어 실제 접속 여부를 확인해야 합니다. 가져오기에 실패하면 구독 주소가 완전하고 만료되지 않았는지 확인한 뒤 클라이언트가 해당 프로토콜을 인식할 수 있는지 살펴보세요.
업데이트 설치 중 서명 충돌이 표시되어도 기존 앱을 바로 삭제하지 마세요. 먼저 설정을 내보내거나 백업하고, 새 앱과 기존 앱의 설치 출처 및 서명이 같은지 확인한 뒤 이전 방법을 결정하세요. 시스템 절전 설정으로 백그라운드 연결이 끊길 수도 있습니다. 실제로 백그라운드 앱이 종료되는 경우에만 앱 배터리 설정에서 제한을 조정하고 배터리 사용량을 살펴보세요.
v2rayNG 사용 가이드 보기 →먼저 배포판에서 deb와 rpm 중 어떤 패키지 형식을 사용하는지 확인한 뒤 x64 또는 arm64를 선택하세요. 패키지 형식과 프로세서 아키텍처가 모두 맞아야 합니다.
deb 패키지 관리자를 사용하는 배포판용입니다. Debian, Ubuntu 및 같은 패키지 형식을 사용하는 데스크톱 시스템에서 주로 사용합니다.
deb 다운로드 · x64v2rayn_7.24.1_amd64.deb
ARM 기기: deb 다운로드 · arm64 ↗
rpm 패키지 관리자를 사용하는 배포판용입니다. 설치 전에 현재 패키지가 배포판의 종속성 환경과 호환되는지 확인하세요.
rpm 다운로드 · x64v2rayN-7.24.1-1.el10.x86_64.rpm
ARM 기기: rpm 다운로드 · arm64 ↗
파일 이름의 amd64와 x86_64는 대개 x64를, arm64와 aarch64는 ARM 64비트를 뜻합니다. 파일 이름을 바꾸거나 확장자를 변경해 설치 패키지 형식을 변환하지 마세요.
| 확인 항목 | 다운로드 전 확인 |
|---|---|
| 데스크톱 환경 | 이 페이지의 그래픽 클라이언트를 사용하려면 데스크톱 세션이 필요합니다. |
| 패키지 형식 | 시스템 정보 또는 소프트웨어 관리자를 통해 배포판과 패키지 관리 유형을 확인하세요. |
| 프로세서 아키텍처 | 일반적인 Intel 및 AMD 데스크톱 기기는 x64를 선택하세요. ARM 기기는 arm64인지 확인해야 합니다. |
| 종속성 및 권한 | 시스템 소프트웨어 설치 프로그램에서 종속성 안내를 확인하세요. 시스템 프록시와 Tun 권한은 각각 따로 설정해야 합니다. |
해당 형식의 파일을 다운로드해 시스템 소프트웨어 설치 프로그램으로 여세요. 종속성 및 호환성 안내를 읽은 뒤 설치를 진행하세요. 확장자가 같더라도 배포판에 따라 기본 라이브러리 버전이 다를 수 있습니다. 설치 프로그램에서 종속성을 충족할 수 없다고 표시되면 호환성을 먼저 확인하고, 종속성 무시는 일반적인 설치 방법으로 사용하지 마세요.
앱 메뉴에서 v2rayN을 실행하고 구독을 가져온 다음 유효한 설정을 선택하세요. Linux 데스크톱 환경마다 시스템 프록시를 처리하는 방식이 다르며, 일부 앱에는 자체 프록시 설정이 있습니다. 브라우저에서는 연결되지만 다른 앱에서 연결되지 않는다면 다른 연결 방식을 시도하기 전에 해당 앱이 데스크톱 시스템 프록시를 따르는지 확인하세요.
Tun을 켜기 전에 추가 권한과 라우팅 변경을 이해하고, 네트워크를 동시에 제어하는 프로그램을 여러 개 실행하지 마세요. 업그레이드 전 설정을 보존하고 기존 프로세스를 종료한 뒤 새 패키지를 설치하세요. 새 버전이 시작되지 않으면 설치 프로그램이나 클라이언트의 오류 메시지를 기록하고 데스크톱 종속성, 권한, 설정 중 어디에서 문제가 발생했는지 구분하세요.
코어 호환성 및 프로토콜 참고 자료 보기 →설치 후
클라이언트는 설정을 관리하고 연결을 만드는 도구이며, 구독에는 서버 정보가 들어 있습니다. 먼저 구독 주소가 유효한지 확인하고 업데이트한 뒤 설정 하나를 선택하고 프록시 모드를 지정하세요. 첫 테스트에서 구독, 라우팅, DNS, 코어를 한꺼번에 바꾸지 마세요. 한 번에 하나씩 조정해야 어떤 변경이 영향을 줬는지 파악할 수 있습니다.
시스템 프록시는 해당 설정을 따르는 앱에만 적용됩니다. 데스크톱에서는 「시스템 프록시 자동 설정」부터 시작하고, Android에서는 시스템 VPN 권한을 확인하세요. 브라우저에서 연결을 확인한 뒤 다른 앱의 연결 방식을 살펴보세요. 연결됨으로 표시되지만 웹페이지가 열리지 않는다면 시스템 프록시, 로컬 포트, 라우팅, DNS, 서버 상태 순서로 점검하세요.
클라이언트를 업데이트하기 전에 구독 그룹, 사용자 지정 라우팅 및 직접 추가한 서버 설정을 백업하세요. 구독 주소에는 개인 접속 정보가 포함될 수 있으므로 공개 스크린샷이나 문의 내용에 그대로 올리지 마세요. 문제를 설명할 때는 오류 문구와 작업 단계를 남기되 주소의 개인정보는 가리세요.
클라이언트 인터페이스와 코어는 서로 다른 요소입니다. 인터페이스에서 옵션을 저장할 수 있어도 현재 코어가 해당 매개변수를 지원한다는 뜻은 아닙니다. 클라이언트를 바꿔도 구독이 자동으로 호환되는 것은 아닙니다. VMess, VLESS, REALITY 등을 선택할 때는 프로토콜과 코어의 지원 여부를 먼저 확인한 뒤 필요한 매개변수를 모두 가져오세요.
연결되었지만 접속할 수 없을 때의 문제 해결 목록 보기 →다운로드 FAQ
유효한 구독 주소나 서버 설정 전체를 준비해야 합니다. 클라이언트는 설정을 불러와 연결을 만들며, 설치 파일에는 사용할 수 있는 서버가 포함되어 있지 않습니다. v2rayN에서 「구독 그룹 설정」을 열어 주소를 저장한 뒤 구독을 업데이트하세요. v2rayNG에서는 「구독 그룹 설정」에서 주소를 추가한 다음 현재 그룹을 업데이트하면 됩니다.
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 Desktop 버전부터 사용해 보세요. 클래식 WPF 버전은 기존 Windows 인터페이스에 익숙하거나 전통적인 안정 버전을 원하는 사용자에게 적합합니다. 두 버전 모두 유효한 설정이 필요합니다. 전환 전 설정을 내보내고 시스템 프록시와 라우팅 설정을 기록하세요. 같은 프록시 포트를 사용하는 클라이언트를 동시에 실행하지 마세요.
2015년 이후 출시된 대부분의 스마트폰에서는 arm64를 우선 선택할 수 있지만, 기기의 운영체제가 64비트 앱을 지원하는지 확인하세요. 아키텍처를 모르거나 arm64 설치가 안 된다면 범용 버전을 시도해 보세요. 범용 버전은 더 다양한 아키텍처를 지원하는 대신 파일 크기가 큰 편이며, 연결 성능이 자동으로 좋아지는 것은 아닙니다.
카드의 버전 정보와 플랫폼별 파일 주소는 별도로 관리되므로 업데이트 시점이 다를 수 있습니다. 다운로드 전에 링크 옆의 파일 이름을 확인하고, 설치 후에는 클라이언트의 「정보」 화면에서 실제 버전을 확인하세요. 카드에 표시된 숫자만으로 플랫폼별 패키지 버전을 판단하거나 다운로드 주소의 숫자를 직접 수정하지 마세요.
먼저 설치 파일이 현재 운영체제와 프로세서 아키텍처에 맞는지 확인하세요. Windows 압축 파일은 모두 압축 해제한 뒤 실행하세요. macOS에서는 앱을 「응용 프로그램」 폴더로 옮기세요. Linux는 패키지 형식과 아키텍처, 종속성 안내를 확인하고, Android는 설치 권한과 기존 앱의 서명 충돌 여부를 살펴보세요. 오류 메시지를 기록한 뒤 튜토리얼의 해당 단계에 따라 문제를 해결하세요.
첫 연결부터 Tun을 반드시 사용할 필요는 없습니다. 데스크톱에서는 유효한 설정을 선택한 뒤 「시스템 프록시 자동 설정」을 켜고 브라우저로 기본 연결을 확인하세요. 대상 앱이 시스템 프록시를 따르지 않을 때 Tun의 권한과 라우팅 영향을 살펴보면 됩니다. Android에서는 처음 연결할 때 시스템 VPN 권한 요청이 표시되므로 내용을 확인한 후 진행하세요.