v2rayN Avalonia와 WPF 버전 비교: UI 프레임워크, 지원 플랫폼 및 선택 가이드

WPF 버전은 Windows 전용이며 Avalonia 데스크톱 버전은 Windows, macOS, Linux를 지원합니다. UI 프레임워크와 실행 환경, 기능 차이, 설정 이전 방법을 비교해 적합한 버전을 안내합니다.

핵심 요약

처음 설치한다면 Avalonia 데스크톱 버전을 우선 고려하세요. Windows에서 WPF 설정을 안정적으로 사용 중이라면 그대로 써도 됩니다. 버전을 바꿀 때는 노드를 먼저 옮긴 뒤 코어, 라우팅, 시스템 프록시를 확인하세요. 화면을 똑같이 맞추려고 기존 설정을 그대로 복사할 필요는 없습니다.

지원 플랫폼: Windows는 두 버전 중 선택, macOS와 Linux는 데스크톱 버전

Avalonia와 WPF는 먼저 UI 프레임워크의 차이입니다. 창과 컨트롤을 표시하는 방식, 실행할 수 있는 데스크톱 운영체제를 좌우합니다. VMess 또는 VLESS 연결 여부는 실제로 사용하는 코어와 노드 매개변수, 서버 설정에 따라 달라집니다. 설치 파일에 표시된 UI 프레임워크 이름을 코어 이름과 혼동하지 마세요.

처음 설치할 때와 기존 설정이 있을 때

Avalonia 데스크톱 버전

권장

Windows, macOS, Linux를 지원합니다. 여러 운영체제에서 사용해도 구독과 노드 관리 방식은 이어갈 수 있지만, 트레이 메뉴와 시스템 프록시, 권한은 운영체제별로 확인해야 합니다.

추천 대상: 처음 설치하거나 여러 데스크톱 운영체제에서 v2rayN을 사용하려는 경우

WPF 버전

Windows 전용입니다. 현재 버전에서 필요한 프로토콜을 사용할 수 있고 라우팅 규칙도 검증했다면, UI 프레임워크만 바꾸려고 설정을 다시 구성할 필요는 없습니다.

추천 대상: 설정을 마친 Windows 환경을 계속 사용하려는 경우

설치 파일과 실행 환경: 운영체제, 아키텍처, 런타임 확인

다운로드하기 전에 노드 서버의 운영체제가 아니라 클라이언트를 실행할 기기를 확인하세요. Windows에서는 ‘설정’ → ‘시스템’ → ‘정보’에서 시스템 종류를 확인할 수 있습니다. macOS에서는 ‘이 Mac에 관하여’에서 Apple 칩인지 Intel 프로세서인지 확인하세요. Linux에서는 uname -m을 실행하면 됩니다. 일반적으로 x86_64는 x64, aarch64는 ARM64에 해당합니다.

.NET을 별도로 설치해야 하는지는 Avalonia나 WPF 여부만으로 결정되지 않습니다. 배포 파일에 런타임이 포함되어 있는지 확인하세요. Windows에서 Microsoft.WindowsDesktop.App이 없다는 메시지가 표시되면 필요한 버전과 아키텍처를 확인하고 해당하는 .NET Desktop Runtime을 설치하세요. 같은 버전의 기본 런타임만 설치해서는 해결되지 않습니다. 메인 창은 열리지만 노드를 시작할 때 오류가 난다면 코어 로그부터 확인하세요. 코어 시작 실패를 UI 런타임 누락으로 오인하지 마세요.

기능 차이 확인: 코어, 라우팅, 트래픽 연결 방식

버전을 바꾼 뒤 같은 노드가 표시되는 것은 노드 데이터가 가져와졌다는 뜻일 뿐입니다. 실제 동작을 비교하려면 같은 노드를 사용하고 코어 종류를 확인한 다음 라우팅과 트래픽 연결 방식을 비교하세요. UI와 코어, 테스트 노드를 한꺼번에 바꾸면 지연 시간이 달라져도 원인을 특정할 수 없습니다.

  1. 코어와 프로토콜: 기존에 연결되던 노드를 선택해 프로토콜, 전송 방식, 보안 설정을 확인한 뒤 로그에서 실제로 시작된 코어를 살펴보세요. VLESS 노드의 전송 및 보안 매개변수는 서버 설정과 일치해야 합니다. Avalonia로 바꿔도 누락된 항목이 자동으로 채워지지는 않습니다.
  2. 라우팅: ‘설정’ → ‘라우팅 설정’에서 현재 선택된 규칙 세트를 확인하세요. 사용자 지정 규칙을 가져온 뒤에는 규칙의 적용 순서와 참조하는 규칙 리소스가 모두 있는지도 점검해야 합니다. 직접 연결되어야 하는 대상과 프록시를 거쳐야 하는 대상을 각각 접속해 확인하세요. 웹페이지 하나가 열린다는 것만으로 완료 처리하지 마세요.
  3. 트래픽 연결 방식: 메인 화면이나 트레이 메뉴에서 ‘시스템 프록시’ 상태를 확인하세요. 먼저 시스템 프록시를 따르는 앱으로 연결을 테스트한 뒤 TUN을 별도로 확인할지 결정하면 됩니다. 시스템 프록시는 모든 앱의 트래픽을 자동으로 처리하지 않습니다. TUN은 플랫폼 권한과 네트워크 설정이 필요하므로, 시스템 프록시와 함께 처음부터 문제 해결에 사용하지 않는 편이 좋습니다.

동시 테스트 시 포트 설정 예시

10808
예: 기존 버전에서 사용 중인 로컬 수신 포트
10818
예: 새 버전에서 사용할 테스트 포트. 사용 가능한지 먼저 확인하세요.

