v2rayN
추천 7.24.1Desktop은 차세대 크로스 플랫폼 인터페이스를 사용하며, 처음 설치하거나 데스크톱 운영체제를 바꿔가며 사용하는 경우에 적합합니다. WPF는 안정적인 클래식 버전으로, 기존 인터페이스와 트레이 조작에 익숙한 사용자에게 알맞습니다. 두 버전은 같은 클라이언트의 서로 다른 인터페이스이므로 하나만 선택하면 됩니다.
GUI 클라이언트 · 설치 파일
운영체제를 선택한 뒤 프로세서 아키텍처를 확인하세요. 데스크톱에서는 v2rayN을 사용하고, Android에서는 설정에 필요한 코어에 따라 v2rayNG 또는 v2flyNG를 선택할 수 있습니다.
Desktop은 차세대 크로스 플랫폼 인터페이스를 사용하며, 처음 설치하거나 데스크톱 운영체제를 바꿔가며 사용하는 경우에 적합합니다. WPF는 안정적인 클래식 버전으로, 기존 인터페이스와 트레이 조작에 익숙한 사용자에게 알맞습니다. 두 버전은 같은 클라이언트의 서로 다른 인터페이스이므로 하나만 선택하면 됩니다.
| 확인 항목 | 요구 사항 |
|---|---|
| 운영체제 및 아키텍처 | Windows 10 또는 11, x64 운영체제 및 프로세서 |
| 설치 형식 | ZIP 압축 파일. 압축을 모두 푼 뒤 안에 있는 설치 프로그램을 실행하세요. |
| 실행 환경 | 런타임이 없다는 메시지가 표시되면 선택한 버전의 시작 안내에 따라 처리하세요. |
「설정 → 시스템 → 정보」를 열어 「시스템 종류」를 확인하세요. 이 영역의 두 다운로드 항목은 모두 x64 패키지입니다. 컴퓨터 브랜드만으로 아키텍처를 판단하지 말고, 프로세서가 지원하는 비트 수와 현재 실행 중인 운영체제의 종류를 혼동하지 마세요.
다운로드 폴더에서 ZIP 파일을 별도 폴더에 완전히 압축 해제한 뒤 안에 있는 설치 프로그램을 실행하세요. 업데이트 전에 시스템 프록시를 사용 중이었다면 기존 클라이언트에서 시스템 프록시를 해제하고 프로그램을 종료하세요. 그래야 설치 중 브라우저가 종료된 로컬 포트로 요청을 보내는 일을 방지할 수 있습니다.
다른 인터페이스로 전환할 때 새 설치 폴더로 기존 폴더를 바로 덮어쓰지 마세요. 기존 구독 그룹, 라우팅, 프록시 모드를 저장한 뒤 새 버전을 실행해 인터페이스와 설정을 확인하세요. 새 버전에서 구독 업데이트와 연결이 정상적으로 되는 것을 확인한 다음 기존 버전을 제거할지 결정하세요.
Apple 메뉴에서 「이 Mac에 관하여」를 여세요. 「칩」에 Apple M 시리즈가 표시되면 Apple Silicon을 선택하고, Intel 「프로세서」가 표시되면 Intel 버전을 선택하세요. 두 패키지는 기능 등급이 아니라 서로 다른 기기에 맞는 버전입니다.
| 확인 항목 | 요구 사항 |
|---|---|
| 칩 | Apple Silicon은 arm64, Intel은 x64에 해당합니다. |
| 운영체제 버전 | 현재 앱 버전에서 지원하는 최소 macOS 버전을 기준으로 합니다. |
| 설치 형식 | DMG 디스크 이미지. 앱을 응용 프로그램 폴더에 복사할 권한이 필요합니다. |
DMG를 열고 앱을 「응용 프로그램」 폴더에 복사한 다음 해당 폴더에서 실행하세요. 업데이트 전에 메뉴 막대에서 실행 중인 프로세스를 포함해 기존 버전을 모두 종료하세요. 복사가 끝나면 디스크 이미지를 꺼내야 다음 실행 때 이미지 안의 복사본으로 이전 앱을 잘못 실행하는 일을 막을 수 있습니다.
앱은 열리지만 브라우저에서 프록시를 사용하지 않는다면, 먼저 클라이언트에서 활성 서버를 선택했는지 확인하세요. 그런 다음 「시스템 설정 → 네트워크」에서 현재 네트워크 서비스의 프록시 설정을 확인합니다. 앱 실행과 프록시 적용은 별도로 확인할 항목이므로, 프록시가 적용되지 않는다고 앱을 다시 다운로드할 필요는 없습니다.
시작 안내 메시지가 표시되면 전체 내용을 기록하고 칩과 운영체제 버전을 확인하세요. 앱 권한, 네트워크 권한, 설치 파일 아키텍처는 서로 다른 문제입니다. 조직에서 관리하는 기기는 관리자의 지침에 따라 처리하세요.
Xray 코어를 사용합니다. 2015년 이후 출시된 일반적인 스마트폰은 대개 arm64를 선택하면 됩니다. 단, 시스템에서 arm64-v8a를 지원해야 합니다. 아키텍처를 확인하기 어렵다면 범용 버전을 선택할 수 있습니다.
V2Fly 코어를 사용합니다. V2Fly용 설정을 이미 보유하고 있고 현재 버전이 사용하는 프로토콜을 지원하는지 확인했다면 이 클라이언트를 선택할 수 있습니다. 두 앱의 고급 설정이 서로 호환된다고 가정하지 마세요.
| 확인 항목 | 요구 사항 |
|---|---|
| arm64 패키지 | 시스템에서 arm64-v8a 앱을 지원해야 합니다. |
| 범용 패키지 | 기기가 패키지에 포함된 아키텍처 중 하나와 호환되고, 시스템 버전이 앱 요구 사항을 충족해야 합니다. |
| 연결 권한 | VPN 모드를 사용할 때는 시스템의 VPN 연결 요청을 승인해야 합니다. |
휴대폰에 64비트 프로세서가 있다고 해서 시스템에서 64비트 앱 설치를 지원한다고 단정할 수는 없습니다. 설치 파일이 호환되지 않는다는 메시지가 표시되면 시스템이 지원하는 앱 아키텍처와 운영체제 버전을 먼저 확인하세요. 범용 패키지는 일부 아키텍처 선택 문제를 해결할 수 있지만 앱의 최소 운영체제 버전을 낮추지는 않습니다.
브라우저나 파일 관리자에서 APK를 열면 시스템에서 해당 출처의 설치 권한을 요청할 수 있습니다. 직접 다운로드한 파일을 열었는지 확인한 뒤 해당 출처의 권한을 설정하세요. 처음 실행한 뒤 VPN 모드에서도 별도의 연결 권한 요청이 표시됩니다. 설치가 완료되었다고 이 권한까지 허용된 것은 아닙니다.
업그레이드 전에 「항상 켜기 VPN」을 사용 중이었다면 시스템 VPN 설정에서 연결된 앱이 무엇인지 확인하세요. 새 클라이언트를 시험할 때는 기존 연결을 중지해야 연결이 점유된 문제를 구독 오류로 오해하지 않습니다. 덮어 설치에 실패하더라도 기존 앱의 설정은 유지하세요.
Debian 및 Ubuntu 계열은 deb 패키지를 우선 확인하세요. RPM 패키지를 사용하는 배포판에서는 대상 환경과 의존성을 먼저 점검해야 합니다. 현재 RPM 파일 이름의 el10은 빌드 대상을 뜻하므로, 확장자만 보고 모든 RPM 기반 시스템에 설치할 수 있다고 판단하지 마세요.
| 확인 항목 | 요구 사항 |
|---|---|
| 아키텍처 | x86_64는 x64, aarch64는 arm64를 선택하세요. |
| 배포판 | 패키지 형식, 대상 배포판, 의존성이 모두 일치해야 합니다. |
| 데스크톱 환경 | 그래픽 데스크톱 세션을 사용해야 하며, 설치 권한은 시스템 패키지 관리자가 처리합니다. |
시스템 설정의 「정보」 페이지에서 배포판, 버전, 프로세서 종류를 확인하세요. 패키지 이름의 amd64는 AMD 프로세서뿐 아니라 호환되는 Intel x64 기기에도 사용됩니다. aarch64와 arm64는 같은 종류의 아키텍처를 가리킵니다.
배포판의 그래픽 패키지 관리자로 파일을 열고 의존성 안내를 확인한 뒤 설치를 진행하세요. 시스템 라이브러리 버전이 낮다는 메시지가 표시되면 의존성을 강제로 무시하거나 다른 배포판의 저장소로 시스템 라이브러리를 교체하지 마세요. 먼저 현재 배포판이 패키지의 빌드 대상에 맞는지 확인하세요.
설치가 끝나면 데스크톱 앱 메뉴에서 v2rayN을 실행하세요. 창이 열리는지, 구독을 새로 고칠 수 있는지 확인한 뒤 프록시를 테스트합니다. 브라우저에서는 정상적으로 작동하지만 다른 프로그램에서 프록시를 사용하지 않는다면, 해당 프로그램이 데스크톱 환경의 프록시 설정을 읽는지 확인하세요.
클라이언트를 실행한 뒤 기존 구독을 가져와 한 번 업데이트하고 서버를 선택하세요. 연결 모드는 하나만 테스트하고 기본 연결이 정상인지 확인한 다음 라우팅이나 DNS를 변경합니다. 설치 직후 시스템 프록시와 TUN을 동시에 켜고 분할 라우팅까지 바꾸면 가져오기, 연결, 트래픽 처리 중 어디에서 문제가 생겼는지 파악하기 어렵습니다.
테스트할 때는 두 가지를 따로 확인하세요. 클라이언트에 연결이 시작된 것으로 표시되는지, 대상 앱이 선택한 모드로 실제 네트워크에 접속하는지 확인해야 합니다. 연결이 시작되었는데 대상 앱에서 접속할 수 없다면 해당 앱이 시스템 프록시를 사용하는지, 또는 규칙에 따라 직접 연결로 분류되었는지 먼저 확인하세요. 설정 방법은 빠른 시작에서 확인할 수 있습니다.
업데이트하거나 이전하기 전에 기존 클라이언트의 구독 그룹, 수동으로 추가한 서버, 사용자 지정 라우팅, DNS 설정을 따로 기록하세요. 클라이언트에서 내보내기를 지원하면 백업 파일을 직접 관리하는 기기에 보관하세요. 구독 링크에는 접근 정보가 포함될 수 있으므로 문제를 해결할 때 전체 링크나 링크가 보이는 스크린샷을 공유하지 마세요.
문제가 발생하면 설치 프로그램이 실행되지 않는지, 클라이언트가 시작되지 않는지, 구독을 업데이트할 수 없는지, 아니면 연결은 시작됐지만 앱이 프록시를 사용하지 않는지 구분해 기록하세요. 단계별로 확인해야 할 설정이 다릅니다. 기본 연결이 정상이라면 심화 안내서를 참고해 라우팅, DNS, TUN을 하나씩 설정하세요.
아니요. 처음 설치한다면 Desktop을 선택하세요. 기존에 WPF 인터페이스 기반으로 사용하던 작업 환경이 있다면 클래식 WPF 버전을 계속 사용할 수 있습니다. 전환하기 전에 기존 클라이언트를 종료하고 유지할 구독과 라우팅 설정을 백업하세요.
덮어 설치 가능 여부는 아키텍처만이 아니라 앱 패키지 이름, 서명, 버전에 따라 달라집니다. 시스템에서 업데이트를 거부하면 기존 앱을 유지하고 설정을 백업한 다음, 새 설치 파일과 기존 설치 파일의 출처 및 버전을 확인하세요. 문제를 확인하기 전에 앱을 먼저 삭제하지 마세요.
직접 바꿔 설치할 수 없습니다. 배포판의 패키지 관리자가 지원하는 형식을 선택하고 배포판 버전, 프로세서 아키텍처, 의존성을 확인하세요. 의존성 부족 메시지가 표시되면 누락된 항목을 기록하고 검사를 강제로 건너뛰지 마세요.
설치 파일에는 클라이언트가 포함되어 있습니다. 처음 실행한 뒤 기존 구독이나 서버 설정을 가져오고 서버를 하나 선택해야 합니다. 구독이 있는데도 목록이 비어 있다면 업데이트를 실행했는지, 현재 올바른 구독 그룹을 보고 있는지 확인하세요.
구독은 주로 서버 목록을 동기화하는 데 사용됩니다. 라우팅 규칙, DNS 설정, 연결 모드는 따로 기록한 뒤 새 클라이언트에서 하나씩 확인하세요. 먼저 기본 연결을 점검하고, 이후 분할 라우팅과 기타 고급 설정을 복원하세요.