· 클라이언트 선택 · 약 8분

v2rayN 데스크톱 버전 선택 가이드: Avalonia 크로스 플랫폼과 WPF 차이

v2rayN은 WPF 기반 Windows 전용 버전과 Avalonia 기반 크로스 플랫폼 데스크톱 버전을 제공합니다. 인터페이스 프레임워크, 운영체제 지원, 트레이 동작, 설치 파일 이름을 비교하고 플랫폼별 선택 방법을 안내합니다.

핵심 내용

macOS와 Linux에서는 Avalonia 버전을 선택하세요. Windows에 처음 설치한다면 크로스 플랫폼 데스크톱 버전부터 시작하면 됩니다. 기존 인터페이스에 익숙하고 문제가 없다면 WPF 버전을 계속 사용해도 좋습니다. 아래에서 설치 파일의 아키텍처를 확인하는 법, 창을 닫은 뒤에도 프로그램이 실행 중인지 확인하는 법, 구독 정보를 유지하면서 버전을 바꾸고 로컬 프록시 연결을 점검하는 방법을 설명합니다.

인터페이스 프레임워크 비교: Avalonia와 WPF 중 어떤 버전이 좋을까요?

Avalonia 크로스 플랫폼 데스크톱 버전

추천

Avalonia는 여러 플랫폼에서 동작하는 인터페이스를 만드는 프레임워크입니다. Windows, macOS, Linux용 배포 파일은 각각 다르며, 하나의 설치 파일로 세 운영체제에서 실행하는 방식이 아닙니다.

추천 대상: 처음 설치하거나 여러 데스크톱 운영체제에서 비슷한 인터페이스를 사용하려는 경우

WPF Windows 버전

WPF는 Windows 데스크톱 인터페이스 프레임워크입니다. 익숙한 창, 메뉴, 트레이 조작 방식을 그대로 사용하고 싶을 때 선택하세요. 노드 프로토콜을 바꾸는 것은 아닙니다.

추천 대상: Windows만 사용하고 기존 WPF 설정과 사용 방식이 안정적인 경우

인터페이스에서는 구독 관리, 노드 편집, 코어 실행을 담당하고 코어에서는 연결을 처리합니다. Avalonia와 WPF는 프로토콜명이나 코어명이 아닙니다. 버전을 바꾼 뒤 같은 노드로 연결되지 않는다면 선택한 노드, 실제 실행 중인 코어, 로그를 먼저 확인한 다음 라우팅과 로컬 포트 설정을 비교하세요. 인터페이스 모양만으로 프로토콜 지원 여부나 연결 속도를 판단할 수는 없습니다.

설치 파일 이름 읽는 법: 운영체제와 아키텍처부터 확인하세요

파일 이름은 요소별로 확인하세요. 운영체제와 아키텍처에 따라 기기에서 실행할 수 있는지가 결정되고, 인터페이스 종류에 따라 사용할 데스크톱 버전이 정해집니다. 확장자는 설치 프로그램인지 압축 파일인지 등을 구분합니다. Windows에서는 x64를 WPF 표시로 오해하지 말고, .exe 확장자만 보고 크로스 플랫폼 데스크톱 버전이라고 판단하지 마세요. 두 파일의 아키텍처가 같다면 다운로드 카드에 표시된 버전을 기준으로 선택하면 됩니다.

운영체제인터페이스 버전다운로드 전 확인
WindowsAvalonia 또는 WPF「설정」→「시스템」→「정보」를 열고 「시스템 종류」를 확인하세요. x64 기반 프로세서라면 x64를 선택합니다. ARM 기기에서는 선택한 버전이 네이티브 ARM64 패키지를 제공하는지 먼저 확인하세요.
macOSAvalonia「이 Mac에 관하여」에서 칩 또는 프로세서를 확인하세요. Apple 칩은 ARM64, Intel 프로세서는 x64를 선택합니다.
LinuxAvaloniauname -m을 실행하세요. x86_64는 x64, aarch64는 ARM64에 해당합니다. 그런 다음 배포판에 맞는 패키지 형식을 선택하세요.

다운로드한 파일이 압축 파일이면 현재 계정에서 쓸 수 있는 새 디렉터리에 전체 압축을 푼 뒤 프로그램을 실행하세요. 실행 파일만 따로 꺼내면 안 됩니다. 별도의 런타임 설치가 필요한 빌드는 패키지 안내와 실행 시 표시되는 메시지에서 런타임 종류와 아키텍처를 확인하세요. 예를 들어 WPF에서 Microsoft.WindowsDesktop.App이 없다는 메시지가 표시되면 해당하는 .NET 데스크톱 런타임을 확인해야 합니다. 다른 버전의 기본 런타임을 임의로 설치하지 마세요.

트레이 동작: 창을 닫아도 프로그램이 종료되지 않을 수 있습니다

데스크톱 환경에서 백그라운드 실행 여부 확인하기

Windows: 알림 영역 확인
  • 창을 닫은 뒤 작업 표시줄의 숨겨진 아이콘을 펼쳐 v2rayN 아이콘이 남아 있는지 확인하세요.
  • 아이콘을 눌러 창을 다시 열어 보세요. 버전을 바꿀 때는 트레이 메뉴에서 「종료」를 선택한 다음 작업 관리자에서 이전 인스턴스가 완전히 종료됐는지 확인하세요.
