v2rayN Avalonia 데스크톱 버전과 WPF 버전 비교: 지원 운영체제와 선택 방법

v2rayN의 Avalonia·WPF 버전별 지원 운영체제, 실행 환경, 인터페이스 차이를 비교합니다. Windows·macOS·Linux에서 맞는 버전을 고르고 설정을 옮기는 방법도 확인하세요.

핵심 내용

v2rayN을 처음 설치한다면 운영체제와 프로세서에 맞는 Avalonia 데스크톱 버전을 우선 고려하세요. Windows만 사용하고 기존 인터페이스에 익숙하다면 WPF 버전을 계속 써도 됩니다. 두 버전의 주된 차이는 인터페이스와 운영체제 지원 여부이지 노드 유형이 아닙니다. 버전을 바꾸기 전에 백업하고, 변경 후에는 구독, 라우팅, 로컬 포트를 확인하세요.

운영체제 지원: Avalonia와 WPF 중 선택하기

Avalonia와 WPF는 창, 메뉴, 버튼 등 인터페이스를 만드는 프레임워크입니다. 프록시 프로토콜이나 연결을 처리하는 코어가 아닙니다. 같은 VLESS 또는 VMess 노드를 비교할 때는 먼저 코어와 버전, 노드 매개변수, 라우팅 설정이 동일한지 확인하세요. 인터페이스 이름만으로 호환성이나 연결 속도를 판단할 수는 없습니다.

Avalonia 데스크톱 버전

추천

Windows, macOS, Linux를 지원하며 운영체제별 설치 파일이 제공됩니다. 같은 인터페이스 프레임워크를 사용해 조작 방식을 일관되게 유지할 수 있지만, 창과 메뉴, 트레이, 시스템 프록시 동작은 운영체제에 따라 다릅니다.

추천 대상: 처음 설치하거나 데스크톱 운영체제를 바꿔 가며 사용하는 경우

WPF 버전

Windows에서 사용할 수 있습니다. 기존 인터페이스에 익숙하고 현재 설정도 정상이라면 인터페이스를 바꾸기 위해 다시 설치할 필요는 없습니다. 다운로드 페이지에서 프로세서 아키텍처와 실행 요구 사항은 확인하세요.

추천 대상: Windows만 사용하며 기존 인터페이스의 조작 방식을 유지하고 싶은 경우

이전 버전 기준 튜토리얼을 따라 할 때는 먼저 스크린샷이 어느 인터페이스인지 확인하세요. 창 배치가 다르다고 기능이 사라진 것은 아닙니다. 노드 목록, 구독 그룹, 로그를 찾을 때는 버튼 위치보다 기능 이름을 기준으로 살펴보세요.

설치 파일 아키텍처와 .NET 실행 환경

설치 파일은 운영체제, 프로세서 아키텍처, 패키지 형식 순으로 선택하고, 마지막으로 런타임을 별도 설치해야 하는지 확인하세요. v2rayN 7.x에서도 주 버전만 보고 모든 배포 파일이 같은 .NET 버전에 의존하거나 런타임을 패키지에 포함한다고 단정할 수 없습니다. 시작할 때 오류가 표시되면 해당 패키지 안내와 오류에 나온 프레임워크 이름, 버전, 아키텍처를 확인하세요.

x64
일반적인 64비트 Intel 또는 AMD PC용이며 Linux에서는 x86_64에 해당
ARM64
Apple 칩 등 ARM 기기용이며 Linux에서는 aarch64에 해당
10808
v2rayN에서 흔히 사용하는 로컬 인바운드 포트이며 실제 값은 매개변수 설정을 따릅니다

버전 변경 전 백업하고 상황에 맞게 설정 복원하기

인터페이스를 바꾸는 작업은 노드를 다시 가져오는 것만으로 끝나지 않습니다. 구독 그룹, 직접 추가한 노드, 사용자 지정 라우팅, 로컬 리스닝 설정은 서로 다른 데이터입니다. 구독을 다시 가져와도 해당 구독에 포함된 노드만 복구되는 경우가 대부분입니다. 백업 전에 기존 버전에서「시스템 프록시」를 끄고 트레이 메뉴에서 클라이언트를 종료하세요. 창만 닫으면 백그라운드에서 설정을 계속 기록할 수 있습니다.

같은 PC에서 버전 변경하기와 다른 운영체제로 옮기기

Windows에서 인터페이스 버전 바꾸기
  • 기존 버전이 실제로 사용하는 데이터 폴더를 먼저 백업하세요. 프로그램 폴더에 사용 중인 guiConfigs가 있다면 JSON 파일 하나만 고르지 말고 폴더 전체를 백업하세요.
  • 가능하면 같은 릴리스 버전에 포함된 두 인터페이스 중에서 선택하세요. 새 버전을 먼저 단독 실행해 실제 데이터 위치를 확인한 다음 종료하고 새 데이터를 백업하세요.
  • 데이터 형식이 호환되는지 확인한 뒤 기존 데이터의 복사본을 복원하세요. 두 인터페이스가 같은 데이터를 동시에 읽고 쓰지 않도록 하고, 이전 코어 실행 파일을 새 버전에 덮어쓰지 마세요.
