Project V 생태계 클라이언트

V2Ray 셀렉트클라이언트 및 프로토콜 가이드

v2rayN 다운로드 사용 가이드 보기

오픈 소스 클라이언트 다운로드 경로를 모아 소개합니다. 프로토콜 호환성과 코어 기능에 맞는 설정을 고르고, 구독 가져오기와 라우팅 안내도 확인하세요.

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
  • REALITY
코어 계열
XrayV2Fly
오픈 소스 라이선스 · 코어
Xray-core
MPL-2.0
v2ray-core
MIT
그래픽 설정 관리

구독 가져오기/라우팅/코어 호환

기능별 계층을 보여 주는 그림이며, 모든 조합이 서로 호환된다는 뜻은 아닙니다. REALITY는 연결 보안 기술로, 이를 지원하는 프로토콜·전송 방식·코어와 함께 사용해야 합니다.

클라이언트 다운로드먼저 실행 플랫폼을 선택하세요

데스크톱에서는 v2rayN, 안드로이드에서는 주로 v2rayNG를 선택합니다. V2Fly 코어가 필요한 설정에는 v2flyNG를 사용할 수 있습니다. 설치 패키지의 아키텍처, 코어 지원 여부, 실행 권한은 각각 따로 확인해야 합니다.

Windows

v2rayN · Desktop / WPF

데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, 클래식 WPF 버전은 Windows 환경에 익숙한 인터페이스를 유지합니다. 처음 사용할 때는 운영체제와 프로세서 아키텍처를 확인하세요. 기존 설정을 옮기기 전에는 구독 그룹, 라우팅 모드, 로컬 수신 설정을 기록해 두는 것이 좋습니다. 두 인터페이스는 메뉴 위치가 다를 수 있으므로 스크린샷만으로 기능의 유무를 판단하지 마세요.

다운로드 페이지로
macOS

v2rayN · Apple Silicon / Intel

‘이 Mac에 관하여’에서 칩 정보를 확인해 설치 패키지를 선택하세요. 기기의 외관이나 모델명만으로 판단하지 않는 것이 좋습니다. 설치 후 먼저 일반 시스템 프록시를 설정하고, 필요할 때 TUN을 활성화하세요. 두 방식은 필요한 권한이 다릅니다. 시스템에서 권한 변경을 요청하면 현재 클라이언트가 요청한 작업인지 확인하고, 해당 권한이 어떤 네트워크 트래픽을 처리하는 데 쓰이는지 파악하세요.

다운로드 페이지로
Android

v2rayNG / v2flyNG

v2rayNG는 Xray 코어를 사용하며, v2flyNG는 V2Fly 코어를 선택할 때 사용할 수 있습니다. 최근 출시된 기기는 대체로 arm64를 선택하면 됩니다. 아키텍처를 모를 때는 기기 정보를 확인하거나 범용 패키지를 선택하세요. 연결을 시작하려면 시스템 VPN 권한이 필요합니다. 백그라운드 절전 제한으로 연결이 끊길 수도 있으므로 시스템 배터리 설정도 확인하세요.

다운로드 페이지로
Linux

v2rayN · deb / rpm

배포판의 패키지 형식에 따라 deb 또는 rpm을 선택한 다음 x64와 arm64를 구분하세요. 데스크톱 환경의 시스템 프록시 설정을 모든 프로그램이 사용하는 것은 아니며, 명령줄 도구는 별도로 설정해야 할 수도 있습니다. TUN을 사용할 계획이라면 권한, 라우팅, DNS 처리 방식을 먼저 확인하고 복구할 수 있도록 기존 네트워크 설정을 보관하세요.

다운로드 페이지로

전체 클라이언트 보기 →

클라이언트 설정필요한 기능을 확인하세요

아래 그림은 기능을 설명하기 위한 정적 예시이며 특정 버전의 인터페이스를 나타내지 않습니다. 클라이언트는 설정을 관리하고 코어는 연결을 처리합니다. 인터페이스에 옵션이 표시되어도 현재 코어가 모든 매개변수 조합을 지원한다는 뜻은 아닙니다.

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

