무료 다운로드

V2Ray 무료 다운로드
클라이언트 및 설정 가이드

v2rayN·v2rayNG·v2flyNG 클라이언트 다운로드 경로와 한국어 설정 문서, Xray·V2Fly 코어 설명을 한곳에 정리했습니다. 다운로드부터 구독 가져오기, 라우팅 분기까지 순서대로 안내합니다.

영구 무료 오픈 소스 한국어 문서 다중 코어 선택

ROUTE / CLIENT FLOW CORE XRAY · V2FLY

LOCAL 로컬

CLIENT INPUT

INBOUND 인바운드

LISTEN · SNIFFING

ROUTING 라우팅

DOMAIN · IP · RULE

OUTBOUND 아웃바운드

SELECTED PATH

CONFIG JSON STATUS READY

PLATFORMS Windows · macOS · Android · Linux

CLIENTS v2rayN · v2rayNG · v2flyNG

CORE FAMILY Xray · V2Fly

DOCUMENTS 설치 · 구독 · 라우팅 · DNS

CLIENT / CONFIG / ROUTING

클라이언트에서 아웃바운드까지 4단계 연결 경로

클라이언트는 연결만 담당하는 단순한 버튼이 아닙니다. 다운로드 선택, 구독 파싱, 라우팅 판단, 코어 실행은 각각 다른 문제를 해결합니다. 연결 경로를 나누어 보면 설정 오류를 더 쉽게 찾을 수 있고, 노드·구독·코어·시스템 프록시를 혼동하는 일도 줄어듭니다.

DOWNLOAD BY PLATFORM

4개 플랫폼 클라이언트 다운로드

홈에서는 플랫폼 선택에 필요한 내용만 정리하고, 구체적인 설치 패키지·시스템 아키텍처·클라이언트 차이는 다운로드 페이지에 모았습니다. 해당 플랫폼으로 이동한 뒤 기기 아키텍처에 맞는 파일을 선택하세요.

DESKTOP

Windows

Windows 데스크톱에서는 v2rayN을 선택하세요. 최신 데스크톱 인터페이스는 여러 플랫폼에서 일관된 조작 방식을 원하는 사용자에게 적합하고, 클래식 WPF 인터페이스는 기존 메뉴와 트레이 조작에 익숙한 사용자에게 알맞습니다. 두 진입점은 같은 플랫폼 패널에 있으며 실행 환경, 압축 해제 폴더, 첫 실행 방법을 함께 안내합니다.

다운로드 페이지로 이동

DESKTOP

macOS

macOS 데스크톱에서는 v2rayN을 사용하며, 다운로드 전에 프로세서 유형을 확인하세요. Apple Silicon 기기는 arm64, Intel 프로세서는 x64를 선택해야 합니다. 아키텍처가 맞지 않으면 프로그램이 정상적으로 시작되지 않을 수 있습니다. 플랫폼 패널에는 시스템 프록시 권한, 첫 실행 방법, 설정 폴더 위치도 안내하여 설치 후 반복적인 문제 해결을 줄였습니다.

다운로드 페이지로 이동

MOBILE

Android

Android에서는 Xray 코어를 사용하는 v2rayNG 또는 V2Fly 코어를 사용하는 v2flyNG를 선택할 수 있습니다. 대부분의 최신 기기는 arm64를 우선 고려하고, 아키텍처를 확인하기 어렵다면 범용 버전을 사용하세요. 두 클라이언트 모두 구독 업데이트, QR 코드 가져오기, 단일 공유 링크를 지원하며 주요 차이는 코어 계열과 프로토콜 지원 범위에 있습니다.

다운로드 페이지로 이동

DESKTOP

Linux

