Windows x64에 처음 설치한다면 Desktop으로 표시된 Avalonia 버전부터 사용해 보세요. WPF 버전을 문제없이 사용 중이라면 화면만 바꾸려고 옮길 필요는 없습니다. macOS와 Linux에서는 Avalonia를 선택하고 CPU 아키텍처와 패키지 형식을 확인하세요. 버전을 바꾼 뒤에는 로컬 프록시부터 테스트하고 시스템 프록시와 라우팅 설정을 확인하세요. 설정 차이를 프레임워크 차이로 오해하지 않는 것이 중요합니다.
Windows x64: Desktop과 WPF 중 무엇을 선택할까
다운로드 페이지의 Desktop과 WPF는 데스크톱 UI 두 종류를 가리키며, 프록시 프로토콜의 차이가 아닙니다. Avalonia 버전은 여러 데스크톱 운영체제에서 사용할 수 있고, WPF 버전은 기존 Windows 인터페이스를 유지합니다. 메뉴 위치, 트레이 조작, 목록 사용 방식, 화면 배율은 버전에 따라 다를 수 있습니다. 설정 이름이 비슷하더라도 다른 버전의 화면을 보며 버튼 위치를 하나씩 맞춰 찾을 필요는 없습니다.
Avalonia(Desktop) 버전
추천처음 설치한다면 Desktop 버전부터 시작해 보세요. 다른 macOS 또는 Linux 컴퓨터에서도 사용할 예정이라면 동일한 인터페이스에 익숙해지는 것이 도움이 됩니다. 다만 시스템 프록시와 권한은 운영체제별로 설정해야 합니다.
추천 대상: Windows x64 첫 설치, 여러 데스크톱 운영체제에서 사용
WPF 버전
현재 버전의 트레이 조작, 단축키, 화면 배율에 익숙하다면 그대로 사용하는 편이 버전을 바꾼 뒤 설정을 다시 점검하는 것보다 간편합니다.
추천 대상: 안정적으로 사용 중인 설정이 있고 기존 Windows 인터페이스를 선호하는 경우
Windows의 「설정」→「시스템」→「정보」에서 「시스템 종류」를 확인하세요. ‘64비트’ 표시만 확인해서는 안 됩니다. x64 기반 프로세서와 ARM 기반 프로세서는 아키텍처가 다릅니다. 이 사이트의 Windows 다운로드는 x64용입니다. ARM 기기에서 정상적으로 실행되는지는 시스템의 호환성과 해당 버전의 실행 요건에 따라 달라집니다. 실행할 때 런타임 구성요소가 없다는 오류가 뜨면 오류에 표시된 구성요소 이름을 적어 두고 다운로드한 버전의 안내와 비교하세요. 두 UI 버전을 무작정 다시 설치할 필요는 없습니다.
macOS와 Linux: 아키텍처와 패키지 형식 확인
두 운영체제 모두 Avalonia를 선택하되, 설치 전 확인할 항목은 다릅니다
macOS: 먼저 칩 확인
- 「이 Mac에 관하여」에서 「칩」 또는 「프로세서」를 확인하세요. Apple 칩은 arm64, Intel 프로세서는 x64를 선택합니다.
- 해당 다운로드에는 DMG가 제공됩니다. 설치 후 클라이언트가 실행되는지 확인하고, 사용 중인 네트워크 서비스에 프록시 설정이 적용되어 있는지 점검하세요.
Linux: 배포판과 시스템 아키텍처 확인
- Debian·Ubuntu 계열은 보통 DEB를 선택합니다. Fedora 등 RPM을 사용하는 배포판은 RPM을 선택하고, 릴리스 안내의 의존성 요건도 확인하세요.
uname -m결과가x86_64이면 x64,aarch64이면 arm64에 해당합니다. 시스템 사용자 공간과 설치 패키지의 아키텍처가 일치하는지도 확인하세요.
크로스 플랫폼 지원은 여러 운영체제에서 UI를 실행할 수 있다는 뜻이지, 하나의 설치 파일을 모든 운영체제에서 사용할 수 있다는 뜻은 아닙니다.
Linux 데스크톱의 프록시 설정이 모든 앱에 적용되는 것은 아닙니다. 그래픽 브라우저, 터미널 도구, 백그라운드 서비스가 서로 다른 프록시 설정을 참조할 수 있습니다. 브라우저에서는 연결되지만 터미널에서는 안 된다면 터미널 도구가 실제로 어떤 설정을 읽는지 먼저 확인하세요. macOS에서도 시스템 프록시와 앱에서 직접 지정한 프록시를 구분해야 합니다. Wi-Fi와 유선 네트워크를 바꾼 뒤 동작이 달라진다면 클라이언트 창의 상태만 보지 말고 현재 네트워크 서비스를 점검하세요.
기능과 성능: UI, 코어, 트래픽 진입점을 구분하세요
UI는 설정 편집, 구독 관리, 로그 표시를 담당합니다. 실제 프록시 연결 처리는 Xray 같은 선택된 코어가 맡습니다. 기능을 비교할 때는 먼저 양쪽 클라이언트와 코어의 버전을 기록한 뒤 사용 중인 설정, 라우팅 모드, 트래픽 진입점을 확인하세요. 설치 패키지의 버전이 다르면 특정 버튼이 있는지 여부만으로 어느 프레임워크가 해당 기능을 지원하는지 판단할 수 없습니다. 시스템 프록시와 Tun도 서로 다른 진입점입니다. 시스템 프록시는 앱이 프록시 설정을 따르는지에 달려 있고, Tun은 가상 인터페이스와 운영체제 권한, 라우팅 변경까지 고려해야 합니다.
버전을 바꾼 뒤 로컬 연결부터 테스트하고 시스템 프록시를 켜세요
클라이언트의 「설정」→「매개변수 설정」에서 로컬 리스닝 설정을 확인한 다음, 수동 프록시를 지원하는 앱 하나를 해당 주소와 포트에 연결하세요. 프록시 유형도 실제 인바운드 설정과 일치해야 합니다. 예를 들어 설정이 SOCKS만 제공한다면 같은 포트를 HTTP 프록시 입력란에 넣지 마세요. 수동 연결은 되지만 시스템 프록시를 켠 뒤 문제가 생긴다면 앱이 시스템 설정을 따르는지 먼저 확인하세요.
속도를 비교하려면 같은 컴퓨터, 연결 설정, 코어와 버전, 테스트 대상을 사용하고 한 번에 클라이언트 하나만 실행해 측정하세요. 작업 관리자의 UI 프로세스 메모리 사용량, 목록 클릭 반응 시간, 실제 다운로드 속도는 서로 다른 지표입니다. 다운로드 속도가 한 번 흔들렸다고 특정 UI가 더 빠르다고 단정할 수 없습니다. 창 조작만 느리다면 프록시 설정을 함께 바꾸지 말고 고해상도 화면 배율과 긴 목록의 스크롤을 따로 확인하세요.
WPF에서 Avalonia로 전환하기: 백업 및 확인 순서
- 기존 버전 상태를 기록하세요. 클라이언트와 코어 버전, 현재 선택된 설정, 구독 그룹, 사용자 지정 라우팅, 로컬 포트, 시스템 프록시 상태를 적어 두세요. 현재 버전의 내보내기 기능을 사용할 수 있습니다. 기존 버전이 실제로 사용하는 데이터 폴더도 별도로 백업하세요. 설치 폴더가 데이터 폴더라고 단정하지 마세요. 구독 주소에 접근 자격 증명이 포함될 수 있으므로 직접 관리하는 안전한 위치에 보관하세요.
- 기존 버전을 종료한 뒤 새 버전을 실행하세요. 주 창만 닫지 말고 트레이 메뉴에서 기존 클라이언트를 완전히 종료하세요. 두 프로세스가 같은 로컬 포트를 사용하면 새 버전이 리스닝하지 못할 수 있습니다. 포트를 다르게 지정하더라도 양쪽에서 시스템 프록시를 동시에 변경하면 문제 원인을 찾기 어려워집니다. 새 버전을 처음 실행할 때는 트래픽을 자동으로 가져오지 않도록 하세요.
- 새 버전에서 지원하는 방식으로 가져오세요. 빠른 시작의 가져오기 안내를 참고해 자주 사용하는 설정이나 구독 하나를 먼저 복원한 다음 사용자 지정 규칙을 추가하세요. 구독 업데이트에 성공했다는 것은 목록을 가져왔다는 뜻일 뿐, 기존의 로컬 라우팅, 포트, 선택 항목까지 복원됐다는 의미는 아닙니다. 버전 간 이전을 할 때 새 버전의 설정 폴더 전체를 그대로 덮어쓰지 마세요.
- 항목별로 확인하고 되돌릴 방법을 남겨 두세요. 먼저 코어 시작 로그를 확인하고 로컬 프록시를 테스트한 뒤 시스템 프록시를 켜세요. 기존에 Tun을 사용했다면 마지막에 별도로 점검하세요. 이전 버전으로 되돌리려면 새 버전에서 활성화한 트래픽 처리 기능을 끄고 종료한 다음 기존 버전을 복원하세요. 네트워크 문제가 계속되면 시스템 프록시가 더 이상 리스닝하지 않는 로컬 포트를 가리키는지 확인하세요.
버전 선택 및 전환 관련 자주 묻는 질문
Windows 한 대에 두 버전을 모두 설치해도 되나요?
비교를 위해 두 버전을 함께 둘 수 있습니다. 다만 설치 경로가 다르다고 설정까지 분리된다고 단정하지 말고 각 버전의 데이터 위치를 확인하세요. 실제로 테스트할 때는 한쪽의 시작 시 자동 실행을 끄고 트레이에서 완전히 종료한 다음 다른 버전을 실행하세요.
새 버전에 목록은 보이는데 브라우저에서 웹페이지가 열리지 않아요. 어떻게 해야 하나요?
먼저 로그에서 코어가 시작됐는지, 리스닝 실패가 없는지 확인하세요. 그런 다음 브라우저가 시스템 프록시를 따르는지, 수동 설정을 사용하는지, 확장 프로그램이 설정을 덮어쓰는지 살펴보세요. 브라우저가 여전히 이전 포트를 가리킨다면 새 버전이 실제로 리스닝 중인 포트로 바꾸고 프록시 프로토콜도 일치하는지 확인하세요.
기존 구독은 그대로인데 라우팅 결과가 왜 달라졌나요?
현재 활성화된 라우팅 설정, 규칙 순서, 기본 아웃바운드를 먼저 확인하고 앱의 트래픽이 실제로 로컬 프록시를 통과하는지도 점검하세요. 구독에서 제공하는 연결 목록과 클라이언트에 저장된 사용자 지정 라우팅은 별개입니다. 라우팅 설정 참고를 보며 항목별로 확인하세요.
Linux 패키지를 설치했는데 트레이 아이콘이 보이지 않아요. 왜 그런가요?
먼저 앱 메뉴에서 주 창을 다시 열어 프로세스가 실행 중인지 확인하세요. 주 창은 정상적으로 표시되지만 트레이 항목이 없다면 현재 데스크톱 환경이 상태 아이콘을 지원하고 활성화했는지 확인하세요. 문제를 살펴보는 동안 트레이에서만 종료하려 하지 말고, 아이콘이 보이지 않는 것을 코어 시작 실패로 오해하지도 마세요.