VMess, VLESS, Trojan, Shadowsocks는 서로 다른 프록시 설정에 사용되며, 유형 이름만 바꾼다고 서로 전환되는 것은 아닙니다. 설정을 가져온 뒤 서버 주소, 포트, 인증 정보, 전송 방식, 보안 계층을 확인하고 클라이언트와 서버 설정이 서로 맞는지 살펴보세요. REALITY는 주소만 입력하면 사용할 수 있는 독립 프록시 프로토콜이 아닙니다. 이를 지원하는 코어와 해당 매개변수가 필요합니다. 하나의 연결 유형만 제공하는 도구와 달리 이 클라이언트는 여러 설정을 한 화면에서 관리할 수 있지만, 실제 호환 범위는 코어에 따라 달라집니다.

프로토콜 및 코어 가이드 보기 →
프로토콜 유형VLESS ▾
전송 방식TCP ▾
보안 계층REALITY ▾
서버 매개변수제공된 설정에 맞춰 입력

빠른 시작가져오기·연결·확인

클라이언트를 설치하는 것만으로는 준비가 끝나지 않습니다. 사용할 연결 설정이나 구독 주소가 별도로 필요합니다. 클라이언트는 이 매개변수를 읽고 사용하며, 서버를 자동으로 제공하지 않습니다. 처음 설정할 때는 아래 순서대로 진행하고 각 단계의 결과를 확인한 뒤 다음 단계로 넘어가세요. 가져오기 실패, 트래픽 미유입, 서버 연결 실패를 구분해 문제를 찾기 쉽습니다.

  1. 구독을 가져오고 사용할 설정 확인하기

    v2rayN에서는 구독 그룹 설정을 찾아 이름과 전체 주소를 추가하고 저장한 뒤 업데이트하세요. v2rayNG에서는 구독 그룹 설정에서 추가를 마친 후 설정 목록으로 돌아가 구독을 업데이트합니다. 프로토콜 이름으로 시작하는 단일 공유 링크를 받았다면 클립보드 가져오기나 QR 코드 스캔을 사용하세요. 구독 주소로 추가하면 안 됩니다. 메뉴 이름은 인터페이스 업데이트에 따라 달라질 수 있으므로, 작업 대상이 구독 그룹인지 단일 설정인지 확인하세요.

    업데이트 후 목록에 실제 항목이 표시되는지 확인하고 사용할 설정을 선택하세요. 프로토콜 유형, 전송 방식, 보안 계층이 제공받은 정보와 일치하는지도 살펴보세요. 안내 메시지를 없애려고 인증 필드를 임의로 바꾸지 마세요. 구독을 가져오는 데 성공해도 개별 연결은 사용할 수 없을 수 있습니다. 반대로 구독 업데이트가 실패했다고 해서 저장된 모든 설정이 즉시 무효가 되는 것도 아닙니다. 두 상태를 따로 확인하세요.

  2. 트래픽 유입 방식과 라우팅 설정하기

    데스크톱에서는 용도에 맞는 라우팅 모드를 선택한 뒤 시스템 프록시를 켜서 시스템 설정을 따르는 앱을 연결하세요. 안드로이드에서 연결을 시작할 때는 시스템 VPN 권한 요청을 확인하고 승인해야 합니다. 특정 앱의 로그가 전혀 보이지 않는다면 서버 매개변수를 바로 수정하지 말고, 먼저 해당 앱이 시스템 프록시를 따르는지와 앱 범위에서 제외되었는지를 확인하세요. 트래픽 유입과 연결 매개변수는 서로 다른 역할을 하므로 한꺼번에 조정하면 문제를 찾기 어려워집니다.

    TUN이 필요하다면 관리자 권한, 가상 인터페이스, DNS, 다른 네트워크 소프트웨어와의 호환성을 확인하세요. 처음 테스트할 때는 트래픽을 처리하는 클라이언트 하나만 실행해 여러 도구가 시스템 프록시나 라우팅 설정을 동시에 바꾸지 않도록 하세요. 규칙 모드에서 직접 연결은 의도적으로 선택한 경로이며 클라이언트가 중지됐다는 뜻이 아닙니다. 특정 사이트가 어느 경로로 연결되는지는 규칙과 로그를 함께 살펴보세요. 스위치 상태만으로 판단할 수 없습니다.

  3. 요청을 확인한 뒤 설정을 단계적으로 조정하세요

    시작 후 코어가 정상적으로 실행되는지 확인하고 테스트할 앱을 열어 연결 로그가 생성되는지 살펴보세요. 요청은 보이지만 연결에 실패한다면 도메인 조회, 서버 포트, 인증 및 보안 계층 매개변수를 확인하세요. 요청이 전혀 없다면 트래픽 유입 설정을 다시 확인해야 합니다. 연결 테스트와 실제 웹페이지 접속은 대상과 절차가 다를 수 있습니다. 한 가지 테스트에 성공해도 모든 앱이 연결됐다고 볼 수 없고, 실패했을 때도 구체적인 로그를 바탕으로 판단해야 합니다.

    기본 접속이 정상인지 확인한 뒤 라우팅 규칙, 구독 업데이트 방식, 앱 범위를 하나씩 조정하고 기존 값을 기록해 두세요. 도움을 요청할 때는 클라이언트 이름, 사용 중인 코어, 프로토콜 유형, 오류가 발생한 단계, 확인한 내용을 정리하고 구독 주소와 인증 정보는 숨기세요. 클라이언트를 종료한 뒤 시스템 프록시가 원래대로 복구됐는지도 확인해야 합니다. 특히 비정상 종료 후 프록시 설정이 남으면 일반 네트워크 접속에 영향을 줄 수 있습니다.

