v2rayN
추천 7.24.1Desktop은 새로운 크로스 플랫폼 UI로, 처음 사용하는 분이나 여러 데스크톱 OS에서 일관된 사용 환경을 원하는 분에게 적합합니다. WPF는 익숙한 Windows 인터페이스를 유지하는 클래식 안정 버전입니다. 둘 중 하나만 설치하면 됩니다. 프로토콜이 다르다는 이유로 두 버전을 동시에 실행할 필요는 없습니다.
클라이언트 / 설치 파일 선택
먼저 운영체제를, 다음으로 아키텍처를 선택하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 권장하며, v2flyNG는 코어 구성이 다른 대안입니다.
같은 클라이언트, 두 가지 UI. 아래 다운로드는 모두 x64 시스템용입니다.
Desktop은 새로운 크로스 플랫폼 UI로, 처음 사용하는 분이나 여러 데스크톱 OS에서 일관된 사용 환경을 원하는 분에게 적합합니다. WPF는 익숙한 Windows 인터페이스를 유지하는 클래식 안정 버전입니다. 둘 중 하나만 설치하면 됩니다. 프로토콜이 다르다는 이유로 두 버전을 동시에 실행할 필요는 없습니다.
| 확인 항목 | 선택 및 요구 사항 |
|---|---|
| 시스템 아키텍처 | 이 페이지의 Windows 패키지는 x64용입니다. ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하세요. x64 패키지를 네이티브 arm64 패키지로 착각하지 마세요. |
| 시스템 환경 | 보안 업데이트를 계속 제공받는 Windows를 사용하세요. 최소 OS 및 런타임 요구 사항은 설치 프로그램의 안내를 따르세요. |
| 폴더 및 권한 | 쓰기 권한이 있는 폴더에 압축을 푸세요. 권한이 제한된 위치는 피하세요. 일반 시스템 프록시와 TUN의 권한 요구 사항은 다르므로 필요한 기능에 맞게 권한을 부여하세요. |
다운로드가 끝나면 실행 중인 프록시 프로그램을 먼저 종료해 포트 충돌이나 시스템 프록시 설정 덮어쓰기를 방지하세요. 설치 후 v2rayN의 ‘구독 그룹 설정’에서 그룹을 만들고 구독 주소를 입력한 다음 ‘구독 업데이트’를 실행하세요. 개별 공유 링크는 클립보드에서 서버를 가져오면 됩니다. 전체 설정 JSON을 구독 주소로 붙여 넣지 마세요.
처음 연결할 때는 시스템 프록시를 사용하고 서버를 선택한 뒤 로그에서 정상적으로 시작했는지 확인하세요. 일부 버전의 기본 로컬 SOCKS 및 HTTP 포트는 각각 10808과 10809이지만, 설정 화면에 표시된 실제 값을 기준으로 하세요. 대상 프로그램이 시스템 프록시를 따르지 않고 해당 프로그램의 트래픽을 직접 처리해야 할 때만 TUN 설정 문서를 확인하세요. Desktop과 WPF 간에 이전하기 전에 백업하고 두 버전이 같은 설정을 동시에 수정하지 않도록 하세요.
‘이 Mac에 관하여’에서 칩 이름을 확인한 뒤 알맞은 DMG를 선택하세요.
Apple Silicon 기기는 arm64, Intel 프로세서 기기는 x64를 선택하세요. ‘이 Mac에 관하여’의 칩 또는 프로세서 항목을 확인하면 됩니다. 컴퓨터를 구입한 시기나 현재 브라우저 이름으로 판단하지 마세요. macOS용 v2rayN은 크로스 플랫폼 데스크톱 UI를 사용합니다.
| 확인 항목 | 선택 및 요구 사항 |
|---|---|
| Apple Silicon | ‘이 Mac에 관하여’에 Apple 칩이 표시되면 arm64 DMG를 선택하세요. 해당 아키텍처에 맞는 앱을 사용하는 것이 좋습니다. |
| Intel | ‘이 Mac에 관하여’에 Intel 프로세서가 표시되면 x64 DMG를 선택하세요. arm64 앱으로 대체할 수 없습니다. |
| 시스템 및 권한 | 보안 업데이트를 계속 제공받는 macOS를 사용하고 현재 앱의 최소 시스템 요구 사항을 확인하세요. 처음 실행할 때 시스템 보안 안내를 확인해야 할 수 있습니다. |
마운트된 디스크 이미지에서 앱을 계속 실행하지 마세요. 먼저 앱을 복사한 다음 디스크 이미지를 꺼내고 ‘응용 프로그램’ 폴더에서 v2rayN을 실행하세요. 시스템에서 실행을 차단하면 다운로드 출처를 확인한 후 안내에 따라 ‘시스템 설정 → 개인정보 보호 및 보안’에서 처리하세요. 이 단계를 건너뛰려고 시스템 보안 기능을 통째로 끄지 마세요.
구독을 가져오고 서버 목록을 업데이트한 뒤 시스템 프록시를 켜고 브라우저 연결을 확인하세요. 시스템 프록시가 모든 터미널 프로그램에 자동 적용되는 것은 아닙니다. 터미널 도구에는 프록시 주소를 별도로 설정해야 할 수 있습니다. TUN을 켜면 권한과 네트워크 라우팅 설정이 필요합니다. 먼저 일반 프록시가 작동하는지 확인한 뒤 문서에 따라 하나씩 설정하세요. 업데이트 전에 기존 앱을 종료하고 복구할 수 있도록 설정을 백업해 두세요.
macOS 설치 및 설정 더 보기 →v2rayNG를 권장하며 v2flyNG는 대안으로 사용할 수 있습니다. 하나씩 선택하면 되며 두 앱을 동시에 연결할 필요는 없습니다.
Android에서 일상적으로 사용한다면 v2rayNG를 우선 선택하세요. 2015년 이후 출시된 대부분의 스마트폰은 보통 arm64를 선택하면 됩니다. 시스템 아키텍처를 모르면 범용 버전을 선택하세요. 사용할 수 있는 프로토콜과 전송 방식은 구독 설정 및 포함된 코어에 따라 달라집니다. 클라이언트 설치만으로 서버 설정이 자동 완성되지는 않습니다.
v2fly 코어 생태계의 설정을 사용해야 한다면 v2flyNG를 선택할 수 있습니다. 별도의 Android 클라이언트이며 v2rayNG에 추가하는 확장 프로그램이 아닙니다. 두 앱이 모든 설정 항목을 동일하게 지원한다고 가정하지 마세요. 특정 코어 기능을 사용하는 공유 링크는 호환성을 확인한 뒤 가져오세요.
| 확인 항목 | 선택 및 요구 사항 |
|---|---|
| arm64 | 64비트 앱을 지원하는 ARM 기기에서 사용할 수 있습니다. 최신 스마트폰 대부분이 해당하지만, 기기 출시 연도만으로 시스템 아키텍처를 판단할 수는 없습니다. |
| 범용 버전 | 아키텍처를 모른다면 우선 고려하세요. 범용 패키지를 사용해도 앱의 최소 Android 버전 요구 사항은 충족해야 합니다. |
| 설치 및 연결 | 설치에 사용할 브라우저나 파일 관리자에만 앱 설치 권한을 일시적으로 허용하세요. 연결할 때는 시스템 안내에 따라 VPN 권한을 부여하세요. |
APK를 다운로드한 뒤 시스템 다운로드 목록이나 파일 관리자에서 여세요. 설치할 수 없다는 안내가 표시되면 먼저 구체적인 오류를 확인하세요. 아키텍처 불일치, 낮은 시스템 버전, 저장 공간 부족, 서명 충돌은 각각 해결 방법이 다릅니다. 기존 앱을 바로 삭제하지 마세요. 필요한 설정을 먼저 내보내고 같은 출처의 앱으로 덮어써서 업데이트할 수 있는지 확인해 구독과 라우팅 설정이 사라지지 않도록 하세요.
설치 후 ‘구독 설정’에서 구독 주소를 추가하고 저장한 다음 메인 화면으로 돌아와 업데이트를 실행하세요. 서버를 선택하고 연결하면 됩니다. 처음 연결할 때 시스템 VPN 권한 요청이 표시됩니다. 이는 앱이 기기의 트래픽을 처리하는 로컬 인터페이스를 설정한다는 뜻이며, 원격 서버 연결이 성공적으로 검증됐다는 의미는 아닙니다. 화면이 잠긴 뒤 연결이 끊긴다면 시스템 배터리 최적화와 백그라운드 실행 제한을 확인하고, 실제로 필요한 앱에만 설정을 조정하세요.
Android 설치 및 설정 더 보기 →먼저 배포판에 맞는 패키지 형식을 확인하고 x64 또는 arm64 아키텍처를 선택하세요.
Debian, Ubuntu 등 deb 패키지 관리 체계를 사용하는 시스템은 deb를 선택하세요. RPM 패키지 관리 체계를 사용하는 배포판은 rpm을 선택하고 배포판 및 의존성 호환성을 확인하세요. 아래 기본 다운로드는 x64용입니다. ARM 데스크톱 기기는 아래 arm64 항목을 이용하세요. GUI 클라이언트를 사용하려면 데스크톱 세션이 필요합니다.
| 확인 항목 | 선택 및 요구 사항 |
|---|---|
| 패키지 관리 체계 | deb와 rpm은 파일 확장자만 바꿔 서로 변환할 수 없습니다. 해당 설치 파일을 시스템 소프트웨어 설치 프로그램에서 여세요. |
| 실행 의존성 | 배포판은 패키지에 명시된 의존성, 시스템 라이브러리 및 데스크톱 실행 환경 요구 사항을 충족해야 합니다. 의존성 오류가 발생하면 먼저 설치 프로그램의 안내를 확인하세요. |
| 프록시 및 권한 | 데스크톱 시스템 프록시를 읽는지는 앱에 따라 다릅니다. TUN을 사용하려면 네트워크 인터페이스, 라우팅 및 권한도 설정해야 합니다. |
시스템 정보에서 아키텍처와 배포판을 확인한 뒤 그래픽 소프트웨어 설치 프로그램으로 패키지를 설치하고 의존성을 확인하세요. 설치 프로그램에서 시스템 라이브러리 버전이 부족하다고 알리면 의존성을 강제로 무시하거나 다른 배포판의 기본 라이브러리를 섞어 설치하지 마세요. 패키지 형식이 같다는 것은 같은 계열의 패키지 관리 체계를 사용한다는 뜻일 뿐, 모든 배포판에서 같은 빌드가 실행된다는 의미는 아닙니다.
v2rayN을 실행한 뒤 먼저 구독을 가져오고 서버를 선택하세요. 코어가 실행 중인지, 로컬 포트가 정상적으로 열려 있는지 확인한 다음 프록시를 설정하세요. 브라우저, 터미널, 데스크톱 앱마다 프록시를 적용하는 방식이 다를 수 있습니다. 특정 프로그램에서 프록시가 작동하지 않으면 먼저 해당 프로그램의 네트워크 설정을 확인하세요. TUN으로 더 많은 앱의 트래픽을 처리하려면 문서에 따라 권한을 설정하고, 데스크톱 세션 전체를 상시 높은 권한으로 실행하지 마세요.
Linux 설치 및 설정 더 보기 →AFTER / INSTALL
설치 문제와 연결 문제를 구분하세요. 클라이언트가 열리는 것은 앱이 실행됐다는 뜻일 뿐입니다. 구독, 서버 설정, 트래픽 처리 방식은 각각 확인해야 합니다.
빠른 시작 보기세 클라이언트 모두 프록시 설정을 관리하는 앱이며, 설치 파일만으로 연결 서비스가 제공되지는 않습니다. 사용 권한이 있는 구독 주소, 개별 공유 링크 또는 전체 설정 파일을 준비하고 각각에 맞는 가져오기 메뉴를 선택하세요. 구독 주소는 보통 구독 설정에 입력하고, 공유 링크는 클립보드나 스캔으로 가져올 수 있습니다. 전체 JSON 파일은 해당 형식의 설정 가져오기 기능을 사용해야 합니다. 잘못된 메뉴에 형식을 붙여 넣었다면 클라이언트를 반복해서 다운로드해도 해결되지 않습니다.
구독 링크에는 접근 인증 정보가 포함될 수 있습니다. 문제를 문의할 때는 전체 주소를 공개 게시판에 올리지 말고 오류 종류, 메뉴 경로, 로그의 주요 부분을 알려 주세요. 가져온 다음 먼저 업데이트를 실행하세요. 목록이 비어 있다면 구독 주소가 온전한지, 그룹 필터가 적용됐는지, 클라이언트에서 구독 서버에 접속할 수 있는지 확인하세요.
목록에서 실제 사용할 서버를 선택하고 로그에 설정 파싱 오류나 포트 점유 오류가 표시되는지 확인하세요. 데스크톱에서는 보통 시스템 프록시를 설정하고, Android에서는 연결 상태와 VPN 권한을 확인합니다. 시스템 프록시는 해당 설정을 따르는 앱이 로컬 프록시를 사용하게 합니다. TUN은 별도의 트래픽 처리 방식입니다. 용도를 파악하기 전 두 방식을 반복해서 전환하지 마세요.
확인할 때는 대상 앱의 연결뿐 아니라 로컬 네트워크 접근, 도메인 이름 확인, 라우팅이 예상대로 작동하는지도 살펴보세요. 규칙에 따라 일부 요청이 직접 연결로 전달될 수 있으며, 이것이 반드시 오류인 것은 아닙니다. 트래픽을 세분화해야 할 때 라우팅 규칙을 설정하고, 먼저 현재 정상적으로 작동하는 설정을 백업하세요. 라우팅 규칙 문제를 설치 파일 문제로 오인하지 마세요.
파일이 사용 중이지 않도록 클라이언트를 종료한 뒤 교체하거나 덮어써서 설치하세요. 업그레이드 전에 구독 그룹, 라우팅 규칙, 사용자 설정을 백업하세요. 특히 UI 버전, 설치 출처, 기기가 달라지는 경우 주의해야 합니다. Android에서 서명 충돌이 발생하면 기존 앱의 출처와 데이터 내보내기 방법부터 확인하세요. 앱을 삭제하면 로컬 설정도 함께 사라질 수 있습니다.
클라이언트 UI 버전과 코어 버전은 서로 다른 개념입니다. Xray와 V2Fly는 모두 Project V 관련 생태계에 속하지만 지원하는 프로토콜, 전송 방식, 설정 항목이 항상 같지는 않습니다. UI 이름이 비슷하다는 이유만으로 모든 고급 설정을 그대로 재사용하면 실행에 실패할 수 있습니다. 다운로드할 때는 플랫폼을 맞추고, 설정할 때는 프로토콜 지원 여부를 확인하세요. 자세한 차이는 개념 빠른 참조에서 확인할 수 있습니다.
DOWNLOAD / FAQ
먼저 설치 파일 형식을 확인한 다음 시스템 권한, 설정 가져오기, 프록시 적용 문제를 점검하세요.