READING ORDER / 01

클라이언트 선택에서 설정 구조까지

V2Ray 클라이언트는 화면, 구독 및 시스템 프록시를 관리하고, Xray 또는 V2Fly 코어는 프로토콜 처리, 전송 및 라우팅을 담당합니다. 두 계층을 분리해 이해하면 화면 옵션, 코어 필드와 서버 매개변수를 혼동하는 일을 줄일 수 있습니다.

홈 화면은 “플랫폼 선택—설정 가져오기—라우팅 확인—연결 점검” 순서로 자료를 구성했습니다. 바로 설치하려면 클라이언트 페이지로, 단계별 작업은 입문 가이드로, 필드 확인은 전체 설정 문서로 이동하세요.

FEATURE LEDGER / 02

클라이언트 기능과 설정의 경계

아래 항목은 자주 사용하는 화면 기능을 코어 개념에 대응시킨 것입니다. 항목을 선택하면 작업 순서, 필드 범위 및 문제 해결 포인트를 확인할 수 있습니다.

SELECTED NOTE / ROUTING

규칙 순서, 매칭 범위 및 아웃바운드 태그

라우팅 문제 해결은 입력 조건부터 시작합니다. 먼저 트래픽이 어느 inbound로 들어오는지 확인하고, 도메인·IP·포트 또는 프로세스 조건이 매칭되는지 점검한 다음 대상 outbound의 태그와 정의를 확인하세요. 규칙 배열은 보통 순서대로 매칭되므로 범위가 넓은 조건을 앞에 두면 뒤의 세부 규칙이 가려질 수 있습니다. 클라이언트의 “전역”, “규칙”, “직접 연결” 모드는 서로 독립된 프로토콜이 아니라 인바운드, 라우팅, 아웃바운드 관계를 화면에서 관리하는 방식입니다.

PLATFORM INDEX / 03

네 가지 플랫폼의 클라이언트

데스크톱 플랫폼은 v2rayN을 기본 진입점으로 사용하고, Android에서는 코어 요구 사항에 따라 v2rayNG와 v2flyNG 중 선택할 수 있습니다. 설치 파일과 CPU 아키텍처 안내는 다운로드 페이지에 모아 두었습니다.

DESKTOP / WINDOWS

Windows

Windows 사용자는 v2rayN 데스크톱 버전 또는 클래식 WPF 버전을 선택할 수 있습니다. 전자는 크로스 플랫폼 UI 아키텍처를 사용하고, 후자는 기존 Windows 사용 환경을 이어가려는 경우에 적합합니다. 다운로드 페이지에서 설치 선택, 시스템 프록시 진입점 및 두 릴리스 라인의 차이도 함께 설명합니다.

다운로드로 이동

DESKTOP / MACOS

macOS

macOS에서는 v2rayN 데스크톱 버전을 사용하며 Apple Silicon과 Intel 프로세서에 맞는 설치 파일을 선택해야 합니다. 칩 종류를 모르겠다면 먼저 시스템 정보에서 프로세서 또는 칩 이름을 확인한 뒤 다운로드 페이지에서 선택하세요. 아키텍처 문제를 앱 실행 오류로 잘못 판단하는 일을 줄일 수 있습니다.

다운로드로 이동

MOBILE / ANDROID

Android

Android에서는 Xray 코어를 사용하는 v2rayNG를 이용하거나, 설정과 코어 선호도에 따라 V2Fly 코어를 사용하는 v2flyNG를 선택할 수 있습니다. 다운로드 페이지에는 arm64 및 범용 설치 파일을 각각 제공하며 VPN 서비스, 백그라운드 실행 및 앱별 프록시의 기본 관계도 설명합니다.

다운로드로 이동

DESKTOP / LINUX

Linux

Linux 데스크톱에서는 v2rayN을 사용할 수 있으며 Debian, Ubuntu, Fedora 등 배포판의 패키지 체계에 맞춰 deb 또는 rpm 파일을 선택합니다. 다운로드 페이지에는 x64와 arm64 진입점도 정리되어 있습니다. 설치 후 가이드를 참고해 데스크톱 연동, 구독 가져오기 및 로그인 세션 자동 시작을 설정할 수 있습니다.

다운로드로 이동

모든 클라이언트 보기 →

QUICKSTART / 04

세 단계로 기본 설정 완료

빠른 시작에서는 가장 짧은 경로만 처리합니다. 첫 연결이 안정된 뒤 사용자 지정 DNS, 복잡한 라우팅 및 앱별 규칙을 단계적으로 추가하면 문제가 생겼을 때 변경 원인을 쉽게 찾을 수 있습니다.

01

설치 및 플랫폼 확인

운영체제, CPU 아키텍처 및 데스크톱 환경에 맞춰 클라이언트를 선택하세요. Windows와 Linux는 배포 형식도 구분해야 하고, macOS는 칩 아키텍처를 확인해야 하며, Android는 arm64와 범용 설치 파일 중에서 선택합니다. 처음 실행한 뒤 화면이 정상적으로 열리고 코어가 로드되는지 먼저 확인한 다음 설정을 가져오세요. 설치 문제와 연결 매개변수를 한 번에 섞어 점검하지 않는 것이 좋습니다.
02

