CLIENT CONFIGURATION INDEX

V2Ray 설정 가이드: 클라이언트 선택과 구독 설정

v2rayN 다운로드 튜토리얼 보기

클라이언트 다운로드, 구독 가져오기, 라우팅 분할을 중심으로 작업 순서를 정리하고, v2rayN·v2rayNG·v2flyNG의 지원 플랫폼, 코어 차이, 시스템 프록시 설정과 자주 발생하는 연결 문제를 설명합니다.

  • v2rayN 데스크톱 클라이언트
  • v2rayNG Android
  • v2flyNG Android
지원 플랫폼 WINDOWS · MACOS · ANDROID · LINUX
코어 계열 XRAY · V2FLY
클라이언트 V2RAYN · V2RAYNG · V2FLYNG
관리 방식 OPEN SOURCE

PLATFORM DOWNLOAD

운영체제별 다운로드 페이지로 이동

먼저 기기의 플랫폼과 프로세서 아키텍처를 확인한 뒤 알맞은 클라이언트를 선택하세요. 홈 화면의 진입점은 플랫폼별 분류만 제공하며, 설치 패키지 종류와 시스템 요구 사항, 파일 설명은 다운로드 페이지에서 확인할 수 있습니다.

DESKTOP

Windows

Windows 데스크톱에서는 먼저 v2rayN을 확인하세요. 다운로드 페이지에서 차세대 데스크톱 인터페이스와 기존 WPF 인터페이스의 적용 범위를 각각 설명합니다. 기존 설정이 있다면 구독 그룹과 라우팅 설정을 먼저 백업한 뒤 설치 방식을 결정하는 것이 좋습니다.

다운로드 페이지로 이동

DESKTOP

macOS

macOS에서는 v2rayN 데스크톱 클라이언트를 사용합니다. 다운로드 전에 시스템 정보에서 프로세서 유형을 확인해야 하며, Apple Silicon과 Intel은 서로 다른 파일을 사용합니다. 구독을 가져온 뒤의 프록시 모드, 라우팅 규칙과 데스크톱 조작 방식은 다른 플랫폼과 대체로 같습니다.

다운로드 페이지로 이동

MOBILE

Android

Android에서는 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. v2rayNG는 Xray 코어를 사용해 일반적인 Xray 설정에 적합하고, v2flyNG는 v2fly 코어를 사용해 V2Fly 생태계 설정에 대응합니다. 다운로드할 때는 arm64와 범용 빌드도 구분해야 합니다.

다운로드 페이지로 이동

DESKTOP

Linux

Linux 데스크톱에서는 v2rayN을 사용하며, 배포판에 따라 deb 또는 rpm을 선택하고 x64와 arm64 아키텍처도 확인해야 합니다. 설치 후에는 클라이언트 프로세스, 시스템 프록시 상태와 데스크톱 환경의 네트워크 설정을 각각 점검하세요. 코어만 실행되고 애플리케이션 트래픽은 넘겨받지 못하는 상황을 피할 수 있습니다.

다운로드 페이지로 이동

전체 클라이언트 보기 →

CLIENT WORKSTATION

세 클라이언트의 설정 작업 공간

클라이언트 이름은 비슷하지만 플랫폼, 코어 계열과 설정 메뉴가 완전히 같지는 않습니다. 먼저 기기에 맞는 클라이언트를 고른 다음 구독, 노드, 프록시 모드, 라우팅 규칙 순서로 설정하세요.

데스크톱 우선

v2rayN: 데스크톱 구독과 시스템 프록시

v2rayN은 Windows, macOS와 Linux를 지원하며 여러 구독 그룹, 수동 노드와 라우팅 규칙을 한곳에서 관리해야 하는 데스크톱 환경에 적합합니다. 일반적인 순서는 구독 그룹 생성, 서버 목록 업데이트, 실제 연결 테스트, 활성 노드 선택, 적절한 시스템 프록시 모드 활성화입니다. 클라이언트는 Xray 또는 V2Fly 관련 코어 기능을 호출할 수 있지만, 실제 프로토콜 지원 여부는 사용 중인 코어와 설정 내용에 따라 달라집니다. 문제를 점검할 때는 클라이언트 로그, 시스템 프록시와 브라우저 연결을 따로 확인해야 하며, 노드 목록의 단일 상태만으로 판단해서는 안 됩니다.

