클라이언트 다운로드 및 설정 자료

v2flyNG 공식 사이트: V2Ray 클라이언트 다운로드 및 사용 가이드

v2rayN 다운로드 가이드 보기

네 가지 플랫폼의 클라이언트 다운로드, 구독 및 라우팅 설정, V2Fly와 Xray 코어 설명을 한곳에 정리했습니다. 첫 설치부터 TUN 모드, 규칙 기반 라우팅과 일상적인 관리까지 다룹니다.

영구 무료 오픈 소스 중국어 문서 그래픽 클라이언트
PLATFORMS

네 가지 플랫폼 클라이언트

Windows macOS Android Linux
CORE FAMILY

두 가지 주요 코어

V2Fly Xray

클라이언트는 그래픽 조작을 담당하고, 코어는 프로토콜·전송·라우팅·아웃바운드 처리를 담당합니다.

OPEN SOURCE

공개 코드와 라이선스

클라이언트와 코어는 각각의 프로젝트에서 지속적으로 유지 관리되며, 릴리스·버그 수정·기능 변경 기록을 공개합니다.

CONFIGURATION

구독·라우팅·TUN

기본 연결을 먼저 완료한 뒤, 사용 시나리오에 맞춰 라우팅 규칙과 시스템 수준의 프록시 기능을 단계적으로 추가하세요.

고급 매뉴얼 읽기 →

처음 사용할 때 모든 프로토콜과 매개변수를 한꺼번에 이해할 필요는 없습니다. 운영체제와 클라이언트를 확인하고, 사용 가능한 설정을 가져온 다음 연결 테스트를 한 번 진행하세요. 이후 실제 필요에 따라 시스템 프록시, 라우팅 모드와 TUN을 조정하는 순서가 안전합니다. 각 단계의 결과가 분명해 문제 발생 시 어느 계층에서 문제가 생겼는지도 쉽게 판단할 수 있습니다.

CLIENT WORKFLOW

구독·라우팅·TUN 설정 핵심

자주 사용하는 작업을 기준으로 클라이언트에서 혼동하기 쉬운 세 부분을 나누어 설명합니다. 각 항목은 실제 설정에 대응하며, 추상적인 성능 점수로 판단을 대신하지 않습니다.

자주 하는 작업

구독 그룹: 업데이트와 노드 선택을 분리해 관리하기

구독 주소는 설정 출처를 관리하기 위한 것이며, 현재 사용 중인 노드와는 다릅니다. 가져온 뒤에는 먼저 한 번 업데이트하고, 그룹에 식별 가능한 서버 항목이 나타나는지 확인하세요. 여러 구독을 함께 사용할 때는 용도나 출처별로 그룹을 만들면 특정 항목을 업데이트한 뒤 변경 범위를 파악하기 쉽습니다.

일상적인 작업은 간단하게 유지할 수 있습니다. 구독 업데이트, 그룹 확인, 노드 선택, 실제 연결 테스트 순서로 진행하세요. 안정적으로 사용하는 구독에는 자동 업데이트가 편리하지만 수동 업데이트 메뉴도 남겨 두는 것이 좋습니다. 업데이트 후 목록이 비어 있다면 시스템 프록시를 반복해서 전환하기보다 주소가 완전한지, 응답 형식을 클라이언트가 인식할 수 있는지, 그룹 필터가 항목을 숨기고 있지 않은지 차례로 확인하세요.

구독 가져오기 단계 보기 →
구독 그룹
일상 그룹수동 선택
사용 중
백업 그룹별도 업데이트
선택 안 함
구독 자동 업데이트
PLATFORM DOWNLOADS

운영체제에 맞는 V2Ray 클라이언트 선택

데스크톱에서는 먼저 v2rayN을 확인하고, Android에서는 코어 요구 사항에 따라 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 다운로드 페이지에서 아키텍처별 파일과 설치 형식을 안내합니다.

01 / DESKTOP

Windows

v2rayN 데스크톱 버전 또는 클래식 WPF 버전을 선택하세요. 구독 그룹, 라우팅 규칙, 시스템 프록시, 로그 확인과 TUN 설정이 필요한 데스크톱 사용자에게 적합합니다. 두 인터페이스의 사용 방식은 비슷하므로 시스템 환경과 사용 습관에 맞춰 고르면 됩니다.

다운로드하기
02 / DESKTOP

macOS

v2rayN은 다양한 프로세서 아키텍처에 맞는 데스크톱 설치 파일을 제공합니다. 다운로드 전에 시스템 정보에서 칩 유형을 확인한 뒤 알맞은 파일을 선택하세요. 설치 후에는 구독 가져오기부터 시작해 기본 연결을 먼저 확인하고, 추가적인 트래픽 가로채기 기능은 그다음에 결정하는 것이 좋습니다.

