v2rayN
추천Desktop은 최신 크로스 플랫폼 인터페이스를 제공해 처음 설치하거나 데스크톱 운영체제를 오가며 사용하는 경우에 적합합니다. WPF는 익숙한 메뉴와 시스템 트레이 조작을 선호하는 사용자를 위한 안정적인 클래식 버전입니다. 두 버전을 함께 설치할 필요는 없으며, 버전을 바꿔도 설정이 자동으로 이전된다고 단정할 수 없습니다.
설치 파일 / 플랫폼 바로가기
운영체제를 먼저 선택한 다음 CPU 아키텍처와 패키지 형식에 맞는 파일을 다운로드하세요. 설치한 뒤 기존 구독 주소나 노드 설정을 사용해 연결하면 됩니다.
Desktop은 최신 크로스 플랫폼 인터페이스를 제공해 처음 설치하거나 데스크톱 운영체제를 오가며 사용하는 경우에 적합합니다. WPF는 익숙한 메뉴와 시스템 트레이 조작을 선호하는 사용자를 위한 안정적인 클래식 버전입니다. 두 버전을 함께 설치할 필요는 없으며, 버전을 바꿔도 설정이 자동으로 이전된다고 단정할 수 없습니다.
ZIP 파일을 로컬 폴더에 완전히 압축 해제한 다음, 압축을 푼 폴더에서 설치 프로그램을 실행하세요. 압축 파일 미리보기에서 프로그램을 바로 실행하지 마세요. 미리보기 도구가 파일 하나만 임시 폴더에 풀면 설치 중 같은 패키지에 들어 있는 다른 파일을 찾지 못할 수 있습니다.
설치 프로그램에서 실행 환경이 없다는 메시지가 표시되면 필요한 구성 요소의 이름과 버전, 아키텍처를 기록한 뒤 안내에 따라 설치하세요. Desktop과 WPF 버전을 번갈아 설치해도 누락된 종속성은 해결되지 않습니다. 회사나 기관에서 관리하는 기기라면 소프트웨어 설치 정책을 먼저 확인하고 다른 계정으로 제한을 우회하지 마세요.
기존 설정이 있다면 이전 클라이언트에서 구독 그룹, 로컬 포트, 현재 프록시 모드를 기록하고 백업한 다음 시스템 트레이 프로세스를 종료하세요. 새 클라이언트를 처음 실행할 때는 포트가 사용 중인지 확인한 뒤 설정을 가져오고, 마지막으로 시스템 프록시를 켜세요. 설정 이전 문제와 로컬 포트 충돌을 구분하는 데 도움이 됩니다.
| 확인 항목 | 적용 조건 |
|---|---|
| 시스템 유형 | 이 페이지의 두 설치 파일은 모두 x64입니다. 「설정 → 시스템 → 정보」에서 시스템 유형을 확인하세요. |
| 실행 환경 | 선택한 버전의 설치 안내를 따르세요. |
64비트라는 정보만으로는 부족합니다. CPU 유형도 확인하세요. x64와 ARM64는 모두 64비트지만 서로 다른 아키텍처입니다.
Apple 메뉴에서 「이 Mac에 관하여」를 여세요. Apple 칩이라고 표시되면 Apple Silicon 버전을, Intel 프로세서라고 표시되면 Intel 버전을 선택하세요. 설치 파일은 기기의 외관이나 구입 연도가 아니라 칩에 따라 선택해야 합니다.
해당 DMG 파일을 여세요. 창에 「응용 프로그램」 바로가기가 있으면 클라이언트를 해당 폴더로 드래그하고 복사가 끝날 때까지 기다리세요. 그런 다음 디스크 이미지를 추출하고 「응용 프로그램」 폴더에서 실행하세요. 이미지 안에 임시로 마운트된 앱을 설치된 앱으로 착각하지 마세요.
시스템에서 앱이 호환되지 않는다고 안내하면 먼저 현재 칩에 맞는 설치 파일을 다시 다운로드했는지 확인한 다음, macOS 버전이 해당 앱의 요구 사항을 충족하는지 살펴보세요. 보안 정책 안내가 표시되면 메시지를 그대로 보관하고 앱 출처와 기기 정책을 확인하세요. 칩을 잘못 선택한 문제와 정책에 의해 앱이 차단된 문제는 서로 다릅니다.
이전할 때는 기존 클라이언트를 종료한 뒤 앱을 교체하세요. 앱을 바꿔도 사용자 설정까지 삭제되는 것은 아닙니다. 새 버전을 실행한 뒤에도 이전 구독이 표시된다면 클라이언트가 현재 어떤 설정을 사용하는지 확인하세요. 목록을 비우려고 앱 데이터 폴더 전체를 바로 삭제하지 마세요.
| 확인 항목 | 적용 조건 |
|---|---|
| 칩 | Apple 칩은 arm64, Intel 프로세서는 x64 버전을 선택하세요. |
| 시스템 및 권한 | 배포판의 시스템 요구 사항을 충족하고 앱을 대상 폴더에 복사할 권한이 있어야 합니다. |
설치한 뒤 클라이언트에서 설정이 정상적으로 로드되는지 확인하고, 시스템 프록시 설정을 사용하는 앱으로 테스트하세요.
2015년 이후 출시된 일반적인 스마트폰은 보통 arm64를 선택하면 됩니다. 다만 기준은 기기에서 지원하는 앱 아키텍처입니다. 기기 사양이 불분명하거나 설치 프로그램에서 아키텍처가 맞지 않는다고 알리면 범용 버전을 사용해 보세요. 매니페스트의 버전과 패키지 파일명은 다를 수 있으므로 설치 결과는 시스템의 앱 정보에 표시된 버전으로 확인하세요.
구독이 v2fly와 호환된다고 명시되어 있다면 v2flyNG를 선택할 수 있습니다. 구독을 가져올 수 있다고 해서 구독에 포함된 모든 노드를 사용할 수 있는 것은 아닙니다. 클라이언트를 바꾼 뒤에는 사용 가능 여부를 알고 있는 노드 하나를 먼저 테스트한 다음 나머지 설정을 옮기세요.
APK를 여는 앱(브라우저나 파일 관리자 등)에 설치 권한을 부여해야 합니다. 개인 기기에서 설치를 허용할 경우 현재 APK를 연 출처에만 권한을 부여하고 설치가 끝나면 권한을 해제할 수 있습니다. 시스템에서 서명 충돌을 알리면 이전 설정을 먼저 백업하고 기존 배포 경로를 통해 업데이트하세요. 백업하지 않은 이전 버전을 바로 삭제하지 마세요.
앱은 열리지만 연결을 시작할 수 없다면 다른 앱이 VPN 연결을 계속 사용 중인지, 현재 클라이언트의 VPN 요청을 거부한 적이 있는지 확인하세요. 기기에서 허용하는 범위에서 충돌하는 연결을 종료한 뒤 클라이언트 하나만 따로 테스트하세요. 시스템의 VPN 사용 충돌을 APK 아키텍처 문제로 오인하지 않도록 주의하세요.
| 확인 항목 | 적용 조건 |
|---|---|
| 앱 아키텍처 | arm64-v8a를 지원하면 arm64를 선택하고, 아키텍처를 모르면 범용 버전을 고려하세요. |
| 시스템 버전 | APK의 최소 시스템 요구 사항을 충족해야 합니다. 시스템 설치 프로그램의 안내를 따르세요. |
| 설치 정책 | 시스템에서 현재 출처의 앱 설치를 허용해야 합니다. 업무용 프로필에는 별도 제한이 있을 수 있습니다. |
일부 기기는 CPU가 64비트를 지원해도 시스템에서는 32비트 앱만 실행할 수 있습니다. 설치 파일은 시스템에서 지원하는 앱 아키텍처에 맞춰 선택하세요.
ARM64 설치 파일: deb 다운로드 · arm64 rpm 다운로드 · aarch64
배포판의 시스템 정보에서 버전과 CPU 아키텍처를 확인하세요. amd64와 x86_64는 모두 x64를 나타냅니다. arm64와 aarch64는 일반적으로 같은 종류의 64비트 ARM 대상을 나타냅니다. 먼저 배포판에 맞는 패키지 형식을 고른 다음 아키텍처를 확인하세요. 파일 확장자가 같다는 이유로 다른 아키텍처용 패키지를 설치하지 마세요.
배포판의 패키지 설치 도구로 로컬 패키지를 열고 누락된 종속 항목을 확인하세요. 현재 rpm 파일명의 el10은 빌드 대상 표시이며, rpm을 지원하는 모든 배포판에서 종속성이 충족된다는 뜻은 아닙니다. 도구에서 종속성을 충족할 수 없다고 나오면 배포판 버전과 소프트웨어 저장소를 확인하세요. 종속성을 강제로 건너뛰거나 확장자를 바꿔 패키지 형식을 변환하려고 하지 마세요.
설치가 끝나면 데스크톱 세션에서 클라이언트를 실행하세요. 일부 데스크톱 환경의 시스템 프록시 설정은 해당 설정을 읽는 앱에만 적용됩니다. 브라우저와 터미널의 동작이 다르면 각 앱의 프록시 설정 사용 방식을 먼저 확인한 뒤 클라이언트 모드를 바꿀지 결정하세요.
| 확인 항목 | 적용 조건 |
|---|---|
| 패키지 형식 | Debian·Ubuntu 계열은 보통 deb를, Fedora·RHEL 계열은 보통 rpm을 선택합니다. |
| 프로세서 | x64와 ARM64용 패키지를 각각 제공합니다. 패키지 형식만으로 아키텍처를 판단할 수 없습니다. |
| 데스크톱 환경 | 그래픽 클라이언트를 실행할 수 있는 데스크톱 세션이 있어야 하며, 배포판이 패키지 종속성을 충족해야 합니다. |
원격 터미널로 관리하는 호스트에 패키지를 설치할 수 있더라도 현재 터미널 세션에서 그래픽 인터페이스를 열 수 있다는 뜻은 아닙니다.
새로 설치한다면 현재 기기에 맞는 패키지 하나만 선택하면 됩니다. 업그레이드 전에는 클라이언트 이름, 시스템 아키텍처, 기존 설치 경로를 기록하고 구독과 수동 설정을 각각 백업하세요. 구독을 다시 가져와 노드를 복원할 수는 있지만, 기기에서 직접 설정한 분할 터널링, 포트, 프록시 모드는 구독만으로 복원되지 않을 수 있습니다.
다운로드한 파일이 웹페이지로 인식되면 다운로드가 완료됐는지, 선택한 다운로드 링크의 파일 형식이 맞는지 먼저 확인하세요. 확장자를 직접 바꿔 설치를 진행하지 마세요. 다운로드 오류와 설치 오류는 구분하기 쉽습니다. 다운로드 오류는 예상한 형식의 파일을 받지 못한 경우이고, 설치 오류는 시스템 설치 프로그램에 메시지가 표시되는 경우입니다.
다른 기기에 설치 파일을 준비할 때는 대상 기기의 운영체제와 아키텍처에 맞는 파일을 선택하세요. 설치 파일을 복사해도 클라이언트의 구독 설정은 함께 옮겨지지 않습니다. 설정을 공유하려면 지원되는 가져오기 방법을 별도로 선택하고 접근 권한이 있는 구독 주소를 안전하게 보관하세요.
클라이언트 비교 보기처음 실행한 뒤 프로그램이 정상적으로 열리는지 확인하고, 구독을 가져와 수동으로 업데이트하세요. 목록에 예상한 항목이 표시되면 사용 가능 여부를 알고 있는 노드 하나를 선택해 테스트하세요. 구독 가져오기는 노드 연결과 별개의 요청이므로 한쪽이 성공했다고 다른 쪽도 정상이라는 뜻은 아닙니다.
프록시 설정을 확인할 수 있는 앱 하나를 정해 비교하고, 테스트할 때는 한 번에 옵션 하나만 바꾸세요. 시스템 프록시는 앱이 시스템 설정을 읽어야 적용됩니다. TUN은 가상 네트워크 인터페이스와 시스템 권한, 적용 범위에 영향을 받습니다. 처음 문제를 확인할 때 모드와 DNS, 라우팅 규칙을 동시에 바꾸면 어떤 설정이 결과를 바꿨는지 찾기 어렵습니다.
같은 앱에서 같은 주소에 접속해 프록시를 켜기 전과 후를 비교하세요. 켰을 때만 실패한다면 클라이언트 로그를 먼저 확인하세요. 두 경우 모두 실패하면 로컬 네트워크부터 점검하세요. 문제를 기록할 때 오류 메시지와 발생 단계를 남기되 구독 주소와 기타 접속 정보는 삭제하세요.
v2rayN 설정 안내 보기아니요. 처음 설치한다면 Desktop 버전을 선택하세요. 기존 WPF 조작 방식이나 설정에 익숙하다면 WPF 버전을 계속 사용해도 됩니다. 전환하기 전에 설정을 백업하고 기존 클라이언트를 종료해 두세요. 두 인스턴스가 로컬 프록시 포트를 동시에 사용하는 일을 막을 수 있습니다.
아니요. 범용 패키지는 더 다양한 CPU 아키텍처를 지원하기 위한 것으로, 운영체제 버전 부족이나 설치 권한 제한, 앱 서명 충돌까지 해결해 주지는 않습니다. 먼저 시스템 설치 프로그램에 표시된 오류 원인을 확인한 뒤 패키지를 바꿀지 결정하세요.
Debian·Ubuntu 계열 배포판은 보통 deb를, Fedora·RHEL 계열은 rpm을 사용합니다. 패키지 형식을 맞춘 다음에도 CPU 아키텍처와 배포판 종속성을 확인해야 합니다. 파일을 열 수 있다고 설치할 수 있는 것은 아닙니다.
클라이언트 설치 파일에는 구독이나 노드가 포함되어 있지 않습니다. 서비스 제공업체나 네트워크 관리자에게 사용 중인 클라이언트와 호환되는 설정을 받아 안내에 따라 가져오세요. 접속 정보가 포함된 구독 주소를 공개된 곳에 공유하지 마세요.
우선 재설치할 필요는 없습니다. 구독을 업데이트할 수 있는지, 노드를 선택했는지, 앱이 예상한 프록시 모드로 동작하는지 확인하세요. 관련 로그에서 처음 나타난 오류를 기록하세요. 프록시를 일시 중지해도 인터넷에 연결되지 않는다면 먼저 시스템 네트워크를 점검하세요.