PROJECT V CLIENT GUIDE

v2rayNG 공식 사이트
V2Ray 클라이언트 및 구독 설정

v2rayN 데스크톱 클라이언트, v2rayNG Android 클라이언트, v2flyNG 대체 클라이언트의 다운로드와 사용법을 한곳에 정리했습니다. 구독 가져오기부터 실제 설정 항목을 따라 시스템 프록시, TUN, 라우팅 규칙과 로그 점검 방법을 설명합니다.

영구 무료 오픈 소스 Xray · V2Fly VMess · VLESS · Trojan · REALITY

CLIENT WORKFLOW

구독, 라우팅 및 프록시 설정

네 개의 설정 화면은 클라이언트에서 가장 자주 사용하는 영역을 보여 줍니다. 각 카드에서 인터페이스 예시를 전환해 설정 항목의 관계를 먼저 파악한 뒤, 전체 가이드에서 단계별로 따라 할 수 있습니다.

구독 그룹
기본 구독사용 중
구독 자동 업데이트
업데이트 후 선택 유지

SUBSCRIPTION

구독 그룹 관리

구독 링크는 설정 업데이트를 지속적으로 받을 때 유용하지만, 모든 주소를 하나의 목록에 섞어 두어서는 안 됩니다. 용도별로 그룹을 만들면 업데이트 주기, 현재 선택 항목과 비활성 상태를 각각 관리할 수 있습니다. 가져오기 전에 링크가 빠짐없이 복사되었는지 확인하고, 그룹에는 알아보기 쉬운 이름을 지정하세요. 업데이트가 끝나면 추가·삭제된 항목과 현재 선택 항목을 확인해 의도치 않게 설정이 바뀌지 않았는지 점검합니다. 한 번 붙여넣고 끝나는 단순한 클라이언트보다 그룹 방식이 일상용, 테스트용, 임시 설정을 함께 관리하기에 적합하며, 구독 업데이트 실패 시 원인 범위를 좁히기도 쉽습니다.

구독 가져오기 단계 보기 →
라우팅 규칙
도메인 규칙우선 매칭
IP 규칙순서대로 매칭
매칭되지 않은 트래픽기본 출구

ROUTING

라우팅 규칙과 트래픽 분할 순서

라우팅은 도메인, IP, 프로세스별로 어떤 출구를 사용할지 결정하며, 규칙 수보다 순서가 중요합니다. 클라이언트는 일반적으로 위에서 아래로 매칭하므로 앞의 포괄적인 조건이 뒤의 정확한 조건을 덮어쓸 수 있습니다. 구체적인 규칙을 먼저 배치하고 마지막에 기본 규칙을 두세요. 설정하기 전에 시스템 프록시가 필요한 앱과 직접 연결할 앱을 구분한 다음, 로그에서 실제로 적용된 규칙을 확인합니다. 가이드에서는 도메인 정책, IP 해석과 기본 출구의 관계도 설명하므로 규칙을 그대로 복사하기보다 작동 방식을 이해할 수 있습니다. 분명한 트래픽 분할 구조는 불필요한 전달을 줄여 문제 원인도 더 쉽게 찾게 해 줍니다.

라우팅 설정 안내 읽기 →
시스템 프록시
시스템 프록시 설정
프록시 모드라우팅 규칙 기준
종료 시 설정 정리

PROXY MODE

시스템 프록시와 TUN 모드

시스템 프록시는 운영체제의 프록시 설정을 따르는 앱의 연결을 주로 처리하므로 설정이 간단하고 브라우저와 일반적인 데스크톱 프로그램에 적합합니다. TUN은 네트워크 인터페이스 계층에서 더 많은 트래픽을 처리해 적용 범위가 넓지만 추가 권한이 필요하고 라우팅과 DNS 설정의 영향도 크게 받습니다. 두 방식을 반드시 함께 켤 필요는 없습니다. 처음에는 시스템 프록시로 구독과 설정이 정상인지 확인한 뒤, 앱 호환성에 따라 TUN 사용 여부를 결정하세요. 전환하기 전 중요한 연결을 종료하고 기존 설정을 기록해 두면 네트워크 이상 발생 시 빠르게 되돌릴 수 있습니다. 전체 가이드는 두 모드를 쉬운 단계부터 차례로 설명합니다.