Linux 데스크톱에서는 v2rayN을 사용합니다. 배포판의 패키지 체계에 따라 deb 또는 rpm을 선택하고 x64와 arm64 아키텍처도 구분하세요. 설치 후에는 데스크톱 세션, 설정 폴더 쓰기 권한, 시스템 프록시 적용 방식을 우선 확인해야 합니다. 다운로드 페이지에는 주요 데스크톱 아키텍처를 기본 진입점으로 배치하고 기타 아키텍처는 별도 링크로 명확히 표시했습니다.

다운로드 페이지로 이동

전체 클라이언트 보기

QUICK START

다운로드 후 3단계 설정

처음에는 가장 짧은 연결 경로만 완성하면 됩니다. 사용 가능한 설정을 가져오고, 노드를 선택한 뒤, 시스템 프록시를 켜세요. 기본 연결이 정상임을 확인한 다음 라우팅, DNS, 자동 시작 같은 추가 설정을 다루는 것이 좋습니다.

01
구독 또는 공유 링크 가져오기

구독 주소를 복사한 뒤 클라이언트의 구독 관리에서 새 주소를 추가하고 업데이트를 실행하세요. 단일 vmess, vless 또는 기타 공유 링크를 받은 경우에는 클립보드에서 노드를 가져오는 메뉴를 사용해야 하며, 구독 주소 입력란에 넣으면 안 됩니다. 가져온 후에는 노드 이름과 프로토콜이 표시되는지 먼저 확인하세요. 목록이 비어 있다면 업데이트를 실행하지 않았거나 주소가 완전히 복사되지 않았거나 클라이언트가 일시적으로 구독 내용을 읽지 못하는 경우가 많습니다.
02
노드 및 프록시 모드 선택

노드 목록에서 설정 하나를 활성 서버로 선택한 다음 사용 범위에 맞는 시스템 프록시 모드를 고르세요. 처음 문제를 확인할 때는 규칙을 최대한 단순하게 유지하고, 먼저 브라우저 트래픽이 클라이언트로 들어오는지 확인한 뒤 분기 규칙을 단계적으로 활성화하는 것이 좋습니다. 네트워크 도구를 여러 개 실행 중이라면 로컬 리스닝 포트가 충돌하지 않는지도 확인하세요. 다른 프로그램이 포트를 사용 중이면 코어가 시작되지 않을 수 있으며, 로그에는 리스닝 실패 또는 주소가 이미 사용 중이라는 메시지가 보통 나타납니다.
03
연결 후 실행 로그 확인

코어를 시작하고 시스템 프록시를 켠 뒤에는 여러 설정을 연달아 바꾸기보다 클라이언트 상태와 로그를 먼저 확인하세요. 로그를 통해 설정을 읽었는지, DNS가 응답했는지, 아웃바운드가 연결되었는지, 오류가 프로토콜 핸드셰이크와 로컬 리스닝 중 어디에서 발생했는지 확인할 수 있습니다. 기본 연결이 정상화된 후 라우팅 분기, 구독 자동 업데이트, 시작 시 실행을 설정하세요. 한 번에 한 종류의 매개변수만 바꾸면 어떤 변경이 결과에 영향을 주었는지 쉽게 판단할 수 있습니다.

전체 가이드 보기

COMMON QUESTIONS

자주 묻는 질문

구독을 가져온 뒤 노드가 표시되지 않으면 무엇을 먼저 확인해야 하나요?

먼저 구독이 저장되었고 업데이트를 직접 실행했는지 확인한 뒤, 주소의 시작·끝·중간 문자가 빠짐없이 복사되었는지 살펴보세요. 클라이언트에서 파싱 오류가 표시되면 기존 주소를 변경하지 말고 다시 복사해 보세요. 업데이트에 아무 반응이 없다면 클라이언트의 네트워크 권한과 현재 시스템 프록시 상태를 확인하세요. 단일 공유 링크는 구독 관리가 아니라 클립보드에서 노드를 가져오는 메뉴를 사용해야 합니다. 전체 절차는 사용 문서에서 확인할 수 있습니다.

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

