그래픽 클라이언트 및 한국어 설정 자료

V2Ray 그래픽 클라이언트: v2rayN 및 v2rayNG

그래픽 클라이언트 다운로드, 구독 가져오기, 라우팅 규칙 설정을 한곳에 정리했습니다. 먼저 기기에 맞는 클라이언트를 선택한 뒤 가이드에 따라 코어, 시스템 프록시와 규칙을 설정하세요.

평생 무료 오픈 소스 Xray · V2Fly 한국어 문서

// PLATFORM DOWNLOADS

기기에 맞는 그래픽 클라이언트 선택

데스크톱에서는 v2rayN을 주로 사용하고, Android에서는 코어 요구사항에 따라 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 플랫폼별 링크를 누르면 해당 다운로드 항목으로 바로 이동합니다.

전체 클라이언트 보기 →

DESKTOP / WINDOWS

Windows

v2rayN 데스크톱 버전 또는 클래식 WPF 버전을 선택하세요. 데스크톱 버전은 크로스플랫폼 인터페이스를 사용하고, WPF 버전은 기존 사용 방식에 익숙한 사용자에게 적합합니다. 두 버전 모두 구독, 시스템 프록시, 라우팅 규칙과 코어 설정을 관리할 수 있습니다.

다운로드 페이지로 이동

DESKTOP / MACOS

macOS

v2rayN 데스크톱 빌드를 사용하세요. 다운로드 전에 시스템 정보에서 Apple Silicon인지 Intel 프로세서인지 확인하고, 설치 후에는 네트워크 사용 범위에 따라 시스템 프록시를 켤지 결정하세요.

다운로드 페이지로 이동

MOBILE / ANDROID

Android

Xray 코어를 사용하는 v2rayNG를 우선 선택하세요. V2Fly 코어가 필요하면 v2flyNG를 사용할 수 있습니다. 최근 출시된 대부분의 기기는 arm64 빌드가 적합하며, 아키텍처를 확인하기 어려울 때만 범용 빌드를 고려하세요.

다운로드 페이지로 이동

DESKTOP / LINUX

Linux

v2rayN은 주요 패키지 형식에 맞춘 데스크톱 빌드를 제공합니다. 먼저 배포판이 deb인지 rpm인지 확인한 다음 x64와 arm64 아키텍처를 구분하세요. 설치 후에는 그래픽 인터페이스에서 구독과 라우팅을 관리할 수 있습니다.

다운로드 페이지로 이동

// CLIENT WORKFLOW

구독 가져오기부터 규칙 적용까지, 설정 흐름에 따라 처리

그래픽 클라이언트는 조작을 위한 진입점일 뿐입니다. 연결이 예상대로 작동하려면 구독 내용, 활성 설정, 시스템 프록시, 라우팅 규칙과 DNS 설정이 하나의 흐름으로 맞물려야 합니다.

STEP 01 / IMPORT

구독 가져오기 및 업데이트

구독 그룹에 주소를 추가하고 직접 한 번 업데이트한 뒤 설정 목록에 항목이 표시되는지 확인하세요. 가져오기에 실패하면 링크 형식, 전체 복사 여부와 네트워크 연결 가능성을 먼저 점검하세요.

STEP 02 / ACTIVATE

활성 설정 선택

가져오기에 성공했다고 바로 활성화된 것은 아닙니다. 데스크톱에서는 대상 설정을 활성 항목으로 지정하고, Android에서는 설정을 선택해 연결을 시작한 뒤 상태 표시를 확인하세요.

STEP 03 / ROUTE

프록시 및 분할 라우팅 범위 결정

먼저 일상 사용에 적합한 라우팅 모드를 선택한 다음 도메인, IP와 geosite 항목에 필요한 규칙을 추가하세요. 처음부터 검증하기 어려운 사용자 지정 조건을 많이 쌓지 않는 것이 좋습니다.

// SUBSCRIPTION GROUP

구독 주소·그룹·업데이트는 서로 다른 기능입니다

구독 주소는 설정 묶음을 제공하고, 그룹은 출처가 다른 설정을 정리하며, 업데이트는 원격 내용을 클라이언트에 반영합니다. 주소만 저장하고 업데이트하지 않았거나, 업데이트 후에도 이전 활성 설정을 그대로 사용하는 경우가 흔합니다. 출처별로 독립적인 그룹을 만들고, 업데이트 후 추가·삭제·이름 변경된 설정을 확인한 다음 현재 사용할 항목을 직접 선택하는 방법이 안정적입니다. 긴 설정을 직접 편집하는 것보다 그래픽 클라이언트에서는 출처, 업데이트 시간과 활성 항목이 분리되어 보여 문제를 더 쉽게 추적할 수 있습니다.

