클라이언트 다운로드 및 설정 매뉴얼

v2rayNG 다운로드 스테이션
v2rayN 클라이언트 가이드

네 가지 플랫폼의 클라이언트 다운로드, 구독 및 라우팅 설정, Xray와 V2Fly 코어 안내를 한곳에 정리했습니다. 먼저 기기에 맞는 클라이언트를 선택한 뒤 단계에 따라 가져오기, 연결 및 네트워크를 확인하세요.

현재 기기에 맞는 다운로드 분류 열기

PLATFORMS Windows · macOS · Android · Linux
CLIENTS v2rayN · v2rayNG · v2flyNG
CORES Xray · V2Fly
MODEL 오픈 소스 · 커뮤니티 유지 관리
01 / SUBSCRIPTION

구독 그룹으로 서버 설정 관리

구독 링크는 서비스 제공자가 배포한 서버 설정을 한곳에서 관리할 때 유용합니다. 가져올 때 먼저 알아보기 쉬운 그룹 이름을 지정한 다음 업데이트를 실행하면 클라이언트가 링크 내용을 분석해 사용할 설정을 만듭니다. 이후 서버 측에서 매개변수를 변경해도 기존 그룹만 업데이트하면 되므로 항목을 하나씩 다시 만들 필요가 없습니다.

v2rayN 데스크톱 버전은 구독 관리, 서버 목록 및 업데이트 기능을 분리해 여러 출처를 동시에 관리하기 좋습니다. v2rayNG Android 버전은 관련 메뉴를 사이드 메뉴에 모아 더 간결하게 조작할 수 있습니다. 어느 버전을 사용하든 먼저 구독 주소가 완전한지 확인한 뒤 업데이트 결과와 현재 선택한 설정을 점검하세요. 목록이 비어 있다면 시스템 프록시를 반복해서 전환하지 말고 링크 접속, 구독 형식 및 업데이트 과정을 먼저 확인해야 합니다.

02 / ROUTING

도메인과 주소 규칙으로 연결 경로 결정

라우팅 분할은 연결이 설정된 뒤에도 작동하며 도메인, IP 주소, 포트 또는 규칙 집합에 따라 트래픽을 프록시로 보낼지, 직접 연결할지, 차단할지를 결정합니다. ‘로컬 네트워크 및 중국 본토 주소 우회’는 미리 설정된 라우팅 모드로, 로컬 서비스와 자주 사용하는 직접 연결 리소스가 기존 경로를 유지해야 할 때 적합합니다.

사전 설정 모드는 대부분의 일상적인 요구를 처리하지만 규칙이 많다고 결과가 더 정확해지는 것은 아닙니다. 특정 웹사이트에 접속 문제가 생기면 먼저 적용된 규칙과 분석 결과를 확인한 뒤 사용자 지정 항목 추가 여부를 결정하세요. 사용자 지정 규칙은 순서도 중요합니다. 앞에서 일치한 규칙이 판단을 먼저 끝낼 수 있기 때문입니다. 단일 전체 프록시 스위치만 제공하는 단순한 도구와 달리 v2rayN과 v2rayNG는 도메인 규칙, 주소 규칙 및 코어의 라우팅 기능을 조합해 업무 요구에 맞게 단계적으로 조정할 수 있습니다.

03 / CORE

프로토콜 기능에 따라 Xray 또는 V2Fly 선택

GUI 클라이언트는 설정 관리와 사용자 인터페이스를 담당하고, 실제 연결·전송·라우팅 처리는 하위 코어가 수행합니다. Xray와 V2Fly는 모두 Project V 기술 체계에서 출발해 기본 설정 방식은 비슷하지만 프로토콜 확장, 기능 발전 및 일부 필드 지원에는 차이가 있습니다. 코어를 선택할 때는 이름보다 현재 설정에 필요한 기능을 기준으로 판단해야 합니다.

