Project V 생태계의 GUI 클라이언트

V2Ray 커뮤니티

구독 가져오기, 라우팅 규칙, DNS 설정을 중심으로 데스크톱 및 Android 클라이언트 다운로드와 사용 방법을 안내합니다.

설정 한눈에 보기 VMess VLESS Trojan REALITY

데스크톱 및 Android 클라이언트

먼저 기기에 맞는 인터페이스를 고른 다음 설정에 맞는 코어를 선택하세요. 클라이언트는 설정을 관리하고, 코어는 연결을 처리합니다.

데스크톱 추천

v2rayN

데스크톱에서 구독 그룹, 활성 설정, 라우팅 규칙을 한곳에서 관리할 수 있습니다. 시스템 프록시는 운영체제 설정을 따르는 앱에 적합하며, 더 많은 프로그램의 트래픽을 처리하려면 TUN 모드를 알아보세요. 처음에는 기본 설정을 유지하고 단일 연결이 되는지 확인한 뒤 하나씩 조정하는 것이 좋습니다.

v2rayN 다운로드
v2rayN · 프록시 설정 예시
시스템 프록시 자동 설정
라우팅 모드중국 본토 우회 ▾
Android 클라이언트

v2rayNG / v2flyNG

Android에서는 Xray 코어를 사용하는 v2rayNG를 먼저 살펴보세요. 기존 V2Fly 설정이 필요하다면 v2flyNG를 선택할 수 있습니다. 구독 그룹으로 설정을 관리하고, 처음 연결할 때는 시스템 VPN 권한을 허용해야 합니다. 인터페이스가 비슷해도 프로토콜과 설정 항목이 완전히 같지는 않습니다.

Android 다운로드 보기
Android 클라이언트 · 설정 예시
VPN 모드
구독 그룹 설정
주요 설정

구독, 라우팅, 네트워크 트래픽 처리

설정 항목을 계층별로 나눠 이해하면 문제를 해결할 때 관련 없는 옵션을 덜 건드리게 됩니다.

구독 그룹과 업데이트

구독 주소는 원격 설정 목록을 불러오는 주소이지, 바로 연결할 수 있는 서버 주소가 아닙니다. 먼저 그룹을 만들고 메모와 주소를 입력한 뒤 업데이트해야 선택 가능한 설정이 표시됩니다. 그룹은 출처나 용도별로 정리할 때 유용하고, 메모는 로컬에서 구분하는 데만 사용됩니다. 서버 정보를 하나씩 직접 입력하는 것보다 구독을 이용하면 서버 설정을 동기화하기 쉽지만, 업데이트 과정에서 원격으로 관리되는 항목이 덮어써질 수 있습니다. 직접 수정하려면 먼저 별도 설정으로 복사하세요. 구독 주소의 토큰은 접근 자격 정보이므로 스크린샷이나 로그를 공유하기 전에 가려야 합니다. 업데이트에 실패하면 주소 전체가 올바른지, 유효 기간이 지났는지, 접속 경로에 문제가 없는지 확인하세요.

https://example.com/sub?token=xxxx
구독 관리 챕터 읽기 →
클라이언트 다운로드

운영체제에 맞는 설치 파일 선택

전체 클라이언트 보기 →

플랫폼에 따라 설치 파일 형식이 달라지고, 프로세서 아키텍처에 따라 실행 가능 여부가 결정됩니다. 먼저 시스템 정보에서 기기 유형을 확인한 뒤 다운로드 페이지에서 맞는 항목을 선택하세요. 홈페이지는 클라이언트 선택을 안내하며 구체적인 릴리스 정보는 표시하지 않습니다. 설치 요구사항과 클라이언트별 정보는 다운로드 페이지에서 함께 확인할 수 있습니다.

Windows

v2rayN을 선택하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, 기존 사용 방식을 유지하려면 클래식 WPF 버전이 적합합니다. 다운로드 전에 시스템 아키텍처와 실행 요구사항을 확인하세요. 두 인터페이스는 메뉴 위치가 다를 수 있으므로 가이드를 따라갈 때 버튼 위치만 비교하지 말고 기능 이름을 기준으로 조작하세요.

다운로드 Windows 클라이언트 →

macOS

v2rayN을 선택하고 ‘이 Mac에 관하여’에서 Apple Silicon인지 Intel 프로세서인지 확인하세요. 칩 종류에 따라 설치 파일이 다릅니다. 처음 실행할 때 시스템 권한 안내를 확인하세요. 시스템 프록시를 바꾸거나 네트워크 트래픽 처리를 활성화한 뒤에는 기존 네트워크 설정이 다른 도구에 의해 덮어써지지 않았는지도 점검해야 합니다.

