Windows / macOS / Android / Linux 데스크톱 및 모바일 클라이언트

V2Ray 오픈소스 커뮤니티
v2rayN 다운로드 및 설정

v2rayN 다운로드 가이드 보기

실제 설정 절차에 맞춰 정리한 무료 오픈소스 클라이언트, Xray 및 V2Fly 코어, 구독 가져오기와 라우팅 규칙을 안내하며, 플랫폼 선택부터 연결 확인까지 다시 검토할 수 있는 근거를 제공합니다.

  • Xray 코어
  • V2Fly 생태계
  • REALITY 프로토콜
  • 중문 설정 문서
운영체제에 맞는 다운로드 영역으로 이동
Platform Downloads

플랫폼에 맞는 V2Ray 클라이언트 선택

데스크톱에서는 v2rayN을 기본 클라이언트로 사용하고, Android에서는 코어 요구 사항에 따라 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 각 플랫폼의 버튼을 누르면 다운로드 페이지의 해당 탭이 바로 열립니다.

Windows

크로스 플랫폼 데스크톱 버전 또는 기존 WPF 버전의 v2rayN을 선택할 수 있습니다. 데스크톱 버전은 일관된 인터페이스를 원하는 사용자에게, WPF 버전은 기존 트레이 및 창 조작 방식을 선호하는 환경에 적합합니다.

다운로드로 이동

macOS

v2rayN은 다양한 프로세서 아키텍처에 맞는 데스크톱 설치 패키지를 제공합니다. 다운로드 전에 시스템 정보에서 칩 유형을 확인한 뒤 해당 항목을 선택하면 설치 패키지의 아키텍처 불일치를 줄일 수 있습니다.

다운로드로 이동

Android

v2rayNG은 Xray 코어를 사용해 VLESS, REALITY 등의 설정에 적합합니다. v2flyNG은 V2Fly 코어를 사용하며 Project V의 기본 구현에 가까운 대안 클라이언트로 활용할 수 있습니다.

다운로드로 이동

Linux

v2rayN 데스크톱 버전은 일반적인 deb 및 rpm 패키지 형식과 다양한 프로세서 아키텍처를 지원합니다. 먼저 배포판의 패키지 체계와 기기 아키텍처를 확인한 후 알맞은 파일을 선택하세요.

다운로드로 이동

전체 클라이언트 보기 →

Configuration Flow

구독, 라우팅 및 연결 확인

클라이언트의 정상 작동은 설치 완료만으로 결정되지 않습니다. 구독 내용을 올바르게 해석하는지, 라우팅 규칙이 예상대로 적용되는지, 시스템 프록시가 대상 애플리케이션의 트래픽을 인계하는지 각각 확인해야 합니다.

1구독 가져오기 2라우팅 선택 3연결 확인

업데이트 가능한 구독 그룹부터 만들기

v2rayN에서 구독 그룹 설정을 열고 그룹 이름과 구독 주소를 추가한 뒤 저장하고 현재 그룹을 업데이트하세요. 개별 공유 링크를 하나씩 붙여 넣는 것보다 그룹 방식이 장기 관리에 적합합니다. 서버 측 내용이 바뀌어도 해당 그룹만 업데이트하면 되므로 전체 설정을 다시 정리할 필요가 없습니다. 가져온 뒤에는 항목이 클라이언트에서 인식되는지 확인하고 프로토콜, 주소, 포트, 전송 방식 등의 필드가 표시되는지 점검하세요. 구독 업데이트에 실패했다면 연속으로 버튼을 누르기보다 링크 유효성, 업데이트 방식, 형식 호환성, 로컬 네트워크 상태를 순서대로 확인해야 합니다.

구독 그룹 설정
그룹 이름: 일상 설정
업데이트 방식: 프록시 없이 업데이트
자동 업데이트 간격: 실제 필요에 따라 설정
작업 순서: 주소 추가 → 저장 → 현재 구독 업데이트
Quick Start

v2rayN 3단계 빠른 시작

빠른 절차는 점검 가능한 기본 설정을 구성하기 위한 방법입니다. 처음 사용할 때는 고급 매개변수를 한꺼번에 많이 변경하지 말고, 먼저 구독·라우팅·시스템 프록시를 하나의 흐름으로 구성한 다음 실제 필요에 따라 DNS, Mux 또는 세부 규칙을 조정하세요.

01

설치 후 구독 가져오기

운영체제와 프로세서 아키텍처에 맞는 클라이언트를 다운로드하세요. 설치가 끝나면 구독 그룹 설정을 열고 그룹 이름과 유효한 구독 주소를 입력한 뒤 업데이트합니다. 개별 공유 링크를 사용하는 경우에도 클라이언트가 해당 프로토콜과 전송 조합을 지원하는지 먼저 확인하세요. 가져오기에 성공했다는 것은 설정이 클라이언트에 들어왔다는 뜻일 뿐 연결 매개변수가 유효하다는 의미는 아닙니다. 따라서 프로토콜 유형, 서버 주소, 포트, 전송 계층, 보안 계층과 코어 지원 여부를 추가로 확인해야 합니다.

02

