v2rayN
데스크톱 Desktop은 최신 크로스 플랫폼 UI를 사용합니다. 클래식 WPF 버전은 기존 Windows 인터페이스를 유지해 익숙한 작업 방식을 선호하는 분에게 안정적인 선택입니다. 두 버전 모두 서버 설정, 구독 그룹, 라우팅을 관리할 수 있으므로 원하는 인터페이스에 따라 하나를 선택하면 됩니다.
CLIENT SHELF / DOWNLOAD
운영체제와 아키텍처에 맞춰 선택데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. 프로세서 아키텍처를 확인한 뒤 알맞은 파일을 다운로드하세요.
v2rayN / x64 / ZIP
데스크톱 Desktop은 최신 크로스 플랫폼 UI를 사용합니다. 클래식 WPF 버전은 기존 Windows 인터페이스를 유지해 익숙한 작업 방식을 선호하는 분에게 안정적인 선택입니다. 두 버전 모두 서버 설정, 구독 그룹, 라우팅을 관리할 수 있으므로 원하는 인터페이스에 따라 하나를 선택하면 됩니다.
| 항목 | 선택 기준 | 권장 사항 |
|---|---|---|
| 프로세서 | 이 페이지에서는 x64 설치 파일을 제공합니다. | 설정 → 시스템 → 시스템 정보에서 시스템 유형을 확인하세요. 기기 이름만으로 판단하지 마세요. |
| 시스템 및 실행 환경 | 현재 배포 패키지의 요구 사항 확인 | 먼저 시스템 업데이트를 설치하세요. 실행에 필요한 구성 요소가 없다는 메시지가 표시되면 안내에 따라 해당 구성 요소를 설치하세요. |
| 설치 위치 | 쓰기 가능한 로컬 폴더 | 압축을 완전히 푼 뒤 실행하세요. 압축 파일 미리보기 창에서 프로그램을 바로 실행하지 마세요. |
| 권한 | 일반 설정과 네트워크 제어를 구분하세요. | 먼저 기본 프록시 연결을 확인하고, TUN 또는 서비스 관련 작업은 클라이언트 안내에 따라 권한을 높이세요. |
다운로드한 압축 파일을 지정된 폴더에 완전히 풀고, 폴더 안의 설치 프로그램이나 실행 파일을 확인하세요. 압축 파일 형식만으로 포터블 방식이라고 단정할 수 없으므로 실제 설치 방법은 파일에 포함된 안내를 따르세요. 처음 실행한 뒤 구독 그룹을 설정하고 링크를 붙여 넣어 구독을 업데이트한 다음 서버를 선택하세요. 설정을 가져오기 전에는 시스템 프록시를 반복해서 전환하지 마세요. 아직 사용할 수 있는 아웃바운드 설정이 없기 때문입니다.
이전 버전에서 업그레이드하는 경우 트레이에 실행 중인 클라이언트를 먼저 종료한 뒤 설정을 백업하세요. Desktop과 WPF는 인터페이스와 데이터 처리 방식이 다를 수 있으므로, 마이그레이션할 때는 클라이언트의 내보내기 및 가져오기 기능을 우선 사용하세요. 시스템 프록시를 켜도 일반적으로 해당 설정을 따르는 앱만 프록시를 사용합니다. 다른 앱의 트래픽도 처리해야 한다면 Windows 설치 및 설정 안내를 확인하세요.
v2rayN / ARM64 · X64 / DMG
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. 칩 항목에 Apple M 시리즈가 표시되면 Apple Silicon을, 프로세서 항목에 Intel이 표시되면 Intel 버전을 선택하세요. 구매 연도가 아니라 기기에 표시된 정보를 기준으로 선택하세요.
| 항목 | 선택 기준 | 권장 사항 |
|---|---|---|
| 칩 아키텍처 | Apple Silicon 또는 Intel | ‘이 Mac에 관하여’에서 칩 또는 프로세서 항목을 확인하세요. |
| 시스템 버전 | 현재 배포 패키지의 최소 요구 사항 | 시스템에서 앱이 호환되지 않는다고 표시되면 macOS 버전과 파일 아키텍처를 먼저 확인하세요. |
| 설치 위치 | 응용 프로그램 폴더 | DMG를 연 뒤 창의 안내에 따라 설치하고, 응용 프로그램 폴더에서 실행하세요. |
| 네트워크 권한 | 사용 방식에 맞게 권한 부여 | 시스템 프록시와 TUN은 필요한 권한이 다르므로 각 시스템 안내를 확인하세요. |
다운로드한 디스크 이미지를 열고 앱을 응용 프로그램 폴더로 옮긴 뒤 해당 폴더에서 실행하세요. 마운트된 디스크 이미지에서 계속 실행하면 업데이트, 경로 접근, 설정 저장이 예상과 다르게 동작할 수 있습니다. 처음 실행할 때 시스템 보안 정책으로 차단되면 다운로드 출처를 먼저 확인한 뒤 ‘개인정보 보호 및 보안’에서 관련 안내를 살펴보세요. 앱 하나를 실행하려고 시스템 보안 기능 전체를 끄지 마세요.
구독을 가져온 뒤 서버를 선택하고 클라이언트 로그를 확인한 다음 필요한 프록시 모드를 켜세요. Wi-Fi, 도킹 스테이션의 네트워크 어댑터, 유선 연결을 전환한 뒤에는 시스템 프록시 설정을 다시 확인해야 할 수 있습니다. 사용을 마칠 때는 클라이언트가 설정한 시스템 프록시를 먼저 해제한 다음 프로그램을 종료하세요. 그래야 브라우저가 종료된 로컬 포트에 계속 접속하는 일을 막을 수 있습니다. 자세한 절차는 macOS 설치 및 설정 안내를 확인하세요.
v2rayNG · v2flyNG / APK
구독 가져오기, 서버 선택, 라우팅 설정을 지원하는 Android 그래픽 클라이언트입니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하세요. 기기 아키텍처를 모르거나 설치 중 호환되지 않는다는 안내가 표시되면 범용 버전을 고려하세요.
기존 설정이 v2fly 코어의 동작 방식에 의존하는 사용자에게 적합합니다. 선택 전에 필요한 프로토콜과 전송 기능을 확인하세요. 클라이언트 이름만 보고 설정을 그대로 옮길 수 있다고 판단하지 마세요.
| 항목 | 선택 기준 | 권장 사항 |
|---|---|---|
| 앱 아키텍처 | arm64 또는 범용 버전 | 프로세서가 64비트를 지원해도 시스템에서 64비트 앱을 실행할 수 있다는 뜻은 아닙니다. 시스템 지원 여부도 확인하세요. |
| 시스템 버전 | 설치 파일에 명시된 최소 버전 | 설치 프로그램에서 버전이 호환되지 않는다고 표시되면 Android 버전을 확인하세요. 같은 파일을 반복해서 설치하지 마세요. |
| 설치 권한 | 현재 출처의 앱 설치 허용 | 현재 사용하는 브라우저나 파일 관리 앱에만 임시로 권한을 부여하세요. |
| 서비스 권한 | 시스템 VPN 권한 및 백그라운드 실행 | 처음 연결할 때 안내에 따라 권한을 부여하세요. 연결이 자주 끊기면 배터리 최적화와 백그라운드 제한을 확인하세요. |
APK를 저장한 뒤 브라우저의 다운로드 기록이나 파일 관리 앱에서 여세요. 시스템에서 해당 출처의 앱 설치를 허용할지 물으면 현재 설치 출처에만 권한을 부여하세요. 설치가 끝난 뒤에는 이 권한을 해제할 수 있습니다. 설치 실패 원인이 아키텍처 문제만은 아닙니다. 저장 공간 부족, 오래된 시스템 버전, 설치된 앱과 새 파일의 서명 불일치일 수도 있습니다. 다음 조치를 취하기 전에 설치 프로그램의 안내를 확인하세요.
처음 실행한 뒤 구독을 추가하고 업데이트한 다음 서버를 선택하세요. 프록시 서비스를 시작하면 Android에서 VPN 권한 대화상자를 표시합니다. 이는 클라이언트가 트래픽을 처리하는 데 필요한 시스템 권한이며, 설치 파일에 원격 서버가 포함되었다는 뜻은 아닙니다. 기기에서 다른 VPN 서비스를 실행 중이면 먼저 중지한 뒤 테스트하세요. 화면을 잠근 뒤 연결이 자주 끊기면 백그라운드 실행, 배터리 최적화, 제조사별 절전 설정을 확인하세요. 자세한 내용은 Android 설치 및 설정 안내를 참고하세요.
v2rayN / DEB · RPM
Debian 및 Ubuntu 계열은 보통 deb를 선택합니다. Fedora, openSUSE처럼 rpm 패키지 관리자를 사용하는 배포판은 대개 rpm을 선택합니다. 패키지 형식이 같아도 필요한 라이브러리가 모두 호환되는 것은 아니므로 설치 프로그램이 요구하는 시스템 라이브러리를 확인하세요.
| 항목 | 선택 기준 | 권장 사항 |
|---|---|---|
| 시스템 아키텍처 | x64 또는 ARM64 | 시스템 정보를 확인하세요. amd64와 x86_64는 x64에 해당하며, aarch64는 일반적으로 ARM64에 해당합니다. |
| 설치 형식 | deb 또는 rpm | 배포판의 기본 패키지 형식을 선택하세요. 의존성 호환 여부는 설치 프로그램의 확인 결과를 따르세요. |
| 실행 환경 | 지원되는 그래픽 데스크톱 및 시스템 라이브러리 | 소프트웨어 설치 프로그램으로 의존성을 확인하고 누락된 항목을 해결한 뒤 앱을 실행하세요. |
| 프록시 권한 | 데스크톱 프록시 설정 또는 TUN | GNOME, KDE, 각 앱이 시스템 프록시 설정을 따르는 방식은 다를 수 있으므로 따로 확인해야 합니다. |
배포판과 아키텍처에 맞는 패키지를 다운로드한 뒤, 의존성도 함께 확인할 수 있도록 시스템 소프트웨어 설치 프로그램으로 여는 것이 좋습니다. 시스템 라이브러리 버전이 부족하다는 안내가 나오면 의존성을 무시하고 강제로 설치하지 마세요. 먼저 현재 배포판이 패키지 요구 사항을 충족하는지 확인하세요. 설치가 끝나면 앱 메뉴에서 v2rayN을 실행하고 일반 사용자 계정으로 구독과 설정을 관리하세요.
Linux 데스크톱 프록시 설정을 모든 프로그램이 사용하는 것은 아닙니다. 브라우저, 데스크톱 앱, 터미널 프로그램은 서로 다른 프록시 설정을 사용할 수 있으므로 클라이언트가 실행 중이라고 해서 모든 앱의 트래픽이 처리되는 것은 아닙니다. 먼저 프록시 설정을 따르는 앱 하나로 확인한 뒤 필요에 따라 환경 변수나 TUN 권한을 설정하세요. 자동 시작은 수동 연결이 정상적으로 확인된 후 설정하세요. 그래야 시작에 실패했을 때 원인을 찾기 쉽습니다. 자세한 내용은 Linux 설치 및 설정 안내를 참고하세요.
INSTALL → IMPORT → VERIFY
설치, 설정, 연결 확인은 나눠서 진행하세요. 한 번에 한 종류의 설정만 변경하면 로그를 통해 문제를 찾기 쉽습니다.
01 / INSTALL
시스템, 아키텍처, 디스크 공간, 폴더 권한을 확인하세요. 창이 열리면 설정이 저장되는지 먼저 확인한 뒤 가져오기를 진행하세요. 시작 오류가 발생하면 구독을 계속 바꾸기보다 실행 환경 문제부터 해결하세요.
02 / IMPORT
사용 권한이 있는 구독 링크를 그룹에 추가하고 업데이트한 뒤 서버 목록을 확인하세요. 구독 주소에는 접속 정보가 포함될 수 있으므로 화면을 공개하거나 전달하지 마세요. 목록이 비어 있으면 업데이트 로그와 링크 형식을 먼저 확인하고 구독이 아직 유효한지도 살펴보세요.
03 / VERIFY
서버를 선택하고 서비스를 시작한 뒤 로그에 설정 파싱 오류가 없는지 확인하고 필요한 모드를 켜세요. 먼저 앱 하나로 테스트한 다음 라우팅과 DNS를 확인하세요. 문제를 조사할 때는 증상과 오류 메시지를 기록하고 서버, 프록시 모드, 이름 확인 설정을 동시에 바꾸지 마세요.
DOWNLOAD / FAQ
Desktop은 최신 크로스 플랫폼 인터페이스를 제공해 데스크톱 환경 간 일관된 사용 방식을 원하는 분에게 적합합니다. WPF는 기존 Windows 인터페이스에 익숙한 분을 위한 안정적인 클래식 버전입니다. 이 페이지의 두 설치 파일은 모두 x64이므로 설치 전에 시스템 유형을 확인하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 다만 기기가 지원하는 앱 아키텍처를 기준으로 선택하세요. 아키텍처를 모르거나 arm64 설치 파일이 호환되지 않는다고 표시되면 범용 버전을 선택할 수 있습니다. 범용 버전은 여러 아키텍처를 포함하므로 파일 크기가 더 클 수 있습니다.
설치 파일에는 클라이언트 프로그램만 포함되며, 사용할 수 있는 구독이나 서버는 제공되지 않습니다. 사용 권한이 있는 구독 링크나 서버 설정을 준비해 가져온 뒤 구독을 업데이트하고, 서버를 선택한 다음 로그를 확인하세요.
먼저 클라이언트의 내보내기 또는 백업 기능으로 설정을 보관하고, 구독 그룹, 라우팅, 사용자 지정 DNS, 수신 대기 포트를 기록한 뒤 클라이언트를 종료하세요. 인터페이스 버전이나 클라이언트가 다르면 데이터 디렉터리를 그대로 옮겨 쓸 수 있다고 가정하지 마세요.
먼저 브라우저 다운로드 기록을 확인하고 디스크 공간과 저장 권한을 점검한 뒤 같은 설치 파일 링크로 다시 시도하세요. 페이지 스크립트가 버전 목록을 불러오지 못해도 정적 다운로드 링크는 사용할 수 있습니다. 계속 실패하면 발생 시간, 플랫폼, 파일 형식, 브라우저 안내를 기록한 뒤 네트워크나 다운로드 정책을 확인하세요.
먼저 구독을 가져오고 기본 연결을 확인한 다음, 앱에서 필요한 방식에 따라 시스템 프록시 또는 TUN을 선택하세요. 데스크톱에서 TUN을 사용하려면 권한을 높여야 할 수 있으며, Android에서 프록시 서비스를 처음 시작하면 시스템 VPN 권한을 요청합니다. 전환하기 전에 같은 트래픽을 처리할 수 있는 다른 네트워크 도구는 일시 중지하세요.