v2rayN은 데스크톱 환경에서 여러 코어 설정을 관리할 수 있어 프로토콜 호환성을 테스트하거나 여러 구성을 유지해야 하는 사용자에게 적합합니다. v2rayNG는 주로 Xray 코어를 중심으로 Android 환경을 구성하고, v2flyNG는 V2Fly 코어 기반의 대안을 제공합니다. 설정을 가져온 뒤 지원되지 않는 필드가 표시되면 먼저 클라이언트와 코어 유형이 호환되는지 확인하고, 프로토콜·전송 계층·TLS 매개변수를 점검하세요. 코어 호환성 문제를 서버 장애로 잘못 판단하지 않도록 주의해야 합니다.

04 / ACCESS

시스템 프록시와 TUN 모드 구분

시스템 프록시는 운영체제의 프록시 설정을 통해 호환되는 애플리케이션을 클라이언트에 연결합니다. 설정이 명확하고 적용 범위를 파악하기 쉬워 브라우저와 시스템 프록시를 따르는 데스크톱 프로그램에 적합합니다. 켜기 전에 사용할 수 있는 설정을 선택하고 코어를 실행해야 하며, 클라이언트를 종료하기 전에는 시스템 프록시 상태를 복원해 애플리케이션이 중지된 로컬 포트를 계속 가리키지 않도록 해야 합니다.

TUN 모드는 가상 네트워크 인터페이스를 통해 더 넓은 범위의 트래픽을 인계받으므로 시스템 프록시 설정을 읽지 않는 프로그램도 처리할 수 있습니다. 다만 드라이버 권한, 라우팅 테이블, DNS 및 다른 네트워크 도구와의 연동이 필요합니다. 처음 설정할 때는 먼저 시스템 프록시로 구독과 노드가 정상인지 확인한 다음 애플리케이션 요구에 따라 TUN을 활성화하세요. 활성화 후 네트워크에 접속할 수 없다면 관리자 권한, 가상 인터페이스, DNS 정책 및 라우팅 충돌을 순서대로 확인해야 하며 모든 매개변수를 동시에 바꾸지 않는 것이 좋습니다.

기기별 선택

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

데스크톱 플랫폼에서는 v2rayN을 사용하고, Android에서는 코어 요구 사항에 따라 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 다운로드 페이지에서 아키텍처, 설치 형식 및 시스템 요구 사항을 추가로 확인할 수 있습니다.

Windows

Windows 사용자는 v2rayN 데스크톱 버전 또는 클래식 WPF 버전을 선택할 수 있습니다. 데스크톱 버전은 크로스 플랫폼 UI 체계를 사용하고, 클래식 버전은 익숙한 Windows 조작 방식을 이어갑니다. 다운로드 페이지에서 사용 습관에 맞는 항목을 선택하세요.

다운로드 페이지로 이동

macOS

macOS에서는 v2rayN 크로스 플랫폼 데스크톱 버전을 사용합니다. 다운로드 전에 시스템 정보에서 프로세서 유형을 확인하세요. Apple Silicon과 Intel은 서로 다른 빌드를 선택해야 하며, 설치 후에는 시스템 안내에 따라 네트워크 관련 권한을 허용해야 합니다.

다운로드 페이지로 이동

Android

Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 선택할 수 있으며, 설정 요구 사항에 따라 V2Fly 코어 기반의 v2flyNG를 사용할 수도 있습니다. 최근 출시된 대부분의 기기는 arm64 아키텍처에 적합하며, 아키텍처를 모를 때는 다운로드 페이지에서 범용 버전 안내를 확인하세요.

다운로드 페이지로 이동

Linux

Linux에서는 v2rayN 크로스 플랫폼 데스크톱 버전을 사용합니다. 배포판의 패키지 체계에 따라 deb 또는 rpm을 선택하고 x64와 arm64 아키텍처를 구분해야 합니다. 설치 전에 데스크톱 환경, 아키텍처 및 권한 설정을 확인하는 것이 좋습니다.

다운로드 페이지로 이동
빠른 시작