라우팅 및 시스템 프록시 모드 선택

일상적인 사용에는 먼저 규칙 모드를 적용해 사설 네트워크와 geosite, geoip 조건에 맞는 트래픽을 direct로 보내고 나머지는 proxy를 사용하도록 설정할 수 있습니다. 시스템 프록시를 따르는 모든 애플리케이션을 프록시 출구로 보내야 한다면 글로벌 모드로 전환할 수 있지만, 일부 애플리케이션은 시스템 설정을 무시할 수 있다는 점을 이해해야 합니다. v2rayN의 ‘시스템 프록시 자동 설정’은 시스템 프록시 매개변수를 기록하며, 로컬 수신 포트는 클라이언트의 인바운드 설정이 결정하므로 두 설정이 서로 맞아야 합니다.

03

연결 후 로그 확인

설정을 하나 선택해 클라이언트를 시작한 뒤 먼저 코어가 정상적으로 실행되는지 확인하고 시스템 프록시 상태를 점검하세요. 연결에 문제가 생기면 warning 또는 error 메시지에서 도메인 확인, 프로토콜 필드, 인증서 시간, 전송 경로와 포트 점유 등의 원인을 찾습니다. 여러 매개변수를 한 번에 바꾸면 어떤 변경이 영향을 주었는지 판단하기 어렵습니다. 한 번에 하나의 변수만 조정하고 다시 연결한 뒤 결과를 기록하는 방식이 안전하며, 문제가 재현되는 조건이나 해결 여부를 명확히 확인할 때까지 반복하세요.

전체 가이드에서는 Windows, macOS, Android, Linux의 설치 차이와 함께 구독 업데이트, 라우팅 선택, LAN 연결 및 자주 발생하는 문제를 연속된 작업 단계로 설명합니다.

전체 가이드 보기 →
Open Source Ecosystem

Project V, V2Fly 및 Xray 코어의 관계

클라이언트, 코어, 프로토콜은 서로 다른 계층에 속합니다. 각 계층의 역할을 이해하면 설정 호환성을 판단하는 데 도움이 되며, 그래픽 인터페이스의 옵션을 하위 프로토콜 구현과 혼동하는 일도 줄일 수 있습니다.

Project V에서 여러 코어 계열로

Project V는 V2Ray 설정 모델을 바탕으로 네트워크 도구 생태계를 형성했습니다. 인바운드, 아웃바운드, 라우팅, DNS, 정책과 전송 설정을 비교적 독립적인 모듈로 나누고 규칙으로 연결하는 것이 핵심입니다. VMess는 초기 대표 프로토콜이며, 이후 생태계는 VLESS, Trojan, Shadowsocks 호환 구현과 다양한 전송 방식으로 확장되었습니다. 설정 파일의 inbounds, outbounds, routing 같은 구조는 오늘날에도 관련 코어의 작동 방식을 이해하는 중요한 출발점입니다.

V2Fly는 Project V의 커뮤니티 유지보수 방향을 이어 왔으며, V2Ray Core는 흔히 v2fly 코어라고 부릅니다. 모듈식 설정 방식을 유지하면서 프로토콜 지원, 전송 구성 요소, 라우팅 리소스와 크로스 플랫폼 실행을 계속 발전시켜 왔습니다. v2flyNG은 이 코어 계열을 사용하므로 V2Fly 구현 경로가 필요한 Android 사용자에게 적합합니다. V2Fly를 선택한다고 해서 VMess만 사용할 수 있는 것은 아니며, 실제 지원 프로토콜은 클라이언트에 포함된 코어와 설정 필드 지원 범위를 기준으로 판단해야 합니다.

Xray는 유사한 설정 체계에서 발전했으며 VLESS, XTLS, REALITY 등의 방향에 더욱 집중된 구현을 제공합니다. v2rayN과 v2rayNG은 일반적으로 Xray 코어를 사용하므로 동일한 구독을 두 클라이언트에서 사용할 때 필드 해석 방식이 비슷한 경우가 많습니다. 그러나 데스크톱과 모바일은 시스템 프록시, VPN 인계 방식, DNS 동작과 백그라운드 실행 구조가 다르므로 코어가 같다는 이유만으로 모든 설정이 완전히 호환된다고 볼 수는 없습니다.

코어는 설정을 해석하고 연결을 만들며 라우팅과 데이터 전송을 처리합니다. 그래픽 클라이언트는 구독 관리, 매개변수 편집, 시스템 프록시 전환, 로그 확인과 코어 프로세스 관리를 담당합니다. 문제가 발생하면 먼저 장애가 인터페이스 계층인지 코어 계층인지 판단해야 합니다. 예를 들어 구독 버튼이 내용을 해석하지 못하면 구독 형식이나 클라이언트 파싱 과정의 문제일 가능성이 높고, 코어 시작 후 필드가 유효하지 않다고 나오면 설정 구조나 코어 호환성 문제에 가깝습니다. 일부 애플리케이션만 작동하지 않는다면 시스템 프록시 또는 애플리케이션 자체 설정을 확인해야 합니다.

데스크톱 클라이언트

v2rayN

