CLIENT CONFIGURATION

v2rayN 공식 사이트 / 4개 플랫폼 설정

v2rayN 다운로드 사용 가이드 보기

v2rayN 데스크톱 클라이언트, v2rayNG Android 클라이언트 및 구독 설정 가이드를 한곳에 정리했습니다. 하나의 서버 설정을 플랫폼별로 가져온 뒤 시스템 프록시, TUN 적용 및 라우팅 규칙을 각각 설정할 수 있습니다.

GPL-3.0 오픈 소스 라이선스 Xray · V2Fly 커널 생태계 VLESS · REALITY 설정 참고
Windows Android macOS Linux
PLATFORMS Windows · macOS · Android · Linux LICENSE GPL-3.0 CORE FAMILY Xray · V2Fly CONFIG Subscription · Routing · TUN
// CONFIGURATION PATH

구독 항목부터 시스템 트래픽 적용까지

클라이언트 설정은 단순한 단일 옵션이 아닙니다. 구독 업데이트, 프로토콜 매개변수, 프록시 모드와 라우팅 규칙이 하나의 연결 흐름을 이룹니다. 실제 연결 순서에 따라 각 단계를 이해해야 문제 발생 시 원인을 정확히 찾을 수 있습니다.

SOURCE → GROUP → NODE

구독 가져오기 및 그룹 업데이트

구독 주소는 서버 항목을 전달하고, 클라이언트는 해당 항목을 로컬 그룹에 저장합니다. 처음 가져온 뒤에는 직접 구독을 업데이트하고 서버 목록에 선택 가능한 노드가 나타나는지 확인해야 합니다. 그룹 이름, 업데이트 결과와 로그 메시지를 함께 살펴봐야 하며, 화면에 기록 한 줄이 표시되는지만으로 성공을 판단해서는 안 됩니다. 장기간 사용할 때는 서비스 출처별로 그룹을 나누면 여러 구독의 같은 이름 노드가 섞이는 것을 막을 수 있습니다. 업데이트 전에 수동 설정을 보존해 두면 덮어쓰기 관계로 인한 확인 작업도 줄일 수 있습니다.

이 과정은 v2rayN과 v2rayNG 모두에 적용되지만 메뉴 위치와 시스템 권한은 서로 다릅니다. 데스크톱 클라이언트는 여러 설정 그룹을 한곳에서 관리하기 좋고, Android에서는 백그라운드 실행과 네트워크 적용 권한을 추가로 확인해야 합니다.

// PLATFORM ENTRY

현재 시스템에 맞는 클라이언트 선택

데스크톱 플랫폼에서는 v2rayN을 사용하고, Android에서는 v2rayNG를 우선 선택하며 다른 커널 경로가 필요할 때는 v2flyNG를 대안으로 사용할 수 있습니다. 플랫폼 입구를 누르면 다운로드 페이지의 해당 탭이 바로 열립니다.

DESKTOP / X64

Windows

Windows 사용자는 데스크톱 버전과 기존 WPF 버전 중에서 선택할 수 있습니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 지향해 일관된 사용 방식을 원하는 사용자에게 적합하고, WPF 버전은 전통적인 Windows 화면과 익숙한 사용 흐름을 이어갑니다. 설치 후 구독을 가져오고 그룹을 업데이트한 다음 활성 서버를 선택해 시스템 프록시를 켜세요.

Windows 다운로드로 이동
DESKTOP / ARM64 · X64

macOS

macOS 설치 패키지는 프로세서 아키텍처별로 구분됩니다. Apple Silicon 기기는 arm64를, Intel 프로세서 기기는 x64를 선택하세요. 처음 실행할 때 시스템 권한을 확인해야 하며, TUN을 활성화할 때는 네트워크 확장 관련 작업도 허용해야 합니다. 먼저 시스템 프록시로 구독과 노드 연결을 확인한 뒤 앱 적용 범위에 따라 더 넓은 트래픽 적용을 활성화하는 것이 좋습니다.

macOS 다운로드로 이동
MOBILE / ARM64 · UNIVERSAL

Android

Android에서는 주로 v2rayNG를 사용하며 Xray 커널을 기반으로 일반적인 VLESS, REALITY, VMess 및 Trojan 설정을 지원합니다. 대부분의 최신 기기는 arm64 빌드를 선택할 수 있고, 아키텍처를 확인하기 어렵다면 범용 빌드를 사용하면 됩니다. 구독을 가져온 뒤 시스템 연결 확인 화면에서 네트워크 적용 권한을 부여하고, 배터리 정책에 따라 백그라운드 실행 제한을 조정하세요.

Android 다운로드로 이동
DESKTOP / DEB · RPM

Linux

Linux 데스크톱에서는 v2rayN을 사용하며 배포판의 패키지 체계에 따라 deb 또는 rpm을 선택하고 x64와 arm64 아키텍처도 구분해야 합니다. 그래픽 클라이언트는 구독, 서버 목록과 라우팅 설정을 담당하지만 시스템 트레이와 데스크톱 환경의 동작은 조금 다를 수 있습니다. 시스템 프록시를 켜기 전에 데스크톱 환경이 읽는 프록시 출처를 확인해 특정 설정 계층만 변경하는 일을 피하세요.

Linux 다운로드로 이동
전체 클라이언트 보기
// OPEN ECOSYSTEM

Project V, 커널과 그래픽 클라이언트

클라이언트 인터페이스와 네트워크 커널은 서로 다른 역할을 담당합니다. 이 관계를 이해하면 프로토콜 기능이 어디에서 제공되는지, 설정 오류를 어느 계층에서 확인해야 하는지, 클라이언트마다 기능 차이가 생기는 이유를 파악하는 데 도움이 됩니다.