구독 그룹일상 설정
업데이트 방식수동 업데이트
활성 설정선택됨

// ROUTING RULES

V2Ray 라우팅 규칙: 매칭 대상과 출구 동작을 나누어 보기

라우팅 설정은 단순한 도메인 목록이 아닙니다. 클라이언트는 규칙 순서에 따라 도메인, IP, 포트 또는 프로토콜 조건을 확인하고, 일치하면 지정된 출구로 넘깁니다. 직접 연결은 로컬 네트워크와 프록시가 필요하지 않은 대상에 적합하고, 프록시 출구는 전달이 필요한 트래픽을 처리하며, 차단 출구는 명확히 거부할 범주에 사용합니다. 이 세 가지 동작을 이해하면 규칙 텍스트도 훨씬 직관적으로 읽을 수 있습니다.

사용자 지정 규칙은 한 줄에 한 가지 문제만 해결하도록 만들고, 프리셋 규칙보다 앞에 있는지 뒤에 있는지 기록하는 것이 좋습니다. 같은 대상이 여러 조건에 동시에 걸리면 규칙 수보다 순서가 더 중요할 때가 많습니다. domain, ip, geosite 작성법과 매칭 우선순위을 더 읽어본 뒤 클라이언트 프리셋을 덮어쓸지 결정하세요.

로컬 네트워크 주소ip:private → direct
중국 본토 주요 도메인geosite:cn → direct
광고 범주category-ads-all → block
그 외 요청final → proxy

// PROTOCOL CHOICE

프로토콜, 전송 방식과 보안 계층을 하나로 보지 마세요

VMess, VLESS, Trojan과 Shadowsocks는 서로 다른 프로토콜 방식이고, TCP, WebSocket, gRPC 등은 전송 계층 선택입니다. TLS와 REALITY 같은 설정은 별도의 핸드셰이크 및 보안 역할을 담당합니다. 구독에는 보통 완성된 조합이 들어 있으므로 처음 사용할 때 어느 한 항목만 임의로 분리해 바꾸면 주소에는 연결되지만 핸드셰이크가 실패할 수 있습니다.

클라이언트의 “프로토콜 유형”은 설정 진입점 중 하나일 뿐입니다. 실제로 문제를 해결할 때는 서버 주소, 포트, 사용자 식별자, 전송 매개변수, 서버 이름과 시간 설정도 함께 확인해야 합니다. 각 방식의 설계상 차이는 프로토콜 및 코어 기술 참고서에서 확인하고, 이름만 비교하지 말고 호환성·리소스 사용량·사용 환경을 기준으로 선택하세요.

프로토콜VLESS
전송TCP
보안 계층REALITY
코어 지원Xray

// DNS SETTINGS

DNS 설정은 라우팅 대상과 일치해야 합니다

도메인 요청은 먼저 조회된 뒤 라우팅 규칙에 따라 출구가 결정됩니다. 조회 결과가 예상 출구와 다르면 도메인 규칙은 적용되지만 실제 연결 경로가 어긋나거나, 일부 웹사이트만 간헐적으로 열리거나, 시스템과 클라이언트가 서로 다른 결과를 받을 수 있습니다. 문제를 해결할 때는 시스템 DNS, 클라이언트 내장 DNS와 원격 조회를 구분하고, 기본 연결을 확인하기 전에는 여러 복잡한 정책을 동시에 사용하지 마세요.

보다 명확한 점검 방법은 먼저 클라이언트 기본 DNS로 연결을 확인한 다음, 대상 도메인이 어느 계층에서 조회되는지와 결과가 예상 규칙에 들어가는지를 살펴보는 것입니다. 조회 경로에 문제가 있다고 의심되면 DNS 누출 검사 및 설정 실전 가이드를 참고해 수정 후 다시 테스트하세요. 페이지가 열리는지만으로 판단해서는 안 됩니다.

시스템 조회기본 네트워크
클라이언트 DNS규칙에 따라 처리
도메인 정책라우팅 매칭
변경 후다시 확인

// OPEN SOURCE ECOSYSTEM