둘 다 Android 그래픽 클라이언트이며, 주요 차이는 코어 계열입니다. v2rayNG는 Xray 코어, v2flyNG는 V2Fly 코어를 중심으로 합니다. 선택할 때는 노드 매개변수, 필요한 프로토콜, 현재 설정과의 호환성을 기준으로 판단하세요. 구독 제공자가 코어 요구 사항을 명시했다면 그에 맞는 선택을 우선해야 합니다. 특별한 요구가 없다면 기본 추천 클라이언트부터 사용한 뒤 로그와 프로토콜 지원 범위를 보고 전환 여부를 결정하면 됩니다.

시스템 프록시를 켜도 연결되지 않으면 원인은 반드시 노드에 있나요?

반드시 그렇지는 않습니다. 연결 경로에는 로컬 리스닝, 시스템 프록시, DNS, 라우팅, 아웃바운드 핸드셰이크가 모두 포함됩니다. 먼저 코어가 정상적으로 시작되었는지 확인하고, 시스템 프록시 포트와 클라이언트 리스닝 포트가 일치하는지 살펴본 다음 로그에서 처음 나타나는 명확한 오류를 읽으세요. 로컬 포트가 열리지 않았다면 권한이나 포트 점유 문제를 먼저 해결해야 합니다. 아웃바운드는 연결되지만 도메인 해석에 실패한다면 노드를 계속 바꾸기보다 DNS 설정을 확인하세요.

구독을 업데이트하면 수동으로 수정한 노드가 덮어써지나요?

구독 노드는 일반적으로 구독 내용에 따라 다시 생성되므로 이름이나 매개변수를 직접 수정하면 다음 업데이트에서 바뀔 수 있습니다. 장기간 유지할 사용자 지정 매개변수는 독립 노드로 복사하거나 클라이언트의 구독 그룹, 라우팅 규칙, 프리셋 기능을 사용하세요. 업데이트 전에 어떤 필드가 구독 데이터이고 어떤 설정이 클라이언트 전역 설정인지 구분하면 반복적인 재설정을 줄일 수 있습니다.

PROJECT V ECOSYSTEM

Project V·V2Fly·Xray의 코어 관계

V2Ray는 흔히 하나의 도구 모음을 가리키는 말로 쓰이지만, 실제로는 기술 생태계·실행 코어·그래픽 클라이언트를 구분해야 합니다. Project V는 모듈형 프록시 아키텍처와 설정 방식을 만들었고, V2Fly는 V2Ray의 핵심 기능을 이어받아 유지 관리합니다. Xray는 같은 기술 계보에서 발전해 독립적인 코어와 확장 기능을 갖추었습니다. v2rayN·v2rayNG·v2flyNG는 사용자에 가까운 계층에서 구독 관리, 노드 선택, 시스템 프록시, 로그 확인을 그래픽 인터페이스로 구성합니다.

01 / HISTORY

생태계의 역사: 구체적인 클라이언트보다 먼저 나온 설정 모델

Project V의 핵심적인 영향은 특정 인터페이스가 아니라 인바운드, 아웃바운드, 라우팅, DNS, 전송, 정책을 조합 가능한 설정 모듈로 나눈 데 있습니다. 그래픽 클라이언트는 이러한 모듈을 메뉴, 양식, 프리셋으로 매핑합니다. 이를 이해하면 서로 다른 클라이언트가 비슷한 노드 매개변수를 사용할 수 있는 이유와, 같은 구독도 코어에 따라 프로토콜 지원 범위가 다르게 나타날 수 있는 이유를 알 수 있습니다.

일상적인 사용에 모든 JSON 필드를 먼저 익힐 필요는 없지만, 각 설정이 어느 계층에 속하는지는 알아야 합니다. 시스템 프록시는 앱 트래픽이 클라이언트로 들어올지 결정하고, 로컬 인바운드는 연결을 수신하며, 라우팅은 아웃바운드 방향을 정하고, 코어는 프로토콜과 전송을 실행합니다. 문제가 생기면 클라이언트 화면의 연결 아이콘만 보는 것보다 계층별로 확인하는 편이 더 정확합니다.

