클라이언트 및 설정 문서 안내

V2Ray 공식 포털: v2rayN 클라이언트 및 설정 가이드

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

v2rayN 데스크톱 클라이언트, Android 클라이언트 및 한국어 설정 문서를 한곳에서 확인하고, 운영체제에 맞춰 설치, 구독 가져오기, 프록시 모드 선택, 라우팅을 점검하세요.

Project V 생태계 V2Fly / Xray VMess / VLESS 설정 문서

SYSTEM MODULES

시스템 모듈 레지스트리

구독 데이터가 클라이언트로 들어오면 설정은 프로토콜 해석, 라우팅 판단, DNS 조회, 로컬 프록시 적용 순서로 처리됩니다. 각 모듈의 담당 범위와 설정 변경 전에 확인할 경계를 단계별로 살펴보세요.

라우팅 엔진: 목적지에 따라 출구 결정

라우팅 엔진은 도메인, 대상 주소, 포트, 프로세스 등의 조건을 읽고 연결을 지정된 출구로 전달합니다. 일반적으로 로컬 네트워크와 직접 연결 대상은 기존 경로를 유지하고, 나머지 요청은 규칙에 따라 프록시 출구로 보냅니다. 규칙 순서가 매칭 결과에 영향을 주므로 변경 전 현재 모드를 기록하고, 먼저 명확한 조건 몇 개로 확인한 뒤 범위를 넓히는 것이 좋습니다. v2rayN은 기본 라우팅과 사용자 지정 규칙을 제공합니다. 일반 사용자는 기본 모드부터 시작하고, 특정 사이트의 경로가 예상과 다를 때 도메인 규칙, 주소 규칙, 최종 기본 항목을 점검하면 됩니다.

engine: domain / ip / port rules action: direct / proxy / block

PLATFORM ENTRY

4개 플랫폼 다운로드 안내

현재 기기에 맞는 플랫폼을 먼저 선택한 다음 프로세서 아키텍처와 설치 패키지 형식에 따라 알맞은 클라이언트로 이동하세요. 홈 화면은 플랫폼 안내만 제공하며, 구체적인 파일, 버전 설명, 시스템 요구 사항은 다운로드 센터에서 확인할 수 있습니다.

desktop / x64

Windows

데스크톱에서는 v2rayN을 우선 선택하세요. 다운로드 페이지에서 차세대 크로스 플랫폼 데스크톱 인터페이스와 기존 WPF 인터페이스를 각각 제공하며, 일반적인 프록시 사용, 구독 관리, 라우팅 설정에 적합합니다. 선택 전 시스템 아키텍처를 확인하고 익숙한 인터페이스에 따라 설치 경로를 정하면 됩니다.

다운로드 페이지로 이동

desktop / arm64 · x64

macOS

macOS에서는 v2rayN 데스크톱 버전을 사용하며 Apple Silicon 또는 Intel 프로세서에 맞는 설치 파일을 선택해야 합니다. 처음 실행할 때 시스템 허용과 네트워크 권한을 확인한 후 구독을 가져오고 시스템 프록시를 전환하세요. 권한 문제를 노드 문제로 잘못 판단하는 일을 줄일 수 있습니다.

다운로드 페이지로 이동

mobile / arm64 · universal

Android

Android에서는 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. v2rayNG는 Xray 코어를 사용하므로 일반적인 첫 선택으로 적합하고, v2flyNG는 V2Fly 코어를 사용하므로 구독 호환성에 따라 대안으로 선택할 수 있습니다. 최신 기기는 대개 arm64를 사용하며, 아키텍처를 확인하기 어렵다면 범용 버전 설명을 참조하세요.

다운로드 페이지로 이동

desktop / deb · rpm

Linux

Linux 데스크톱에서는 v2rayN을 사용하고 배포판에 맞춰 deb 또는 rpm 설치 패키지를 선택하세요. Debian, Ubuntu 계열은 보통 deb를 사용하고 Fedora, RHEL 계열은 보통 rpm을 사용합니다. x64와 arm64 아키텍처도 구분해야 하며, 설치 후 데스크톱 실행 항목과 자동 시작 설정을 확인하세요.

다운로드 페이지로 이동
전체 클라이언트 보기 →

OPEN SOURCE ECOSYSTEM

Project V, 코어와 클라이언트의 관계

V2Ray 관련 명칭은 프로젝트 생태계, 코어 구현, 그래픽 클라이언트, 프로토콜 설정 등 여러 계층에 걸쳐 사용됩니다. 각 계층의 역할을 먼저 구분하면 설치와 문제 해결이 훨씬 수월합니다.