Project V, V2Fly와 Xray의 계보 관계

그래픽 클라이언트, 프록시 코어와 프로토콜 설정은 서로 다른 계층에 속합니다. 각 이름을 제자리에 놓고 보면 선택과 문제 해결이 더 정확해집니다.

Project V: 프로토콜 도구와 설정 체계의 출발점

Project V는 설정을 중심으로 작동하는 프록시 도구 체계를 구축했습니다. 중요한 영향은 특정 실행 파일 하나에만 있지 않고 인바운드, 아웃바운드, 라우팅, 전송과 DNS를 모듈화한 개념을 세웠다는 데 있습니다. 그래픽 클라이언트에서 보는 프로토콜 유형, 라우팅 출구, 규칙 대상과 로그 옵션 대부분은 이러한 하위 기능을 조작하는 것입니다. 그래픽 인터페이스는 구조화된 설정 편집의 진입 장벽을 낮추지만, 설정의 의미는 여전히 코어가 결정합니다.

따라서 기능 차이가 생기면 먼저 문제가 클라이언트 인터페이스에 속하는지 코어 지원에 속하는지 판단해야 합니다. 버튼 위치가 달라진 것은 클라이언트 계층의 문제이고, 특정 프로토콜이나 전송을 사용할 수 있는지는 주로 코어와 설정 형식에 달려 있습니다. 두 계층을 섞으면 “인터페이스에 진입점이 없다”를 “코어가 지원하지 않는다”로 오해하기 쉽고, 구독 필드 누락을 프로그램 오류로 잘못 판단할 수도 있습니다.

V2Fly: V2Ray 설정과 커뮤니티 유지보수의 계승

V2Fly는 V2Ray 코어의 커뮤니티 유지보수 방향을 이어가며 모듈식 설정 구조를 유지하고, 프로토콜 구현, 전송 구성 요소, 라우팅 데이터와 호환성 문제를 계속 다룹니다. V2Ray의 기존 설정 의미를 사용하고 범용 호환성 및 기존 설정 이전을 중시하는 환경에 적합합니다. Android의 v2flyNG는 V2Fly 코어를 주요 선택지로 제공해 모바일 사용자가 익숙한 그래픽 진입점에서 이 코어 계열을 사용할 수 있게 합니다.

코어 업데이트는 필드 검증, 기본 동작 또는 리소스 파일을 변경할 수 있습니다. 그래픽 클라이언트가 보통 이에 맞춰 업데이트되더라도 구독 제공자와 클라이언트의 업데이트 주기가 항상 일치하는 것은 아닙니다. 업데이트 후 사용할 수 없다면 먼저 오류가 가리키는 설정 필드를 확인하고, 이전 설정과의 호환성 문제인지 클라이언트 생성 로직인지 코어 동작 변화인지 판단하세요. 모든 설정을 바로 교체하는 것은 바람직하지 않습니다.

Xray: 프로토콜 기능 확장과 독립적인 발전

Xray는 유사한 설정 기반에서 독립적인 코어 노선으로 발전했으며 VLESS, XTLS와 REALITY 설정에서 자주 사용됩니다. v2rayN과 v2rayNG는 모두 Xray를 중심으로 그래픽 관리를 제공해 구독, 코어 시작, 시스템 프록시와 라우팅 설정을 한 화면에서 처리할 수 있습니다. Xray와 V2Fly는 일부 설정 구조가 비슷하지만, 모든 필드와 프로토콜 조합 및 기본값을 그대로 서로 바꿔 쓸 수 있다고 가정해서는 안 됩니다.

코어를 선택할 때는 구독 설정에 명시된 요구사항과 클라이언트 지원 범위를 우선 기준으로 삼으세요. 특정 코어 전용 기능이 포함된 설정이라면 클라이언트, 코어와 규칙 리소스의 대응 관계를 유지해야 합니다. 일반적인 프로토콜만 사용한다면 안정성, 플랫폼 호환성과 설정 가독성을 더 중요하게 보는 것이 좋습니다. 자세한 차이는 프로토콜 상세 안내에서 프로토콜, 리소스 사용량과 호환성을 기준으로 비교할 수 있습니다.

오픈 소스 라이선스와 업데이트 방식: 구성 요소의 경계를 확인하세요