02 / CORE FAMILY

코어 계열: Xray와 V2Fly의 독립적인 유지 관리

V2Fly 코어는 V2Ray의 모듈형 설계를 이어받아 설정 구조와 여러 기본 개념의 연속성을 유지합니다. Xray 코어는 관련 기술 기반에서 발전하여 프로토콜, 전송, 흐름 제어 방향에서 자체 구현을 유지합니다. 공통 개념도 있지만 직접 호환되지 않는 필드와 기능도 있습니다. VLESS, VMess, Trojan, REALITY, XTLS Vision 같은 이름을 보았다면 공유 링크의 겉모양만으로 호환성을 판단하지 말고 클라이언트 코어와 서버 매개변수를 계속 확인해야 합니다.

이 사이트의 설정 자료는 각 필드가 공통 설정 방식인지, V2Fly 구현인지, Xray 확장인지 명확히 표시합니다. 그래픽 클라이언트를 바로 사용할 때도 편리하고, 필요할 때 생성된 설정 파일과 실행 로그를 직접 읽을 때도 도움이 됩니다.

03 / OPEN SOURCE

오픈 소스 구조: 클라이언트와 코어의 분리된 유지 관리

v2rayN·v2rayNG·v2flyNG와 관련 코어는 각 프로젝트의 오픈 소스 라이선스에 따라 배포되며, 클라이언트 코드·코어 코드·릴리스 일정은 서로 다른 유지 관리자가 담당합니다. 그래픽 클라이언트 업데이트는 인터페이스, 시스템 프록시, 구독 관리, 플랫폼 호환에 집중되는 반면, 코어 업데이트는 프로토콜 구현, 전송 계층, 라우팅, DNS와 관련된 경우가 많습니다. 두 업데이트는 같은 주기로 진행될 필요가 없으므로 클라이언트에 코어 관리 또는 코어 선택 메뉴가 별도로 제공되는 경우가 많습니다.

이러한 계층 구조의 실질적인 장점은 경계가 분명하다는 것입니다. 클라이언트는 사용 경험을 담당하고, 코어는 네트워크 실행을 담당하며, 구독은 설정 데이터를 배포합니다. 문제의 원인을 판단할 때 클라이언트 로그, 코어 시작 결과, 구독 내용을 각각 확인할 수 있어 모든 이상을 하나의 프로그램 탓으로 돌리지 않아도 됩니다.

04 / UPDATE FLOW

업데이트 방식: 변경된 계층부터 확인하기

클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 세 가지 문제를 해결합니다. 클라이언트 업데이트는 플랫폼 호환성, 인터페이스, 설정 생성을 개선하고, 코어 업데이트는 프로토콜 구현과 하위 동작을 조정하며, 구독 업데이트는 노드 목록과 매개변수만 새로 고칩니다. 구독을 업데이트해도 클라이언트 프로그램이 자동으로 교체되지는 않으며, 클라이언트를 업데이트해도 저장된 노드 내용이 반드시 바뀌지는 않습니다. 업데이트 대상을 구분하면 문제 해결 중 불필요한 작업을 피할 수 있습니다.

안정적인 설정은 절제된 순서로 조정해야 합니다. 먼저 현재 작동하는 설정을 보존하고, 한 계층만 업데이트한 뒤 로그를 확인하세요. 노드를 추가하는 것이라면 보통 구독 업데이트만 하면 됩니다. 특정 프로토콜을 인식하지 못한다면 코어 기능과 클라이언트 지원 범위를 확인하고, 시스템 프록시가 적용되지 않는다면 클라이언트 권한과 플랫폼 설정을 중점적으로 살펴보세요.

v2rayN