클라이언트 설치 파일
플랫폼, UI 버전, CPU 아키텍처에 맞춰 선택하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 권장합니다.
기기에 맞는 설치 파일을 다운로드한 뒤 기존 구독을 가져오세요. 처음 설정할 때는 입문 가이드 →를 참고하세요.
설치 파일 선택
설치 후 설정 순서
순서 안내 · 설치 파일과 연결 설정은 별도로 준비
플랫폼 및 아키텍처
버튼에 설치 파일 종류가 표시됩니다. 시스템 요구 사항 표에서 선택 기준을 확인하고, 실제 설치 가능 여부는 시스템 안내와 현재 패키지의 의존성을 따르세요.
동일한 클라이언트의 두 가지 UI 버전입니다. 아래 다운로드는 모두 x64 시스템용입니다.
차세대 크로스 플랫폼 UI를 제공합니다. 처음 설치하거나 데스크톱 운영체제가 달라도 비슷한 사용 경험을 원한다면 이 버전을 선택하세요.
데스크톱 버전 다운로드 · x64ZIP 설치 아카이브 · 다운로드 후 압축 해제
Windows용 클래식 안정 버전입니다. 기존 WPF 창과 설정 배치에 익숙하고 현재 사용 방식을 유지하고 싶다면 적합합니다.
클래식 WPF 버전 다운로드 · x64ZIP 설치 아카이브 · 데스크톱 버전과 별도 선택
두 버전의 주요 차이는 UI 프레임워크와 조작 방식이며, 어느 한 버전이 모든 기기에 더 적합하다는 뜻은 아닙니다. 기존 설정이 있다면 버전을 바꾸기 전에 내보내고 실행 중인 클라이언트를 종료하세요. 두 인스턴스가 동시에 시스템 프록시를 제어하지 않도록 주의하세요.
설정 → 시스템 → 시스템 정보에서 시스템 종류를 확인해 운영체제와 CPU 아키텍처가 맞는지 확인하세요. 여기서 제공하는 설치 파일은 x64용이므로 Windows를 사용한다는 이유만으로 호환된다고 판단하면 안 됩니다. 조직에서 관리하는 기기라면 앱 제어 정책이 설치 프로그램 실행을 제한하는지도 확인하세요.
| 확인 항목 | 선택 기준 | 설치 전 확인 사항 |
|---|---|---|
| 시스템 아키텍처 | 두 파일 모두 x64용 | 시스템 정보에서 시스템 종류 확인 |
| 시스템 환경 | 제조사 지원이 계속되는 Windows 사용 권장 | 시스템 업데이트 및 설치 프로그램의 런타임 안내 확인 |
| 설치 파일 | ZIP에 설치 파일 포함 | 압축을 모두 푼 뒤 설치 프로그램 실행 |
| 프록시 연결 | 시스템 프록시 및 로컬 수신 포트 | 같은 연결 지점을 제어하는 다른 클라이언트 종료 |
압축 파일 미리 보기에서 프로그램을 바로 실행하지 마세요. 먼저 쓰기 가능한 위치에 아카이브를 풀고 설치 프로그램을 실행하세요. 런타임 환경이 없다는 메시지가 표시되면 전체 안내를 확인하고 시스템 지침에 따라 해결하세요. 환경 문제를 가리려고 설치 파일을 반복해서 바꾸지 마세요. 설치 후 설정을 가져오고 서버를 선택한 다음 시스템 프록시 자동 설정을 활성화하세요. 시스템 프록시를 따를지는 각 앱의 설정에 따라 다릅니다.
먼저 이 Mac에 관하여에서 칩 종류를 확인한 뒤 DMG를 선택하세요.
이 Mac에 관하여에 Apple 칩이라고 표시되면 arm64를 선택하세요. 예를 들어 M 시리즈 칩이 이에 해당합니다. 화면 크기가 아니라 실제 칩을 기준으로 선택하세요.
Apple Silicon 다운로드 · arm64DMG 디스크 이미지
이 Mac에 관하여에 Intel 프로세서라고 표시되면 x64를 선택하세요. 칩 아키텍처에 맞는 설치 파일을 선택하고, 변환 실행은 기본 선택으로 삼지 마세요.
Intel 다운로드 · x64DMG 디스크 이미지
DMG를 연 뒤 이미지 안의 안내에 따라 앱을 설치하세요. 처음 실행할 때 시스템이 차단하면 안내에 표시된 앱 이름과 출처를 먼저 확인한 다음 시스템 설정 → 개인정보 보호 및 보안에서 관련 내용을 확인하세요. 앱 하나를 설치하려고 시스템 전체 보호 기능을 끄지 마세요.
시스템 메뉴에서 이 Mac에 관하여를 열고 칩 또는 프로세서 항목을 확인하세요. Apple Silicon은 arm64, Intel은 x64에 해당합니다. 같은 제품군 이름을 사용하는 기기라도 프로세서가 다를 수 있으므로 다운로드 전에 기기에 표시된 정보를 확인하세요.
| 확인 항목 | 선택 기준 | 설치 전 확인 사항 |
|---|---|---|
| 프로세서 | Apple Silicon 또는 Intel | 이 Mac에 관하여에서 칩 또는 프로세서 확인 |
| 시스템 버전 | 현재 앱의 실행 요구 사항 충족 필요 | macOS 버전을 기록하고 실행 시 호환성 안내 확인 |
| 패키지 형식 | DMG | 이미지를 열고 안내에 따라 앱 설치 |
| 네트워크 권한 | 시스템 프록시 및 필요에 따라 활성화하는 네트워크 기능 | 권한 안내를 읽고 용도를 확인한 뒤 허용 |
설치와 첫 실행은 별개의 단계입니다. 앱이 제대로 열리지 않으면 아키텍처 불일치, 낮은 시스템 버전 또는 앱 권한 제한과 관련한 안내가 있는지 먼저 확인한 뒤 다시 다운로드할지 판단하세요. 앱은 열리지만 웹페이지에 접속할 수 없다면 연결 설정 단계의 문제입니다. 설치를 반복하는 대신 구독, 서버 선택 및 시스템 프록시를 확인하세요.
먼저 클라이언트를 선택한 다음 아키텍처를 고르세요. 2015년 이후 출시된 주류 스마트폰은 보통 arm64를 선택하면 됩니다.
대부분의 64비트 Android 스마트폰에 권장합니다. 기기가 arm64-v8a를 지원하는지 확인한 뒤 다운로드하면 더 적합한 설치 파일을 선택할 수 있습니다.
v2rayNG 다운로드 · arm64APK · arm64-v8a용
기기의 아키텍처를 확인하기 어려울 때 선택할 수 있습니다. 여러 아키텍처를 지원하지만 앱의 시스템 버전 요구 사항은 충족해야 합니다.
v2rayNG 다운로드 · 범용 버전APK · 여러 아키텍처 지원
처음 연결할 때 Android에서 VPN 연결 권한을 요청합니다. 앱 이름을 확인한 후 허용하세요. 기기에 다른 VPN 연결이 활성화되어 있다면 먼저 충돌 여부를 해결하세요. 시스템에 VPN 표시가 나타나는 것은 로컬 서비스가 설정됐다는 뜻일 뿐, 원격 연결이 가능한지까지 보장하지는 않습니다.
arm64 아키텍처를 확인했고 V2Fly 코어 생태계가 필요한 기기에 적합합니다. 설치 후 연결 설정은 별도로 가져와야 합니다.
v2flyNG 다운로드 · arm64APK · arm64-v8a용
아키텍처를 확인하지 못했을 때 선택할 수 있는 대안입니다. 범용 버전이라고 해서 시스템 버전, 서명 또는 기기 정책 제한을 우회할 수 있는 것은 아닙니다.
v2flyNG 다운로드 · 범용 버전APK · 여러 아키텍처 지원
v2flyNG와 v2rayNG는 서로 다른 코어 계열을 사용합니다. 가져오기 전에 공유 링크의 프로토콜, 전송 방식 및 보안 옵션이 현재 버전에서 지원되는지 확인하세요. 사용자 지정 JSON이나 특정 코어 전용 항목을 모든 클라이언트에서 통용되는 설정으로 간주하지 마세요.
기기 출시 시기는 대략적인 판단에만 도움이 되며 아키텍처 정보를 대신할 수 없습니다. 2015년 이후 출시된 주류 스마트폰은 보통 arm64를 선택하지만, 일부 기기는 비트 수가 다른 운영체제를 실행할 수 있습니다. 기기 설명서나 시스템 정보에서 아키텍처를 확인한 뒤 다운로드하세요. arm64 파일이 설치되지 않으면 클라이언트 문제라고 단정하지 말고 구체적인 오류를 먼저 확인하세요.
| 확인 항목 | 선택 기준 | 설치 전 확인 사항 |
|---|---|---|
| CPU 아키텍처 | arm64 또는 범용 버전 | 기기 설명서 및 시스템 정보 확인 |
| 시스템 호환성 | 현재 APK의 설치 요구 사항 확인 | Android 버전 및 시스템 설치 안내 확인 |
| 설치 출처 권한 | APK를 여는 앱에만 권한 허용 | 시스템에서 요청할 때 필요한 권한만 허용하고 설치 후 해제 가능 |
| 연결 권한 | Android VPN 서비스 권한 | 앱 이름을 확인하고 다른 VPN의 사용 여부 점검 |
시스템에 앱을 설치할 수 없다고 표시되면 아키텍처 불일치, 저장 공간 부족, 설치 출처 제한, 기존 앱과의 서명 불일치 등을 구분해 확인하세요. 마이그레이션을 진행하기 전에 현재 설정을 보존하고 중요한 설정이 남아 있는 기존 앱을 바로 삭제하지 마세요. 업그레이드 후 백그라운드 연결이 자주 끊기면 배터리 최적화와 백그라운드 활동 권한을 확인하세요. 이 권한은 APK 설치 가능 여부와는 별개의 문제입니다.
먼저 배포판에 맞는 패키지 형식을 고른 다음 CPU 아키텍처를 선택하세요.
Debian, Ubuntu 계열처럼 deb 패키지 관리 체계를 사용하는 배포판이라면 보통 여기서 선택합니다. 설치할 때 시스템 의존성을 확인하세요.
deb 다운로드 · x64amd64 패키지
arm64 기기: deb 다운로드 →Fedora, RHEL 계열처럼 rpm 패키지 관리 체계를 사용하는 배포판이라면 보통 여기서 선택합니다. 배포판 호환성도 확인하세요.
rpm 다운로드 · x64x86_64 패키지
arm64 기기: rpm 다운로드 →이 다운로드는 그래픽 데스크톱 환경용입니다. 패키지 관리자를 사용하면 의존성과 설치 상태를 확인할 수 있습니다. 의존성이 충족되지 않으면 오류 정보를 보존하고 시스템 환경을 점검하세요. 의존성 검사를 무시해 강제로 설치하지 마세요.
deb와 rpm은 패키지 형식이고 x64와 arm64는 CPU 아키텍처입니다. 두 조건이 모두 일치해야 합니다. 같은 패키지 형식이라도 배포판이나 버전이 다르면 실행되지 않을 수 있습니다. 기본 런타임 라이브러리, 데스크톱 환경 및 의존성 버전도 설치 결과에 영향을 줍니다. 다운로드 전에 시스템 정보에서 배포판 이름, 버전 및 아키텍처를 확인하세요.
| 확인 항목 | 선택 기준 | 설치 전 확인 사항 |
|---|---|---|
| 패키지 관리 체계 | deb 또는 rpm | 배포판의 소프트웨어 관리 방식에 맞춰 선택 |
| CPU 아키텍처 | x64 또는 arm64 | 시스템 정보에서 아키텍처 확인 |
| 실행 환경 | 그래픽 데스크톱 및 해당 런타임 라이브러리 | 패키지 관리자로 소프트웨어 의존성 확인 |
| 프록시 연결 | 데스크톱 프록시 설정 또는 앱별 설정 | 대상 앱이 해당 로컬 포트를 사용하는지 확인 |
설치가 끝나면 데스크톱 앱 메뉴에서 클라이언트를 실행하세요. 데스크톱 시스템 프록시, 브라우저 프록시, 다른 앱의 개별 프록시 설정은 서로 다를 수 있으므로 클라이언트가 실행 중인지 만으로 판단하면 안 됩니다. 먼저 로컬 수신 포트를 확인한 뒤 대상 앱에서 해당 연결 지점을 사용하도록 설정하세요. 특정 앱에서만 연결되지 않는다면 설치 파일을 바꾸기 전에 해당 앱의 프록시 설정과 환경을 확인하세요.
설치부터 연결까지
설치가 끝났다면 첫 단계만 완료된 것입니다. 설정 입력, 트래픽 연결 지점 및 접속 결과를 순서대로 확인하면 문제의 원인을 좁힐 수 있습니다.
클라이언트 설치 파일에는 서버가 포함되지 않습니다. 사용 권한이 있는 구독 주소, 공유 링크 또는 설정 파일을 준비한 뒤 알맞은 가져오기 방법을 선택하세요. 구독 주소는 보통 업데이트 가능한 설정 목록을 가져오는 데 사용하고, 단일 공유 링크는 특정 서버를 가져오는 데 사용합니다. 두 정보를 구분하지 않고 같은 입력란에 붙여 넣지 마세요.
가져온 뒤 서버 이름, 프로토콜, 주소 및 포트가 올바르게 표시되는지 확인하세요. 구독 업데이트에 성공해도 목록의 모든 서버에 현재 연결할 수 있다는 뜻은 아닙니다. 가져온 후 목록이 비어 있다면 네트워크 설정을 바꾸기 전에 입력 내용과 구독 응답을 확인하세요.
v2rayN의 시스템 프록시는 해당 설정을 따르는 앱이 로컬 프록시를 사용하도록 합니다. 라우팅 규칙은 요청이 코어에 전달된 뒤 어떤 아웃바운드를 사용할지 결정합니다. 두 설정은 별개로 이해해야 합니다. ‘중국 본토 우회’는 라우팅 정책이지 시스템 프록시 설정이 아니며, 모든 앱이 자동으로 클라이언트를 사용한다는 뜻도 아닙니다.
Android 클라이언트는 VPN 서비스를 통해 트래픽을 전달하며, 앱별 프록시 설정에 따라 연결 대상 앱의 범위도 달라집니다. 먼저 이해하기 쉬운 기본 설정으로 연결을 확인한 뒤 분할 라우팅이나 앱별 규칙을 조정하세요. 한 번에 한 종류의 설정만 변경하고 내용을 기록해 두면 되돌리거나 문제를 재현하기 쉽습니다.
실제로 사용할 앱을 열고 확인하기 쉬운 요청을 한 번 보낸 뒤 클라이언트 실행 로그를 확인하세요. 로컬 서비스 미실행, 앱의 프록시 미사용, 원격 연결 시간 초과, 대상 서비스 오류를 구분해야 합니다. 시스템 프록시가 켜져 있거나 Android 상태 표시줄에 VPN 아이콘이 나타나는 것만으로 실제 접속을 확인할 수는 없습니다.
문제를 확인할 때 오류 발생 시각과 필요한 상황 정보를 기록하되, 공유하기 전에 구독 주소, 서버 주소 및 접속 정보를 가리세요. 설정 항목이 궁금하다면 설정 항목 참고서를 확인하세요. 처음 사용하는 경우 입문 가이드에 따라 구독을 가져오고 연결을 설정하세요.
버전 및 설정
클라이언트 프로그램, 코어 기능 및 개인 설정은 서로 다른 요소입니다. 프로그램을 업데이트한 뒤에도 사용자 지정 설정이 유지됐는지 확인하세요.
업그레이드 전에 현재 클라이언트의 내보내기 또는 백업 기능을 사용하세요. 서버 목록뿐 아니라 구독 그룹, 사용자 지정 라우팅, DNS, 로컬 포트 및 앱별 선택도 보관해야 합니다. 구독 주소만 저장해서는 수동으로 변경한 설정을 모두 복구하기 어렵습니다. 구독을 다시 가져오면 구독에 포함된 일부 설정이 덮어써질 수도 있습니다.
백업 파일에는 인증 정보가 포함될 수 있으므로 접근이 제한된 폴더에 보관하고 공개 문의에 첨부하지 마세요. 다른 클라이언트로 옮길 계획이라면 지원하는 가져오기 형식부터 확인하세요. 공유 링크, 구독 내용, 클라이언트 데이터베이스 및 코어 JSON은 용도가 다르므로 모두 연결 설정을 담고 있다는 이유만으로 서로 바꿔 사용할 수는 없습니다.
업데이트할 때는 먼저 연결을 중지하고 기존 인스턴스를 종료한 다음 프로그램 파일을 교체하세요. 업데이트 후에는 서버 선택, 시스템 프록시 상태, 로컬 수신 포트 및 라우팅 프리셋을 확인하세요. Android 기기에서는 VPN 권한과 백그라운드 활동 설정도 확인해야 합니다. 설정과 실제 접속 결과가 모두 예상대로일 때 업그레이드 후 점검이 끝난 것입니다.
카드에 표시된 버전 정보와 실제 설치 파일 이름은 구분해서 확인하세요. 다운로드 링크는 목록 업데이트에 따라 바뀔 수 있으므로 실제 패키지와 설치 화면에 표시된 정보를 기준으로 설치하세요. 파일 이름의 길이만으로 범용 패키지인지 판단하지 말고, 버전이 더 높다는 이유만으로 모든 프로토콜 설정과 호환된다고 생각하지 마세요.
다운로드 자주 묻는 질문
시스템 아키텍처와 클라이언트별 차이부터 설정 보존까지, 다운로드 단계에서 자주 묻는 내용을 확인하세요.
처음 설치한다면 차세대 크로스 플랫폼 UI를 사용하는 v2rayN 데스크톱 버전을 권장합니다. 클래식 WPF 버전은 기존 Windows 인터페이스에 익숙한 사용자를 위한 안정적인 버전입니다. 두 버전 모두 x64용 설치 아카이브이므로 다운로드한 뒤 압축을 풀고 설치 프로그램을 실행하세요. UI 버전을 바꾸기 전에는 설정을 백업하세요.
Windows에서는 설정의 시스템 정보에서 시스템 종류를 확인하세요. macOS에서는 이 Mac에 관하여에서 칩 또는 프로세서를 확인할 수 있습니다. Android는 기기 설명서나 시스템 정보에서 아키텍처를 확인하세요. 2015년 이후 출시된 주류 스마트폰은 보통 arm64를 선택하면 됩니다. Linux에서는 배포판의 시스템 정보를 확인하세요. 기기의 외형이나 브랜드만으로 판단하지 마세요.
Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 권장합니다. v2flyNG는 V2Fly 코어를 사용하며, 해당 코어 생태계가 필요한 경우 대안으로 선택할 수 있습니다. 두 앱 모두 arm64와 범용 버전을 제공합니다. 프로토콜 및 전송 방식 지원 여부는 클라이언트와 코어 버전에 따라 다르므로, 한쪽에서 지원하는 설정 항목을 다른 쪽에도 그대로 적용하지 마세요.
설치 파일에는 클라이언트 프로그램만 포함되며, 사용할 수 있는 서버 설정은 제공되지 않습니다. 사용 권한이 있는 구독 주소, 공유 링크 또는 설정 파일을 준비해 가져온 다음 서버를 선택하세요. 이후 시스템 프록시를 설정하거나 Android VPN 권한을 허용해야 합니다. 구독 주소와 공유 링크에는 접속 정보가 포함될 수 있으므로 공개적으로 공유하지 마세요.
먼저 현재 클라이언트의 내보내기 또는 백업 기능으로 서버 설정, 구독 그룹, 사용자 지정 라우팅 및 DNS 설정을 저장하고 로컬 포트와 프록시 모드도 기록하세요. 백업에는 민감한 정보가 포함될 수 있으므로 안전한 곳에 보관해야 합니다. 업그레이드 후 설정을 하나씩 확인하세요. 구독 목록이 남아 있다는 이유만으로 이전이 완료됐다고 판단해서는 안 됩니다.
deb와 rpm은 배포판별 패키지 관리 체계에 맞춘 패키지 형식입니다. Debian, Ubuntu 계열은 보통 deb를, Fedora, RHEL 계열은 보통 rpm을 선택합니다. x64와 arm64는 CPU 아키텍처를 나타냅니다. 패키지 형식과 아키텍처가 모두 맞아야 하며, 실제 설치 가능 여부는 배포판 버전, 런타임 라이브러리 및 패키지 의존성에 따라 달라집니다.