Project V 그래픽 클라이언트 및 한국어 설정 문서

V2Ray 프록시 클라이언트: v2rayN 및 v2rayNG

v2rayN 다운로드 설정 가이드 보기

클라이언트 선택, 구독 가져오기, 라우팅의 전체 과정을 정리하고 데스크톱 운영체제와 Android를 다룹니다. 설정 설명은 v2rayN, v2rayNG, v2flyNG의 실제 항목을 기준으로 합니다.

영구 무료 오픈 소스 Xray 및 V2Fly 코어 한국어 설정 문서
클라이언트 설정 주제

구독, 라우팅, TUN 및 DNS

설정 항목을 실제 사용 순서에 따라 나누어 설명합니다. 먼저 구독과 노드를 정리하고, 트래픽을 가로챌 범위를 정한 다음 라우팅과 DNS 정책을 설정하면 여러 설정을 동시에 바꾼 뒤 문제를 찾기 어려워지는 일을 줄일 수 있습니다.

01 / SUBSCRIPTION

여러 구독 그룹과 노드 필터링

구독 그룹은 여러 출처의 노드가 섞여 관리하기 어려운 문제를 해결합니다. v2rayN에서는 서로 다른 구독과 직접 만든 설정을 별도 그룹에 넣고 지정한 출처만 업데이트할 수 있으며, v2rayNG는 모바일에서 자주 쓰는 설정 몇 개를 관리하는 데 적합합니다. 가져온 뒤에는 그룹 이름, 업데이트 시간, 프로토콜 항목을 먼저 확인하고 별칭이나 주소로 필터링하세요. ‘구독 업데이트’와 ‘현재 노드 전환’은 서로 다른 작업입니다.

실제로는 ‘일상 사용’, ‘임시 테스트’, ‘직접 만든 설정’처럼 의미가 분명한 그룹을 유지하는 것이 좋습니다. 구독을 삭제하기 전 현재 연결에서 해당 설정을 참조하는지 확인하세요. 필터는 목록 표시 범위만 바꾸며 구독 원본을 수정하지 않습니다. 특정 유형의 노드를 계속 제외하려면 클라이언트의 서버 필터 규칙에 키워드를 설정해야 합니다.

구독 관리 안내 보기 →
구독 그룹 현재 그룹 업데이트
A 일상 사용자동 업데이트 켜짐 현재
T 임시 테스트수동 업데이트 ···
L 직접 만든 설정로컬 관리 ···
서버 필터: 별칭 또는 주소 입력
운영체제별 선택

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

데스크톱에서는 v2rayN을 기본 클라이언트로 사용하고, Android에서는 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 다운로드 페이지에서 시스템 아키텍처와 설치 형식을 계속 구분해 안내합니다.

Windows

v2rayN 데스크톱 버전 또는 클래식 WPF 버전을 선택하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 Windows 방식에 익숙한 사용자에게 적합합니다. 두 버전 모두 구독, 시스템 프록시, 라우팅 규칙, TUN 모드를 지원합니다.

다운로드로 이동

macOS

v2rayN 데스크톱 클라이언트를 사용하고 프로세서에 맞춰 Apple Silicon 또는 Intel 설치 파일을 선택하세요. 처음 실행할 때 시스템 보안 확인과 네트워크 권한 승인이 필요하며, 이후 구독을 가져와 시스템 프록시를 활성화하면 됩니다.

다운로드로 이동

Android

Xray 코어가 탑재된 v2rayNG를 우선 선택하세요. V2Fly 코어가 필요하면 v2flyNG를 사용할 수 있습니다. 최신 기기는 대체로 arm64 아키텍처를 사용하며, 아키텍처를 확인할 수 없을 때는 범용 설치 파일을 선택하세요. 두 클라이언트의 구독 사용 방법은 비슷합니다.

다운로드로 이동

Linux

v2rayN은 주요 Linux 배포판에 맞는 패키지를 제공합니다. 시스템의 패키지 관리 방식에 따라 deb 또는 rpm을 선택하고, 프로세서 아키텍처에 맞춰 x64와 arm64를 구분하세요. 설치 후 다른 데스크톱 플랫폼과 비슷한 구독 및 라우팅 화면을 사용할 수 있습니다.

