클라이언트 설치 파일 / 시스템 및 아키텍처
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 권장합니다. 운영체제를 확인한 다음 CPU 아키텍처와 설치 파일 형식을 선택하세요.
세 클라이언트는 모두 무료로 사용할 수 있으며 오픈 소스입니다. 이 사이트는 다운로드 링크와 설정 정보를 정리하고, 각 클라이언트의 배포와 개발은 해당 프로젝트에서 담당합니다.
두 링크 모두 x64 설치 파일입니다. 「설정 → 시스템 → 정보」에서 시스템 종류를 확인하세요.
Desktop: 차세대 크로스 플랫폼 UI. 처음 설치하거나 여러 데스크톱 운영체제에서 비슷한 인터페이스를 사용하고 싶은 경우에 적합합니다. 클래식 버전과 메뉴 구성이 다를 수 있으므로 구독, 라우팅, 시스템 프록시 설정은 현재 화면에 표시된 메뉴 이름을 기준으로 찾으세요.
WPF: 안정적인 클래식 버전. 기존 Windows 데스크톱 인터페이스를 사용하므로 전통적인 조작 방식에 익숙하고 기존 사용 환경을 유지하고 싶은 경우에 적합합니다. 두 버전의 차이는 인터페이스와 실행 환경에 있습니다. 인터페이스가 다르다고 같은 설정의 회선 품질이 더 좋아지는 것은 아닙니다.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 시스템 및 아키텍처 | 최신 64비트 Windows용입니다. 이 페이지의 설치 파일은 x64이며 32비트 시스템에서는 사용할 수 없습니다. |
| 실행 환경 | 최소 시스템 버전과 실행 구성 요소는 선택한 빌드의 설치 안내를 확인하세요. 파일 이름만으로 호환 여부를 판단하지 마세요. |
| 권한 | 일반 시스템 프록시와 TUN은 필요한 권한이 다릅니다. TUN을 활성화하려면 관리자 권한이 필요할 수 있습니다. |
ZIP 파일을 다운로드한 뒤 개인 쓰기 권한이 있는 폴더에 압축을 모두 푼 다음 설치 프로그램을 실행하세요. 압축 파일을 보는 창에서 바로 실행하거나 이전 버전과 새 버전의 파일을 같은 폴더에 섞어 복사하지 마세요. 설치가 끝나면 v2rayN을 실행해 기본 화면이 정상적으로 열리는지 확인한 뒤 구독 관리로 이동하세요.
컴퓨터에서 다른 프록시 프로그램을 사용 중이라면 먼저 종료하고 시스템 프록시 상태를 확인하세요. 여러 클라이언트가 동시에 프록시 포트를 변경하면 브라우저에 연결되지 않거나 프로그램을 종료한 뒤에도 이전 프록시 설정이 남을 수 있습니다. 처음에는 일반 시스템 프록시로 연결을 확인한 뒤 TUN을 설정하면 문제를 추적하기 쉽습니다.
기존 설정을 사용하는 경우 Desktop과 WPF를 전환하기 전에 설정을 내보내거나 백업하세요. 두 프로그램이 모든 데이터를 자동으로 공유한다고 가정하지 마세요. 새 인터페이스에서 구독 그룹, 라우팅 규칙, 수신 대기 포트를 확인한 뒤 이전 설치를 제거할지 결정하세요.
Apple 메뉴에서 「이 Mac에 관하여」를 열고 「칩」 또는 「프로세서」 항목에 따라 설치 파일을 선택하세요.
Apple Silicon은 arm64를 선택하세요. 「이 Mac에 관하여」에 Apple M 시리즈 칩이 표시되면 이 설치 파일을 권장합니다. 컴퓨터를 구입한 연도나 외관만으로 아키텍처를 판단하지 마세요. 같은 제품군에서도 프로세서가 다를 수 있습니다.
Intel은 x64를 선택하세요. 프로세서 항목에 Intel이 표시되면 이 설치 파일을 선택하세요. 네이티브 아키텍처용 패키지는 별도의 호환 계층이 필요할 가능성을 줄여 줍니다. 설치 중 아키텍처가 맞지 않는다는 안내가 나오면 권한을 반복해서 변경하기보다 칩을 다시 확인하세요.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 칩 아키텍처 | Apple Silicon은 arm64, Intel은 x64를 선택하세요. 설치 파일은 기기의 네이티브 아키텍처와 일치해야 합니다. |
| 시스템 호환성 | 선택한 빌드가 지원하는 macOS 버전을 사용하세요. 시스템 버전이 오래됐다는 안내가 나오면 먼저 호환성 요구 사항을 확인하세요. |
| 권한 범위 | 시스템 안내에 따라 네트워크 관련 권한을 허용하세요. TUN과 일반 시스템 프록시는 연결 방식이 다릅니다. |
DMG를 연 뒤 앱을 「응용 프로그램」 폴더로 복사하고 해당 폴더에서 실행하세요. 마운트된 디스크 이미지에서 계속 실행하면 업데이트, 권한 기록, 디스크 이미지 연결 해제 등이 이후 사용에 영향을 줄 수 있습니다. 설치가 끝나면 디스크 이미지를 추출하고 다운로드 파일은 설치 기록으로 보관할 수 있습니다.
처음 실행할 때 시스템 보안 안내가 표시되면 파일 출처와 선택한 아키텍처를 확인한 뒤 「시스템 설정 → 개인정보 보호 및 보안」에 표시된 안내에 따라 처리하세요. 앱 하나를 실행하려고 시스템 보안 기능 전체를 끄지 마세요. 앱이 호환되지 않는다는 안내가 나오면 모든 오류를 권한 문제로 단정하지 말고 시스템 버전 요구 사항을 먼저 확인하세요.
설정을 가져온 뒤 앱 서비스가 정상적으로 시작됐는지 확인하고 시스템 프록시를 설정하세요. 시스템 프록시를 사용하지 않는 앱은 앱 안에서 프록시를 따로 지정하거나 일반 연결이 정상인지 확인한 뒤 TUN을 검토해야 합니다. 연결 방식별 범위는 사용 설명서의 프록시 모드 섹션을 참고하세요.
v2rayNG를 먼저 고려하세요. 기존 설정이나 커널 호환성이 필요한 경우에만 v2flyNG를 검토하세요.
v2rayNG는 Xray 커널을 사용하며 구독 가져오기, 라우팅 설정, 앱별 프록시를 그래픽 인터페이스에서 관리할 수 있습니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택하면 됩니다. 다만 일부 기기는 여전히 32비트 시스템을 사용하므로 기기에서 실제로 지원하는 앱 아키텍처를 확인하세요.
범용 버전은 여러 아키텍처를 포함하므로 기기 종류를 바로 확인하기 어려울 때 적합합니다. arm64 버전과의 차이는 주로 패키지에 포함된 아키텍처 범위이며, 프록시 모드나 구독 유형의 차이가 아닙니다. 설치 후에는 서버 설정을 가져오고 시스템 연결 권한을 허용해야 합니다.
v2flyNG는 v2fly 커널을 사용하며 해당 커널용 설정과의 호환성이 필요한 경우 대안으로 사용할 수 있습니다. 인터페이스가 비슷해도 모든 프로토콜, 전송 옵션, 설정 확장 기능을 서로 바꿔 쓸 수 있는 것은 아닙니다. 전환하기 전에 구독에 포함된 기능을 확인하고 파일 확장자만 보고 지원 여부를 판단하지 마세요.
아키텍처 선택 방법은 위와 같습니다. 시스템이 64비트 앱을 지원하는지 확인한 뒤 arm64를 선택하고, 확실하지 않으면 범용 버전을 선택하세요. 두 클라이언트는 설정을 각각 저장할 수 있지만 Android VPN 연결은 보통 두 앱이 동시에 사용할 수 없으므로 테스트 전에 다른 클라이언트를 중지하세요.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 아키텍처 및 시스템 | arm64 패키지는 64비트 앱을 지원하는 시스템이 필요합니다. 최소 Android 버전은 설치 프로그램의 호환성 안내를 확인하세요. |
| 설치 권한 | 필요한 경우 현재 브라우저나 파일 관리자의 앱 설치를 허용하고, 설치가 끝나면 해당 출처의 권한을 해제할 수 있습니다. |
| 네트워크 권한 | 연결을 시작할 때 시스템 VPN 권한을 허용하세요. 백그라운드 실행은 절전 및 자동 시작 정책의 영향을 받을 수 있습니다. |
APK를 다운로드한 뒤 다운로드 목록이나 파일 관리자에서 여세요. 기존 앱과 충돌한다는 안내가 나오면 현재 설치된 클라이언트와 배포 경로를 먼저 확인하세요. 서명이 다른 빌드는 기존 앱 위에 바로 설치되지 않을 수 있습니다. 서둘러 앱을 삭제하지 말고, 직접 추가한 서버와 규칙을 잃지 않도록 필요한 설정을 먼저 내보내세요.
처음 연결을 시작하면 Android 시스템의 VPN 권한 창이 표시됩니다. 이 권한은 기기의 트래픽을 로컬 클라이언트로 연결하기 위한 것으로, 설정이 사용할 수 있는 상태라는 뜻은 아닙니다. 권한을 허용한 뒤에도 서버가 선택됐는지, 서비스가 실행 중인지, 구독 정보가 모두 있는지 확인하세요. 백그라운드에서 연결이 끊기면 배터리 최적화, 자동 시작, 백그라운드 네트워크 제한을 점검하세요.
앱별 프록시 설정은 어떤 앱을 연결에 포함할지 결정합니다. 문제를 확인할 때는 테스트할 브라우저가 허용 목록이나 제외 목록에 포함됐는지 먼저 확인한 뒤 라우팅을 점검하세요. 다른 VPN 앱이 실행 중이면 먼저 연결을 끊으세요. 자세한 조작 방법은 사용 설명서를, 커널별 차이는 클라이언트 선택 가이드를 참고하세요.
먼저 배포판의 패키지 관리 체계를 확인한 다음 프로세서 아키텍처를 확인하세요. deb와 rpm은 파일 크기만으로 선택할 수 없습니다.
deb는 Debian 패키지 관리 체계를 사용하는 배포판용이고, rpm은 RPM 패키지 관리 체계를 사용하는 배포판용입니다. 파일 형식이 맞더라도 패키지 관리자로 라이브러리 의존성과 배포판 호환성을 확인해야 합니다. 의존성을 무시하도록 강제해 설치 오류를 해결하지 마세요.
x64는 deb 파일 이름에 보통 amd64, rpm에는 x86_64로 표기됩니다. rpm에서는 arm64를 aarch64로 표기하는 경우가 많습니다. 이러한 이름은 프로세서 아키텍처를 나타내며 클라이언트 기능 등급을 뜻하지 않습니다. 일반 데스크톱과 ARM 기기는 각각 알맞은 빌드를 선택하세요.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 데스크톱 환경 | 그래픽 앱을 실행할 수 있는 데스크톱 세션이 필요합니다. 이 페이지에서는 그래픽 클라이언트 설치 파일을 제공합니다. |
| 패키지 및 의존성 | 배포판에 맞춰 deb 또는 rpm을 선택하세요. 의존성과 기본 라이브러리 버전은 시스템 패키지 관리자가 확인합니다. |
| 아키텍처 및 권한 | x64 또는 arm64를 선택하세요. TUN을 사용하려면 추가 시스템 권한과 라우팅 설정이 필요할 수 있습니다. |
파일 관리자에서 설치 파일을 열고 배포판의 소프트웨어 설치 도구로 의존성을 확인하세요. 데스크톱 설치 프로그램에서 구성 요소가 없다고 안내하면 의존성 저장소와 시스템 호환성을 먼저 확인한 뒤 다시 설치하세요. RPM을 사용하는 모든 배포판에서 같은 rpm 파일이 바로 실행되는 것은 아닙니다.
처음 실행한 뒤 클라이언트 서비스가 정상적으로 작동하는지 확인하고 데스크톱 시스템 프록시를 설정하세요. 데스크톱 환경, 브라우저, 앱마다 프록시 설정을 읽는 방식이 다를 수 있습니다. 클라이언트 창이 열려도 모든 앱이 연결된 것은 아닙니다. 먼저 시스템 프록시를 따르는 앱 하나로 테스트한 뒤 다른 프로그램으로 범위를 넓히세요.
TUN을 활성화하면 가상 네트워크 인터페이스, 라우팅, DNS 설정이 필요합니다. 기존 네트워크 설정을 기록하고 일반 프록시가 작동하는지 확인한 뒤 설명서에 따라 하나씩 설정하세요. 권한이 부족하면 해당 기능에 필요한 권한만 처리하고, 데스크톱 세션 전체를 계속 높은 권한으로 실행하지 마세요.
설치 후 설정 이어가기
설치 파일은 프로그램을 설치하고, 실제 연결은 구독 정보와 연결 방식, 라우팅 설정에 따라 달라집니다. 순서대로 설정하면 여러 항목을 한꺼번에 변경하는 것보다 문제를 찾기 쉽습니다.
사용 권한이 있는 구독 주소나 서버 정보를 준비해 클라이언트의 구독 관리에서 그룹을 추가하고 업데이트하세요. 목록에 설정이 표시되면 서버 하나를 선택한 뒤 서비스를 시작합니다. 구독 주소에 접근 인증 정보가 포함될 수 있으므로 전체 주소를 공개된 스크린샷이나 문의에 올리지 마세요.
그런 다음 시스템 프록시 또는 Android VPN 연결 방식을 선택하고 대상 앱을 지정해 테스트하세요. 서비스가 시작되지 않은 문제, 앱이 연결에 포함되지 않은 문제, 원격 서버에 도달할 수 없는 문제는 각각 다른 원인입니다. 글로벌 모드와 우회 모드는 라우팅을 선택하는 기능이며 서비스 실행이나 시스템 권한을 대신하지 않습니다.
단계별 첫 연결 안내 →업데이트 전에 구독 그룹, 사용자 지정 라우팅, DNS 설정을 저장하고 수신 대기 포트와 TUN 상태를 기록하세요. 프로그램 파일이 사용 중이지 않도록 이전 프로세스를 종료한 뒤 설치합니다. 새 버전을 실행하면 데이터 폴더와 설정이 올바르게 읽혔는지 먼저 확인하고, 구독을 모두 다시 만들지는 마세요.
버전 정보와 패키지 파일 이름은 배포 정보를 식별하는 데 사용하세요. 설치 파일은 시스템, 아키텍처, 빌드 유형에 맞춰 선택해야 합니다. 업데이트 후 문제가 생기면 로그를 확인하고 변경 사항을 점검하세요. 연결을 복구한 다음 고급 기능을 하나씩 활성화하고, 문제 해결의 기준으로 사용할 정상 설정을 하나 남겨 두세요.
사용 설명서 및 유지 관리 안내 →패키지 안내 / 다운로드 FAQ
네. 클라이언트는 설정을 읽고 앱 트래픽을 연결해 커널을 실행합니다. 설치 파일에는 사용할 수 있는 서버나 구독 정보가 포함되어 있지 않습니다. 사용 권한이 있는 구독 주소나 서버 정보를 준비해 클라이언트에 가져온 뒤 프록시 모드를 선택하세요.
처음 사용한다면 차세대 크로스 플랫폼 인터페이스를 적용한 Desktop 버전을 권장합니다. 기존 Windows 조작 방식에 익숙하다면 안정적인 클래식 WPF 버전을 선택할 수 있습니다. 둘 다 v2rayN이므로 전환하기 전에 구독 그룹과 사용자 지정 규칙을 백업하고, 두 인스턴스가 동시에 시스템 프록시를 관리하지 않도록 하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택하면 됩니다. 다만 시스템이 64비트 앱을 지원하는지 확인하세요. 아키텍처를 확인할 수 없거나 arm64 설치 시 호환되지 않는다는 안내가 나오면 여러 아키텍처를 포함한 범용 버전을 선택할 수 있습니다. 범용 버전은 대체로 용량이 더 크며, 연결 성능이 더 좋다는 뜻은 아닙니다.
구독 그룹, 사용자 지정 서버, 라우팅 규칙, DNS 설정을 먼저 백업하고 시스템 프록시와 TUN의 활성화 상태도 기록해 두세요. 이전 클라이언트를 종료한 다음 업데이트를 설치하세요. 새 버전을 실행하면 설정이 정상적으로 읽혔는지 확인한 뒤 연결을 복원합니다. 백업에 민감한 연결 정보가 포함될 수 있으므로 직접 관리할 수 있는 위치에 보관하세요.
구독 정보가 업데이트됐는지, 서버를 선택했는지 먼저 확인한 다음 시스템 시간, 서비스 실행 여부, 로그 오류를 점검하세요. 데스크톱에서는 시스템 프록시나 TUN 설정을, Android에서는 VPN 권한과 앱별 프록시 설정을 확인합니다. 정상 작동이 확인된 설정으로 먼저 테스트한 뒤 라우팅과 DNS를 하나씩 조정해 여러 변수를 동시에 바꾸지 않도록 하세요.