설정 항목 목록

  • 시스템 프록시 모드
  • 구독 그룹 및 업데이트
  • 실제 연결 테스트
  • 라우팅 규칙 세트
  • 코어 유형 및 로그
코어 계열: Xray / V2Fly 오픈 소스 데스크톱 클라이언트 지원 플랫폼: 3

QUICK START

구독 가져오기부터 연결 확인까지

처음 설정할 때는 고급 옵션을 한꺼번에 많이 바꾸지 마세요. 재현 가능한 기본 연결을 먼저 만든 뒤 라우팅, DNS와 앱별 규칙을 단계적으로 추가해야 문제가 생겼을 때 변경 원인을 정확히 찾을 수 있습니다.

  1. 01

    구독을 가져오고 그룹 확인하기

    전체 V2Ray 구독 링크를 복사해 클라이언트의 구독 그룹 또는 구독 설정에서 새 주소로 추가한 다음 업데이트를 실행하세요. 업데이트가 끝났다고 바로 연결하지 말고, 먼저 서버 목록에 설정이 실제로 나타났는지와 새로 만든 그룹에 들어갔는지를 확인합니다. 목록이 비어 있다면 주소가 완전히 복사되었는지, 네트워크에서 구독 소스에 접근할 수 있는지, 클라이언트 로그에 형식 파싱 오류가 반환되었는지를 순서대로 확인하세요. QR 코드와 단일 노드 링크는 임시 가져오기에 적합하지만, 여러 노드를 장기간 관리할 때는 구독 그룹을 사용하는 편이 업데이트와 출처 구분에 유리합니다.

  2. 02

    노드와 프록시 모드 선택하기

    현재 그룹에서 노드 하나를 활성 설정으로 선택하고, 먼저 실제 연결 테스트를 실행해 전체 핸드셰이크 경로가 만들어지는지 확인하세요. 데스크톱에서는 이어서 시스템 프록시 모드를 설정하고, Android에서는 시스템 연결을 시작합니다. 첫 확인 단계에서는 클라이언트가 제공하는 기본 프록시 모드를 사용하고 복잡한 분할 규칙은 나중으로 미루는 것이 좋습니다. 전역 프록시는 더 많은 트래픽을 프록시 아웃바운드로 보내고, 규칙 모드는 도메인, IP, 포트와 프로세스 등의 조건에 따라 직접 연결 또는 프록시를 선택합니다. 이는 트래픽 선택 전략일 뿐 구독 매개변수 오류나 노드 자체의 접근 불가 문제를 해결해 주지는 않습니다.

  3. 03

    브라우저, 로그와 라우팅 결과 확인하기

    연결을 시작한 뒤 먼저 브라우저로 확실히 접속 가능한 페이지를 열고, 클라이언트 로그에 해당 요청이 기록되는지 확인하세요. 데스크톱에서는 운영체제의 프록시 설정이 실제로 적용되었는지와 클라이언트를 종료했을 때 예상대로 복원되는지도 확인해야 합니다. 일부 웹사이트만 실패한다면 도메인 확인과 라우팅 매칭을 살펴보고, 모든 연결이 시간 초과된다면 노드 주소, 포트, 프로토콜 매개변수와 로컬 네트워크부터 점검하세요. 기본 확인이 끝난 뒤 geosite, geoip, 광고 차단 또는 앱별 규칙을 추가하되, 한 번에 한 그룹의 설정만 바꾸고 변경 전후 로그를 보관하세요.

전체 튜토리얼 보기 →

OPEN SOURCE ECOSYSTEM

