클라이언트 다운로드 및 설정 지식 베이스

V2Ray 공식 다운로드 사이트: v2rayN 클라이언트 및 설정 문서

v2rayN 다운로드 사용 안내 보기

네 가지 플랫폼 클라이언트, 구독 가져오기 절차, 라우팅 및 DNS 설정을 한곳에 정리했습니다. 실제 작업 순서에 맞춰 구성했으며, 처음 설치할 때나 설정을 이전할 때, 연결 문제가 발생했을 때 단계별로 확인하기 좋습니다.

무료 사용 오픈 소스 한국어 문서 그래픽 클라이언트
PLATFORMSWindows · macOS · Android · Linux
CLIENTSv2rayN · v2rayNG · v2flyNG
CORESXray · V2Fly
TOPICS구독 · 라우팅 · DNS
시스템별 선택

네 가지 플랫폼의 클라이언트 다운로드

데스크톱에서는 주로 v2rayN을 사용하고, Android에서는 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 다운로드 페이지에서는 프로세서 아키텍처와 패키지 형식까지 구분하며, 여기서는 운영체제별 다운로드 경로를 안내합니다.

Windows

일반적인 데스크톱 환경에 적합합니다. v2rayN은 데스크톱 버전과 기존 WPF 버전을 제공하므로 인터페이스 선호도와 기존 사용 방식에 따라 선택할 수 있습니다.

다운로드 페이지로 이동

macOS

v2rayN은 Apple Silicon과 Intel용 설치 패키지를 제공합니다. 선택하기 전에 시스템 정보에서 칩 유형을 확인해 맞지 않는 아키텍처의 파일을 받지 않도록 하세요.

다운로드 페이지로 이동

Android

대부분의 최신 기기에서는 arm64 아키텍처를 선택합니다. v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용하므로 설정 출처와 필요한 코어에 따라 결정하면 됩니다.

다운로드 페이지로 이동

Linux

v2rayN은 deb와 rpm 패키지를 제공하며 x64와 arm64 아키텍처를 구분합니다. 먼저 배포판의 패키지 형식을 확인한 뒤 알맞은 프로세서용 파일을 선택하세요.

다운로드 페이지로 이동
전체 클라이언트 보기
설정 핵심

구독부터 라우팅까지 핵심 설정 세 가지

클라이언트 설치는 시작에 불과합니다. 실제 사용 결과에 더 큰 영향을 주는 요소는 구독이 정상적으로 업데이트되는지, 라우팅 규칙이 예상대로 적용되는지, DNS 조회가 분기 정책과 일치하는지입니다.

구독 관리

구독 업데이트 설정

구독 링크는 서버 설정 목록을 클라이언트에 제공합니다. 가져온 뒤 먼저 수동으로 한 번 업데이트해 클라이언트가 내용을 읽는지 확인하고, 그다음 시작 시 업데이트를 사용할지 결정하세요. 업데이트에 실패하면 링크가 완전한지, 복사 과정에서 공백이 섞이지 않았는지, 시스템 시간이 정확한지, 현재 네트워크에서 구독 주소에 접근할 수 있는지를 우선 확인해야 합니다. 오류 메시지와 업데이트 시간은 문제를 찾는 중요한 단서이므로 설정 전체를 반복해서 삭제하지 마세요. 업데이트가 성공한 뒤에는 새 항목이 올바른 구독 그룹에 추가되었는지도 확인해 이전 설정을 이번 업데이트 결과로 착각하지 않도록 하세요.

구독 가져오기 절차 보기 →
구독 설정subscription
시작 시 구독 업데이트
업데이트 시 사용할 수 없는 그룹 건너뛰기끄기
구독 그룹출처별 저장
빠른 시작

설치 후 세 단계로 기본 연결 설정

먼저 설정 출처를 확인하고, 실행 방식을 선택한 다음, 실제 접속과 클라이언트 로그로 검증하세요. 이 순서로 진행하면 설치 문제, 설정 문제, 시스템 프록시 문제를 나누어 처리할 수 있습니다.

  1. 01

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

    클라이언트의 구독 관리에서 완전한 링크를 추가하고 저장한 뒤 수동 업데이트를 한 번 실행하세요. 단일 공유 링크를 사용하는 경우 클립보드에서 가져온 다음 프로토콜, 주소, 포트 등의 필드가 올바르게 인식되었는지 확인합니다. 가져오기가 완료되었다고 연결이 활성화된 것은 아니므로 사용할 설정을 계속 선택해야 합니다.

  2. 02

    설정 및 시스템 프록시 모드 선택

    목록에서 사용할 설정을 선택하고 코어를 시작한 뒤 필요에 따라 시스템 프록시를 켜세요. 규칙 모드는 라우팅 조건에 따라 출구를 결정하고, 전역 모드는 더 넓은 범위의 연결을 프록시로 전달하는 경우가 많습니다. 처음 사용할 때는 기본 라우팅을 유지하고 기본 연결이 정상인지 확인한 후 사용자 지정 분기를 추가하는 것이 좋습니다.

  3. 03

    연결 및 로컬 포트 확인

    클라이언트 상태, 코어 로그, 로컬 수신 포트가 정상인지 확인한 뒤 브라우저로 대상 페이지에 접속하세요. 일부 앱만 연결되지 않는다면 해당 앱이 시스템 프록시를 따르는지 확인해야 합니다. 코어가 시작되지 않으면 포트 충돌과 설정 필드 형식을 우선 점검하세요.

전체 사용 안내 보기
생태계와 코어

Project V, V2Fly, Xray의 관계