다운로드로 이동
전체 클라이언트 보기 →
오픈 소스 생태계 관계

Project V, V2Fly, Xray 및 그래픽 클라이언트

클라이언트 이름, 코어 이름, 프로토콜 이름은 서로 다른 계층에 속합니다. 관계를 이해해야 소프트웨어를 선택하고 설정을 읽으며 로그를 점검할 때 문제 위치를 정확히 파악할 수 있습니다.

PROJECT V

Project V는 생태계의 출발점

Project V는 조합 가능한 네트워크 프록시 기능을 중심으로 오픈 소스 생태계를 형성했습니다. 일반적인 설정의 인바운드, 아웃바운드, 라우팅, DNS, 전송 방식과 프로토콜 매개변수는 모두 이 모듈형 설계에서 비롯됩니다. 사용자가 일상적으로 조작하는 것은 그래픽 클라이언트지만 연결, 프로토콜, 라우팅을 실제로 처리하는 것은 클라이언트가 호출하는 코어입니다. 따라서 같은 구독이 여러 클라이언트에서 비슷한 항목으로 표시될 수 있지만, 코어 기능과 클라이언트 적용 수준에 따라 설정이 달라질 수도 있습니다.

가이드를 읽을 때는 먼저 문제가 어느 계층에서 발생했는지 구분해야 합니다. 구독을 추가할 수 없다면 클라이언트 입력이나 구독 형식 문제일 가능성이 높고, 프로토콜 매개변수를 인식하지 못하면 코어 지원 여부를 확인해야 합니다. 시스템 프록시가 대상 앱에 영향을 주지 않으면 운영체제의 프록시 메커니즘을 점검하고, 라우팅 결과가 예상과 다르면 규칙 순서, 도메인 해석, 아웃바운드 태그를 확인하세요. 무작정 재설치하는 것보다 계층별 점검이 효과적입니다.

CORE FAMILIES

V2Fly와 Xray는 두 코어 계열

V2Fly 커뮤니티는 V2Ray의 핵심 기능을 이어받아 유지 관리하며, 설정 구조는 모듈 조합과 호환성 있는 발전을 중시합니다. Xray는 유사한 설정 체계를 바탕으로 자체 코어 구현과 기능 확장을 발전시켰습니다. 둘 다 그래픽 클라이언트가 아니며 특정 프로토콜과 같은 개념도 아닙니다. 인바운드 리스닝, 아웃바운드 연결, 규칙 매칭, DNS 질의, 전송 매개변수 실행을 담당합니다.

기본 설정의 상당 부분은 두 코어 계열 사이에서 대응해 이해할 수 있지만, 구체적인 항목과 지원 범위, 기본 동작은 현재 클라이언트에 통합된 코어를 기준으로 해야 합니다. 다른 클라이언트의 설정을 복사할 때는 프로토콜 이름만 같다고 판단하지 말고 전송 방식, 보안 매개변수, 서버 이름, 경로, 지문 옵션, 라우팅 태그가 모두 갖춰졌는지 확인하세요.

CLIENT LAYER

세 클라이언트는 서로 다른 플랫폼 진입점

v2rayN은 Windows·macOS·Linux를 지원하는 주요 데스크톱 클라이언트로, 구독 그룹, 서버 필터, 시스템 프록시, 라우팅 규칙, DNS, TUN, 로그 확인 등의 그래픽 설정을 제공합니다. v2rayNG는 Android용이며 일반적으로 Xray 코어를 탑재해 구독이나 공유 링크로 모바일 연결을 관리하는 데 적합합니다. v2flyNG 역시 Android용이지만 V2Fly 코어를 내장한 점이 다르며, 해당 코어 계열이 필요할 때의 대안으로 사용할 수 있습니다.

세 소프트웨어 모두 개방적인 커뮤니티 협업 방식으로 지속 관리되며 코드와 변경 기록을 검토할 수 있습니다. 클라이언트와 코어의 릴리스 주기는 완전히 일치하지 않습니다. 코어에 기능이 추가된 뒤에도 그래픽 인터페이스에서 매개변수 매핑, 상호작용 설계, 플랫폼 테스트가 필요합니다. 선택할 때는 이름의 유사성보다 플랫폼, 코어, 필요한 기능을 기준으로 판단하세요.

