클라이언트 및 설정 문서 · Project V 생태계 참고

V2Ray 사용 가이드
v2rayN 다운로드 및 구독 설정

v2rayN 다운로드 사용법 보기

클라이언트 선택부터 시작해 구독 가져오기, 라우팅 분기, 설정 문제 해결을 차례로 확인하세요. 데스크톱과 Android 클라이언트를 다루며 Xray와 V2Fly 두 코어 라인의 사용 상황도 설명합니다.

영구 무료 오픈 소스 한국어 문서 멀티 코어 참고
구독 링크를 붙여넣고 v2rayN으로 한 번에 가져오기
구독 가져오기
메뉴 위치: 구독 그룹 → 구독 추가 → 구독 업데이트

CLIENT WORKBENCH

클라이언트 작업 공간: 구독부터 코어 로그까지

자주 사용하는 기능은 구독 그룹, 라우팅 모드, 시스템 프록시, 코어 선택, 로그 창의 다섯 곳에 모여 있습니다. 먼저 설정이 속한 계층을 확인한 뒤 세부 매개변수를 수정하면 설정을 반복해서 가져오는 것보다 문제를 쉽게 찾을 수 있습니다.

구독 그룹
  • 그룹 이름자주 쓰는 구독
  • 자동 업데이트
  • 업데이트 메뉴구독 그룹

구독 주소와 노드를 분리해 관리하기

구독은 서버에서 관리하는 설정 진입점 모음입니다. 클라이언트에서 구독을 업데이트해야 노드, 프로토콜, 전송 매개변수가 로컬에 저장됩니다. 실제로 사용할 때는 먼저 알아보기 쉬운 이름의 그룹을 만든 다음 전체 구독 주소를 붙여넣고 업데이트를 실행하세요. 업데이트에 실패하면 버튼을 연속해서 누르지 말고 네트워크 접속 실패인지, 반환된 콘텐츠 형식이 올바르지 않은지, 주소가 만료되었는지 안내 메시지부터 확인해야 합니다. 그룹 관리는 출처를 분리해 보존하는 데 의미가 있습니다. 여러 구독이 서로 덮어쓰지 않으며 한 그룹을 비활성화해도 다른 설정에는 영향을 주지 않습니다. 직접 추가한 단일 노드는 임시 테스트에 적합하므로 장기간 관리하는 구독과 같은 그룹에 섞지 않는 것이 좋습니다.

PLATFORM ENTRY

운영체제에 맞는 클라이언트와 설치 패키지 선택

플랫폼 페이지에서 지원 클라이언트, 설치 형식, 아키텍처 선택지를 한눈에 확인할 수 있습니다. 홈페이지에서 파일을 직접 배포하지 않으므로 해당 플랫폼으로 이동한 뒤 기기 유형에 맞는 설치 패키지를 선택하세요.

Windows

데스크톱에서는 v2rayN을 우선 선택하세요. 최신 데스크톱 인터페이스는 일반적인 설치에 적합하고, 클래식 WPF 버전은 전통적인 조작 레이아웃을 선호하는 사용자에게 알맞습니다. 두 버전 모두 구독, 라우팅, 시스템 프록시를 관리할 수 있습니다.

다운로드 페이지로 이동

macOS

macOS에서는 v2rayN 데스크톱 클라이언트를 사용합니다. 다운로드하기 전에 시스템 정보에서 프로세서 유형을 확인하고 Apple Silicon 또는 Intel에 맞는 설치 패키지를 선택해 설치 형식과 기기 아키텍처가 맞지 않는 문제를 피하세요.

다운로드 페이지로 이동

Android

Android에서는 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 전자는 Xray 코어를, 후자는 V2Fly 코어를 사용하는 방식입니다. 최근 출시된 대부분의 기기는 arm64를 선택할 수 있으며 아키텍처를 확인하기 어렵다면 범용 설치 패키지를 사용하세요.

다운로드 페이지로 이동

Linux

Linux 데스크톱에서는 v2rayN을 사용합니다. 배포판의 패키지 체계에 따라 deb 또는 rpm을 선택하고 프로세서 아키텍처에 맞춰 x64 또는 arm64를 고르세요. 설치 후에는 데스크톱 세션에서도 시스템 프록시를 설정해야 합니다.

