v2rayN
v2rayN은 구독 그룹, 서버 필터, 시스템 프록시, 라우팅 규칙, TUN 모드와 실행 로그 등 주요 기능을 제공합니다. 데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용해 처음 설치하거나 일관된 데스크톱 환경을 원하는 사용자에게 적합합니다. 클래식 WPF 버전은 전통적인 Windows 배치를 유지해 메뉴 위치와 기존 조작 방식에 더 가깝습니다.
운영체제에 맞는 페이지로 이동해 v2rayN, v2rayNG 또는 v2flyNG를 선택하세요. 각 항목에 인터페이스 버전, 프로세서 아키텍처와 적합한 사용 환경이 표시되어 있어, 다운로드 전에 복잡한 프로토콜 매개변수를 이해할 필요가 없습니다.
플랫폼을 전환해도 현재 페이지를 벗어나지 않으며, 주소 표시줄에 선택한 플랫폼이 함께 기록되어 해당 항목을 저장하거나 공유하기 쉽습니다.
Windows 클라이언트
두 설치 패키지는 v2rayN의 핵심 설정 기능을 공유하지만 인터페이스 기술과 조작 배치는 다릅니다. 처음 사용한다면 데스크톱 버전을 우선 선택하세요. WPF 방식에 익숙하다면 클래식 버전을 계속 사용해도 됩니다.
v2rayN은 구독 그룹, 서버 필터, 시스템 프록시, 라우팅 규칙, TUN 모드와 실행 로그 등 주요 기능을 제공합니다. 데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용해 처음 설치하거나 일관된 데스크톱 환경을 원하는 사용자에게 적합합니다. 클래식 WPF 버전은 전통적인 Windows 배치를 유지해 메뉴 위치와 기존 조작 방식에 더 가깝습니다.
| 항목 | 권장 사항 | 설명 |
|---|---|---|
| 프로세서 아키텍처 | x64 | 이 페이지에서 제공하는 두 Windows 설치 패키지는 모두 일반적인 64비트 데스크톱 프로세서용입니다. |
| 설치 권한 | 설치 프로그램이 애플리케이션 폴더에 쓸 수 있도록 허용 | 시스템에서 권한 확인 창이 표시되면 프로그램 이름을 확인한 후 계속하세요. |
| 첫 실행 | 먼저 구독을 가져온 다음 서버를 선택하세요 | 클라이언트만 설치한다고 사용할 수 있는 서버 설정이 자동으로 생성되지는 않습니다. |
| 프록시 방식 | 먼저 시스템 프록시부터 사용하세요 | 더 많은 애플리케이션 트래픽을 처리해야 할 때 TUN 모드 설정 안내를 확인하세요. |
macOS 클라이언트
macOS 설치 패키지는 Apple Silicon과 Intel 두 아키텍처로 제공됩니다. 칩에 맞는 버전을 선택하면 설치 중 아키텍처 불일치를 피하고 애플리케이션을 해당 프로세서에 맞는 네이티브 방식으로 실행할 수 있습니다.
macOS용 v2rayN은 데스크톱 버전과 동일한 주요 기능 구성을 사용해 여러 구독 그룹을 관리하고, 서버를 전환하며, 애플리케이션 라우팅 규칙을 적용하고 실행 로그를 확인할 수 있습니다. 두 다운로드 항목의 기능은 같고 프로세서 아키텍처만 다르므로, 다운로드 전에 ‘이 Mac에 관하여’에서 칩 정보를 확인하세요.
| 항목 | 권장 사항 | 설명 |
|---|---|---|
| 칩 유형 | Apple Silicon 또는 Intel | ‘이 Mac에 관하여’에 표시된 칩에 맞는 설치 패키지를 반드시 다운로드해야 합니다. |
| 설치 형식 | DMG | 디스크 이미지를 연 후 시스템 안내에 따라 애플리케이션을 응용 프로그램 폴더로 이동하세요. |
| 시스템 권한 | 필요한 경우 네트워크 및 프록시 설정 허용 | 시스템 프록시 또는 TUN 모드를 처음 활성화할 때 관련 권한 확인이 필요할 수 있습니다. |
| 설정 이전 | 구독 링크를 우선 사용하세요 | 여러 기기에서 서버 목록을 동일하게 유지해야 한다면 항목별로 입력하는 것보다 통합 구독을 관리하는 편이 쉽습니다. |
Android 클라이언트
Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 선택하세요. v2fly 코어가 필요하거나 해당 설정 방식을 계속 사용해야 한다면 v2flyNG를 선택할 수 있습니다. 두 클라이언트 모두 arm64 및 범용 설치 패키지를 제공합니다.
v2rayNG는 Android에서 널리 사용되는 그래픽 클라이언트로, 클립보드에서 구독 가져오기, QR 코드 스캔, 서버 전환, 구독 업데이트와 앱별 프록시 관리를 지원합니다. 2015년 이후 출시된 대부분의 주요 휴대전화는 용량이 더 적합한 arm64 버전을 먼저 다운로드할 수 있으며, 기기 아키텍처가 확실하지 않다면 범용 버전을 사용하세요.
v2flyNG는 일반적인 Android 프록시 클라이언트와 비슷한 인터페이스와 조작 방식을 제공하므로 v2fly 코어가 필요하거나 해당 설정을 이미 사용 중인 경우, 또는 한 기기에서 별도의 클라이언트 설정을 유지하려는 경우에 적합합니다. 특정 코어가 필요하지 않다면 위의 v2rayNG를 우선 사용하면 됩니다.
| 항목 | 권장 사항 | 설명 |
|---|---|---|
| 클라이언트 선택 | v2rayNG 우선 | v2fly 코어가 필요하거나 별도 설정을 유지해야 할 때 v2flyNG를 선택하세요. |
| 프로세서 아키텍처 | 주요 휴대전화는 arm64 우선 | 아키텍처가 확실하지 않거나 호환성 안내가 표시되면 범용 버전을 사용하세요. |
| 설치 권한 | 시스템 안내에 따라 현재 출처를 허용하세요 | 설치가 끝난 후 시스템 설정으로 돌아가 임시 설치 권한을 확인하고 해제할 수 있습니다. |
| 연결 권한 | 처음 연결할 때 확인 | 시스템에 네트워크 연결 권한 창이 표시됩니다. 확인해야 클라이언트가 로컬 연결 서비스를 만들 수 있습니다. |
Linux 클라이언트
Linux용 v2rayN은 deb와 rpm 두 종류의 설치 패키지를 제공하며 x64와 arm64 아키텍처를 각각 지원합니다. 먼저 배포판에 맞는 패키지 형식을 정한 다음 기기의 프로세서에 맞는 아키텍처를 선택하세요.
Debian, Ubuntu 및 파생 배포판은 보통 deb를 선택하고, Fedora, Rocky Linux, AlmaLinux 등은 일반적으로 rpm을 선택합니다. 일반적인 데스크톱 컴퓨터는 대부분 x64를 사용하며, ARM 프로세서가 탑재된 개발 보드, 소형 컴퓨터 또는 일부 노트북은 arm64 패키지가 필요합니다.
시스템 아키텍처가 aarch64 또는 arm64로 표시될 때만 아래 항목을 선택하세요. 패키지 형식은 배포판의 패키지 체계에도 맞아야 합니다.
| 배포판 또는 환경 | 패키지 형식 | 아키텍처 선택 |
|---|---|---|
| Debian, Ubuntu 및 파생 배포판 | deb | 데스크톱 컴퓨터는 보통 x64를, ARM 기기는 arm64를 선택합니다. |
| Fedora、Rocky Linux、AlmaLinux | rpm | uname -m 결과에 따라 해당 아키텍처를 선택하세요. |
| 데스크톱 환경 | 그래픽 세션 | v2rayN은 그래픽 클라이언트이므로 사용 가능한 데스크톱 세션과 시스템 트레이 환경이 필요합니다. |
| 프록시 애플리케이션 | 시스템 설정 또는 TUN 모드 | 설치 후에도 설정을 가져오고 현재 데스크톱 환경에 적합한 트래픽 처리 방식을 선택해야 합니다. |
클라이언트 설치는 첫 단계일 뿐입니다. 아래 순서대로 진행하면 설치 패키지 선택, 구독 가져오기와 연결 확인을 나누어 처리할 수 있어 문제가 생겼을 때 원인을 더 쉽게 찾을 수 있습니다.
Windows에서는 데스크톱 버전 또는 클래식 WPF 버전을 선택하고, macOS에서는 칩에 따라 Apple Silicon 또는 Intel을 선택합니다. Android에서는 arm64와 범용 버전 중 하나를 고르며, Linux에서는 deb 또는 rpm과 x64 또는 arm64를 모두 확인해야 합니다. 설치 패키지가 열리지 않으면 먼저 이 단계로 돌아가 확인하고 구독이나 라우팅 설정부터 변경하지 마세요.
운영체제의 설치 화면에 따라 설치를 완료하세요. 처음 실행할 때 시스템에서 네트워크 연결, 프록시 설정 또는 백그라운드 실행 권한을 요청할 수 있습니다. 이러한 권한은 클라이언트가 로컬 프록시 서비스를 만들고 시스템 설정을 적용하는 데 사용됩니다. 현재 필요한 권한만 활성화하고 나중에 시스템 설정에서 조정할 수 있습니다.
클라이언트의 구독 관리 메뉴를 열고 기존 구독 주소를 붙여 넣은 뒤 업데이트를 실행하세요. 단일 vmess://, vless:// 또는 trojan:// 링크를 받았다면 클립보드에서 가져오기 기능을 사용하세요. Android 클라이언트에서는 QR 코드로 개별 설정을 입력할 수도 있습니다. 가져온 후 서버 목록에 항목이 표시되는지 먼저 확인하세요.
서버 목록에서 설정 하나를 선택한 다음 사용 환경에 맞춰 시스템 프록시 또는 TUN 모드를 활성화하세요. 일반 브라우저와 시스템 프록시 설정을 따르는 애플리케이션은 시스템 프록시부터 시작하면 됩니다. 더 많은 애플리케이션 트래픽을 처리해야 할 때 고급 사용법의 TUN, DNS와 라우팅 항목을 확인하세요. 처음 연결하기 전에 여러 설정을 동시에 변경하는 것은 권장하지 않습니다.
연결 후 클라이언트 로그에서 설정이 정상적으로 로드되었는지, 포트가 정상적으로 수신 대기 중인지, 도메인 해석·인증·네트워크 시간 초과 메시지가 나타나는지 확인하세요. 페이지에 접속할 수 없다고 해서 반드시 클라이언트 설치 실패를 뜻하는 것은 아닙니다. 구독 내용, 서버 상태, 시스템 프록시와 로컬 네트워크가 모두 영향을 줄 수 있으므로 로그 순서에 따라 하나씩 점검하세요.
모델, 코어와 프로세서 아키텍처는 서로 다른 계층의 요소입니다. 먼저 플랫폼과 설치 패키지의 호환성을 확인한 다음 인터페이스 사용 습관과 설정 기능을 고려하면 선택 과정이 더 명확해집니다.
Windows, macOS, Linux 모두 v2rayN을 제공합니다. 세 플랫폼의 설치 형식은 다르지만 구독 그룹, 서버 목록, 라우팅 설정과 로그 확인 등 핵심 사용 방식은 비슷합니다. 여러 데스크톱 기기에서 같은 서버 목록을 사용하려면 각 기기에 동일한 구독을 가져온 뒤 시스템 프록시 방식을 각각 설정하세요.
Windows의 Desktop과 WPF는 인터페이스 구현 방식의 차이이며, 프로토콜 기능의 단순한 우열 관계가 아닙니다. 신규 사용자는 보통 Desktop이 더 적합하고, 기존 조작 절차를 따르거나 전통적인 메뉴 위치에 의존하거나 클래식 인터페이스 튜토리얼을 참고한다면 WPF가 더 편리합니다.
특별한 선호가 없다면 v2rayNG를 우선 사용하세요. Xray 코어를 사용하며 일반적인 구독 가져오기, 앱별 프록시와 라우팅 설정에 적합합니다. v2flyNG는 v2fly 코어를 사용하므로 해당 설정이 필요할 때 대안으로 선택할 수 있습니다. 두 클라이언트의 설정은 서로 독립적이므로 앱을 바꾸면 대상 클라이언트에서 구독을 다시 가져와야 합니다.
클라이언트 모델을 정한 후 arm64 또는 범용 설치 패키지를 선택하세요. arm64는 주요 64비트 ARM 휴대전화용이며, 범용 버전은 더 넓은 범위의 아키텍처를 지원해 기기 정보를 확인할 수 없을 때 적합합니다. 설치 실패 메시지에 아키텍처 불일치가 표시되면 같은 클라이언트의 다른 패키지로 바꾸면 됩니다.
Linux는 다른 플랫폼보다 선택 단계가 하나 더 있습니다. 배포판이 deb 또는 rpm을 결정하고, 프로세서가 x64 또는 arm64를 결정합니다. 패키지 형식이 틀리면 시스템 패키지 관리자가 정상적으로 인식하지 못하고, 아키텍처가 틀리면 설치 또는 실행 중 프로그램 형식 불일치가 표시됩니다.
배포판이 Debian 또는 Ubuntu 계열이면 보통 deb를 선택하고, Fedora 또는 엔터프라이즈 Linux 파생 계열이면 일반적으로 rpm을 선택합니다. 기기 아키텍처는 시스템 설정이나 uname -m으로 확인할 수 있으며 기기 외관으로 판단할 필요가 없습니다.
클라이언트를 업데이트하기 전에 클라이언트의 설정 내보내기 기능을 사용하거나 기존 구독 주소, 라우팅 규칙과 DNS 조정 항목을 기록해 두세요. 구독만 사용하는 경우에는 보통 구독 출처만 보관하면 됩니다. 여러 단일 노드, 사용자 지정 아웃바운드 또는 복잡한 라우팅을 직접 관리한다면 관련 설정도 별도로 저장해야 합니다.
업데이트 후에는 구독 그룹과 서버 목록이 모두 유지되었는지 먼저 확인한 다음 시스템 프록시를 테스트하세요. 클라이언트 업그레이드와 동시에 라우팅 및 DNS를 크게 변경하지 마세요. 연결 문제가 생겼을 때 버전 변경과 설정 변경 중 무엇이 원인인지 판단하기 어려워집니다.
아래에서는 인터페이스 버전, 프로세서 아키텍처, 패키지 형식과 첫 연결에 관한 질문을 정리했습니다. 구독, 라우팅과 문제 해결에 대한 자세한 내용은 도움말 센터에서 확인할 수 있습니다.
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 데스크톱 버전을 우선 선택하세요. 기존 Windows 방식에 익숙하거나 기존 인터페이스를 계속 사용하고 싶다면 클래식 WPF 버전을 선택할 수 있습니다. 둘 다 v2rayN이며, 주요 차이는 인터페이스 기술과 조작 배치입니다.
arm64 버전은 주류 64비트 ARM 프로세서용입니다. 2015년 이후 출시된 대부분의 일반적인 Android 휴대전화는 우선 이 버전을 선택하면 됩니다. 프로세서 아키텍처를 확인할 수 없거나 설치 중 아키텍처 불일치 메시지가 표시될 때 범용 버전으로 바꾸세요.
시스템 메뉴에서 ‘이 Mac에 관하여’를 열고 칩 또는 프로세서 항목을 확인하세요. Apple 칩 이름이 표시되면 Apple Silicon 버전을, Intel 프로세서가 표시되면 Intel 버전을 선택하면 됩니다.
Debian, Ubuntu 및 파생 배포판은 일반적으로 deb를 사용하고, Fedora, Rocky Linux, AlmaLinux 등은 보통 rpm을 사용합니다. 장치의 프로세서에 맞춰 x64 또는 arm64 아키텍처도 선택해야 합니다.
클라이언트 설치 후에도 유효한 구독 링크나 단일 노드 설정을 가져오고, 서버를 선택한 다음 적절한 시스템 프록시 또는 TUN 모드를 활성화해야 합니다. 클라이언트는 설정과 연결을 관리할 뿐 서버 정보를 자동으로 생성하지 않습니다.
구독 업데이트, 라우팅 규칙, DNS 설정과 연결 로그 관련 문제를 항목별로 정리했습니다.
도움말 센터 보기