macOS 또는 Linux로 옮기기
  • 기존 버전에서「구독 그룹」→「구독 그룹 설정」으로 이동해 구독 주소를 기록하세요. 직접 추가한 노드는 따로 내보내거나 정보를 기록해 두세요.
  • 먼저 새 운영체제에 맞는 아키텍처의 클라이언트를 설치한 뒤 구독과 노드를 복원하세요. Windows의 절대 경로, 자동 시작 설정, 코어 프로그램 파일은 그대로 복사하지 마세요.
  • 「설정」→「라우팅 설정」에서 사용자 지정 규칙과 규칙이 참조하는 로컬 파일을 확인하고 새 운영체제의 경로로 다시 지정하세요.

두 방법 모두 원본 백업을 보관하세요. 구독 주소와 노드 공유 링크에는 접속 정보가 포함될 수 있으므로 공개 스크린샷이나 로그에 올리지 마세요.

버전 변경 후 노드, 포트, 라우팅 확인하기

새 버전이 기존 데이터를 읽었는지 먼저 확인한 다음 시스템 프록시를 활성화하세요. 문제가 생기면 설정 이전 누락인지, 코어가 실행되지 않은 것인지, 앱이 올바른 프록시 주소를 사용하지 않는 것인지 구분하기 쉽습니다.

  1. 그룹과 현재 노드 확인.구독 그룹 이름, 직접 추가한 노드, 현재 선택된 노드를 확인하세요. 목록이 비어 있다면 구독을 삭제하거나 기존 버전을 덮어쓰기 전에 새 버전이 예상한 데이터 폴더를 읽는지 먼저 확인하세요.
  2. 연결 포트와 로그 확인.「설정」→「매개변수 설정」에서 로컬 리스닝 포트를 확인하세요. 로그에 address already in use가 표시되면 기존 버전과 해당 코어 프로세스가 완전히 종료됐는지 확인하세요. 포트를 변경해야 한다면 프록시 주소를 직접 입력한 앱에서도 값을 바꾸고 HTTP인지 SOCKS인지 확인하세요.
  3. 같은 목적지로 라우팅 확인.필요한 시스템 프록시 모드를 켠 뒤 원래 직접 연결되어야 하는 도메인 하나와 프록시를 거쳐야 하는 도메인 하나를 각각 테스트하세요. 페이지가 열리는 것만으로는 요청이 성공했다는 사실만 알 수 있습니다. 실제 연결 경로는 코어 로그와 현재 활성화된 라우팅 규칙을 함께 확인하세요. 터미널에서만 문제가 재현된다면 터미널 프로그램이 시스템 프록시를 사용하는지, 별도 프록시 환경 변수가 설정되어 있는지 확인하세요.

버전 변경 관련 자주 묻는 질문

WPF 버전이 잘 작동하는데 Avalonia로 바꿔야 하나요?

인터페이스만 바꾸기 위해 이전할 필요는 없습니다. 필요한 것이 새 코어 지원인지, 크로스 플랫폼 인터페이스인지 먼저 확인하세요. 코어만 바꾸려는 경우 현재 클라이언트가 지원하는 코어와 버전을 확인하면 됩니다. 다른 인터페이스를 시험해 보려면 기존 버전과 백업을 보관하고, 기존 버전을 종료한 다음 새 버전을 실행하세요.

새 버전을 열었더니 .NET이 없다고 합니다. 최신 버전을 설치하면 되나요?

반드시 그렇지는 않습니다. 오류에 나온 프레임워크 이름, 필요한 버전, 아키텍처를 먼저 확인하세요. PC에 더 높은 주 버전이 설치되어 있는지만 확인해서는 안 됩니다. 릴리스 페이지에 PC에 맞는 자체 포함 패키지가 있다면 선택할 수도 있습니다. 이 패키지에 필요한 .NET 런타임을 따로 설치하지 않아도 됩니다.

구독과 노드는 있는데 브라우저에서 프록시가 작동하지 않는 이유는 무엇인가요?

로그에서 코어가 실행 중인지 확인한 다음 트레이 메뉴의「시스템 프록시」가 필요한 모드로 설정되어 있는지 살펴보세요. 브라우저에서 프록시를 따로 지정했다면 포트와 프록시 유형도 확인하세요. 인터페이스를 바꿔도 브라우저에 직접 입력한 이전 주소는 자동으로 변경되지 않습니다.

버전을 바꾼 뒤 라우팅이 잘못되면 어떻게 이전 버전으로 돌아가나요?

새 버전의 시스템 프록시를 끄고 새 버전을 종료한 다음 기존 버전을 실행하세요. 시험 사용 중 기존 버전의 데이터 폴더를 수정했다면 버전 변경 전에 따로 보관한 백업으로 복원하세요. 새 버전이 기록한 데이터베이스를 기존 버전에서 그대로 읽게 하지 마세요. 마지막으로 기존 라우팅 규칙과 노드를 다시 선택한 뒤 시스템 프록시를 켜세요.

v2rayN 다운로드플랫폼에 맞는 클라이언트 선택