v2rayN
Windows x64 GUI 클라이언트로, 데스크톱 버전과 클래식 WPF 버전 두 가지 UI 계열을 제공합니다.
차세대 크로스 플랫폼 UI입니다. 처음 설치하거나 새로운 인터페이스를 사용하려면 우선 선택하세요.
익숙하고 안정적인 인터페이스입니다. 이전 버전의 메뉴 구조에 익숙하거나 기존 작업 흐름을 유지해야 할 때 선택하세요.
// CLIENT PACKAGES
데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 우선 선택하세요. 운영체제, 프로세서 아키텍처, UI 버전을 확인한 뒤 알맞은 설치 패키지를 다운로드하면 됩니다.
// PLATFORM SELECTOR
네 플랫폼별로 호환 클라이언트, 기본 설치 패키지, 대체 아키텍처와 기본 시스템 요구 사항을 정리했습니다. 플랫폼을 전환하면 페이지 주소도 해당 앵커로 동기화됩니다.
// WINDOWS PACKAGES
데스크톱 버전은 차세대 크로스 플랫폼 UI를 사용해 처음 설치하거나 통일된 데스크톱 환경을 원하는 사용자에게 적합합니다. 클래식 WPF 버전은 기존 Windows 인터페이스와 조작 구성을 유지하므로 익숙한 환경에 알맞습니다. 두 진입점 모두 v2rayN이며, 차이는 주로 GUI 기술과 상호작용 레이아웃에 있습니다.
Windows x64 GUI 클라이언트로, 데스크톱 버전과 클래식 WPF 버전 두 가지 UI 계열을 제공합니다.
차세대 크로스 플랫폼 UI입니다. 처음 설치하거나 새로운 인터페이스를 사용하려면 우선 선택하세요.
익숙하고 안정적인 인터페이스입니다. 이전 버전의 메뉴 구조에 익숙하거나 기존 작업 흐름을 유지해야 할 때 선택하세요.
| 확인 항목 | 권장 사항 |
|---|---|
| 프로세서 아키텍처 | 이 페이지의 Windows 설치 패키지는 x64 시스템용입니다. ‘시스템 정보’의 시스템 유형 항목에서 확인할 수 있습니다. |
| 설치 권한 | 설치 프로그램이 애플리케이션 디렉터리에 파일을 기록해야 합니다. 관리되는 기기에서 권한 메시지가 표시되면 해당 기기의 관리 정책에 따라 처리하세요. |
| 처음 실행 | 실행 후 먼저 구독 또는 단일 설정을 가져오고, 구독 그룹을 업데이트한 다음 설정을 선택하여 코어를 시작하세요. |
| 시스템 프록시 | 클라이언트가 실행 중이라고 해서 시스템 트래픽이 자동으로 연결되는 것은 아닙니다. 사용 방식에 따라 시스템 프록시를 켜거나 애플리케이션 프록시를 설정해야 합니다. |
// MACOS PACKAGES
macOS 설치 패키지는 프로세서 아키텍처별로 나뉩니다. Apple M 시리즈 칩은 Apple Silicon arm64 버전을, Intel 프로세서는 x64 버전을 선택하세요. 아키텍처가 일치해야 하며, 기기 외관이나 구입 연도만으로 판단하면 오류가 생길 수 있으므로 다운로드 전에 시스템 정보에서 칩 항목을 확인해야 합니다.
Apple Silicon 및 Intel용 설치 패키지를 각각 제공하는 macOS 데스크톱 GUI 클라이언트입니다.
Apple M 시리즈 칩을 탑재한 기기용이며 arm64 아키텍처에 해당합니다.
| 확인 항목 | 권장 사항 |
|---|---|
| 칩 유형 | 시스템 정보에서 칩 또는 프로세서 이름을 확인하세요. M 시리즈는 arm64, Intel 프로세서는 x64에 해당합니다. |
| 설치 파일 | 다운로드가 완료되면 dmg를 열고 시스템 안내에 따라 애플리케이션을 응용 프로그램 디렉터리로 옮기세요. |
| 처음 열기 | 시스템 보안 안내에 따라 앱 출처와 열기를 확인하세요. 서로 다른 아키텍처 파일을 반복해서 다운로드해 덮어쓰려고 하지 마세요. |
| 프록시 권한 | 시스템 프록시나 관련 네트워크 기능을 켤 때 시스템에서 권한 확인을 요청할 수 있습니다. 설정을 마친 뒤 클라이언트 상태를 다시 확인하세요. |
// ANDROID PACKAGES
일반적인 사용 환경에서는 Xray 코어를 사용하는 v2rayNG를 먼저 선택하세요. v2fly 코어가 필요하거나 기존 설정이 v2fly 동작을 기준으로 관리되고 해당 호환 경로가 필요할 때만 v2flyNG를 사용하면 됩니다. 두 클라이언트 모두 arm64와 범용 버전을 제공하며, 2015년 이후 출시된 대부분의 스마트폰은 보통 arm64를 먼저 선택합니다.
Xray 코어를 사용하는 Android GUI 클라이언트로, 일반적인 사용 환경의 기본 선택에 적합합니다.
2015년 이후 출시된 대부분의 Android 스마트폰용이며, 해당 아키텍처 리소스만 포함합니다.
프로세서 아키텍처를 확인할 수 없거나 arm64 파일이 호환되지 않을 때 선택하세요.
v2fly 코어를 사용하는 Android GUI 클라이언트로, 특정 코어 호환성이 필요한 환경에 적합합니다.
기기 아키텍처가 arm64임을 확인한 경우 선택하세요. 파일 구성이 더 간결합니다.
기기 아키텍처를 확인할 수 없거나 전용 아키텍처 패키지를 설치할 수 없을 때 사용하세요.
| 확인 항목 | 권장 사항 |
|---|---|
| 아키텍처 버전 | 대부분의 스마트폰에서는 arm64를 먼저 시도하세요. 아키텍처를 알 수 없거나 호환되지 않는다는 메시지가 표시될 때만 범용 버전으로 바꾸면 됩니다. |
| 클라이언트 선택 | 일반적인 환경에서는 v2rayNG를 먼저 사용하고, v2fly 코어 호환 경로가 명확히 필요할 때는 v2flyNG를 사용하세요. |
| 설치 권한 | 브라우저나 파일 관리자로 설치 패키지를 열면 시스템에서 해당 출처의 설치 권한을 확인하도록 요청할 수 있습니다. |
| 첫 연결 | 구독을 가져온 뒤 먼저 그룹을 업데이트하고 설정을 선택한 다음 연결을 시작하세요. 구독 주소만 추가한다고 설정이 자동으로 선택되지는 않습니다. |
// LINUX PACKAGES
Linux 설치 패키지는 먼저 배포판의 패키지 관리 체계에 따라 deb 또는 rpm을 선택한 뒤, 기기의 프로세서에 맞춰 x64 또는 arm64를 선택하세요. Debian, Ubuntu 및 파생 배포판은 보통 deb를 사용하고, Fedora, RHEL 계열 및 rpm 체계를 사용하는 배포판은 보통 rpm을 사용합니다.
deb, rpm 및 두 가지 프로세서 아키텍처 설치 패키지를 제공하는 Linux 데스크톱 GUI 클라이언트입니다.
x86_64 기반 Fedora, RHEL 계열 및 관련 배포판용입니다.
기기 명령 결과가 aarch64 또는 arm64이면 다음 아키텍처 버전을 선택하세요. 패키지 형식은 배포판에 맞아야 합니다.
| 확인 항목 | 권장 사항 |
|---|---|
| 패키지 형식 | apt, dpkg 체계를 사용하면 보통 deb를 선택하고, dnf, yum, rpm 체계를 사용하면 보통 rpm을 선택합니다. |
| 프로세서 아키텍처 | x86_64 또는 amd64는 x64를, aarch64 또는 arm64는 arm64를 선택하세요. |
| 데스크톱 환경 | v2rayN은 GUI 클라이언트이므로 사용 가능한 데스크톱 세션이 있는 환경에 설치하고 실행해야 합니다. |
| 시스템 프록시 | 데스크톱 환경마다 시스템 프록시 설정 위치가 다를 수 있습니다. 클라이언트를 실행한 뒤 데스크톱 환경이 해당 프록시 설정을 읽는지도 확인하세요. |
// AFTER DOWNLOAD
클라이언트 설치 완료는 준비 단계일 뿐입니다. 실제로 사용하기 전에 설정을 가져오고, 실행 항목을 선택하고, 프록시 범위를 정한 뒤 연결 상태를 확인해야 합니다.
STEP 01
시스템과 아키텍처에 맞는 설치 패키지로 설치를 완료하세요. 처음 실행한 뒤 클라이언트 기본 화면이 정상적으로 열리는지 먼저 확인하고, 포트·DNS·라우팅·시스템 프록시를 한꺼번에 바꾸지는 마세요. 한 번에 한 단계씩 처리하면 문제가 생겼을 때 원인을 찾기 쉽습니다.
STEP 02
구독 그룹에 유효한 주소를 추가하고 업데이트를 실행하거나, 단일 vmess, vless, trojan 등의 설정을 가져오세요. 가져온 뒤 프로토콜, 서버 주소, 포트와 전송 설정이 올바르게 인식되었는지 확인하고 실행할 설정을 선택합니다.
STEP 03
코어를 시작한 뒤 용도에 따라 시스템 프록시, 애플리케이션 프록시 또는 라우팅 규칙을 선택하세요. 직접 연결, 프록시와 차단 규칙은 최종 접속 경로에 영향을 줍니다. 처음에는 클라이언트의 일반 라우팅 모드로 연결을 확인한 후 사용자 지정 규칙을 추가하는 것이 좋습니다.
// SUBSCRIPTION
구독 주소를 추가한 뒤에도 업데이트를 실행하고 해당 그룹을 연 다음 설정 하나를 선택해야 합니다. 구독 업데이트에 실패하면 먼저 주소가 완전한지, 기기 시간이 정확한지, 현재 네트워크에서 구독 출처에 접근할 수 있는지 확인하세요. 같은 문제를 점검하면서 클라이언트, 포트와 프로토콜을 연속으로 바꾸지 마세요. 실제 장애 지점을 판단하기 어려워집니다.
구독 가져오기 안내 보기// ROUTING
시스템 프록시는 애플리케이션의 요청을 클라이언트로 보낼지 결정하고, 로컬 라우팅 규칙은 클라이언트가 요청을 받은 뒤 직접 연결할지, 프록시를 사용할지, 차단할지를 결정합니다. 클라이언트가 실행 중인데도 브라우저가 연결되지 않으면 설정 선택 여부, 로컬 수신 포트, 시스템 프록시 상태와 라우팅 모드를 각각 확인하세요. 하나의 스위치만 확인해서는 안 됩니다.
프로토콜 및 코어 참고 자료 보기// UPDATE PATH
큰 버전으로 업데이트할 때는 구독 그룹, 로컬 수신 포트, 라우팅 모드, DNS 옵션과 사용자 지정 규칙을 먼저 기록하는 것이 좋습니다. 새 버전을 설치한 뒤 각 항목이 현재 용도에 맞는지 하나씩 확인하세요. 연결 문제를 점검하는 중이라면 먼저 클라이언트 로그와 오류 메시지를 확인하고, 업그레이드만을 유일한 해결 방법으로 삼지 마세요.
문제 해결 항목 보기// PACKAGE NOTES
데스크톱 플랫폼은 v2rayN, Android의 일반적인 기본 선택은 v2rayNG이며, v2fly 코어가 명확히 필요할 때만 v2flyNG를 선택하세요. 먼저 클라이언트 모델을 정한 뒤 같은 카드 안에서 아키텍처와 패키지 형식을 고르면 이름이 비슷하지만 용도가 다른 파일을 내려받는 실수를 줄일 수 있습니다.
x64, x86_64와 amd64는 보통 같은 계열의 데스크톱 프로세서 아키텍처를 뜻하며, arm64와 aarch64도 대개 같은 64비트 ARM 아키텍처에 해당합니다. 설치 패키지 파일 이름과 시스템 정보의 표기가 완전히 같지 않을 수 있으므로, 동일한 문자열을 찾기보다 아키텍처의 의미를 기준으로 대응하세요.
Android 범용 버전은 더 넓은 아키텍처를 지원하므로 기기 정보를 확인할 수 없거나 전용 아키텍처 패키지를 설치할 수 없을 때 적합합니다. 기기가 arm64임을 확인했다면 arm64 패키지를 우선 사용하세요. 범용 버전이 기능 강화판인 것은 아니며, 두 버전의 주요 차이는 지원하는 프로세서 아키텍처 범위입니다.
클라이언트가 열린다는 것은 프로그램 설치가 기본적으로 완료되었다는 뜻일 뿐입니다. 이후 구독, 프로토콜 매개변수, 실행 설정, 시스템 프록시와 라우팅 규칙을 확인해야 합니다. 포트 사용 중 오류가 표시되면 해당 포트를 사용하는 프로세스를 찾거나 로컬 수신 포트를 변경하고, 해당 포트에 의존하는 애플리케이션 프록시 설정도 함께 수정하세요.
// DOWNLOAD FAQ
아래에서는 버전, 아키텍처, 패키지 형식과 첫 실행에 관한 질문을 다룹니다. 구독 업데이트, 라우팅 규칙과 연결 오류에 대한 추가 해결 방법은 자주 묻는 질문 페이지에서 확인할 수 있습니다.
처음 설치한다면 차세대 크로스 플랫폼 UI를 사용하는 데스크톱 버전을 먼저 선택하세요. 기존 Windows 인터페이스에 익숙하거나 유지 관리 절차가 WPF 버전의 메뉴 레이아웃에 의존한다면 클래식 WPF 버전을 계속 사용할 수 있습니다. 두 버전 모두 v2rayN이며 핵심 용도는 거의 같으므로 동시에 설치하고 실행할 필요가 없습니다.
시스템 정보를 열어 칩 또는 프로세서 항목을 확인하세요. Apple M 시리즈 칩이면 Apple Silicon arm64 패키지를, Intel 프로세서면 Intel x64 패키지를 선택합니다. 외관이 비슷한 모델도 프로세서가 다를 수 있으므로 기기 이름만으로 판단하지 마세요.
2015년 이후 출시된 대부분의 Android 스마트폰은 arm64 버전을 우선 선택하세요. 해당 아키텍처 리소스만 포함해 파일 구성이 더 간결합니다. 기기 아키텍처를 확인할 수 없거나 arm64 패키지가 호환되지 않을 때는 범용 버전을 다운로드하세요. 두 설치 패키지의 주요 기능은 같고 지원하는 프로세서 아키텍처 범위가 다릅니다.
일반적인 Android 사용 환경에서는 Xray 코어를 사용하는 v2rayNG를 우선 선택하세요. v2fly 코어가 필요하거나 기존 설정이 v2fly 동작을 기준으로 관리되고, 서비스 안내에서 해당 코어를 지정한 경우에만 v2flyNG를 사용하면 됩니다. 설정을 가져오기 전에 프로토콜과 전송 매개변수가 호환되는지도 확인하세요.
Debian, Ubuntu 및 파생 배포판은 보통 deb를, Fedora, RHEL 계열 및 rpm 패키지 관리 체계를 사용하는 배포판은 rpm을 선택합니다. 패키지 형식을 정한 뒤 시스템이 x86_64인지 arm64인지도 확인하세요. 두 조건이 모두 맞아야 설치 패키지가 현재 환경과 호환됩니다.
설치 패키지는 클라이언트 프로그램만 제공합니다. 처음 실행한 뒤 유효한 설정 또는 구독을 가져오고, 구독 그룹을 업데이트하고, 구체적인 설정을 선택한 다음 코어를 시작해야 합니다. 브라우저나 다른 애플리케이션을 연결하려면 사용 방식에 따라 시스템 프록시를 켜거나 애플리케이션 프록시 주소를 클라이언트의 로컬 수신 포트로 지정하세요.