구독 또는 단일 설정 가져오기

구독은 여러 항목을 한곳에서 관리할 때 적합하고, 단일 링크나 수동 JSON은 구체적인 매개변수를 확인할 때 유용합니다. 가져온 뒤 그룹, 프로토콜, 주소, 포트 및 전송 유형이 예상대로 표시되는지 확인하고 활성 설정을 직접 선택하세요. 클라이언트에서 해석 오류가 표시되면 먼저 콘텐츠 형식과 복사 범위를 확인해야 하며, 프록시 모드를 반복해서 바꾸며 가져오기 단계의 문제를 가려서는 안 됩니다.
03

연결, 시스템 연동 및 확인

클라이언트 연결을 시작한 뒤 플랫폼에 따라 시스템 프록시 또는 모바일 VPN 서비스를 활성화하세요. 확인할 때는 시스템 네트워크 설정을 따르는 앱을 먼저 사용하고, 클라이언트 로그에 해당 요청이 나타나는지 관찰합니다. 기본 경로가 확인된 뒤 우회 규칙, DNS 분기 및 앱별 범위를 추가하세요. 이 순서를 따르면 연결 매개변수, 시스템 연동, 라우팅 조건이 각각 어느 계층에 있는지 구분할 수 있습니다.

전체 가이드 보기 →

ECOSYSTEM NOTES / 05

Project V, V2Fly 및 Xray 코어 계열

그래픽 클라이언트, 코어 및 설정 형식은 서로 협력하지만 역할은 다른 계층입니다. 프로젝트 간 관계를 이해하면 특정 옵션이 화면, 코어 기능 또는 프로토콜 자체에서 비롯된 것인지 판단하는 데 도움이 됩니다.

Project V

생태계의 출처와 설정 모델

Project V는 인바운드, 아웃바운드, 라우팅, DNS, 정책 및 전송 설정을 중심으로 한 설정 모델을 구축했습니다. 이는 하나의 그래픽 프로그램 이름이 아니라 프로토콜 구현, 코어 분기, 클라이언트 화면 및 문서 사례가 함께 이루는 기술 생태계입니다. 많은 클라이언트가 JSON 필드를 폼, 메뉴 및 모드 선택으로 변환해 일상적인 작업을 쉽게 만들지만, 기본 로직은 여전히 inbounds, outbounds, routing 및 dns 구조로 설명할 수 있습니다.

설정 파일을 읽을 때는 먼저 데이터 흐름으로 전체 구조를 파악하는 것이 좋습니다. 앱 트래픽이 로컬 인바운드를 통해 코어로 들어오면 라우팅 규칙이 사용할 아웃바운드를 결정하고, 아웃바운드는 프로토콜과 전송 필드에 따라 연결을 수립합니다. DNS와 policy 등은 해석, 리소스 정책 및 특정 동작에 조건을 추가합니다. 이 흐름대로 읽으면 고립된 필드를 하나씩 외우는 것보다 참조 태그 오류나 규칙 범위 충돌을 쉽게 발견할 수 있습니다.

V2Fly

지속적으로 유지 관리되는 코어 분기

V2Fly는 Project V의 관련 기술 체계를 이어받아 프로토콜, 라우팅, 전송 및 플랫폼 대응을 지속적으로 관리합니다. v2flyNG는 V2Fly 코어를 사용해 Android 환경에 다른 그래픽 클라이언트 조합을 제공합니다. 이를 선택할 때는 구독 내용과 대상 코어의 지원 범위를 확인하고, 비슷하게 보이는 링크 형태만으로 호환성을 판단하지 말고 클라이언트에 실제로 표시되는 설정 항목을 기준으로 삼아야 합니다.

코어 업데이트에는 보통 프로토콜 구현, 의존 구성 요소, 전송 동작 및 문제 수정이 포함됩니다. 클라이언트 업데이트에는 화면, 구독 해석, 시스템 연동 및 플랫폼 패키징도 포함됩니다. 두 업데이트의 출시 주기는 다를 수 있으므로 특정 기능을 점검할 때는 클라이언트 이름과 함께 연결된 코어 계열을 확인해야 합니다. 화면에 노출되지 않은 옵션을 코어가 완전히 지원하지 않는다고 오해하지 않도록 주의하세요.

Xray

프로토콜 및 전송 기능의 또 다른 분기

Xray는 같은 기술 생태계에 속한 코어 분기 중 하나로, 프로토콜·전송·라우팅 기능을 중심으로 독립적인 유지 관리 경로를 형성합니다. v2rayNG는 일반적으로 Xray 코어와 함께 사용되며, v2rayN도 지원 범위 내에서 해당 코어를 관리할 수 있습니다. 설정을 옮길 때는 서로 다른 코어의 모든 확장 항목이 이름, 기본값 및 사용 범위까지 완전히 같다고 가정하지 말고 구체적인 필드를 확인해야 합니다.