Project V, V2Fly와 Xray의 관계

클라이언트는 인터페이스, 구독과 시스템 통합을 담당하고 코어는 프로토콜, 전송, 라우팅과 아웃바운드 처리를 담당합니다. 이 두 계층을 구분하는 것이 클라이언트 차이를 이해하고 설정 문제를 해결하는 기초입니다.

Project V에서 코어 계열로

Project V는 V2Ray 관련 기술과 도구로 형성된 초기 오픈 소스 생태계로, 핵심 설정 모델은 인바운드, 아웃바운드, 라우팅, DNS, 전송과 정책을 중심으로 구성됩니다. 커뮤니티가 발전하면서 V2Fly는 v2ray-core 계열을 이어받아 유지했고, Xray는 비슷한 설정 개념을 바탕으로 별도의 코어 계열로 발전했습니다. 두 계열은 공통 개념이 많지만 프로토콜 지원, 필드 세부 사항, 전송 기능과 기본 동작은 다를 수 있습니다. 따라서 ‘V2Ray 설정’이라는 이름만 보고 판단하지 말고, 클라이언트가 실제로 호출하는 코어와 구독이 생성하는 설정 대상을 확인해야 합니다.

그래픽 클라이언트가 곧 코어를 의미하는 것은 아닙니다. v2rayN은 주로 데스크톱의 구독 관리, 노드 선택, 시스템 프록시, 라우팅 편집, 로그 확인과 코어 호출을 담당하고, v2rayNG와 v2flyNG는 비슷한 기능을 Android의 시스템 연결 흐름에 통합합니다. 연결에 실패했을 때 인터페이스에는 노드가 정상적으로 표시되더라도 코어는 필드 비호환, 인증서 이름 불일치, 전송 매개변수 누락 또는 잘못된 라우팅 태그 때문에 처리를 중단할 수 있습니다. 로그에 기록된 구체적인 단계가 단순한 ‘실행 중’ 상태보다 훨씬 유용한 판단 근거입니다.

오픈 소스 라이선스는 코드의 사용, 수정과 재배포 범위를 정하며, 프로젝트마다 배포 자료에 포함된 해당 라이선스 문서를 기준으로 해야 합니다. 일반 사용자에게 오픈 소스 유지 관리가 중요한 직접적인 이유는 설정 형식, 문제 논의와 변경 기록을 지속적으로 검토할 수 있다는 점입니다. 클라이언트를 선택할 때는 플랫폼, 코어 요구 사항과 설정 출처를 기준으로 판단해야 하며, 비슷한 프로토콜 이름을 사용하는 모든 클라이언트를 완전히 같은 것으로 보아서는 안 됩니다.

업데이트 방식도 계층별로 이해해야 합니다. 클라이언트 업데이트는 인터페이스 기능, 플랫폼 호환과 구독 관리 로직을 담당하고, 코어 업데이트는 프로토콜 구현, 라우팅 기능과 하위 네트워크 처리를 담당합니다. 규칙 데이터 업데이트는 도메인과 IP 분류에 영향을 줍니다. 이 세 가지는 반드시 동시에 배포되지 않습니다. 업데이트 후 기존 설정의 동작이 달라졌다면 클라이언트 설정, 코어 유형, 규칙 출처와 오류 로그를 기록한 뒤 항목별로 비교하세요. 설정을 바로 전부 지우면 문제 해결에 가장 중요한 맥락을 잃게 됩니다.

v2rayN

오픈 소스 데스크톱 클라이언트로, 여러 데스크톱 시스템에서 구독 그룹, 노드 관리, 프록시 모드와 라우팅 설정을 담당합니다. 사용할 때는 인터페이스 버전, 선택한 코어 유형과 시스템 프록시 상태를 함께 확인해야 합니다.

v2rayNG

Xray 코어 계열을 사용하는 오픈 소스 Android 클라이언트입니다. 앱별 프록시, 모바일 네트워크 전환, QR 코드 가져오기와 일반적인 Xray 프로토콜 설정이 필요한 기기에 적합합니다.

