CLIENT / ROUTING / DNS

V2Ray 클라이언트
다운로드 및 설정 안내

v2rayN 다운로드 가이드 보기

v2rayN·v2rayNG·v2flyNG 설치 경로를 한곳에 모아 구독 가져오기, 라우팅 및 DNS 설정을 다루고, 데스크톱과 Android 클라이언트별 사용 방법을 안내합니다.

영구 무료 오픈 소스 한국어 문서 Xray · V2Fly
미국 일본 홍콩 싱가포르 한국

CLIENT OPERATIONS

구독, 서버 및 로컬 트래픽 처리

클라이언트 설정은 링크 하나를 입력하는 것으로 끝나지 않습니다. 구독 업데이트, 서버 필터링, 라우팅 매칭, DNS 아웃바운드와 TUN 연결이 함께 연결 결과를 결정합니다.

MODULE / 01

구독 가져오기와 서버 정리

구독 주소는 서버 설정을 한꺼번에 가져오는 데 사용합니다. 가져온 뒤 먼저 업데이트를 실행하고, 프로토콜·지역·사용자 메모 기준으로 서버를 정리하면 긴 목록에서 반복해서 찾는 일을 줄일 수 있습니다. v2rayN은 구독 그룹과 필터 조건을 지원하며, v2rayNG는 모바일에서 자주 쓰는 소수의 그룹을 관리하기에 적합합니다. 업데이트에 실패하면 링크 만료, 프록시를 통한 업데이트 필요, 호환되지 않는 응답 형식, 클라이언트 권한 문제를 구분해 확인하세요. 기존 설정을 바로 삭제하지 마세요. 업데이트가 끝난 뒤 서버를 선택해 활성 항목으로 지정해야 하며, 구독이 존재한다고 해서 서버가 바로 사용 중인 것은 아닙니다.

구독 가져오기 단계 보기 →

PLATFORM DOWNLOADS

네 가지 플랫폼별 클라이언트 안내

데스크톱에서는 v2rayN을 주로 사용하고, Android에서는 코어 요구 사항에 따라 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 설치 패키지 유형, CPU 아키텍처와 시스템 요구 사항은 다운로드 페이지에 그룹별로 정리되어 있습니다.

DESKTOP / WPF

Windows

Windows 사용자는 v2rayN의 최신 데스크톱 인터페이스와 클래식 WPF 인터페이스 중에서 선택할 수 있습니다. 두 버전 모두 구독 관리, 시스템 프록시, 라우팅 규칙과 코어 제어를 지원합니다. 새로 설치한다면 데스크톱 버전부터 시작하고, 안정적인 기존 설정이 있다면 익숙한 WPF 경로를 계속 사용해도 됩니다.

다운로드하기

DESKTOP / DMG

macOS

macOS에서는 v2rayN 데스크톱 클라이언트를 사용하며, 다운로드할 때 기기 프로세서에 맞는 Apple Silicon 또는 Intel 설치 패키지를 선택해야 합니다. 설치 후 구독을 가져오고 시스템 프록시를 전환하거나 라우팅을 편집할 수 있습니다. 처음 실행이 차단되면 시스템 보안 설정에서 애플리케이션 권한을 확인하세요.

다운로드하기

MOBILE / APK

Android

Android에서는 일반적으로 v2rayNG를 우선 선택하며, Xray 코어로 주요 프로토콜과 라우팅 설정을 처리합니다. V2Fly 코어가 필요하다면 v2flyNG를 선택하세요. 최신 기기는 대부분 arm64 패키지를 사용하며, 프로세서 아키텍처를 모를 때만 범용 패키지를 선택해 기기와 맞지 않는 파일을 피하는 것이 좋습니다.

다운로드하기

DESKTOP / DEB · RPM

Linux

Linux 데스크톱에서는 v2rayN을 사용할 수 있습니다. 배포판의 패키지 체계에 따라 deb 또는 rpm을 선택한 다음 x64·arm64 아키텍처로 구분하세요. 설치 후 데스크톱 환경, 시스템 프록시 적용 방식과 TUN 권한을 확인해야 합니다. 서버 환경에서는 데스크톱 조작을 그대로 따라 하기보다 설정과 서비스 관리 방식을 먼저 이해하는 것이 좋습니다.

다운로드하기
전체 클라이언트 및 설치 패키지 안내 보기 →

QUICK START

구독에서 연결까지 세 단계

처음 설정할 때는 가장 짧은 작업 흐름을 먼저 완료한 다음 라우팅, DNS와 TUN을 설정하세요. 기본 연결이 성립하는지 확인할 수 있어 여러 설정을 동시에 바꾼 뒤 원인을 찾기 어려워지는 일을 막을 수 있습니다.

