CLIENT / PACKAGE / ARCHITECTURE
먼저 운영체제를 선택한 다음 아키텍처를 고르세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 사용하고, V2Fly 코어가 필요하면 v2flyNG를 선택하세요.
아래에서 플랫폼별 설치 파일을 확인하세요. 다운로드 후 설치와 설정 가져오기를 마친 다음 시스템 프록시, VPN 또는 Tun을 설정하세요. 각 방식은 트래픽을 처리하는 범위가 서로 다릅니다.
아키텍처를 모르겠다면 기기 외관으로 판단하지 말고 시스템 정보를 확인하세요.
01 / 다운로드
플랫폼을 바꾼 뒤 현재 페이지 주소를 복사하면 해당 플랫폼의 다운로드 링크를 저장할 수 있습니다.
Desktop 버전은 차세대 크로스 플랫폼 UI를 사용해 처음 설치하거나 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하려는 경우에 적합합니다. WPF 버전은 클래식 UI를 유지하며, 기존 서버 목록과 설정 창에 익숙한 사용자에게 안정적인 선택지입니다.
두 파일 모두 ZIP 압축 파일입니다. 먼저 전체 압축을 푼 다음 안에 있는 설치 프로그램이나 실행 파일을 실행하세요. 압축 파일 미리보기에서 바로 실행하지 마세요.
v2rayN-Desktop-Setup-x64-7.24.1.zip| 확인 항목 | 요구 조건 |
|---|---|
| 운영체제 및 아키텍처 | Windows x64. ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하세요. |
| 설치 형식 | ZIP. 쓰기 가능한 폴더에 압축을 풀고 전체 파일 구조를 유지하세요. |
| 실행 구성 요소 | 런타임이 없다는 안내가 표시되면 현재 릴리스의 안내에 따라 필요한 구성 요소를 설치하세요. |
| Tun 권한 | 클라이언트 안내에 따라 필요한 권한을 허용하세요. 일반 시스템 프록시와 Tun은 각각 확인해야 합니다. |
설치 전에 ‘시스템 종류’에 x64 기반 프로세서라고 표시되는지 확인하세요. UI가 실행된다고 해서 모든 종속 구성 요소가 준비된 것은 아닙니다. 연결을 누른 직후 코어가 종료된다면 서버 시간 초과로 단정하지 말고 로그에서 시작 오류를 먼저 확인하세요. Windows 버전과 런타임 요구 사항은 릴리스마다 달라질 수 있으므로 설치 프로그램 안내와 최신 릴리스 정보를 따르세요.
처음 실행한 뒤 ‘서버’ 메뉴에서 공유 링크를 가져오거나 ‘구독 그룹’에 구독 주소를 입력하세요. 사용할 설정을 선택한 다음 시스템 프록시를 ‘시스템 프록시 자동 설정’으로 지정하세요. 다른 UI로 전환하기 전에는 그룹과 라우팅 설정을 백업하세요. 두 인스턴스가 같은 로컬 포트를 동시에 사용하면 나중에 실행한 인스턴스에 포트 충돌이 표시될 수 있습니다.
먼저 시스템 메뉴에서 ‘이 Mac에 관하여’를 여세요. ‘칩’에 Apple M 시리즈가 표시되면 Apple Silicon을, ‘프로세서’에 Intel이 표시되면 Intel을 선택하세요. 하드웨어 아키텍처에 맞는 설치 파일을 우선 사용해 호환 모드 실행을 네이티브 지원으로 오해하지 않도록 하세요.
DMG를 연 뒤 이미지에 표시된 설치 안내를 따르고, 앱을 ‘응용 프로그램’ 폴더에 넣은 다음 실행하세요. 처음 실행할 때 시스템 설정에서 앱 실행을 허용해야 할 수 있습니다.
v2rayN-macos-arm64.dmg| 확인 항목 | 요구 조건 |
|---|---|
| Apple Silicon | Apple M 시리즈 칩이면 arm64 DMG를 선택하세요. |
| Intel | Intel 프로세서이면 x64 DMG를 선택하세요. |
| 시스템 호환성 | 현재 릴리스의 요구 사항에 맞는 macOS 버전인지 확인하세요. 열리지 않으면 시스템에 표시된 안내를 빠짐없이 기록하세요. |
| 트래픽 처리 | 시스템 프록시와 Tun은 필요한 권한과 적용 범위가 다릅니다. 용도에 맞춰 사용하세요. |
기기 출시 연도만으로 설치 파일을 선택하지 마세요. 같은 제품군이라도 칩이 다를 수 있습니다. 시스템에서 앱 아키텍처가 맞지 않는다고 안내하면 같은 파일을 반복 설치하지 말고 ‘이 Mac에 관하여’에서 프로세서를 확인하세요. 출처 확인 안내가 표시되면 macOS의 앱 열기 확인 절차를 사용하세요. 앱 하나를 실행하기 위해 전체 보안 정책을 변경하는 것은 권장하지 않습니다.
설정을 가져온 뒤 브라우저에서 시스템 프록시가 작동하는지 먼저 확인하세요. 터미널과 일부 독립 실행형 앱은 시스템 프록시를 따르지 않을 수 있으므로 브라우저가 작동하는데 특정 앱이 직접 연결된다고 해서 설정이 잘못된 것은 아닙니다. 더 많은 트래픽을 처리해야 한다면 Tun 권한과 라우팅을 확인하세요. 사용을 마칠 때는 클라이언트에서 트래픽 처리를 먼저 끄고, 종료된 프로세스를 가리키는 프록시 설정이 남지 않도록 하세요.
Android에서 우선 사용할 클라이언트로 Xray 코어를 사용합니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하세요. 기기 아키텍처를 모르거나 시스템에서 arm64 패키지를 허용하지 않으면 범용 버전을 선택할 수 있지만, 현재 릴리스의 시스템 호환성 조건은 충족해야 합니다.
설치 후 설정을 가져오고, 처음 연결할 때 시스템 VPN 권한을 허용하세요. 버전 표시와 패키지 파일명은 각각 릴리스 목록에서 가져오므로 숫자가 다를 수 있습니다. 설치 후 앱에서 실제 버전을 확인하세요.
v2rayNG_2.3.11_arm64-v8a.apk
V2Fly 코어가 필요하거나 해당 코어와의 설정 호환성이 필요한 경우 사용하는 Android용 대체 클라이언트입니다. v2rayNG의 다른 테마가 아닙니다. 프로토콜 지원과 설정 필드는 각 코어에 따라 다르므로 전환 전에 기존 공유 링크가 올바르게 인식되는지 확인하세요.
클라이언트를 바꾸기 전에 설정을 백업하세요. 실행 중인 VPN 연결을 끊은 다음 다른 클라이언트를 시작하세요. 구독 업데이트와 라우팅 설정은 두 앱에서 각각 관리해야 합니다.
v2flyNG_1.10.31-fdroid_arm64-v8a.apk| 확인 항목 | 요구 조건 |
|---|---|
| arm64 | 시스템에서 arm64-v8a 앱을 지원해야 합니다. 프로세서가 64비트라고 해서 시스템도 반드시 64비트인 것은 아닙니다. |
| 범용 버전 | 여러 아키텍처를 포함해 파일 크기가 더 큰 편이며, 앱의 최소 시스템 요구 사항은 여전히 충족해야 합니다. |
| 설치 권한 | 현재 브라우저나 파일 관리자에서 앱 설치를 허용하세요. 설치 후에는 해당 권한을 다시 해제할 수 있습니다. |
| 연결 권한 | 처음 연결할 때 VPN 권한을 허용하고, 다른 VPN 앱이 네트워크를 사용 중인지 확인하세요. |
APK 다운로드가 끝나면 다운로드 목록이나 파일 관리자에서 파일을 여세요. ‘앱이 설치되지 않았습니다’라는 안내가 나오면 저장 공간, 시스템 아키텍처, 기존 앱의 서명 출처를 먼저 확인하세요. 서명이 달라 업데이트할 수 없는 경우 바로 앱을 삭제하지 마세요. 먼저 구독과 사용자 지정 라우팅을 내보낸 뒤 이전 방법을 결정해야 앱을 삭제할 때 로컬 설정이 함께 지워지는 것을 막을 수 있습니다.
연결이 자주 끊긴다면 시스템 배터리 최적화, 백그라운드 실행 제한, 절전 모드를 확인하세요. 먼저 백그라운드에서 클라이언트가 계속 실행되도록 허용한 뒤 화면을 잠근 상태에서 연결을 테스트하세요. 앱을 열어 둔 상태에서도 연결되지 않으면 배터리 옵션만 조정하기보다 노드 설정과 로그를 먼저 확인하세요. VPN 권한은 시스템이 트래픽 처리를 허용한다는 뜻일 뿐, 원격 서버 연결 성공을 의미하지 않습니다.
먼저 배포판의 패키지 체계를 확인한 다음 CPU 아키텍처를 확인하세요. Debian, Ubuntu 등은 일반적으로 deb를 사용하며, RPM 패키지 체계를 사용하는 배포판은 rpm을 사용합니다. 확장자가 같아도 모든 배포판에서 호환되는 것은 아니므로 설치 전에 종속성과 시스템 버전 요구 사항도 확인하세요.
배포판의 소프트웨어 설치 프로그램으로 패키지를 열어 종속성 안내를 확인하는 방법을 권장합니다. 그래픽 데스크톱 환경이 필요하며, 데스크톱 클라이언트 패키지를 서버 프로그램으로 사용하지 마세요.
v2rayn_7.24.1_amd64.deb| 확인 항목 | 요구 조건 |
|---|---|
| 프로세서 | x86_64는 x64, aarch64는 arm64에 해당합니다. |
| deb 패키지 | Debian 계열 패키지 관리 체계와 호환되어야 하며 현재 패키지의 종속성 조건을 충족해야 합니다. |
| rpm 패키지 | RPM 패키지 관리 체계와 호환되어야 하며 패키지 대상 시스템 환경을 확인해야 합니다. |
| 데스크톱 및 권한 | 그래픽 데스크톱 환경이 필요합니다. 소프트웨어 설치와 Tun 사용에 필요한 권한은 시스템 안내에 따라 허용하세요. |
시스템의 ‘정보’ 또는 ‘시스템 정보’에서 배포판과 하드웨어 아키텍처를 확인한 다음 해당 파일을 소프트웨어 설치 프로그램으로 여세요. 설치 프로그램에서 종속성 문제를 알리면 필요한 구성 요소 이름을 기록하고 배포판 버전을 확인하세요. 다른 패키지 형식으로 강제 변환해 설치하는 것은 권장하지 않습니다. 형식을 변환해도 런타임 버전 차이가 자동으로 해결되지는 않습니다.
실행 후 먼저 설정을 가져오고 로그에 포트 충돌이 없는지 확인하세요. 데스크톱 환경마다 시스템 프록시 처리 방식이 다를 수 있으며 일부 앱에는 별도의 프록시 설정이 있습니다. 브라우저에서 연결을 확인한 뒤 프록시가 필요한 앱을 하나씩 테스트하세요. Tun을 켠 뒤 네트워크에 문제가 생기면 먼저 Tun을 꺼서 기존 연결을 복구한 다음 권한, DNS, 라우팅 충돌을 확인하세요. 한 번에 여러 설정을 바꾸면 원인을 비교하기 어렵습니다.
02 / 첫 실행
클라이언트 다운로드는 첫 단계일 뿐입니다. 설정 가져오기, 트래픽 처리 활성화, 연결 결과 확인은 각각 다른 항목을 점검해야 합니다. 순서대로 진행하면 설치 문제와 네트워크 설정 문제를 구분할 수 있습니다.
전체 설정 가이드 보기 →클라이언트에서 공유 링크나 구독을 가져온 다음 서버 주소, 포트, 프로토콜, 전송 매개변수가 올바르게 인식됐는지 확인하세요. 구독 주소에 접속 정보가 포함될 수 있으므로 스크린샷, 공개 게시물, 로그 공유 시 전체 주소를 노출하지 마세요.
데스크톱에서는 시스템 프록시를, Android에서는 VPN 권한을 먼저 확인하세요. Tun은 더 많은 트래픽의 라우팅 경로를 바꾸므로 용도를 명확히 한 뒤 사용해야 합니다. 시스템 프록시 설정이 완료된 것과 원격 서버에 연결할 수 있는 것은 별개의 문제이므로 따로 확인하세요.
설정 하나를 선택해 테스트하고 로그에서 연결 실패, 도메인 조회 실패, 코어 미실행 중 어떤 문제가 있는지 확인하세요. 매번 설정을 하나씩만 바꿔 다시 테스트하세요. 업데이트 후 문제가 시작됐다면 기존 설정 백업을 보관하고 UI나 설정 필드가 바뀌었는지 확인하세요.
03 / 다운로드 FAQ
처음 설치한다면 차세대 크로스 플랫폼 UI를 사용하는 Desktop 버전을 권장합니다. 기존 창 구성이 익숙하다면 클래식 안정 버전인 WPF를 선택할 수 있습니다. 두 버전 모두 시스템에 맞는 아키텍처를 선택하세요. UI를 바꾸기 전에는 설정을 백업하고, 두 인스턴스가 같은 포트를 동시에 사용하지 않도록 주의하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 다만 최종적으로는 시스템이 지원하는 앱 아키텍처를 기준으로 선택하세요. 범용 버전은 여러 아키텍처를 포함해 아키텍처를 모르거나 arm64 설치에 실패했을 때 사용할 수 있습니다. 계속 설치할 수 없다면 패키지를 반복해서 바꾸기보다 시스템 호환성, 저장 공간, 기존 앱의 서명을 확인하세요.
두 앱을 같은 설치 파일로 취급하지 마세요. v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용하므로 설정을 각각 관리해야 합니다. 전환하기 전에 보존할 설정을 내보내고, 사용할 프로토콜을 새 클라이언트가 지원하는지 확인하세요. 연결할 때는 시스템 VPN을 한 앱만 사용하도록 설정하세요.
버전 표시는 릴리스 목록의 latest 필드에서 가져오고, 다운로드 주소는 선택한 플랫폼의 download 필드에서 가져옵니다. 릴리스 정보가 갱신되는 동안 두 값이 다를 수 있습니다. 파일명만으로 설치된 버전을 판단하지 말고, 설치 후 클라이언트의 정보 또는 업데이트 확인 메뉴에서 실제 버전을 확인하세요.
클라이언트는 연결 설정을 관리하며, 설치 파일에는 사용할 수 있는 서버가 포함되어 있지 않습니다. 먼저 사용 권한이 있는 공유 링크나 구독을 가져와 활성 설정을 선택한 다음 시스템 프록시 또는 VPN을 켜야 합니다. 연결에 실패하면 로그를 확인해 설정 오류, 서버 연결 불가, 트래픽이 프록시를 거치지 않는 문제를 구분하세요.
먼저 운영체제, CPU 아키텍처, 패키지 형식이 맞는지 확인한 다음 시스템 안내, 저장 공간, 설치 권한을 점검하세요. Windows ZIP 파일은 먼저 압축을 풀어야 합니다. macOS는 Apple Silicon과 Intel을 구분하고, Linux는 deb 또는 rpm 패키지 체계에 맞춰야 합니다. Android에서는 현재 출처의 앱 설치를 허용했는지 확인하세요.