CLIENT REFERENCE / ZH-CN

V2Ray 다운로드 안내v2rayN 설정 가이드

그래픽 클라이언트의 다운로드와 설정을 한곳에 정리했습니다. 4개 플랫폼 설치 안내, 구독 및 라우팅 절차, Xray와 V2Fly 코어의 관계를 다룹니다. 먼저 기기에 맞는 클라이언트를 고른 뒤 구독 가져오기, 노드 활성화, 시스템 프록시 설정을 순서대로 진행하세요.

영구 무료 오픈 소스 한국어 문서 그래픽 클라이언트 구독 및 라우팅
CLIENT WORKFLOW

클라이언트 설정의 4가지 핵심 단계

다운로드부터 안정적인 사용까지 중요한 차이는 버튼 수가 아니라 클라이언트, 설정 출처, 프록시 모드와 라우팅 규칙의 조합입니다. 아래 내용은 실제 작업 순서에 맞춰 나누었으며, 왼쪽 설정 항목에서 전환해 확인할 수 있습니다.

01 / CLIENT

먼저 운영체제에 맞는 그래픽 클라이언트를 선택하세요

데스크톱에서는 Windows·macOS·Linux를 지원하는 v2rayN을 우선 살펴보세요. 구독 관리, 서버 목록, 라우팅 규칙과 시스템 프록시 설정이 하나의 작업 흐름으로 구성되어 있습니다. Android에서는 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. v2rayNG는 Xray 코어를 사용해 폭넓은 프로토콜과 전송 기능을 지원하고, v2flyNG는 V2Fly 코어를 사용해 해당 설정 생태계를 이미 이용하는 사용자에게 적합합니다. 클라이언트는 운영체제, 프로세서 아키텍처와 설정 호환성을 기준으로 선택하면 되며, 기능이 겹치는 프로그램을 여러 개 설치할 필요는 없습니다.

다운로드 페이지에서는 설치 파일을 플랫폼과 아키텍처별로 나누고 데스크톱 버전, 클래식 인터페이스, arm64와 범용 패키지의 차이를 설명합니다. 기기 조건을 확인한 뒤 다운로드하면 설치 파일 형식 불일치, 프로세서 아키텍처 오선택, 설정 필드 인식 불가 같은 문제를 줄일 수 있습니다.

v2rayN v2rayNG v2flyNG
SELECTION RULE

클라이언트와 코어는 같은 계층이 아닙니다

v2rayN·v2rayNG·v2flyNG는 사용자를 위한 그래픽 클라이언트로, 설정 편집·구독 관리·노드 전환·시스템 프록시와 로그 확인을 담당합니다. Xray와 V2Fly는 코어 처리 계층으로 프로토콜·전송·라우팅·연결 실행을 담당합니다. 설정 호환성을 판단할 때는 클라이언트가 해당 설정 항목을 제공하는지와 사용 중인 코어가 관련 필드를 이해하는지를 함께 확인해야 합니다.

CHANGE CONTROL

설정 변경은 단일 변수 방식으로 점검하세요

구독·노드·프록시 모드·DNS와 라우팅 규칙을 동시에 바꾸면 연결 차이의 원인을 찾기 어렵습니다. 더 안전한 순서는 클라이언트가 실행되는지 확인하고, 설정을 가져와 노드를 선택한 뒤 시스템 프록시를 검증하고, 마지막으로 TUN이나 사용자 지정 규칙을 추가하는 것입니다. 단계마다 되돌릴 수 있는 상태를 남겨 두면 로그의 오류 메시지도 더 의미 있게 해석할 수 있습니다.

PLATFORM DOWNLOADS

플랫폼별 클라이언트 다운로드 페이지로 이동

홈에서는 플랫폼 목록만 제공하며 설치 파일을 직접 배포하지 않습니다. 다운로드 페이지에서 운영체제, 프로세서 아키텍처와 설치 파일 유형에 맞는 항목을 선택하세요.

DESKTOP / WINDOWS

Windows · v2rayN

Windows 사용자는 새로운 크로스 플랫폼 데스크톱 인터페이스와 클래식 WPF 인터페이스 중에서 선택할 수 있습니다. 두 버전 모두 서버 목록, 구독 업데이트, 시스템 프록시와 라우팅 설정을 중심으로 구성되어 여러 설정 출처를 그래픽으로 관리하려는 데스크톱 환경에 적합합니다.

다운로드 페이지에서 사용하기 편한 데스크톱 버전 또는 클래식 버전을 선택하고, 설치 전에 시스템 아키텍처와 권한 정책을 확인하세요.

다운로드하러 가기
DESKTOP / MACOS

macOS · v2rayN

macOS 항목은 Apple Silicon과 Intel 프로세서로 나뉩니다. 클라이언트는 데스크톱의 설정 관리 흐름을 이어받아 구독·노드·시스템 프록시·라우팅 설정을 한곳에서 처리하므로, 여러 데스크톱 시스템에서 비슷한 방식으로 사용하려는 사용자에게 적합합니다.

