클라이언트 설치 파일 및 아키텍처 선택
Android용 v2rayNG와 데스크톱용 v2rayN. 먼저 운영체제를 선택한 다음 프로세서 아키텍처를 확인하세요.
세 클라이언트는 모두 무료 오픈소스 소프트웨어입니다. 설치 후에는 사용 권한이 있는 서버 설정이나 구독 주소를 가져와야 합니다.
설치 및 설정 가져오기 안내 →새로 설치한다면 Desktop을 권장하며, 클래식 인터페이스를 계속 사용하려면 WPF를 선택할 수 있습니다. 두 링크 모두 x64 압축 파일입니다.
Desktop은 새로운 크로스 플랫폼 UI입니다. 처음 설치하거나 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하려는 경우에 적합합니다. WPF는 클래식하고 안정적인 인터페이스입니다. 서버 목록, 구독 그룹, 설정 위치에 익숙하다면 계속 사용해도 됩니다. 두 버전의 차이는 주로 인터페이스 구현과 사용 흐름에 있습니다. 인터페이스를 바꾸는 것이 서버 연결 문제의 일반적인 해결책은 아닙니다.
ZIP 파일을 다운로드한 뒤 별도 폴더에 압축을 풀고, 그 안의 설치 프로그램을 실행하세요. 압축 프로그램의 미리보기 창에서 바로 실행하지 마세요. 설치 경로는 현재 계정에서 읽고 쓸 수 있는 위치를 선택하는 것이 좋습니다. 실행 중 구성 요소가 없다는 메시지가 표시되면 시스템 안내에 따라 필요한 항목을 확인하세요. 실제 오류를 무시한 채 클라이언트 설치 파일만 반복해서 바꾸지 마세요.
| 확인 항목 | 이 페이지의 설치 파일 | 확인 방법 |
|---|---|---|
| 시스템 및 아키텍처 | Windows 64비트, x64 | 설정 → 시스템 → 시스템 정보에서 시스템 종류를 확인하세요. 두 설치 파일은 네이티브 ARM용이 아닙니다. |
| 시스템 호환성 | 지원이 계속 제공되는 Windows 10 / 11 환경에서 사용하는 것을 권장합니다. | 구형 시스템은 구체적인 버전 요구 사항과 실행 구성 요소를 먼저 확인하세요. 64비트라는 이유만으로 호환된다고 판단할 수 없습니다. |
| 파일 형식 | ZIP 압축 파일 | 압축을 완전히 푼 뒤 설치하고, 기존 설정 백업을 보관하세요. |
| 연결 제어 | 시스템 프록시 또는 클라이언트가 지원하는 TUN 모드 | 한 번에 하나의 클라이언트만 프록시를 제어하도록 하세요. 처음 테스트할 때는 시스템 프록시를 사용하세요. |
시작한 뒤 설정을 가져오고 서버 목록에서 항목을 선택한 다음 시스템 프록시를 설정하세요. 시스템 프록시는 해당 설정을 따르는 앱에만 적용됩니다. 특정 프로그램이 프록시를 거치지 않는다고 해서 설치 실패라고 단정할 수는 없습니다. 더 많은 트래픽을 제어하려면 TUN 및 라우팅 설정 안내를 확인하세요.
이 Mac에 관하여에서 칩 이름을 확인하세요. Apple Silicon은 arm64, Intel 프로세서는 x64를 선택합니다.
Apple Silicon 모델은 칩 이름이 보통 M으로 시작하므로 arm64 패키지를 선택하세요. 이 Mac에 관하여에 Intel이라고 표시되면 x64 패키지를 선택합니다. 기기 외관이나 구매 연도, 운영체제 이름으로 아키텍처를 추측하지 마세요. 같은 제품군에도 칩 구성이 다른 모델이 있을 수 있습니다. 네이티브 아키텍처를 선택하면 호환성 변환으로 인한 변수를 줄일 수 있습니다.
DMG를 연 뒤 앱을 응용 프로그램 폴더로 복사하고 해당 폴더에서 실행하세요. 처음 실행할 때 시스템 보안 경고가 표시되면 먼저 다운로드 출처를 확인한 다음 시스템 설정 → 개인정보 보호 및 보안에서 구체적인 안내를 확인하세요. 클라이언트 하나를 실행하기 위해 시스템 보안 기능 전체를 끌 필요는 없습니다.
| 확인 항목 | 선택 기준 | 유의 사항 |
|---|---|---|
| 칩 | Apple Silicon / Intel | Apple 메뉴의 이 Mac에 관하여에서 확인하세요. 기기 외관으로 판단하지 마세요. |
| 운영체제 버전 | 선택한 앱 패키지의 최소 요구 사항을 충족해야 합니다. | 아키텍처가 맞더라도 구형 시스템과 호환된다는 뜻은 아닙니다. 설치 안내와 앱 요구 사항을 확인하세요. |
| 설치 위치 | 응용 프로그램 | 복사가 끝난 뒤 실행하세요. 마운트된 디스크 이미지에서 계속 실행하지 마세요. |
| 네트워크 권한 | 사용할 기능에 필요한 권한만 허용 | 시스템 프록시를 변경하거나 TUN을 활성화할 때는 권한 안내를 읽고 승인하세요. |
앱은 열리지만 브라우저가 계속 기존 네트워크를 사용한다면 시스템 프록시 스위치, 현재 네트워크 서비스, 브라우저 자체 프록시 설정을 먼저 확인하세요. 업데이트 전에는 이전 프로세스를 종료한 뒤 앱을 교체하세요. 구독 주소가 남아 있어도 모든 로컬 규칙이 보존되는 것은 아니므로 라우팅 설정과 사용자 지정 DNS 매개변수도 기록해 두는 것이 좋습니다.
v2rayNG를 우선 권장합니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택할 수 있지만, 실제로는 시스템이 지원하는 아키텍처를 확인해야 합니다.
v2rayNG는 Xray 코어를 사용하며 Android에서 일반적인 공유 링크, 구독 설정, 라우팅 및 앱별 프록시를 관리하는 데 적합합니다. VLESS 또는 REALITY 설정을 사용한다면 설정 제공자가 안내한 매개변수를 우선 확인하세요. 프로토콜 이름만 보고 전송 계층, 보안 유형, 서버 이름을 생략하지 마세요.
arm64 패키지는 시스템에서 arm64-v8a 앱을 지원하는 기기에 적합합니다. 범용 버전에는 여러 아키텍처가 포함되어 있어 기기 아키텍처를 확인하기 어려울 때 사용할 수 있습니다. 일부 기기는 64비트 프로세서를 탑재했더라도 시스템에서 32비트 앱 환경만 제공할 수 있습니다. 따라서 구매 연도와 프로세서 사양은 참고 사항일 뿐, 실제 호환성 확인을 대신할 수 없습니다.
v2flyNG는 v2fly 코어를 사용하며, 해당 코어와 호환되는 기존 설정을 계속 사용하려는 경우에 적합합니다. 독립 실행형 앱이며 v2rayNG의 추가 구성 요소가 아닙니다. 두 클라이언트는 지원 기능과 매개변수가 다를 수 있으므로 코어 전용 항목이 포함된 설정을 그대로 서로 바꿔 쓸 수 있다고 가정하지 마세요.
다른 클라이언트에서 옮길 때는 필요한 공유 링크나 구독 정보를 먼저 내보낸 다음 라우팅, DNS, 앱별 프록시를 하나씩 확인하세요. 두 앱의 VPN 서비스를 동시에 실행하지 마세요. 특정 설정 하나만 연결되지 않는다면 설치 파일을 자주 바꾸기보다 오류 로그와 매개변수 지원 여부부터 확인하세요.
| 확인 항목 | 요구 사항 또는 옵션 | 안내 |
|---|---|---|
| 앱 아키텍처 | arm64 / 범용 버전 | 시스템 아키텍처를 모르면 범용 버전을 선택하세요. 다만 아키텍처가 맞아도 앱의 최소 시스템 요구 사항을 충족해야 합니다. |
| 설치 권한 | 현재 출처에서 앱 설치 허용 | 이번 설치에 사용할 브라우저나 파일 관리자에만 권한을 허용하고, 설치가 끝나면 해당 권한을 끌 수 있습니다. |
| VPN 권한 | 처음 연결할 때 승인 | 시스템에 연결 요청이 표시됩니다. 권한을 허용해야 클라이언트가 해당 트래픽을 제어할 수 있습니다. |
| 백그라운드 실행 | 기기 배터리 정책에 맞게 조정 | 화면을 잠갔을 때만 연결이 끊긴다면 백그라운드 제한을 확인하세요. 미리 모든 절전 옵션을 변경할 필요는 없습니다. |
설치 중 ‘앱이 설치되지 않았습니다’라는 메시지가 표시되면 시스템 버전, 앱 아키텍처, 남은 저장 공간, 설치 서명을 차례대로 확인하세요. 범용 버전은 아키텍처 호환 범위를 넓힐 뿐, 서명 충돌이나 오래된 시스템 문제를 해결하지는 못합니다. 현재 버전 표기와 파일 이름이 다르면 앱의 정보 화면이나 시스템 앱 정보에서 실제 설치 버전을 확인하세요.
배포판에서 사용하는 패키지 관리 형식을 먼저 확인한 뒤 x64와 arm64를 구분하세요. 기본 다운로드는 x64 설치 파일입니다.
Debian, Ubuntu 및 유사한 패키지 관리 시스템을 사용하는 배포판은 보통 deb를 선택합니다. RPM 패키지 관리 체계를 사용하는 배포판은 rpm을 선택하세요. 패키지 형식이 맞는 것은 첫 단계일 뿐이며, 배포판의 시스템 라이브러리, 데스크톱 환경, 소프트웨어 의존성도 설치 요구 사항을 충족해야 합니다. 특히 RPM 계열 배포판을 모두 동일한 실행 환경으로 간주하지 마세요.
그래픽 파일 관리자에서 설치 파일을 열고 시스템 소프트웨어 설치 프로그램으로 의존성을 처리하세요. 설치 프로그램에서 라이브러리가 없거나 버전이 맞지 않는다고 알리면 구체적인 오류를 먼저 확인하고 의존성을 무시하도록 강행하지 마세요. 설치 후 앱 메뉴에서 v2rayN을 실행하고 설정을 가져오세요. 시스템 프록시 적용 여부는 데스크톱 환경과 대상 앱이 해당 설정을 읽는지에 따라 달라집니다.
| 확인 항목 | 선택 기준 | 유의 사항 |
|---|---|---|
| 프로세서 아키텍처 | x64 / arm64 | amd64와 x86_64는 x64를 뜻하며, aarch64는 보통 arm64에 해당합니다. |
| 패키지 관리 형식 | deb / rpm | 배포판에 맞는 형식을 선택하세요. 확장자만 바꿔 다른 형식으로 변환할 수는 없습니다. |
| 실행 환경 | 그래픽 데스크톱 및 필수 의존성 | 이 페이지는 그래픽 클라이언트용입니다. 설치 프로그램이 실행된다고 해서 모든 실행 의존성이 충족된 것은 아닙니다. |
| 네트워크 권한 | 시스템 프록시 / TUN | 먼저 일반 프록시로 설정을 확인한 뒤 TUN을 활성화할 때는 클라이언트 안내에 따라 추가 권한을 처리하세요. |
소프트웨어가 실행되지만 일부 앱만 프록시를 거친다면 데스크톱 프록시 설정과 앱 자체의 네트워크 옵션을 먼저 확인하세요. TUN이 필요하면 다른 VPN, 가상 네트워크 인터페이스, 기존 라우팅 규칙의 영향을 먼저 확인하세요. 그래픽 클라이언트를 항상 높은 권한으로 실행하는 것을 기본 해결책으로 삼지 마세요.
설치 후
설치 파일은 ‘클라이언트 실행’을 위한 것이고, 서버 매개변수는 ‘연결 수립’을 위한 것입니다. 여러 설정을 동시에 변경해 잘못 판단하는 일을 줄이려면 순서대로 확인하세요.
단일 서버 공유 링크와 구독 주소는 서로 다른 형식입니다. 공유 링크를 복사했다면 클립보드에서 가져오고, 구독 주소를 받았다면 구독 그룹을 새로 만들어 주소를 입력한 뒤 업데이트하세요. 웹페이지 안내 주소를 구독 주소로 사용하지 말고, 가져올 때 링크 끝부분의 전송 및 보안 매개변수를 삭제하지 마세요.
가져오기가 끝나면 설정 항목 하나를 선택하고 라우팅과 DNS는 기본값으로 둔 채 시스템 프록시 또는 VPN을 시작하세요. 평소 사용하는 테스트 페이지를 열고 로그를 함께 확인해 연결 여부를 판단하세요. 클라이언트에 실행 표시가 나타나도 서비스가 시작된 것일 뿐, 서버부터 DNS 해석, 대상 사이트까지의 전체 경로가 정상이라는 뜻은 아닙니다.
단계별 설정 가져오기 및 연결 확인 →업데이트 전에 설정을 내보내고 구독 그룹, 라우팅 규칙, DNS, 앱별 프록시 설정을 별도로 저장하세요. 구독을 다시 가져오면 서버 매개변수는 복구할 수 있지만 모든 로컬 설정까지 되살아나는 것은 아닙니다. 백업 파일에는 서버 인증 정보가 포함될 수 있으므로 안전한 위치에 보관하고 공개적으로 보내지 마세요.
기존 클라이언트를 종료한 뒤 설치해 백그라운드 프로세스가 파일을 점유하지 않도록 하세요. 같은 앱이고 서명이 호환되면 보통 덮어써서 업데이트할 수 있습니다. 충돌이 발생하면 원인을 먼저 확인하고 데이터를 잃을 수 있으니 바로 삭제하지 마세요. 설치를 마친 뒤 기존 설정을 확인하고 새 기능은 하나씩 활성화하면 문제가 업데이트와 관련 있는지 판단하기 쉽습니다.
구독, 라우팅 및 DNS 설정 보기 →다운로드 관련 질문
처음 설치한다면 새로운 크로스 플랫폼 인터페이스를 사용하는 Desktop을 권장합니다. 클래식 인터페이스에 익숙하고 문제없이 사용 중이라면 WPF 버전을 계속 사용해도 됩니다. 전환하기 전에 설정을 백업하고, 두 클라이언트가 동시에 시스템 프록시를 제어하지 않도록 하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 확인해 선택하세요. 기기 출시 연도는 참고 사항이며, 실제로는 시스템이 지원하는 앱 아키텍처를 기준으로 해야 합니다. 아키텍처를 모르거나 arm64가 호환되지 않는다는 메시지가 표시되면 범용 버전을 선택하세요. 범용 버전으로도 시스템 버전이나 설치 서명 호환성 문제는 해결되지 않습니다.
클라이언트는 설정을 읽고 연결을 수립하는 역할을 하며, 설치 파일에는 바로 사용할 수 있는 서버 설정이 포함되어 있지 않습니다. 직접 관리하거나 사용 권한이 있는 공유 링크, QR 코드 또는 구독 주소를 가져온 다음 서버를 선택하고 연결을 시작해야 합니다.
같은 앱이고 설치 서명이 동일하며 시스템에서 업그레이드를 허용하면 일반적으로 덮어써서 설치할 수 있습니다. 업데이트 전에 설정을 내보내고 구독 그룹과 라우팅 설정을 기록해 두세요. 서명 충돌 메시지가 표시되더라도 바로 삭제하지 말고, 설치 파일의 출처와 백업 복원 가능 여부부터 확인하세요.
페이지의 버전 표기와 다운로드 파일 경로는 목록의 서로 다른 항목에서 가져오므로 업데이트 중에는 일시적으로 다를 수 있습니다. 실제 설치 버전은 클라이언트의 정보 화면이나 시스템 앱 정보에서 확인하세요. 페이지에 표시된 버전만으로 설치 파일의 버전을 판단하지 마세요.
먼저 서버 설정이 유효한지, 시스템 프록시 또는 VPN이 켜져 있는지 확인하고 로그에서 DNS 오류, 연결 시간 초과, 인증서 오류를 살펴보세요. 대개 설정과 네트워크 경로부터 점검해야 합니다. 앱이 실행되지 않거나 파일이 손상되었거나 패키지 아키텍처가 맞지 않는 경우에만 재다운로드를 우선 고려하세요.