V2Ray는 일반적으로 프로토콜, 전송, 라우팅, 프록시 기능을 아우르는 이름으로 사용됩니다. Project V에서 초기 핵심 개념과 설정 구조가 형성되었고, 이후 커뮤니티의 유지보수를 거치며 여러 코어 계열로 나뉘었습니다. V2Fly는 v2ray-core 계열을 이어서 유지하고 있으며, Xray는 기존 설정 방식과의 호환성을 유지하면서 프로토콜과 전송 기능을 확장했습니다. 그래픽 클라이언트는 코어와 별개로 설정 관리, 구독 업데이트, 시스템 프록시 전환, 로그 확인 등의 화면을 제공합니다.

CORE 01

코어가 연결과 규칙을 실행합니다

코어는 설정 파일을 읽어 인바운드와 아웃바운드 연결을 만들고 DNS, 라우팅, 전송, 정책 설정을 실행합니다. VMess, VLESS, Trojan 등의 프로토콜 매개변수도 최종적으로 코어가 해석합니다. 설정을 사용할 수 있는지는 클라이언트 화면에 항목이 표시되는지만으로 결정되지 않습니다. 선택한 코어가 해당 필드를 인식할 수 있는지, 전송 계층과 보안 계층의 매개변수가 서로 맞는지도 중요합니다.

CLIENT 02

클라이언트가 일상적인 설정을 관리합니다

v2rayN은 Windows, macOS, Linux 데스크톱 환경을 대상으로 구독 그룹, 라우팅, 시스템 프록시, 여러 코어를 관리하는 화면을 제공합니다. v2rayNG는 Android용으로 보통 Xray 코어와 함께 사용하며, v2flyNG도 Android용이지만 내장된 V2Fly 코어를 선택지로 제공합니다. 세 클라이언트 모두 오픈 소스이지만 기능 범위와 코어 방향은 완전히 같지 않습니다.

LICENSE 03

오픈 소스 라이선스가 코드 사용 방식을 정합니다

오픈 소스는 소스 코드를 검토하고 학습하며 라이선스 조건에 따라 수정할 수 있다는 뜻이지, 모든 클라이언트와 코어, 서드파티 설정이 같은 라이선스를 사용한다는 뜻은 아닙니다. 특정 구성 요소를 확인할 때는 그래픽 클라이언트 코드, 코어 코드, 규칙 데이터, 배포 파일을 구분해야 하며 각각 저작권 고지와 재배포 조건이 다를 수 있습니다. 일반 사용자는 유지보수 상태, 호환 범위, 설정 이전 안내를 우선 확인하는 것이 좋습니다.

UPDATE 04

업데이트는 클라이언트, 코어, 규칙 데이터로 나뉩니다

클라이언트 업데이트는 주로 화면, 설정 관리, 시스템 통합을 변경합니다. 코어 업데이트는 프로토콜 지원, 필드 해석, 실행 방식에 영향을 줄 수 있으며, geosite와 geoip 같은 규칙 데이터 업데이트는 분류 매칭 결과를 바꿉니다. 이 세 종류를 하나의 작업으로 혼동해서는 안 됩니다. 업데이트 후 차이가 생기면 어느 계층을 변경했는지 기록하고, 원본 설정에 수정되었거나 더 이상 사용하지 않는 필드가 포함되어 있는지 확인하세요.

자주 묻는 질문

먼저 문제가 발생한 계층을 확인하세요

대부분의 문제는 구독, 코어, 시스템 프록시, DNS, 라우팅의 다섯 계층으로 나누어 볼 수 있습니다. 아래에는 홈페이지에서 가장 자주 확인하는 항목을 정리했으며, 자세한 필드는 용어집과 설정 참고 문서에서 확인할 수 있습니다.

구독 업데이트에 실패하면 무엇부터 확인하나요?

먼저 링크의 앞뒤가 완전하고 공백이 없는지 확인한 뒤 클라이언트가 표시한 오류 메시지를 살펴보세요. 구독 주소에 접근할 수 없다면 라우팅을 바꾸거나 반복해서 가져와도 근본 원인은 해결되지 않습니다.

구독 관련 용어 보기 →

시스템 프록시를 켜도 일부 앱이 직접 연결되나요?

일부 앱은 시스템 프록시 설정을 읽지 않으며, 다른 앱은 별도의 프록시나 직접 연결 네트워크 스택을 사용할 수 있습니다. 먼저 앱의 동작 방식을 확인한 다음 클라이언트의 로컬 수신 포트를 점검하세요.

연결 확인 절차 보기 →

규칙 모드와 전역 모드는 어떻게 다른가요?

규칙 모드는 도메인, IP, 포트 등의 조건에 따라 출구를 선택하고, 전역 모드는 일반적으로 더 넓은 범위의 연결을 하나의 출구로 전달합니다. 문제를 확인할 때 두 모드를 잠시 비교하면 원인이 라우팅 규칙에 있는지 판단하는 데 도움이 됩니다.

라우팅 및 트래픽 분기 용어 보기 →

DNS를 수정한 뒤 코어를 다시 시작해야 하는 이유는 무엇인가요?

실행 중인 코어는 현재 설정을 이미 불러온 상태이므로 파일을 저장해도 DNS 구성 요소가 자동으로 다시 만들어진다는 보장은 없습니다. 다시 시작하면 새 서버, 도메인 조건, 조회 순서가 모두 적용됩니다.

DNS 설정 필드 보기 →
문서 업데이트

최근 설정 및 문제 해결 문서

문서에서는 구체적인 오류 현상과 설정 필드를 다룹니다. 각 문서는 하나의 명확한 주제만 다루므로 클라이언트 알림, 시스템 현상, 설정 구간 이름으로 필요한 내용을 바로 찾을 수 있습니다.

전체 문서 보기