ECOSYSTEM Project V 프로토콜 및 프록시 도구 생태계
CORE FAMILY V2Fly 커뮤니티가 유지 관리하는 코어 제품군
CORE FAMILY Xray 독립적으로 발전하는 호환 코어 제품군
DESKTOP v2rayN 데스크톱 그래픽 클라이언트
ANDROID v2rayNG Xray 코어 클라이언트
ANDROID v2flyNG V2Fly 코어 클라이언트

생태계의 역사: V2Ray는 단일 설치 프로그램이 아닙니다

Project V는 프록시 프로토콜, 전송 방식, 라우팅 규칙, 설정 형식을 중심으로 한 오픈 소스 기술 생태계를 구축해 왔습니다. 일반적인 검색에서 V2Ray는 프로토콜 기능이나 핵심 프로그램을 뜻할 수도 있고, 관련 설정을 읽는 그래픽 클라이언트를 통칭할 수도 있습니다. 사용자가 실제로 조작하는 것은 대개 v2rayN, v2rayNG 또는 v2flyNG입니다. 클라이언트는 인터페이스, 구독, 시스템 통합을 담당하고 하위 코어는 연결 수립, 라우팅 실행, 프로토콜 처리를 담당합니다. 그래픽 인터페이스와 코어를 별도 계층으로 이해하면 클라이언트 업데이트, 코어 업데이트, 구독 업데이트가 서로 같지 않은 이유를 파악하기 쉽습니다.

코어 제품군: V2Fly와 Xray

V2Fly는 V2Ray의 핵심 기능을 이어받아 커뮤니티에서 지속적으로 유지 관리하고 있으며, Xray는 기존 설정 일부와의 호환성을 바탕으로 독립적으로 발전하고 있습니다. 두 코어 모두 일반적인 프로토콜과 라우팅 설정을 처리할 수 있지만 지원 기능, 필드 세부 사항, 업데이트 주기는 다를 수 있습니다. 가져온 노드의 정상 작동 여부는 클라이언트 이름만으로 결정되지 않으며, 호출된 코어가 해당 프로토콜, 전송 계층, 확장 매개변수를 지원하는지도 중요합니다. 가져오기는 성공했지만 시작되지 않는다면 같은 구독을 반복해서 삭제하기보다 클라이언트 로그의 설정 오류를 확인하고 현재 코어의 지원 범위와 대조하세요.

오픈 소스 라이선스: 코드, 배포, 문서의 범위는 서로 다릅니다

세 클라이언트와 관련 코어는 모두 오픈 소스 소프트웨어 생태계에 속합니다. 소스 코드 라이선스는 코드를 열람, 연구, 수정, 재배포할 수 있는 조건을 설명합니다. 구성 요소마다 다른 라이선스를 사용할 수 있으므로 재배포나 통합 시에는 해당 프로젝트에 포함된 라이선스 문서를 기준으로 삼아야 합니다. 오픈 소스라는 사실이 모든 제3자 구독 콘텐츠를 클라이언트 프로젝트가 관리한다는 뜻은 아니며, 특정 노드 서비스가 Project V에 속한다는 의미도 아닙니다. 클라이언트, 코어, 구독 제공자, 로컬 네트워크 환경은 서로 독립된 단계이므로 문제 해결 시 책임 범위를 나누어 확인해야 합니다.

업데이트 방식: 클라이언트, 코어, 구독은 각각 관리

클라이언트 업데이트는 주로 인터페이스, 플랫폼 호환성, 설정 관리 기능을 변경합니다. 코어 업데이트는 프로토콜 지원을 추가하거나 설정 해석을 수정하고 네트워크 동작을 조정할 수 있습니다. 구독 업데이트는 기존 주소에서 노드 목록을 다시 가져옵니다. 세 가지 업데이트는 별도로 이해해야 합니다. 정상적인 사용에서는 현재 클라이언트가 시작되는지 먼저 확인한 뒤 구독을 업데이트하고 알려진 설정으로 테스트하세요. 로그에 코어가 특정 필드를 지원하지 않는다는 메시지가 명확히 표시되거나 플랫폼 호환 문제가 새 버전에서 해결된 경우에만 클라이언트 또는 코어 업그레이드를 고려하면 됩니다. 업그레이드 전 프록시 모드, 라우팅 방식, 사용자 지정 설정을 기록해 두면 변경 사항을 비교하기 쉽습니다.