macOS 및 Linux: 상태 아이콘 표시 여부 확인
  • macOS에서는 화면 상단의 메뉴 막대를 확인하세요. Dock의 앱 아이콘과 메뉴 막대의 상태 아이콘은 서로 다릅니다.
  • Linux에서는 먼저 데스크톱 패널이 상태 아이콘을 지원하는지 확인하세요. 아이콘이 보이지 않으면 시스템 모니터 도구로 프로세스 상태를 확인하고, 확인하려고 인스턴스를 여러 개 연속 실행하지 마세요.

프로그램이 종료됐는지 먼저 확인한 다음 시스템 프록시가 여전히 로컬 수신 주소를 가리키는지 살펴보세요. 두 항목은 각각 따로 확인해야 합니다.

트레이 아이콘이 표시되는지는 데스크톱 환경, 아이콘 표시 방식, 앱 설정에 따라 달라집니다. 확인하려면 먼저 기본 창을 열었다가 한 번 닫은 뒤 트레이나 메뉴 막대에서 다시 열어 보세요. 프록시만 중지하려면 현재 사용 방식에 따라 클라이언트에서 설정한 시스템 프록시나 TUN을 끄고, 프로그램도 명시적으로 종료하세요. 수동 프록시를 사용하던 기기라면 시스템 설정을 바로 지우지 말고 이전 주소로 복원하세요.

버전 변경 후 확인: 구독 유지와 로컬 포트 점검

버전을 바꾸기 전에 구독 출처, 사용 중인 노드, 라우팅 모드, 로컬 수신 포트를 기록하세요. 구독 주소는 인증 정보처럼 안전하게 보관하고 공개 화면 캡처에 포함하지 마세요. 직접 입력한 노드를 유지하려면 클라이언트의 가져오기·내보내기 기능을 사용하거나 기존 데이터 디렉터리를 백업하세요. 새 프로그램과 기존 프로그램이 쓰기 중인 디렉터리를 함께 사용하게 해서는 안 됩니다.

127.0.0.1
로컬 루프백 주소 예시
10808
로컬 수신 포트 예시
  1. 기존 버전을 종료한 뒤 새 버전을 실행하세요. 구독 하나를 가져오거나 이미 작동하는 노드를 추가한 다음, 기존 버전과 같은 테스트 노드를 선택하세요. 그래야 노드 차이로 인한 문제를 버전 변경 문제로 오해하지 않습니다.
  2. 「설정」→「매개변수 설정」에서 로컬 수신 항목을 확인하고, 로그에서 코어가 시작됐는지 살펴보세요. 위의 127.0.0.1:10808은 주소와 포트가 프록시 연결 주소를 구성하는 방식을 보여 주는 예시입니다. 실제 프로토콜과 포트는 이 기기의 설정을 기준으로 확인하세요.
  3. 먼저 시스템 프록시 설정을 따르는 브라우저로 접속을 확인한 다음, 수동으로 프록시를 설정한 터미널이나 다른 프로그램을 테스트하세요. 새 버전에서 포트가 바뀌었다면 해당 프로그램의 이전 포트도 함께 변경해야 합니다. 로그에 포트 사용 중 오류가 표시되면 기존 인스턴스가 실행 중인지 먼저 확인하세요. 인스턴스를 반복해서 추가 실행하며 문제를 진단하지 마세요.

노드, 라우팅, 자주 쓰는 프로그램이 모두 정상인지 확인한 뒤 기존 디렉터리를 삭제할지 결정하세요. 이전 버전으로 되돌아가려면 새 버전을 종료하고 기존 프록시 설정을 복원한 다음 이전 버전을 실행하세요. 새 파일을 기존 디렉터리에 덮어쓰는 것보다 이전 디렉터리와 백업을 따로 보관하는 편이 차이를 찾기 쉽습니다.

v2rayN 데스크톱 버전 FAQ

Windows에서 두 버전의 파일을 함께 보관해도 되나요?

각 버전을 별도의 디렉터리에 보관할 수 있지만, 테스트할 때는 한 번에 하나만 실행하세요. 전환하기 전에 현재 버전을 종료하고 로컬 포트가 해제됐는지 확인한 뒤 다른 버전을 실행하세요. 두 버전이 동시에 시스템 프록시 설정을 변경하는 상황을 피할 수 있습니다.

크로스 플랫폼 버전으로 바꾸면 구독을 다시 구매해야 하나요?

인터페이스 버전만 바꾸는 경우에는 다시 구매할 필요가 없습니다. 새 버전에 기존 구독을 추가하고 업데이트를 실행해 보세요. 업데이트에 실패하면 링크가 아직 유효한지, 서비스 제공업체가 구독 형식이나 기기 수를 제한하는지 확인하세요.

설치 파일을 실행하자마자 종료되는데 WPF로 바꿔야 하나요?

먼저 버전을 바꾸지 않아도 됩니다. 운영체제와 아키텍처, 압축 해제 상태, 현재 계정의 프로그램 데이터 디렉터리 쓰기 권한을 확인하세요. Windows에서 런타임 오류가 발생한다면 실행 시 안내 메시지나 이벤트 뷰어의 「Windows 로그」→「응용 프로그램」을 확인하고, 실제로 누락된 항목을 해결하세요.

WPF에서 Avalonia로 바꾼 뒤 웹페이지는 열리지만 터미널에서 연결되지 않으면 어떻게 하나요?

먼저 터미널에 이전 http_proxy 또는 https_proxy 설정이 남아 있는지 확인한 다음 포트와 프록시 유형을 비교하세요. 환경 변수를 바꾼 뒤에는 터미널을 새로 열어 테스트하세요. 브라우저 접속이 된다는 이유만으로 터미널도 같은 프록시 연결 주소를 사용한다고 단정하면 안 됩니다.

클라이언트 다운로드 및 설치