전체 사용 가이드 보기 →

Project V 생태계클라이언트와 코어의 역할

V2Ray는 생태계와 기술적 배경을 설명할 때 자주 쓰이는 이름입니다. 실제 사용 시에는 클라이언트, 코어, 설정의 세 계층을 구분해야 합니다. 각 구성 요소의 역할을 이해하면 특정 인터페이스의 버튼 위치를 외우는 것보다 설정을 옮기거나 문제를 찾는 데 도움이 됩니다.

PROJECT V

공통 기반과 커뮤니티의 발전

Project V는 프록시 연결, 전송, 라우팅에 활용할 수 있는 여러 기술 구현을 제공합니다. V2Ray는 그중 널리 사용되는 핵심 프로젝트입니다. 커뮤니티가 발전하면서 V2Fly는 V2Ray 코어의 유지보수를 이어받았고, Xray는 공통 코드 기반에서 독립적으로 발전하는 분기 프로젝트가 되었습니다. 일부 개념은 비슷하지만 기능과 설정 방식은 점차 달라졌습니다. 프로젝트 이름이 같은 프로그램의 서로 다른 테마를 뜻한다고 이해해서는 안 됩니다.

그래픽 클라이언트는 코어와 별도로 설정 편집, 공유 링크 가져오기, 구독 그룹 관리, 실행 제어 기능을 제공합니다. 사용자가 보는 설정 화면은 대개 클라이언트 인터페이스이며, 실제 연결과 라우팅은 하위 코어가 처리합니다. 따라서 여러 클라이언트에서 같은 구독이 비슷하게 표시되더라도 최종적으로 생성되는 코어 설정까지 동일한 것은 아닙니다. 가져오기 기능이 특정 필드를 인식하는지도 호환성의 일부입니다.

XRAY / V2FLY

기능 분기와 설정 호환성

Xray와 V2Fly 모두 여러 프록시 설정을 처리할 수 있지만, 구체적인 지원 범위는 각 프로젝트의 릴리스에 따라 달라집니다. 코어를 선택할 때는 이름만 보고 속도를 추측하지 말고 서버에서 제공한 프로토콜, 전송 방식, 보안 계층, 필수 확장 기능을 먼저 확인하세요. REALITY 같은 기능을 사용할 때는 구현과 매개변수 요구 사항을 확인해야 합니다. 다른 코어의 설정 파일 전체를 그대로 복사해도 모든 필드가 똑같이 해석되는 것은 아닙니다.

프로토콜 이름은 성능 순위를 뜻하지 않습니다. 같은 프로토콜도 네트워크 경로, 전송 방식의 조합, 기기 부하, 서버 환경에 따라 성능이 달라질 수 있습니다. 모바일 기기의 배터리 사용량은 연결 유지, 백그라운드 제한, 트래픽 유입 방식에도 영향을 받습니다. 먼저 호환성을 확보한 뒤 같은 기기와 실제 사용 환경에서 비교하는 편이 좋습니다. 체계적으로 선택하려면 프로토콜 가이드에서 설정 요구 사항을 하나씩 확인하며 범위를 좁혀 보세요.

