Project V 클라이언트 가이드

V2Ray 공식 다운로드v2rayN 및 설정 가이드

플랫폼에 맞는 오픈 소스 클라이언트를 선택하고 구독 가져오기부터 프로토콜 및 라우팅 설정까지 진행하세요.

완전 무료 한국어 설정 안내 Xray · V2Fly
코어 및 프로토콜

Xray / V2Fly

VLESSVMessTrojan
호환 범위 보기 →
오픈 소스 생태계

Project V

클라이언트는 설정을 관리하고, 코어는 연결을 처리합니다. 먼저 두 역할을 구분하세요.

클라이언트 3종 비교 →
서버 관리

구독 그룹 및 라우팅 규칙

구독은 출처별로 관리하고, 목적지에 따라 아웃바운드를 선택합니다.

가져오기 단계 보기 →
트래픽 처리

가상 네트워크 어댑터와 시스템 프록시는 트래픽을 처리하는 범위가 다릅니다.

TUN 모드 이해하기 →

설정 창은 항목 간 관계를 보여 주는 예시입니다. 실제 매개변수는 서버에서 제공한 설정과 일치해야 하며, 프로토콜 이름만으로 추측해서는 안 됩니다.

V2Ray 클라이언트 플랫폼별 다운로드

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 고려하세요. 운영체제와 프로세서 아키텍처를 확인한 뒤 다운로드 센터에서 설치 파일을 선택하면 됩니다. 클라이언트를 설치한 후에도 유효한 서버 설정이나 구독을 가져와야 합니다.

Windows

v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 UI를 사용하고, WPF 버전은 익숙한 데스크톱 인터페이스를 유지합니다. 두 UI를 동시에 설치할 필요는 없습니다. 다운로드 페이지 안내에 따라 하나를 선택한 다음 구독을 가져오고 시스템 프록시를 설정하세요.

기존 환경에서 옮길 때는 먼저 구독 그룹, 라우팅 규칙, 개인 설정을 백업하세요. 실행 중인 프로그램의 폴더를 새 프로그램으로 바로 덮어쓰지 마세요. 클라이언트를 종료한 뒤 작업하면 파일 잠금과 설정 혼선을 줄일 수 있습니다. TUN을 켜기 전에 필요한 권한이 있는지도 확인하세요.

다운로드 · Windows

macOS

v2rayN 설치 파일은 Apple Silicon과 Intel 칩용으로 나뉩니다. 먼저 시스템의 ‘이 Mac에 관하여’에서 칩 정보를 확인하고 해당 아키텍처에 맞는 파일을 선택하세요. 칩과 설치 파일의 아키텍처가 일치해야 하며, 컴퓨터 외관이나 구입 연도만으로 판단하면 안 됩니다.

처음 실행한 뒤 사용할 수 있는 설정을 하나 가져와 시스템 프록시가 작동하는지 확인하세요. 브라우저는 연결되지만 다른 앱은 기존 네트워크를 사용한다면, 노드 매개변수를 바로 바꾸기보다 해당 앱이 시스템 프록시를 따르는지 확인하세요. 가상 네트워크 어댑터 권한과 트래픽 처리 설정은 별도 단계가 필요하므로 가이드에 따라 하나씩 점검하면 문제를 찾기 쉽습니다.

다운로드 · macOS

Android

Xray 코어를 사용하는 v2rayNG를 우선 권장합니다. 기존 V2Fly 설정이 필요한 경우 v2flyNG도 고려할 수 있습니다. 최신 기기 대부분은 arm64 설치 파일에 적합하며, 아키텍처가 확실하지 않으면 범용 버전 안내를 확인하세요. 두 클라이언트의 인터페이스와 코어 기능은 각각 확인해야 합니다.

처음 연결할 때는 시스템의 VPN 연결 요청을 허용해야 합니다. 연결 후 백그라운드로 전환할 때 끊긴다면 배터리 최적화, 백그라운드 실행, 다른 VPN 앱의 점유 여부를 먼저 확인하세요. 구독 주소와 공유 링크에는 설정 정보가 포함되어 있으므로 공개 댓글이나 스크린샷에 올리지 않는 것이 좋습니다.

