Windows 사용자는 익숙한 조작 방식과 UI 호환성을 고려해 WPF 버전이나 Avalonia 데스크톱 버전을 선택하면 됩니다. macOS와 Linux 사용자는 각 OS용 데스크톱 설치 파일을 선택하세요. 두 버전의 차이는 우선 UI 기술에 있으며 프록시 프로토콜의 성능 차이가 아닙니다. 이 글에서는 실행 환경, 코어와의 관계, 설정 이전 및 확인 방법을 살펴보고 처음 다운로드하거나 버전을 바꾸려는 사용자의 불필요한 문제 해결을 줄입니다.
데스크톱 버전과 WPF 버전: UI, 클라이언트, 코어 구분하기
이 글에서 말하는 ‘데스크톱 버전’은 Avalonia UI를 사용하는 v2rayN 버전을 뜻합니다. WPF 버전도 데스크톱 앱이며, 다운로드 페이지에서 서로 다른 UI 분기를 구분하기 위해 두 이름을 사용합니다. Avalonia는 크로스 플랫폼 UI 프레임워크이고 WPF는 Windows용 UI 프레임워크입니다. 두 프레임워크는 창 렌더링, 컨트롤 동작, 데스크톱 통합에 영향을 주지만 원격 서버의 프록시 프로토콜 지원 여부를 직접 결정하지는 않습니다.
v2rayN은 서버 항목, 구독, 라우팅 규칙과 코어 프로세스를 관리하며 실제 프록시 연결은 선택한 코어가 처리합니다. VMess, VLESS 또는 특정 전송 설정을 사용할 수 있는지 확인하려면 다운로드 패키지에 Avalonia나 WPF라고 적혀 있는지만 보지 말고 코어 종류와 버전, 서버 측 매개변수를 확인해야 합니다. 또한 두 UI에서 모든 릴리스 버전의 기능과 메뉴가 완전히 동일하다고 보장할 수는 없습니다.
| 구분 | 주요 역할 | 버전 선택 시 확인할 항목 |
|---|---|---|
| Avalonia / WPF | 창, 목록, 설정 화면 및 조작 방식 | 운영체제, 화면 배율, 시스템 트레이 및 입력 환경 |
| v2rayN 클라이언트 | 설정 저장, 구독 관리, 실행 매개변수 생성 | 기능 메뉴, 설정 호환성, 권한 요구사항 |
| Xray / V2Fly 코어 | 인바운드, 아웃바운드, 라우팅 및 연결 처리 | 프로토콜 지원, 로그, 연결 매개변수 |
운영체제별 선택: Windows는 사용 습관, 다른 데스크톱 OS는 설치 파일 확인
Windows에서만 사용하고 기존 WPF 버전의 구독 업데이트, 시스템 프록시, 라우팅이 정상이라면 ‘크로스 플랫폼’이라는 이유만으로 이전할 필요는 없습니다. Windows, macOS, Linux를 자주 오간다면 Avalonia 데스크톱 버전에서 비슷한 조작 방식을 사용할 수 있지만 시스템 프록시 인터페이스, 권한 체계, 트레이 동작은 각 OS의 제약을 받습니다.
WPF 버전: 익숙한 Windows 작업 환경
추천Windows에서만 사용하며 WPF UI에 익숙한 사용자라면 기존에 안정적으로 사용하던 작업 환경을 유지하는 것을 기본으로 권합니다. UI 이름만 보고 성능을 짐작하기보다 화면 배율, 자주 쓰는 조작, 시스템 프록시 복원이 요구사항에 맞는지 확인하세요.
적합한 사용자: Windows만 사용하며 현재 조작 방식에 익숙한 사용자.
Avalonia 데스크톱 버전: 여러 OS에서 사용
여러 데스크톱 OS에서 비슷한 설정을 관리해야 한다면 해당 OS와 프로세서 아키텍처에 맞는 데스크톱 버전을 선택하세요. 크로스 플랫폼 UI는 여러 OS를 지원한다는 뜻이지, 하나의 설치 파일이 모든 OS에서 실행된다는 뜻은 아닙니다.
적합한 사용자: macOS, Linux 사용자 및 여러 데스크톱 OS를 자주 오가는 사용자.
Android는 Avalonia와 WPF 중에서 선택하는 대상이 아닙니다. 모바일 환경에서는 v2rayNG와 v2flyNG를 별도로 비교하세요. v2rayNG는 Xray 코어, v2flyNG는 V2Fly 코어를 중심으로 합니다. 구독을 재사용할 수 있는지는 포함된 프로토콜과 매개변수에 따라 달라집니다. 같은 V2Ray 생태계에 속한다고 해서 모든 설정을 바로 가져올 수 있는 것은 아닙니다.
결론: OS를 먼저 확인하고 실제 조작을 검증하세요
Windows 사용자는 기존 버전에서 구독 업데이트, 프록시 전환, 종료 후 복원을 각각 한 번씩 확인하세요. 세 가지가 모두 정상이라면 버전 변경을 미뤄도 됩니다. macOS와 Linux 사용자는 해당 OS용 Avalonia 데스크톱 패키지를 선택하고 WPF 패키지는 실행하지 마세요.
실행 환경과 UI 호환성: 설치 전 확인할 네 가지
두 UI 모두 .NET 기술 스택과 관련이 있지만 모든 설치 파일에 같은 런타임을 사용자가 따로 설치해야 하는 것은 아닙니다. 배포 패키지는 런타임을 포함할 수도 있고 시스템 런타임에 의존할 수도 있습니다. 필요한 항목은 선택한 패키지의 안내와 실행 오류 메시지를 확인하세요. 런타임이 없다면 요구되는 런타임 종류, 주 버전, 프로세서 아키텍처를 맞춰야 하며 임의로 더 높은 버전을 설치해서는 안 됩니다.
- 프로세서 아키텍처: x64와 ARM64는 서로 다른 패키지입니다. Windows에서는 ‘설정’ → ‘시스템’ → ‘정보’에서 시스템 종류를 확인할 수 있으며 macOS에서는 ‘이 Mac에 관하여’에서 칩 종류를 확인하세요.
- 런타임 종류: WPF는 Windows 데스크톱 기술입니다. 오류 메시지에 Windows Desktop Runtime이 필요하다고 명시되어 있으면 안내에 따라 설치하세요. SDK나 다른 종류의 런타임만 설치해서는 실행 조건을 충족하지 못할 수 있습니다.
- 글꼴과 화면 배율: 실제로 사용하는 화면 배율에서 서버 목록, 설정 대화상자, 긴 텍스트가 제대로 표시되는지 확인하세요. 내용이 잘리면 네트워크 문제로 단정하지 말고 창 크기, 시스템 배율, 글꼴 환경부터 살펴보세요.
- 데스크톱 통합: Linux는 데스크톱 환경, 트레이 확장 기능, 세션 종류에 따라 아이콘 표시가 달라질 수 있습니다. macOS의 보안 안내와 권한 설정도 별도로 처리해야 합니다. 문제를 해결하려고 시스템 보안 기능 전체를 끄지 마세요.
TUN 모드는 가상 네트워크 인터페이스, 라우팅, 권한과도 관련이 있어 창 안의 스위치 하나로 끝나지 않습니다. 시스템 프록시는 정상인데 TUN이 시작되지 않는다면 권한과 코어 로그를 따로 확인하세요. 두 UI를 비교하는 단계부터 TUN, 복잡한 DNS 설정, 여러 라우팅 규칙을 한꺼번에 적용하면 문제를 찾기 더 어려워집니다.
연결 속도 비교하기: 코어, 노드, 로컬 포트를 동일하게
프레임워크 이름만으로 ‘Avalonia 버전이 더 빠르다’거나 ‘WPF 버전의 지연 시간이 더 낮다’고 결론 내릴 수 없습니다. 노드 회선, 코어, 라우팅 규칙, DNS 처리, 테스트 대상이 연결 성능에 중요한 영향을 줍니다. UI를 비교할 때는 시작 속도, 목록 스크롤, 창 반응을 살펴보세요. 네트워크를 비교하려면 먼저 양쪽의 조건을 동일하게 맞춰야 합니다.
위 포트는 확인 방법을 설명하기 위한 예시일 뿐, 모든 버전에서 두 포트가 기본으로 각각 열려 있다는 뜻은 아닙니다. 일부 설정은 혼합 인바운드를 사용해 하나의 포트에서 여러 프록시 프로토콜을 처리하며, HTTP 인바운드가 별도로 없는 설정도 있습니다. 브라우저나 명령줄에 주소를 입력하기 전에 현재 클라이언트 설정과 코어 시작 로그를 확인하세요.
- 기존 버전과 해당 코어를 종료하고 프로세스가 완전히 멈췄는지 확인하세요. 두 클라이언트가 같은 수신 주소와 포트를 두고 충돌하는 일을 방지할 수 있습니다.
- 새 버전에는 동일한 서버 항목 하나만 가져오고 같은 코어 버전을 선택하세요. 우선 라우팅을 단순하게 유지하고 TUN과 DNS 설정을 동시에 바꾸지 마세요.
- 동일한 테스트 주소를 사용해 연결 성공 여부와 로그 오류를 기록하세요. 한 번 측정한 지연 시간의 차이만으로 UI 프레임워크가 회선 품질에 영향을 준다고 단정할 수 없습니다.
- 기본 연결이 확인된 뒤 기존 라우팅 규칙과 트래픽 처리 방식을 하나씩 복원하세요. 항목을 바꿀 때마다 다시 확인하면 차이가 발생한 지점을 찾기 쉽습니다.
코어가 포트 수신에 성공했다는 것은 로컬 진입점이 시작됐다는 뜻일 뿐이며, 시스템 프록시를 켜도 모든 프로그램이 이를 사용하는 것은 아닙니다. 자체 프록시 설정을 사용하는 프로그램도 있으므로 별도로 확인해야 합니다. 시스템 프록시가 적용되지 않을 때 UI 버전부터 바꾸기보다 설정을 먼저 점검하세요.
WPF에서 데스크톱 버전으로 이전하기: 구독, 노드, 규칙을 따로 보관
이전하기 전 되돌릴 수 있는 백업을 남기세요. 릴리스 버전에 따라 설정 구조가 달라질 수 있으므로 데이터 디렉터리 전체를 버전 간 또는 OS 간에 그대로 덮어써도 된다고 보장할 수 없습니다. 구독 주소와 서버 공유 링크는 다시 가져오기 쉽지만 모든 로컬 설정을 담고 있지는 않습니다. 사용자 지정 라우팅, DNS, 코어 선택, 단축키는 별도로 기록하세요.
- 먼저 백업: 기존 클라이언트를 종료한 뒤 실제로 사용 중인 데이터 디렉터리를 저장하고 현재 버전, 코어, 프록시 적용 방식을 기록하세요. 데이터가 프로그램 설치 디렉터리에 모두 들어 있는 것은 아니므로 현재 버전의 디렉터리 안내를 확인해야 합니다.
- 분리 설치: 새 버전은 별도 디렉터리에 설치하거나 안내된 설치 절차를 따르세요. 처음 실행할 때 기존 데이터를 덮어쓰지 마세요. 구독 주소에 접근 토큰이 포함될 수 있으므로 공개 스크린샷이나 문의 내용에 노출하지 마세요.
- 나눠서 가져오기: 먼저 서버 항목 하나를 복원해 테스트한 뒤 구독을 추가하세요. 구독 업데이트 결과가 올바른지 확인하고 나서 로컬 그룹과 사용자 지정 라우팅을 복원하세요.
- OS별 설정 재구성: OS를 바꿔 이전할 때는 코어 파일과 경로를 다시 지정하세요. Windows 경로는 Linux나 macOS에서 그대로 사용할 수 없습니다. 단축키, 시작 시 자동 실행, 시스템 프록시도 다시 확인해야 합니다.
- 종료 후 복원 확인: 시스템 프록시를 켜고 연결을 확인한 뒤 정상적으로 종료하고 시스템 프록시가 예상한 상태로 복원됐는지 살펴보세요. 자주 사용하는 앱과 라우팅 규칙을 모두 확인할 때까지 기존 버전의 백업을 보관하세요.
클라이언트가 쓰는 중인 설정 파일을 수동으로 복사하면 내용이 불완전할 수 있습니다. 두 버전이 같은 데이터 디렉터리를 공유하게 하면 서로의 설정을 덮어쓸 위험도 커집니다. 새 버전에서 기존 설정을 인식하지 못하면 지원되는 가져오기 방법으로 다시 구성하세요. 필드 이름이 비슷하다고 내부 데이터 구조를 임의로 편집하지 마세요.
버전 선택 FAQ: UI가 비슷해도 실행 환경은 다릅니다
Windows에서 처음 다운로드한다면 어떤 버전을 먼저 선택해야 하나요?
다운로드 페이지에서 OS, 아키텍처, 버전 안내를 기준으로 먼저 선택하세요. 여러 OS에서 사용할 필요가 없다면 WPF 버전으로 가져오기, 시스템 프록시, 종료 후 복원의 세 가지를 확인해 볼 수 있습니다. 화면 배율이나 조작 방식이 맞지 않으면 별도 디렉터리에 Avalonia 데스크톱 버전을 설치해 보세요. 두 버전을 동시에 실행할 필요는 없습니다.
데스크톱 버전으로 바꾸면 기존 노드를 사용할 수 없나요?
UI를 바꾼다고 원격 계정이 비활성화되는 것은 아닙니다. 서버 주소, 포트, 사용자 ID, 전송 방식, TLS 매개변수를 확인한 뒤 선택한 코어를 점검하세요. 같은 항목이 한쪽에서만 실패한다면 실제 설정과 로그를 비교하고 모든 구독을 바로 초기화하지 마세요.
두 버전을 동시에 열어 UI를 비교해도 되나요?
UI만 살펴보더라도 자동으로 시작되는 코어에 주의해야 합니다. 두 프로세스가 모두 127.0.0.1:10808에 바인딩되면 주소가 충돌할 수 있으며, 둘 다 시스템 프록시를 수정하면 설정이 서로 덮어써질 수 있습니다. 한쪽을 종료한 다음 다른 쪽을 실행하는 편이 안전합니다.
데스크톱 버전은 실행되는데 트레이 아이콘이 보이지 않으면 어떻게 하나요?
먼저 프로세스가 계속 실행 중인지 확인한 뒤 시스템 알림 영역이나 데스크톱 환경의 트레이 지원 여부를 살펴보세요. 주 창을 열어 둔 상태에서 창 닫기와 프로그램 종료가 서로 다른 동작인지 테스트하세요. 여러 인스턴스를 연달아 실행하지 말고 트레이 아이콘이 없는 문제를 구독 오류로 오해하지 마세요.
두 버전의 설정 이름이 다르면 기존 튜토리얼을 따라 해도 되나요?
이름이 같은 버튼을 기계적으로 찾기보다 설정 목적에 맞는 메뉴를 찾으세요. 예를 들어 변경하려는 항목이 로컬 수신 포트, 시스템 프록시, 라우팅 규칙 중 무엇인지 먼저 확인한 다음 현재 버전의 설정에서 해당 메뉴를 찾으면 됩니다. 문제 해결을 요청할 때는 클라이언트 버전과 코어 버전을 함께 기록하세요. ‘데스크톱 버전’이라는 정보만으로는 부족합니다.
선택 기준은 간단합니다. OS에 따라 사용할 수 있는 분기가 정해지고, 작업 방식에 따라 선호하는 UI가 달라지며, 연결 기능은 코어와 설정에 달려 있습니다. 사용 중인 설정을 먼저 유지하고 별도 환경에서 다른 버전을 검증하면 기존 설치를 덮어쓰는 것보다 실제 차이를 쉽게 파악할 수 있습니다. 플랫폼별 클라이언트 선택은 클라이언트 비교를, 라우팅과 DNS 개념은 설정 가이드를 참고하세요.