연결 및 프록시 설정 보기 →
실행 로그
로그 수준warning
시간 표시
자동 스크롤

DIAGNOSTICS

로그 수준과 문제 추적

연결에 실패했을 때는 설정을 계속 바꾸기보다 먼저 로그를 확인하는 편이 효과적입니다. 평소에는 warning 수준을 유지하고, 문제가 재현될 때만 일시적으로 상세 수준을 높이세요. 시간, 대상 주소, 프로토콜 단계와 오류 키워드를 중점적으로 확인하면 됩니다. timeout은 네트워크 경로, 주소 또는 포트 문제일 가능성이 높고, rejected는 로컬 규칙과 원격 응답을 추가로 구분해야 합니다. invalid는 대개 설정 필드가 서로 맞지 않을 때 발생합니다. 점검할 때는 한 번에 한 항목만 바꾸고 변경 전후 로그를 보관해야 실제 원인을 확인할 수 있습니다. 이 사이트는 자주 발생하는 오류를 구체적인 점검 행동으로 연결해 막연한 반복 시도를 줄여 줍니다.

문제 해결 Q&A로 이동 →

PLATFORM DOWNLOADS

현재 기기에 맞는 클라이언트 선택

데스크톱은 v2rayN부터 시작하고, Android에서는 필요한 코어에 따라 v2rayNG와 v2flyNG 중에서 선택하면 됩니다. 다운로드 페이지에서 프로세서 아키텍처와 설치 형식도 확인할 수 있습니다.

DESKTOP

Windows

Windows 사용자는 v2rayN을 우선 선택하세요. 다운로드 페이지에는 최신 크로스플랫폼 데스크톱 인터페이스와 클래식 WPF 인터페이스가 함께 제공됩니다. 전자는 일관된 사용 경험을 원하는 사용자에게, 후자는 기존 Windows 설정 방식에 익숙한 사용자에게 적합합니다. 설치 후 먼저 구독을 가져온 다음 시스템 프록시를 켜 기본 연결을 확인하세요.

다운로드하기

DESKTOP

macOS

macOS에서는 v2rayN 데스크톱 클라이언트를 사용합니다. 다운로드 전에 시스템 정보를 열어 프로세서 유형을 확인하고 Apple Silicon 또는 Intel용 설치 파일을 선택하세요. 처음 실행할 때 시스템에서 앱 권한 확인을 요구하면 안내에 따라 진행합니다. 이후 클라이언트 안에서 구독을 가져오고, 구독 주소를 브라우저 주소창에 직접 붙여넣지는 마세요.

다운로드하기

MOBILE

Android

Android 사용자는 보통 Xray 코어 기반의 v2rayNG를 먼저 선택합니다. V2Fly 코어가 필요하다면 v2flyNG를 사용할 수 있습니다. 최신 기기는 대체로 arm64 아키텍처가 적합하며, 프로세서 유형을 모르면 범용 설치 파일을 선택하세요. 가져오기가 끝나면 시스템의 VPN 연결 생성을 허용한 뒤 백그라운드 실행과 배터리 정책을 확인해야 합니다.

다운로드하기

DESKTOP

Linux

Linux 데스크톱에서는 v2rayN을 사용할 수 있습니다. 배포판에 맞춰 deb 또는 rpm 설치 형식을 선택하고, 기기가 x64인지 arm64인지도 확인하세요. 설치 후 데스크톱 환경의 시스템 프록시 메뉴를 먼저 확인한 다음 시스템 프록시와 TUN 중 사용할 방식을 결정합니다. Linux에서는 권한, DNS와 방화벽 설정이 자주 확인해야 하는 항목입니다.

다운로드하기

QUICK START

세 단계로 기본 연결 완료