다운로드하기
03 / MOBILE

Android

v2rayNG는 Xray 코어를 사용하며 VLESS, REALITY 등의 관련 기능이 필요한 사용자에게 적합합니다. v2flyNG는 V2Fly 코어를 사용하므로 같은 생태계에서 선택할 수 있는 다른 방법입니다. 대부분의 최신 기기에서는 먼저 arm64를 확인하고, 아키텍처를 알 수 없을 때만 범용 설치 패키지를 사용하세요.

다운로드하기
04 / DESKTOP

Linux

v2rayN은 일반적인 패키지 형식을 제공하며 프로세서 아키텍처도 구분합니다. 먼저 배포판이 사용하는 패키지 체계를 확인한 뒤 기기 아키텍처를 대조하세요. 설치 후 TUN이 필요하다면 시스템 권한, 네트워크 관리 서비스와 기존 방화벽 규칙도 함께 점검해야 합니다.

다운로드하기
전체 클라이언트 보기 →
QUICK START

설치부터 연결까지 세 단계

작동하는 기본 설정을 먼저 만든 다음 복잡한 기능을 단계적으로 추가하세요. 각 단계에서 확인 가능한 결과를 남기면 문제 위치를 파악하기 쉽습니다.

  1. 01

    클라이언트 선택 및 설치 완료

    Windows, macOS와 Linux 데스크톱 환경에서는 먼저 v2rayN을 사용하고, Android에서는 코어 요구 사항에 따라 v2rayNG 또는 v2flyNG를 선택하세요. 다운로드 전에 운영체제, 프로세서 아키텍처와 설치 형식을 확인하고 파일 이름이 비슷하다는 이유만으로 교차 설치하지 마세요. 처음 실행한 뒤에는 서버 목록, 구독 그룹, 로그와 설정 메뉴의 위치를 익히고 라우팅과 프록시 매개변수는 일단 기본값으로 유지하세요.

    시스템에서 권한 요청이 표시되면 현재 기능에 비추어 용도를 판단하세요. 일반 시스템 프록시는 보통 시스템 네트워크 설정만 변경하면 되지만 TUN에는 더 높은 권한이 필요할 수 있습니다. 기본 연결이 성공하기 전에는 TUN, 엄격한 라우팅 또는 복잡한 DNS 옵션을 먼저 활성화하지 않는 것이 좋습니다.

  2. 02

    구독 가져오기 및 사용 가능한 설정 선택

    구독 관리에서 전체 주소를 추가하고 저장한 뒤 직접 한 번 업데이트하세요. 그룹에 서버 항목이 나타난 것을 확인한 다음 그중 하나를 현재 설정으로 선택합니다. 구독 업데이트 성공은 클라이언트가 데이터를 읽었다는 뜻일 뿐 모든 노드가 연결된다는 의미는 아니므로, 실제 연결 테스트나 대상 서비스에 직접 접속해 확인해야 합니다.

    가져온 뒤 항목이 없다면 주소가 완전히 복사되었는지, 응답 내용이 클라이언트에서 지원하는 구독 형식인지, 현재 그룹에 필터 조건이 설정되어 있는지부터 확인하세요. 항목은 있지만 연결되지 않는다면 로그에서 확인·핸드셰이크·시간 초과·DNS 관련 정보를 살펴보세요. 구독 가져오기와 노드 연결을 두 단계로 나누면 불필요한 수정을 줄일 수 있습니다.

  3. 03

    시스템 프록시 활성화 및 라우팅 확인

    현재 설정을 선택한 뒤 클라이언트의 시스템 프록시 기능을 켜면 시스템 프록시를 따르는 프로그램이 연결을 사용하기 시작합니다. 확인할 때는 예상되는 직접 연결 대상과 프록시 대상 각각을 하나 이상 점검하고 로그에 해당 요청이 나타나는지 살펴보세요. 일반 모드가 안정적인 것을 확인한 후, 앱이 시스템 프록시를 읽는지에 따라 TUN이 필요한지 판단하세요.

    라우팅 규칙은 최소 변경 원칙에 따라 수정하세요. 한 번에 한 종류의 규칙만 추가하고 결과가 예상과 맞는지 확인한 뒤 계속 진행합니다. 문제가 생기면 먼저 마지막으로 정상 작동이 확인된 상태로 되돌리고, 구독·노드·DNS·라우팅 모드를 동시에 바꾸지 마세요. 일상적인 관리는 구독을 정기적으로 업데이트하고 릴리스 정보를 읽으며 되돌릴 수 있는 설정을 보관하는 것이 핵심입니다. 시스템 네트워크 환경이 바뀐 뒤에는 다시 확인해야 합니다.