다운로드 macOS 클라이언트 →

Android

Xray 코어를 사용하는 v2rayNG를 우선 선택하고, V2Fly 설정과의 호환성이 필요할 때 v2flyNG를 고려하세요. 대부분의 최신 기기는 arm64를 사용하며 아키텍처를 확인하기 어렵다면 범용 버전 안내를 참고하세요. 처음 연결할 때 VPN 권한을 허용해야 합니다. 이미 다른 VPN에 연결되어 있다면 시스템의 연결 제한을 먼저 확인하세요.

다운로드 Android 클라이언트 →

Linux

v2rayN GUI 클라이언트를 선택하고 배포판의 패키지 형식에 맞춰 deb 또는 rpm을 고른 뒤 x64와 arm64 아키텍처를 확인하세요. 데스크톱 환경, 권한 관리, 시스템 프록시 지원 여부에 따라 실제 동작이 달라질 수 있습니다. 클라이언트를 실행했다고 모든 터미널 프로그램이 자동으로 프록시를 사용하는 것은 아니므로 앱별 설정을 따로 확인하세요.

다운로드 Linux 클라이언트 →
첫 설정

구독 가져오기 3단계 미리보기

전체 가이드 보기 →

구독 업데이트 성공, 설정 선택, 앱에서 실제로 프록시 사용은 각각 다른 상태입니다. 이 순서로 진행하면 ‘목록이 표시됨’을 ‘연결이 완료됨’으로 착각하지 않을 수 있습니다. 데스크톱과 Android에서는 메뉴 이름이 조금 다를 수 있지만 기본 과정은 같습니다.

  1. 그룹을 만들고 구독 가져오기

    사용 중인 서비스에서 구독 주소를 받은 뒤 클라이언트의 구독 그룹 설정에 메모와 전체 주소를 입력하세요. 저장한 다음 업데이트를 실행하면 됩니다. 개별 공유 링크를 구독 주소 입력란에 넣지 말고, 불필요한 공백이나 따옴표, 줄바꿈이 함께 복사되지 않도록 주의하세요. 업데이트 후 항목이 예상한 그룹에 들어갔는지 확인하세요. 목록이 비어 있다면 업데이트 알림과 구독 유효성을 확인한 뒤 다시 가져오세요.

  2. 설정을 선택하고 트래픽 처리 방식 정하기

    사용할 서버 설정을 선택하세요. 데스크톱에서는 먼저 시스템 프록시를 사용하고 현재 필요에 맞는 라우팅 프리셋을 고르세요. Android에서는 연결을 시작하고 VPN 권한을 허용해야 합니다. 시스템 프록시는 요청을 클라이언트에 전달할지를 정하고, 라우팅 규칙은 전달된 요청이 어떤 경로로 나갈지를 정합니다. 서로 대체할 수 있는 기능이 아닙니다. 첫 연결에서는 사용자 지정 DNS, TUN, 복잡한 규칙을 한꺼번에 추가하지 않는 편이 문제 해결 기준을 명확히 유지하는 데 도움이 됩니다.

  3. 실제 앱에서 연결 확인

    접속하려는 사이트나 앱을 열어 요청이 실제로 완료되는지 확인하고, 클라이언트 로그로 연결 과정을 살펴보세요. 테스트가 실패해도 반드시 서버 문제인 것은 아닙니다. 앱이 시스템 프록시를 사용하지 않거나 DNS 조회에 문제가 있거나 로컬 포트를 이미 다른 프로그램이 사용 중일 수 있습니다. 오류 발생 시각과 내용을 기록하고 한 번에 설정 하나만 변경하세요. 연결이 확인된 뒤 라우팅 예외를 차례로 추가하고 정상 작동하는 설정을 백업해 두세요.

오픈소스 생태계와 유지 관리

Project V, V2Fly, Xray

프로젝트 배경 알아보기 →

인터페이스에서 연결까지

GUI 클라이언트
와 프록시 코어

데스크톱 인터페이스v2rayN
Android 인터페이스v2rayNG · v2flyNG
코어 계열Xray · V2Fly

메뉴가 비슷해도 설정까지 같은 것은 아닙니다. 프로토콜 지원 여부는 선택한 코어와 해당 릴리스 안내를 기준으로 확인하세요.