PROJECT V

개방형 프로토콜 생태계의 계층 구조

Project V는 프록시 프로토콜, 전송 방식, 라우팅 규칙과 설정 모델을 중심으로 발전한 개방형 기술 생태계입니다. 특정 그래픽 인터페이스의 이름도 아니며 하나의 네트워크 커널과 같지도 않습니다. 클라이언트에서 보는 서버 목록, 구독 그룹, 시스템 프록시 스위치와 로그 창은 상호작용 계층에 속합니다. 실제로 연결을 설정하고 프로토콜 핸드셰이크, 데이터 전달과 라우팅 일치를 수행하는 부분은 하위 커널이 담당합니다.

이러한 계층 구조 덕분에 인터페이스 개발과 프로토콜 구현이 각자 발전할 수 있습니다. 그래픽 클라이언트는 플랫폼 대응, 설정 관리와 작업 흐름을 개선하고, 커널 프로젝트는 프로토콜 호환성, 전송 세부 사항, DNS 동작과 라우팅 실행을 계속 처리합니다. 문제가 생기면 노드를 반복해서 바꾸기보다 장애가 구독 데이터, 클라이언트 인터페이스, 운영체제 적용 또는 커널 연결 계층 중 어디에 있는지 먼저 판단하는 편이 효과적입니다.

01

V2Fly 커널 계열

V2Fly는 V2Ray의 설정 모델과 프로토콜 생태계를 이어받아 프록시 인바운드, 아웃바운드, 전송, DNS와 라우팅 같은 기본 모듈을 중심으로 구성됩니다. v2flyNG는 이 커널 경로를 사용하며 Android 플랫폼의 대안 클라이언트로 적합합니다. 선택할 때는 클라이언트 이름만 보고 호환성을 판단하지 말고 서버에서 실제로 사용하는 프로토콜과 매개변수를 기준으로 삼아야 합니다.

02

Xray 커널 계열

Xray는 Project V 생태계와 많은 설정 개념을 공유하면서 VLESS, REALITY, XTLS Vision 등의 주요 기능을 발전시켜 왔습니다. v2rayN과 v2rayNG는 Xray 설정 관리에 자주 사용됩니다. 그래픽 인터페이스가 복잡한 필드를 양식으로 정리해도 실제 적용 결과는 프로토콜, 보안 계층, 전송과 라우팅 매개변수의 조합으로 결정되므로 서버와 클라이언트 설정이 일치해야 합니다.

03

세 클라이언트의 오픈 소스 특성

v2rayN, v2rayNG와 v2flyNG는 모두 오픈 소스로 유지 관리되며 각 프로젝트가 명시한 오픈 소스 라이선스를 따릅니다. 개방형 개발 방식은 인터페이스 로직, 설정 처리와 커널 호출 관계를 지속적으로 검토할 수 있게 하고, 여러 플랫폼이 동일한 프로토콜 개념을 바탕으로 각자의 사용 방식을 발전시키도록 합니다. 사용할 때는 클라이언트 라이선스, 커널 라이선스와 서드파티 구성 요소 라이선스를 구분해야 합니다.

04

업데이트 방식과 설정 이전

클라이언트 업데이트에는 보통 인터페이스 조정, 플랫폼 호환성 처리, 설정 구조 대응과 커널 호출 변경이 포함됩니다. 구독 내용은 서비스 제공자가 관리하므로 클라이언트 업데이트가 서버 매개변수를 자동으로 수정해 주지는 않습니다. 기기를 이전할 때는 구독 출처, 수동 라우팅 규칙, DNS 방식과 로컬 환경설정을 먼저 보존한 뒤 새 플랫폼에서 권한과 시스템 프록시 상태를 다시 확인하세요. 모든 로컬 설정을 그대로 재사용할 수 있다고 가정해서는 안 됩니다.

// FIELD NOTES

설정 안내 및 문제 해결 기록

실제 인터페이스, 연결 흐름과 고급 설정을 중심으로 정리한 주제별 글입니다. 각 글은 하나의 명확한 문제에 집중해 재사용 가능한 판단 순서와 매개변수의 배경을 제공합니다.

고급 활용

FakeDNS 가상 DNS 매핑 원리: 켜야 할 상황과 피해야 할 상황

FakeDNS가 실제 조회 결과 대신 예약 주소 대역을 사용하는 처리 과정을 분석하고, TUN·도메인 스니핑·라우팅 일치와의 관계를 설명합니다. 활성화에 적합한 상황과 비활성화해야 하는 대표 사례도 함께 정리합니다.

전체 글 읽기 →
시작 가이드

v2rayN 메인 화면 기능별 빠른 이해: 서버 목록, 구독 그룹, 로그와 설정 메뉴

메인 창의 실제 정보 구조를 기준으로 서버 목록 항목, 구독 그룹 관리, 로그 창과 핵심 설정 메뉴를 설명합니다. 처음 설치한 사용자가 먼저 화면 구성을 익힌 뒤 설정 가져오기를 시작할 수 있도록 돕습니다.

전체 글 읽기 →
문제 해결

v2rayN 노드 연결 시간 초과 문제 해결: 이 6단계를 순서대로 확인하세요

로컬 시간, 구독 상태, 포트 사용 여부와 프로토콜 매개변수부터 시작해 시스템 프록시와 로그의 주요 키워드를 차례로 확인합니다. 일정한 순서를 지키면 설정을 반복해서 바꾸며 새로운 문제를 만드는 일을 줄일 수 있습니다.

전체 글 읽기 →
전체 글 보기