v2rayN 데스크톱 버전(Avalonia)과 WPF 버전 비교: UI 프레임워크·지원 플랫폼·선택 가이드

UI 프레임워크와 프록시 코어의 역할

Avalonia와 WPF는 창을 표시하고, 프록시 코어는 연결을 처리합니다. v2rayN은 서버 목록, 구독 관리, 라우팅 옵션, 코어 프로세스 관리 등을 담당하는 데스크톱 클라이언트입니다. WPF는 Windows용 UI 프레임워크이고, Avalonia는 Windows·macOS·Linux에서 사용할 수 있는 크로스 플랫폼 UI 프레임워크입니다. 다운로드 페이지의 ‘데스크톱 버전’과 ‘WPF 버전’은 주로 이 두 가지 UI 구현 방식을 구분합니다.

실제 프록시 연결은 클라이언트의 설정 생성, 코어 실행, 아웃바운드 연결 등의 단계를 거칩니다. VMess, VLESS, REALITY를 사용할 수 있는지는 선택한 코어와 버전, 노드 매개변수, 서버 설정을 확인해야 하며 창의 모양만으로 판단할 수 없습니다. Avalonia로 바꾼다고 구독 내용이 자동으로 달라지지 않으며, WPF로 바꾼다고 특정 프로토콜을 새로 사용할 수 있는 것도 아닙니다.

따라서 UI가 버벅이는 문제와 웹사이트에 접속할 수 없는 문제는 따로 확인해야 합니다. 전자는 그래픽 렌더링, 화면 배율, 데스크톱 세션과 관련이 있을 수 있습니다. 후자는 먼저 코어가 실행 중인지, 로컬 포트가 수신 대기 중인지, 앱 트래픽이 프록시로 전달되는지를 확인하세요.

Windows·macOS·Linux별 버전 선택

먼저 운영체제를 확인하고, 다음으로 프로세서 아키텍처를 선택한 뒤 UI를 비교하세요. 특정 플랫폼을 지원하는 프레임워크라도 모든 릴리스에서 각 운영체제와 아키텍처용 설치 파일을 제공하는 것은 아닙니다. 실제 선택지는 현재 클라이언트 다운로드 페이지에 표시된 내용을 기준으로 확인하세요.

• Windows: ‘설정’ → ‘시스템’ → ‘정보’에서 시스템 종류를 확인하세요. 프로세서와 운영체제에 맞는 패키지를 선택하고, UI 버전 이름을 아키텍처 이름으로 혼동하지 마세요.
• macOS: ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인하고 Apple Silicon과 Intel 프로세서를 구분해 맞는 아키텍처를 선택하세요.
• Linux: uname -m으로 아키텍처를 확인하세요. 일반적으로 x86_64는 x64, aarch64는 ARM64에 해당합니다. 배포판에 맞는 패키지 형식도 선택해야 합니다.

화면 표시, 실행 의존성, 시스템 연동

두 UI는 목록의 정보 밀도, 메뉴 위치, 글꼴 표시, 고해상도 화면 배율에서 차이가 날 수 있습니다. Avalonia는 자체 크로스 플랫폼 UI 체계를 사용하고, WPF는 Windows 데스크톱 환경과 더 밀접하게 연동됩니다. 다만 글꼴이 보기 편한지, 창을 움직일 때 부드러운지는 그래픽 드라이버, 시스템 배율, 구체적인 빌드에 따라서도 달라집니다. 프레임워크 이름만으로 결론을 내릴 수 없습니다.

두 버전 모두 .NET 기술 스택을 사용하지만, 추가 런타임 설치가 필요한지는 패키지 배포 방식에 따라 다릅니다. 자체 포함 배포는 필요한 실행 구성 요소를 함께 제공하고, 프레임워크 종속 배포는 시스템에 해당 런타임이 설치되어 있어야 합니다. 어느 한 버전이 항상 별도 의존성 설치 없이 작동한다고 단정할 수 없으며, 다른 기기의 실행 환경만으로 현재 기기의 조건을 판단해서도 안 됩니다.

시스템 트레이 동작도 별도로 확인하는 것이 좋습니다. Linux 데스크톱 환경에서는 트레이 확장 기능이나 관련 구성 요소가 필요할 수 있으며, 창을 닫은 뒤에도 계속 실행되는지는 클라이언트 설정에서 확인하세요. ‘창을 닫은 뒤 다시 찾을 수 없는’ 경우에는 프로세스, 트레이, 종료 동작 옵션을 먼저 살펴보세요. 인스턴스를 반복해서 실행하면 UI 문제에 로컬 포트 충돌까지 더해질 수 있습니다.

설정 이전 및 구독 복원

UI 버전을 바꾸기 전에 구독 주소와 주요 설정을 기록하고 기존 사용자 데이터를 백업하세요. 구독으로 서버 목록은 복원할 수 있는 경우가 많지만, 로컬 라우팅, 사용자 지정 DNS, 단축키, 수신 포트, 사용자 지정 설정까지 포함되는 것은 아닙니다. 구독 주소만 저장하는 것은 전체 설정을 백업한 것과 다릅니다.

