Windows에서만 사용하고 익숙한 인터페이스를 선호한다면 WPF판을 우선 고려하세요. Windows, macOS, Linux에서 비슷한 방식으로 사용하고 싶다면 Avalonia 데스크톱판이 적합할 수 있습니다. 두 버전의 핵심 차이는 UI 기술과 OS 통합 방식이지, 프록시 프로토콜의 성능 등급이 아닙니다. 설치 파일 선택부터 코어의 관계, 마이그레이션 절차와 포트 문제 확인까지 살펴보고 처음 설치하는 사용자와 기존 설정을 옮기는 사용자에게 필요한 기준을 안내합니다.
1. Windows 사용자는 어떤 버전을 선택할까
현재 버전이 안정적으로 작동한다면 UI 프레임워크만을 이유로 바꿀 필요는 없습니다. 처음 설치한다면 먼저 OS를 확인하고, 평소 사용하는 방식을 고려하세요. WPF는 Windows 전용 UI 프레임워크이며 Avalonia는 여러 OS를 지원하는 데스크톱 UI 프레임워크입니다. 다만 Avalonia판도 OS와 프로세서 아키텍처에 맞는 설치 파일을 내려받아야 합니다.
WPF판: Windows만 사용한다면 우선 고려
추천Windows 사용자, 특히 기존 사용 방식이나 참고 자료의 화면이 WPF판과 같은 경우 처음 선택하기에 적합합니다. 사용 환경을 고려한 추천이며 WPF판의 프록시 속도가 더 빠르다는 뜻은 아닙니다.
추천 대상: Windows만 사용하고, 기존 작업 방식을 유지하며, 현재 설정이 안정적으로 작동하는 사용자
Avalonia 데스크톱판: 여러 OS에서 사용하려는 경우
비슷한 인터페이스를 Windows, macOS, Linux에서 사용할 수 있어 여러 데스크톱 기기를 오갈 때 편리합니다. 다만 트레이, 창, 권한 동작은 OS마다 다르므로 세 OS에서 완전히 똑같이 작동한다고 볼 수는 없습니다.
추천 대상: 데스크톱 OS를 자주 바꾸고, 인터페이스 사용 방식의 차이를 줄이고 싶으며, 현재 버전의 기능을 확인할 수 있는 사용자
다운로드 페이지에서 말하는 ‘데스크톱판’은 이 글에서 Avalonia판을 가리킵니다. WPF판도 데스크톱 애플리케이션이므로 두 명칭을 ‘정식판’과 ‘간편판’의 차이로 오해하지 마세요. 필요한 기능이 있는지는 프레임워크 이름이 아니라 현재 배포 버전에서 실제로 제공하는 기능을 확인해야 합니다.
2. UI 프레임워크, 클라이언트, 프록시 코어는 서로 다른 계층
v2rayN은 노드 관리, 구독 업데이트, 설정, 프록시 코어의 실행과 관리를 담당합니다. Avalonia와 WPF는 창을 표시하고 UI 입력을 처리합니다. 연결, 프로토콜 핸드셰이크, 라우팅을 실제로 처리하는 것은 실행 중인 프록시 코어입니다.
| 비교 항목 | Avalonia 데스크톱판 | WPF판 |
|---|---|---|
| UI 기술 | Avalonia 크로스 플랫폼 UI 프레임워크 | Windows Presentation Foundation |
| 지원 OS | 해당 OS용 빌드가 제공되는 경우 Windows, macOS, Linux에서 사용 가능 | Windows. 배포 버전의 시스템 요구 사항을 충족해야 함 |
| 설치 파일 선택 | OS와 프로세서 아키텍처에 맞춰 선택 | Windows용 빌드와 프로세서 아키텍처에 맞춰 선택 |
| 프로토콜 지원 여부 | 사용 중인 코어 버전과 클라이언트의 설정 생성 기능에 따라 결정 | 사용 중인 코어 버전과 클라이언트의 설정 생성 기능에 따라 결정 |
| OS 통합 차이 | 각 플랫폼의 트레이, 권한, 창 동작을 따로 확인해야 함 | Windows에서 트레이, 권한, 창 동작 확인 |
| 성능 판단 | 동일한 조건에서 측정해야 하며 프레임워크만으로 결론을 내릴 수 없음 | 동일한 조건에서 측정해야 하며 프레임워크만으로 결론을 내릴 수 없음 |
예를 들어 노드가 VLESS와 REALITY를 사용한다면 실제로 실행되는 Xray 코어와 해당 설정이 지원되는지 먼저 확인해야 합니다. ‘Avalonia를 설치했다’는 사실은 이 확인을 대신할 수 없습니다. VMess, Trojan, Shadowsocks도 코어와 설정을 기준으로 각각 확인하세요. WPF와 Avalonia는 프록시 프로토콜 이름이 아닙니다.
3. 다운로드 전 OS, 아키텍처, 실행 환경 확인
먼저 설치 파일이 실행되는지 확인한 다음 UI를 비교하세요. Windows에서는 ‘설정’ → ‘시스템’ → ‘시스템 정보’에서 시스템 종류를 확인할 수 있습니다. 일부 Windows 버전에서는 마지막 메뉴가 ‘정보’로 표시됩니다. x64와 ARM64를 구분하고, ‘64비트 운영 체제’를 x64 프로세서와 같은 의미로 보지 마세요.
- 시스템 요구 사항을 확인하세요. 현재 배포 버전에서 지원하는 Windows 버전과 다운로드 항목에 표시된 아키텍처를 확인하세요. WPF라는 이름만으로 오래된 모든 시스템에서 실행된다고 보장할 수는 없습니다.
- 패키지 형식을 확인하세요. 설치 프로그램인지 압축 파일인지, 실행 환경이 포함되는지는 배포 버전에 따라 달라질 수 있습니다. 실행 파일이 있다고 해서 필요한 종속성이 모두 포함되어 있다고 단정하지 마세요.
- 시작 안내에 따라 종속성을 설치하세요. .NET 실행 환경이 없다는 안내가 표시되면 필요한 버전과 아키텍처를 맞춰 설치하세요. 데스크톱 런타임이 필요한 경우 일반 런타임이 설치되어 있다는 이유만으로 충분하다고 판단하면 안 됩니다.
- 두 버전을 서로 다른 위치에 설치하세요. 처음 시험할 때 기존 프로그램 폴더를 덮어쓰지 말고, 두 버전이 같은 설정 데이터를 동시에 다루지 않도록 하세요.
macOS 사용자는 프로세서에 맞는 빌드를 선택해야 합니다. Linux 사용자는 배포판의 패키지 형식과 프로세서 아키텍처를 기준으로 선택하세요. 크로스 플랫폼 지원은 UI 프레임워크와 OS별 배포 빌드에 따른 것이며, Windows 설치 파일을 다른 OS에서 그대로 사용할 수 있다는 뜻은 아닙니다.
설치 파일 이름, 버전 번호, 종속성 요구 사항은 바뀔 수 있습니다. 오래된 안내의 파일명을 기준으로 설치 파일을 찾지 말고 클라이언트 다운로드 페이지와 현재 패키지 안내를 확인하세요. 특정 과거 버전 번호를 계속 사용할 다운로드 기준으로 제시하지 않습니다.
4. WPF에서 Avalonia로 전환할 때는 노드부터 옮기고 규칙은 나중에 복원
마이그레이션의 목적은 두 인터페이스의 스위치 모양을 똑같이 맞추는 것이 아니라 기존 연결 동작을 재현하는 것입니다. 가장 안전한 방법은 기존 설정을 백업하고, 작동이 확인된 노드 하나를 먼저 가져와 연결을 확인한 뒤 구독, 라우팅, 자동 시작 설정을 복원하는 것입니다.
마이그레이션 방법: 기존 환경을 보존하고 새 버전을 별도로 확인
기존 버전: 되돌릴 수 있도록 유지
- 종료하기 전에 v2rayN과 코어 버전을 기록합니다.
- 설정 데이터를 백업하고 필요한 구독 주소와 사용자 지정 규칙을 따로 저장합니다.
- 로컬 수신 포트, 시스템 프록시 상태, 현재 라우팅 모드를 기록합니다.
- 자동 시작을 끄고 프로그램을 종료한 뒤 기존 코어가 더 이상 포트를 수신 대기하지 않는지 확인합니다.
새 버전: 단계별로 설정 복원
- 기존 설치와 분리해 설치한 뒤 검증된 노드 하나를 가져옵니다.
- 코어가 정상적으로 시작되는지 확인한 다음 브라우저 접속을 테스트합니다.
- 구독, 라우팅, DNS, 필요에 따라 사용하는 TUN 설정을 하나씩 복원합니다.
- 시스템을 재시작한 뒤 다시 테스트하고, 마지막으로 자동 시작에 사용할 버전을 결정합니다.
각 단계에서 한 종류의 설정만 변경하세요. 문제가 생겼을 때는 모든 데이터를 한꺼번에 옮기는 것보다 직전 단계로 돌아가 원인을 찾기 쉽습니다.
일반적으로 같은 구독을 다시 추가할 수 있지만, 사용자 지정 라우팅, DNS, 단축키, 창 설정, 사용자 지정 설정의 저장 방식까지 버전 간에 그대로 이전된다고 보장할 수는 없습니다. 현재 버전에서 가져오기나 복원 기능을 제공한다면 백업을 사용하기 전에 지원하는 파일 형식과 원본 버전을 확인하세요.
메뉴 확인은 ‘설정’ → ‘매개변수 설정’에서 시작해 수신 포트와 관련 설정을 살펴보세요. 구독은 ‘구독 그룹’에서 항목별로 확인할 수 있습니다. 메뉴 이름과 그룹은 버전에 따라 달라질 수 있으므로 같은 이름의 항목을 찾지 못하면 설정의 의미를 기준으로 확인하세요. 기존 데이터 폴더를 반복해서 덮어쓰지 마세요. 구독 주소에 접속 정보가 포함될 수 있으므로 스크린샷과 로그에서 민감한 부분을 가려야 합니다.
5. 포트 충돌과 속도 차이를 따로 확인하는 방법
버전을 바꾼 뒤 연결되지 않는다면 먼저 클라이언트 프로세스 두 개가 동시에 실행 중인지 확인하세요. 다음은 확인 방법을 설명하기 위한 수동으로 지정한 예시 포트입니다. 모든 버전의 기본값이라는 뜻도 아니며, 프로그램이 SOCKS 포트와 HTTP 포트를 항상 별도로 제공한다는 의미도 아닙니다.
포트를 다르게 설정해도 두 버전이 시스템 프록시 설정을 서로 바꿀 수 있으므로, 일상적인 테스트에서는 한 번에 한 버전만 실행하는 것이 좋습니다. ‘설정’ → ‘매개변수 설정’에서 실제 수신 포트를 확인한 다음 시스템 프록시가 어디를 가리키는지 확인하세요. 트레이 아이콘에 실행 중으로 표시된다는 이유만으로 새 버전을 통해 데이터가 전송된다고 판단하지 마세요.
netstat -ano | findstr :10808
netstat -ano | findstr :10818위 내용은 Windows 명령 프롬프트에서 확인하는 예시입니다. 출력에 표시된 로컬 주소, 포트, PID를 확인하세요. TCP 수신 대기 상태라면 LISTENING을 확인합니다. 그런 다음 작업 관리자에서 해당 PID의 프로세스를 찾으세요. 포트를 사용 중이라는 사실만으로 프로세스에 문제가 있다고 볼 수 없으므로, 어떤 프로세스인지 확인하기 전에 종료하지 마세요.
- 브라우저에서는 접속되지만 명령줄에서는 실패: 명령줄 프로그램이 시스템 프록시를 사용하는지, 이전 포트를 명시적으로 가리키고 있지는 않은지 확인하세요.
- 버전 전환 후 일부 사이트만 접속되지 않음: 라우팅 규칙, DNS, 스니핑 설정을 비교하세요. 설정 차이를 UI 프레임워크 문제로 오인하지 않도록 합니다.
- 노드 지연 시간은 정상인데 다운로드 속도가 느림: 지연 시간 테스트는 처리량 테스트와 다릅니다. 노드 부하, 회선, 접속 대상 사이트의 제한을 추가로 확인하세요.
- 메모리 사용량이 늘어난 것처럼 보임: UI 프로세스와 코어 프로세스를 구분해 살펴보고, 노드 수와 창 상태, 실행 시간을 동일하게 맞춰 비교하세요.
두 버전의 속도를 비교하려면 같은 노드, 다운로드 대상, 코어 버전, 라우팅 설정을 사용하고 각 버전에서 번갈아 3회씩 측정해 중앙값을 기록하세요. 이 방법은 우연한 변동을 줄이기 위한 것으로, 미리 성능 차이를 단정하는 기준은 아닙니다. 동일한 조건의 기록이 없다면 특정 프레임워크가 회선을 더 빠르게 만든다고 결론 내릴 수 없습니다.
6. 버전 선택과 마이그레이션 FAQ
Windows에서만 사용하는데 WPF에서 Avalonia로 바꿔야 할까요?
현재 버전이 안정적으로 작동하고 필요한 기능도 갖췄다면 프레임워크만을 이유로 바꿀 필요는 없습니다. 새 UI를 확인하고 싶다면 별도로 설치해 구독 업데이트, 트레이에서 종료하는 동작, 시스템 프록시 복원, 재시작 후 동작을 점검하세요. 평소 사용 방식에 모두 맞는지 확인한 뒤 교체하면 됩니다.
Avalonia판에서도 기존 구독을 사용할 수 있나요?
기존 구독을 추가해 수동으로 업데이트한 다음 노드 수와 작동이 확인된 노드 하나의 프로토콜, 포트, 전송 방식, 보안 매개변수를 비교하세요. 목록을 가져왔다고 모든 확장 매개변수가 제대로 적용된 것은 아닙니다. 연결에 실패하면 현재 코어 로그도 함께 확인하세요.
기존에는 REALITY가 작동했는데 버전을 바꾼 뒤 실패합니다. 프로토콜을 바꿔야 할까요?
우선 프로토콜을 바꾸지 마세요. 사용 중인 Xray 코어 버전을 확인한 뒤 서버 주소, 포트, 사용자 ID, 공개 키, 서버 이름과 기타 필수 매개변수를 점검하세요. 생성된 설정과 시작 오류를 확인하고, 가져오기 과정에서 누락된 항목이나 코어 호환성 문제부터 살펴보세요.
새 버전을 종료한 뒤 기존 버전에서도 웹 페이지가 열리지 않습니다. 어떻게 해야 하나요?
Windows의 ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’에서 종료된 프로그램의 포트를 가리키고 있지 않은지 확인하세요. 그런 다음 사용할 버전 하나만 실행하고 시스템 프록시를 다시 설정한 뒤 연결을 확인합니다. TUN을 사용한다면 관련 가상 네트워크 어댑터와 라우팅이 복구되었는지도 확인하세요.
두 버전의 자동 시작을 모두 켜도 되나요?
권장하지 않습니다. 창이 모두 열리더라도 포트 점유, 시스템 프록시 설정 덮어쓰기, TUN 충돌이 생길 수 있습니다. 마이그레이션을 마친 뒤 자동 시작 항목은 한 버전만 남기고, 재시작 후 작업 관리자와 실제 수신 포트를 확인하세요.
선택 기준은 두 가지로 정리할 수 있습니다. Windows만 사용하고 기존 작업 방식을 유지하려면 WPF를 우선 고려하고, 여러 데스크톱 OS에서 비슷한 인터페이스를 사용하려면 Avalonia를 고려하세요. 프로토콜 지원은 코어, 연결 동작은 설정에 따라 달라집니다. UI는 실제 사용 방식과 OS 통합이 요구에 맞는지를 기준으로 선택하세요.