그래픽 클라이언트 설정 문서 플랫폼별 정리

V2Ray 튜토리얼 V2Ray 설정과 클라이언트 시작하기

v2rayN 다운로드 가이드 보기

v2rayN, v2rayNG, v2flyNG의 다운로드 선택과 설정 절차를 한곳에 정리하고, 구독 가져오기·시스템 프록시부터 라우팅 분할 및 TUN 모드까지 자주 쓰는 기능을 다룹니다.

영구 무료 오픈 소스 한국어 문서 그래픽 인터페이스

플랫폼별 바로가기

구독 자동 업데이트 사용 설정됨

시스템 프록시 설정 사용 설정됨

라우팅 사용 규칙 적용 중

TUN 모드 사용 대기

PLATFORMWindows · macOS · Android · Linux
CLIENTv2rayN · v2rayNG · v2flyNG
COREXray · V2Fly
DOCUMENT다운로드 · 설정 · 라우팅 · 문제 해결

설정 기능

클라이언트 선택부터 트래픽 가로채기까지

일상적인 설정에서 가장 헷갈리기 쉬운 단계를 여섯 개의 장으로 나눴습니다. 주제를 선택하면 용도, 적용 범위와 판단 방법을 확인할 수 있으며, 서로 다른 수준의 설정을 한 단계에 섞지 않습니다.

클라이언트 선택

먼저 운영체제에 맞는 그래픽 클라이언트 선택

데스크톱에서는 주로 v2rayN을 사용합니다. Windows·macOS·Linux를 지원하며 구독, 라우팅, 시스템 프록시와 TUN을 한곳에서 설정할 수 있습니다. Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 고려하고, V2Fly 코어가 필요하면 v2flyNG를 선택할 수 있습니다. 세 클라이언트는 화면 구성과 코어의 특성은 다르지만 구독 가져오기, 설정 선택, 연결 시작이라는 기본 흐름은 비슷합니다. 선택할 때는 화면 모양보다 플랫폼과 코어 요구 사항을 먼저 확인하세요.

플랫폼별 바로가기

기기에 맞는 V2Ray 클라이언트 선택

다운로드 페이지에서는 운영체제별 설치 경로와 아키텍처 정보를 제공합니다. 홈페이지는 플랫폼 안내만 담당하고 설치 파일 경로를 직접 제시하지 않으므로, 시스템과 프로세서 유형을 확인하기 전에 잘못된 빌드를 고르는 일을 줄일 수 있습니다.

Windows

v2rayN 사용. 다운로드 페이지에서 차세대 데스크톱 인터페이스와 클래식 WPF 인터페이스 중 하나를 선택할 수 있으며, 시스템 프록시·구독 관리·라우팅·TUN 설정이 필요한 데스크톱 환경에 적합합니다.

다운로드로 이동

macOS

v2rayN 사용. 다운로드 페이지에 들어간 뒤 기기 프로세서에 따라 Apple Silicon 또는 Intel 빌드를 선택하세요. 설치 후 구독과 라우팅 방식은 다른 데스크톱 플랫폼과 동일합니다.

다운로드로 이동

Android

Xray 코어를 사용하는 v2rayNG를 우선 선택하고, 코어 요구 사항에 따라 v2flyNG를 사용할 수도 있습니다. 대부분의 최신 기기에는 arm64 빌드가 적합하며, 아키텍처를 확인하기 어렵다면 범용 빌드 안내를 확인하세요.

다운로드로 이동

Linux

v2rayN 사용. 다운로드 페이지에서 일반적인 패키지 형식별 데스크톱 빌드를 제공하고 x64와 arm64 경로를 따로 안내합니다. 선택하기 전에 배포판의 패키지 형식과 프로세서 아키텍처를 확인하세요.

다운로드로 이동

모든 클라이언트 보기 →

빠른 시작

세 단계로 기본 연결 완료

먼저 최소한으로 작동하는 설정을 만든 뒤 라우팅, DNS와 TUN을 다루세요. 기본 연결과 고급 설정을 나누어 검증하면 여러 변수가 동시에 바뀌어 잘못 판단하는 일을 줄일 수 있습니다.

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

클라이언트의 구독 관리에서 구독 주소를 추가하고 저장한 뒤 업데이트를 실행하세요. 단일 공유 링크를 받은 경우에는 클립보드 가져오기 기능을 사용합니다. 가져오기가 끝나면 목록에 프로토콜, 주소, 포트 같은 기본 정보가 표시되는지 먼저 확인하세요. 구독 이름에는 출처나 용도를 적어 두면 기본 이름이 여러 개 쌓여 어떤 항목을 업데이트해야 하는지 모르는 일을 피할 수 있습니다. 이 단계에서는 설정이 클라이언트에 들어왔는지만 확인하고 라우팅 템플릿이나 DNS 매개변수는 서둘러 수정하지 마세요.
노드 선택 및 프록시 진입점 설정