칩 종류를 모를 때는 시스템 정보에서 프로세서 또는 칩 이름을 확인한 뒤 해당 디스크 이미지를 선택하세요.

다운로드하러 가기
MOBILE / ANDROID

Android · v2rayNG / v2flyNG

Android에서는 두 가지 클라이언트 경로를 제공합니다. v2rayNG는 Xray 코어를 사용해 폭넓은 프로토콜과 전송 설정에 적합하고, v2flyNG는 V2Fly 코어를 사용해 해당 생태계 설정의 대안으로 활용할 수 있습니다. 두 클라이언트 모두 구독 가져오기, QR 코드 읽기와 노드 전환을 지원합니다.

최근 주류 기기에서는 보통 arm64 패키지를 우선 확인하세요. 아키텍처를 확인하기 어렵다면 다운로드 페이지의 범용 패키지 설명을 참고하면 됩니다.

다운로드하러 가기
DESKTOP / LINUX

Linux · v2rayN

Linux 다운로드 항목은 일반적인 패키지 체계에 따라 deb와 rpm을 제공하며 x64와 arm64 아키텍처도 구분합니다. 그래픽 클라이언트는 구독·서버·시스템 프록시를 화면에서 관리하면서 로그도 확인하려는 데스크톱 사용자에게 적합합니다.

먼저 배포판의 패키지 체계를 확인한 다음 시스템 아키텍처 명령이나 시스템 정보를 바탕으로 맞는 빌드를 선택하세요.

다운로드하러 가기
OPEN SOURCE ECOSYSTEM

Project V·V2Fly·Xray와 클라이언트의 계층 구조

이 이름들은 설정 문서에 함께 등장하는 경우가 많지만, 각각 생태계 개념·코어 계열·그래픽 클라이언트를 의미합니다. 계층 관계를 이해하면 제품명을 단순히 외우는 것보다 프로토콜 지원과 설정 호환성을 판단하기 쉽습니다.

Project V는 생태계의 배경이며 특정 설치 프로그램을 뜻하지 않습니다

Project V는 프록시 프로토콜, 전송 방식, 라우팅 규칙과 설정 구조를 중심으로 한 개방형 기술 생태계를 형성했습니다. 초기 사용자들은 V2Ray를 전체 체계의 통칭처럼 부르기도 했지만, 실제 설치 과정에서 접하는 것은 보통 그래픽 클라이언트·코어 프로그램·설정 파일이라는 세 계층입니다. 그래픽 클라이언트는 인터페이스와 시스템 통합을 담당하고, 코어는 연결과 라우팅을 실행하며, 설정은 두 계층이 읽어야 할 매개변수를 정의합니다. 이 계층을 구분하면 ‘클라이언트 업데이트’, ‘코어 업데이트’, ‘설정 형식 변경’이 서로 다른 일임을 이해할 수 있습니다.

V2Fly와 Xray는 서로 연관된 코어 계열입니다

V2Fly는 Project V 체계의 핵심 구현과 설정 개념을 이어받아 개방형 협업, 프로토콜 구현과 라우팅 기능에 중점을 둡니다. Xray는 유사한 설정 모델을 바탕으로 프로토콜과 전송 기능을 계속 확장해 왔으므로 기본 필드 중에는 서로 이해할 수 있는 항목도 많습니다. 다만 새로운 기능, 전송 세부 옵션과 특정 매개변수는 한쪽 코어만 지원할 수 있습니다. 설정 사용 가능 여부는 공유 링크의 접두사만으로 판단하지 말고, 클라이언트가 현재 어떤 코어를 호출하는지와 대상 필드가 해당 코어의 지원 범위에 포함되는지를 확인해야 합니다.

v2rayN·v2rayNG·v2flyNG는 사용자 인터랙션 계층에 있습니다

v2rayN은 Windows·macOS·Linux를 지원하는 데스크톱 그래픽 클라이언트입니다. v2rayNG는 Android용으로 Xray 코어를 사용해 연결을 처리하고, v2flyNG 역시 Android용이지만 V2Fly 코어를 사용합니다. 클라이언트는 설정 파일을 직접 편집해야 하는 작업을 구독 그룹·서버 목록·라우팅 모드·시스템 프록시·로그 화면으로 정리합니다. 그래픽 인터페이스는 일상적인 조작을 간소화하지만 하위 프로토콜 요구사항을 바꾸지는 않습니다. 주소·포트·식별자·전송 계층·보안 계층·도메인 등의 필드는 여전히 서버 설정과 일치해야 합니다.

오픈 소스 라이선스와 커뮤니티 유지보수의 의미

