Desktop은 Avalonia로 만든 크로스 플랫폼 인터페이스이며, WPF는 Windows용 데스크톱 인터페이스입니다. macOS와 Linux 사용자는 해당 플랫폼용 Desktop 패키지를 선택하세요. Windows 사용자는 기존 설정과 사용 습관, 필요한 기능을 고려해 결정하면 됩니다. 이 글에서는 앱 구조를 구분하는 법, 인터페이스와 코어의 역할, 설정 이전 및 전환 후 확인 절차를 살펴봅니다. 인터페이스 프레임워크 차이를 프로토콜 지원이나 네트워크 속도 차이로 오해하지 않도록 주의하세요.
Desktop과 WPF의 역할 구분
Avalonia와 WPF는 모두 인터페이스 프레임워크이며, 프록시 프로토콜이나 네트워크 연결을 처리하는 코어가 아닙니다. 서버 목록, 구독 그룹, 설정 창은 v2rayN 클라이언트 인터페이스에 속합니다. 연결 여부는 실제로 실행되는 코어, 서버 매개변수, 라우팅 규칙, 네트워크 환경에도 영향을 받습니다. 인터페이스가 정상적으로 열려도 코어가 성공적으로 실행됐다는 뜻은 아닙니다.
| 비교 항목 | Desktop（Avalonia） | WPF |
|---|---|---|
| 지원 플랫폼 | Windows, macOS, Linux용으로 각 운영체제에 맞는 패키지 필요 | Windows용이며 다른 운영체제에서는 네이티브 앱으로 실행할 수 없음 |
| 인터페이스 구현 | 크로스 플랫폼 컨트롤과 레이아웃을 사용하며, 시스템 연동은 플랫폼별로 조정 | Windows 데스크톱 컨트롤과 상호작용 방식 사용 |
| 프로토콜 지원 | 사용하는 코어와 해당 코어의 설정 지원 여부에 따라 달라짐 | 마찬가지로 사용하는 코어와 해당 코어의 설정 지원 여부에 따라 달라짐 |
| 사용 시 확인 사항 | 트레이, 단축키, 창 크기 조정, 권한 동작 확인 필요 | 기존 Windows 사용 방식에 익숙한 사용자에게 적합 |
| 설정 이전 | 대상 배포 패키지의 설정 형식과 기능 메뉴 확인 | 버전이 다르면 설정을 그대로 덮어써도 된다고 가정할 수 없음 |
같은 Xray 코어를 사용하더라도 창 모양만 보고 VLESS, VMess 또는 REALITY 지원 여부를 판단할 수는 없습니다. 실제 코어 버전과 서버에서 요구하는 항목을 확인하세요. '크로스 플랫폼'이라는 이유로 더 빠르다고 볼 수도 없고, 'Windows 전용'이라는 이유로 지연 시간이 더 낮다고 단정할 수도 없습니다. 속도를 비교하려면 서버, 코어, 라우팅, 테스트 조건을 동일하게 맞춰야 합니다.
결론: 운영체제를 먼저 확인하고 기능을 검증하세요
다운로드 전 사용할 수 없는 플랫폼용 패키지를 제외하세요. 다운로드 후에는 같은 서버를 사용해 구독 업데이트, 프록시 연결, 코어 로그를 확인하세요. 서버 핸드셰이크 오류를 해결하려고 인터페이스 프레임워크부터 바꾸지는 마세요.
Windows 사용자를 위한 선택 기준
Windows에서는 두 인터페이스 모두 선택할 수 있습니다. 처음 설치한다면 Desktop을 먼저 사용해 볼 수 있습니다. WPF로 이미 안정적인 작업 환경을 갖췄다면 인터페이스 이름만을 이유로 옮길 필요는 없습니다. 아래 추천은 처음 설치하는 경우를 위한 것이며, 모든 기기에서 특정 인터페이스가 더 빠르거나 기능이 더 많다는 뜻은 아닙니다.
Desktop（Avalonia）
추천처음 설치할 때 시작점으로 적합합니다. 특히 macOS나 Linux에서도 v2rayN을 사용할 예정이라면 고려해 볼 만합니다. 사용 개념은 플랫폼 간에 대응하기 쉽지만, 트레이와 시스템 프록시는 각 플랫폼에서 따로 확인해야 합니다.
적합한 사용자: Windows에 처음 설치하거나 여러 데스크톱 운영체제에서 사용하려는 경우
WPF
현재 설정이 정상적으로 작동한다면 그대로 사용해도 됩니다. 특정 단축키, 목록 조작 방식, 창 배치에 의존한다면 필요한 사항을 먼저 정리하고 Desktop 해당 배포판에서 지원하는지 확인하세요. 대체 메뉴를 찾기 위해 먼저 옮길 필요는 없습니다.
적합한 사용자: 안정적인 기존 설정이 있고 Windows의 기존 조작 방식에 익숙한 경우
시스템 아키텍처와 실행 환경
- Windows에서 '설정' → '시스템' → '정보'를 열고 '시스템 종류'를 확인하세요. x64와 ARM64는 해당 아키텍처용 패키지를 선택해야 합니다. '64비트'를 곧바로 x64와 같은 뜻으로 보면 안 됩니다.
- 클라이언트 다운로드 페이지에서 Windows 패키지의 인터페이스 유형, 아키텍처, 실행 환경 요구 사항을 확인하세요. 런타임을 별도로 설치해야 하는지는 해당 배포 패키지의 안내를 따르세요.
- 실행한 뒤 기본 창, 트레이 아이콘, 종료 동작을 먼저 확인하세요. 창이 실행되지 않으면 런타임과 아키텍처부터 점검하고, 창은 열리지만 프록시를 사용할 수 없다면 코어 로그를 확인하세요.
인터페이스 프로그램과 코어 프로그램은 별도의 프로세스입니다. 잘못된 패키지는 창이 뜨기도 전에 실행에 실패할 수 있습니다. 반면 코어 파일 누락, 포트 충돌, 설정 항목 호환성 문제는 서버를 선택한 뒤에 드러날 수 있습니다. 이 두 단계를 나눠 기록하면 반복해서 덮어 설치하는 것보다 원인을 쉽게 찾을 수 있습니다.
macOS 및 Linux 패키지 선택
이 두 플랫폼에서는 운영체제에 맞는 Desktop 패키지를 선택해야 합니다. Windows용 WPF 패키지를 복사해 실행한 뒤 구독이 만료된 탓이라고 오해하지 마세요. 운영체제, CPU 아키텍처, 패키징 방식은 서로 별개의 조건이므로 각각 확인해야 합니다.
플랫폼별 선택: 아키텍처를 확인한 뒤 시스템 연동을 점검하세요
macOS
- Apple 메뉴에서 '이 Mac에 관하여'를 열고 '칩' 또는 '프로세서'를 확인하세요.
- Apple Silicon 기기에는 ARM64 패키지를, Intel 기기에는 x64 패키지를 선택하세요.
- 실행 후 트레이 메뉴, 시스템 프록시, 종료 후 프록시 설정 복구 여부를 확인하세요.
- TUN을 사용하는 경우 현재 배포판의 권한 안내를 따르세요. TUN은 일반적인 시스템 프록시 설정과 다릅니다.
Linux
- 터미널에서
uname -m을 실행해 시스템 아키텍처를 확인하세요. x86_64는 x64에 해당하고,aarch64는 일반적으로 ARM64에 해당합니다.- 배포판에 맞는 deb, rpm 또는 제공되는 다른 패키지 형식을 선택하세요.
- 데스크톱 환경의 트레이 지원, 프록시 설정, TUN에 필요한 권한을 확인하세요.
Desktop이라는 이름이 같아도 플랫폼별 시스템 연동이 완전히 동일한 것은 아닙니다. 먼저 자주 사용하는 앱에서 프록시가 작동하는지 확인한 뒤 필요하면 TUN을 설정하세요.
Linux의 데스크톱 시스템 프록시는 대개 데스크톱 환경과 앱의 지원 여부에 따라 달라집니다. 브라우저는 이 설정을 읽어 사용할 수 있지만, 터미널 프로그램은 프록시 매개변수를 별도로 지정해야 할 수 있습니다. TUN은 가상 네트워크 인터페이스와 라우팅 제어를 사용하므로 권한과 구현 방식이 다릅니다. 터미널 트래픽이 라우팅되지 않는다고 해서 Desktop의 서버 연결 기능이 빠진 것은 아닙니다.
작업별 기능 확인
인터페이스 이름만으로 기능 목록을 대신할 수는 없습니다. 구독 가져오기, 그룹 관리, 라우팅 설정, 코어 선택, 시스템 프록시, TUN을 각각 확인하세요. 배포판에 따라 메뉴 배치와 기능 제공 시점이 다를 수 있습니다. 아래 메뉴 이름은 기능을 찾기 위한 참고이며, 실제 위치는 설치한 버전에 따라 달라질 수 있습니다.
| 작업 | 메뉴 위치 또는 항목 | 확인 기준 |
|---|---|---|
| 구독 업데이트 | '구독 그룹' → '구독 그룹 설정'에서 구독 업데이트 실행 | 기존 구독 소스가 업데이트되고 그룹과 필터 결과가 예상대로 표시됨 |
| 로컬 리스닝 | '설정' → '매개변수 설정'에서 로컬 리스닝 주소와 포트 확인 | 코어 로그에 주소 사용 중 오류가 없고 앱이 실제 리스닝 포트에 연결됨 |
| 시스템 프록시 | 메인 창 또는 트레이의 '시스템 프록시' 메뉴 | 시스템 프록시가 클라이언트의 실제 포트를 가리키고, 해제 후 예상한 상태로 복구됨 |
| 라우팅 규칙 | '설정' → '라우팅 설정'에서 규칙 순서와 아웃바운드 태그 확인 | 직접 연결할 대상과 프록시를 사용할 대상이 예상대로 매칭됨 |
| 코어 호환성 | 코어 선택 항목과 시작 로그 | 필요한 프로토콜, 전송 방식, 보안 매개변수를 실제 코어에서 수락함 |
| TUN 트래픽 처리 | TUN 스위치, 권한 안내, 관련 로그 | 활성화 후 라우팅이 올바르게 작동하고 비활성화 후 네트워크가 복구됨 |
예를 들어 기존 설정에서 앱이 127.0.0.1:10808에 연결했다면, 이전 후 새 인스턴스가 여전히 해당 포트에서 리스닝하는지, 그 포트가 어떤 프로토콜을 제공하는지 확인하세요. 여기의 10808은 확인 예시일 뿐 모든 배포판의 기본값은 아닙니다. HTTP 프록시를 SOCKS만 제공하는 리스닝 포트에 임의로 연결하면 안 됩니다. 혼합 리스닝 지원 여부는 실제 설정을 확인하세요.
- 인터페이스 문제: 버튼 위치, 목록 열 너비, 단축키, 화면 배율이 예상과 다르면 인터페이스 버전, 운영체제, 디스플레이 배율을 먼저 기록하세요.
- 코어 문제: 로그에 인식할 수 없는 항목이나 프로토콜이 표시되면 선택한 코어와 설정을 확인하세요. 창 배치만 초기화해서는 해결되지 않습니다.
- 트래픽 처리 문제: 코어는 실행 중인데 앱이 프록시를 사용하지 않는다면 구독을 삭제하기 전에 시스템 프록시, 앱 자체의 프록시 매개변수, TUN 설정을 확인하세요.
설정 이전 및 롤백 절차
설정 이전의 목적은 구독과 규칙을 재사용하는 것이지 기존 폴더 전체를 새 패키지에 덮어쓰는 것이 아닙니다. 버전에 따라 데이터베이스나 설정 구조가 바뀔 수 있습니다. 대상 프로그램에서 설정을 읽었다고 해서 이전 프로그램도 변경된 파일을 읽을 수 있는 것은 아닙니다. 설정 폴더를 함께 사용하는 것보다 별도 백업을 보관하는 편이 안전합니다.
- 현재 상태 기록. 클라이언트 버전, 코어 종류, 로컬 리스닝 포트, 라우팅 모드, 구독 그룹을 적어 두세요. 구독 주소는 민감한 정보이므로 공개 스크린샷에 포함하지 마세요.
- 기존 인스턴스 종료 및 백업. 먼저 시스템 프록시를 해제하고 TUN을 끈 뒤 클라이언트를 종료하세요. 현재 버전에서 제공하는 백업 또는 내보내기 기능을 사용하세요. 설정 폴더를 복사해야 한다면 프로그램을 종료한 후 진행하세요.
- 대상 인터페이스 별도 설치. 프로그램 폴더를 분리하고 배포판에서 지원하는 방식으로 설정도 분리하세요. 프로그램을 다른 폴더에 설치했다고 데이터까지 분리된다고 단정하면 안 됩니다.
- 단계별 복원. 먼저 구독을 가져와 정상 작동이 확인된 서버 하나로 테스트한 다음 사용자 지정 라우팅, DNS, 기타 설정을 옮기세요. 모든 변경 사항을 한 번에 가져오면 장애 원인을 찾기 어렵습니다.
- 포트와 트래픽 처리 확인. 기존 코어가 종료됐는지, 새 인스턴스와 포트 충돌이 없는지 확인하세요. 먼저 프록시를 직접 지정해 테스트하고, 그다음 시스템 프록시를 활성화한 뒤 마지막으로 TUN을 테스트하세요.
- 롤백 경로 확보. 필수 기능이 충족되지 않으면 새 인스턴스를 종료하고 별도 백업을 복원하세요. 새 버전이 수정한 설정을 호환성이 확인되지 않은 상태로 이전 프로그램에서 열지 마세요.
일반 사용자가 사용성을 확인할 때는 먼저 인터페이스만 바꾸세요. 서버, 코어, DNS, 라우팅을 함께 변경하면 결과만으로 어떤 변경이 영향을 줬는지 알 수 없습니다. 로그에 구독 주소, 사용자 식별자, 서버 인증 정보가 있으면 공유하기 전에 삭제하세요.
버전 선택 관련 자주 묻는 질문
Windows에서 WPF가 이미 잘 작동하는데 Desktop으로 바꿔야 하나요?
이름만을 이유로 바꿀 필요는 없습니다. 여러 데스크톱 운영체제에서 사용하려는지, 화면 배율이나 특정 기능 메뉴가 필요한지 등 실제 요구 사항을 정리한 뒤 별도 설정으로 Desktop을 테스트하세요. 기존 구독 업데이트, 라우팅, 시스템 프록시가 모두 안정적이라면 현재 방식을 계속 사용해도 됩니다.
Desktop은 열리는데 서버에 연결되지 않는 이유는 무엇인가요?
먼저 코어 시작 로그에서 포트 충돌, 파일 누락, 설정 구문 오류가 있는지 확인하세요. 그런 다음 서버 주소, 포트, 전송 방식, 보안 매개변수를 점검하세요. 창이 열린 것은 인터페이스 프로세스가 시작됐다는 뜻일 뿐, 코어 연결이 성립됐다는 뜻은 아닙니다.
Avalonia로 바꾸면 VLESS나 VMess가 더 빨라지나요?
인터페이스 프레임워크만으로 속도가 빨라진다는 일반적인 결론은 없습니다. 같은 서버, 같은 코어, 같은 라우팅 조건에서 테스트하고 백그라운드 구독 업데이트나 다른 프록시 프로세스의 간섭이 없는지 확인하세요. 조건이 다르면 결과를 Avalonia의 영향으로 볼 수 없습니다.
macOS 또는 Linux에서 Windows와 같은 메뉴를 찾을 수 없으면 어떻게 하나요?
먼저 해당 플랫폼용 Desktop 패키지를 다운로드했는지 확인한 다음 메인 창, 설정 창, 트레이 메뉴에서 '구독, 라우팅, 시스템 프록시, TUN' 기능을 찾아보세요. 현재 배포판에 해당 메뉴가 없다면 안내 문서를 확인하고, 다른 운영체제의 설정 경로를 그대로 적용하지 마세요.
기존 설정을 가져올 때 오류가 나면 폴더 전체를 덮어써도 되나요?
먼저 덮어쓰기를 중단하고 백업을 보관하세요. 구독만 가져와 기본 연결이 되는지 확인한 뒤 규칙을 하나씩 복원해 보세요. 전체 설정을 옮겨야 한다면 원본과 대상 버전이 지원하는 형식을 먼저 확인하세요. 롤백할 때는 이전에 만든 별도 백업을 사용하세요.