OPEN SOURCE

오픈 소스 라이선스로 사용 및 재배포 범위 확인

오픈 소스 소프트웨어는 라이선스를 통해 코드의 사용, 수정, 재배포 조건을 정합니다. 일반 사용자에게 라이선스는 소프트웨어 출처가 투명하고 협업 범위가 명확하다는 점을 먼저 보여줍니다. 추가 개발이나 기업 배포가 필요한 팀은 해당 프로젝트의 구체적인 라이선스 전문을 확인하고 배포 방식이 조건을 충족하는지 검토해야 합니다. 클라이언트와 의존 구성 요소마다 라이선스가 다를 수 있으므로 한 구성 요소의 조항을 전체 소프트웨어 스택에 그대로 적용해서는 안 됩니다.

오픈 소스라는 사실이 설정 검토를 대신해 주지는 않습니다. 구독을 가져오기 전 출처와 용도를 확인하고, 연결 후 로그에서 실제로 사용된 인바운드·아웃바운드·라우팅 규칙을 점검하세요. 시스템 네트워크 권한이 필요한 경우 운영체제 안내에 따라 프록시 또는 가상 네트워크 설정에 필요한 범위만 허용하면 됩니다.

UPDATE FLOW

업데이트는 클라이언트·코어·구독으로 나뉩니다

클라이언트 업데이트는 주로 인터페이스, 플랫폼 호환성, 기능 진입점을 바꿉니다. 코어 업데이트는 프로토콜 구현, 라우팅, DNS 같은 하위 기능에 영향을 주며, 구독 업데이트는 서버 설정을 교체하거나 추가합니다. 세 가지는 서로 관련되어 있지만 같은 작업은 아닙니다. 구독이 업데이트되지 않으면 주소, 네트워크, 구독 그룹을 먼저 확인하고, 코어가 시작되지 않으면 로그와 설정 항목을 점검하세요. 클라이언트 인터페이스에 문제가 있을 때 소프트웨어 업데이트나 설정 이전을 고려합니다.

업데이트 전 현재 라우팅 모드, DNS 정책, TUN 상태를 기록해 두면 동작이 바뀌었을 때 빠르게 비교할 수 있습니다. 여러 구독을 사용하는 경우 그룹별로 업데이트하며 결과를 확인하세요. 클라이언트, 코어, 모든 구독을 한꺼번에 바꾸면 문제를 추적할 기준을 잃을 수 있습니다. 고급 설정 장에서는 사용자 지정 아웃바운드, FakeDNS, 여러 구독 필터링 방법도 정리합니다.

고급 설정 매뉴얼 보기 →
기술 노트

설정 및 문제 해결 문서

DNS 라우팅, 연결 속도, 데스크톱 운영체제 권한을 중심으로 다룹니다. 각 문서는 문제 계층에 따른 점검 순서를 제시해 판단 근거 없이 여러 설정을 동시에 바꾸는 일을 줄입니다.

고급 설정

V2Ray DNS 라우팅 설정 자세히 알아보기: 중국 본토와 해외 도메인의 분리 조회 및 오염 방지

DNS 서버 그룹과 질의 정책부터 라우팅 연동까지, 도메인별로 알맞은 해석 경로를 사용하게 하는 방법과 캐시 삭제 및 적용 확인 절차를 설명합니다.

문서 읽기 →
문제 해결

V2Ray 속도 저하 단계별 점검법: 노드·회선·로컬 설정을 차례로 확인

속도 문제를 노드 상태, 회선 및 시간대, 로컬 설정의 세 계층으로 나누고 라우팅·DNS·TUN·대상 앱을 순서대로 점검해 불필요한 반복 전환을 줄입니다.

문서 읽기 →
플랫폼 가이드

macOS에서 v2rayN 설치 시 개발자를 확인할 수 없음: 보안 권한 및 네트워크 승인 절차

시스템 설정 경로에 따라 처음 실행 제한을 처리한 뒤 네트워크 권한 승인, 시스템 프록시 확인, 클라이언트 연결 점검을 진행해 설치 문제와 설정 문제를 구분합니다.

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