v2flyNG

v2fly 코어 계열을 사용하는 오픈 소스 Android 클라이언트입니다. V2Fly 설정 동작에 맞추거나 모바일에서도 해당 코어 체계를 유지하려는 경우에 적합합니다.

CHECKLIST

자주 묻는 질문

아래 질문은 설정 흐름에 따라 정리했습니다. 먼저 로컬 프록시가 트래픽을 넘겨받는지 확인하고, 다음으로 노드 핸드셰이크를 점검한 뒤 라우팅과 DNS를 처리하는 편이 노드를 계속 바꿔 보는 것보다 원인을 찾기 쉽습니다.

구독 업데이트 후 새 노드가 보이지 않음

먼저 현재 사용하는 구독 그룹을 업데이트했는지 확인한 다음, 구독 주소가 완전한지와 업데이트 로그에 파싱 오류가 반환되었는지를 확인하세요. 이름이 비슷한 그룹이 여러 개라면 노드가 다른 그룹에 들어갔을 수 있습니다.

구독 문제 확인 →

클라이언트는 실행 중인데 브라우저가 연결되지 않음

데스크톱에서는 시스템 프록시가 적용되었는지와 브라우저가 시스템 설정을 사용하는지 확인하고, Android에서는 시스템 연결이 만들어졌는지 확인하세요. 그다음 노드 핸드셰이크와 도메인 확인 로그를 살펴봅니다.

문제 해결로 이동 →

전역 프록시와 규칙 모드 중 무엇을 선택할까

전역 모드는 더 많은 트래픽을 프록시 아웃바운드로 보내고, 규칙 모드는 조건에 따라 직접 연결, 프록시 또는 차단을 선택합니다. 첫 연결에서는 기본 경로를 먼저 확인한 뒤 분할 규칙을 단계적으로 설정하세요.

라우팅 용어 보기 →

지연 시간은 낮은데 실제 속도는 느림

ping, 실제 연결 지연 시간과 다운로드 속도 측정은 서로 다른 대상을 측정합니다. 실제 속도는 핸드셰이크, 회선 혼잡, 서버 부하, 전송 방식과 대상 사이트의 응답에도 영향을 받습니다.

속도 측정 차이 알아보기 →

LATEST NOTES

설정 및 문제 해결 글

라우팅 규칙, 첫 연결과 클라이언트 인터페이스라는 세 가지 관점에서 실제 설정 세부 사항을 보충합니다. 글의 단계와 용어 페이지, 문제 해결 페이지가 서로 연결되어 있어 문제에 맞춰 계속 확인할 수 있습니다.

고급 활용

V2Ray 라우팅 규칙 설정 실전: geosite와 geoip로 중국 본토·해외 트래픽 분할

도메인과 IP 규칙을 사용해 직접 연결, 프록시와 차단의 매칭 순서를 설명하고, 아웃바운드 태그를 규칙에 연결하는 방법과 분할 라우팅 결과를 확인하는 방법을 소개합니다.

전체 글 읽기 →
입문 가이드

V2Ray 첫 연결 튜토리얼: 노드 선택, 실제 연결 속도 측정, 프록시 적용 여부를 확인하는 3단계

가져온 노드 목록에서 시작해 실제 연결 테스트, 활성 노드 선택, 프록시 시작과 브라우저 확인을 차례로 진행하고, 첫 연결에 실패했을 때의 점검 순서를 정리합니다.

전체 글 읽기 →
입문 가이드

v2rayN 메인 화면 기능별 상세 설명: 서버 목록, 구독 그룹, 로그와 설정 메뉴

서버 목록 필드, 구독 그룹 구성 방식, 로그 확인 위치와 코어 설정 메뉴를 항목별로 설명해 데스크톱 클라이언트의 기본 화면 구조를 파악할 수 있도록 합니다.

전체 글 읽기 →

전체 글 보기 →