이 클라이언트와 코어는 오픈 소스 방식으로 협업하며 각 프로젝트가 자체 소프트웨어 라이선스를 적용합니다. 공개 개발 덕분에 프로토콜 구현, 오류 수정, 플랫폼 대응과 인터페이스 변경을 지속적으로 검토할 수 있고, 여러 클라이언트가 비슷한 설정 모델을 바탕으로 각자의 사용 흐름을 발전시킬 수 있습니다. 일반 사용자에게 더 직접적인 이점은 변경 내역을 확인하고 기능이 클라이언트에서 제공되는지 코어에서 제공되는지 파악하며, 업그레이드 전에 설정 필드나 시스템 권한의 변화를 판단할 수 있다는 점입니다.

업데이트할 때 클라이언트·코어·설정을 따로 확인하세요

클라이언트 업그레이드는 보통 인터페이스, 설치 방식, 시스템 프록시 연동과 코어 패키징 방식에 영향을 줍니다. 코어 업그레이드는 프로토콜 구현, 전송 기능, 라우팅 규칙이나 설정 해석에 영향을 줄 가능성이 큽니다. 구독 업데이트는 주로 서버 항목을 바꿉니다. 업그레이드 후 연결 상태가 달라졌다면 먼저 어느 계층에서 변경이 발생했는지 확인하세요. 구독 내용만 바뀐 경우 클라이언트를 다시 설치해도 의미가 없습니다. 로그에 필드를 인식할 수 없다는 메시지가 나오면 코어 지원 범위를 확인하고, 프로그램이 실행되지 않거나 시스템 프록시가 적용되지 않으면 클라이언트 권한과 플랫폼 의존성을 점검하세요.

CONFIG COMPATIBILITY

형식이 비슷해도 모든 필드가 호환되는 것은 아닙니다

VMess·VLESS·Trojan·Shadowsocks 등의 프로토콜은 여러 코어와 클라이언트에서 사용할 수 있지만, REALITY·전송 계층 옵션·핑거프린트 필드·라우팅 표현 방식은 지원 범위가 다를 수 있습니다. 가져오기에 실패하면 노드 이름만 비교하지 말고 현재 코어, 클라이언트의 설정 메뉴와 설정 출처를 확인하세요.

RELEASE PRACTICE

업데이트 전에 작동하는 설정 상태를 저장하세요

클라이언트와 코어의 업데이트 주기는 완전히 같지 않습니다. 업그레이드 전에 현재 프록시 모드, 코어 선택, 구독 그룹과 사용자 지정 라우팅을 기록하고, 업그레이드 후 기존 설정을 먼저 검증한 다음 새 기능을 활성화하세요. 이렇게 하면 프로그램 업그레이드 문제와 설정 변경을 분리해 처리할 수 있습니다.

DOCUMENT SCOPE

문서는 그래픽 클라이언트 사용을 중심으로 구성됩니다

사이트 콘텐츠는 다운로드·설치·구독 가져오기·노드 활성화·시스템 프록시·TUN 모드·라우팅·문제 해결을 중심으로 다룹니다. 프로토콜 섹션은 클라이언트 선택을 돕기 위해 설계상의 차이, 리소스 사용량, 코어 지원과 구독 호환성을 설명합니다.

COMMON DECISIONS

설정을 시작하기 전 자주 하는 판단

구독을 가져온 뒤 노드가 표시되지 않는 이유는 무엇인가요?

구독 주소를 추가하는 것만으로는 설정 출처가 저장될 뿐이며, 구독 업데이트를 실행해야 합니다. 업데이트 후 현재 그룹, 필터 조건과 로그 메시지를 확인하세요. 그래도 비어 있다면 구독 주소에 접근할 수 있는지, 반환된 내용을 현재 클라이언트가 인식할 수 있는지 확인하세요. 자세한 절차는 FAQ에서 확인할 수 있습니다.

노드를 선택했는데도 앱이 프록시를 사용하지 않는 이유는 무엇인가요?

노드 선택은 현재 서버만 지정합니다. 앱에 맞는 연결 방식도 활성화해야 합니다. 브라우저는 보통 시스템 프록시를 사용할 수 있지만, 시스템 프록시를 읽지 않는 프로그램에는 TUN 모드가 필요할 수 있습니다. 먼저 빠른 시작에 따라 기본 연결을 확인한 뒤 적용 범위를 넓히세요.

v2rayNG와 v2flyNG는 어떻게 선택해야 하나요?

먼저 설정에 필요한 코어 기능을 기준으로 선택하세요. v2rayNG는 Xray 코어를 사용하고 v2flyNG는 V2Fly 코어를 사용합니다. 설정 출처에서 특정 코어 또는 필드를 요구한다면 해당 조건을 유지해야 합니다. 일반 구독은 제공자가 표시한 프로토콜과 전송 유형을 먼저 확인해도 됩니다.

지연 시간이 낮으면 실제 연결도 반드시 더 빠른가요?

반드시 그렇지는 않습니다. Ping, 실제 연결 지연 시간과 다운로드 속도 측정은 확인하는 경로와 방식이 달라 결과가 서로 다를 수 있습니다. 일상적으로 노드를 선택할 때는 실제 연결 테스트, 웹페이지 응답과 지속적인 전송 성능을 함께 판단하세요.

V2Ray 클라이언트 다운로드