이 글은 v2rayN을 다운로드하려는 사용자, WPF 버전에서 이전하려는 사용자, Windows·macOS·Linux에서 사용 방식을 통일하려는 사용자를 위한 안내입니다. 두 버전에 적합한 환경을 판단하고 구독, 라우팅, 포트, 시스템 프록시 설정을 단계별로 이전할 수 있습니다.
Avalonia 데스크톱 버전과 WPF 버전이란?
v2rayN의 두 데스크톱 인터페이스는 서로 완전히 별개의 클라이언트가 아닙니다. 두 버전 모두 서버 설정, 구독 그룹, 라우팅 규칙, 프록시 코어, 시스템 프록시 상태를 관리합니다. 주요 차이는 그래픽 인터페이스 기술과 운영체제 대응 방식에서 비롯됩니다. 다운로드 페이지에서 말하는 ‘데스크톱 버전’은 일반적으로 Avalonia로 만든 크로스 플랫폼 인터페이스를 뜻하며, ‘WPF 버전’은 Windows Presentation Foundation으로 구축한 기존 Windows 인터페이스를 의미합니다.
Avalonia는 동일한 주요 인터페이스 로직을 Windows, macOS, Linux에서 실행할 수 있어 여러 운영체제에서 비슷한 사용 흐름을 원하는 사용자에게 적합합니다. WPF는 Windows 데스크톱 기술에 의존하므로 Windows만 지원하지만, Windows 알림 영역, 창 동작, 시스템 프록시와의 연동이 더 직접적이며 기존 v2rayN을 오래 사용한 사용자에게는 메뉴 위치도 익숙합니다.
두 숫자는 설정과 함께 이해해야 합니다. 10808은 많은 v2rayN 설정에서 사용하는 로컬 프록시 포트지만, 업그레이드하거나 백업을 가져온 뒤에는 다른 값이 유지될 수 있습니다. 127.0.0.1은 로컬 컴퓨터의 연결만 허용한다는 뜻입니다. 실제 포트는 「설정」→「매개변수 설정」에서 확인하고, 튜토리얼의 예시만 보고 브라우저나 다른 프로그램을 수정하지 마세요.
| 비교 항목 | Avalonia 데스크톱 버전 | WPF 버전 |
|---|---|---|
| 실행 플랫폼 | Windows、macOS、Linux | Windows |
| 인터페이스 기술 | Avalonia 크로스 플랫폼 인터페이스 | Windows WPF 인터페이스 |
| 적합한 신규 설치 환경 | 크로스 플랫폼 사용, 일관된 사용 방식 | Windows만 사용, 기존 방식 유지 |
| 시스템 연동 | 운영체제별로 대응 | Windows 데스크톱 환경 중심 |
인터페이스와 실제 사용 경로의 차이
두 버전의 핵심 구성은 대체로 같습니다. 메인 창에는 서버 목록과 지연 시간이 표시되고, 구독 관리에는 원격 구독 주소를 저장하며, 라우팅 설정은 도메인이나 주소의 연결 경로를 결정합니다. 시스템 프록시 메뉴는 다른 애플리케이션의 트래픽을 v2rayN으로 보낼지 제어합니다. 차이는 기본 개념보다 버튼 배치, 마우스 오른쪽 버튼 메뉴, 대화상자 레이아웃, 트레이 메뉴 구조에 더 많이 나타납니다.
WPF 버전은 오랫동안 사용된 Windows 데스크톱 소프트웨어 레이아웃에 가깝고, 서버 목록이 주된 작업 공간인 경우가 많습니다. 여러 명령은 목록의 마우스 오른쪽 버튼 메뉴나 상단 메뉴에서 실행할 수 있습니다. Avalonia 데스크톱 버전은 운영체제별 창 규칙을 함께 고려하므로 컨트롤 간격, 대화상자 스타일, 단축키 반응, 알림 영역 표시가 WPF 버전과 다를 수 있습니다. 기존 스크린샷을 참고할 때는 버튼 위치만 보지 말고 명령 이름으로 메뉴를 찾으세요.
Avalonia 데스크톱 버전
추천세 가지 데스크톱 시스템을 지원하며 주요 기능의 정보 구조가 비슷해, 운영체제를 바꿀 때 다시 익혀야 할 내용이 적습니다.
적합: 신규 설치, 크로스 플랫폼 업무, 일관된 인터페이스를 원하는 경우
WPF 버전
기존 Windows 사용 방식을 유지하며, 예전 설정 절차와 알림 영역 메뉴, 익숙한 사용 습관에 더 잘 맞습니다.
적합: Windows 고정 환경, 기존 버전 유지, 이전 비용을 줄이는 것이 우선인 경우
자주 하는 작업에서 찾아야 할 명령
- 구독 추가: 「구독 그룹 설정」 또는 이에 해당하는 구독 관리 메뉴를 찾으세요. 주소를 저장한 뒤 구독 업데이트를 실행해야 하며, 구독 주소를 개별 서버 주소로 바로 가져오면 안 됩니다.
- 로컬 포트 변경: 「설정」→「매개변수 설정」으로 이동해 로컬 수신 포트와 LAN 접근 옵션을 확인하세요. 메뉴의 마지막 단계 이름은 버전에 따라 달라질 수 있지만, 주요 진입점은 매개변수 설정입니다.
- 라우팅 전환: 라우팅 설정이나 트레이 메뉴에서 기존 규칙을 선택하세요. 전체, 직접 연결, 규칙 기반 분할은 적용 범위가 다르며, 버전을 바꾼다고 규칙의 의미가 자동으로 변경되지는 않습니다.
- 시스템 프록시 활성화: 먼저 사용 가능한 서버를 선택하고 코어를 시작한 다음 시스템 프록시 모드를 설정하세요. 메인 프로그램을 실행하는 것만으로 시스템 트래픽이 프록시를 통과하는 것은 아닙니다.
- 문제 정보 확인: 로그 영역을 열고 먼저 코어가 실행되었는지 확인한 뒤 포트 충돌, 설정 파싱, 연결 핸드셰이크 정보를 점검하세요.
결론: 명령 이름을 기준으로 찾고, 오래된 스크린샷을 그대로 따라 하지 마세요
Avalonia와 WPF는 메뉴 위치가 다를 수 있지만 ‘구독, 매개변수 설정, 라우팅, 시스템 프록시, 로그’라는 다섯 가지 작업은 안정적으로 유지됩니다. 이전할 때는 스크린샷의 좌표보다 작업 이름으로 메뉴를 찾는 편이 더 정확합니다.
핵심 기능은 완전히 동일한가?
인터페이스 프레임워크가 VMess, VLESS, 라우팅 분할, TLS 같은 프로토콜 기능을 정의하는 것은 아닙니다. 실제 연결은 클라이언트가 호출하는 프록시 코어가 담당하고, v2rayN은 설정을 생성하고 코어를 실행하며 상태를 표시합니다. 따라서 특정 노드를 사용할 수 있는지 판단할 때는 v2rayN 버전, 선택한 코어, 서버 매개변수, 실행 플랫폼을 함께 확인해야 하며, 인터페이스가 Avalonia인지 WPF인지만 봐서는 안 됩니다.
구독 가져오기, 서버 수동 추가, 지연 시간 테스트, 활성 설정 전환, 로그 확인, 시스템 프록시 설정은 두 경로 모두에서 제공해야 하는 기본 기능입니다. 다만 새 기능은 한 경로에서 먼저 인터페이스 대응이 완료될 수 있고, 복잡한 설정의 컨트롤 이름도 일시적으로 다를 수 있습니다. 특히 관리자 권한, 가상 네트워크 인터페이스, 시스템 수준 시작 항목이 필요한 기능은 운영체제의 권한 모델에 영향을 받으므로 Windows의 결과만으로 macOS나 Linux를 판단할 수 없습니다.
| 기능 | 두 버전의 관계 | 확인할 핵심 항목 |
|---|---|---|
| VMess 및 VLESS 설정 | 선택한 코어가 모두 처리 | 주소, 포트, 전송 계층, TLS 및 SNI 매개변수 |
| 구독 업데이트 | 두 버전 모두 구독 그룹 관리 가능 | 구독 주소, 업데이트 방식, 그룹 필터 결과 |
| 라우팅 분할 | 두 버전 모두 라우팅 설정 생성 가능 | 규칙 순서, 매칭 범위, 최종 아웃바운드 |
| 시스템 프록시 | 목표는 같지만 구현은 시스템에 의존 | 프록시 모드, 로컬 포트, 시스템 권한 |
| 시작 시 자동 실행 및 알림 영역 | 운영 방식은 플랫폼에 따라 다름 | 시스템 승인, 데스크톱 환경, 백그라운드 실행 상태 |
포트와 LAN 접근은 별도로 확인해야 합니다
- 「설정」→「매개변수 설정」을 열고 현재 로컬 프록시 포트를 기록하세요. 일반적인 설정은 10808이지만, 기존 백업에는 10809나 사용자 지정 포트가 남아 있을 수 있습니다.
- 수신 주소를 확인하세요. 127.0.0.1은 로컬 컴퓨터에서만 사용할 수 있습니다. LAN 기기에서 연결하려면 LAN 접근 허용을 명확히 활성화하고 운영체제 방화벽도 설정해야 합니다.
- 브라우저, 다운로드 도구 또는 개발 도구에 고정 입력된 프록시 포트를 확인하세요. 클라이언트의 포트가 바뀌어도 이러한 독립 설정은 자동으로 동기화되지 않습니다.
- 코어를 시작한 뒤 로그에서 ‘포트가 이미 사용 중’과 같은 오류가 없는지 확인하고, 시스템 프록시로 전환한 다음 대상 사이트에 접속해 테스트하세요.
결론: 인터페이스가 같아도 시스템 동작이 완전히 같다는 뜻은 아닙니다
구독과 라우팅은 이전할 수 있지만 시스템 프록시, 백그라운드 실행, 권한 요청, 방화벽 규칙은 각 기기에서 다시 확인해야 합니다. 크로스 플랫폼 이전에서는 ‘설정 데이터’와 ‘시스템 연동’을 두 그룹으로 나누어 처리하세요.
Windows·macOS·Linux에서는 어떻게 선택해야 하나?
Windows 사용자는 두 가지를 선택할 수 있습니다. 처음 설치하거나 다른 데스크톱 시스템과 인터페이스 흐름을 통일하고 싶다면 Avalonia 데스크톱 버전을 먼저 사용해 보세요. WPF 버전을 오랫동안 사용해 왔고 현재 구독, 라우팅, 트레이 조작이 안정적이며 크로스 플랫폼 요구가 없다면 WPF 버전을 계속 사용하는 편이 메뉴와 창 동작을 다시 익히는 비용을 줄일 수 있습니다.
macOS와 Linux 사용자는 WPF 버전이 Windows 데스크톱 실행 환경에 의존하므로 Avalonia 데스크톱 버전을 선택해야 합니다. 다운로드할 때는 프로세서 아키텍처도 맞춰야 하며, 해당 플랫폼의 실행 및 권한 안내를 확인하세요. Linux의 알림 영역, 시작 시 자동 실행, 시스템 프록시 동작은 데스크톱 환경의 영향을 받을 수 있고, macOS는 처음 실행할 때 시스템이 요구하는 애플리케이션 권한을 허용해야 합니다.
- Windows 신규 사용자: 먼저 Avalonia 데스크톱 버전을 선택하고, 구독을 가져온 뒤 지연 시간 테스트, 시스템 프록시, 라우팅을 확인하세요. 특정 Windows 작업 흐름에 맞지 않으면 WPF 버전과 비교해 보세요.
- Windows 기존 사용자: 안정성이 우선이라면 WPF 버전을 유지하세요. 이전하기 전에는 설정을 내보내고 매개변수 설정의 로컬 포트를 기록하세요.
- macOS 사용자: Avalonia 데스크톱 버전을 선택하고 기기의 프로세서 아키텍처에 맞는 파일을 다운로드한 뒤, 처음 실행한 후 시스템 프록시가 실제로 적용되었는지 확인하세요.
- Linux 사용자: Avalonia 데스크톱 버전을 선택하세요. 클라이언트 설정뿐 아니라 데스크톱 환경의 알림 영역 지원, 파일 실행 권한, 프록시 설정 메뉴도 확인해야 합니다.
요구 사항에 따른 최종 판단
| 사용 목적 | 권장 버전 | 이유 |
|---|---|---|
| 세 가지 데스크톱 시스템에서 비슷한 흐름 사용 | Avalonia 데스크톱 버전 | 인터페이스 로직이 크로스 플랫폼으로 통일되어 기기를 바꿔도 기능을 찾기 쉽습니다 |
| Windows에서 기존 사용 방식 유지 | WPF 버전 | 기존 메뉴, 창, 알림 영역 흐름이 더 익숙합니다 |
| v2rayN을 처음 설치 | Avalonia 데스크톱 버전 우선 | 처음부터 크로스 플랫폼 경로를 사용해 나중에 다시 적응할 필요를 줄입니다 |
| 복잡한 Windows 설정을 이미 사용 중 | WPF 버전을 유지하면서 병행 테스트 | 구독, 라우팅, 포트, 시스템 프록시를 확인한 뒤 이전합니다 |
WPF 버전에서 Avalonia 데스크톱 버전으로 이전하는 점검 절차
이전의 핵심은 서버를 하나씩 다시 추가하는 것이 아니라 설정 데이터를 보존하고 두 프로그램이 동시에 시스템 프록시를 변경하지 않도록 하는 데 있습니다. 시작하기 전에 자동 실행과 시스템 프록시를 끄고 현재 활성 서버, 구독 그룹, 라우팅 방식, 로컬 포트, 코어 선택을 기록하세요. 복잡한 사용자 지정 규칙은 별도로 보관해 이전 후 하나씩 대조할 수 있게 하세요.
두 버전을 짧은 기간 병행 테스트해야 한다면 10808처럼 동일한 수신 포트를 함께 사용하지 마세요. 포트 충돌이 발생하면 나중에 시작한 코어가 실패할 수 있지만, 인터페이스에는 선택한 서버 상태가 그대로 표시될 수 있습니다. 테스트할 때는 한 번에 한 버전만 실행하거나 테스트 버전을 다른 포트로 설정하고, 브라우저가 현재 어느 포트에 연결되어 있는지 명확히 확인하세요.
- 기존 버전 연결 중지: WPF 버전에서 시스템 프록시를 끄고 코어를 종료한 뒤, 알림 영역에 남아 있는 실행 인스턴스가 없는지 확인하세요.
- 설정 정리: 사용 가능한 설정을 내보내고 구독 그룹 이름, 라우팅 규칙, 로컬 포트, LAN 접근 상태를 기록하세요.
- 호환 버전 설치: Windows, macOS 또는 Linux와 프로세서 아키텍처에 맞춰 Avalonia 데스크톱 버전을 선택하세요.
- 구독 및 서버 복원: 먼저 설정을 가져온 다음 구독을 업데이트하고 서버 수와 그룹이 예상대로인지 확인하세요.
- 매개변수 복원: 「설정」→「매개변수 설정」으로 이동해 127.0.0.1, 10808 등의 수신 매개변수를 확인하세요. 가져오기 과정에서 프로그램 설정이 모두 덮어써진다고 가정하지 마세요.
- 라우팅 확인: 기존에 사용하던 라우팅 방식을 선택하고 직접 연결 주소와 프록시가 필요한 주소를 각각 테스트해 규칙이 올바르게 적용되는지 확인하세요.
- 마지막으로 시스템 프록시 활성화: 코어 로그가 정상이고 포트 충돌이 없는지 확인한 뒤 시스템 프록시를 켜고 자주 사용하는 애플리케이션을 검증하세요.
자주 묻는 선택 및 이전 문제
다음 문제는 대개 프로토콜 자체의 장애가 아니라 버전 선택 오류, 포트 충돌, 시스템 프록시 상태 미동기화 때문에 발생합니다. 구독을 반복해서 삭제하기보다 증상에 따라 확인하는 편이 원인을 찾기 쉽습니다.
Windows에서는 반드시 Avalonia 데스크톱 버전으로 바꿔야 하나요?
강제로 이전할 필요는 없습니다. WPF 버전이 안정적으로 실행되고 현재 요구 사항을 충족한다면 계속 사용해도 됩니다. 크로스 플랫폼 일관성이 필요하거나 새 인터페이스 경로를 사용하려는 경우 이전 목록에 따라 Avalonia 데스크톱 버전을 테스트하세요.
두 버전을 동시에 설치할 수 있나요?
비교를 위해 두 프로그램을 모두 보관할 수는 있지만, 코어를 동시에 실행하거나 시스템 프록시를 동시에 제어해서는 안 됩니다. 각각의 「설정」→「매개변수 설정」에서 포트를 확인해 두 인스턴스가 모두 10808을 수신하지 않도록 하세요.
구독을 가져온 뒤 서버 목록이 비어 있으면 어떻게 하나요?
먼저 구독 주소가 완전한지 확인한 뒤 구독 업데이트를 실행하고 로그를 확인하세요. 그룹 필터를 사용 중이라면 키워드 필터를 지우고 다시 확인하세요. 그래도 비어 있다면 현재 버전이 구독 응답 형식을 인식할 수 있는지 점검하세요.
이전 후 연결됨으로 표시되지만 웹페이지가 열리지 않으면 어떻게 하나요?
먼저 코어 로그와 시스템 프록시 상태를 확인한 다음 로컬 포트를 점검하세요. 브라우저가 127.0.0.1:10808을 고정 사용하고 있는데 새 버전이 다른 포트를 사용하면 인터페이스에는 연결됨으로 표시되지만 애플리케이션에 접속할 수 없습니다.
Avalonia 버전과 WPF 버전에서 노드 속도가 달라지나요?
인터페이스 프레임워크는 일반적으로 속도를 결정하는 주요 요인이 아닙니다. 동일한 서버, 동일한 코어, 동일한 프로토콜 매개변수, 동일한 라우팅 규칙으로 비교하고 네트워크 품질, 서버 부하, 전송 설정을 우선 확인하세요.
요약하면 macOS와 Linux는 Avalonia 데스크톱 버전을 바로 선택하면 됩니다. Windows 신규 사용자는 Avalonia 데스크톱 버전으로 시작하는 것이 좋고, 기존 인터페이스를 오래 사용했으며 작업 흐름이 안정적인 Windows 사용자는 WPF 버전을 계속 사용할 수 있습니다. 어느 경로를 선택하든 구독 업데이트, 코어 실행, 라우팅 결과, 로컬 포트, 시스템 프록시를 실제로 확인한 결과를 기준으로 판단하세요.