v2rayN
두 설치 패키지는 구독, 노드, 라우팅 설정 로직을 동일하게 공유합니다. 처음 사용하는 경우 Desktop 버전부터 시작하는 것이 좋습니다. WPF 사용 경험이 있거나 클래식한 인터페이스가 필요하다면 WPF 버전을 선택하세요.
운영체제와 프로세서 아키텍처에 맞는 설치 패키지를 선택하세요. 데스크톱에서는 v2rayN을 사용하고, Android에서는 v2rayNG과 v2flyNG 중에서 선택할 수 있습니다. 페이지는 동일 출처의 버전 목록을 바탕으로 다운로드 주소와 버전 정보를 업데이트합니다.
Platform packages
플랫폼을 바꾸면 다운로드 카드, 시스템 요구 사항, 설치 안내가 함께 변경됩니다. URL의 플랫폼 앵커를 사용하면 현재 선택을 저장하거나 공유할 수 있습니다.
Windows에는 Desktop과 WPF 두 가지 인터페이스 버전이 있습니다. Desktop은 차세대 크로스 플랫폼 UI로, 통일된 인터페이스와 향후 크로스 플랫폼 기능을 원하는 사용자에게 적합합니다. WPF는 클래식하고 안정적인 버전으로, 오랫동안 사용된 기존 v2rayN과 설정 레이아웃이 더 비슷합니다.
두 설치 패키지는 구독, 노드, 라우팅 설정 로직을 동일하게 공유합니다. 처음 사용하는 경우 Desktop 버전부터 시작하는 것이 좋습니다. WPF 사용 경험이 있거나 클래식한 인터페이스가 필요하다면 WPF 버전을 선택하세요.
macOS 설치 패키지는 프로세서 아키텍처별로 나뉩니다. 시스템 정보에서 Apple M 시리즈 칩이 표시되면 Apple Silicon을, 프로세서 항목에 Intel이 표시되면 Intel을 선택하세요. 아키텍처를 올바르게 선택하면 설치와 이후 업데이트가 더 간단해집니다.
두 설치 패키지의 기능 범위는 같고 차이는 프로세서 아키텍처뿐입니다. 다운로드 전에 시스템 정보를 열어 칩 항목을 확인하고, Apple Silicon 기기에 Intel 패키지를 사용하거나 반대로 선택하지 않도록 하세요.
대부분의 사용자에게는 Xray 코어를 사용하고 일반적인 구독 및 라우팅 요구를 지원하는 v2rayNG를 우선 권장합니다. v2flyNG는 v2fly 코어를 사용하며 같은 플랫폼에서 선택할 수 있는 대안 클라이언트입니다. 2015년 이후 출시된 대부분의 주류 스마트폰은 arm64를 먼저 선택하고, 아키텍처를 확인할 수 없을 때는 범용 버전을 선택하세요.
대부분의 Android 사용자에게 적합합니다. arm64 패키지는 일반적인 64비트 ARM 기기에 맞춰 파일이 더 간결합니다. 범용 버전은 더 다양한 아키텍처를 지원하므로 하드웨어 정보를 확인할 수 없거나 arm64 패키지가 설치되지 않는 기기에 적합합니다.
v2fly 코어가 필요하거나 같은 플랫폼에서 별도의 설정 환경을 유지하고 싶다면 v2flyNG를 선택할 수 있습니다. 아키텍처 선택 규칙은 v2rayNG와 같습니다. 64비트 ARM이 확실하면 arm64를, 확실하지 않으면 범용 버전을 선택하세요.
Linux 설치 패키지는 배포판의 패키지 관리 체계와 프로세서 아키텍처에 모두 맞아야 합니다. Debian, Ubuntu 및 파생 배포판은 보통 deb를 사용하고, Fedora, Rocky Linux, AlmaLinux 등 rpm 계열 배포판은 rpm을 사용합니다. 일반적인 데스크톱은 x64를, ARM 기기는 arm64를 선택하세요.
먼저 배포판에서 deb와 rpm 중 무엇을 사용하는지 확인한 다음 기기가 x64인지 arm64인지 확인하세요. 일반적인 Intel 또는 AMD 데스크톱은 보통 x64를 사용합니다. ARM 데스크톱, 소형 컴퓨터, 개발 보드는 시스템 아키텍처를 확인한 뒤 선택해야 합니다.
시스템 아키텍처가 arm64 또는 aarch64로 명확히 표시될 때만 선택하세요.
Selection guide
여러 다운로드 항목이 있으면 플랫폼, 클라이언트, 아키텍처, 패키지 형식 순서로 판단하세요. 단계마다 하나의 조건만 확인하면 이름이 비슷한 파일을 잘못 선택하는 일을 줄일 수 있습니다.
Windows, macOS, Android, Linux는 서로 다른 설치 형식을 사용하므로 플랫폼을 넘나들며 사용할 수 없습니다. 브라우저 다운로드 기록에 다른 기기용 설치 패키지가 있다면 해당 플랫폼 탭으로 돌아가 다시 선택하고, 기존 파일을 그대로 복사해 사용하지 마세요.
데스크톱 플랫폼에서는 v2rayN을 선택합니다. Android에서는 v2rayNG를 우선 사용하고, v2fly 코어가 필요할 때 v2flyNG를 선택하세요. 클라이언트 이름은 비슷하지만 설정 파일 저장 방식, 인터페이스 구성, 일부 기능의 위치는 완전히 같지 않습니다.
x64, arm64, 범용 버전은 설치 패키지에 포함된 기계어의 범위를 나타냅니다. macOS에서는 시스템 정보에서 칩을 확인할 수 있고, Android에서는 기기 정보 앱이나 제조사 사양으로 확인할 수 있습니다. Linux에서는 시스템 설정 또는 터미널의 시스템 정보에서 아키텍처를 확인하세요.
이 항목은 주로 Linux에 해당합니다. deb와 rpm은 서로 다른 패키지 관리 체계에 대응하므로 프로세서 아키텍처가 같아도 패키지 형식을 무시할 수 없습니다. 올바르게 선택해야 시스템 패키지 관리 도구가 의존 관계와 업데이트 경로를 인식합니다.
After download
클라이언트는 그래픽 설정 도구일 뿐입니다. 설치 후 구독 또는 단일 공유 링크를 가져오고, 노드 목록을 업데이트한 다음 노드를 선택하세요. 이후 플랫폼에 맞게 시스템 프록시나 네트워크 가로채기 방식을 설정해야 합니다. 순서를 명확히 지키면 스위치를 반복해서 바꾸는 것보다 문제를 쉽게 찾을 수 있습니다.
시스템 안내에 따라 설치를 완료하세요. 처음 실행할 때 네트워크 액세스, 시스템 프록시, 백그라운드 실행 관련 권한을 확인하세요. 이러한 권한은 클라이언트가 대상 트래픽을 가로챌 수 있는지에 직접 영향을 줍니다.
구독 주소는 업데이트 가능한 노드 목록을 가리키며, 단일 vmess:// 또는 vless:// 링크는 하나의 설정만 나타냅니다. 가져온 후에는 구독 업데이트를 한 번 실행해 목록이 클라이언트에 저장되었는지 확인하세요.
먼저 노드 하나를 선택한 다음 용도에 맞는 라우팅 규칙을 선택하세요. 연결 문제를 점검할 때는 일단 단순한 라우팅 설정을 사용해 기본 연결을 확인하고, 정상 작동한 뒤 사용자 지정 분할 라우팅 규칙을 단계적으로 복원하세요.
시스템 프록시를 활성화한 뒤 브라우저 연결을 다시 설정하세요. 일부 앱이 이전 연결을 계속 사용한다면 완전히 종료한 후 다시 실행합니다. 도메인 확인에 문제가 있으면 클라이언트 DNS, 시스템 DNS, 라우팅 규칙 사이에 충돌이 없는지 계속 확인하세요.
Installation notes
버전 업데이트에는 인터페이스, 코어 호환성, 프로토콜 필드, 시스템 호환성 변경이 포함될 수 있습니다. 업그레이드 전에 현재 설정 구조를 기록하고, 업그레이드 후 구독, 라우팅, 시스템 프록시를 차례로 확인하세요.
구독 주소로 노드 목록은 다시 가져올 수 있지만 사용자 지정 라우팅, DNS, 구독 그룹, 포트, 시작 동작은 로컬 기기에만 저장될 수 있습니다. 업그레이드하거나 클라이언트를 바꾸기 전에 이러한 항목을 기록하고 기존 설정의 저장 위치를 확인하세요.
노드 이름만 저장하고 라우팅 규칙을 무시하면 마이그레이션 후 '노드는 연결되지만 일부 앱의 동작이 달라지는' 상황이 발생할 수 있습니다.
같은 버전 번호에도 x64, arm64, 범용 패키지가 함께 제공될 수 있습니다. 버전 번호가 같다는 것은 출시 배치가 같다는 뜻일 뿐, 모든 프로세서에 적합하다는 의미는 아닙니다. 시스템에서 실행 또는 설치할 수 없다고 표시되면 먼저 아키텍처를 다시 확인하세요.
Linux에서는 deb와 rpm도 추가로 확인해야 하며, macOS에서는 칩 항목을 중점적으로 확인하세요.
먼저 클라이언트가 실행되는지 확인하고, 그다음 구독을 업데이트한 후 노드 연결을 테스트하세요. 마지막으로 시스템 프록시와 사용자 지정 라우팅을 활성화합니다. 한 번에 한 단계씩 확인하면 클라이언트 실행 문제, 설정 문제, 네트워크 문제를 더 빠르게 구분할 수 있습니다.
기존 규칙에 이미 변경된 필드가 포함되어 있다면 여러 이전 버전을 연속으로 덮어쓰지 말고 현재 버전의 인터페이스를 참고해 다시 저장하세요.
Download FAQ
아래에서는 버전, 아키텍처, 패키지 형식, 설치 후 설정과 관련된 문제를 다룹니다. 연결 시간 초과, DNS 오류, 시스템 프록시 미작동 문제는 문제 해결 페이지에서 증상별로 계속 확인할 수 있습니다.
먼저 Desktop 버전을 권장합니다. 차세대 크로스 플랫폼 인터페이스를 사용하기 때문입니다. 클래식한 Windows 화면이나 기존 사용 방식, 전통적인 설정 레이아웃이 익숙하다면 WPF 버전을 선택하세요. 두 버전 모두 v2rayN이며, 구독 가져오기와 라우팅 설정의 핵심 절차는 거의 같습니다.
시스템 정보 또는 이 Mac에 관하여를 열고 칩 또는 프로세서 항목을 확인하세요. Apple M 시리즈가 표시되면 Apple Silicon을, Intel이 표시되면 Intel을 선택합니다. 아키텍처가 맞지 않으면 설치 프로그램이 실행되지 않거나 별도의 호환 처리가 필요할 수 있습니다.
2015년 이후 출시된 대부분의 주류 Android 스마트폰은 파일이 더 간결한 arm64를 우선 선택하면 됩니다. 프로세서 아키텍처를 확인할 수 없거나 기기가 오래되었거나 arm64 패키지가 설치되지 않을 때는 범용 버전을 선택하세요. 범용 버전은 호환 범위가 넓지만 파일 크기가 더 큰 편입니다.
Debian, Ubuntu 및 파생 배포판은 보통 deb를 선택하고, Fedora, Rocky Linux, AlmaLinux 등 rpm 계열 배포판은 rpm을 선택합니다. 프로세서 아키텍처도 확인해야 합니다. 일반적인 데스크톱은 x64를, arm64 장치는 해당 arm64 패키지를 선택하세요.
클라이언트 설치가 끝났다고 프록시 설정까지 적용된 것은 아닙니다. 사용 가능한 구독 또는 공유 링크를 가져오고, 노드 목록을 업데이트한 뒤 노드를 선택해야 합니다. 사용 환경에 따라 시스템 프록시나 해당 트래픽 가로채기 모드도 활성화하세요. 그래도 실패하면 시스템 시간, DNS, 라우팅 규칙, 노드 상태를 계속 확인해야 합니다.