V2Fly, Xray와 세 가지 그래픽 클라이언트는 모두 공개 코드와 라이선스 조건을 바탕으로 유지보수되지만, 프로젝트마다 적용하는 라이선스 유형은 완전히 같지 않습니다. 공개 라이선스는 복사, 수정과 재배포 시 따라야 할 조건을 명시하고 프로토콜 구현 및 설정 처리 로직을 커뮤니티가 검토할 수 있게 합니다. 일반 사용자에게 더 실질적인 가치는 문제를 보이지 않는 하나의 통합 프로그램이 아니라 명확한 구성 요소 단위로 추적할 수 있다는 점입니다.

업데이트는 보통 클라이언트 인터페이스, 프록시 코어, 라우팅 리소스와 구독 콘텐츠의 네 갈래로 나뉩니다. 클라이언트 업데이트가 코어를 함께 바꾸는 것은 아니며, 구독 업데이트도 로컬 프로그램을 자동으로 교체하지 않습니다. 다운로드 페이지는 플랫폼별 빌드를 구분하고 가이드는 작업 순서를 설명합니다. 실제 유지보수에서는 한 번에 한 계층만 업데이트하고 기존 설정을 보존해야 호환성 문제가 생겼을 때 변경 원인을 빠르게 판단할 수 있습니다.

// V2RAYN

데스크톱 통합 진입점

v2rayN은 구독 관리, 코어 전환, 시스템 프록시, 라우팅 규칙과 로그 확인을 그래픽 인터페이스에 통합합니다. 크로스플랫폼 데스크톱 빌드와 클래식 Windows 인터페이스를 함께 제공하므로 시스템 환경과 사용 습관에 맞춰 선택할 수 있습니다.

// V2RAYNG

Android와 Xray 코어

v2rayNG는 Android에서 널리 사용되는 V2Ray 그래픽 클라이언트로, Xray 코어를 통해 다양한 구독 설정을 지원합니다. 모바일에서는 설정 가져오기, 연결 권한 부여, 활성 항목 선택과 앱별 규칙 관리가 중요합니다.

// V2FLYNG

Android용 V2Fly 선택지

v2flyNG는 V2Fly 코어가 필요한 Android 환경을 위한 클라이언트이며, 기본 조작 흐름은 일반적인 모바일 그래픽 클라이언트와 비슷합니다. 선택하기 전에 구독 필드가 대상 코어와 호환되는지 확인하고, 이름만 보고 클라이언트를 바꾸지 마세요.

// QUICK ANSWERS

자주 묻는 질문: 먼저 설정 흐름을 확인하세요

대부분의 문제는 처음부터 재설치할 필요가 없습니다. 구독, 활성 설정, 코어, 포트, 시스템 프록시, 라우팅과 DNS 순서로 확인하면 더 빠르게 원인을 찾을 수 있습니다.

구독을 가져온 뒤 설정이 보이지 않는 이유는 무엇인가요?

주소를 추가한 뒤 구독 업데이트를 실행하고, 내용이 올바른 그룹에 저장되었는지 확인해야 합니다. 업데이트 결과가 비어 있다면 링크가 완전한지, 만료되지 않았는지, 클라이언트가 구독 주소에 접근할 수 있는지 먼저 확인하세요. 구독 가져오기 단계를 확인하세요.

클라이언트가 실행 중인데 브라우저가 연결되지 않나요?

먼저 대상 설정이 활성 항목으로 지정되었는지 확인한 다음 시스템 프록시가 켜져 있는지와 로컬 포트가 사용 중인지 점검하세요. 일부 프로그램은 별도의 프록시 설정을 사용하므로 주소와 포트도 확인해야 합니다. 연결 문제 분류를 확인하세요.

라우팅 모드는 글로벌과 분할 라우팅 중 무엇을 선택해야 하나요?

기본 연결을 점검할 때는 범위가 명확한 모드로 비교해 보세요. 일상적으로는 프리셋 분할 라우팅 규칙부터 시작하는 것이 일반적입니다. 정상 작동을 확인한 뒤 사용자 지정 규칙을 하나씩 추가하고 각 규칙의 출구 동작을 관찰하세요.

REALITY 설정에는 어떤 코어가 필요한가요?

REALITY는 Xray 관련 설정에서 자주 사용됩니다. 프로토콜 유형뿐 아니라 서버 이름, 공개 키, 짧은 ID와 지문 등의 필드가 서버 측과 일치해야 합니다. 프로토콜 참고서에서 설정 계층과 선택 기준을 확인하세요.