VLESS, Reality, gRPC 또는 세밀한 라우팅을 다룰 때는 기본 시스템 프록시 조작보다 코어 차이가 더 중요합니다. 가장 안전한 방법은 작동하는 최소 설정을 먼저 유지한 뒤 현재 코어 문서에 따라 전송 보안, 스니핑, DNS 및 라우팅 조건을 하나씩 추가하는 것입니다. 여러 필드를 동시에 바꾸면 실패하더라도 원인이 프로토콜 매개변수인지, 전송 설정인지, 로컬 연동인지 판단하기 어렵습니다.

Open source

클라이언트, 라이선스 및 업데이트 방식

v2rayN, v2rayNG 및 v2flyNG는 모두 코드가 공개되어 유지 관리되는 클라이언트 프로젝트입니다. 코드가 공개되어 있어 화면 동작, 설정 변환 및 코어 호출 방식을 기술 커뮤니티에서 논의하고 검토할 수 있으며, 플랫폼별로도 동일한 설정 개념을 바탕으로 각자의 조작 화면을 구성할 수 있습니다. 오픈 소스는 개발 및 협업 방식에 대한 속성이며, 임의의 설정 출처나 네트워크 환경을 포괄적으로 판단하는 근거로 바꿔 해석해서는 안 됩니다.

업데이트할 때는 클라이언트 프로그램, 코어 구성 요소 및 구독 콘텐츠라는 세 대상을 구분해야 합니다. 클라이언트 프로그램 업데이트는 화면과 해석 로직을 바꿀 수 있고, 코어 업데이트는 프로토콜 또는 전송 구현을 바꿀 수 있으며, 구독 업데이트는 설정 항목만 교체합니다. 변경 대상과 시간 순서를 기록하면 문제가 발생했을 때 되짚어 볼 범위를 줄일 수 있습니다. 이 사이트의 다운로드 페이지는 플랫폼과 설치 파일 선택을, 전체 설정 문서는 필드 의미를, 블로그는 아키텍처 차이와 일반적인 유지 관리 문제를 다룹니다.

SELECTED QUESTIONS / 06

자주 묻는 질문

아래 질문은 문제 해결 순서에 따라 간단한 판단 기준을 제시합니다. 특정 버튼이나 필드 위치가 필요하면 입문 가이드 또는 전체 설정 문서로 이동하세요.

v2rayN 데스크톱 버전과 WPF 버전은 어떻게 선택하나요

데스크톱 버전은 Avalonia 크로스 플랫폼 아키텍처로 Windows, macOS 및 Linux에서 사용할 수 있고, WPF 버전은 Windows 전용이며 클래식 화면과 조작 방식을 유지합니다. 새로 설치한다면 데스크톱 버전부터 시작하고, 기존 Windows 작업 흐름에 익숙한 사용자는 두 버전의 화면, 의존성 및 마이그레이션 방식을 비교한 뒤 결정할 수 있습니다. 다운로드 페이지에는 두 진입점이 각각 제공됩니다.

구독 가져오기에 성공했는데 왜 연결되지 않나요

가져오기에 성공했다는 것은 클라이언트가 구독 콘텐츠를 읽었다는 뜻일 뿐입니다. 활성 설정을 선택하고 연결을 시작한 뒤 플랫폼에 따라 시스템 프록시 또는 VPN 서비스를 활성화해야 합니다. 여전히 응답이 없다면 주소와 포트, 프로토콜 및 전송 필드, 시스템 시간, 연동 범위와 클라이언트 로그를 순서대로 확인하세요. 모든 문제를 곧바로 구독 주소 탓으로 돌리는 것은 적절하지 않습니다.

전역 모드, 규칙 모드와 시스템 프록시는 어떻게 다른가요

시스템 프록시는 앱 트래픽이 클라이언트로 들어오는 방식을 설명하고, 전역 또는 규칙 모드는 코어에 들어온 트래픽이 아웃바운드를 선택하는 방식을 설명합니다. 전자는 시스템 연동 계층이고 후자는 라우팅 계층입니다. 어떤 앱이 시스템 프록시를 읽지 않으면 라우팅을 전역으로 설정해도 트래픽이 클라이언트로 들어오지 않을 수 있습니다. 반대로 트래픽이 들어온 뒤에는 선택한 라우팅 모드의 영향을 받습니다.

V2Ray DNS 설정은 어디부터 확인해야 하나요

먼저 도메인을 시스템에서 해석하는지 코어에 맡기는지 확인한 뒤 DNS 서버, 조회 정책 및 정적 매핑을 점검하세요. 여러 처리 방식을 동시에 활성화했다면 단일 경로로 줄여 기본 해석을 확인한 다음 분기를 복원하는 것이 좋습니다. 도메인과 IP를 조합한 규칙을 사용할 때는 해석 결과가 라우팅 매칭에 참여하는지도 확인해야 합니다.

입문 가이드 읽기 → 전체 설정 보기 →