Windows · x64
v2rayN
7.24.1데스크톱판은 차세대 크로스 플랫폼 UI를 사용하며, 클래식 WPF판은 익숙한 Windows 인터페이스를 유지합니다. 처음 설치한다면 데스크톱판부터 사용해 보세요.
ZIP 압축 파일입니다. 다운로드가 끝나면 먼저 압축을 푼 뒤 폴더 안의 설치 프로그램을 실행하세요.
먼저 운영체제를 선택한 다음 프로세서 아키텍처를 확인하세요.
Windows · x64
데스크톱판은 차세대 크로스 플랫폼 UI를 사용하며, 클래식 WPF판은 익숙한 Windows 인터페이스를 유지합니다. 처음 설치한다면 데스크톱판부터 사용해 보세요.
ZIP 압축 파일입니다. 다운로드가 끝나면 먼저 압축을 푼 뒤 폴더 안의 설치 프로그램을 실행하세요.
| 확인 항목 | 요구 사항 및 처리 방법 |
|---|---|
| 운영체제 및 아키텍처 | 이 페이지에서는 x64 패키지를 제공합니다. 최소 지원 운영체제 버전은 해당 릴리스 노트와 설치 프로그램의 검사 결과를 확인하세요. |
| 설치 파일 | ZIP 파일의 압축을 완전히 푸세요. 압축 파일 미리보기 창에서 설치 프로그램을 바로 실행하지 마세요. |
| 실행 환경 | 설치 프로그램에서 실행 구성 요소가 없다고 안내하면 지정된 구성 요소만 설치하세요. 이름만 보고 관련 없는 구성 요소를 설치하지 마세요. |
| 권한 및 네트워크 | 일반 프록시와 Tun 모드는 필요한 권한이 다릅니다. Tun을 켜기 전에 권한, 가상 네트워크 어댑터, 다른 VPN과의 충돌 여부를 확인하세요. |
설치 전에 실행 중인 기존 클라이언트를 종료하세요. 두 버전을 동시에 실행하면 같은 로컬 수신 포트를 점유하거나 시스템 프록시 설정을 번갈아 변경할 수 있습니다. 버전을 바꾸려면 먼저 현재 설정을 백업하고 새 UI에서 구독 그룹, 수신 포트, 라우팅 모드를 확인하세요. 연결이 정상적으로 되는 것을 확인한 뒤 이전 폴더를 정리하세요. 문제 해결의 첫 단계로 이전 버전을 삭제하지 마세요.
macOS · 칩에 맞는 파일 선택
Apple 메뉴의 ‘이 Mac에 관하여’에서 칩을 확인하세요. Apple 칩이면 Apple Silicon, Intel 프로세서면 Intel을 선택합니다.
DMG를 연 다음 디스크 이미지의 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮기고, 해당 폴더에서 실행하세요.
| 확인 항목 | 요구 사항 및 처리 방법 |
|---|---|
| 칩 아키텍처 | Apple Silicon은 arm64, Intel은 x64에 해당합니다. ‘이 Mac에 관하여’에 표시된 정보를 기준으로 선택하세요. |
| 운영체제 버전 | ‘이 Mac에 관하여’에서 버전을 확인하세요. 지원 여부는 현재 설치 파일의 안내와 해당 릴리스 노트를 기준으로 판단하면 됩니다. |
| 설치 위치 | 앱을 ‘응용 프로그램’ 폴더에 복사한 뒤 디스크 이미지를 추출하세요. 임시 마운트 위치에서 계속 실행하지 않는 것이 좋습니다. |
| 네트워크 권한 | 선택한 프록시 모드에 필요한 시스템 권한을 확인하세요. 다른 네트워크 도구와 중복으로 트래픽을 제어하지 않도록 모드를 바꾸기 전에 연결을 중지하세요. |
시스템에서 실행을 차단해도 앱을 연달아 다시 실행하지 마세요. 아키텍처 불일치, 개발자 확인 제한, 파일 손상 등 어떤 메시지인지 먼저 구분하세요. 출처를 확인한 뒤 개발자 확인 관련 옵션은 ‘시스템 설정 → 개인정보 보호 및 보안’에서 살펴볼 수 있습니다. 명확한 위험 경고가 표시되면 실행을 중단하고 출처를 다시 확인하세요. 업그레이드 전에는 기존 프록시 설정을 기록하고 클라이언트를 종료한 뒤 앱을 교체해 이전 프로세스가 파일이나 포트를 계속 점유하지 않도록 하세요.
Android · Xray 코어
2015년 이후 출시된 대부분의 스마트폰은 arm64판을 우선 선택하세요. 기기 아키텍처를 모르겠다면 범용판을 선택할 수 있지만, 실제로 지원되는 앱 아키텍처를 기준으로 해야 합니다.
APK 설치 파일입니다. VPN 모드로 처음 연결할 때 시스템의 VPN 연결 권한을 승인해야 합니다.
Android · v2fly 코어
설정이 v2fly 코어를 대상으로 작성된 경우에 적합합니다. 가져오기 전에 프로토콜과 전송 매개변수를 확인하세요. 코어마다 지원하는 기능이 모두 같다고 가정하지 마세요.
v2rayNG와는 다른 클라이언트입니다. 이전할 때 설정을 다시 가져오고 라우팅 및 앱별 설정을 각각 확인하세요.
| 확인 항목 | 요구 사항 및 처리 방법 |
|---|---|
| 프로세서 아키텍처 | arm64판은 해당 앱 아키텍처를 지원하는 기기에 적합합니다. 범용판은 여러 아키텍처를 포함하며 파일 크기가 더 큰 편입니다. |
| 운영체제 버전 | ‘설정 → 휴대전화 정보’에서 확인하세요. 구체적인 호환 범위는 현재 APK의 설치 검사와 릴리스 노트를 기준으로 판단하면 됩니다. |
| 설치 권한 | 현재 사용하는 브라우저나 파일 관리자에 필요한 설치 권한만 허용하세요. 설치가 끝나면 필요에 따라 권한을 해제할 수 있습니다. |
| VPN 및 백그라운드 | 처음 연결할 때 VPN 권한을 승인하세요. 계속 사용하려면 배터리 최적화, 백그라운드 활동, 시스템 자동 실행 제한도 확인하세요. |
APK를 열었을 때 설치할 수 없다는 메시지가 나오면 구체적인 원인을 먼저 확인하세요. 아키텍처 비호환, 운영체제 버전 미지원, 기존 앱과 서명 불일치는 각각 해결 방법이 다릅니다. 범용판은 아키텍처 선택 문제만 해결할 뿐 운영체제 버전이나 서명 제한을 우회하지 못합니다. 기기 출시 연도는 대략적인 참고 자료일 뿐입니다. 일부 기기는 프로세서가 64비트를 지원해도 운영체제에서 실행 가능한 앱 아키텍처를 제한할 수 있습니다.
클라이언트를 실행한 뒤 먼저 설정을 가져오고 연결하세요. VPN 권한은 클라이언트가 시스템 네트워크 인터페이스를 통해 트래픽을 처리하도록 허용하는 것이며, 원격 서버에 연결할 수 있다는 뜻은 아닙니다. 화면을 잠근 뒤 연결이 끊기면 배터리 최적화와 백그라운드 제한을 먼저 확인하세요. 일부 앱에서만 접속할 수 없다면 ‘앱별 프록시’가 선택 앱만 우회하는지, 선택한 앱만 프록시를 사용하는지 확인하세요. 목록을 변경한 다음 다시 연결해 새 규칙이 적용됐는지 확인합니다.
VPN 권한 및 배터리 절약 설정 안내 →Linux · deb / rpm
먼저 배포판의 패키지 형식을 확인한 다음 프로세서 아키텍처를 확인하세요. Debian·Ubuntu 계열은 보통 deb, Fedora·RHEL 계열은 주로 rpm을 사용하지만 의존성 호환성도 확인해야 합니다.
배포판의 소프트웨어 설치 프로그램으로 파일을 여세요. 의존성 문제가 있으면 설치 프로그램의 안내를 먼저 확인하고, 의존성 검사를 강제로 건너뛰지 마세요.
| 확인 항목 | 요구 사항 및 처리 방법 |
|---|---|
| 패키지 형식 | 배포판의 패키지 관리 체계에 맞춰 deb 또는 rpm을 선택하세요. 확장자만 바꿔 패키지 형식을 변환하지 마세요. |
| 하드웨어 아키텍처 | x64는 amd64 / x86_64 패키지, arm64는 arm64 / aarch64 패키지를 사용하세요. |
| 데스크톱 환경 | 그래픽 앱을 실행할 수 있는 데스크톱 환경이 필요합니다. 구체적인 시스템 라이브러리와 실행 구성 요소는 설치 프로그램의 안내를 확인하세요. |
| 프록시 적용 | 데스크톱 환경과 앱마다 시스템 프록시를 읽는 방식이 다를 수 있습니다. 먼저 앱 하나로 확인한 다음 Tun에 필요한 권한을 살펴보세요. |
설치가 끝나면 앱 메뉴에서 클라이언트를 실행하고 기본 화면이 정상적으로 표시되는지 확인하세요. 설치 프로그램의 의존성 오류와 클라이언트 실행 후 연결 실패는 서로 다른 단계의 문제이므로 따로 처리해야 합니다. 전자는 시스템 라이브러리와 패키지 호환성을, 후자는 설정, 수신 주소, 프록시 모드를 확인하세요. 일반적인 실행 문제를 해결하려고 데스크톱 세션 전체를 계속 높은 권한으로 실행하지 마세요. 일반 프록시를 확인하기 전에 여러 트래픽 제어 방식을 한꺼번에 켜지 마세요.
프로그램 실행, 설정 가져오기, 트래픽 적용은 각각 별도로 확인해야 합니다.
클라이언트 자체에는 서버가 포함되어 있지 않습니다. 사용 권한이 있는 구독 주소나 설정을 준비해 구독 그룹에 추가하고 업데이트하세요. 목록에 사용할 수 있는 설정이 표시되면 서버를 선택하면 됩니다. 구독 주소에는 접근 자격 증명이 포함될 수 있으므로 공개 댓글에 올리거나 로그와 함께 공유하지 마세요.
데스크톱에서는 현재 앱에 적합한 시스템 프록시 설정부터 사용하고, 안드로이드에서는 VPN 모드와 시스템 권한을 먼저 확인하세요. Tun 모드, 앱별 프록시, 사용자 지정 DNS는 나중에 하나씩 설정해도 됩니다. 첫 연결 전에 모두 켤 필요는 없습니다.
단계별 첫 연결 가이드 →시스템 프록시
설정 간의 관계를 보여 주는 예시이며 실제로 조작할 수 있는 컨트롤은 아닙니다. 클라이언트와 버전에 따라 메뉴 위치가 다를 수 있으니 실제 UI를 기준으로 확인하세요.
설치하거나 업데이트하기 전에 구독 그룹, 직접 추가한 설정, 사용자 지정 라우팅을 백업하세요. 백업 파일에도 민감한 정보가 들어 있을 수 있으므로 직접 관리할 수 있는 위치에 보관하세요. 업데이트 후에는 기존 모드로 먼저 연결하고 로그에 오류가 계속 기록되지 않는지 확인한 다음 고급 설정을 하나씩 복원하세요. 문제가 생겨도 여러 설정을 오가며 추측하는 대신 어떤 변경이 원인인지 파악하기 쉽습니다.
연결한 뒤 실제로 사용할 앱에서 접속을 확인하세요. 시스템 프록시 스위치가 켜져 있어도 모든 앱이 해당 설정을 읽는 것은 아닙니다. 안드로이드 알림 표시줄에 VPN 아이콘이 보여도 현재 서버 연결이 정상이라는 뜻은 아닙니다. 확인에 실패하면 클라이언트 이름, 시스템 정보, 구체적인 오류, 재현 절차를 기록하세요. 로그를 공유하기 전에 구독 주소와 인증 매개변수를 가리세요.
먼저 올바른 패키지를 선택했는지 확인한 다음 설치 권한과 연결 설정을 점검하세요.
처음 설치한다면 차세대 크로스 플랫폼 UI를 적용한 데스크톱판을 권장합니다. 클래식 WPF판은 Windows에서 안정적으로 사용할 수 있는 기존 UI 버전으로, 익숙한 화면을 선호하는 사용자에게 적합합니다. 두 버전 모두 유효한 설정을 가져와야 합니다. 전환하기 전 설정을 백업하고, 로컬 수신 포트 충돌을 피하려면 두 버전을 동시에 실행하지 마세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64판을 우선 선택하면 됩니다. 다만 기기에서 지원하는 앱 아키텍처를 확인하세요. 범용판은 여러 아키텍처를 포함하므로 기기 유형을 잘 모를 때 적합합니다. 아키텍처 비호환 메시지가 표시되면 기기 정보를 확인하고 같은 파일을 반복해서 설치하지 마세요.
클라이언트에는 사용할 수 있는 서버 설정이 포함되어 있지 않습니다. 사용 권한이 있는 구독 주소나 설정을 준비해 가져온 다음 서버를 선택하고, 시스템 프록시 또는 VPN 모드를 설정해 연결해야 합니다. 설치가 완료됐다는 것은 프로그램을 사용할 준비가 됐다는 뜻일 뿐, 네트워크 연결이 성립됐다는 의미는 아닙니다.
먼저 설정과 라우팅 구성을 백업한 뒤 이전 클라이언트를 종료하고 설치 프로그램의 안내에 따라 업데이트하세요. Android에서는 패키지명과 서명이 같고 버전 업그레이드가 허용되면 대개 덮어 설치할 수 있습니다. 서명이 다르다는 메시지가 나오면 바로 삭제하지 말고 먼저 설정을 내보내세요. 다른 클라이언트로 옮기는 작업은 일반적인 덮어쓰기가 아닙니다.
먼저 ‘이 Mac에 관하여’에서 칩을 확인해 설치 파일의 아키텍처를 잘못 선택하지 않았는지 점검한 다음, 시스템에 표시된 구체적인 메시지를 확인하세요. 개발자 확인 제한 관련 메시지가 나오면 출처를 확인한 뒤 ‘시스템 설정 → 개인정보 보호 및 보안’ 옵션을 살펴볼 수 있습니다. 파일 손상이나 악성 소프트웨어 위험 메시지가 표시되면 실행을 중단하고 출처를 다시 확인하세요. 시스템의 보안 보호 기능을 전반적으로 끄지 마세요.
먼저 다른 프록시나 VPN을 종료하고 기존 네트워크가 직접 연결되는지 확인한 다음, 클라이언트 로그와 설정이 유효한지 살펴보세요. 데스크톱에서는 ‘시스템 프록시 자동 설정’과 로컬 수신 포트를, 안드로이드에서는 VPN 권한과 백그라운드 제한을 확인하세요. 일부 앱에서만 문제가 생긴다면 앱 자체의 프록시 설정과 라우팅 규칙을 살펴보고, 여러 설정을 한꺼번에 바꾸지 마세요.