먼저 최소한의 사용 가능한 설정을 완료한 뒤 라우팅, DNS와 백그라운드 정책을 조정하세요. 한 번에 너무 많이 변경하면 문제의 원인을 찾기 어려워집니다.

  1. 플랫폼과 설치 파일 선택

    다운로드 센터에 들어가 현재 운영체제로 먼저 전환하세요. Windows, macOS와 Linux에서는 v2rayN을 사용하고, Android에서는 v2rayNG 또는 v2flyNG를 선택할 수 있습니다. 데스크톱 기기는 프로세서 아키텍처와 설치 형식을 구분하고, Android 기기는 arm64와 범용 설치 파일 중에서 고릅니다. 다운로드가 끝나면 운영체제의 일반적인 방식으로 설치하세요. 같은 종류의 클라이언트를 여러 개 동시에 실행하면 로컬 프록시 포트를 놓고 충돌하거나 시스템 네트워크 설정을 중복으로 변경할 수 있습니다.

  2. 구독 가져오기 및 설정 확인

    V2Ray 구독 링크를 빠짐없이 복사해 클라이언트의 구독 그룹 또는 구독 설정에 주소를 추가한 다음 수동 업데이트를 한 번 실행하세요. 업데이트가 완료되었다고 설정이 반드시 정상인 것은 아닙니다. 그룹에 항목이 표시되는지, 주소와 포트가 완전한지, 프로토콜 유형이 예상과 맞는지도 확인해야 합니다. 업데이트에 실패하면 시스템 시간, 로컬 네트워크와 링크 앞뒤가 누락되지 않았는지 먼저 점검하고 클라이언트 로그를 확인하세요. 업데이트 버튼을 연속해서 반복해서 누르지는 마세요.

  3. 프록시 활성화 및 연결 확인

    설정을 하나 선택한 뒤 데스크톱에서는 시스템 프록시를 켜고, Android에서는 시스템 안내에 따라 VPN 연결을 생성합니다. 확인할 때는 평소 사용하는 웹페이지나 앱에 먼저 접속하고 클라이언트 로그에 해당 연결 기록이 남는지 살펴보세요. 기본 연결이 안정된 뒤에 라우팅, TUN, DNS 또는 자동 업데이트를 설정합니다. 이상이 발생하면 로컬 네트워크, 시스템 시간, 구독 상태, 설정 매개변수, 프록시 모드 순서로 확인하는 것이 무작정 설정을 바꾸는 것보다 원인을 찾기 쉽습니다.

PROJECT V ECOSYSTEM

V2Fly, Xray와 클라이언트의 관계

그래픽 클라이언트는 설정 관리와 시스템 연동을 담당하고, 코어는 프로토콜, 전송, 라우팅과 연결을 처리합니다. 이 관계를 이해해야 업데이트 내용과 호환 범위를 정확히 판단할 수 있습니다.

Project V 생태계와 코어 분기

Project V는 네트워크 프록시 프로토콜, 전송 방식과 라우팅 기능을 중심으로 형성된 오픈 소스 기술 생태계입니다. 초기 V2Ray 프로젝트가 설정 구조와 핵심 기능을 마련했고, 이후 커뮤니티 유지보수를 통해 여러 분기가 형성되었습니다. V2Fly는 V2Ray 생태계의 핵심 구현과 문서 체계를 이어받아 커뮤니티 협업과 지속적인 유지보수를 강조합니다. Xray는 기존 설정 방식과의 호환을 바탕으로 자체적인 코어 방향을 발전시키며 프로토콜과 전송 관련 기능을 계속 확장하고 있습니다. 둘 다 그래픽 클라이언트가 아니며 특정 설치 화면과 동일한 것도 아닙니다.

v2rayN, v2rayNG와 v2flyNG는 코어 위에서 동작합니다. 클라이언트는 복잡한 설정을 구독 그룹, 서버 목록, 시스템 프록시 스위치, TUN 설정, 라우팅 규칙과 로그 창으로 정리해 그래픽 인터페이스에서 실행 과정을 관리할 수 있게 합니다. 실제 연결 생성, 프로토콜 필드 해석과 라우팅 실행은 탑재된 코어가 담당합니다. 따라서 특정 프로토콜이나 전송 방식의 사용 가능 여부를 판단할 때는 클라이언트가 해당 설정을 제공하는지와 코어가 관련 필드를 지원하는지를 함께 확인해야 합니다.