다운로드 · Android

Linux

v2rayN은 deb 및 rpm 배포판별 다운로드를 제공하며 x64와 arm64 아키텍처도 구분합니다. 먼저 배포판의 패키지 형식을 확인한 다음 프로세서 아키텍처를 확인하세요. 설치 파일 형식, 아키텍처, 데스크톱 실행 환경은 서로 다른 조건이므로 혼동하면 안 됩니다.

시스템 프록시가 작동하는지는 데스크톱 환경과 앱 자체 설정에도 영향을 받습니다. 문제를 확인할 때는 프록시를 명시적으로 지원하는 앱으로 연결을 테스트한 뒤 TUN 처리를 검토하세요. 가상 네트워크 어댑터 권한이나 시스템 라우팅을 변경해야 한다면 가이드에 따라 진행하고 기존 설정을 보존하세요. 여러 네트워크 도구가 기본 경로를 동시에 변경하지 않도록 주의해야 합니다.

다운로드 · Linux
전체 클라이언트 보기 →설치 파일 선택, 시스템 요구 사항 및 설치 안내는 다운로드 센터에서 확인할 수 있습니다.

v2rayN 설정 및 관리 기능

실제 작업에 맞춰 설정 항목을 살펴보세요. 먼저 서버 매개변수와 구독 출처를 확인하고, 다음으로 트래픽을 코어에 전달하는 방식과 규칙에 따른 아웃바운드를 정합니다. 아래는 필드 예시이며 실제로 연결할 수 있는 서버 정보는 포함되어 있지 않습니다.

프로토콜, 전송 방식, 보안 계층을 각각 확인하세요

다중 프로토콜 지원은 서로 다른 서버 설정을 사용할 수 있게 해 주는 기능이지, 임의의 프로토콜 매개변수를 서로 바꿔 쓸 수 있다는 뜻은 아닙니다. 서버를 추가할 때는 공유 정보에 따라 VMess, VLESS 또는 Trojan을 선택한 뒤 주소, 포트, 인증 항목, 전송 계층 보안을 확인하세요. VLESS에 REALITY를 조합하는 경우 공개 키, ShortId, 서버 이름도 확인해야 합니다. 연결 스위치만 보여 주는 간단한 화면과 달리 계층별 설정은 오류를 항목별로 찾기 쉽습니다. 실제 선택 가능한 항목은 코어가 지원하는 기능에 따라 달라지며, 프로토콜을 바꾼다고 매개변수가 자동으로 수정되지는 않습니다.

프로토콜 및 코어 참고 자료 보기 →
서버 추가
프로토콜 유형VLESS
전송 프로토콜tcp
전송 계층 보안reality

REALITY는 보안 계층 방식이며 VLESS와 같은 계층의 프록시 프로토콜이 아닙니다.

Project V 생태계와 클라이언트 선택

클라이언트, 코어, 프로토콜은 서로 다른 계층에 속합니다. 이 세 가지를 구분하면 ‘가져오기는 되지만 실행되지 않는’ 문제나 ‘코어를 바꾼 뒤 필드가 작동하지 않는’ 문제를 설명하기 쉽고, 연결 문제 하나 때문에 소프트웨어를 계속 바꾸는 일도 줄일 수 있습니다.

Project V: 모듈형 프록시 도구의 배경

Project V는 V2Ray 생태계를 이해하는 출발점입니다. 인바운드, 아웃바운드, 라우팅, 전송 등의 기능을 조합 가능한 모듈로 나누어 다양한 사용 환경을 설정으로 표현합니다. 사용자가 주로 보는 서버 목록은 GUI에 표시되는 정보의 한 부분일 뿐이며, 코어는 프로토콜, 인증, 전송, 라우팅 등의 구조화된 정보를 읽습니다. 따라서 ‘V2Ray 클라이언트’는 모든 기능이 똑같은 단일 제품을 가리키는 말이 아니라, 관련 코어와 설정 방식을 중심으로 구성된 도구들을 뜻합니다.

