먼저 운영체제에 맞는 버전을 고른 뒤 사용 습관을 고려하세요. Avalonia 데스크톱 버전은 Windows, macOS, Linux를 지원하고 WPF 버전은 Windows용입니다. 두 버전은 UI 프레임워크가 다를 뿐 프록시 코어가 다른 것은 아니며, UI를 바꾼다고 노드 속도가 자동으로 빨라지지도 않습니다. 운영체제별 차이와 기능, 전환 전 확인 사항을 정리했습니다. 설치 파일을 고르거나 기존 UI에서 전환하려는 사용자, 여러 데스크톱 OS에서 v2rayN을 사용하려는 사용자에게 유용합니다.
UI 프레임워크와 프록시 코어 구분하기
Avalonia와 WPF는 창, 메뉴, 노드 목록 등 데스크톱 UI를 구성하는 기술입니다. WPF는 Windows용 데스크톱 UI 기술이고 Avalonia는 여러 플랫폼을 지원합니다. VMess, VLESS 같은 프록시 프로토콜이나 V2Ray, Xray 같은 프록시 코어와는 다릅니다. 설치 항목에 Avalonia라고 표시되어 있어도 구독 형식을 바꿀 필요는 없습니다.
v2rayN은 서버 설정, 구독, 실행 옵션을 관리하고 적절한 코어를 호출해 연결을 처리합니다. 특정 프로토콜과 전송 옵션을 사용할 수 있는지는 현재 v2rayN 버전의 설정 지원 여부와 선택한 코어의 기능을 함께 확인해야 합니다. UI 모양만 보고 프로토콜 호환성을 판단하거나 두 UI 버전을 서로 다른 네트워크 회선처럼 생각하지 마세요.
Windows·macOS·Linux별 선택 기준
먼저 운영체제와 프로세서 아키텍처를 확인하세요. Windows에서는 「설정」→「시스템」→「정보」에서 ‘시스템 종류’를 확인해 x64와 ARM64를 구분합니다. macOS에서는 ‘이 Mac에 관하여’에서 칩 정보를 확인하고, Linux에서는 uname -m 명령으로 아키텍처를 확인할 수 있습니다. 프레임워크를 제대로 골라도 아키텍처가 맞지 않으면 설치나 실행에 실패할 수 있습니다.
Avalonia 데스크톱 버전
권장여러 플랫폼에서 사용할 때 우선 고려할 선택지입니다. Windows, macOS, Linux를 오가며 비슷한 방식으로 노드를 관리할 수 있습니다. 단, OS와 아키텍처에 맞는 배포 파일을 각각 선택해야 합니다.
추천 대상: 처음 버전을 고르는 사용자, 여러 OS에서 작업하는 사용자, 일관된 데스크톱 UI를 원하는 사용자
WPF 버전
Windows에서 기존 UI를 계속 사용하려는 경우에 적합합니다. 익숙한 작업 방식이 안정적으로 자리 잡았다면 우선 그대로 사용하고 전환 필요성을 검토하세요. Windows용 프로그램을 다른 데스크톱 OS에서 직접 실행할 수는 없습니다.
추천 대상: 주로 Windows를 사용하거나 기존 UI에 익숙하고, 현재 설정을 이어가려는 사용자
Windows 11을 사용한다고 해서 WPF를 제외할 필요는 없습니다. 반대로 WPF라고 해서 모든 구형 시스템에 더 잘 맞는 것도 아닙니다. 대상 OS의 지원 여부는 배포 파일, 런타임, 코어 요구 사항에 따라 달라집니다. 다운로드 전에 배포 안내를 확인하고 프레임워크 이름만으로 최소 OS 버전을 추측하지 마세요.
macOS와 Linux에서는 해당 플랫폼용 Avalonia 패키지를 선택하세요. Linux는 배포판에서 지원하는 패키지 형식과 데스크톱 의존성도 확인해야 합니다. 창이 열린다고 해서 시스템 프록시, 트레이, TUN 권한까지 설정된 것은 아닙니다.
UI·기능·네트워크 성능 비교
두 UI는 목록 표시 밀도, 설정 창 배치, 단축키, 트레이 조작 방식이 다를 수 있습니다. 고해상도 화면에서 글자가 선명한지, 화면 배율을 조정해도 버튼이 잘리지 않는지는 시스템 배율과 사용 중인 버전에서 확인하세요. 한 번의 화면 표시 오류를 프레임워크 전체의 문제로 단정하거나, 두 UI의 버튼 위치가 모두 같다고 가정하지 마세요.
| 확인 항목 | Avalonia 데스크톱 버전 | WPF 버전 |
|---|---|---|
| 플랫폼별 설치 파일 | Windows·macOS·Linux에 맞는 패키지 선택 | Windows와 아키텍처에 맞는 패키지 선택 |
| 구독 관리 | 구독 그룹, 업데이트 메뉴, 가져오기 결과 확인 | 기존 그룹과 현재 업데이트 설정 확인 |
| 프로토콜 설정 | 클라이언트의 설정 지원과 코어 기능에 따라 결정 | 클라이언트와 코어 버전을 함께 확인 |
| 시스템 연동 | 각 OS에서 프록시, 트레이, 권한을 각각 확인 | Windows 시스템 프록시와 트레이 동작 확인 |
| 성능 비교 | UI의 리소스 사용량과 코어의 트래픽 처리를 구분 | 같은 노드와 테스트 조건으로 비교 |
구독 가져오기, 서버 선택, 시스템 프록시, 라우팅 분기는 버전을 고를 때 각각 확인해야 할 작업 흐름입니다. 두 버전의 기능이 항상 완전히 같다고 보면 안 됩니다. 새 옵션의 메뉴 위치, 설정 항목, 구현 여부가 다를 수 있습니다. 특정 설정을 찾지 못했다면 먼저 현재 버전의 설정 화면과 안내를 확인한 뒤 버전 변경을 검토하세요.
- UI 리소스 사용량 비교: 다른 인스턴스를 종료하고 노드 수를 같게 맞춘 뒤 Windows 작업 관리자에서 UI 프로세스와 코어 프로세스를 각각 확인하세요. 두 프로세스의 사용량을 하나의 지표로 합산하지 마세요.
- 네트워크 체감 비교: 노드, 코어, 라우팅 규칙, DNS, 테스트 대상을 동일하게 맞추세요. 노드 부하나 회선이 달라지면 UI 차이를 정확히 비교하기 어렵습니다.
- TUN 확인: 필요한 권한과 코어, 라우팅 동작을 별도로 점검하세요. TUN은 단순한 UI 스위치가 아니며, 스위치가 켜져 있다고 모든 트래픽이 의도한 대로 처리되는 것은 아닙니다.
설정 전환: 백업 후 항목별로 확인
전환할 때 중요한 것은 새 프로그램을 기존 폴더에 덮어쓰는 것이 아니라, 기존에 작동하던 설정을 새 버전에서 다시 구성하는 것입니다. 먼저 기존 인스턴스를 완전히 종료하고 현재 버전의 백업 또는 내보내기 기능으로 설정을 저장하세요. 포터블 폴더를 사용한다면 종료 후 별도 위치에 복사해 두세요. 설정에는 구독 주소, 서버 인증 정보, 사용 기록이 포함될 수 있으므로 안전한 위치에 보관해야 합니다.
전환 절차: 분리해서 테스트하고 되돌릴 방법 마련하기
새 버전 테스트
- 프로그램 폴더를 별도로 사용하고 기존 버전과 활성 설정을 공유하지 않는지 확인합니다.
- 정상 작동이 확인된 노드 하나를 먼저 가져온 뒤 구독 그룹을 추가합니다.
- 수신 포트, 코어 선택, 라우팅, DNS를 확인합니다.
- 일반 시스템 프록시부터 확인한 다음 필요하면 TUN을 테스트합니다.
기존 버전으로 되돌리기
- 종료 후 저장한 설정 백업과 기존 프로그램 폴더를 보관합니다.
- 테스트하는 동안 기존 버전의 시작 프로그램 등록을 비활성화합니다.
- 두 클라이언트가 동시에 시스템 프록시 설정을 변경하지 않도록 합니다.
- 되돌리기 전에 새 인스턴스를 종료하고 기존 프록시 설정을 복원합니다.
프로그램 폴더가 분리되어 있어도 데이터 폴더까지 별개라는 보장은 없습니다. 두 버전이 사용자 설정 경로를 공유한다면 순서대로 테스트하고 전환 전에 백업을 남기세요.
- 기존 설정 기록.「설정」→「매개변수 설정」에서 로컬 수신 포트를 확인하고 현재 서버, 라우팅 선택, 시스템 프록시 상태를 기록합니다. 메뉴 이름이 다르면 해당 기능을 찾아 확인하세요.
- 구독 다시 설정.「구독 그룹」→「구독 그룹 설정」으로 이동해 기존 구독 주소를 추가하고 저장한 뒤 업데이트를 실행합니다. 구독은 서버 정보를 제공할 뿐, 로컬 DNS·단축키·라우팅 설정을 모두 자동으로 옮기지는 않습니다.
- 포트 충돌 확인. 기존 인스턴스가
10808을 사용한다면 먼저 종료한 뒤 새 인스턴스를 테스트하세요. 두 인스턴스를 동시에 진단해야 한다면 새 인스턴스에 사용 중이지 않은 포트(예:10818)를 지정하고, 직접 입력한 앱 프록시 주소도 함께 변경합니다. - 실제 사용 흐름 확인. 사용할 서버를 선택한 뒤 「시스템 프록시」 메뉴에서 원하는 상태를 설정합니다. 브라우저, 개발 도구, 기타 앱을 하나씩 테스트하고 노드 지연 시간 결과만 확인하고 끝내지 마세요.
- 마지막으로 상시 실행 설정. 연결, 절전 모드 해제 후 복구, 재부팅 테스트를 마친 뒤 새 인스턴스의 시작 프로그램 등록을 활성화하세요. 그래야 다음 로그인 때 기존 인스턴스가 다시 프록시를 설정하는 일을 막을 수 있습니다.
두 UI 버전의 내부 데이터베이스나 설정 파일을 서로 그대로 사용할 수 있다고 가정하지 마세요. 전체 전환에는 현재 버전에서 공식 지원하는 가져오기 또는 복원 방식만 사용하세요. 버전 간 복원에 실패하면 구독과 노드를 이용해 최소한의 작동 설정을 만든 뒤 로컬 규칙을 하나씩 복원합니다.
버전 변경 후 인터넷에 연결되지 않을 때
버전을 바꾼 뒤 ‘노드는 보이지만 웹페이지가 열리지 않는’ 경우 프레임워크를 바꾸기보다 프록시 설정을 먼저 확인하세요. 클라이언트가 코어를 실행했는지 확인한 다음 시스템 프록시와 앱에 직접 입력한 프록시 주소를 점검합니다. 시스템 프록시는 해당 설정을 읽는 앱에서만 작동하므로 모든 프로그램의 트래픽이 프록시를 거친다고 단정할 수 없습니다.
Windows에서는 아래 명령으로 예시 포트를 사용하는 프로세스를 찾을 수 있습니다. 결과가 없으면 클라이언트에서 실제 포트와 시작 로그를 확인하세요. 결과가 나오면 PID가 예상한 인스턴스에 해당하는지 확인합니다. 프로세스의 용도를 파악한 뒤에만 해당 프로그램을 종료하세요.
netstat -ano | findstr LISTENING | findstr :10808
tasklist /FI "PID eq 4321"- 브라우저는 되지만 다른 앱은 안 되는 경우: 해당 앱이 시스템 프록시 설정을 읽는지 확인하세요. 수동 프록시를 지원하는 앱에는 실제 주소와 포트를 입력하고, 그 밖의 트래픽을 처리해야 한다면 TUN 사용을 검토하세요.
- 도메인 접속은 실패하지만 직접 연결은 다르게 동작하는 경우: 새 인스턴스의 DNS와 라우팅 설정을 확인하고, 직접 연결과 프록시 연결에서 DNS가 처리되는 경로가 다른 점을 고려하세요. 보안 검사를 꺼서 오류를 숨기지 마세요.
- 창을 닫은 뒤 인터넷이 끊기는 경우: 창을 닫을 때 클라이언트까지 종료되도록 설정되어 있는지 확인한 다음, 시스템 프록시가 중지된 로컬 포트를 계속 가리키는지 살펴보세요.
모드별 차이를 더 확인하려면 시스템 프록시 모드 안내를 참고하세요. 전체 트래픽을 처리해야 한다면 TUN 설정에서 권한과 라우팅을 확인하세요. 원인을 찾기 어려워지지 않도록 두 항목은 따로 점검하세요.
버전 선택 FAQ
Windows 11에서 처음 사용한다면 어떤 UI 버전을 선택해야 하나요?
먼저 Avalonia 데스크톱 버전을 선택하고 시스템 아키텍처에 맞는 패키지를 받은 뒤 구독 가져오기와 시스템 프록시를 확인하면 됩니다. 기존 클래식 UI에 익숙하고 필요한 기능이 명확하다면 WPF 버전을 선택해도 좋습니다. 프레임워크 이름만을 이유로 불필요하게 여러 번 전환하지 말고 실제 기능을 먼저 확인하세요.
WPF에서 Avalonia로 바꾸면 구독을 다시 구매해야 하나요?
UI를 바꾸는 것만으로 구독을 다시 구매할 필요는 없습니다.「구독 그룹」→「구독 그룹 설정」에서 기존 서비스의 유효한 주소를 사용해 가져오세요. 여러 기기에서 사용할 수 있는지, 동시 접속이 제한되는지는 구독 서비스의 계정 정책을 확인해야 합니다.
UI를 바꾸면 같은 노드의 속도가 빨라지나요?
UI 프레임워크만으로 속도를 판단할 수는 없습니다. 같은 노드, 같은 코어, 같은 라우팅 조건에서 테스트하고 양쪽의 DNS와 프록시 모드를 확인하세요. 설정이 다르면 관찰된 차이를 Avalonia나 WPF 탓으로 단정할 수 없습니다.
두 버전을 한 컴퓨터에 함께 설치해도 되나요?
되돌릴 때 사용할 수 있도록 함께 보관해도 되지만, 데이터 위치를 확인하고 먼저 백업하세요. 평소에는 한 버전만 실행해야 합니다. 테스트할 때는 수신 포트가 겹치지 않도록 하고 시스템 프록시와 TUN을 담당하는 인스턴스도 하나만 두세요. 테스트 후에는 시작 프로그램 설정도 확인합니다.
macOS나 Linux에서 튜토리얼과 같은 메뉴를 찾을 수 없으면 어떻게 하나요?
먼저 튜토리얼이 어떤 UI와 버전을 기준으로 작성되었는지 확인하세요. Windows의 시스템 메뉴 경로를 그대로 따라 하지 말고 ‘구독 그룹’, ‘매개변수 설정’, ‘시스템 프록시’, ‘라우팅 설정’ 등 기능 이름으로 찾아보세요. 데스크톱 환경의 트레이 지원과 프록시 적용 방식도 별도로 확인해야 합니다.
v2rayN 클라이언트 다운로드
운영체제와 아키텍처에 맞는 설치 파일을 선택한 뒤 안내에 따라 구독을 가져오고 프록시가 작동하는지 확인하세요.