먼저 가져오고, 연결한 뒤, 마지막으로 확인

처음 설정을 세 단계로 나누고 각 단계가 끝날 때마다 결과를 확인하세요. 문제가 생겼을 때 구독, 코어 시작 또는 시스템 연결 중 어느 단계에 문제가 있는지 명확히 파악할 수 있습니다.

전체 가이드 보기
  1. 01

    구독 또는 개별 설정 가져오기

    클라이언트에서 구독 관리 메뉴를 찾아 완전한 링크와 알아보기 쉬운 그룹 이름을 입력한 다음 업데이트를 실행하세요. 개별 설정은 클립보드, QR 코드 또는 수동 양식을 통해 가져올 수 있습니다. 완료 후 서버 목록에 유효한 항목이 생성되었는지 확인하고 프로토콜 및 전송 필드가 누락되지 않았는지 점검하세요. 이 단계에서는 라우팅과 DNS를 아직 변경하지 말고 초기 환경을 단순하게 유지하는 것이 좋습니다.

  2. 02

    설정을 선택하고 코어 시작

    목록에서 사용할 설정을 선택해 활성 항목으로 지정한 다음 클라이언트 코어를 시작하세요. 데스크톱에서는 일반적으로 시스템 프록시를 계속 켜야 하고, Android에서는 시스템 네트워크 연결 권한을 확인해야 합니다. 코어가 시작되지 않으면 클라이언트 로그의 설정 분석 정보를 먼저 확인하고 현재 코어가 구독에 사용된 프로토콜 필드를 지원하는지 점검하세요.

  3. 03

    접속을 확인하고 항목별로 조정

    먼저 브라우저에서 익숙한 웹사이트를 열어 도메인 분석과 기본 접속이 정상인지 확인한 다음 프록시가 필요한 대상을 테스트하세요. 기본 연결이 안정된 후에만 사용자 지정 라우팅, TUN 모드 또는 복잡한 DNS 설정을 활성화해야 합니다. 변경 후 문제가 생기면 최근 변경을 되돌리고 다시 테스트해 여러 변수가 동시에 바뀌어 판단이 흐려지는 일을 피하세요.

오픈 소스 생태계

Project V, V2Fly 및 Xray의 관계

클라이언트, 코어 및 프로토콜 설정의 역할을 이해하면 적합한 소프트웨어를 선택할 수 있고, 구독 가져오기 실패나 연결 이상이 발생했을 때도 문제를 더 빠르게 찾을 수 있습니다.

기술 체계 Project V

프로토콜 설정, 전송 기능 및 라우팅 메커니즘의 공통 기술 기반

V2Fly

V2Ray 핵심 기능과 커뮤니티 규범 계승

Xray

동일한 기반에서 프로토콜 및 전송 기능 확장

생태계의 역사와 구성 요소별 역할

Project V는 V2Ray 설정 모델과 모듈형 네트워크 처리 방식을 확립했습니다. 커뮤니티가 발전하면서 V2Fly와 Xray는 각자의 유지 관리 경로를 형성했지만 인바운드, 아웃바운드, 라우팅, 전송 계층 및 DNS 설정과 같은 기본 개념은 여전히 많이 공유합니다. 사용자가 일상적으로 접하는 v2rayN, v2rayNG 및 v2flyNG는 GUI 클라이언트로, 설정 화면 표시, 구독 저장, 서버 목록 관리 및 코어 호출을 담당합니다. 실제 프로토콜 핸드셰이크, 트래픽 전달 및 규칙 매칭은 코어가 수행합니다.

따라서 ‘클라이언트가 실행된다’고 해서 ‘설정이 반드시 작동한다’는 뜻은 아닙니다. 로그에 프로토콜 필드를 인식할 수 없다고 표시되면 코어 호환성 문제일 수 있고, 일부 애플리케이션만 인터넷에 연결되지 않는다면 시스템 프록시, TUN 인계 또는 라우팅 규칙에 문제가 있을 가능성이 큽니다. UI 계층과 코어 계층을 나누어 판단하는 편이 클라이언트를 반복해서 설치하는 것보다 효과적입니다.

