데스크톱 및 Android 클라이언트 자료

v2rayN 가이드 허브클라이언트 및 설정 가이드

v2rayN 클라이언트 다운로드, 구독 가져오기, 라우팅 분할 절차를 한곳에 정리했습니다. 데스크톱과 Android를 모두 다루며, 설정 명칭은 클라이언트 화면과 동일하게 표기합니다.

영구 무료 오픈 소스 Xray 및 V2Fly 코어 한국어 사용 문서
플랫폼 바로가기

운영체제별 클라이언트 선택

데스크톱은 v2rayN으로 시작하고, Android에서는 코어 유형에 따라 v2rayNG 또는 v2flyNG를 선택할 수 있습니다. 각 버튼은 다운로드 페이지의 해당 플랫폼 탭으로 이동합니다.

Windows

v2rayN 데스크톱 버전 또는 클래식 WPF 버전을 사용할 수 있습니다. 데스크톱 버전은 크로스 플랫폼 인터페이스로 새 환경에 적합하고, WPF 버전은 기존 조작 구조를 유지해 트레이 메뉴, 서버 목록, 시스템 프록시 메뉴가 한곳에 모여 있습니다.

다운로드 페이지로 이동

macOS

v2rayN 데스크톱 클라이언트를 사용합니다. 다운로드 전에 시스템 정보에서 프로세서 유형을 확인한 뒤 Apple Silicon 또는 Intel 설치 패키지를 선택하세요. 처음 실행한 후에는 시스템 안내에 따라 앱 확인과 네트워크 권한 설정을 완료합니다.

다운로드 페이지로 이동

Android

Xray 코어를 사용하는 v2rayNG를 우선 권장합니다. V2Fly 코어가 필요한 경우 v2flyNG를 사용할 수 있습니다. 최근 출시된 대부분의 기기는 arm64 패키지가 적합하며, 아키텍처를 확인하기 어렵다면 범용 버전을 선택하세요.

다운로드 페이지로 이동

Linux

v2rayN 데스크톱 클라이언트를 사용합니다. Debian·Ubuntu 등에서는 deb를, Fedora·RHEL 계열에서는 rpm을 선택하세요. 또한 기기의 프로세서에 맞춰 x64 또는 arm64 아키텍처를 확인해야 합니다.

다운로드 페이지로 이동
핵심 설정

구독부터 라우팅까지의 작업 흐름

기능 목록은 실제 설정 순서에 맞춰 구성했습니다. 왼쪽 항목을 선택하면 용도, 적용 범위, 관련 설정을 확인할 수 있습니다.

설정 메뉴

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

구독은 서버 설정을 한곳에서 불러올 때 사용하며, 여러 노드 사이를 전환할 때 편리합니다. 가져오기 전에 링크 출처와 그룹 이름을 확인한 뒤 구독 업데이트를 실행해 클라이언트가 최신 내용을 다시 읽도록 하세요. 업데이트가 끝나면 서버 목록은 구독에서 제공한 이름으로 해당 그룹에 저장됩니다. 기존 수동 설정은 대개 별도로 계속 유지할 수 있습니다. 가져온 뒤 목록이 비어 있다면 시스템 프록시를 반복해서 전환하기보다 선택한 구독 그룹과 링크가 완전한지 먼저 확인하세요.

v2rayN에서는 업데이트 주기를 설정하거나 특정 그룹을 수동으로 업데이트할 수 있습니다. 여러 기기에서 같은 구독을 사용하더라도 각 클라이언트에서 따로 업데이트해야 합니다. 구독 자체는 클라이언트의 라우팅 모드, 시스템 프록시 상태, 화면 설정을 직접 동기화하지 않습니다. 따라서 서버 설정과 로컬 정책을 분리해 관리할 수 있으며, 한쪽을 수정해도 다른 쪽이 덮어써지지 않습니다.

구독 업데이트 현재 구독 업데이트
오픈 소스 생태계

Project V, V2Fly 및 Xray

클라이언트, 코어, 프로토콜은 서로 다른 계층에 있습니다. 세 요소의 관계를 이해하면 설치 패키지를 올바르게 선택하고 설정 호환성을 판단하며, 업데이트 후 변경 원인을 빠르게 찾을 수 있습니다.

핵심 프로젝트부터 그래픽 클라이언트까지

Project V는 설정 중심의 네트워크 프록시 코어를 기반으로 기술 생태계를 형성했습니다. V2Ray의 인바운드, 아웃바운드, 라우팅, 전송 계층 개념은 이후 클라이언트에 공통 설정 기반을 제공했습니다. 그래픽 클라이언트는 이러한 프로토콜을 새로 정의하지 않고 JSON 설정, 구독 내용, 시스템 프록시, 프로세스 관리를 조작 가능한 화면으로 변환합니다. 서버 목록에서 노드를 전환하면 클라이언트가 선택 항목에 따라 코어가 읽을 수 있는 실행 설정을 생성합니다.

V2Fly는 V2Ray 코어의 커뮤니티 유지 방향을 이어받아 범용 프로토콜과 모듈식 설정에 중점을 둡니다. Xray는 유사한 설정 체계 위에서 XTLS, REALITY 관련 구현을 포함한 자체 확장 기능을 발전시켰습니다. 두 코어는 많은 기본 개념을 공유하지만 기능이 추가된 시점, 매개변수 이름, 호환 범위는 다를 수 있습니다. 설정 제공자가 특정 코어를 요구한다면 그 조건에 맞춰 선택해야 하며, 모든 확장이 서로 호환된다고 가정해서는 안 됩니다.