전체 가이드 보기 →
  1. STEP 01

    구독을 가져오고 업데이트 실행

    전체 구독 주소를 복사해 클라이언트의 구독 그룹에 새 항목으로 추가한 뒤 수동으로 한 번 업데이트하세요. 업데이트가 끝나면 서버 목록이 표시되는지, 메모가 읽기 쉬운지, 프로토콜 필드가 올바르게 인식되었는지 확인합니다. 목록이 비어 있다면 시스템 프록시를 계속 조정하기보다 먼저 구독 응답 문제를 해결해야 합니다.

  2. STEP 02

    서버와 프록시 모드 선택

    서버 목록에서 설정 하나를 선택해 활성 항목으로 지정한 다음 용도에 따라 시스템 프록시 또는 TUN 모드를 선택하세요. 처음 연결할 때는 라우팅 규칙을 단순하게 유지하고 브라우저와 주요 애플리케이션을 먼저 확인합니다. 기본 연결이 확인되면 규칙 모드를 전환하고 사용자 지정 직접 연결 또는 프록시 조건을 추가하세요.

  3. STEP 03

    연결 후 로그와 출구 확인

    연결을 시작한 뒤 클라이언트 상태와 코어 로그를 확인해 로컬 수신 포트가 열렸는지 점검하세요. 이후 도메인 접속과 프록시가 필요한 애플리케이션을 각각 테스트합니다. 연결 버튼은 켜졌지만 애플리케이션에 접속되지 않는다면 애플리케이션이 시스템 프록시를 읽는지, DNS가 예상한 아웃바운드로 나가는지, 규칙이 대상 트래픽을 올바른 출구로 보내는지 확인하세요.

PROJECT V / CORE FAMILY

Project V·V2Fly·Xray의 관계

클라이언트는 GUI와 시스템 통합을 담당하고, 코어는 프로토콜·전송·라우팅·아웃바운드 처리를 담당합니다. 이 역할을 이해해야 클라이언트 업데이트 안내와 설정 호환 범위를 올바르게 파악할 수 있습니다.

프로토콜 도구에서 클라이언트 생태계로

Project V는 프록시 프로토콜, 전송 계층, 라우팅과 네트워크 도구를 중심으로 형성된 오픈 소스 기술 생태계입니다. 특정 GUI 클라이언트 하나와 같은 의미는 아닙니다. 데스크톱이나 모바일 클라이언트는 구독 관리, 연결 버튼, 시스템 프록시, 로그 확인과 설정 편집을 제공하고, 실제 네트워크 처리는 클라이언트가 호출하는 코어가 수행합니다. 화면에 표시되는 서버, 라우팅 규칙과 DNS 옵션은 최종적으로 코어가 읽을 수 있는 설정으로 정리됩니다.

V2Fly는 V2Ray 계열의 핵심 기능을 이어받아 개방적인 프로토콜 조합, 전송 설정과 라우팅 메커니즘을 강조합니다. Xray는 같은 기술 계열에서 독립 코어로 발전했으며 VLESS, XTLS, REALITY 등에서 고유한 구현 방향을 갖습니다. 두 코어는 기본 설정 개념을 상당 부분 공유하지만 지원 기능, 필드 세부 사항과 업데이트 주기는 완전히 같지 않으므로 설정 파일의 겉모양만으로 호환성을 판단할 수 없습니다.

v2rayN은 여러 코어와 구독 그룹을 관리하는 데스크톱 GUI 클라이언트입니다. v2rayNG는 주로 Android에서 Xray 코어와 함께 사용하며, v2flyNG는 V2Fly 코어를 대상으로 합니다. 세 클라이언트 모두 오픈 소스로 유지되며 GUI 프로젝트와 코어 프로젝트는 별도로 업데이트를 배포합니다. 프로토콜을 인식하지 못하거나 새 필드를 저장할 수 없다면 클라이언트 지원 범위와 선택한 코어의 기능을 함께 확인하세요.

A

오픈 소스 라이선스와 코드 검토

v2rayN·v2rayNG·v2flyNG와 주요 코어에는 명확한 오픈 소스 라이선스가 적용됩니다. 오픈 소스 라이선스는 코드의 사용·수정·재배포 조건을 정하고, 소스 코드·커밋 기록·릴리스 안내를 통해 기능 변화를 기술 커뮤니티가 검토할 수 있게 합니다. 이 사이트는 클라이언트의 실제 기능과 공개 문서를 기준으로 설명하며, 다운로드 수·평점·검증할 수 없는 테스트 수치로 기술 설명을 대신하지 않습니다.

B

클라이언트와 코어는 별도로 업데이트

클라이언트 업데이트는 일반적으로 인터페이스, 구독 관리, 시스템 프록시 적용과 설정 생성을 다룹니다. 코어 업데이트는 프로토콜 기능을 추가하거나 설정 필드를 조정하고 네트워크 처리 문제를 수정할 수 있습니다. 두 업데이트 주기는 서로 다릅니다. 연결 이상을 진단할 때는 클라이언트 이름, 현재 코어 계열, 사용 모드와 로그 오류를 기록해야 하며 연결 버튼이 켜졌는지만 설명해서는 부족합니다.