릴리스 버전에 따라 데이터 구조와 저장 위치가 달라질 수 있으므로 이전 디렉터리 전체를 새 디렉터리에 덮어쓰지 마세요. 특히 운영체제를 바꾸면 경로 구분자, 코어 실행 파일 경로, 권한이 달라질 수 있습니다. 현재 버전에서 제공하는 내보내기·가져오기·백업 기능을 우선 사용하세요. 해당 기능을 찾을 수 없다면 최소한 기존 데이터 사본을 보관하고 수동으로 다시 설정할 항목을 기록하세요.

1. 기존 상태 기록: 구독 출처, 현재 사용하는 노드, 라우팅 모드, 로컬 포트를 저장하세요. UI에 ‘설정’ → ‘매개변수 설정’이 있다면 그곳에서 수신 대기 및 기본 옵션을 확인하세요. 메뉴 분류 이름은 현재 UI에 따라 다를 수 있습니다.
2. 기존 인스턴스 종료: 먼저 시스템 프록시나 Tun을 끈 다음 클라이언트를 종료하세요. 기존 코어가 수신 포트를 더 이상 사용하지 않는지 확인하고 새 버전을 실행하세요.
3. 서버 목록 복원: 구독 관리 메뉴에서 기존 구독 주소를 추가하고 업데이트하세요. 구독 주소에 접속 정보가 포함될 수 있으므로 전체 주소가 보이는 공개 스크린샷이나 로그를 공유하지 마세요.
4. 최소한의 테스트부터 진행: 정상 작동이 확인된 노드 하나를 선택하고 시스템 프록시만 활성화한 뒤 웹 접속과 로그를 확인하세요. 그런 다음 라우팅, DNS, Tun을 하나씩 복원하세요.
5. 되돌릴 수 있도록 준비: 새 버전 테스트가 끝나기 전에는 기존 데이터를 삭제하지 마세요. 이전 버전으로 돌아가야 한다면 새 인스턴스를 먼저 종료한 다음 기존 환경을 복원하세요. 두 인스턴스가 동시에 시스템 프록시 설정을 변경하지 않도록 주의하세요.

연결 확인 및 포트 예시

‘데스크톱 버전은 연결되는데 WPF 버전은 연결되지 않는다’고 해서 반드시 프레임워크 차이인 것은 아닙니다. 두 버전에서 현재 선택한 노드, 코어 버전, 라우팅 모드, 수신 포트가 다를 수 있습니다. 비교 전 조건을 통일하고 다른 인스턴스를 종료한 뒤 같은 대상 주소로 테스트하세요. 아래 숫자는 테스트 흐름을 설명하기 위한 예시이며 모든 패키지의 기본값을 뜻하지 않습니다.

현재 클라이언트에서 로컬 프록시 포트로 10808을 설정했다고 가정하고, 먼저 루프백 주소에서 수신 중인지 확인하세요. Windows에서는 PowerShell에서 아래 명령을 사용할 수 있습니다. 이 명령은 로컬 포트에서 TCP 연결을 만들 수 있는지만 확인하며 노드, DNS, 원격 웹사이트의 정상 작동 여부는 검사하지 않습니다.

Test-NetConnection -ComputerName 127.0.0.1 -Port 10808

Linux에서는 아래 명령으로 해당 TCP 수신 대기 항목을 확인할 수 있습니다. 출력이 없다면 구독을 바로 수정하지 말고 코어 시작 로그와 실제 포트 설정을 먼저 확인하세요. macOS에서는 lsof -nP -iTCP:10808 -sTCP:LISTEN으로 수신 프로세스를 확인할 수 있습니다.

ss -ltnp 'sport = :10808'

• 수신 대기 항목이 없음: 코어 실행 실패, 설정 구문 오류, 포트 충돌을 확인하세요. 현재 UI에 표시된 실제 포트를 검사하고 있는지도 확인해야 합니다.
• 수신은 정상인데 브라우저에서 접속할 수 없음: 시스템 프록시가 올바른 주소와 포트를 가리키는지 확인하고, 브라우저에 별도 프록시 설정이 있는지도 살펴보세요.
• 일부 앱만 프록시를 사용하지 않음: 해당 앱이 시스템 프록시 설정을 따르지 않을 수 있습니다. 먼저 앱 설정을 확인한 뒤 Tun 사용 여부를 결정하세요.
• 일부 웹사이트만 문제가 발생함: DNS, 라우팅 규칙 적용 여부, 노드 아웃바운드 로그를 확인하세요. 특정 트래픽의 분기 문제를 Avalonia나 WPF 탓으로 돌리지 마세요.

일반 노드의 지연 시간 테스트만으로 앱 전체의 연결 상태를 판단할 수는 없습니다. 다운로드 속도를 비교할 때는 같은 노드, 같은 대상, 같은 시간대, 같은 라우팅 설정을 사용하세요. 조건을 통제하지 않으면 속도 차이를 UI 프레임워크 탓으로 돌릴 수 없습니다. 실제 테스트 조건이 없는 성능 순위는 제시하지 않습니다.

자주 묻는 선택 질문