v2rayN은 Windows, macOS, Linux용 그래픽 클라이언트로 구독 그룹, 서버 설정, 라우팅 규칙, DNS, 시스템 프록시와 Xray 등의 코어를 관리합니다. 크로스 플랫폼 데스크톱 버전과 Windows WPF 버전은 인터페이스 기술과 트레이 동작에 차이가 있지만, 설정 가져오기, 서버 선택, 프록시 모드 설정, 로그 확인을 중심으로 하는 기본 흐름은 같습니다.

Android · Xray

v2rayNG

v2rayNG은 Xray 코어 기능을 Android 클라이언트에 통합해 일반적인 공유 링크와 구독 내용을 가져올 수 있으며, 시스템에서 제공하는 VPN 인터페이스로 애플리케이션 트래픽을 인계합니다. VLESS, REALITY, VMess, Trojan 또는 Shadowsocks 설정이 필요한 모바일 기기에 적합하며, 라우팅, 앱별 프록시와 DNS 동작은 시스템 제약을 고려해 설정해야 합니다.

Android · V2Fly

v2flyNG

v2flyNG은 V2Fly 코어를 사용하는 Android용 오픈소스 클라이언트입니다. v2rayNG과 인터페이스 방식은 비슷하지만 하위 코어 계열이 다릅니다. 구독이 Xray 고유 필드에 의존한다면 먼저 호환성을 확인하고, V2Fly 지원 범위에 기반한 설정이라면 동일한 가져오기, 연결, 로그 확인 절차로 구성할 수 있습니다.

오픈소스 프로토콜 및 업데이트 방식

관련 프로젝트는 공개 소스 코드와 오픈소스 라이선스를 바탕으로 협업하며, 클라이언트와 코어는 대체로 독립적인 출시 주기를 따릅니다. 클라이언트 업데이트는 인터페이스, 구독 파싱, 시스템 통합과 호환성에 집중될 수 있고, 코어 업데이트는 프로토콜 구현, 라우팅 리소스, 전송 구성 요소, 보안 수정과 설정 필드를 다룰 수 있습니다. 두 업데이트가 항상 동시에 출시되는 것은 아니므로 새 프로토콜이나 필드를 점검할 때는 클라이언트가 설정을 전달할 수 있는지와 코어가 해당 기능을 구현했는지를 함께 확인해야 합니다.

구독 서비스가 제공하는 설정에도 별도의 변경 주기가 있습니다. 클라이언트를 업데이트해도 만료된 구독이 자동으로 수정되지는 않으며, 구독을 업데이트해도 로컬 프로그램의 기능이 바뀌지는 않습니다. 보다 명확하게 관리하려면 클라이언트 업데이트, 코어 변경, 구독 조정을 각각 기록하고 문제가 발생했을 때 가장 최근에 바뀐 계층부터 확인하세요. 이렇게 하면 무작정 재설치하거나 설정을 반복해서 덮어쓰는 일을 줄이고 되돌릴 수 있는 판단 경로를 남길 수 있습니다.

  • 클라이언트 인터페이스
  • 코어 프로세스
  • 구독 파싱
  • 라우팅 리소스
  • 시스템 프록시
Technical Notes

V2Ray 설정 및 프로토콜 문서

프로토콜 원리, 구독 문제와 플랫폼 권한을 중심으로 실행 가능한 점검 방법을 정리합니다. 각 매개변수의 관계를 먼저 설명한 뒤 실제 작업에 적합한 처리 순서를 제시합니다.

프로토콜 해설

REALITY와 XTLS Vision이 빠른 이유: 핸드셰이크 재사용과 흐름 제어 원리

TLS 핸드셰이크 비용부터 시작해 REALITY의 핸드셰이크 방식과 XTLS Vision이 중복 처리를 줄이는 원리, 그리고 Xray 코어에서 두 기능이 함께 작동하기 위한 조건을 설명합니다. 프로토콜, 보안 계층과 흐름 제어 매개변수도 구분해 이름만으로 성능을 판단하지 않도록 안내합니다.

전체 글 읽기 →
문제 해결

V2Ray 구독 업데이트 실패 원인과 해결: 링크·파싱·형식 점검 목록

링크 유효성, 업데이트 방식, Base64 내용, 공유 링크 형식과 클라이언트 지원 범위에 따른 점검 순서를 정리합니다. 업데이트 버튼을 반복해서 눌러도 형식이나 호환성 문제는 해결되지 않는 이유와 네트워크 실패 및 파싱 실패를 구분하는 방법을 설명합니다.

전체 글 읽기 →
플랫폼별 안내

v2rayN macOS 설치가 차단될 때: 확인되지 않은 개발자 및 네트워크 권한 처리

개인정보 보호 및 보안 패널에서 앱을 허용하는 절차와 격리 속성 처리 방법, 시스템 프록시가 적용되지 않을 때의 점검 방법을 설명합니다. 프로그램 실행 권한과 네트워크 프록시 권한을 구분해 어느 시스템 계층에서 경고가 발생했는지 쉽게 파악할 수 있습니다.

전체 글 읽기 →

전체 문서 보기 →

v2rayN 다운로드