이 페이지에서는 x64 패키지를 제공합니다. ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하고 기기 아키텍처가 설치 파일과 일치하는지 확인하세요.
시스템 환경
지원이 계속되는 64비트 Windows를 사용하세요. 최소 운영체제 버전과 런타임 종속성은 현재 배포 패키지 안내를 확인해야 합니다.
권한 및 저장 공간
압축 해제와 설치에 필요한 공간을 확보하세요. 일반 프록시 설정과 TUN은 필요한 권한이 다르므로 처음 실행할 때 모든 기능을 한꺼번에 켜지 마세요.
Desktop과 WPF 중 선택하기
두 버전의 주요 차이는 UI 프레임워크와 데스크톱 사용 방식이며, 구독 출처와는 무관합니다. Desktop은 차세대 크로스 플랫폼 UI를 사용하고, WPF는 클래식 Windows 인터페이스를 유지합니다. 메뉴 위치와 창 동작, 일부 기능의 진입 경로가 다를 수 있습니다. 기존 안내서의 화면과 실제 UI가 다르면 버튼 위치만 보고 기능이 없다고 판단하지 말고 메뉴 이름으로 해당 기능을 찾아보세요. 지원 기능은 배포 버전에 따라 달라질 수 있으니 현재 업데이트 안내를 확인해 선택하세요.
WPF 설정을 사용 중이고 문제없이 작동한다면 먼저 백업한 뒤 Desktop으로 전환할지 검토하세요. 설정 폴더의 유일한 사본을 새 버전으로 바로 덮어쓰거나 두 버전을 동시에 실행해 시스템 프록시를 제어하지 마세요. 전환 후에는 구독 그룹, 현재 서버, 시스템 프록시, 라우팅 설정을 차례로 확인하고 기본 연결이 정상인지 확인한 뒤 사용자 지정 옵션을 복원하세요. 처음 설치한다면 한 버전으로 시작해 중복 설정으로 인한 문제 해결 부담을 줄이세요.
다운로드 후 설치 순서
ZIP 파일을 쓰기 가능한 폴더에 저장한 뒤 압축을 완전히 푸세요. 압축 파일 미리보기에서 설치 프로그램을 바로 실행하지 마세요.
압축을 푼 폴더에서 설치 프로그램을 실행하고 안내에 따라 설치하세요. 실행 환경이 없다는 메시지가 나오면 필요한 종속성 이름을 확인한 뒤 배포 안내에 따라 설치하세요. 같은 파일을 반복해서 재설치하지 마세요.
클라이언트를 실행해 설정을 가져오고 서버를 선택한 다음 시스템 프록시 자동 설정을 켜세요. 브라우저로 기본 연결을 확인한 후 라우팅 분할과 TUN을 설정하세요.
설치 중 파일이 사용 중이라는 메시지가 나오면 알림 영역의 클라이언트를 종료하고 이전 프로세스가 남아 있는지 확인하세요. 앱은 열리지만 연결되지 않는다면 설정과 네트워크를 점검해야 합니다. 구독 만료, 서버 매개변수 오류, 포트 충돌은 설치 파일을 다시 받아도 해결되지 않는 경우가 많습니다. 자세한 방법은 사용 가이드를 참고하세요.
v2rayN
데스크톱 클라이언트
macOS · DMG7.24.1
‘이 Mac에 관하여’에 표시된 칩 종류에 맞춰 설치 파일을 선택하세요. Apple M 시리즈와 Intel은 다운로드 링크가 다릅니다.
Apple Silicon
Apple M 시리즈 칩에 적합합니다. 불필요한 아키텍처 변환을 피하려면 기본 arm64 패키지를 선택하세요.
최소 macOS 버전은 현재 배포 패키지 안내를 확인하세요. 처음 실행할 때 보안 허용이 필요할 수 있으며, 시스템 프록시와 TUN 권한은 실제 기능의 안내에 따라 설정해야 합니다.
DMG 설치 및 첫 실행
다운로드한 DMG를 열고 앱을 ‘응용 프로그램’ 폴더로 드래그한 다음, 해당 폴더에서 실행하세요. 마운트된 디스크 이미지에서 계속 실행하면 업데이트, 앱 경로 인식, 권한 기록을 관리하기 불편할 수 있습니다. 설치가 끝나면 디스크 이미지를 추출해도 됩니다. 다운로드 파일을 보관할지는 이후 유지 관리 방식에 따라 결정하면 되며, 응용 프로그램 폴더에 복사된 앱의 실행에는 영향을 주지 않습니다.
처음 실행할 때 개발자 확인 경고가 표시되면 다운로드 출처와 칩에 맞는 패키지를 선택했는지 먼저 확인한 뒤 ‘시스템 설정 → 개인정보 보호 및 보안’에서 관련 안내를 살펴보세요. 출처를 확인한 앱에만 실행을 허용하고, 앱 하나를 열기 위해 시스템 보안 기능 전체를 끄지 마세요. macOS 버전에 따라 버튼 위치가 다를 수 있으므로 현재 시스템 안내를 따르세요.
앱 설치와 네트워크 권한은 별도로 설정
앱이 열린다고 해서 모든 네트워크 기능에 권한이 부여된 것은 아닙니다. 먼저 유효한 설정을 가져와 일반 시스템 프록시로 연결을 확인하세요. 더 많은 앱의 트래픽을 제어해야 할 때 안내에 따라 TUN을 활성화하고 필요한 권한을 설정하면 됩니다. 시스템 프록시, 네트워크 확장, 가상 네트워크 인터페이스는 서로 다른 설정이므로 한 가지 권한을 허용했다고 다른 기능까지 작동하는 것은 아닙니다.
실행 후 창이 보이지 않으면 메뉴 막대나 Dock에 이미 실행 중인 인스턴스가 있는지 확인하세요. 앱을 종료한 뒤에만 네트워크가 복구된다면 시스템 프록시가 여전히 로컬 포트를 가리키는지, 다른 프록시 클라이언트도 함께 실행 중인지 확인하세요. 권한 문제를 해결할 때는 표시된 메시지와 시스템 버전을 기록해 두는 편이 아키텍처가 다른 패키지를 반복해서 다운로드하는 것보다 원인을 찾는 데 도움이 됩니다.
v2rayNG
추천
Android · Xray 코어2.2.6
Android에서 많이 사용하는 클라이언트로, 공유 링크와 구독 가져오기를 지원합니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 고려할 수 있지만, 시스템이 지원하는 아키텍처를 확인하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택할 수 있습니다. 일부 기기는 운영체제의 아키텍처 제한이 있을 수 있으므로 확인이 어렵다면 범용 버전을 선택하세요.
운영체제 버전
최소 Android 버전은 각 클라이언트의 최신 배포 안내를 확인하세요. 프로세서가 64비트를 지원해도 운영체제가 해당 패키지를 지원한다고 단정할 수는 없습니다.
설치 및 연결 권한
APK를 실제로 여는 브라우저나 파일 관리자에 앱 설치 권한을 허용하세요. 처음 연결할 때는 시스템 VPN 권한을 확인해야 합니다.
아키텍처 선택 및 설치 실패 해결
arm64는 프로세서와 앱 실행 아키텍처를 뜻하므로 휴대전화 브랜드나 모델 출시 연도만으로 판단할 수 없습니다. 최근 기기의 대부분은 arm64 패키지를 사용할 수 있지만, 구형 기기나 특수 운영체제, 다른 아키텍처를 사용하는 기기에는 범용 버전이 필요할 수 있습니다. 범용 버전은 지원 아키텍처를 넓혀 주지만, 운영체제 버전이 낮거나 저장 공간이 부족하거나 기존 앱의 서명이 다른 문제까지 자동으로 해결하지는 않습니다.
APK를 열고 시스템 안내에 따라 설치하세요. 앱 설치 권한은 보통 설치를 시작한 앱에 부여됩니다. 브라우저로 다운로드한 뒤 파일 관리자에서 열면 파일 관리자에도 별도로 권한을 허용해야 할 수 있습니다. 설치가 끝나면 임시로 허용한 설치 권한을 끌 수 있습니다. ‘앱이 설치되지 않음’이라는 메시지가 나오면 동명의 기존 앱, 남은 저장 공간, 아키텍처 호환성을 먼저 확인한 뒤 백업 후 재설치할지 판단하세요.
v2rayNG와 v2flyNG는 어떻게 다른가요?
v2rayNG는 Xray 코어를 사용하며 이 페이지에서 Android용으로 우선 추천하는 클라이언트입니다. v2flyNG는 V2Fly 코어를 사용하며 관련 설정이 필요한 분이 선택할 수 있습니다. 두 클라이언트는 같은 프록시 생태계의 서로 다른 선택지이며, 모든 구독 매개변수가 서로 호환된다고 가정해서는 안 됩니다. 프로토콜, 전송 방식, 확장 매개변수 지원 여부는 실제 코어 버전과 클라이언트 설정 지원에 따라 달라집니다.
처음 연결할 때 시스템 VPN 요청을 확인하세요. 일반적으로 한 번에 네트워크 트래픽을 제어하는 앱 하나만 작동할 수 있습니다. 다른 클라이언트나 VPN 앱이 이미 연결되어 있으면 기존 연결을 중지한 뒤 테스트하세요. 연결 버튼이 시작 상태로 바뀌어도 로컬 서비스가 실행 중이라는 뜻일 뿐입니다. 서버 사용 가능 여부는 웹 페이지 접속과 로그로 확인해야 합니다. 백그라운드에서 연결이 끊긴다면 배터리 최적화와 백그라운드 실행 제한도 확인하세요. 모든 문제를 설치 파일 탓으로 돌리지 마세요.
v2rayN
데스크톱 클라이언트
Linux · deb / rpm7.24.1
배포판에 맞는 deb 또는 rpm을 선택한 뒤 x64 또는 arm64 아키텍처를 확인하세요. 아래 기본 다운로드는 x64 데스크톱용이며 arm64 링크는 그 아래에 있습니다.
deb · x64
Debian, Ubuntu 및 deb를 지원하는 배포판용입니다. 설치 시 패키지 관리자가 종속성을 처리합니다.
기기와 데스크톱 시스템이 모두 arm64일 때만 선택하세요. 패키지 형식도 배포판과 일치해야 합니다.
Linux 운영체제 및 패키지 형식 요구 사항
배포판, 아키텍처 및 데스크톱 환경
항목
선택 및 확인 방법
deb 패키지
deb 패키지 관리 체계를 사용하는 배포판용입니다. 배포 패키지가 요구하는 시스템 라이브러리 버전을 충족해야 합니다.
rpm 패키지
rpm 패키지 관리 체계를 사용하는 배포판용입니다. 패키지 형식이 같아도 모든 배포판 버전과 호환되는 것은 아닙니다.
CPU 아키텍처
일반적인 Intel·AMD 데스크톱은 x64를 선택하고 arm64 데스크톱은 해당 패키지를 선택하세요. amd64와 x86_64는 보통 x64를, aarch64는 보통 arm64를 뜻합니다.
실행 환경
사용 가능한 그래픽 데스크톱과 필요한 종속성이 있어야 합니다. 일반 사용자는 앱을 실행하면 되며, 시스템 네트워크 설정을 변경할 때만 안내에 따라 권한을 허용하세요.
그래픽 패키지 관리자로 설치
설치 파일을 로컬에 저장한 뒤 배포판에서 제공하는 소프트웨어 설치 프로그램으로 여세요. 시스템 폴더에 파일을 쓰려면 관리자 권한이 필요할 수 있으며, 종속성은 배포판 소프트웨어 저장소에서 설치할 수 있습니다. 종속성 문제가 발생하면 누락된 항목과 시스템 버전을 먼저 확인하고 무시하도록 강제하지 마세요. deb와 rpm은 서로 다른 패키지 형식이므로 파일 확장자만 바꿔서는 형식이 변환되지 않습니다.
설치가 끝나면 앱 메뉴에서 v2rayN을 실행하세요. 창이 열리지 않으면 아키텍처, 그래픽 환경, 종속성이 맞는지 먼저 확인하세요. 창은 열리지만 네트워크가 프록시를 사용하지 않는다면 데스크톱 환경의 시스템 프록시 설정을 점검해야 합니다. 데스크톱과 앱마다 시스템 프록시를 따르는 방식이 다르므로, 브라우저 하나가 연결된다고 모든 앱이 자동으로 같은 경로를 사용하는 것은 아닙니다.
프록시 적용 범위와 권한
먼저 일반 프록시 모드로 서버 연결을 확인한 다음 TUN을 고려하세요. TUN은 가상 네트워크 인터페이스, 라우팅, 권한이 필요해 앱 프록시보다 더 넓은 범위에 영향을 줍니다. 권한 요청이 표시되면 어떤 작업에 필요한 권한인지 확인하고, 편의를 위해 그래픽 클라이언트 전체를 계속 높은 권한으로 실행하지 마세요. 다른 프록시나 네트워크 제어 도구가 이미 있다면 하나를 끈 뒤 포트 점유와 라우팅 충돌을 확인하세요.
업데이트하기 전에 클라이언트를 종료하고 설정을 백업한 다음 패키지 관리자로 새 패키지를 설치하세요. 배포판의 주요 버전을 업그레이드하면 기존 시스템 라이브러리와 데스크톱 연동이 달라질 수 있으므로 현재 패키지 요구 사항을 다시 확인해야 합니다. 전체 설정 방법과 분할 라우팅 원칙은 전체 가이드를 참고하세요. 이 페이지에서는 그래픽 클라이언트 설치 링크만 제공합니다.
다운로드 후: 설정 및 업데이트
01 / IMPORT
구독 또는 공유 링크 가져오기
설치 파일에는 클라이언트 프로그램만 포함되며 사용 가능한 서버는 제공되지 않습니다. 유효한 구독 주소가 있다면 클라이언트의 구독 그룹에 추가한 뒤 업데이트하세요. 단일 공유 링크는 클립보드에서 가져오면 됩니다. 구독 주소에는 접속 인증 정보가 포함될 수 있으므로 댓글에 공개하거나 문제 해결용 스크린샷에 전체 주소를 노출하지 마세요.
서버 설정을 선택하고 적절한 프록시 모드를 켠 뒤 브라우저로 접속을 확인하세요. 시스템 프록시는 앱에서 클라이언트로 트래픽을 전달하는 방식을 결정하고, 라우팅 규칙은 전달된 트래픽의 목적지를 정합니다. 처음 설정할 때는 구성을 단순하게 유지하고 연결이 정상인지 확인한 뒤 분할 라우팅과 TUN을 추가하면 문제를 단계별로 찾기 쉽습니다.
구독 그룹, 직접 추가한 서버, 사용자 지정 라우팅 및 DNS 설정을 백업하세요. 구독 업데이트는 서버 설정을 새로 고치는 것이지 클라이언트를 업그레이드하는 것이 아닙니다. 반대로 클라이언트를 업그레이드해도 구독이 자동으로 갱신되지는 않습니다. 업데이트 후 기존 연결을 먼저 테스트하고 고급 설정을 하나씩 복원해 여러 조건이 동시에 바뀌지 않도록 하세요.
브라우저가 파일을 끝까지 저장하지 못했거나 연결이 끊겼거나 다운로드가 진행 중인 상태라면 전송 문제입니다. 저장이 완료된 뒤 아키텍처 비호환, 종속성 누락, 서명 충돌 메시지가 표시되면 설치 문제입니다. 메시지 내용을 기록하고 해당 단계부터 점검해 플랫폼별 패키지를 무작정 바꿔 가며 시도하지 마세요. 다운로드 후 실행은 되지만 구독 업데이트나 서버 연결에 실패한다면 설치 파일을 바꾸기보다 네트워크 설정 문제로 확인해야 합니다.
다른 클라이언트로 옮길 때 설정을 가져오는 데 성공했다고 해서 모든 확장 매개변수가 지원된다는 뜻은 아닙니다. 사용하는 프로토콜과 전송 방식을 확인한 다음 코어 기능과 클라이언트 설정 화면의 지원 여부를 살펴보세요. Project V, V2Fly, Xray는 서로 관련된 오픈 소스 생태계에 속하지만 구체적인 기능은 실제 배포 버전에 따라 다릅니다. 명확한 설정 요구 사항이 있다면 UI 이름만 비교하기보다 필요한 기능을 기준으로 선택하세요.
다운로드 및 설치 FAQ
먼저 패키지 유형을 확인한 뒤 설치 메시지를 해결하세요. 아래 질문과 답변은 다운로드 선택에 초점을 맞춥니다. 구독 업데이트와 연결 문제는 FAQ에서 확인할 수 있습니다.
Windows에서는 Desktop과 WPF 중 어떤 버전을 다운로드해야 하나요?
처음 설치한다면 차세대 크로스 플랫폼 UI를 사용하는 Desktop 버전을 선택해 보세요. 기존 Windows 인터페이스에 익숙하다면 WPF 버전이 적합합니다. 두 버전 모두 현재 배포 패키지의 실행 환경 요구 사항을 확인해야 합니다. 전환하기 전에는 구독 그룹과 라우팅 설정을 백업하고, 두 클라이언트가 동시에 시스템 프록시를 제어하지 않도록 하세요.
Android arm64와 범용 버전, 어떻게 선택하나요?
2015년 이후 출시된 대부분의 스마트폰은 arm64 버전을 사용할 수 있지만, 기기와 운영체제에서 지원하는 아키텍처를 확인하세요. 아키텍처를 확인하기 어렵거나 arm64 패키지가 호환되지 않는다고 표시되면 범용 버전을 선택할 수 있습니다. 범용 버전은 더 많은 아키텍처를 포함하므로 파일 크기가 더 큰 편입니다.
macOS에서 어떤 설치 파일을 다운로드해야 하는지 어떻게 확인하나요?
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. 칩이 Apple M 시리즈라면 Apple Silicon arm64 패키지를, 프로세서가 Intel이라면 Intel x64 패키지를 선택합니다. 설치 후 보안 경고가 표시되면 먼저 다운로드 출처를 확인한 다음, 시스템 설정의 ‘개인정보 보호 및 보안’에서 안내에 따라 처리하세요.
Linux에서 deb와 rpm을 서로 바꿔 사용할 수 있나요?
배포판이 기본 지원하는 패키지 형식을 선택해야 합니다. Debian, Ubuntu 및 주요 파생 배포판은 보통 deb를 사용하고, Fedora와 RHEL 계열 및 관련 배포판은 대개 rpm을 사용합니다. x64 또는 arm64 아키텍처도 맞춰야 하며, 배포 패키지가 요구하는 시스템 라이브러리 버전도 확인하세요.
다운로드하고 설치했는데 왜 바로 연결되지 않나요?
클라이언트는 서버 설정을 가져와 사용하는 프로그램이며, 설치 파일에 구독이나 사용 가능한 서버가 포함되지는 않습니다. 유효한 공유 링크나 구독 주소를 가져오고 서버를 선택한 뒤, 시스템 프록시 또는 앱 프록시를 설정해야 합니다. 먼저 기본 연결을 확인하고 분할 라우팅과 TUN은 차례로 설정하세요.
업데이트 전에 무엇을 백업해야 하며, 버전 표기와 파일명이 다른 이유는 무엇인가요?
업데이트하기 전에 구독 그룹, 직접 추가한 서버, 라우팅 규칙, 사용자 지정 DNS 설정을 백업하고 실행 중인 클라이언트를 종료하세요. 페이지의 버전 표기와 파일명은 목록의 서로 다른 필드에서 가져오므로 배포 관리 중에는 일시적으로 다를 수 있습니다. 이를 근거로 다운로드 주소를 직접 수정하지 말고, 설치 후 ‘정보’ 화면과 업데이트 안내를 함께 확인해 실제 버전을 파악하세요.
설치 후 사용 가이드를 계속 확인하세요. 구독, 프록시 또는 라우팅 문제를 해결하려면 FAQ를 참고하세요.