두 포트는 충돌 상황을 설명하기 위한 예시이며, 각 버전의 고정 포트가 아닙니다. ‘설정’ → ‘매개변수 설정’에서 로컬 수신 포트를 확인하세요. 기존 버전이 같은 주소와 포트를 사용 중이면 새 버전의 화면은 정상적으로 열려도 수신 대기 실패가 발생할 수 있습니다. 버전을 바꿀 때는 트레이에서 기존 버전을 완전히 종료하는 것이 가장 간단합니다. 두 버전을 동시에 테스트해야 한다면 기본 수신 포트뿐 아니라 활성화된 다른 수신 항목도 확인하고, 시스템 프록시는 한 인스턴스만 변경하도록 하세요.

설정 이전: 구독은 다시 등록하고 수동 설정은 따로 확인

먼저 노드의 출처를 확인하세요. 구독 그룹은 새 버전에 구독 주소를 다시 추가한 뒤 ‘구독 그룹’ 메뉴에서 업데이트하면 됩니다. 구독에 포함되지 않은 수동 추가 노드는 공유 링크를 따로 보관하거나 로컬에 백업해야 합니다. 구독 링크와 노드 공유 링크에는 접속 정보가 포함될 수 있으므로 직접 관리하는 곳에만 보관하고, 공개 스크린샷이나 문제 해결 게시물에 올리지 마세요.

이전할 환경에 맞는 방법 선택

같은 Windows PC에서 버전 전환 또는 다른 데스크톱 운영체제로 이전

Windows에서 WPF를 Avalonia로 전환
  • 기존 버전에서 시스템 프록시를 해제하고 활성화된 TUN을 끈 다음, 트레이 메뉴에서 종료하세요. 이후 기존 버전이 실제로 사용하던 데이터 디렉터리를 백업합니다.
  • 새 버전은 기존 버전과 별도 위치에 설치해 시험하세요. 데이터 파일을 복원해야 한다면 두 버전의 데이터 형식과 디렉터리 구조가 호환되는지 먼저 확인하고, 새 버전의 원본 데이터도 따로 보관하세요.
  • 기존 버전의 기록을 참고해 라우팅과 로컬 포트를 복원하세요. 데이터를 읽지 못하면 새 버전의 데이터를 먼저 복구한 뒤 구독과 공유 링크로 노드를 다시 구성합니다.
Windows에서 macOS 또는 Linux로 이전
  • 대상 운영체제와 아키텍처에 맞는 Avalonia 패키지를 설치한 뒤 구독을 다시 추가하고 필요한 수동 노드를 가져옵니다.
  • 대상 운영체제에서 규칙 파일 위치, 앱의 수동 프록시 주소, 시작 시 실행 설정을 다시 지정하세요. Windows 전용 경로는 복사하지 마세요.
  • 먼저 일반 프록시 연결과 라우팅 결과를 확인하세요. 모든 기기의 트래픽을 처리해야 하는 경우에만 대상 운영체제에서 TUN을 별도로 설정하고 검증합니다.

새 버전이 독립적으로 실행되고 노드에 연결되며 라우팅 결과가 예상대로 나오는지를 완료 기준으로 삼으세요. 확인을 마친 뒤 기존 버전을 제거할지 결정하면 됩니다.

자주 묻는 문제: 버전 전환 후 연결 실패, 노드 누락, 앱에서 프록시 미사용

증상별 점검 방법

창을 닫았는데도 새 버전에서 포트 사용 중 오류가 발생합니다. 왜 그런가요?

창을 닫은 뒤에도 기존 버전이 트레이에서 계속 실행 중일 수 있습니다. 기존 버전의 트레이 아이콘을 찾아 ‘종료’를 선택한 다음 새 버전에서 코어를 다시 시작하세요. 계속 포트 충돌이 발생하면 ‘설정’ → ‘매개변수 설정’에서 충돌하는 포트를 확인하세요. 포트를 변경했다면 프록시 주소를 직접 입력한 앱의 설정도 함께 바꿔야 합니다.

구독 업데이트는 성공했는데 기존 버전보다 노드가 몇 개 적은 이유는 무엇인가요?

같은 구독 그룹을 선택했는지와 주소가 동일한지 먼저 확인하고, 그룹 설정의 필터 조건도 살펴보세요. 이어서 기존 버전에서 누락된 노드가 수동으로 추가한 노드인지 확인합니다. 구독 업데이트는 수동 노드를 새 버전으로 동기화하지 않으므로, 해당 노드는 별도로 가져와야 합니다.

브라우저에서는 되는데 다른 앱은 왜 연결되지 않나요?

먼저 해당 앱이 시스템 프록시 설정을 사용하는지 확인하세요. 수동 프록시를 지원하는 앱이라면 프록시 종류, 주소, 포트를 클라이언트가 실제로 제공하는 로컬 수신 항목에 맞추세요. 앱에서 이 방법을 사용할 수 없고 트래픽을 처리해야 할 필요가 있을 때만 TUN을 별도로 확인합니다.

새 버전이 맞지 않으면 WPF로 어떻게 되돌리나요?

새 버전에서 시스템 프록시를 해제하고 TUN을 끈 다음 트레이 메뉴에서 종료하세요. 보관해 둔 기존 디렉터리에서 WPF를 실행하고 현재 노드와 라우팅을 확인한 뒤 원래 시스템 프록시 설정을 복원합니다. 두 버전이 같은 데이터 디렉터리를 사용했다면 이전 전에 만든 백업으로 기존 버전 데이터를 먼저 복구하세요.

v2rayN 클라이언트플랫폼별 다운로드 보기