전체 가이드 보기 초보자부터 고급자까지 매뉴얼 읽기
PROJECT V ECOSYSTEM

Project V, V2Fly와 Xray의 관계

V2Ray는 일반적으로 하나의 데스크톱 소프트웨어 이름이 아니라 코어, 프로토콜 구현, 설정 형식과 그래픽 클라이언트가 함께 이루는 기술 생태계를 뜻합니다. 그래픽 클라이언트는 구독 관리, 설정 편집, 시스템 프록시, 로그와 업데이트 메뉴를 담당하고, 인바운드·아웃바운드·전송·라우팅 로직은 하위 코어가 실제로 처리합니다. 이 역할 분담을 이해하면 문제가 인터페이스 설정, 설정 내용 또는 코어 기능 중 어디에 속하는지 판단하기 쉽습니다.

01 / HISTORY

Project V와 코어 분기

Project V는 V2Ray 생태계의 설정 구조와 핵심 개념을 마련했습니다. 이후 V2Fly 커뮤니티는 V2Ray Core를 계속 유지 관리하며 프로토콜 구현, 전송 방식, 라우팅 기능과 호환성을 중심으로 업데이트를 이어 왔습니다. Xray는 관련 기술 기반에서 독립적인 코어 분기로 발전했으며 VLESS, XTLS, REALITY 등의 기능에서 자체 구현과 릴리스 주기를 형성했습니다.

두 코어 계열은 클라이언트 이름이 아닙니다. v2rayNG는 일반적으로 Xray 코어를 조합하고, v2flyNG는 V2Fly 코어에 대응합니다. 데스크톱 그래픽 클라이언트인 v2rayN은 설정 관리와 코어 호출을 담당합니다. 클라이언트를 선택할 때는 플랫폼과 사용 방식을 먼저 확인한 뒤, 구독의 프로토콜과 전송 설정에 특정 코어 기능이 필요한지 살펴보세요.

02 / CLIENTS

세 클라이언트의 특징

v2rayN은 데스크톱 시스템용으로 서버 목록, 구독 그룹, 일괄 테스트, 로그 패널, 라우팅 설정과 TUN이 필요한 사용자에게 적합합니다. v2rayNG는 Android용이며 모바일 연결·구독·라우팅 작업에 맞춰 구성되고 Xray 코어로 관련 설정을 처리합니다. v2flyNG 역시 Android용이지만 V2Fly 코어를 중심으로 하므로 해당 코어와의 호환성이 필요한 설정에 사용할 수 있습니다.

클라이언트에는 기능이 많을수록 더 적합하다는 일률적인 결론이 없습니다. 데스크톱과 모바일은 시스템 네트워크 모델이 다르고 권한과 백그라운드 실행 방식도 다릅니다. 더 효과적인 선택 기준은 플랫폼 일치 여부, 설정 형식 지원 여부, 현재 코어가 프로토콜과 전송 매개변수를 인식하는지, 일상적인 관리 메뉴가 명확한지입니다.

03 / LICENSE

오픈 소스 라이선스와 공개 유지 관리

코어와 그래픽 클라이언트는 각각 명시한 오픈 소스 라이선스에 따라 배포됩니다. 라이선스는 코드 사용·수정·재배포 조건을 정하며, 구체적인 범위는 해당 프로젝트가 릴리스와 함께 제공하는 라이선스 문서를 기준으로 확인해야 합니다. 오픈 소스의 실제 가치는 구현 로직을 검토할 수 있고, 기능 변화를 커밋 기록과 릴리스 정보로 추적할 수 있으며, 호환성 문제를 재현 가능한 논의로 발전시킬 수 있다는 데 있습니다.

오픈 소스라고 해서 설정 판단이 필요 없어지는 것은 아닙니다. 구독 내용은 사용자가 선택한 서비스에서 오며, 노드 가용성·프로토콜 매개변수·네트워크 환경도 클라이언트 하나로 결정되지 않습니다. 따라서 문제를 진단할 때는 클라이언트, 코어, 설정 출처, 시스템 프록시와 로컬 네트워크라는 다섯 요소를 구분해야 하며 모든 연결 문제를 특정 프로그램 하나의 탓으로 돌려서는 안 됩니다.

04 / UPDATE

업데이트 방식과 호환성 범위

클라이언트 업데이트에는 보통 인터페이스 조정, 구독 파싱, 시스템 통합과 오류 수정이 포함되고, 코어 업데이트에는 프로토콜 동작, 전송 구현, 라우팅 규칙과 보안 수정이 포함될 수 있습니다. 두 구성 요소의 릴리스 주기는 다를 수 있습니다. 새 프로토콜 매개변수를 인식하지 못한다면 먼저 어떤 코어를 사용하는지 확인한 다음 클라이언트가 해당 설정 메뉴를 이미 제공하는지 판단하세요.

