먼저 운영체제로 선택지를 좁힌 뒤 사용 방식에 맞춰 고르세요. macOS와 Linux에서는 Avalonia 데스크톱 버전을 사용하고, Windows에서는 Avalonia와 WPF를 비교할 수 있습니다. 두 버전의 주요 차이는 인터페이스 프레임워크, 데스크톱 통합, 실행 종속성입니다. 인터페이스 버전이 프로토콜이나 속도 등급을 뜻하는 것은 아닙니다. 아래에서 비교표와 설치 전 확인 사항, 전환 절차를 살펴봅니다. 처음 다운로드하거나 버전 변경을 준비하는 데스크톱 사용자에게 적합합니다.
인터페이스 프레임워크와 프록시 코어 구분하기
Avalonia와 WPF는 모두 그래픽 인터페이스를 만드는 기술입니다. 창, 목록, 메뉴, 입력 컨트롤을 화면에 표시하는 방식을 결정합니다. v2rayN은 이 인터페이스를 통해 서버, 구독 그룹, 라우팅 규칙, 프록시 사용 여부를 관리합니다. 실제 프록시 연결은 선택한 코어가 처리합니다. Avalonia 버전을 선택해도 특정 프로토콜로 바뀌는 것은 아니며, WPF 버전을 선택했다고 특정 코어만 사용할 수 있는 것도 아닙니다.
VLESS 또는 VMess 노드에 연결할 수 없다면 노드 설정, 코어 지원 여부, 로그부터 확인하세요. 창 모양만으로 원인을 판단하면 안 됩니다. 두 프로그램에 같은 구독 이름이 표시되더라도 코어 버전, 선택된 노드, 라우팅 설정이 다르면 연결 결과가 달라질 수 있습니다. 인터페이스 버전을 비교하기 전에 이러한 조건부터 맞추세요.
| 구성 요소 | 담당 기능 | 확인할 곳 |
|---|---|---|
| Avalonia / WPF | 창 표시, 메뉴 조작, 데스크톱 통합 | 인터페이스 설정, 시스템 디스플레이 설정 |
| 프록시 코어 | 프로토콜 처리, 연결 설정, 규칙 적용 | 코어 선택, 실행 로그 |
| 노드 및 구독 | 서버 주소, 포트, 인증 및 전송 설정 | 서버 편집, 구독 그룹 설정 |
플랫폼에 맞춰 Avalonia 또는 WPF 선택하기
Avalonia 데스크톱 버전은 Windows, macOS, Linux를 지원하고, WPF는 Windows용 인터페이스입니다. 여기서 멀티플랫폼이란 운영체제별 빌드가 제공된다는 뜻이지, 하나의 설치 파일을 세 운영체제에서 모두 실행할 수 있다는 의미는 아닙니다. 다운로드하기 전에 x64, ARM64 등 프로세서 아키텍처도 확인하세요. 버전 이름만 보고 선택하면 안 됩니다.
Avalonia 데스크톱 버전
권장처음 버전을 선택할 때 출발점으로 삼기 좋습니다. 특히 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하려는 경우에 적합합니다. 시스템 버전, 아키텍처, 데스크톱 환경 요구 사항은 각각 확인해야 합니다.
추천 대상: macOS·Linux 사용자 및 데스크톱 사용 방식을 통일하려는 Windows 사용자
WPF 버전
기존 Windows 인터페이스 방식으로 계속 사용할 수 있습니다. 안정적인 설정을 유지하고 있고 기존 메뉴와 트레이 조작에 익숙하다면, 우선 현재 버전을 사용하면서 새 인터페이스를 별도로 평가하세요.
추천 대상: Windows만 사용하며 기존 인터페이스 방식에 익숙한 사용자
권장 표시는 이 문서에서 제안하는 선택 순서를 뜻하며, WPF 버전의 지원이 종료됐다는 의미는 아닙니다. Windows 사용자는 ‘멀티플랫폼’이라는 이유만으로 서둘러 전환할 필요가 없습니다. 현재 환경이 안정적이라면 인터페이스 이름을 따라가기보다 기능과 호환성을 먼저 확인하세요.
인터페이스, 트레이, 창 동작 비교
두 인터페이스 모두 서버 목록, 구독 그룹, 로그, 설정을 중심으로 구성되어 있지만 메뉴 위치, 열 너비 저장, 단축키, 마우스 오른쪽 버튼 메뉴는 버전에 따라 달라질 수 있습니다. 처음 실행하면 현재 서버 표시, 시스템 프록시 상태, 로그 위치부터 확인한 뒤 테마, 글꼴, 목록 열 너비를 조정하세요. 다른 버전의 화면을 보고 좌표만 따라 눌러서는 안 됩니다.
| 점검 항목 | Avalonia 데스크톱 버전 | WPF 버전 |
|---|---|---|
| 창 및 배율 | 현재 시스템의 배율, 글꼴, 컨트롤 배치 확인 | Windows 배율 및 다중 모니터 전환 확인 |
| 트레이 메뉴 | 시스템 및 Linux 데스크톱 환경의 지원 여부에 따라 달라집니다 | Windows 알림 영역과 숨겨진 아이콘 영역 확인 |
| 닫기 버튼 | 창을 닫은 뒤에도 백그라운드에서 실행되는지 확인 | 창 닫기 동작과 트레이 메뉴의 종료 기능 확인 |
| 시스템 프록시 | 현재 데스크톱 세션에 설정이 실제로 적용되는지 확인 | Windows 프록시 설정과 클라이언트 상태 확인 |
창을 닫는다고 프로그램이 종료되는 것은 아닙니다. 트레이 동작을 테스트하려면 먼저 기본 창을 닫은 뒤 트레이에서 다시 열어 보세요. 프로그램을 완전히 중지할 때는 트레이 메뉴의 종료 기능을 사용하고 프록시 설정이 복원됐는지 확인하세요. 창은 사라졌는데 연결이 계속된다면 프로그램을 다시 실행하기 전에 백그라운드 프로세스를 확인하세요.
- Windows: 작업 표시줄의 숨겨진 아이콘 영역을 열어 트레이 아이콘이 접혀 있지 않은지 확인하세요. 다른 모니터로 옮긴 뒤에는 배율과 창 위치도 점검하세요.
- macOS: 창 닫기와 앱 종료를 구분하세요. 메뉴 막대의 진입점을 확인하고, 잠자기 후 깨어났을 때 연결 상태도 테스트하세요.
- Linux: 데스크톱 환경이 트레이 또는 상태 표시기를 지원하는지 확인하세요. 트레이 아이콘이 없다는 사실만으로 프록시 코어가 실행되지 않았다고 판단할 수는 없습니다.
설치 전 실행 종속성 확인
‘더블 클릭해도 실행되지 않는’ 문제는 먼저 패키지 유형, 아키텍처, 실행 종속성을 확인해야 합니다. 노드부터 바꾸지 마세요. WPF 버전은 보통 해당 버전의 .NET Desktop Runtime이 필요합니다. Avalonia 데스크톱 버전은 배포 패키지에 필요한 구성 요소가 포함되어 있는지와 시스템의 네이티브 라이브러리 요구 사항을 확인해야 합니다. 자체 포함 패키지에는 해당 관리 런타임이 들어 있지만, 운영체제 요구 사항까지 무시해도 된다는 뜻은 아닙니다.
- 운영체제와 아키텍처를 확인하세요. Windows에서는 ‘설정’ → ‘시스템’ → ‘정보’에서 시스템 종류를 확인합니다. macOS에서는 ‘이 Mac에 관하여’에서 칩을 확인하고, Linux에서는 시스템 설정의 ‘정보’ 페이지에서 운영체제와 프로세서 정보를 확인하세요.
- 설치 패키지 안내를 확인하세요. 데스크톱 버전과 WPF 버전을 구분하고, 자체 포함 여부와 최소 시스템 요구 사항, 아키텍처를 확인하세요. 다른 운영체제용 패키지를 압축 해제해 반복해서 실행하려 하지 마세요.
- 오류에 표시된 종속성을 설치하세요. 시작 오류 대화상자에 누락된 프레임워크 이름, 버전, 아키텍처가 표시되면 해당 정보를 기준으로 설치하세요. WPF에 필요한 Desktop Runtime과 일반 .NET Runtime은 서로 다릅니다.
- 프로그램 폴더 전체를 유지하세요. 포터블 패키지는 쓰기 가능한 위치에 전체 압축을 풀어야 하며, 실행 파일만 복사하면 안 됩니다. 코어 파일, 리소스, 설정 파일의 위치는 해당 버전의 디렉터리 안내를 따르세요.
버전 전환: 먼저 백업하고 별도로 검증하기
WPF에서 Avalonia로 바꾸거나 Avalonia에서 WPF로 돌아갈 때 사용 중인 프로그램 폴더를 그대로 덮어쓰지 마세요. 버전에 따라 설정 형식과 데이터 디렉터리가 다를 수 있습니다. 기존 환경을 보존하고 새 프로그램은 별도 위치에 설치하세요. 클라이언트에서 제공하는 백업, 복원 또는 가져오기 기능으로 데이터를 옮기되, 메뉴 위치는 현재 버전을 기준으로 확인하세요.
마이그레이션 방법: 기존 환경을 보존하고 새 인터페이스를 별도로 테스트
기존 환경: 문제 발생 시 복귀할 수 있도록 보존
- 클라이언트 버전, 코어, 현재 노드를 기록하세요.
- 구독 그룹, 라우팅, 사용자 지정 설정을 백업하세요.
- 프로그램을 종료한 뒤 실제 데이터 디렉터리를 백업하세요.
새 환경: 항목별로 검증
- 먼저 구독 그룹 하나를 가져와 노드 수를 확인하세요.
- 먼저 시스템 프록시로 테스트하고 TUN은 활성화하지 마세요.
- 연결을 확인한 뒤 사용자 지정 라우팅을 복원하세요.
두 프로그램이 동시에 시스템 프록시를 제어하거나 같은 수신 대기 포트를 사용하지 않도록 하세요. 검증을 마친 뒤 어느 쪽을 유지할지 결정하세요.
예를 들어 기존 환경이 127.0.0.1:10808에서 수신 대기 중이고 새 환경도 같은 주소와 포트에 바인딩하면 실행에 실패할 수 있습니다. 기존 환경을 완전히 종료한 뒤 새 환경을 실행하세요. 동시에 테스트해야 한다면 새 환경에 다른 포트를 지정하고 테스트할 앱의 프록시 주소도 함께 변경하세요. 여기서 10808은 예시일 뿐이며 모든 버전의 기본 포트가 아닙니다.
- ‘설정’ → ‘매개변수 설정’에서 로컬 수신 대기 관련 항목을 확인하세요. 이름과 분류는 버전에 따라 달라질 수 있으므로 실제 인터페이스를 기준으로 확인해야 합니다.
- 기존 환경과 같은 노드 및 코어를 선택하고 시스템 프록시가 새 환경의 실제 수신 대기 포트를 가리키는지 확인하세요.
- 같은 테스트 웹페이지에 접속해 로그에서 포트 바인딩, 핸드셰이크, 이름 확인 오류가 있는지 살펴보세요. 설정은 한 번에 하나씩만 변경하세요.
- 구독 업데이트, 트레이에서 창 복원, 종료 후 프록시 복원, 재시작 후 실행 동작을 테스트한 뒤 나머지 그룹을 옮기세요.
구독으로 복원되는 것은 구독에 포함된 노드 정보뿐이며, 모든 로컬 설정이 자동으로 복구되지는 않습니다. 수동으로 추가한 서버, 라우팅 규칙, DNS 설정, 단축키는 각각 확인해야 합니다. 백업에는 구독 주소와 인증 정보가 포함될 수 있으므로 안전한 곳에 보관하고 도움을 요청할 때 첨부 파일로 공개하지 마세요.
자주 묻는 질문과 최종 선택
같은 구독인데 버전을 바꾸면 왜 연결되지 않나요?
먼저 현재 선택된 노드가 같은지 확인한 다음 코어 유형과 버전, 라우팅, 시스템 프록시를 점검하세요. 로그에서 로컬 포트가 사용 중이라는 메시지가 있는지 확인하고, 기존 프로그램이 백그라운드에서 실행 중이면 종료하세요. 구독이 같아도 실행 설정 전체가 같은 것은 아닙니다.
Windows에서는 어떤 버전을 먼저 설치해야 하나요?
처음 사용한다면 Avalonia 데스크톱 버전부터 테스트해 보세요. 익숙한 Windows 사용 방식을 유지하고 싶거나 특정 창 동작이 현재 환경에서 더 안정적이라면 WPF를 선택할 수 있습니다. 설치 후에는 창이 열리는지만 보지 말고 이 문서의 트레이, 프록시, 재시작 항목을 확인하세요.
WPF로 바꾸면 VLESS 노드가 더 빨라지나요?
그렇게 단정할 수 없습니다. 먼저 노드, 코어, 라우팅을 동일하게 맞춘 뒤 비슷한 시간대에 테스트하세요. 목록 스크롤만 끊긴다면 디스플레이 배율, 목록 크기, 인터페이스 설정을 확인하고, 웹페이지 연결이 느리다면 네트워크와 로그를 점검하세요.
새 인터페이스에 트레이 아이콘이 없어도 계속 사용할 수 있나요?
먼저 기본 창이 정상적으로 작동하는지 확인하고 시스템에서 아이콘을 숨겼는지도 살펴보세요. Linux에서는 데스크톱 환경의 트레이 지원 여부도 확인해야 합니다. 창을 닫은 뒤 다시 열 수 있는지 테스트하세요. 복원 방법이 확실해질 때까지 창을 열어 두고 검증되지 않은 백그라운드 동작에 의존하지 마세요.
새 버전과 기존 버전을 같은 폴더에 둘 수 있나요?
마이그레이션 테스트에는 별도 디렉터리를 사용하고 두 버전이 같은 데이터 위치를 참조하는지도 확인하세요. 두 프로그램이 같은 설정 저장소에 동시에 기록하게 두지 마세요. 복구할 수 있도록 기존 환경을 보존하고 새 환경의 안정성을 확인한 뒤 정리하세요.
최종 선택은 세 가지 기준으로 결정하세요. 시스템에서 실행되는지, 자주 쓰는 기능이 모두 있는지, 데스크톱 동작 방식이 사용 습관에 맞는지 확인하면 됩니다. macOS와 Linux 사용자는 Avalonia 데스크톱 버전부터 시작하고, Windows 사용자는 실제 PC에서 검증한 인터페이스를 선택하세요. 연결 오류가 발생하면 인터페이스, 코어, 노드의 문제를 나눠 확인한 다음 버전 변경 여부를 결정하세요.