다운로드 페이지로 이동
전체 클라이언트 및 시스템 요구 사항 보기 →

OPEN SOURCE ECOSYSTEM

Project V, V2Fly, Xray의 관계

클라이언트, 코어, 프로토콜, 구독은 서로 다른 계층입니다. 각각의 역할을 이해해야 문제가 발생했을 때 그래픽 인터페이스, 설정 파일, 하위 프로토콜 구현 중 어디를 점검할지 판단할 수 있습니다.

Project V 생태계에서 두 코어 라인으로

Project V는 설정 중심의 네트워크 도구 생태계를 구축했습니다. 초기 V2Ray 프로젝트는 인바운드, 아웃바운드, 라우팅, DNS, 정책, 전송 계층 등 핵심 설정 구조를 확립했고, 이후 커뮤니티의 유지보수를 거치며 V2Fly와 Xray라는 두 가지 대표적인 코어 라인이 형성되었습니다. 두 코어는 JSON으로 수신 대기 진입점, 원격 출구, 매칭 규칙을 설명하는 등 많은 기본 개념을 공유하지만, 신규 프로토콜, 전송 기능, 필드 확장, 버전 발전 속도에서는 서로 다른 방향을 보입니다.

따라서 “V2Ray 클라이언트”는 보통 이러한 코어와 설정을 관리하는 GUI 도구를 뜻하며 단일 프로그램의 이름을 의미하지는 않습니다. v2rayN은 데스크톱에서 구독, 노드, 라우팅, 시스템 프록시, 코어 실행을 담당하고, v2rayNG와 v2flyNG는 Android에서 설정을 관리합니다. GUI 클라이언트는 사용자의 조작을 코어가 읽을 수 있는 설정으로 변환한 뒤 로컬 수신 대기 포트를 시작합니다. 연결 성공 여부는 결국 구독 내용, 프로토콜 매개변수, 전송 계층 설정, 도메인 확인, 시스템 시간, 로컬 네트워크 환경이 함께 영향을 미칩니다.

오픈 소스 프로토콜과 커뮤니티 유지보수가 의미하는 것

소스 코드가 공개되면 프로토콜 구현, 설정 구조, 클라이언트 동작을 공개적으로 논의하고 계속 개선할 수 있지만 프로젝트마다 출시 주기는 다릅니다. 클라이언트 업데이트는 새로운 화면이나 설정 생성 로직을 가져올 수 있고, 코어 업데이트는 프로토콜 필드를 추가하거나 호환성 문제를 수정하고 기본 동작을 바꿀 수 있습니다. 업데이트 전에는 변경 사항을 읽고 사용 가능한 설정을 보존하며 현재 구독이 특정 코어 기능에 의존하는지 확인하세요. 안정적인 사용은 모든 업데이트를 따라가는 것과 다릅니다. 명확한 호환성 요구, 오류 수정, 시스템 지원 변경이 있을 때 업데이트하는 편이 대개 변수를 통제하기 쉽습니다.

오픈 소스 라이선스는 코드 복사, 수정, 재배포의 범위도 규정합니다. 일반 사용자가 더 주의할 부분은 프로젝트 이름과 설치 패키지 출처가 일치하는지, 클라이언트가 실제로 어떤 코어를 호출하는지, 설정에 해당 코어가 지원하는 필드가 포함되어 있는지입니다. 이 사이트의 가이드는 클라이언트 조작과 코어 개념을 나누어 설명합니다. 입문 단계에서는 눈에 보이는 화면에 집중하고, 설정 전체 안내에서는 JSON 각 부분의 의미를 설명하며, 용어집에서는 프로토콜과 네트워크 기초 개념을 찾을 수 있습니다. 문제 해결 글은 로그 현상에서 구체적인 설정으로 원인을 되짚습니다.

v2rayN

데스크톱 클라이언트

Windows, macOS, Linux를 지원하며 구독 그룹, 노드 선택, 시스템 프록시, 라우팅 규칙, 코어 관리를 한곳에서 처리합니다. 여러 설정을 GUI로 관리하려는 데스크톱 환경에 적합합니다.