OPEN SOURCE

세 클라이언트의 오픈 소스 정보

v2rayN, v2rayNG, v2flyNG는 모두 클라이언트 코드가 오픈 소스로 공개된 프로젝트입니다. v2rayN은 데스크톱용으로 설정·구독·라우팅 관리에 중점을 둡니다. v2rayNG는 안드로이드용이며 주로 Xray 코어에 맞춰져 있습니다. v2flyNG도 안드로이드용으로 V2Fly 코어를 선택할 수 있습니다. 세 클라이언트는 같은 인터페이스의 이름만 바꾼 것이 아니므로 설정 메뉴, 가져오기 방식, 플랫폼 권한을 서로 그대로 적용할 수 없습니다.

오픈 소스 라이선스는 코드의 사용·수정·재배포 조건을 정하며, 모든 네트워크 환경에서 동일한 결과를 보장하지는 않습니다. 코어의 경우 Xray-core는 MPL-2.0, V2Fly가 유지보수하는 v2ray-core는 MIT 라이선스를 사용합니다. 클라이언트와 종속 구성 요소의 라이선스도 각각 확인해야 합니다. 오픈 소스 정보를 살펴볼 때는 다운로드 패키지 전체를 하나의 라이선스로 묶기보다 클라이언트, 코어, 포함된 종속 구성 요소의 라이선스를 구분하는 편이 정확합니다.

MAINTENANCE

업데이트 대상과 이전 순서

클라이언트, 코어, 구독, 규칙 데이터 업데이트는 각각 다른 문제를 해결합니다. 클라이언트 업데이트는 인터페이스와 설정 생성 방식을 바꿀 수 있습니다. 코어 업데이트는 연결 기능과 필드 해석에 영향을 줍니다. 구독 업데이트는 원격 설정을 가져오며, geosite·geoip 데이터 업데이트는 규칙이 적용되는 범위를 바꿉니다. 구독만 업데이트한다고 모든 소프트웨어 구성 요소가 자동으로 업그레이드되는 것은 아닙니다. 반대로 클라이언트를 업데이트해도 원격 연결 매개변수가 새로 고쳐지는 것은 아닙니다.

기존 설정이 정상적으로 작동한다면 업그레이드 전에 사용 중인 연결, 구독 그룹, 라우팅, DNS 설정을 기록하고 설정 변경 사항을 확인하세요. 업데이트 후에는 기본 연결을 먼저 확인한 다음 라우팅과 특정 앱을 테스트하세요. 코어를 바꾸고 규칙을 수정하면서 새로운 트래픽 유입 방식까지 동시에 활성화하지 않는 것이 좋습니다. 낯선 용어는 개념 빠른 참조에서 확인할 수 있습니다. 가져오기나 연결 오류가 발생하면 FAQ에서 오류가 발생한 단계에 따라 살펴보세요. 모든 문제를 프로토콜 탓으로 돌리면 안 됩니다.

기술 노트생태계·링크·라우팅

구체적인 문제를 바탕으로 설정의 배경을 살펴보세요. 먼저 소프트웨어 간 관계를 구분한 뒤 가져오기 형식과 규칙 적용 방식을 이해하면 됩니다. 아래 세 글은 최신 글부터 날짜순으로 정렬되어 있으니 현재 상황에 맞춰 읽어 보세요.

고급 설정

V2Ray 라우팅 규칙 실전: geosite·geoip 분할 라우팅 설정 방법

domain, ip, geosite, geoip 규칙의 적용 순서를 설명하고, 중국 본토 트래픽은 직접 연결하고 그 외 지역 트래픽은 프록시로 보내는 일반적인 라우팅 설정과 규칙 충돌을 확인하는 방법을 소개합니다. 규칙을 길게 늘리는 것보다 요청이 어떤 경로에 매칭되는지 확인하는 데 중점을 둡니다.

노트 읽기 →

전체 글 보기 →