먼저 운영체제에 맞는 UI 버전을 고르고, 다음으로 프로세서 아키텍처에 맞는 설치 파일을 선택하세요. WPF와 Avalonia는 창, 메뉴, 플랫폼 연동 방식을 결정할 뿐 노드 속도나 프로토콜 지원을 직접 좌우하지 않습니다. v2rayN 설치 파일을 고르거나 Windows에서 다른 데스크톱 OS로 옮길 예정인 사용자, UI 버전을 바꿔야 할지 고민하는 사용자에게 적합한 안내입니다. 읽은 뒤 설치 파일 선택, 마이그레이션, 연결 확인을 차례로 진행할 수 있습니다.
UI 프레임워크·프록시 코어·노드 설정 구분하기
WPF는 Windows용 데스크톱 UI 프레임워크입니다. Avalonia는 크로스 플랫폼 데스크톱 UI 프레임워크로, 이를 바탕으로 v2rayN은 macOS와 Linux를 포함한 데스크톱 버전을 제공합니다. 둘 다 v2rayN의 그래픽 관리 UI입니다. 서버 목록 표시, 구독 관리, 라우팅 편집을 담당하고 설정을 프록시 코어에 전달해 실행합니다. Avalonia를 새로운 프록시 프로토콜로 여기거나 WPF를 코어 이름으로 오해하지 마세요.
- UI 계층 확인: 메뉴 위치, 트레이 조작, 글꼴 크기 조정, 창 사용 방식과 시스템 연동을 비교하세요.
- 코어 계층 확인: 실제로 사용하는 코어와 버전, 배포 패키지에 필요한 실행 파일이 포함되어 있는지 확인하세요.
- 설정 계층 확인: VMess, VLESS 등의 프로토콜 매개변수와 전송 방식, TLS, 라우팅 및 DNS 설정을 확인하세요.
예를 들어 구독에 VLESS 설정이 있다고 해서 UI만 바꾸면 연결 문제가 저절로 해결되는 것은 아닙니다. 사용 가능 여부는 코어의 해당 매개변수 지원, 서버 설정과의 일치 여부, 가져온 설정의 누락 여부에 달려 있습니다. 같은 노드와 코어, 라우팅을 사용한다면 UI 프레임워크만 보고 어느 버전이 더 빠른지 판단할 수 없습니다.
운영체제에 맞춰 WPF 또는 Avalonia 선택하기
먼저 다운로드 페이지에서 현재 제공하는 운영체제별 옵션을 확인하세요. Windows 사용자는 사용 방식과 제공되는 버전에 따라 선택할 수 있습니다. macOS와 Linux 사용자는 해당 OS용 Avalonia 데스크톱 버전을 선택해야 하며, WPF 패키지를 실행하려고 해서는 안 됩니다. 아래 추천은 ‘Windows에서 기존 UI를 계속 사용하는’ 경우를 위한 것으로, 모든 기기에 WPF를 권하는 것은 아닙니다.
WPF 버전: Windows 클래식 UI 유지
추천Windows에서 실행됩니다. 이미 설정을 안정적으로 사용 중이고 기존 메뉴와 트레이 조작에 익숙하다면, 시스템에 맞는 WPF 버전을 계속 사용해 새 UI에 적응하는 부담을 줄일 수 있습니다. 별도 런타임이 필요한지는 선택한 패키지의 안내를 확인하세요.
추천 대상: Windows에서 일상적으로 사용하거나 WPF 설정을 이미 갖추고 있어 기존 사용 방식을 유지하려는 경우.
Avalonia 데스크톱 버전: 운영체제에 맞는 패키지 선택
크로스 플랫폼 데스크톱 UI를 제공하며 macOS와 Linux를 지원합니다. 해당 운영체제용 패키지가 제공되면 Windows에서도 사용할 수 있습니다. 운영체제마다 트레이, 권한, 시스템 프록시 동작은 다를 수 있으므로 UI가 비슷하다고 해서 기반 설정까지 같다고 볼 수는 없습니다.
추천 대상: macOS 또는 Linux 데스크톱 사용자, 여러 운영체제를 오가며 사용하거나 비슷한 UI 구성을 선호하는 경우.
현재 WPF 버전으로 구독 업데이트, 라우팅 설정, 일상적인 연결이 원활하다면 ‘크로스 플랫폼’이라는 이유만으로 옮길 필요는 없습니다. 반대로 macOS나 Linux에서 v2rayN을 사용하려면 해당 OS용 데스크톱 버전을 선택하고 제공 기능을 확인하세요. Windows 화면을 기준으로 똑같은 이름의 메뉴를 하나씩 찾으려 하지 마세요.
운영체제 아키텍처·패키지 유형·런타임 의존성 확인
프레임워크를 올바르게 고르는 것은 첫 단계일 뿐입니다. 운영체제나 프로세서 아키텍처가 맞지 않거나 배포 패키지에 필요한 런타임이 없으면 앱이 실행되지 않을 수 있습니다. 파일명에 v2rayN이 들어 있는지만 보고 덮어 설치하지 마세요.
- Windows에서 시스템 종류 확인: ‘설정’ → ‘시스템’ → ‘시스템 정보’를 열고 장치 사양의 시스템 종류를 확인한 다음, 다운로드 페이지에서 제공하는 x64 또는 ARM64 패키지를 선택하세요.
- macOS에서 칩 확인: Apple 메뉴에서 ‘이 Mac에 관하여’를 열고 Apple 칩인지 Intel 프로세서인지 확인한 뒤, 다운로드 페이지에 표시된 아키텍처에 맞는 패키지를 선택하세요.
- Linux에서 아키텍처 확인: 아래 명령을 실행하세요. 일반적으로
x86_64는 x64,aarch64는 ARM64에 해당합니다. 그런 다음 배포판에 맞춰 실제 제공되는 패키지 형식을 선택하세요. - 의존성 안내 확인: 독립 실행형 패키지인지 시스템 런타임에 의존하는 패키지인지 확인하세요. .NET 런타임 설치가 필요한지는 해당 패키지 안내와 시작 오류를 기준으로 판단해야 합니다. WPF나 Avalonia라는 이름만으로 단정할 수 없습니다.
uname -mLinux의 deb, rpm, 압축 파일은 서로 자유롭게 바꿔 쓸 수 있는 형식이 아닙니다. 배포판의 패키지 관리 체계에 맞춰 선택하세요. 압축 파일을 사용하는 경우 프로그램 실행 권한과 관련 의존성도 확인해야 합니다. macOS에서 보안 경고가 표시되면 패키지 출처와 시스템 호환성을 먼저 확인하고 운영체제의 정상적인 승인 절차를 따르세요. 시스템 보안 기능을 통째로 끄지 마세요.
구독과 라우팅 마이그레이션: 설정 출처를 복사한 뒤 시스템 설정 재확인
WPF에서 Avalonia로 전환하거나 Windows에서 다른 데스크톱 기기로 옮길 때는 구독 주소를 우선 재사용하세요. 구독은 보통 노드 설정을 배포하지만 클라이언트의 모든 환경설정을 동기화하지는 않습니다. 시스템 프록시, 수신 주소, DNS, 라우팅 규칙, 로컬 파일 경로는 새 기기에서 하나씩 확인해야 합니다.
마이그레이션 방법: 기존 환경은 유지하고 새 환경을 별도로 검증
기존 기기 또는 기존 UI 버전
- 구독 출처와 그룹 이름을 기록하고, 접근 정보가 포함된 주소는 안전하게 보관하세요.
- 현재 노드, 라우팅 모드, DNS, 로컬 수신 설정을 기록하세요.
- 기존 설정을 백업하고 정상 작동하는 환경을 바로 삭제하지 마세요.
대상 기기 또는 새 UI 버전
- 같은 구독 주소를 추가하고 저장한 뒤 구독을 업데이트하세요.
- 노드를 선택해 프로토콜, 전송 방식, 보안 매개변수가 모두 있는지 확인하세요.
- 시스템 관련 옵션을 하나씩 다시 설정한 다음 로그와 웹 페이지 접속을 확인하세요.
구독을 공유해도 모든 설정이 공유되는 것은 아닙니다. 먼저 노드를 확인한 뒤 라우팅과 네트워크 트래픽 처리 방식을 옮기세요.
일반적인 중국어 UI의 v2rayN에서는 ‘구독 그룹’ → ‘구독 그룹 설정’에서 주소를 추가한 다음, ‘구독 그룹’ 메뉴의 업데이트 기능으로 노드를 가져올 수 있습니다. 버전에 따라 메뉴 이름이나 위치가 달라질 수 있습니다. 같은 항목을 찾을 수 없다면 ‘구독 그룹 관리’와 ‘구독 업데이트’에 해당하는 기능을 찾으세요. 구독 주소를 개별 노드 링크로 가져오면 안 됩니다.
로컬 라우팅 파일을 옮길 때는 경로가 여전히 유효한지도 확인하세요. Windows의 드라이브 문자 경로는 macOS나 Linux에서 그대로 사용할 수 없으며 파일명의 대소문자도 읽기에 영향을 줄 수 있습니다. 전체 설정을 백업했다면 대상 버전이 해당 백업 형식을 지원하는지 먼저 확인하세요. 프로그램이 실행 중일 때 설정 디렉터리 전체를 다른 플랫폼에 강제로 덮어쓰지 마세요.
- 구독 사용 권한 확인: 같은 주소를 여러 기기에서 사용할 수 있는지는 구독 제공자의 제한을 따르세요.
- 접근 정보 보호: 화면을 공유하기 전에 구독 주소, UUID, 비밀번호 및 관련 키를 가리세요.
- 각 버전을 따로 테스트: 한 컴퓨터에서 버전을 바꿀 때는 기존 프로그램을 먼저 종료하세요. 두 인스턴스가 수신 포트를 동시에 사용하거나 시스템 프록시 설정을 번갈아 바꾸는 일을 막을 수 있습니다.
로컬 수신과 시스템 프록시 확인하기: UI만 보고 연결 결과를 판단하지 않기
가져오기를 마친 뒤 먼저 프록시 코어가 정상적으로 시작되었는지 확인하고, 앱이 실제로 로컬 프록시를 사용하는지도 점검하세요. 아래에서는 로컬 수신 주소의 예시로 127.0.0.1:10808을 사용합니다. 이 포트가 모든 버전의 기본값이라는 뜻은 아닙니다. 실제 주소, 포트, 인바운드 유형은 현재 클라이언트 설정과 로그를 기준으로 확인하세요.
- 코어 시작 확인: 로그에서 설정 파싱 오류, 코어 파일 누락, 포트 충돌이 있는지 확인하세요. 시작 오류를 해결한 뒤 웹 페이지 접속을 테스트하세요.
- 수신 유형 확인: 포트가 SOCKS, HTTP 또는 혼합 인바운드를 제공하는지 확인하세요. 앱에 프록시를 수동 입력할 때는 프로토콜 유형을 해당 인바운드에 맞춰야 합니다.
- 시스템 프록시 확인: v2rayN의 시스템 프록시 메뉴에서 트래픽 처리 방식을 설정한 뒤 운영체제의 프록시 상태도 확인하세요. 데스크톱 환경마다 시스템 프록시를 참조하는 범위가 다릅니다.
- 라우팅과 트래픽 처리를 구분: 시스템 프록시는 일부 프로그램이 요청을 클라이언트로 보내도록 합니다. 라우팅은 해당 요청을 직접 연결할지 프록시로 보낼지 결정합니다. 라우팅을 전역 프록시로 설정해도 모든 프로그램의 트래픽이 처리되는 것은 아닙니다.
- 실제 앱으로 테스트: 먼저 시스템 프록시를 사용하는 브라우저에서 접속한 다음 대상 프로그램을 테스트하세요. 대상 프로그램에 별도 프록시 설정이 있다면 따로 구성해야 합니다.
노드 지연 시간 테스트에 성공했다는 것은 해당 테스트 경로에서 응답을 받았다는 뜻일 뿐, 웹 페이지 접속이나 DNS 확인, 대상 앱 테스트를 대신하지는 않습니다. Avalonia와 WPF의 외관 차이만으로 모든 시스템 프록시 동작 차이를 설명할 수도 없습니다. ‘노드 목록에서는 속도가 측정되는데 프로그램은 인터넷에 연결되지 않음’ 문제가 있다면 구독을 반복해서 가져오기보다 위 경로를 따라 트래픽 처리 범위를 확인하세요.
자주 묻는 질문: 버전을 바꾸기 전에 확인할 사항
Windows에서 WPF를 사용 중인데 구독을 계속 쓰려면 Avalonia로 바꿔야 하나요?
UI 프레임워크가 다르다는 이유만으로 바꿀 필요는 없습니다. 먼저 구독을 업데이트하고 해당 노드의 매개변수와 코어 로그를 확인하세요. 특정 노드만 연결에 실패한다면 프로토콜 매개변수, 서버 상태, 코어 지원 여부를 점검해야 합니다. UI 선택과 구독 유효기간은 서로 다른 문제입니다.
Avalonia로 바꾼 뒤에도 노드는 그대로인데 왜 분기 라우팅 결과가 달라졌나요?
현재 라우팅 모드와 규칙 순서, DNS 설정을 확인한 뒤 시스템 프록시나 TUN이 실제로 활성화되었는지 확인하세요. 구독을 다시 가져와도 보통 노드 목록만 복원되며 기존 기기의 모든 규칙과 시스템 설정이 자동으로 복구되지는 않습니다.
두 버전을 동시에 열면 한쪽이 시작되지 않는 이유는 무엇인가요?
먼저 한쪽을 종료한 다음 실패한 인스턴스의 로그를 확인하세요. 주소나 포트가 이미 사용 중이라는 메시지가 있으면 로컬 수신 포트를 점검하세요. 평소에는 시스템 프록시를 관리하는 인스턴스를 하나만 실행해야 합니다. 포트를 다르게 설정하더라도 두 인스턴스가 같은 시스템 프록시 설정을 동시에 관리하게 해서는 안 됩니다.
컴퓨터와 Android 기기에서 같은 설정 디렉터리를 그대로 복사해도 되나요?
디렉터리 전체를 그대로 복사하지 마세요. 데스크톱에서는 v2rayN을, Android에서는 v2rayNG 또는 v2flyNG를 사용할 수 있지만 설정 저장 방식과 항목은 서로 다릅니다. 각 기기에서 같은 구독을 추가한 뒤 라우팅을 따로 설정하세요. v2rayNG는 Xray 코어, v2flyNG는 v2fly 코어를 사용하므로 노드에 필요한 기능이 해당 코어에서 지원되는지도 확인해야 합니다.
선택 순서는 간단하게 유지하세요. 먼저 운영체제를 정하고, 아키텍처와 배포 패키지 의존성을 확인한 다음 구독, 코어, 트래픽 처리를 검증합니다. Windows에서는 UI 사용 방식에 따라 선택할 수 있고, macOS와 Linux에서는 해당 OS용 Avalonia 데스크톱 패키지를 고르세요. 프레임워크 이름을 속도 순위처럼 여기거나 UI 통일을 위해 기기별 네트워크 설정을 무시하지 마세요.