v2rayN
7.24.1Desktop은 차세대 크로스 플랫폼 인터페이스를 사용하며, 처음 설치하거나 다른 데스크톱 운영체제에서 전환하는 경우에 적합합니다.
WPF는 Windows용 클래식 안정 버전으로, 기존 메뉴와 시스템 트레이 조작 방식에 익숙한 사용자에게 적합합니다.
클라이언트 및 설치 파일 선택
데스크톱은 v2rayN, Android는 v2rayNG를 우선 선택하세요. 먼저 운영체제를 고른 다음 CPU 아키텍처와 설치 파일 형식을 확인하세요.
Desktop은 차세대 크로스 플랫폼 인터페이스를 사용하며, 처음 설치하거나 다른 데스크톱 운영체제에서 전환하는 경우에 적합합니다.
WPF는 Windows용 클래식 안정 버전으로, 기존 메뉴와 시스템 트레이 조작 방식에 익숙한 사용자에게 적합합니다.
| 항목 | 이 페이지에서 제공 | 설치 전 확인 |
|---|---|---|
| 운영체제 및 아키텍처 | Windows x64 | ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하고 64비트 운영체제와 x64 프로세서인지 확인하세요. |
| 파일 형식 | 설치 프로그램이 포함된 ZIP | 압축 파일 전체를 로컬 폴더에 풀고, 압축을 푼 폴더에서 설치 프로그램을 실행하세요. |
| 실행 구성 요소 | 배포 패키지에 따라 다름 | .NET 런타임이 없다는 메시지가 표시되면 안내에 따라 런타임 종류와 버전, 아키텍처를 확인하세요. |
압축 파일 미리보기 창에서 설치 프로그램을 바로 실행하지 마세요. 파일을 모두 압축 해제한 뒤 설치하고, 처음 실행할 때는 기본 창이 열리고 시스템 트레이 메뉴가 정상 작동하는지 확인하세요. 트레이에 아이콘만 보인다고 실행에 실패한 것은 아닐 수 있습니다. 먼저 트레이 메뉴에서 기본 창을 여세요. 설치와 실행은 별개의 단계입니다. 설치 프로그램이 정상적으로 완료된 뒤 앱에서 오류가 발생하면 같은 파일을 반복해서 다운로드하지 말고 구체적인 오류 메시지를 확인하세요.
이전에 다른 프록시 클라이언트를 사용했다면 시스템 트레이에서 종료한 뒤 새 버전을 실행하세요. 두 프로그램이 같은 로컬 포트를 사용하려 하거나 시스템 프록시 설정을 차례로 변경해 브라우저가 현재 창의 설정과 다른 구성을 사용할 수 있습니다. 버전을 바꾸기 전에 기존 구독 그룹과 라우팅 규칙, 포트를 기록해 두세요. 설정 백업은 개인 폴더에 보관하고 구독 링크가 공개 스크린샷에 노출되지 않도록 주의하세요.
기본 창이 정상적으로 작동하는지 확인한 뒤 구독을 가져오세요. 처음 연결을 확인할 때는 시스템 프록시를 사용하는 브라우저로 테스트해 노드와 라우팅, 프록시 상태가 예상대로인지 확인하세요. 시스템 프록시를 사용하지 않는 앱까지 연결해야 할 때만 TUN을 고려하세요. 설치, 구독 설정, 트래픽 전달을 한꺼번에 변경하지 않는 것이 좋습니다.
‘이 Mac에 관하여’에 Apple M 시리즈 칩이 표시되면 arm64 네이티브 패키지를 선택하세요.
‘이 Mac에 관하여’에 Intel 프로세서가 표시되면 x64 패키지를 선택하세요. 파일 이름의 64는 이 다운로드 항목을 뜻합니다.
| 항목 | 이 페이지에서 제공 | 설치 전 확인 |
|---|---|---|
| 칩 | Apple Silicon / Intel | ‘Apple 메뉴 → 이 Mac에 관하여’에 표시된 칩 또는 프로세서 이름을 기준으로 선택하세요. |
| 운영체제 버전 | 배포 버전에 따라 다름 | 구형 운영체제에서는 해당 버전의 최소 요구 사항을 먼저 확인하세요. 칩이 맞더라도 운영체제 버전까지 호환되는 것은 아닙니다. |
| 파일 형식 | .dmg | 디스크 이미지가 마운트되면 앱을 ‘응용 프로그램’으로 복사한 뒤 해당 폴더에서 실행하세요. |
DMG를 연 다음 디스크 이미지 창의 안내에 따라 앱을 ‘응용 프로그램’으로 복사하세요. 복사가 끝나면 창을 닫고 디스크 이미지를 추출한 뒤 ‘응용 프로그램’에서 실행하세요. 이렇게 하면 업데이트할 때 사용 중인 앱을 쉽게 확인할 수 있고, 다운로드 폴더와 디스크 이미지, 응용 프로그램 폴더에서 각각 여러 복사본을 실행하는 일을 방지할 수 있습니다.
시스템 호환성 메시지가 표시되면 프로세서 불일치, 운영체제 버전 미달, 보안 경고를 구분하세요. 앞의 두 경우에는 패키지 종류와 시스템 요구 사항을 다시 확인해야 합니다. 출처가 불분명하거나 경고 내용을 이해하기 어렵다면 설치를 중단하세요. 시스템 보안 설정을 낮추는 것은 일반적인 해결 방법이 아닙니다. 조직에서 관리하는 기기에서는 앱 설치가 제한될 수 있으므로 관리자가 안내한 절차를 따르세요.
앱을 실행한 뒤 현재 사용 중인 네트워크 서비스의 시스템 프록시 설정을 확인하세요. 예를 들어 Wi-Fi와 유선 네트워크 중 어느 쪽에 연결되어 있는지 확인하면 됩니다. 네트워크를 바꾼 뒤 동작이 달라진다면 앱을 다시 설치하기보다 현재 활성화된 네트워크의 프록시 설정을 비교하세요. 수동 프록시나 자동 구성 주소를 이미 설정한 기기라면 클라이언트를 켜기 전에 기존 설정을 기록해 두어 종료 후 복원할 수 있도록 하세요.
Xray 코어를 사용합니다. 2015년 이후 출시된 일반적인 스마트폰은 우선 arm64를 선택하되, 시스템이 arm64-v8a를 지원하는지 확인하세요.
시스템이 지원하는 앱 아키텍처를 모르겠다면 먼저 범용 패키지를 선택하세요. 여러 아키텍처용 구성 요소를 포함하므로 파일 크기가 더 클 수 있습니다.
V2Fly 코어를 사용합니다. V2Fly 설정이 필요한 경우 구독에 사용된 프로토콜과 전송 옵션이 호환되는지 먼저 확인하세요.
v2flyNG가 필요하지만 앱 아키텍처를 아직 확인할 수 없다면 이 항목을 선택하세요.
| 항목 | 이 페이지에서 제공 | 설치 전 확인 |
|---|---|---|
| 앱 아키텍처 | arm64-v8a / 범용 버전 | 하드웨어가 64비트라고 해서 시스템이 반드시 64비트 앱을 지원하는 것은 아닙니다. 시스템에서 지원하는 아키텍처를 선택하세요. |
| 설치 권한 | .apk | 현재 파일을 여는 앱에 설치 권한을 허용해야 합니다. 설치가 끝나면 이 권한을 다시 해제할 수 있습니다. |
| 연결 권한 | Android VPN 서비스 | 처음 연결을 시작할 때 시스템 권한 요청을 승인하세요. 테스트 전에 실행 중인 다른 VPN 연결을 끊으세요. |
다운로드가 끝나면 시스템 다운로드 목록이나 파일 관리자에서 APK를 여세요. 시스템에서 현재 출처의 앱 설치를 허용하라고 요청하면, 방금 파일을 연 앱이 브라우저나 파일 관리자인지 확인한 뒤 허용하세요. 설치 권한은 APK를 시스템 설치 프로그램에 전달할 수 있는지를 결정하며, 클라이언트의 연결 여부와는 관계없습니다. 설치 항목이 나타나지 않으면 다운로드가 완료됐는지, 파일 이름이 여전히 .apk로 끝나는지 확인하세요.
기존 앱을 덮어 설치할 때 앱 이름이 같아도 서명이 같다는 뜻은 아닙니다. 시스템에서 설치를 거부하면 기존 버전의 출처를 확인하고 설정을 보존한 뒤, 같은 배포처에서 호환되는 업데이트를 선택하세요. 클라이언트를 바꾸면 라우팅, 앱별 분할 목록, 구독 자동 업데이트 설정이 그대로 옮겨진다고 가정하지 마세요. 각 항목을 따로 확인하고 노드 하나로 먼저 테스트한 다음 사용자 설정을 하나씩 복원하세요.
설치 후 구독을 추가하고 업데이트한 다음 노드를 선택해 연결을 시작하세요. 권한을 승인한 뒤 같은 앱으로 연결 전후를 비교 테스트하세요. 처음에는 연결되지만 화면을 잠근 뒤 끊긴다면 배터리 관리와 백그라운드 활동 권한을 확인하세요. 처음부터 연결되지 않는다면 설치 파일을 바로 바꾸기보다 구독 업데이트가 완료됐는지, 유효한 노드를 선택했는지 먼저 확인하세요.
Debian, Ubuntu 등 DEB 패키지를 사용하는 x86-64 데스크톱 시스템용입니다.
RPM을 사용하는 x86-64 데스크톱 시스템용입니다. 빌드 대상과 배포판 의존성을 먼저 확인하세요.
| 항목 | 이 페이지에서 제공 | 설치 전 확인 |
|---|---|---|
| 패키지 형식 | DEB / RPM | 배포판에서 사용하는 패키지 관리자를 기준으로 선택하세요. 확장자가 같아도 의존성이 호환된다는 보장은 없습니다. |
| 아키텍처 | amd64 / x86_64、arm64 / aarch64 | uname -m을 실행해 현재 시스템 아키텍처를 확인한 다음 패키지 이름과 비교하세요. |
| 데스크톱 세션 | GUI 클라이언트 | 로컬 그래픽 세션에서 실행하세요. 시스템 프록시의 적용 여부는 데스크톱 환경과 대상 앱에 따라서도 달라집니다. |
아키텍처가 맞더라도 패키지의 빌드 환경을 확인해야 합니다. 이 페이지의 RPM 파일 이름에는 빌드 대상 표시인 el10이 포함되어 있습니다. RPM을 읽을 수 있는 모든 배포판에서 바로 설치할 수 있다는 뜻은 아닙니다. 배포판의 패키지 관리자로 로컬 파일을 열어 의존성을 해결할 수 있는지 먼저 확인하세요. 필요한 라이브러리가 없거나 요구 버전이 시스템 제공 버전보다 높다면 강제 설치로 검사를 건너뛰지 마세요.
설치가 끝나면 현재 로그인한 데스크톱의 일반 사용자 계정으로 응용 프로그램 메뉴에서 실행하세요. 메뉴에 아이콘이 없다면 여러 아키텍처 패키지를 연달아 설치하지 말고, 먼저 패키지 관리자에서 설치 작업이 정상적으로 완료됐는지 확인한 뒤 실행 항목을 점검하세요. 다른 사용자 세션에서만 앱을 실행하면 현재 사용자가 보는 구독과 프록시 설정이 다를 수 있습니다. 문제를 확인할 때는 항상 같은 계정을 사용하세요.
GNOME이나 KDE에서는 데스크톱 네트워크 설정과 앱 자체의 프록시 설정이 함께 적용될 수 있습니다. 먼저 데스크톱 프록시를 따르는 앱 하나를 선택해 연결을 확인하고, 설정을 상속하지 않는 프로그램은 별도로 점검하세요. 수동 실행과 정상 종료가 모두 문제없이 되는지 확인한 뒤에 자동 시작이나 TUN 활성화를 고려하세요.
다운로드 및 업데이트
하나만 선택하면 됩니다. 처음 설치한다면 Desktop 버전으로 시작하고, 기존 WPF 사용 방식이 익숙하다면 WPF를 계속 사용해도 됩니다. 버전을 바꾸기 전에 설정을 백업하고, 테스트할 때는 클라이언트를 하나만 실행해 로컬 포트 충돌을 방지하세요.
x64, amd64, x86_64는 일반적으로 같은 64비트 x86 아키텍처를 뜻하며, arm64와 aarch64는 64비트 ARM 아키텍처를 뜻합니다. 둘 다 64비트지만 서로 다른 아키텍처이므로 설치 파일을 바꿔 사용할 수는 없습니다.
문제가 CPU 아키텍처와 관련된 경우에만 범용 버전이 도움이 될 수 있습니다. 서명 충돌, 버전 다운그레이드 또는 시스템 비호환 메시지가 표시되면 안내에 따라 기존 앱의 설치 출처와 버전, 시스템 요구 사항을 확인하세요. 기존 버전을 바로 삭제하지 마세요.
카드의 버전은 릴리스 목록의 앱 단위 필드에서 가져오므로 플랫폼별 패키지 이름과 다를 수 있습니다. 특정 패키지를 확인하려면 해당 다운로드 링크에 표시된 파일 이름을, 설치된 버전을 확인하려면 클라이언트의 정보 화면을 확인하세요.
먼저 구독을 가져오고 그룹을 업데이트한 다음 노드를 선택하세요. 데스크톱에서는 시스템 프록시를 사용하는 앱으로 먼저 확인하고 필요할 때 TUN을 활성화하세요. Android에서는 노드를 선택한 뒤 연결을 시작하고 시스템 VPN 권한 요청을 승인하면 됩니다.
클라이언트가 정상적으로 시작되는지 확인한 다음 시작 가이드에 따라 구독을 가져오고 그룹을 업데이트한 뒤 연결을 확인하세요. 설정을 옮기거나 포트 충돌을 해결하고 데스크톱 프록시 설정을 확인하려면 운영체제에 맞는 전체 플랫폼 가이드를 참고하세요.