macOS와 Linux에서는 해당 운영체제용 Avalonia 빌드를 선택하세요. Windows에서는 기존 사용 방식, 시스템 연동, 실행 환경을 고려하면 됩니다. 두 인터페이스의 차이가 노드 속도나 프로토콜 지원을 직접 결정하지는 않습니다. 설치 파일 확인, 트레이와 시스템 프록시, 실행 종속성, 설정 이전 순으로 살펴봅니다. 처음 설치하거나 버전을 바꾸려는 데스크톱 사용자에게 유용한 내용입니다.
Avalonia와 WPF: 인터페이스와 프록시 코어 구분하기
Avalonia와 WPF는 모두 데스크톱 인터페이스 기술입니다. WPF는 Windows용이며 Avalonia는 여러 플랫폼을 지원합니다. 따라서 v2rayN은 운영체제에 따라 Windows, macOS, Linux용 빌드를 제공할 수 있습니다. 다운로드 페이지의 인터페이스별 빌드는 창 표시 방식, 입력 동작, 트레이 및 시스템 기능 연동에 주로 영향을 줍니다. 프록시 프로토콜이 달라지는 것은 아닙니다.
v2rayN은 서버, 구독, 라우팅 규칙, 로컬 프록시 진입점을 관리하고, 실제 연결 처리는 선택한 프록시 코어가 담당합니다. VLESS, VMess, REALITY 설정을 사용할 수 있는지는 코어 버전, 노드 매개변수, 클라이언트의 해당 항목 지원 여부를 확인해야 합니다. Avalonia나 WPF라는 표기만으로 판단할 수 없습니다.
Avalonia 크로스 플랫폼 데스크톱 버전
추천여러 운영체제에서 사용할 때 우선 고려할 만한 버전입니다. 운영체제가 달라도 비슷한 방식으로 조작할 수 있습니다. 다만 운영체제와 프로세서 아키텍처에 맞는 빌드를 각각 다운로드하고, 해당 릴리스의 시스템 요구 사항도 확인해야 합니다.
추천 대상: macOS 또는 Linux 사용자, 여러 운영체제가 설치된 컴퓨터를 오가며 사용하는 사용자
Windows WPF 버전
Windows용 인터페이스 버전입니다. 서버 목록, 트레이 메뉴, 바로 가기 조작 방식에 익숙하고 현재 안정적으로 사용 중이라면 그대로 사용해도 됩니다. 인터페이스만 바꾸기 위해 이전할 필요는 없습니다.
추천 대상: Windows만 사용하며 익숙한 조작 방식과 현재 작업 환경을 유지하고 싶은 사용자
여기서 추천하는 기준은 크로스 플랫폼 지원 여부입니다. 모든 Windows PC에서 Avalonia가 메모리를 덜 쓰거나 더 빠르다는 뜻은 아닙니다. 같은 노드를 사용해도 코어 버전, 라우팅, DNS, 연결 모드에 따라 인터페이스 차이보다 훨씬 큰 차이가 생길 수 있습니다.
설치 파일 선택: 운영체제, 아키텍처, 종속성 순으로 확인
먼저 운영체제를 확인하고, 다음으로 프로세서 아키텍처를 확인한 뒤 실행 환경 포함 여부를 살펴보세요. 파일 크기만 보고 설치 파일을 고르거나, ‘크로스 플랫폼’이라는 이유로 같은 압축 파일이 모든 운영체제에서 바로 실행된다고 생각하면 안 됩니다. 다음 항목은 다운로드 전에 확인할 수 있습니다.
| 확인 항목 | 확인 위치 | 선택 기준 |
|---|---|---|
| Windows 시스템 종류 | ‘설정’ → ‘시스템’ → ‘정보’에서 ‘시스템 종류’ 확인 | x64와 ARM64용은 별도로 선택하세요. 64비트 운영체제라고 해서 프로세서가 반드시 x64인 것은 아닙니다. |
| macOS 프로세서 | Apple 메뉴 → ‘이 Mac에 관하여’에서 ‘칩’ 또는 ‘프로세서’ 확인 | Apple 칩은 ARM64, Intel 프로세서는 x64를 우선 선택하세요. 실제 릴리스에 표시된 정보를 기준으로 확인해야 합니다. |
| Linux 아키텍처 | 터미널에서 uname -m 실행 | x86_64는 일반적으로 x64, aarch64는 일반적으로 ARM64에 해당합니다. |
| 실행 환경 | 설치 파일 설명 및 실행 시 표시되는 종속성 안내 | 자체 포함 빌드와 시스템 런타임에 의존하는 빌드를 구분하세요. 파일명만 보고 추측하지 마세요. |
WPF라고 해서 구형 .NET Framework를 반드시 설치해야 하는 것은 아닙니다. 최신 WPF 앱도 최신 .NET을 기반으로 할 수 있습니다. 필요한 런타임 버전은 해당 버전의 실행 안내와 릴리스 정보를 확인하세요. Windows Desktop Runtime이 없다는 안내가 표시되면 일반 .NET Runtime만 설치해서는 해결되지 않을 수 있습니다.
Avalonia도 시스템 종속성이 전혀 없다는 뜻은 아닙니다. 자체 포함 빌드에는 일반적으로 필요한 .NET 런타임 구성 요소가 포함되지만, Linux에서는 그래픽, 글꼴 또는 기타 네이티브 라이브러리가 필요할 수 있습니다. 구형 시스템에 기반 구성 요소가 없다면 지원 범위를 먼저 확인한 뒤 종속성을 해결하세요. 아직 실행되지 않는 프로그램의 문제를 찾겠다며 노드를 반복해서 바꾸지는 마세요.
시스템 연동 비교: 트레이, 시스템 프록시, TUN을 따로 확인
창이 열리는 것은 그래픽 인터페이스가 실행된다는 뜻일 뿐입니다. 실제 사용 편의성은 창을 닫은 뒤의 동작, 트레이 메뉴, 시작 프로그램 등록, 시스템 프록시 설정에도 달려 있습니다. 버전에 따라 메뉴 위치가 달라질 수 있으므로 스크린샷만 비교하지 말고 실제 기능을 하나씩 확인하세요.
- 창과 트레이: 닫기 버튼을 눌렀을 때 프로그램이 종료되는지 트레이로 최소화되는지 확인하세요. 이어서 트레이에서 기본 창을 다시 열고 배율 조정, 한글 글꼴, 다중 모니터 간 이동이 정상인지 살펴보세요.
- 시스템 프록시: v2rayN의 시스템 프록시 메뉴에서 ‘시스템 프록시 자동 설정’을 선택한 뒤 Windows ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’에서 프록시 서버 주소와 포트를 확인하세요. 메뉴 이름은 설치한 버전에 따라 다를 수 있습니다.
- 시작 프로그램: 기능을 켠 뒤 프로그램을 완전히 종료하고 다시 로그인해 자동 실행 여부, 코어 실행 여부, 프록시 설정 복원 여부를 확인하세요. 이 세 가지는 각각 따로 점검해야 합니다.
- Linux 데스크톱 트레이: 트레이 아이콘 표시는 데스크톱 환경과 트레이 지원 여부에도 영향을 받습니다. 아이콘이 사라졌다고 해서 코어가 중지된 것은 아닐 수 있으므로 프로세스와 로그를 함께 확인하세요.
시스템 프록시 모드는 일반적으로 시스템 프록시 설정을 따르는 앱에만 영향을 줍니다. TUN 모드는 가상 네트워크 인터페이스, 라우팅, 권한과 관련이 있습니다. 사용 가능 여부는 운영체제, 클라이언트 빌드, 코어, 권한 설정에 따라 달라지므로 Avalonia나 WPF만으로 판단할 수 없습니다. 인터페이스 버전을 비교할 때는 먼저 TUN을 끄고 일반 로컬 프록시가 작동하는지 확인한 다음 TUN을 별도로 테스트하세요.
결론: 먼저 로컬 포트를 확인한 뒤 시스템 연동 점검
같은 활성 서버에서 로컬 프록시를 직접 지정하면 연결되지만 브라우저에서는 연결되지 않는다면 시스템 프록시 설정과 앱의 프록시 사용 여부부터 확인하세요. 인터페이스 버전이나 노드 프로토콜 탓으로 단정하지 마세요.
속도와 리소스 사용량: 제대로 비교하는 방법
‘어느 버전이 더 빠른가’는 인터페이스 반응 속도와 네트워크 전송 속도로 나눠 살펴봐야 합니다. 서버 목록 스크롤이나 창을 여는 시간은 인터페이스 경험에 해당합니다. 다운로드 속도, 핸드셰이크 실패, 웹페이지 시간 초과는 주로 네트워크 경로, 코어, 노드, 설정의 영향을 받습니다. 운영체제를 달리해 테스트하면 드라이버와 시스템 네트워크 스택 차이도 생기므로 UI 기술만의 영향이라고 볼 수 없습니다.
- 두 버전의 클라이언트와 실제 실행 중인 코어 버전을 기록하고, 같은 노드와 라우팅, DNS, 연결 모드를 사용하세요.
- 한 번에 한 버전만 실행하고 구독 업데이트, 속도 측정, 기타 다운로드 작업을 일시 중지하세요. 5분간 대기한 뒤 클라이언트 프로세스와 코어 프로세스의 메모리 및 CPU 사용량을 각각 기록하세요.
- 같은 대상으로 연결 테스트를 3회 연속 수행하고 성공률과 전체 소요 시간을 기록하세요. 측정값이 하나뿐이라면 일시적인 변동을 결론으로 삼지 마세요.
- 첫 번째 버전을 종료하고 코어 프로세스가 끝났는지, 로컬 포트가 해제됐는지 확인한 뒤 두 번째 버전을 실행해 반복 테스트하세요. 두 버전을 동시에 실행한 상태에서 사용량을 비교하지 마세요.
아래는 로컬 SOCKS 진입점을 테스트하는 명령입니다. 수신 주소는 127.0.0.1, 포트는 10808이며 해당 진입점이 SOCKS를 지원한다고 가정합니다. 클라이언트에 다른 포트가 표시된다면 먼저 값을 바꾸세요. Windows에서는 curl.exe, macOS와 Linux에서는 보통 curl을 사용합니다.
curl.exe --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 30 --output NUL --write-out "HTTP=%{http_code} total=%{time_total}s\n" https://example.com/
curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 30 --output /dev/null --write-out "HTTP=%{http_code} total=%{time_total}s\n" https://example.com/socks5h는 대상 호스트 이름 처리를 프록시 쪽에 맡기므로 이 특정 프록시 경로를 확인하는 데 적합합니다. 모든 앱의 DNS 동작을 대변하지는 않습니다. 연결 거부 오류가 발생하면 수신 포트와 코어 실행 여부를 먼저 확인하세요. 인증서나 핸드셰이크 오류가 나타나면 로그와 함께 시스템 시간, TLS 매개변수, 서버 설정을 확인하세요.
WPF에서 Avalonia로 전환하기: 복구 경로를 확보한 뒤 이전
같은 클라이언트의 인터페이스 버전이 다르더라도 모든 버전의 데이터 폴더와 설정 형식이 완전히 같다고 단정하면 안 됩니다. 여러 버전을 건너뛰면 데이터베이스나 설정이 업그레이드될 수 있습니다. 기존 파일을 덮어쓰기보다 이전 폴더를 보존하고 새 위치에서 확인하는 것이 가장 안전합니다.
이전 방법: 기존 버전은 보존하고 새 버전을 별도로 확인
기존 환경
- 클라이언트를 종료한 뒤 실제 사용 중인 데이터 폴더와 설정을 백업하세요.
- 구독 그룹, 활성 서버, 로컬 포트, 사용자 지정 라우팅을 기록하세요.
- 현재 버전 정보를 저장하고 포트 충돌을 막기 위해 자동 실행을 일시 중지하세요.
- 구독 주소에 접근 자격 증명이 포함될 수 있으므로 백업 파일에 대한 접근을 제한하세요.
새 환경
- 프로그램 폴더를 별도로 사용하고 이전 데이터 폴더를 공유하지 않는지 확인하세요.
- 해당 버전에서 지원하는 가져오기 기능을 우선 사용하거나 구독을 다시 추가하세요.
- 로컬 진입점, 라우팅, DNS, 시스템 프록시 상태를 다시 확인하세요.
- 연결, 재시작, 창 복원 테스트를 마친 뒤에 기존 버전을 교체할지 결정하세요.
운영체제를 넘나드는 이전은 구독과 명시적으로 내보낸 설정을 중심으로 진행하세요. 다른 운영체제의 코어 파일이 포함된 구형 프로그램 폴더 전체를 그대로 옮기지 마세요.
구독을 다시 추가하면 서버 목록은 복원할 수 있지만 사용자 지정 규칙, 바로 가기 키, 창 설정, 로컬 수신 포트까지 복원되는 것은 아닙니다. 이전 후에는 활성 서버를 다시 선택하세요. 노드가 목록에 보인다는 이유만으로 연결 설정이 끝났다고 판단하면 안 됩니다.
선택 후 실행되지 않거나 연결되지 않을 때: 단계별 문제 해결
두 인터페이스 버전을 번갈아 실행하는 것보다 ‘프로그램 시작, 코어 시작, 프록시 적용, 원격 연결’ 중 어느 단계에서 문제가 생기는지 확인하는 편이 효과적입니다. 오류 메시지는 전체 내용을 보관하되 구독 자격 증명, 서버 비밀번호 등 민감한 정보는 가리세요.
| 증상 | 우선 확인할 항목 | 다음 단계 |
|---|---|---|
| 실행 후 런타임 누락 안내가 표시됨 | 런타임 종류, 버전, 아키텍처 | 오류 안내에 맞는 실행 환경을 설치하거나 같은 운영체제용 자체 포함 빌드를 선택하세요. |
| 인터페이스는 정상이나 코어 시작 실패 | 코어 파일, 실행 권한, 수신 포트, 설정 로그 | 압축이 제대로 풀렸는지 확인하고 Linux에서는 실행 권한을 확인하세요. 포트 충돌도 점검하세요. |
| 수동 프록시는 되지만 브라우저에서는 연결되지 않음 | 시스템 프록시 상태, 브라우저 프록시 설정 | 주소와 포트를 확인하고 다른 프로그램이 설정을 덮어쓰지 않는지 점검하세요. |
| 특정 노드에서만 핸드셰이크 실패 | 해당 노드 매개변수, 코어 기능, 시스템 시간 | 서버 이름, 공개 키 등 해당 필드를 확인하세요. 먼저 인터페이스 버전을 바꾸지는 마세요. |
| 종료 후 네트워크 이상 발생 | 남아 있는 시스템 프록시 설정 또는 TUN 경로 | 기존 프록시 설정을 복원하고 클라이언트와 코어가 모두 종료됐는지 확인한 뒤 직접 연결을 테스트하세요. |
최종 선택은 간단하게 할 수 있습니다. macOS와 Linux에서는 해당 운영체제에 맞는 Avalonia 빌드를 사용하세요. Windows에 처음 설치한다면 다운로드 페이지에서 현재 제공하는 데스크톱 빌드로 시작하고, 안정적으로 작동하는 WPF 환경이 있다면 우선 유지하세요. 인터페이스, 시스템 연동, 실행 환경에 명확한 변경 이유가 있을 때만 되돌릴 수 있는 방식으로 이전하면 됩니다.