V2Fly는 V2Ray의 커뮤니티 개발 및 유지보수 작업을 이어가고 있으며, Xray는 관련 코드 기반에서 출발해 자체 기능 방향으로 발전했습니다. 공통된 배경을 공유하지만 구현과 확장 기능은 각자 다르게 발전해 왔습니다. 어떤 이름이 더 최신인지 묻기보다 현재 서버에 필요한 프로토콜, 보안 계층, 흐름 제어를 정리한 뒤 클라이언트와 코어가 이를 지원하는지 확인하세요. 기존 구성이 필요한 기능을 충족한다면 이름이 바뀌었다는 이유만으로 이전하기보다 필드 호환성, 시스템 지원, 구체적인 기능처럼 명확한 이유가 있을 때 진행하는 편이 좋습니다.

코어 계열: 호환성 기반과 확장 범위

VMess, VLESS, Trojan, Shadowsocks는 서로 다른 프록시 프로토콜입니다. TCP와 WebSocket 등은 전송 관련 옵션이며 TLS와 REALITY는 연결 보안 계층에 해당합니다. 설정 화면에 이 항목들이 함께 표시된다고 같은 계층에 있는 것은 아닙니다. 특히 VLESS만으로 전체 전송 보안 설정을 대신할 수 없으며, XTLS Vision도 필요한 조건을 갖춘 흐름 제어 방식이므로 서버 설정과 맞지 않는 환경에서 임의로 활성화하면 안 됩니다.

REALITY와 XTLS Vision 설정에서는 Xray의 기능 지원 여부와 클라이언트 필드 매핑을 특히 확인해야 합니다. V2Fly와 Xray는 일부 기본 설정 개념이 비슷하지만 확장 필드, 기본 동작, 지원 범위는 다를 수 있습니다. 설정 파일을 특정 UI에서 읽을 수 있다고 모든 필드가 그대로 유지되는 것은 아니며, 구독을 가져오는 데 성공해도 해당 코어가 반드시 실행된다는 뜻은 아닙니다. 호환되지 않는 문제가 생기면 먼저 시작 단계의 구체적인 오류를 확인한 뒤 클라이언트의 구문 분석, 코어 지원, 서버 매개변수 중 어느 문제인지 판단하세요.

속도와 리소스 사용량은 프로토콜 이름만으로 순위를 매길 수 없습니다. 핸드셰이크 횟수, 전송 캡슐화, 연결 재사용, 서버 부하, 네트워크 왕복 시간 모두 성능에 영향을 줍니다. 모바일 기기의 배터리 소모는 백그라운드 연결, 네트워크 전환, 트래픽 처리 범위에도 좌우됩니다. 같은 기기와 네트워크, 비슷한 부하 조건에서 평소 작업을 비교하고 연결 안정성도 함께 살펴보세요. 지연 시간 테스트 한 번으로 특정 프로토콜이 항상 더 빠르다고 결론 내릴 수는 없습니다.

오픈 소스 클라이언트 3종: 플랫폼과 코어 요구 사항에 맞춰 선택

v2rayN은 데스크톱의 주요 클라이언트로, GUI에서 구독 그룹, 서버, 라우팅, 연결 설정을 관리하는 데 적합합니다. 설정 작업을 체계적으로 관리하는 도구이지 서버 매개변수를 대체하거나 서버를 자동으로 제공하는 프로그램은 아닙니다. 데스크톱 버전과 클래식 WPF 버전 중 무엇을 선택할지는 현재 시스템과 선호하는 인터페이스에 따라 달라집니다. 이후 설정이 작동하는지는 선택한 코어와 서버 정보를 기준으로 판단해야 합니다. 자세한 차이는 선택 가이드에서 비교할 수 있습니다.