업데이트 전에 현재 구독 그룹, 라우팅 모드, DNS 선택과 TUN 상태를 기록하고 업데이트 후 기본 연결을 먼저 다시 테스트하세요. 설정이 복잡하다면 최소한의 작동 구성 하나를 보존해 새 버전의 호환성 문제와 기존 규칙 충돌을 구분하는 데 사용하세요. 일상적인 관리에서 설정을 자주 다시 만들 필요는 없지만 구독 형식과 코어 기능의 변화를 장기간 방치해서는 안 됩니다.

COMMON QUESTIONS

자주 묻는 질문

처음 설치할 때 자주 생기는 개념상의 오해를 간단히 정리했습니다. 용어 페이지에서는 프로토콜, 코어, 구독과 라우팅을 더 자세히 설명합니다.

v2rayN, v2rayNG와 v2flyNG 중 무엇을 선택해야 하나요?

데스크톱 시스템에서는 먼저 v2rayN을 확인하세요. Android 사용자는 설정에 Xray 관련 기능이 필요하면 v2rayNG를, V2Fly 코어를 사용해야 하면 v2flyNG를 살펴볼 수 있습니다. 먼저 운영체제를 맞춘 뒤 프로토콜과 전송 매개변수를 확인하고, 이름이 비슷한지만으로 판단할 필요는 없습니다.

구독을 가져온 뒤 목록이 비어 있는 이유는 무엇인가요?

먼저 수동 업데이트를 실행한 뒤 구독 주소가 완전한지, 응답 형식이 클라이언트에서 지원되는지 확인하고 그룹 필터 조건도 점검하세요. 목록이 비어 있으면 구독을 가져오거나 파싱하는 단계의 문제입니다. 항목은 있지만 연결에 실패한다면 노드 매개변수, 네트워크 환경과 코어 로그를 확인해야 합니다.

시스템 프록시와 TUN 모드는 어떻게 다른가요?

시스템 프록시는 주로 시스템 프록시 설정을 읽는 프로그램에 적용됩니다. TUN은 가상 네트워크 인터페이스를 통해 더 넓은 범위의 트래픽을 가로채며 권한, DNS, 라우팅과 로컬 네트워크 호환성에도 영향을 줍니다. 먼저 일반 시스템 프록시로 테스트를 완료한 뒤 TUN 활성화 여부를 결정하세요.

클라이언트를 업데이트해도 기존 설정을 계속 사용할 수 있나요?

대부분의 일반적인 구독과 기본 설정은 유지할 수 있지만, 복잡한 라우팅·DNS·TUN과 특정 프로토콜 매개변수는 클라이언트나 코어 변경의 영향을 받을 수 있습니다. 업데이트 전에 핵심 설정을 기록하고, 업데이트 후 최소 설정을 먼저 테스트한 다음 고급 기능을 하나씩 복원하세요.

V2Ray 용어집 보기 →
TECH NOTES

클라이언트 설정 및 코어 기술 노트

구독 형식, 노드 선택, 클라이언트 인터페이스, 코어 차이와 문제 해결 방법을 기록합니다. 글은 구체적인 문제를 중심으로 구성해 검색 결과에서 필요한 단계로 바로 이동할 수 있습니다.

입문 가이드

v2rayN 메인 화면 기능 한눈에 보기: 서버 목록·구독 그룹·로그·설정 영역 해설

서버 목록의 정렬과 테스트, 구독 그룹 관리 메뉴, 로그 패널 읽는 법, 트레이 메뉴와 핵심 설정의 위치를 영역별로 설명합니다. 설치를 마친 뒤 인터페이스 구조를 익히는 데 적합합니다.

전체 글 읽기 →
문제 해결

구독 업데이트에 실패하면? 흔한 원인 진단과 자동 업데이트 설정 방법

구독 주소 만료, 네트워크 연결, 형식 호환성, 클라이언트 설정이라는 네 가지 원인을 차례로 확인하고 수동 업데이트와 자동 업데이트의 사용 범위도 설명합니다. 구독 문제를 노드 장애로 잘못 판단하지 않도록 도와줍니다.

전체 글 읽기 →
코어 분석

Xray 코어와 V2Fly 코어 비교: 기능 차이와 클라이언트 선택 가이드

두 코어 계열의 발전 관계와 유지 관리 방향을 정리하고 VLESS, REALITY, XTLS 등의 기능을 비교합니다. v2rayN·v2rayNG·v2flyNG를 바탕으로 선택 기준도 설명합니다.

전체 글 읽기 →
전체 글 보기 →