QUICK ANSWERS

자주 묻는 질문

설치 전에 클라이언트, 구독, 프록시 모드의 차이를 확인하면 반복 설정을 줄일 수 있습니다. 더 자세한 분류별 문답은 자주 묻는 질문 페이지에서 확인하세요.

01 / CLIENT

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

Windows, macOS, Linux 데스크톱에서는 v2rayN을 우선 선택하세요. Android는 보통 v2rayNG로 시작하고, 설정에 V2Fly 코어 경로가 명시되어 있거나 두 코어의 동작을 비교해야 할 때 v2flyNG를 사용하면 됩니다. 클라이언트 이름은 인터페이스와 플랫폼을 결정하며, 실제 프로토콜 처리는 클라이언트가 호출하는 코어가 담당합니다.

클라이언트 선택 안내 보기 →

02 / SUBSCRIPTION

공유 링크와 구독 주소는 어떻게 다른가요?

vmess:// 또는 vless://는 보통 단일 노드를 설명하며, 가져오면 하나의 서버 항목이 생성됩니다. 구독 주소는 업데이트 가능한 노드 목록을 반환하고 클라이언트가 그룹별로 관리합니다. 공유 링크만 있다면 클립보드에서 바로 가져오고, 구독 주소가 있다면 구독 설정에서 추가한 뒤 업데이트를 실행하세요.

구독 가져오기 절차 보기 →

03 / MODE

시스템 프록시와 TUN 중 무엇을 먼저 사용해야 하나요?

처음 설정할 때는 시스템 프록시를 먼저 사용하세요. 적용 범위를 확인하기 쉽고 브라우저 같은 일반적인 앱의 작동 여부도 점검하기 편합니다. 시스템 프록시를 읽지 않는 프로그램이 있다면 그때 TUN을 검토하세요. TUN을 활성화하기 전에는 가상 네트워크 인터페이스, 시스템 권한, 라우팅 테이블, DNS 적용 범위의 변화를 이해해야 하며 여러 네트워크 적용 도구를 동시에 사용하지 않는 것이 좋습니다.

프록시 모드 용어 보기 →

04 / TROUBLESHOOTING

노드에 연결할 수 없을 때 무엇부터 확인해야 하나요?

먼저 클라이언트 코어가 실행 중인지 확인하고, 구독 업데이트 성공 여부, 현재 노드 선택 여부, 시스템 프록시 활성화 여부를 차례로 점검하세요. 그다음 로그에서 처음 나타난 명확한 오류를 읽고 도메인 해석, 포트 연결 불가, 설정 필드 오류, 권한 문제를 구분합니다. 클라이언트, 노드, 프록시 모드를 한꺼번에 바꾸기보다 한 번에 하나의 변수만 수정해야 원인을 더 쉽게 찾을 수 있습니다.

문제 해결 문답 열기 →

LATEST GUIDES

최근 설정 문서

플랫폼별 설치, 공유 링크 가져오기, 시작 오류라는 세 가지 주제로 구체적인 절차를 정리했습니다. 문서의 다운로드 안내는 모두 다운로드 센터로 연결되며, 설정 방법은 각 클라이언트 인터페이스에 맞춰 단계별로 설명합니다.

플랫폼 가이드

v2rayN Linux 데스크톱 버전 설치 가이드: deb/rpm 패키지 선택 및 부팅 시 자동 시작 설정

Debian, Ubuntu, Fedora 계열 배포판을 대상으로 설치 패키지 형식, 설치 명령, 데스크톱 실행 항목 복구, systemd 사용자 서비스 설정을 설명합니다.

문서 읽기 →
플랫폼 가이드

macOS에서 개발자를 확인할 수 없다는 메시지가 표시될 때: v2rayN 첫 실행 및 네트워크 권한 처리

시스템 설정에서 앱을 허용하는 경로, 첫 실행 안내, 로컬 네트워크 권한, 프록시 권한을 단계별로 처리하고 설치 차단과 노드 연결 문제를 구분합니다.

문서 읽기 →
입문 가이드

vmess:// 및 vless:// 공유 링크 사용법: 구독 주소와의 차이 한눈에 보기

단일 노드 공유 링크와 구독 주소의 구조적 차이를 설명하고, v2rayN과 v2rayNG에서 클립보드로 가져온 뒤 그룹을 업데이트하는 방법을 안내합니다.

문서 읽기 →
전체 문서 보기 →