v2rayNG

Android · Xray 라인

Xray 코어를 기반으로 구독 업데이트, 설정 가져오기, 라우팅 설정, 연결 로그를 제공합니다. 특정 Xray 확장 필드를 포함한 설정은 일반적으로 이 조합을 우선 사용합니다.

v2flyNG

Android · V2Fly 라인

V2Fly 코어를 기반으로 하며 화면 조작과 일반적인 구독 절차는 비슷합니다. 선택할 때는 설정 요구사항과 코어 호환 범위를 기준으로 판단하면 되며 두 클라이언트를 동시에 설치할 필요는 없습니다.

구독 업데이트에 실패하면 먼저 무엇을 확인해야 하나요?

먼저 주소가 완전하고 아직 접속 가능한지 확인한 다음 반환된 콘텐츠가 클라이언트에서 인식할 수 있는 구독 형식인지 살펴보세요. 네트워크 오류, 만료된 주소, 형식 오류는 각각 다르게 처리해야 하며 로컬 설정을 모두 삭제해서는 안 됩니다.

구독 가져오기 단계 보기 →

DNS와 라우팅을 함께 확인해야 하는 이유는 무엇인가요?

도메인 규칙의 일치 여부는 확인 위치와 도메인 전략의 영향을 받을 수 있습니다. DNS만 조정하거나 라우팅만 조정하면 실제 원인을 가릴 수 있으므로 요청 도메인, 확인 결과, 최종 출구를 차례로 대조해야 합니다.

DNS 및 routing 설정 보기 →

Xray와 V2Fly 중 무엇을 선택해야 하나요?

먼저 구독 또는 수동 설정에서 어떤 프로토콜, 흐름 제어, 전송 필드를 사용하는지 확인한 다음 해당 필드를 완전히 해석할 수 있는 코어를 선택하세요. 기본 설정은 대체로 모두 이해할 수 있지만 확장 기능은 항목별 확인이 필요합니다.

코어 및 프로토콜 용어 보기 →

연결에 실패하면 로그를 먼저 확인하는 이유는 무엇인가요?

로그를 보면 설정 파싱, 포트 수신 대기, DNS, 연결 시간 초과, 핸드셰이크 오류를 구분할 수 있습니다. 한 번에 변수 하나만 수정하고 완전히 새로 시작한 기록에서 첫 오류를 확인하면 문제 해결 경로가 더 명확해집니다.

설정 문제 해결 참고 보기 →

LATEST NOTES

설정 및 문제 해결 글

코어 시작, 프로토콜 원리, TLS 오류를 중심으로 재사용할 수 있는 점검 순서를 정리했습니다. 글의 설정 예시는 필드 관계를 설명하기 위한 것이며 실제 매개변수는 자신의 구독 또는 서비스 설정을 기준으로 해야 합니다.

문제 해결

V2Ray 코어 시작 실패 해결법: 로그로 config.json 설정 오류 찾기

클라이언트 로그 창에서 출발해 JSON 문법 오류, 포트 사용 중, 필드 오탈자, 프로토콜 매개변수 누락이라는 네 가지 주요 원인의 대표 오류 행을 해석하고, 항목별 수정 및 재시작 판단 기준을 제시합니다.

전체 글 읽기 →
프로토콜 해설

REALITY 프로토콜과 XTLS Vision 해설: 핸드셰이크 원리와 성능 이점

REALITY의 핸드셰이크 특성과 XTLS Vision이 중복 암호화 오버헤드를 줄이는 흐름 제어 방식을 설명하고, 클라이언트, 코어, 노드 설정이 서로 일치해야 하는 핵심 필드를 안내합니다.

전체 글 읽기 →
문제 해결

V2Ray TLS 인증서 오류 해결 체크리스트: 시스템 시간 불일치와 SNI 설정

certificate invalid, handshake failed와 같은 흔한 메시지를 대상으로 시스템 시간 오차, serverName 불일치, 인증서 체인 문제를 점검하는 순서로 정리했습니다.

전체 글 읽기 →
전체 글 보기 →
v2rayN 다운로드