생태계 배경: Project V의 모듈형 설계

Project V는 네트워크 프록시를 중심으로 만들어진 오픈소스 기술과 도구 모음이며, V2Ray는 그중 중요한 구성 요소입니다. 인바운드, 아웃바운드, 라우팅, 전송 등의 역할을 분리해 같은 코어 기능을 다양한 환경에 맞게 활용할 수 있습니다. GUI 클라이언트 사용자가 처음부터 전체 설정을 작성할 필요는 없지만 각 계층을 이해하면 여러 현상의 원인을 파악하는 데 도움이 됩니다. 인터페이스에 설정을 저장할 수 있어도 코어가 모든 항목을 받아들이는 것은 아니며, 코어가 시작되어도 대상 앱이 요청을 전달했다는 뜻은 아닙니다.

코어 계열: 비슷한 배경, 다른 확장

V2Fly 커뮤니티는 V2Ray 관련 개발을 이어가고 있으며, Xray는 공통된 기술 배경을 바탕으로 자체 확장 방향을 발전시켰습니다. 두 코어는 일부 프로토콜과 설정을 공유하지만 이름만 바꿔 서로 대체할 수 있는 구성 요소는 아닙니다. VLESS, 전송 보안, REALITY 등의 주제는 해당 코어의 실제 지원 여부에 맞춰 이해해야 합니다. 같은 구독을 두 클라이언트에서 사용했을 때 동작이 다르다면 인터페이스 테마를 바꾸거나 소프트웨어를 재설치하기보다 프로토콜, 전송 방식, TLS, 코어 로그를 먼저 비교하는 편이 문제를 찾는 데 효과적입니다.

오픈소스: 인터페이스와 코어는 별도로 관리

v2rayN, v2rayNG, v2flyNG는 모두 오픈소스 GUI 클라이언트입니다. 클라이언트와 코어의 라이선스는 각각 확인해야 합니다. 오픈소스 라이선스는 코드 사용, 수정, 배포 조건을 정하며, 서로 다른 프로젝트가 같은 출시 일정을 따른다는 의미는 아닙니다. 이 사이트는 세 클라이언트의 자료를 정리하며 클라이언트 이름을 구독 서비스 이름으로 사용하거나 GUI 기능 목록을 모든 코어가 지원하는 기능으로 간주하지 않습니다. 선택할 때는 기기 플랫폼, 설정 호환성, 유지 관리 및 릴리스 기록이 명확한지를 살펴보는 것이 좋습니다.

업데이트 구분: 프로그램, 코어, 규칙 데이터

클라이언트 프로그램, 프록시 코어, 지역 규칙 데이터, 구독 콘텐츠는 각각 업데이트 출처가 다릅니다. 구독 업데이트는 보통 원격에서 제공하는 서버 항목을 새로고침할 뿐 클라이언트를 업그레이드하지 않습니다. 클라이언트를 업그레이드해도 모든 규칙 데이터가 갱신되는 것은 아닙니다. 변경 전에 사용자 지정 라우팅과 독립 설정을 백업하고, 업데이트 후에는 시작 로그와 주요 앱을 확인하세요. 업데이트 직후 문제가 생겼다면 모든 구성 요소를 한꺼번에 갱신하는 대신 무엇을 변경했는지 기록하고 하나씩 되돌리는 편이 원인을 찾기 쉽습니다. 다운로드 페이지에는 설치 경로를 모아 두었으며, 가이드와 고급 사용법에서는 설정 간의 관계를 설명합니다.

기술 노트

연결 문제 해결과 배포 가이드

전체 글 보기 →

첫 연결을 마친 뒤 문제에 맞는 심화 주제를 살펴보세요. 프록시 모드, 서버 시간 초과, 우회 라우터 배포는 서로 다른 계층이므로 같은 문제 해결 절차를 적용하면 안 됩니다. 아래 글에서는 앱 트래픽 처리, 연결 과정, 네트워크 구성 방식을 각각 다룹니다. 고급 사용법의 설정 챕터와 함께 읽어 보세요.

용어가 낯설다면 먼저 용어 빠른 검색을 확인하고, 연결 문제를 재현할 수 있다면 연결 문제 해결 챕터로 바로 이동하세요. 문제 해결 자료를 공유할 때는 오류 유형, 작업 순서, 발생 시각은 남기고 구독 토큰, 계정 정보, 전체 서버 주소는 가리세요.