세 클라이언트의 용도

v2rayN은 Windows, macOS와 Linux 데스크톱 환경을 대상으로 구독 관리, 시스템 프록시, TUN, 라우팅, DNS와 로그 등 주요 기능을 제공합니다. 컴퓨터에서 여러 설정을 한곳에서 관리하고 표시되는 로그로 연결 문제를 확인하려는 사용자에게 적합합니다. 데스크톱 운영체제마다 설치 형식과 권한 처리에는 차이가 있지만 기본 설정 절차는 동일합니다.

v2rayNG는 Android용으로 Xray 코어를 기반으로 하며, 모바일 기기의 VPN 연결 방식, 구독 업데이트, 라우팅 설정과 백그라운드 실행에 맞춰 구성되어 있습니다. 모바일 운영체제는 백그라운드 작업을 적극적으로 제한하므로 연결 안정성은 클라이언트 설정뿐 아니라 시스템 배터리 정책, 백그라운드 권한과 네트워크 전환 동작에도 영향을 받습니다.

v2flyNG도 Android용 클라이언트이며 V2Fly 코어를 사용합니다. 해당 코어 생태계가 필요한 경우 대안으로 적합합니다. 기본 사용 방식은 v2rayNG와 비슷하지만 코어 구현, 일부 설정 기능과 업데이트 주기는 완전히 같지 않습니다. 선택할 때는 화면만 비교하지 말고 구독에서 사용하는 프로토콜과 전송 매개변수를 먼저 확인한 뒤 적합한 코어 방향을 결정하세요.

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

세 클라이언트와 관련 코어는 오픈 소스 방식으로 유지보수되며, 소스 코드와 변경 과정은 프로젝트 커뮤니티에서 지속적으로 검토합니다. 오픈 소스라고 해서 모든 버전이 자동으로 호환되는 것은 아닙니다. 기능 발전에 따라 설정 필드가 바뀔 수 있고, 플랫폼별로 클라이언트 인터페이스 구현도 달라질 수 있습니다. 안전하게 업데이트하려면 변경 사항을 먼저 읽고 현재 사용 가능한 설정을 보관한 뒤 클라이언트를 업데이트하고 기본 연결 테스트를 한 번 실행하세요.

커뮤니티가 유지보수하는 소프트웨어는 단일 업체처럼 고정된 출시 주기를 따르지 않는 경우가 많습니다. 클라이언트, 코어와 문서가 각각 업데이트될 수 있고, 새로운 프로토콜 매개변수가 먼저 코어에 추가된 뒤 클라이언트에 그래픽 설정이 제공되기도 합니다. 때로는 수동 설정으로 먼저 사용할 수 있습니다. 따라서 ‘설정 항목을 찾을 수 없음’ 또는 ‘가져온 뒤 필드가 사라짐’ 문제가 발생하면 클라이언트 화면, 코어 지원 여부와 구독 내용 중 어디에서 비롯되었는지 구분해야 하며, V2Ray 클라이언트 전체가 작동하지 않는다고 단정해서는 안 됩니다.

프로토콜 이름만으로는 전체 설정이 아니다

VMess, VLESS, Trojan과 REALITY 같은 이름은 설정의 일부만 설명합니다. 실제로 연결하려면 서버 주소, 포트, 사용자 식별자, 전송 방식, TLS 관련 매개변수, 도메인, 경로와 라우팅 정책도 필요합니다. 클라이언트가 구독을 가져오면 이 필드를 코어에 전달해 처리하며, 중요한 필드 하나라도 맞지 않으면 시간 초과, 핸드셰이크 실패 또는 잘못된 설정이 발생할 수 있습니다. 이 사이트의 프로토콜 설명은 필드 간 관계와 클라이언트 내 위치에 초점을 두며, 서버 측 매개변수와 무관한 ‘범용 최적 설정’은 제공하지 않습니다.

COMMON QUESTIONS

자주 묻는 질문

먼저 바로 적용할 결론을 확인한 다음, 문제 해결 페이지에서 분류별 점검을 이어가세요.