서버 목록에서 설정 하나를 활성 노드로 선택하고 클라이언트 코어를 시작한 다음, 사용 범위에 맞춰 시스템 프록시를 켜세요. 브라우저처럼 시스템 프록시를 따르는 프로그램은 보통 이 진입점을 바로 사용할 수 있습니다. 앱이 시스템 프록시를 읽지 않는다면 수동 프록시를 지원하는지 먼저 확인하세요. 더 넓은 트래픽을 가로채야 할 때만 TUN 모드로 전환하고, 기본 연결을 확인하기 전에 여러 네트워크 가로채기 도구를 동시에 사용하지 마세요.
결과 확인 및 문제 해결 근거 남기기

검증할 때는 먼저 클라이언트 상태와 로그에 리스닝 실패, 권한 부족 또는 해석 오류가 있는지 확인한 뒤 접속하려는 대상을 실제로 테스트하세요. 일부 앱만 이상하면 해당 앱이 시스템 프록시를 따르는지 비교하고, 모든 도메인이 해석되지 않으면 DNS를 우선 점검하세요. 특정 사이트만 잘못된 출구로 나가면 라우팅 규칙을 확인합니다. 한 번에 설정 하나만 조정하고 변경 전후의 현상을 기록하면 장애 계층을 정확히 찾는 데 도움이 됩니다.

전체 가이드 보기

생태계 관계

Project V·V2Fly·Xray 코어 계열

클라이언트 인터페이스, 프록시 코어와 설정 데이터는 서로 다른 계층입니다. 이 관계를 이해하면 기능의 출처, 프로토콜 호환 범위와 업데이트 영향을 판단하기 쉽습니다.

Project V는 프로토콜 및 설정 체계의 기반을 제공합니다

V2Ray는 보통 Project V 생태계의 프록시 기술과 설정 방식을 가리키는 말로 사용됩니다. 단일 그래픽 프로그램이 아니라 인바운드, 아웃바운드, 전송, 라우팅과 DNS를 중심으로 구성된 기능 집합입니다. 데스크톱이나 Android 기기에서 보는 v2rayN·v2rayNG·v2flyNG는 그래픽 클라이언트이며, 설정을 해석하고 연결을 처리하는 것은 클라이언트가 호출하는 코어입니다. 두 계층을 구분하면 인터페이스 문제, 코어 문제와 구독 콘텐츠 문제를 각각 판단할 수 있습니다.

V2Fly와 Xray는 널리 사용되는 코어 계열입니다

V2Fly는 Project V와 관련된 구현 및 설정 체계를 이어가고, Xray는 유사한 설정 모델을 바탕으로 자체 기능을 발전시키고 있습니다. 두 코어 모두 인바운드, 아웃바운드, 라우팅, DNS와 다양한 전송 기능을 포함하지만 세부 필드, 프로토콜 확장과 기본 동작은 다를 수 있습니다. 구독 설정을 정상적으로 가져올 수 있는지는 링크 형식뿐 아니라 클라이언트 코어가 해당 필드를 인식하는지에도 달려 있습니다. 호환성 문제가 발생하면 먼저 코어 계열을 확인한 뒤 클라이언트 지원 범위를 대조하세요.

그래픽 클라이언트는 코어 기능을 조작 가능한 화면으로 구성합니다

v2rayN은 데스크톱 플랫폼에서 구독, 서버 목록, 시스템 프록시, 라우팅 규칙, DNS와 TUN 설정을 통합 관리합니다. v2rayNG는 Android용으로 보통 Xray 코어와 함께 작동하며, v2flyNG는 V2Fly 코어 계열을 사용해 다른 코어가 필요한 경우 선택할 수 있습니다. 클라이언트는 서버 설정 자체를 바꾸지 않습니다. 설정을 저장하고 코어가 읽을 수 있는 매개변수를 생성하며 프로세스를 시작하고 실행 상태와 로그를 사용자에게 보여주는 역할을 합니다.

오픈 소스 라이선스는 코드 사용 및 배포 조건을 정합니다

Project V 생태계의 프로젝트들은 각각 자체 오픈 소스 라이선스를 사용합니다. 라이선스는 소스 코드의 사용·수정·재배포 시 지켜야 할 조건을 정하며, 모든 프로젝트가 같은 라이선스를 쓴다고 단순화할 수 없습니다. 사이트는 기능을 설명할 때 프로젝트가 공개한 코드와 문서의 사실을 기준으로 하며, 특정 클라이언트의 라이선스 결론을 모든 코어에 그대로 적용하지 않습니다. 재배포나 통합이 필요하다면 해당 프로젝트에 포함된 라이선스 원문을 확인하세요.

업데이트는 클라이언트·코어·데이터 파일을 함께 확인해야 합니다

클라이언트 업데이트 한 번에 인터페이스 변경, 설정 생성 로직 변화 또는 코어 교체가 포함될 수 있으며, GeoIP·GeoSite 같은 라우팅 데이터도 별도의 업데이트 주기를 가집니다. 따라서 기능 이상을 클라이언트 이름만으로 판단해서는 안 됩니다. 업데이트 후 라우팅 결과가 바뀌었다면 코어, 라우팅 데이터와 기존 규칙이 여전히 맞는지 확인하고, 인터페이스 위치만 바뀌었다면 클라이언트 설정 구조를 먼저 살펴보세요. 기존 설정을 읽을 수 있는 형태로 백업해 두면 모든 설정을 덮어쓰는 것보다 차이를 비교하기 쉽습니다.