클라이언트 다운로드 및 설치 패키지 선택
운영체제와 프로세서 아키텍처에 맞춰 설치 패키지를 선택하세요. 데스크톱 플랫폼에서는 v2rayN을 사용하고, Android에서는 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 페이지의 버전 정보는 동일한 출처의 버전 목록을 기준으로 업데이트되지만, 다운로드 전 플랫폼, 아키텍처와 패키지 형식을 다시 확인해야 합니다.
플랫폼별 설치 패키지
플랫폼을 전환한 뒤 해당 시스템에 맞는 클라이언트 목록, 기본 설치 패키지, 대체 패키지와 최소 요구 사항을 확인하세요. 각 탭에는 해당 시스템에서 사용할 수 있는 그래픽 클라이언트만 표시됩니다.
Windows x64
Windows에서는 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 두 버전 모두 같은 유형의 구독, 서버 구성, 라우팅 규칙과 시스템 프록시를 관리하며, 주요 차이는 UI 기술과 조작 방식에 있습니다.
데스크톱 버전은 차세대 크로스 플랫폼 UI를 사용하며 macOS 및 Linux 버전과 인터페이스 구성이 더 비슷합니다. 처음 설치하거나 최신 상호작용 방식을 원하는 사용자에게 적합합니다. 클래식 WPF 버전은 Windows 데스크톱 인터페이스를 사용하고, 장기간 유지된 기존 버전과 메뉴 경로가 더 비슷해 기존 조작 방식에 익숙한 사용자에게 알맞습니다. 처음 사용한다면 일반적으로 데스크톱 버전을 우선 다운로드하고, 기존 업무 흐름이 WPF 인터페이스에 의존하는 경우 클래식 버전을 선택하세요.
| 항목 | 요구 사항 | 선택 안내 |
|---|---|---|
| 운영체제 | 지원되는 64비트 Windows 데스크톱 시스템 | 시스템 구성 요소와 실행 환경을 사용할 수 있는 상태로 유지하세요. |
| 프로세서 아키텍처 | x64 | 이 페이지의 Windows 설치 패키지는 일반적인 64비트 Intel 또는 AMD 프로세서용입니다. |
| 설치 방식 | 압축 해제 후 설치 프로그램 실행 | 먼저 압축 파일 전체를 압축 해제한 다음 내부의 설치 프로그램을 실행하는 것이 좋습니다. |
| 초기 설정 | 구독 링크 또는 개별 서버 구성 | 설치가 완료되어도 유효한 구성을 가져와야 하며, 클라이언트가 서버 정보를 자동으로 생성하지는 않습니다. |
설치 전에 실행 중인 기존 버전 창을 닫아 구성 파일이 쓰기 중인 상태가 되지 않도록 하세요. 설치가 끝나면 먼저 ‘구독 그룹’을 열어 구독 주소를 추가한 뒤 구독을 업데이트합니다. 가져오기가 완료되면 구성을 하나 선택하고 실제 필요에 따라 라우팅 모드와 시스템 프록시를 설정하세요. 프로그램은 실행되지만 브라우저가 예상대로 프록시를 사용하지 않는다면 계속 재설치하기보다 먼저 시스템 프록시 스위치를 확인해야 합니다.
macOS 데스크톱
macOS 설치 패키지는 칩 아키텍처별로 나뉩니다. Apple M 시리즈 칩은 arm64를, Intel 프로세서는 x64를 선택하세요. 칩 유형과 설치 패키지가 일치해야 합니다.
v2rayN macOS 버전은 최신 데스크톱 클라이언트와 동일한 구성 관리 로직을 사용하며 구독 그룹, 노드 구성, 라우팅 규칙과 로그를 관리할 수 있습니다. 다운로드 전에 시스템 메뉴에서 ‘이 Mac에 관하여’를 열고 ‘칩’ 또는 ‘프로세서’ 항목을 확인하세요. Apple M 시리즈로 표시되면 Apple Silicon을, Intel로 표시되면 Intel을 선택합니다. 설치 패키지 아키텍처를 잘못 고르면 앱이 열리지 않거나 시스템에서 아키텍처가 호환되지 않는다고 알릴 수 있습니다.
| 항목 | 요구 사항 | 선택 안내 |
|---|---|---|
| 운영체제 | 지원되는 64비트 macOS | 먼저 시스템 유지 관리 업데이트를 완료한 뒤 현재 클라이언트를 설치하는 것이 좋습니다. |
| Apple 칩 | arm64 | ‘이 Mac에 관하여’에 Apple M 시리즈가 표시되면 Apple Silicon 패키지를 선택하세요. |
| Intel 칩 | x64 | ‘이 Mac에 관하여’에 Intel 프로세서가 표시되면 Intel 패키지를 선택하세요. |
| 설치 형식 | DMG | 디스크 이미지를 열고 시스템 안내에 따라 앱을 설치하세요. |
처음 실행하면 시스템에서 네트워크 관련 권한 확인을 요청할 수 있습니다. 이 권한은 앱이 로컬 프록시를 만들고 관련 시스템 설정을 조정할 수 있는지만 결정하며, 구독 가져오기를 대신하지는 않습니다. 권한을 허용한 뒤 구독 그룹을 추가하고 업데이트한 다음 구성과 라우팅 모드를 선택하세요. 다른 칩 아키텍처의 기기로 바꿨다면 새 기기에 맞는 설치 패키지를 다시 다운로드해야 하며, 기존 기기의 앱 파일을 그대로 복사하지 마세요.
Android 모바일
Android에서는 v2rayNG를 우선 사용합니다. v2fly 커널 브랜치가 필요한 경우 v2flyNG를 선택할 수 있습니다. 두 클라이언트 모두 arm64와 범용 설치 패키지를 제공합니다.
v2rayNG는 Android 플랫폼의 주요 선택지로, 구독 가져오기, 구성 QR 코드 스캔, 서버 목록 관리와 라우팅 모드 전환에 적합합니다. 2015년 이후 출시된 대부분의 스마트폰은 일반적으로 arm64 아키텍처를 사용하므로 arm64 버전을 우선 다운로드하면 설치 패키지 크기를 줄일 수 있습니다. 기기 아키텍처를 확인할 수 없거나 기기 모델이 오래되었거나 arm64 패키지가 설치되지 않을 때는 범용 버전을 선택하세요.
v2flyNG는 v2fly 커널 브랜치가 필요한 Android 환경을 대상으로 하며, 구성 관리 방식은 일반적인 모바일 클라이언트와 유사합니다. 선택 여부는 주로 구독에서 사용하는 프로토콜과 서버 구성이 v2fly 호환 경로에 더 적합한지에 따라 결정됩니다. 특정 커널 요구 사항이 없는 일반 사용자는 위의 v2rayNG를 먼저 사용해도 됩니다.
| 항목 | 요구 사항 | 선택 안내 |
|---|---|---|
| 프로세서 아키텍처 | arm64 또는 범용 아키텍처 패키지 | 2015년 이후 출시된 대부분의 기기는 일반적으로 arm64를 먼저 선택합니다. |
| 설치 형식 | APK | 시스템 설치 화면에서 다운로드한 설치 패키지를 여세요. |
| 클라이언트 선택 | v2rayNG 또는 v2flyNG | 기본값은 v2rayNG이며, v2fly 커널 브랜치가 명확히 필요한 경우 v2flyNG를 선택하세요. |
| 첫 연결 | 시스템 네트워크 연결 권한 | 연결을 시작할 때 시스템 안내에 따라 클라이언트의 로컬 네트워크 연결 요청을 승인하세요. |
설치가 완료되면 클립보드에서 구독 링크를 가져오거나 클라이언트의 QR 코드 스캔 기능을 사용해 개별 구성을 가져올 수 있습니다. 가져온 후 먼저 구독을 업데이트하고 서버 목록에 유효한 항목이 나타나는지 확인하세요. 모바일 클라이언트의 연결 스위치는 로컬 네트워크 채널이 설정되었다는 뜻일 뿐이며, 실제 사용 가능 여부는 구성 매개변수, 서버 상태, 라우팅 규칙과 DNS 설정에 따라 달라집니다. 구독 업데이트에 실패하면 링크 접근 가능 여부, 현재 네트워크와 업데이트 요청에 기존 프록시가 필요한지를 각각 확인하세요.
Linux 데스크톱
Linux 설치 패키지는 배포판의 패키지 형식과 프로세서 아키텍처에 따라 구분됩니다. Debian 계열은 deb, RHEL 계열은 rpm을 선택하고 기기에 맞게 x64 또는 arm64를 선택하세요.
v2rayN Linux 버전은 그래픽 인터페이스로 구독, 서버, 라우팅과 로그를 관리할 수 있습니다. Ubuntu, Debian 및 파생 배포판은 일반적으로 deb를, Fedora, Rocky Linux, AlmaLinux 및 RHEL 계열 배포판은 rpm을 선택합니다. 일반적인 데스크톱 컴퓨터는 x64를 사용하고 ARM 프로세서 기기는 arm64를 선택합니다. 먼저 패키지 형식을 판단한 뒤 아키텍처를 선택하면 설치 프로그램의 호환성 오류를 피할 수 있습니다.
시스템 아키텍처가 aarch64 또는 arm64로 표시될 때만 아래 항목을 선택하세요. 패키지 형식은 여전히 배포판에 맞춰야 합니다.
| 배포판 또는 기기 | 설치 패키지 | 아키텍처 선택 |
|---|---|---|
| Debian, Ubuntu 및 파생 배포판 | deb | 일반적인 Intel 또는 AMD 데스크톱은 x64를, ARM 기기는 arm64를 선택하세요. |
| Fedora, Rocky Linux, AlmaLinux, RHEL 계열 | rpm | x86_64는 x64를, aarch64는 arm64를 선택하세요. |
| 데스크톱 환경 | 그래픽 앱을 실행할 수 있는 데스크톱 세션 | 경량 서버 환경에서는 먼저 그래픽 데스크톱과 필수 의존성이 갖춰져 있는지 확인하세요. |
| 네트워크 설정 | 데스크톱 시스템 프록시 또는 앱 내 프록시 | 설치가 완료되면 데스크톱 환경에서 시스템 프록시가 실제로 적용되었는지 확인하세요. |
터미널에서 uname -m을 실행하면 아키텍처를 확인할 수 있습니다. 일반적으로 x86_64는 x64, aarch64는 arm64에 해당합니다. 패키지 관리자가 의존성 누락을 보고하면 먼저 현재 배포판의 소프트웨어 저장소를 통해 의존성을 보완한 뒤 설치를 다시 실행하세요. 클라이언트를 시작한 후 구독을 가져오고 구성을 선택하는 과정은 다른 데스크톱 버전과 비슷하지만, 시스템 프록시 메뉴는 데스크톱 환경에 따라 달라질 수 있습니다. 앱에서는 연결되지만 브라우저에서 적용되지 않는다면 현재 데스크톱 환경의 프록시 설정이 올바르게 기록되었는지 확인하세요.
설치 후 구성 경로
클라이언트 설치는 준비 단계일 뿐입니다. 구독 가져오기, 구성 선택, 라우팅 모드와 시스템 프록시가 함께 작동해야 앱이 예상대로 동작합니다.
먼저 운영체제에 맞는 플랫폼 탭을 선택한 뒤 칩 또는 프로세서 아키텍처를 확인하세요. Windows는 x64 설치 패키지를 제공하고, macOS는 Apple Silicon과 Intel로 구분하며, Android는 arm64와 범용 버전으로 나눕니다. Linux는 deb, rpm, x64와 arm64를 모두 구분합니다. 파일명의 버전 번호만 보고 선택해서는 안 됩니다.
데스크톱 시스템은 설치 프로그램 또는 패키지 관리자로 설치하고, Android는 시스템 설치 화면에서 APK를 여세요. 기존 버전을 업그레이드하기 전에는 실행 중인 클라이언트를 종료해 구성 파일이 사용 중인 상태가 되지 않도록 하세요. 설치가 끝나면 먼저 클라이언트가 정상적으로 열리는지 확인한 뒤 구성을 가져옵니다.
구독 링크는 여러 서버 항목을 한곳에서 관리할 때 적합하고, 개별 공유 링크나 구성은 임시로 가져올 때 유용합니다. 구독 주소를 붙여넣을 때 불필요한 공백과 줄바꿈을 제거하고 링크가 아직 유효한지 확인하세요. 구독을 업데이트한 뒤 클라이언트 목록에 인식 가능한 구성 항목이 생성되었는지 확인합니다.
구성을 하나 선택한 다음 라우팅 모드를 설정하세요. 일상적인 사용은 보통 규칙 기반 분할 라우팅으로 시작하며, 명확한 필요가 있을 때만 다른 모드로 변경합니다. 데스크톱에서는 시스템 프록시 상태도 확인하고, 모바일에서는 처음 연결할 때 시스템 네트워크 권한에 응답해야 합니다. 라우팅이나 DNS를 변경한 뒤에는 구성을 다시 불러와 이전 설정이 계속 적용되지 않도록 하세요.
클라이언트 선택 기준
세 이름은 서로 다른 플랫폼과 커널 생태계를 가리킵니다. 선택할 때는 먼저 기기 플랫폼을 확인하고, 그다음 프로토콜 호환 요구 사항을 살펴보세요. 한 기기에 모든 클라이언트를 중복 설치할 필요는 없습니다.
v2rayN은 Windows, macOS와 Linux를 지원하며, 이 페이지의 데스크톱 플랫폼에서는 주요 클라이언트로 제공됩니다. 구독 그룹, 서버 목록, 라우팅 규칙, 시스템 프록시, 로그와 커널 설정을 그래픽 인터페이스에서 관리할 수 있습니다. Windows 사용자는 차세대 데스크톱 버전과 클래식 WPF 버전 중에서 선택할 수 있고, macOS와 Linux는 칩, 아키텍처와 패키지 형식에 맞는 설치 패키지를 선택합니다.
v2rayNG는 Android의 일상적인 구성 관리에 적합하며, Xray 커널로 해당 프로토콜과 전송 구성을 처리합니다. 구독, 공유 링크와 QR 코드를 가져올 수 있고 시스템 네트워크 연결 기능을 통해 프록시가 필요한 트래픽을 처리합니다. 특정 커널 브랜치 요구 사항이 없는 모바일 사용자는 일반적으로 v2rayNG arm64 버전을 먼저 선택합니다.
v2flyNG 역시 Android용이지만 v2fly 커널 브랜치를 사용합니다. 서버 구성, 구독 형식 또는 프로토콜 조합이 해당 브랜치를 필요로 한다는 점을 확인한 경우에 더 적합합니다. 클라이언트 이름이 비슷하더라도 모든 구성 동작이 동일한 것은 아니므로, 클라이언트를 바꾼 뒤에는 구독 해석 결과, 라우팅 규칙과 DNS 설정을 다시 확인해야 합니다.
버전 업데이트에는 일반적으로 UI 변경, 프로토콜 기능 변화, 실행 환경 업데이트 또는 문제 수정이 포함됩니다. 업그레이드 전 현재 구독 그룹, 라우팅 모드와 시스템 프록시 상태를 기록해 두세요. 데스크톱에서 구성을 마이그레이션해야 한다면 먼저 기존 버전에서 구성 디렉터리와 내보내기 기능을 확인한 뒤, 새 버전에서 클라이언트가 제공하는 가져오기 경로를 통해 복원하세요. 기존 클라이언트와 새 클라이언트를 동시에 실행한 상태로 같은 구성 디렉터리를 수정하지 마세요.
Android에서 v2rayNG와 v2flyNG를 서로 전환할 때는 단순 덮어쓰기 설치가 아니라 클라이언트 마이그레이션으로 처리해야 합니다. 구독을 다시 가져온 뒤 항목 수, 프로토콜 필드, 전송 매개변수와 라우팅 규칙을 확인하세요. 특정 구독을 가져올 수 있다고 해서 그 안의 모든 구성이 현재 커널 브랜치에 적합하다는 뜻은 아닙니다.
다운로드 관련 문제
아래 질문은 플랫폼 아키텍처, 패키지 형식과 초기 설정에서 가장 자주 발생하는 선택 지점을 다룹니다.
데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용하므로 처음 설치하거나 새로운 조작 구조를 원하거나 macOS 및 Linux 버전과 비슷한 사용 경험을 원하는 사용자에게 적합합니다. 클래식 WPF 버전은 Windows 네이티브 데스크톱 기술을 기반으로 하며 장기간 유지된 기존 버전과 메뉴 경로가 더 비슷해 기존 인터페이스에 익숙한 사용자에게 알맞습니다.
두 버전 모두 Windows x64용이며 구독, 구성, 라우팅과 시스템 프록시를 관리할 수 있습니다. 기존 사용 습관이 없다면 데스크톱 버전을 먼저 선택하고, 현재 작업 흐름이 WPF 메뉴 위치에 의존한다면 클래식 버전을 선택하세요.
시스템 메뉴에서 ‘이 Mac에 관하여’를 열고 칩 또는 프로세서 항목을 확인하세요. Apple M 시리즈 칩이면 Apple Silicon arm64 버전을, Intel 프로세서면 Intel x64 버전을 선택합니다. 아키텍처를 잘못 선택하면 설치 패키지가 실행되지 않거나 시스템에서 앱이 현재 기기와 호환되지 않는다고 알릴 수 있습니다.
2015년 이후 출시된 대부분의 Android 스마트폰은 일반적으로 arm64 아키텍처를 사용하므로 arm64 버전을 우선 선택하세요. 이 버전은 해당 아키텍처에 필요한 구성 요소만 포함해 설치 패키지가 더 간결한 편입니다. 기기 아키텍처를 확인할 수 없거나 기기가 오래되었거나 arm64 버전이 설치되지 않을 때는 범용 버전으로 바꾸세요.
아키텍처 선택은 구독 내용이나 기본 조작 방식을 바꾸지 않고, 설치 패키지가 프로세서와 호환되는지만 결정합니다. arm64 버전을 이미 정상적으로 설치했다면 범용 버전을 추가로 설치할 필요가 없습니다.
Debian, Ubuntu 및 파생 배포판은 일반적으로 deb를, Fedora, Rocky Linux, AlmaLinux 및 RHEL 계열 배포판은 rpm을 선택합니다. 형식을 정한 뒤에는 프로세서 아키텍처도 확인해야 합니다. 터미널에서 uname -m의 결과가 x86_64이면 x64를, aarch64이면 arm64를 선택하세요.
패키지 형식과 프로세서 아키텍처는 서로 독립적인 조건입니다. deb 또는 rpm을 올바르게 선택했더라도 아키텍처가 틀리면 설치에 실패할 수 있습니다.
클라이언트는 구성, 라우팅과 시스템 프록시를 관리하는 역할만 합니다. 처음 실행한 뒤에는 유효한 구독 링크나 개별 서버 구성을 가져오고, 구독을 업데이트한 다음 사용할 구성을 선택해야 합니다. 사용 환경에 따라 시스템 프록시 또는 모바일 네트워크 연결도 활성화해야 합니다.
클라이언트가 실행 중인데도 앱이 예상대로 인터넷에 연결되지 않는다면 구독이 정상적으로 해석되었는지, 현재 구성이 유효한지, 라우팅 모드가 적절한지, 시스템 프록시가 적용되었는지와 DNS 설정이 맞는지를 순서대로 확인하세요. 전체 점검 절차는 문제 진단 페이지에서 확인할 수 있습니다.