C

설정 호환성은 항목별 확인 필요

VMess·VLESS·Trojan·WebSocket·gRPC·TLS·REALITY는 각각 프로토콜, 전송과 보안 계층에 속하는 용어로 서로 대체할 수 없습니다. 구독 변환이나 클라이언트 간 마이그레이션을 진행할 때는 대상 클라이언트가 모든 필드를 인식하는지 확인해야 합니다. 변환 과정에서 흐름 제어, 전송 매개변수나 서버 이름이 사라지면 원래 클라이언트와 연결 결과가 달라질 수 있습니다.

COMMON QUESTIONS

자주 발생하는 설정 문제

다음 내용은 첫 가져오기, 클라이언트 선택, 업데이트 실패, 연결 후 트래픽 없음이라는 네 가지 주요 상황을 다룹니다. 전체 작업 절차는 사용 가이드와 고급 매뉴얼에서 확인할 수 있습니다.

Q / 01

구독을 가져온 뒤 서버가 표시되지 않는 이유는 무엇인가요?

먼저 단일 서버가 아니라 구독 그룹을 추가했는지 확인한 다음 수동 업데이트를 실행하세요. 업데이트 결과가 비어 있거나 형식을 인식하지 못한다면 주소가 완전한지, 링크가 유효한지, 프록시를 통한 업데이트가 필요한지 확인합니다. 구독 내용을 가져오기도 전에 라우팅 규칙을 수정하지 마세요.

가져오기 단계 보기 →
Q / 02

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

Xray 코어 기능이 필요하면 v2rayNG를 선택하고, V2Fly 코어가 필요하거나 해당 설정을 이미 사용 중이라면 v2flyNG를 선택하세요. 두 클라이언트의 조작 방식은 비슷하지만 코어 지원 범위와 일부 필드가 다릅니다. 구독을 이전한 뒤 프로토콜·전송·보안 계층과 라우팅 설정이 모두 유지되었는지 확인해야 합니다.

Android 클라이언트 보기 →
Q / 03

연결은 켜졌는데 애플리케이션에 트래픽이 흐르지 않으면 어떻게 하나요?

먼저 애플리케이션이 시스템 프록시를 읽는지 확인하고, 읽지 않는 경우 TUN 모드를 고려하세요. 이어서 활성 서버, 라우팅 기본 출구, DNS 해석 방식과 로컬 수신 상태를 점검합니다. 특정 애플리케이션만 문제라면 해당 앱의 프록시 지원과 네트워크 권한을 집중적으로 비교하면 되며, 전체 구독을 바로 다시 만들 필요는 없습니다.

계층별 문제 해결 →
Q / 04

라우팅 규칙을 변경한 뒤 왜 매칭되지 않나요?

규칙 순서, 도메인 매칭 유형, 아웃바운드 태그와 GeoIP·GeoSite 데이터가 서로 일치하는지 확인하세요. 기존 연결은 이전 경로를 계속 사용할 수 있으므로 변경 후 연결을 다시 수립해 테스트해야 합니다. 로그에 대상 도메인과 매칭된 아웃바운드가 표시된다면 문제 지점이 규칙 조건인지 이후 연결 단계인지 바로 판단할 수 있습니다.

라우팅 문서 보기 →

TECH NOTES

설정 및 문제 해결 문서

FakeDNS, DNS 누출과 코어 차이를 중심으로 적용 범위, 설정 절차와 문제 해결 순서를 자세히 설명합니다.

전체 문서 보기 →
고급 설정 · 2026-08-11

FakeDNS 원리 해설: 가상 IP로 도메인 라우팅을 빠르게 하는 방법과 활성화하면 안 되는 경우

가상 IP 매핑, 도메인 복원과 라우팅 판정 과정을 분석하고 TUN 모드와 함께 사용할 때의 애플리케이션 호환 범위를 설명합니다.

전체 글 읽기 → 문제 해결 · 2026-08-04

DNS 누출 점검 및 해결 실전: v2rayN·v2rayNG 누출 방지 설정 단계

점검 결과를 해석하는 방법부터 원격 DNS, DNS 아웃바운드와 TUN 연결 범위를 단계적으로 조정한 뒤 해석 경로를 다시 확인합니다.

전체 글 읽기 → 고급 설정 · 2026-07-29

Xray 코어와 V2Fly 코어 비교: XTLS·REALITY 지원 및 설정 호환성

두 코어 계열의 기능적 차이, 공통으로 사용되는 설정과 세 GUI 클라이언트의 코어 선택 방식을 정리합니다.

전체 글 읽기 →