Windows용 WPF 인터페이스를 사용하는 클래식 안정 버전입니다. 기존 창 레이아웃과 메뉴, 트레이 조작 방식에 익숙하다면 평소 사용 방식에 맞춰 선택하세요.
zip 압축 파일 · Windows 전용 인터페이스
설치한 다음 구독 가져오기
다운로드한 zip 파일의 압축을 로컬 폴더에 완전히 푼 다음, 폴더 안의 설치 프로그램을 실행하세요. 압축 파일 미리보기 창에서 바로 실행하지 마세요. 프로그램을 연 뒤 ‘구독 그룹 설정’에서 구독 주소를 추가하고 저장한 다음 ‘구독 전체 업데이트(프록시 사용 안 함)’를 실행하세요. 현재 네트워크에서 구독 주소에 접근할 수 없다면 주소와 네트워크 상태를 확인한 뒤 업데이트 방식을 조정할지 결정하세요.
사용 가능한 설정을 선택한 다음 ‘시스템 프록시 자동 설정’을 켜세요. 일반적인 브라우저 사용이라면 시스템 프록시부터 설정하면 되며, 설치 직후 Tun을 활성화할 필요는 없습니다. Desktop 버전과 WPF 버전을 전환하기 전에 설정을 내보내거나 백업하세요. 새 버전을 테스트할 때는 기존 프로그램을 종료해 두 버전이 동시에 시스템 프록시를 변경하거나 같은 포트를 사용하지 않도록 하세요.
Windows 시스템 요구 사항 및 설치 확인
확인 항목
선택 기준
안내
CPU 아키텍처
이 페이지에서는 x64 설치 파일을 제공합니다
‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하세요.
운영체제 및 실행 환경
배포 패키지가 지원하는 Windows 환경이 필요합니다
구형 운영체제에서는 먼저 호환성을 확인하세요. 실행 환경이 없다는 안내가 표시되면 설치 프로그램의 지침을 따르세요.
권한 및 프록시 적용 방식
일반 프록시와 Tun은 필요한 권한이 다릅니다
Tun을 사용하려면 가상 네트워크 어댑터가 필요하며 관리자 권한이 요구될 수 있습니다. 일반 실행 시에는 미리 권한을 높일 필요가 없습니다.
이 페이지에서는 모든 배포 패키지에 동일한 최소 운영체제 버전을 적용하지 않습니다. 현재 패키지의 설치 안내를 기준으로 확인하세요. 실행에 실패하면 안내 내용을 기록한 뒤 문제 해결에서 증상에 맞는 방법을 찾아보세요.
macOS 설치 파일
‘이 Mac에 관하여’에서 칩 이름을 확인하고 Apple Silicon 또는 Intel을 선택하세요.
‘이 Mac에 관하여’에 Intel 프로세서가 표시되면 이 패키지를 선택하세요. 컴퓨터 외관이나 구매 연도만으로 판단하지 마세요. 두 기기 유형은 앱 아키텍처가 다릅니다.
dmg 디스크 이미지 · x64
응용 프로그램 폴더에 설치
dmg 파일을 열고 이미지에 표시된 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮긴 다음 해당 폴더에서 실행하세요. 처음 실행할 때 시스템 보안 알림이 표시되면 파일 출처와 알림 내용을 확인하고 시스템에서 제공하는 확인 절차를 따르세요. 앱을 실행하기 위해 시스템 보호 기능 전체를 끄지 마세요.
구독을 가져온 뒤 설정 하나로 시스템 프록시를 먼저 테스트하세요. 시스템 프록시는 해당 설정을 따르는 앱에만 영향을 주며 모든 프로그램의 트래픽을 제어하는 것은 아닙니다. Tun을 추가로 사용하려면 권한, 가상 네트워크 어댑터, 라우팅 관련 안내를 확인하세요. 앱을 업데이트하기 전에 기존 프로세스를 종료하고 설정을 백업하세요. 앱 제거와 설정 삭제를 한 번에 처리하지 마세요.
macOS 시스템 요구 사항 및 설치 확인
확인 항목
선택 기준
안내
칩
Apple Silicon은 arm64, Intel은 x64에 해당합니다
Apple 메뉴에서 ‘이 Mac에 관하여’를 열고 칩 또는 프로세서 항목을 확인하세요.
운영체제 버전
현재 데스크톱 배포 패키지에서 지원하는 macOS가 필요합니다
운영체제가 오래된 경우 먼저 호환성을 확인하세요. 칩이 맞더라도 운영체제 버전 확인을 생략하면 안 됩니다.
앱 및 네트워크 권한
사용하려는 기능에 필요한 권한을 부여하세요
일반 프록시 연결을 테스트한 뒤 필요에 따라 Tun과 관련 권한을 설정하세요.
칩 아키텍처를 바꾼다고 설정까지 자동으로 동기화되지는 않습니다. 기기를 옮길 때는 구독 그룹과 사용자 지정 규칙을 별도로 내보내고, 가져온 뒤 로컬 경로, 수신 주소, 프록시 모드를 다시 확인하세요.
Android 설치 파일
v2rayNG를 우선 선택하세요. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 사용하지만, 확실하지 않으면 기기 아키텍처를 확인하세요.
여러 아키텍처를 지원하므로 기기 아키텍처를 아직 확인하지 못한 경우에 적합합니다. 범용 버전이라고 모든 Android 버전과 호환되는 것은 아니며 앱 자체의 요구 사항을 충족해야 합니다.
구독을 추가하고 VPN 권한 확인
apk를 다운로드한 뒤 시스템 안내에 따라 현재 사용하는 브라우저나 파일 관리자에만 앱 설치 권한을 허용하세요. v2rayNG를 실행하고 ‘구독 그룹 설정’에서 주소를 추가한 다음 돌아와 ‘구독 업데이트’를 실행하세요. 설정을 선택하고 연결 버튼을 누른 뒤 시스템에 표시되는 VPN 연결 요청을 승인하고 앱 접속을 테스트하세요.
일반적으로 스마트폰에서는 여러 VPN 서비스를 동시에 사용할 수 없습니다. 연결되지 않으면 먼저 다른 VPN 서비스가 실행 중인지 확인하고 로그를 살펴보세요. 화면을 잠근 뒤 연결이 자주 끊긴다면 배터리 관리와 백그라운드 실행 제한도 확인하세요. 백그라운드 제한, 만료된 구독, 호환되지 않는 설정을 모두 설치 파일 문제로 단정하지 마세요.
기기에 맞춰 다른 아키텍처 지원을 선택할 때 사용하세요. 전환하기 전에 구독의 프로토콜과 전송 설정이 현재 코어에서 지원되는지 확인하세요.
클라이언트와 코어 기능의 차이
v2rayNG와 v2flyNG는 모두 GUI 클라이언트지만 코어 계열이 다르므로 설정 기능이 완전히 같지는 않습니다. 인터페이스가 비슷하다고 모든 공유 링크를 서로 바꿔 사용할 수 있다고 생각하지 마세요. 가져온 뒤 지원되지 않는 항목이 표시되면 프로토콜, 전송 방식, 보안 설정을 확인하세요. REALITY 같은 설정은 선택한 코어가 지원하는지 확인해야 합니다.
두 앱의 설정과 시스템 권한은 각각 관리됩니다. 대체 클라이언트를 시험할 때는 기존 연결을 먼저 중지한 뒤 새 클라이언트에서 가져와 테스트하세요. 구독 주소에는 접속 정보가 포함될 수 있으므로 백업, 스크린샷, 공유 시 주의하고 전체 주소를 공개된 문의 내용에 포함하지 마세요.
Android 시스템 요구 사항 및 설치 확인
확인 항목
선택 기준
안내
앱 아키텍처
arm64 우선 선택 · 잘 모르면 범용 버전 고려
프로세서 이름만 보지 말고 기기에서 지원하는 앱 아키텍처를 확인하세요.
운영체제 버전
선택한 apk의 설치 요구 사항을 충족해야 합니다
호환되지 않는다는 안내가 표시되면 먼저 운영체제 버전 문제인지 아키텍처 문제인지 구분하세요.
설치 및 연결 권한
앱 설치 권한과 VPN 권한이 필요합니다
설치 권한은 설치 파일 출처별로 설정하세요. 처음 연결할 때는 안내에 따라 VPN 요청을 승인하세요.
백그라운드 실행
연결 유지 여부는 시스템 배터리 정책의 영향을 받습니다
필요에 따라 백그라운드 제한을 조정하고 배터리 사용량을 확인하세요.
기존 앱 위에 설치할 때 서명 충돌이 표시되면 먼저 설정을 백업하고 출처가 다른 이유를 확인하세요. 백업을 찾기 전에 앱부터 삭제하지 마세요. 다른 클라이언트로 바꿔도 만료되었거나 접속할 수 없는 구독 주소는 해결되지 않습니다.
Linux 설치 파일
배포판의 패키지 형식을 확인한 다음 x64 또는 arm64를 선택하세요. 이 페이지에서는 그래픽 데스크톱 클라이언트를 제공합니다.
파일 관리자에서 해당 설치 파일을 열고 배포판에서 제공하는 소프트웨어 설치 관리자로 설치하세요. 의존성 누락이 표시되면 누락된 구성 요소와 배포판 호환성을 먼저 확인하고 의존성을 강제로 건너뛰지 마세요. arm64 기기는 작은 글씨로 표시된 해당 링크를 선택하세요. x86_64는 x64, aarch64는 arm64에 해당하며 서로 바꿔 사용할 수 없습니다.
그래픽 인터페이스가 실행되면 먼저 구독을 가져오고 라우팅을 확인한 뒤 프록시 모드를 선택하세요. 데스크톱 환경마다 시스템 프록시 설정 반영 방식이 다를 수 있습니다. 특정 앱에서 프록시가 적용되지 않으면 해당 앱이 데스크톱 시스템 프록시를 읽는지 확인하세요. Tun은 네트워크 장치와 권한 설정이 필요하므로 일반 연결이 작동한 뒤 별도로 테스트하세요. 데스크톱 클라이언트를 항상 높은 권한으로 실행하는 것은 일반적인 해결 방법이 아닙니다.
Linux 시스템 요구 사항 및 설치 확인
확인 항목
선택 기준
안내
CPU 아키텍처
x64 또는 arm64
시스템 정보에서 아키텍처 항목을 확인하고 기기에 맞는 패키지를 선택하세요.
패키지 관리 형식
deb 또는 rpm
현재 배포판의 패키지 형식을 따르고 의존성 버전이 충족되는지 확인하세요.
그래픽 환경
사용 가능한 데스크톱 세션과 관련 구성 요소가 필요합니다
명령줄 전용 서버용 설치 파일이 아닙니다.
프록시 적용
데스크톱 환경, 앱, 권한의 영향을 받습니다
시스템 프록시와 Tun을 각각 테스트하고 두 모드를 같은 설정으로 간주하지 마세요.
업그레이드 전에 클라이언트를 종료하고 설정을 저장하세요. 패키지 관리자가 설치를 거부하면 배포판 버전, 아키텍처, 의존성 안내를 기록한 뒤 시스템 가이드를 참고해 문제를 해결하세요. 설정 폴더에 계속 덮어쓰지 마세요.
설치 후 설정 순서
구독을 가져온 뒤 연결 확인
다운로드는 시작일 뿐입니다. 설정, 트래픽 적용 방식, 실제 접속 결과를 나눠 확인하면 문제의 원인을 찾기 쉽습니다.
구독 및 설정
주소를 저장한 다음 업데이트
구독 주소를 추가했다고 설정이 자동으로 가져와지는 것은 아닙니다. 주소를 저장한 뒤 업데이트를 실행하고 그룹에 항목이 나타나는지 확인한 다음 사용할 설정을 선택하세요. 구독에서 아무 내용도 불러오지 못하면 주소 유효 기간, 현재 네트워크, 구독 형식을 확인하세요. 주소가 만료된 문제를 해결하려고 클라이언트를 다시 설치하지 마세요.
공유 링크와 구독 주소는 용도가 다릅니다. 단일 공유 링크는 보통 설정 하나를 가져오며, 구독은 여러 설정을 가져오고 업데이트할 때 사용합니다. 업데이트하면 구독 그룹에 생성된 항목이 덮어써질 수 있으므로 직접 수정하기 전에 저장 위치와 덮어쓰기 범위를 확인하세요.
데스크톱에서는 시스템 프록시를 먼저 테스트하고 Android에서는 VPN 서비스가 실행 중인지 확인하세요. 자주 사용하는 앱 하나가 예상대로 접속되는지 확인한 뒤 라우팅과 DNS를 조정하세요. 시스템 프록시는 해당 설정을 따르는 프로그램에만 적용됩니다. 더 넓은 범위의 트래픽을 적용해야 한다면 Tun 안내를 확인하세요.
테스트할 때는 한 번에 한 항목만 변경하세요. 연결 전후의 증상을 기록해 도메인 조회 실패, 연결 시간 초과, 설정 항목 오류를 구분하세요. 연결을 끊은 뒤 시스템 프록시가 복원되었는지도 확인하세요. 남아 있는 프록시 설정을 기기 네트워크 문제로 오해할 수 있습니다.
먼저 증상에 따라 확인하세요. 연결 및 분할 라우팅 문제는 문제 해결에서 추가로 살펴볼 수 있습니다.
Windows 데스크톱 버전과 클래식 WPF 버전, 무엇을 선택할까요?
처음 설치한다면 새로운 크로스 플랫폼 인터페이스를 사용하는 v2rayN 데스크톱 버전을 추천합니다. 기존 Windows 메뉴와 조작 방식에 익숙하다면 클래식 WPF 버전을 선택하세요. 두 버전 모두 x64 패키지입니다. 전환 전에 설정을 백업하고 각 버전을 따로 설치해 연결을 테스트하세요. 두 프로그램이 동시에 시스템 프록시를 제어하지 않도록 주의하세요.
Android에서는 arm64와 범용 버전 중 무엇을 다운로드해야 하나요?
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 다만 기기에서 실제로 지원하는 앱 아키텍처를 확인하세요. 아키텍처를 모르거나 arm64 패키지가 호환되지 않는다고 표시되면 범용 버전을 시도할 수 있습니다. 그래도 설치되지 않는다면 시스템 버전, 저장 공간, 기존 앱의 서명을 확인하세요. 패키지를 계속 바꾸는 것만으로 해결하려 하지 마세요.
설치했는데 연결되지 않는 이유는 무엇인가요?
설치 파일에는 클라이언트만 포함되어 있으며 바로 사용할 수 있는 서버 설정은 제공되지 않습니다. 먼저 유효한 구독이나 공유 링크를 가져오고 구독을 업데이트한 뒤 설정을 선택하세요. 다음으로 시스템 프록시를 설정하거나 Android VPN 권한을 승인하세요. 구독 만료 여부, 기기 시간, 연결 로그를 확인하고 로그 안내에 따라 문제를 해결하세요.
클라이언트를 업데이트하기 전에 무엇을 보관해야 하나요?
먼저 클라이언트의 백업 또는 내보내기 기능으로 설정을 저장하고 구독 그룹, 라우팅 규칙, DNS, 프록시 모드를 기록하세요. 실행 중인 클라이언트를 종료한 뒤 운영체제와 아키텍처에 맞는 패키지를 설치하세요. 업데이트 후 설정 하나로 연결을 테스트하고 사용자 지정 설정을 하나씩 복원하세요. 기존 설정 폴더를 바로 삭제하지 마세요.
다운로드가 시작되지 않거나 설치 파일이 열리지 않으면 어떻게 하나요?
먼저 브라우저의 다운로드 기록에서 다운로드가 일시 중지되거나 차단되었는지, 다른 위치에 저장되었는지 확인하세요. 네트워크와 저장 공간을 확인한 뒤 다시 다운로드하고, 파일이 현재 운영체제와 아키텍처에 맞는지 살펴보세요. Windows용 zip 파일은 압축을 풀어야 하며, macOS는 dmg, Android는 apk, Linux는 배포판에 맞는 deb 또는 rpm을 사용합니다. 알 수 없는 위험 알림을 피하려고 시스템 보호 기능을 끄지 마세요.