VMess, VLESS, Trojan은 프록시 프로토콜 이름이고 WebSocket, gRPC, TCP 등은 전송 방식입니다. TLS, REALITY 등은 보안과 핸드셰이크 설정의 서로 다른 계층을 담당합니다. 구독은 설정을 배포하는 형식일 뿐 프로토콜 자체를 바꾸지 않습니다. 각 필드를 계층별로 확인하면 “구독 업데이트 실패”, “코어 비호환”, “라우팅 미적용”을 하나의 문제로 오해하는 일을 줄일 수 있습니다.

관련 프로젝트는 오픈 소스 방식으로 유지 관리되며, 코드 변경, 버그 수정, 프로토콜 구현은 각 커뮤니티에서 계속 진행됩니다. 오픈 소스 라이선스는 코드 사용, 수정, 재배포의 범위를 정하고, 여러 그래픽 클라이언트가 같은 코어 체계를 기반으로 화면과 시스템 연동 기능을 제공할 수 있게 합니다. 클라이언트 업데이트에는 보통 화면 조정, 구독 파싱, 플랫폼 대응, 코어 관리 변경이 포함되고, 코어 업데이트는 프로토콜 지원과 연결 동작에 더 직접적인 영향을 줍니다.

실제 유지 관리에서는 클라이언트와 코어가 항상 동시에 출시되지는 않습니다. 업데이트 후 동작이 달라졌다면 먼저 변화가 클라이언트 화면, 구독 내용, 하위 코어 중 어디에서 발생했는지 확인한 뒤 설정을 다시 검토하거나 구성을 조정하세요. 현재 사용 가능한 구독 출처와 라우팅 정책을 기록해 두면 여러 기기로 이전할 때 동일한 연결 조건을 재현하는 데 도움이 됩니다.

DESKTOP

v2rayN

Windows, macOS, Linux용 그래픽 클라이언트입니다. 구독 그룹, 서버 전환, 시스템 프록시, 라우팅 규칙, 로그 확인, 코어 관리를 지원합니다. 데스크톱 설정을 하나의 작업 공간에서 관리할 수 있어 여러 구독, 수동 노드, 사용자 지정 라우팅을 운영하는 환경에 적합합니다.

ANDROID · XRAY

v2rayNG

Android용 그래픽 클라이언트로 Xray 코어를 주요 실행 구성 요소로 사용합니다. 구독 링크, 클립보드 내용, QR 코드로 설정을 가져올 수 있으며 Android의 VPN 서비스를 통해 기기 트래픽을 처리합니다. Xray 확장 프로토콜과 관련 전송 매개변수를 사용하는 설정에 적합합니다.

ANDROID · V2FLY

v2flyNG

Android용 V2Fly 코어 클라이언트로, 화면 조작 방식은 일반적인 Android 프록시 클라이언트와 비슷합니다. V2Fly 코어가 명시된 설정에 적합하며 코어 유형에 따라 선택할 수 있는 대안입니다. 가져오기 전에는 프로토콜, 전송 방식, 보안 매개변수를 확인해야 합니다.

가이드 업데이트

설정 원리 및 문제 해결 기록

설치, 코어, 속도 측정, 멀티 디바이스 관리 순서로 글을 구성하고 설정 간 인과관계를 중점적으로 설명합니다.

전체 글 보기 →

V2Ray 속도 저하 단계별 점검: 노드, 경로, 로컬 설정 순서로 확인

노드 자체, 중간 경로, 로컬 설정의 세 계층으로 병목을 찾습니다. 노드 변경, 한산한 시간대 비교, 라우팅과 코어 설정을 항목별로 점검해 여러 변수를 동시에 바꾼 뒤 원인을 놓치는 일을 피하세요.

전체 글 읽기

여러 기기에서 V2Ray 설정을 동기화하는 세 가지 방법: 구독 링크, 내보내기·가져오기, QR 코드 공유

구독을 한곳에서 관리하는 방법, 설정 파일을 전달하는 방법, QR 코드로 공유하는 방법을 비교하고, 데스크톱 v2rayN과 Android 클라이언트 사이에서 동기화할 수 있는 항목과 기기별로 따로 설정해야 하는 로컬 항목을 설명합니다.

전체 글 읽기

지연 시간 테스트 수치 읽는 법: ICMP ping, 실제 연결 지연, 다운로드 속도의 차이

세 가지 테스트가 각각 어떤 네트워크 구간을 측정하는지 설명합니다. 짧은 왕복 시간이 높은 처리량이나 프록시 핸드셰이크 성공을 의미하지 않는 이유를 알아보고, 문제 유형에 따른 테스트 선택 순서도 제시합니다.

전체 글 읽기

처음 설정은 어디서 시작하나요?

먼저 클라이언트를 설치하고 구독을 가져온 다음 현재 서버를 선택하고 시스템 프록시를 켠 뒤 접속을 확인하세요. 문제가 발생하면 로그의 시간과 오류 단계를 기록하고 가이드 순서에 따라 다시 점검합니다.

전체 가이드 보기