세 클라이언트의 특징

v2rayN은 Windows·macOS·Linux 데스크톱 환경을 대상으로 구독 관리, 서버 목록, 시스템 프록시, 라우팅 설정 및 다중 코어 설정 기능을 제공합니다. 데스크톱에서 연결 구성을 한곳에 관리해야 하는 사용자에게 적합합니다. v2rayNG는 Android용으로, 터치 조작과 시스템 네트워크 연결 절차를 중심으로 기능을 구성하며 일반적으로 Xray 코어와 함께 사용합니다. v2flyNG 역시 Android용이지만 V2Fly 코어를 사용하는 경로로, 특정 설정이나 코어 선호도에 따른 대안이 될 수 있습니다.

클라이언트를 선택할 때는 먼저 운영체제를 확인하고 다음으로 코어 요구 사항을 살펴보세요. 데스크톱 기기라면 v2rayN 분류로 이동하고, Android 설정이 Xray 기능에 의존한다면 v2rayNG를 우선 선택할 수 있습니다. V2Fly 동작이 명확히 필요하다면 v2flyNG를 선택하세요. 클라이언트를 단순히 기능 수로 순위 매기기보다 현재 플랫폼과 설정 형식에 맞추는 것이 중요합니다.

오픈 소스 라이선스와 검토 가능한 코드

세 클라이언트와 관련 코어는 모두 공개 소스 코드 기반의 커뮤니티 유지 관리 방식을 사용합니다. 프로젝트의 라이선스 파일, 코드 변경 내역 및 릴리스 기록은 추적 가능한 기술 자료를 구성합니다. 오픈 소스 라이선스는 복사, 수정 및 재배포 조건을 명확히 하며 개발자가 네트워크 요청, 설정 처리 및 코어 호출 방식을 검토할 수 있게 합니다. 일반 사용자에게는 소프트웨어 동작을 기술 커뮤니티가 지속적으로 점검할 수 있고 문제 수정과 호환성 논의의 근거가 분명하다는 점이 실질적인 가치입니다.

오픈 소스라는 특성이 올바른 설정을 대신해 주지는 않습니다. 구독 내용, 서버 관리 및 로컬 기기 권한은 여전히 사용자의 환경에 따라 달라집니다. 설치 후에는 필요한 최소 범위로 시스템 권한을 허용하고, 출처가 불분명한 텍스트에서 해석하기 어려운 복잡한 규칙을 바로 가져오지 마세요. 네트워크 설정을 변경하기 전에는 기존 설정을 보관하는 것이 좋습니다.

업데이트 방식과 호환성 판단

클라이언트, 코어 및 구독 형식의 업데이트 주기는 서로 완전히 일치하지 않습니다. 클라이언트 업데이트는 UI 변경과 시스템 대응을 가져올 수 있고, 코어 업데이트는 프로토콜 기능·전송 구현·규칙 처리와 관련되는 경우가 많습니다. 구독 서비스는 인코딩 방식이나 전달 필드를 변경할 수 있습니다. ‘예전에는 작동했지만 업데이트 후 문제가 생긴’ 경우에는 먼저 어느 계층에서 변화가 발생했는지 확인한 다음 해당 오류 정보를 읽어야 합니다.

합리적인 업데이트 순서는 먼저 현재 설정을 저장하고, 클라이언트 또는 코어를 업데이트한 뒤 기존 설정으로 기본 테스트를 진행하는 것입니다. 마지막으로 구독을 업데이트하고 새 필드를 확인하세요. 연결에 실패하면 시스템 시간, 도메인 분석, TLS 매개변수, SNI, 프로토콜 필드 및 라우팅 적용 순서를 하나씩 점검하세요. 한 번에 하나의 조건만 바꾸면 문제 해결 결과를 더 신뢰할 수 있습니다.