데스크톱판은 차세대 크로스 플랫폼 인터페이스를 사용해 여러 데스크톱 운영체제에서 비슷한 방식으로 조작할 수 있습니다. WPF판은 Windows용으로, 익숙한 클래식 창 구성을 유지합니다. 인터페이스 프레임워크가 다르다고 해서 서버 설정에 사용하는 커널 매개변수를 임의로 함께 쓸 수 있는 것은 아닙니다. 특정 프로토콜이나 전송 설정을 사용할 수 없다면 현재 버전과 설정 요구 사항을 먼저 확인하세요. 인터페이스 버전만 바꿔 해결하려고 하지 마세요.
ZIP 파일의 압축을 푼 뒤 안에 있는 설치 프로그램을 실행하세요. 압축 프로그램의 미리 보기 창에서 바로 실행하지 마세요. 쓰기 권한이 있는 위치를 선택하고 설치 마법사에 표시되는 실행 구성 요소 안내를 따르세요. 일반적인 시스템 프록시 사용에는 보통 관리자 권한이 필요하지 않습니다. Tun 모드를 활성화하기 전에는 클라이언트 안내에 따라 관리자 권한과 가상 네트워크 어댑터 구성 요소를 확인하세요.
Windows 시스템 요구 사항 및 설치 확인
확인 항목
선택 기준
설치 전 조치
운영체제
지원이 계속되는 Windows 11을 우선 사용하세요. 다른 버전은 설치 프로그램의 요구 사항을 확인하세요.
Windows 업데이트를 완료한 다음 누락된 실행 구성 요소 안내를 처리하세요.
CPU 아키텍처
이 페이지의 두 다운로드 항목은 모두 x64입니다.
‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하세요.
폴더 및 권한
설치 폴더와 설정 폴더에 쓰기 권한이 필요합니다.
먼저 압축을 푸세요. 권한 문제를 서버 문제로 오해하지 마세요.
네트워크 제어
시스템 프록시와 Tun 모드의 권한 요구 사항은 서로 다릅니다.
먼저 시스템 프록시를 확인한 뒤 필요한 경우 Tun을 활성화하세요.
처음 실행한 뒤 최소한의 설정부터 완료하세요. ‘구독 그룹 설정’을 열어 구독 주소를 저장한 다음 ‘현재 구독 업데이트(프록시 사용 안 함)’를 실행합니다. 해당 주소에 접속할 때 프록시가 필요한 경우에는 사용 가능한 연결을 확보한 뒤 적절한 업데이트 방식을 선택하세요. 이어서 사용할 서버와 라우팅을 설정하고 ‘시스템 프록시 자동 설정’을 켜세요. 자세한 순서는 빠른 시작 가이드를 참고하세요.
데스크톱판과 WPF판을 전환할 때는 실행 중인 인스턴스를 먼저 종료하고 로컬 포트와 사용자 지정 설정을 기록하세요. 두 인스턴스가 같은 수신 포트를 함께 사용하거나 동시에 시스템 프록시를 변경하지 않도록 하세요. 이전 버전은 정상적으로 실행되는데 새 버전이 시작되지 않으면 기존 설정을 백업한 상태로 설치 안내와 클라이언트 로그를 먼저 확인한 뒤 이전 환경으로 복원할지 결정하세요.
v2rayN
데스크톱 클라이언트7.24.1
‘이 Mac에 관하여’에 표시된 칩 정보를 확인해 DMG를 선택하세요. Apple M 시리즈라면 Apple Silicon을, Intel 프로세서라면 Intel을 선택하세요. 컴퓨터 외관이나 구매 연도로 판단하지 마세요.
다운로드한 DMG를 열고 창의 안내에 따라 앱을 ‘응용 프로그램’으로 복사한 다음 해당 폴더에서 실행하세요. 마운트된 디스크 이미지에서 계속 실행하면 업데이트, 설정 저장, 권한 확인에 혼란이 생길 수 있습니다. 앱 복사가 완료된 것을 확인한 뒤 디스크 이미지를 추출하세요.
처음 실행할 때 시스템 보안 안내가 표시되면 다운로드 출처, 파일 아키텍처, 안내 내용을 먼저 확인하세요. 그런 다음 ‘시스템 설정 → 개인정보 보호 및 보안’에서 해당 앱을 허용할 수 있는지 살펴보세요. 클라이언트를 실행하기 위해 시스템 보안 기능 전체를 끄지 마세요. 앱을 실행할 수 없다는 안내가 표시되면 시스템 버전 미지원, 아키텍처 불일치, 앱 파일 손상을 구분해 각각 확인하세요.
macOS 시스템 요구 사항 및 설치 확인
확인 항목
선택 기준
설치 전 조치
칩
Apple M 시리즈는 arm64, Intel은 x64에 해당합니다.
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요.
시스템 버전
현재 앱의 실행 요구 사항과 시스템 안내를 확인하세요.
시스템 버전을 기록하고 지원이 계속되는지 확인하세요.
앱 위치
‘응용 프로그램’에 복사한 앱을 실행하세요.
DMG는 앱 복사가 끝난 뒤 추출하세요.
네트워크 권한
시스템 프록시와 Tun은 필요한 권한 범위가 다릅니다.
실제로 사용할 기능에 필요한 권한만 허용하고 네트워크 제어 도구를 여러 개 동시에 실행하지 마세요.
구독을 가져온 뒤 브라우저에서 시스템 프록시가 작동하는지 먼저 확인하고 Tun 모드가 필요한지 판단하세요. 브라우저는 연결되지만 특정 앱이 연결되지 않는다면 해당 앱이 시스템 프록시를 사용하지 않는 경우가 많습니다. 곧바로 설치 실패로 판단하지 마세요. 먼저 앱 자체의 네트워크 설정을 확인한 뒤 프록시 모드 안내를 참고해 트래픽 제어 방식을 선택하세요.
업그레이드할 때는 클라이언트를 정상 종료하고 설정을 백업한 다음 앱을 교체하세요. 시스템에서 네트워크 관련 기능을 다시 승인하라고 하면 안내를 읽고 항목별로 확인하세요. 이전 보조 프로세스, 다른 프록시 도구, 기존 가상 네트워크 어댑터가 연결에 영향을 줄 수 있습니다. 문제를 확인할 때는 네트워크 제어 경로를 하나만 남겨 여러 변경 사항이 겹치지 않도록 하세요.
v2rayNG
추천Xray 커널2.2.6
Android에서 우선 사용할 클라이언트입니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택하면 됩니다. 기기에서 32비트 앱만 지원하거나 아키텍처를 확인하기 어렵다면 범용 버전을 시도하고 설치 화면의 호환성 안내를 따르세요.
브라우저나 파일 관리자에서 APK를 열고 시스템 안내에 따라 현재 설치 출처 앱에 ‘알 수 없는 앱 설치’ 권한을 허용하세요. 모든 파일 도구에 권한을 부여할 필요는 없습니다. 설치가 끝나면 임시 권한을 해제할 수 있습니다. 기존 앱과 충돌한다는 안내가 나오면 서명 채널이 다른지 먼저 확인하세요. 설정이 사라질 수 있으므로 기존 클라이언트를 바로 삭제하지 마세요.
설정을 가져오고 서버를 선택한 다음 연결 버튼을 누르세요. Android에서 VPN 연결 권한을 요청하면 승인해야 클라이언트가 로컬 VPN 인터페이스를 통해 트래픽을 제어할 수 있습니다. 이 시스템 권한은 서버 구독이 아니며 모든 트래픽이 원격 프록시를 거친다는 뜻도 아닙니다. 실제 트래픽 경로는 클라이언트의 라우팅과 앱별 분할 설정에 따라 달라집니다.
v2flyNG
대안v2fly 커널1.10.31
기존 설정에서 요구하는 커널 호환성에 따라 선택하세요. v2fly 커널을 v2rayNG 설정 전체의 대체품처럼 사용해서는 안 됩니다. 설정을 가져오기 전에 프로토콜, 전송 방식, 보안 매개변수의 지원 여부를 확인하세요.
두 Android 클라이언트는 서로 다른 설정 환경에서 사용할 수 있지만, 평소 연결할 때는 VPN 하나만 활성화하세요. 다른 클라이언트를 실행하기 전에 현재 연결을 중지해야 Android가 이전 VPN 연결을 해제해 생기는 혼란을 막을 수 있습니다. 구독을 옮길 때는 서버, 라우팅, 앱별 분할 설정을 항목별로 확인하세요. 구독 링크만으로 모든 설정이 이전된다고 가정하지 마세요.
Android 시스템 요구 사항 및 설치 확인
확인 항목
선택 기준
설치 전 조치
앱 아키텍처
일반적인 64비트 시스템에서는 arm64를 우선 선택하고, 그 밖의 지원 아키텍처에는 범용 버전을 선택하세요.
프로세서 모델만 보지 말고 시스템에서 실행할 수 있는 앱 아키텍처를 확인하세요.
시스템 버전
설치 프로그램에서 패키지의 최소 시스템 버전을 확인합니다.
호환되지 않는다면 전체 안내를 기록하고 덮어쓰기를 반복하지 마세요.
설치 출처
브라우저와 파일 관리자는 각각 별도의 권한을 허용해야 합니다.
실제로 사용하는 설치 출처 앱에만 임시로 권한을 허용하세요.
백그라운드 실행
배터리 최적화로 연결이 중단될 수 있습니다.
필요에 따라 백그라운드 제한을 조정하고 배터리 사용량을 확인하세요.
화면을 잠근 뒤 연결이 끊긴다면 설치 아키텍처를 바꾸기보다 배터리 최적화, 자동 시작, 백그라운드 활동 제한을 먼저 확인하세요. 백그라운드 실행을 허용하면 배터리 소모가 늘 수 있으므로 실제 연결 방식에 맞게 설정하세요. v2rayNG 사용 가이드에 따라 구독을 가져온 뒤 앱을 켠 상태에서 웹을 탐색하고, 화면 잠금 상태로 기다린 다음 네트워크를 전환해 각각 테스트하면 문제 범위를 좁힐 수 있습니다.
앱 버전 표시와 APK 파일 이름이 일시적으로 다를 수 있으며, 다운로드 항목이 앱 릴리스 정보보다 먼저 업데이트되기도 합니다. 설치할 때 시스템 설치 화면에 표시된 패키지 버전을 확인해 이전 버전이 최신 버전을 덮어쓰지 않도록 하세요. 시스템에서 다운그레이드를 거부하면 기존 앱을 유지하고 적절한 업데이트를 기다리세요. 설정을 잃을 수 있으니 삭제로 강제로 우회하지 마세요.
v2rayN
데스크톱 클라이언트7.24.1
먼저 배포판에 맞는 deb 또는 rpm을 선택한 다음 x64 또는 arm64를 확인하세요. 아래 주요 다운로드 항목은 x64 데스크톱용입니다. ARM 기기에서는 해당하는 arm64 항목을 선택하세요.
시스템 소프트웨어 설치 도구나 패키지 관리자로 다운로드한 파일을 열고 의존성 확인 결과를 읽으세요. deb와 rpm은 패키지 형식일 뿐, 같은 계열의 모든 배포판과 호환된다는 보장은 아닙니다. 현재 rpm 파일 이름에는 el10 표시가 있으므로 시스템 라이브러리와 배포판 요구 사항을 특히 꼼꼼히 확인하세요. 의존성이 충족되지 않으면 무시하고 강제로 설치하지 마세요.
처음 실행할 때는 일반 사용자 계정의 그래픽 데스크톱 세션을 사용하세요. 먼저 설정을 가져와 시스템 프록시를 확인하고 추가 권한이 필요한 네트워크 기능은 그다음 처리하세요. 그래픽 클라이언트 전체를 상시 높은 권한으로 실행하는 것은 폴더 쓰기나 데스크톱 프록시 설정 문제를 해결하는 일반적인 방법이 아닙니다. 구체적인 오류에 따라 설정 폴더의 소유자와 권한 안내를 확인하세요.
Linux 시스템 요구 사항 및 설치 확인
확인 항목
선택 기준
설치 전 조치
패키지 형식
배포판에서 지원하는 deb 또는 rpm을 사용하세요.
시스템 설치 도구에서 의존성 요구 사항을 확인하세요.
CPU 아키텍처
amd64와 x86_64는 x64에 해당하며, arm64와 aarch64는 64비트 ARM에 해당합니다.
시스템의 ‘정보’ 페이지에서 아키텍처를 확인하세요.
데스크톱 환경
그래픽 클라이언트를 실행할 수 있는 데스크톱 세션이 필요합니다.
디스플레이 환경과 필요한 시스템 라이브러리를 사용할 수 있는지 확인하세요.
프록시 동작
앱이 데스크톱 환경의 프록시 설정을 사용하지 않을 수도 있습니다.
먼저 앱 하나로 확인한 뒤 Tun을 통한 트래픽 제어를 검토하세요.
Linux에서 데스크톱 시스템 프록시를 설정해도 모든 명령줄 프로그램이 자동으로 프록시를 사용하는 것은 아닙니다. 브라우저, 데스크톱 앱, 터미널 도구는 각각 다른 설정을 사용할 수 있습니다. 문제를 확인할 때는 앱이 어떤 프록시 설정을 읽는지 먼저 파악한 다음 로컬 수신 주소와 포트를 확인하세요. 앱마다 동작이 다른 것을 설치 파일 문제로 오해하지 마세요.
업그레이드 전에 시스템 패키지 관리자로 기존 패키지의 설치 상태를 확인하고 원래 설치 방식을 유지하세요. 설정 위치를 모르는 상태에서 시스템 패키지와 수동 파일 복사를 번갈아 사용하지 마세요. Tun을 활성화한 뒤 로컬 네트워크 접속이나 DNS에 문제가 생기면 Tun을 먼저 끄고 기본 네트워크를 복원한 다음 Tun 모드 안내를 참고해 권한, 라우팅, DNS 확인 경로를 차례로 살펴보세요.
설치 후 설정 순서
클라이언트는 설정을 읽고 트래픽을 전달할 뿐, 바로 사용할 수 있는 원격 서버를 제공하지 않습니다. 사용할 권한이 있는 구독 주소나 개별 서버 설정을 준비하고 출처와 만료일을 확인하세요. 구독 주소에는 접속 정보가 포함될 수 있으므로 계정 정보처럼 안전하게 보관하고, 전체 주소가 보이는 화면을 공개적으로 공유하거나 문제 보고에 첨부하지 마세요.
구독 가져오기. v2rayN에서 ‘구독 그룹 설정’을 열고 그룹 이름과 구독 주소를 추가한 다음 저장하고 구독을 업데이트하세요. 주소만 저장한다고 연결할 서버 목록이 자동으로 만들어지는 것은 아닙니다. 업데이트에 실패하면 주소, 네트워크 경로, 응답 내용을 확인하세요.
사용할 서버 선택. 업데이트가 끝나면 목록에서 사용할 서버를 골라 활성 항목으로 지정하세요. 구독 그룹은 서버를 관리하는 묶음일 뿐, 특정 서버를 선택했다는 뜻은 아닙니다. 여러 그룹을 유지한다면 현재 목록과 활성 항목이 일치하는지 확인하세요.
라우팅 및 프록시 모드 설정. 먼저 사용 목적에 맞는 라우팅을 선택한 다음 ‘시스템 프록시 자동 설정’을 활성화하세요. 라우팅은 클라이언트로 들어온 트래픽이 어디로 향할지를 결정하고, 시스템 프록시는 어떤 앱이 트래픽을 클라이언트로 보낼지를 결정합니다. 두 기능의 역할은 서로 다릅니다.
연결을 항목별로 확인. 먼저 시스템 프록시를 사용하는 브라우저를 테스트한 다음 다른 앱을 확인하세요. 시스템 프록시를 사용하지 않는 앱의 트래픽까지 제어해야 할 때만 Tun 모드를 고려하세요. 한 번에 설정 하나만 바꾸고 재현 가능한 순서로 테스트하세요.
복구 가능한 업그레이드 경로 유지
업그레이드 전에 현재 사용하는 프록시 모드, 수신 포트, DNS, 사용자 지정 라우팅을 기록하고 구독 그룹과 설정을 백업하세요. 기존 인스턴스를 종료한 뒤 새 버전을 설치하고, 처음 실행할 때는 기존 기본 연결부터 확인하세요. 서버 변경, DNS 수정, Tun 활성화를 한꺼번에 하지 마세요. 문제가 생겼을 때 소프트웨어 업그레이드, 설정 이전, 네트워크 환경 변화 중 무엇이 원인인지 파악하기 쉽습니다.
디스크 공간, 메모리, 최소 시스템 버전 요구 사항은 클라이언트와 실행 구성 요소에 따라 달라질 수 있습니다. 확인되지 않은 고정 수치를 모든 환경의 공통 요구 사항으로 간주하지 마세요. 현재 설치 프로그램과 패키지 관리자가 안내하는 호환성 정보를 따르세요. 기기의 운영체제 지원이 종료됐다면 아키텍처가 다른 설치 파일을 계속 시도하기보다 시스템 업그레이드를 우선 검토하세요.
자세한 사용 순서는 빠른 시작을, 구독·커널·라우팅의 관계는 초보자부터 고급 사용자까지를 위한 안내서를 참고하세요. 설치 파일을 다운로드하는 것과 원격 연결을 설정하는 것은 별개의 단계입니다. 먼저 클라이언트가 정상적으로 실행되는지 확인한 뒤 구독과 네트워크 문제를 살펴보세요.
다운로드 및 설치 자주 묻는 질문
Windows에서는 데스크톱판과 클래식 WPF판 중 무엇을 선택해야 하나요?
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 v2rayN 데스크톱판을 선택할 수 있습니다. 기존 Windows 인터페이스에 익숙하다면 WPF판을 사용하세요. 두 버전 모두 유효한 설정을 가져와야 합니다. 인터페이스 버전을 바꾸기 전에 구독 그룹과 사용자 지정 라우팅을 백업하고, 두 인스턴스가 동시에 시스템 프록시를 제어하지 않도록 하세요.
macOS용 Apple Silicon과 Intel 설치 파일은 어떻게 구분하나요?
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. Apple M 시리즈 칩이 표시되면 Apple Silicon을, Intel 프로세서가 표시되면 Intel 설치 파일을 선택하세요. 프로세서에 맞는 네이티브 설치 파일을 우선 사용하고, 시스템 버전이 요구 사항을 충족하는지는 설치 안내를 확인하세요.
Android에서는 arm64와 범용 버전 중 무엇을 다운로드해야 하나요?
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 다만 최종적으로는 기기의 운영체제에서 지원하는 앱 아키텍처를 기준으로 하세요. 구형 기기나 32비트 시스템을 사용하는 기기에는 범용 버전이 적합합니다. 설치 파일을 열 수 없다면 다운로드가 완료됐는지 확인한 뒤 시스템 버전과 아키텍처를 살펴보세요.
클라이언트 버전과 설치 파일 이름이 다른 이유는 무엇인가요?
버전 표시는 앱 단위의 릴리스 정보를, 설치 파일 경로는 플랫폼별 개별 기록을 기준으로 하므로 업데이트 중에는 서로 다를 수 있습니다. 버전 표시만으로 파일 내용을 판단하지 마세요. 설치 전에 시스템 설치 화면에 표시된 패키지 버전을 확인하고, 업그레이드할 때 이전 버전을 덮어쓰지 않도록 주의하세요.
클라이언트를 다운로드하면 바로 연결할 수 있나요?
클라이언트는 설정 관리와 트래픽 전달 기능만 제공합니다. 사용할 권한이 있는 서버 설정이나 구독 주소는 직접 준비해야 합니다. 가져온 뒤 사용할 서버를 선택하고 라우팅을 확인한 다음, 필요에 따라 시스템 프록시 자동 설정이나 Tun 모드를 활성화하세요. 이 사이트는 서버나 구독 서비스를 제공하지 않습니다.
업그레이드 전에 어떤 설정을 보관해야 하나요?
클라이언트 설정 폴더를 백업하거나 현재 버전의 내보내기 기능을 사용해 구독 그룹, 사용자 지정 라우팅, DNS 설정, 로컬 수신 포트 기록을 보관하세요. 기존 인스턴스를 종료한 뒤 새 버전을 설치하고, 복원할 때는 항목별로 확인하세요. 구독 주소나 인증 정보가 포함된 백업은 안전한 곳에 보관하고 공개적으로 공유하지 마세요.