v2rayN 구독 업데이트가 실패하면 무엇부터 확인해야 하나요?

먼저 일반 네트워크 연결과 시스템 시간이 정상인지 확인하고, 구독 주소가 완전한지와 복사 과정에서 여분의 공백이 들어가지 않았는지 점검하세요. 그런 다음 로그를 열어 요청 단계의 오류 정보를 확인합니다. 같은 주소가 다른 기기에서도 업데이트되지 않는다면 구독 상태를 우선 확인하고, 현재 기기에서만 실패한다면 시스템 프록시, DNS와 방화벽 설정을 이어서 점검하세요.

설치 및 설정 Q&A 보기 →

VMess와 VLESS 중 무엇을 선택해야 하나요?

클라이언트가 서버 설정과 무관하게 프로토콜을 임의로 바꿀 수는 없습니다. 구독 또는 서버에서 제공하는 프로토콜 유형을 기준으로 하고 사용자 식별자, 전송 방식, TLS 매개변수와 도메인 등의 필드를 일치시켜야 합니다. VLESS는 일반적으로 연동된 전송 및 보안 매개변수의 영향을 더 많이 받으며, VMess도 정확한 시간과 인증 필드가 필요합니다.

기초 개념 Q&A 보기 →

시스템 프록시와 TUN은 어떻게 다른가요?

시스템 프록시는 운영체제의 프록시 설정을 읽는 앱에만 영향을 주며 설정이 가볍고 되돌리기 쉽습니다. TUN은 가상 네트워크 인터페이스에서 더 넓은 범위의 트래픽을 처리하므로 추가 권한과 세밀한 라우팅 설정이 필요합니다. 먼저 시스템 프록시로 연결을 확인한 뒤, 특정 앱의 트래픽이 적용 대상에 포함되는지에 따라 TUN 사용 여부를 결정하세요.

프록시 모드 단계 보기 →

노드 시간 초과가 발생해도 설정을 먼저 계속 바꾸면 안 되는 이유는 무엇인가요?

시간 초과는 로컬 네트워크, 시스템 시간, 만료된 구독, 주소와 포트, 프로토콜 매개변수 또는 라우팅 설정에서 발생할 수 있습니다. 계속 전환하면 여러 변수가 동시에 바뀌어 원인을 확인하기 어려워집니다. 현재 설정을 고정하고 네트워크, 구독, 매개변수, 프록시 모드와 로그 순서로 하나씩 확인하면 안정적인 해결 방법을 찾기 쉽습니다.

문제 해결 Q&A 보기 →

LATEST ARTICLES

클라이언트 설정 및 문제 해결 글

모바일 백그라운드 실행, 코어 선택과 초보자가 자주 겪는 문제를 중심으로 가이드에서 다루지 못한 구체적인 상황을 보완합니다.

문제 해결

v2rayNG 배터리 소모가 빠를 때: Android 백그라운드 실행 및 절전 정책 점검

시스템 배터리 통계로 배터리 소모 원인을 찾고, 백그라운드 유지 설정, 라우팅 규칙 범위와 구독 자동 업데이트 주기를 차례로 점검합니다. 배터리 사용 시간과 안정적인 연결을 함께 고려한 설정 방향도 제시합니다.

전체 글 읽기 →
코어와 선택

Xray와 V2Fly 코어의 차이: 버전 관계 정리와 클라이언트 선택 가이드

Project V 생태계에서 V2Fly와 Xray 두 코어 분기의 관계, 프로토콜 지원 차이와 업데이트 흐름을 정리하고 v2rayNG와 v2flyNG가 각각 적합한 사용 상황을 설명합니다.

전체 글 읽기 →
입문 가이드

V2Ray 초보자 10문 10답: 구독 가져오기, 프로토콜 선택과 연결 실패 한 번에 이해하기

클라이언트 선택, V2Ray 구독 링크 입력, VMess와 VLESS 설정 관계, 프록시 모드 차이 등 자주 묻는 내용을 정리하고 각 질문에 실행 가능한 점검 순서를 제시합니다.

전체 글 읽기 →