Android에서는 v2rayNG를 우선 고려할 수 있습니다. Xray 코어는 해당 프로토콜 기능이 필요한 설정에 적합합니다. v2flyNG는 V2Fly 코어를 사용하므로 기존 V2Fly 환경의 대안으로 활용할 수 있습니다. 앱 이름이 비슷하다고 고급 기능까지 같다고 볼 수는 없습니다. 클라이언트 간에 가져오기 전에 구독이 서버 공유 형식인지 전체 설정 파일인지 확인하세요. 전체 설정에는 로컬 인바운드, 라우팅 태그, 플랫폼별 항목이 포함될 수 있어 공유 링크 하나를 가져올 때보다 더 꼼꼼한 점검이 필요합니다.

세 클라이언트는 모두 오픈 소스 소프트웨어 생태계에 속하며, 소스 코드, 라이선스, 커뮤니티 유지보수가 기술적 기반을 이룹니다. 오픈 소스라고 해서 모든 구성 요소가 같은 라이선스를 적용받는 것은 아닙니다. 라이선스 조건에 따라 소프트웨어를 살펴보고 사용하거나 재배포할 수 있지만, 클라이언트 UI, 코어, 포함된 구성 요소에는 각각 별도의 요구 사항이 있을 수 있습니다. 일반적인 사용에는 제품 안내를 먼저 확인하고, 수정·통합·배포할 때는 관련 라이선스를 각각 살펴보세요. ‘무료 사용’을 자유로운 재포장과 동일시해서는 안 됩니다.

업데이트 및 문제 해결: 재현 가능한 설정 기준 유지

클라이언트 프로그램, 실행 코어, 구독 콘텐츠는 서로 다른 업데이트 경로를 따릅니다. 클라이언트 업데이트는 주로 인터페이스, 설정 생성, 시스템 통합에 영향을 주고, 코어 업데이트는 프로토콜 지원과 실행 동작을 바꿀 수 있으며, 구독 업데이트는 서버 항목을 새로고침합니다. 문제를 확인할 때 세 가지를 한꺼번에 바꿀 필요는 없습니다. 현재 설정을 저장하고 기존에 작동하던 연결 방식을 기록한 다음 한 번에 한 요소만 변경해 예상한 변화가 있는지 확인하는 편이 안전합니다.

예를 들어 구독 업데이트에 실패했다고 소프트웨어를 먼저 재설치할 필요는 없습니다. 링크가 온전한지, 출처가 여전히 유효한지, 현재 요청 방식으로 접속할 수 있는지 확인하고 오류 내용을 살펴보세요. 서버 항목은 있는데 연결되지 않는다면 코어가 실행되는지, 주소가 해석되는지, 대상 포트에 연결할 수 있는지, 인증 정보가 일치하는지로 문제를 나눠 확인하세요. 브라우저는 연결되는데 특정 앱만 문제가 있다면 트래픽 처리 범위를 먼저 살펴보고, 특정 도메인에서만 문제가 생기면 라우팅과 DNS를 먼저 확인하세요.

문제를 문의할 때는 작업 단계, 오류가 발생한 시점, 관련 설정 항목 이름을 남기고 구독 주소나 사용자 ID 같은 개인 설정 정보는 가리세요. 로그에는 ‘연결할 수 없음’이라는 설명보다 유용한 정보가 담겨 있지만, 주소나 인증 정보가 노출되지 않았는지 먼저 확인해야 합니다. 설정 가이드를 따라 작동하는 최소 구성을 만든 뒤 트래픽 분할과 TUN 설정을 단계적으로 추가하면 고급 옵션을 한꺼번에 켜는 것보다 원인을 명확히 파악하기 쉽습니다.

설정 가이드 및 프로토콜 문서

클라이언트 설정에서 한 단계 더 나아가 설정 구조를 살펴보세요. 먼저 각 모듈의 역할을 이해한 뒤 기본 동작을 변경할 필요가 있는지 판단하세요. 아래 세 문서에서는 필드 간 관계, DNS 트래픽 분할, REALITY의 기술적 위치를 각각 설명합니다.

V2Ray 다운로드