클라이언트 릴리스 및 중국어 문서

V2Ray 클라이언트
다운로드 및 설정 가이드

v2rayN 다운로드 가이드 보기

오픈 소스 클라이언트 3종, 4개 플랫폼 경로와 중국어 사용 문서를 한곳에서 확인하세요. 먼저 기기에 맞는 클라이언트를 선택한 뒤 구독 가져오기, 시스템 프록시와 라우팅을 설정합니다.

구독 가져오기 라우팅 분기 DNS 설정 연결 문제 해결
04 지원 플랫폼 03 그래픽 클라이언트 Xray · V2Fly 코어 제품군 OPEN SOURCE 오픈 소스 생태계
사이트 공지

클라이언트 다운로드부터 연결 문제 해결까지

사용 단계별로 안내를 확인하세요. 왼쪽에서 주제를 선택하면 오른쪽에 적용 범위, 처리 순서와 관련 문서 경로가 표시됩니다.

먼저 운영체제에 맞는 클라이언트를 선택하세요

데스크톱에서는 v2rayN부터 선택합니다. Windows는 데스크톱 버전과 클래식 버전 중 적합한 것을 확인하고, macOS는 프로세서 아키텍처에 맞는 설치 패키지를 선택합니다. Linux는 배포판의 패키지 형식에 따라 해당 경로로 이동합니다. Android는 Xray 코어를 사용하는 v2rayNG가 기본이며, V2Fly 코어가 필요할 때 v2flyNG를 선택합니다. 이렇게 운영체제, 클라이언트, 코어를 분리해 안내하면 이름이 비슷한 파일을 잘못 다운로드하는 일을 줄일 수 있습니다. 다운로드 센터에는 아키텍처 확인 방법과 설치 전제 조건도 함께 정리되어 있어 처음 설치하거나 기기를 바꿀 때 참고하기 좋습니다.

플랫폼 경로는 해당 다운로드 패널로 안내하는 역할만 하며, 홈페이지에서 파일을 직접 배포하지는 않습니다. 다운로드 페이지에서 시스템 요구 사항, 설치 패키지 차이와 프로세서 정보를 확인하면 모바일 기기에 데스크톱 파일을 잘못 고르거나 데스크톱에서 아키텍처를 잘못 선택하는 일을 줄일 수 있습니다.

CLIENTS · v2rayN / v2rayNG / v2flyNG · WINDOWS / macOS / ANDROID / LINUX

4개 플랫폼 다운로드 경로

기기에 맞는 다운로드 패널로 이동

홈페이지에서는 설치 패키지 파일을 직접 구분하지 않습니다. 먼저 운영체제를 선택하면 다운로드 페이지에서 클라이언트, 프로세서 아키텍처와 패키지 형식을 이어서 안내합니다.

Windows

Windows 데스크톱에서는 v2rayN을 우선 사용합니다. 다운로드 페이지에서 최신 크로스 플랫폼 데스크톱 인터페이스와 클래식 WPF 인터페이스의 적합한 사용 환경을 각각 설명합니다. 처음 설치할 때는 시스템 버전과 실행 환경을 확인한 뒤 평소 사용 방식에 맞는 인터페이스를 선택하세요. 기존 설정을 옮겨야 한다면 먼저 구독 주소와 사용자 지정 라우팅을 백업한 다음 새 클라이언트에서 항목별로 복원합니다.

다운로드로 이동

macOS

macOS에서는 v2rayN 데스크톱 클라이언트를 사용합니다. 설치 패키지는 Apple Silicon과 Intel 프로세서용으로 나뉘므로 기기 외관만 보고 판단할 수 없습니다. 시스템 정보에서 칩 또는 프로세서 이름을 확인한 뒤 해당 경로로 이동하세요. 설치 후에는 시스템이 요구하는 네트워크 관련 권한을 허용하고, 메뉴 막대의 클라이언트 상태와 시스템 프록시 상태가 일치하는지 확인해야 합니다.

다운로드로 이동

Android

Android의 기본 경로는 Xray 코어를 사용하는 v2rayNG이며, v2flyNG는 V2Fly 코어에 대응하는 대체 클라이언트입니다. 최근 출시된 대부분의 기기는 먼저 arm64 설치 패키지를 확인할 수 있습니다. 아키텍처를 알 수 없다면 범용 버전 안내를 읽어 보세요. 설치 후에는 클라이언트가 로컬 VPN 연결을 만들도록 허용하고, 화면이 꺼진 뒤 시스템이 연결을 종료하지 않도록 백그라운드 실행 권한을 조정해야 합니다.

다운로드로 이동

Linux

Linux 데스크톱에서는 v2rayN을 사용하며 배포판에 맞춰 deb 또는 rpm 패키지를 선택합니다. Debian, Ubuntu 및 파생 시스템은 일반적으로 deb를 사용하고, Fedora, RHEL 계열과 파생 시스템은 일반적으로 rpm을 사용합니다. 프로세서 아키텍처는 별도로 확인해야 합니다. 설치 후 시스템 프록시가 적용되지 않으면 클라이언트 연결 상태만 보지 말고 현재 데스크톱 환경의 프록시 설정을 점검하세요.

다운로드로 이동
전체 클라이언트 보기 →
빠른 시작 미리보기

다운로드·가져오기·연결, 세 단계

다음 절차는 처음 연결을 완료하기 위한 과정입니다. 구체적인 메뉴 위치, 시스템 권한과 예외 처리는 전체 가이드에서 플랫폼별로 설명합니다.

  1. 클라이언트를 선택하고 설치를 완료하세요

    먼저 운영체제를 확인한 뒤 해당 클라이언트를 선택합니다. Windows, macOS와 Linux는 v2rayN을 사용하고, Android는 v2rayNG를 우선 사용합니다. V2Fly 코어가 필요하면 v2flyNG를 선택하세요. 데스크톱 설치 패키지는 프로세서 아키텍처나 패키지 형식도 구분해야 합니다. 설치가 끝나면 클라이언트를 실행해 메인 창, 트레이 아이콘 또는 상태 영역이 정상적으로 열리는지 확인한 후 구독 작업을 진행합니다.

    처음 실행할 때 권한 요청이 표시되면 시스템 안내에 따라 네트워크 연결과 시스템 프록시 관련 작업을 허용하세요. 설치가 끝나기 전에 기존 기기의 실행 디렉터리 전체를 복사하지 마세요. 시스템마다 경로, 권한과 실행 환경이 다르기 때문입니다. 보존해야 할 핵심 정보는 보통 구독 주소, 사용자 지정 라우팅 구상과 일부 수동 설정입니다.

  2. 구독 그룹을 만들고 업데이트하세요

    유효한 구독 주소를 복사한 뒤 클라이언트의 구독 관리에서 새 그룹을 추가합니다. 알아보기 쉬운 그룹 이름을 입력하고 저장한 다음 구독 업데이트를 실행하세요. 업데이트가 완료되어야 선택 가능한 설정 항목이 생성됩니다. 목록이 계속 비어 있다면 현재 보고 있는 그룹이 방금 만든 그룹인지 확인하고, 필터 조건, 주소의 완전성 및 업데이트 로그의 안내를 차례로 점검하세요.

    설정이 많다면 용도별로 여러 그룹을 만들 수 있지만, 같은 주소를 여러 그룹에 반복해서 추가하는 것은 권장하지 않습니다. 업데이트 후 설정 하나를 현재 연결 항목으로 선택하고 프로토콜, 주소와 포트 등 기본 정보가 완전한지 확인하세요. 구독 내용은 제공자가 관리하고 클라이언트는 이를 읽어 변환합니다. 필드가 호환되지 않는 경우 먼저 클라이언트와 코어 유형이 구독 요구 사항에 맞는지 확인하세요.

  3. 연결을 시작하고 프록시 적용 범위를 확인하세요

    설정을 선택한 뒤 클라이언트를 시작하고 기기에 따라 시스템 프록시, 전역 프록시 또는 앱별 모드를 정합니다. 데스크톱에서는 클라이언트 실행 상태와 시스템 프록시 상태를 함께 확인해야 하며, Android에서는 시스템이 로컬 VPN 연결을 허용했는지 확인해야 합니다. 연결 후에는 먼저 브라우저로 기본 접속을 테스트하고 다른 앱을 확인하세요. 특정 앱의 독립 프록시 설정을 클라이언트 전체의 오류로 오해하지 않도록 주의해야 합니다.

    브라우저는 정상인데 다른 앱에 적용되지 않는다면 해당 앱이 시스템 프록시를 따르는지, 독립적인 네트워크 설정을 사용하지 않는지, 현재 라우팅 규칙이 해당 트래픽을 포함하는지 중점적으로 확인하세요. 모든 앱이 연결되지 않으면 클라이언트 로그로 돌아가 설정 시작, 포트 사용 여부, DNS 해석과 원격 응답 순서로 원인을 찾습니다. 매번 한 가지 설정만 변경하고 확인한 뒤 다음 항목으로 넘어가세요.

전체 가이드 보기 →
오픈 소스 생태계 안내

Project V, V2Fly와 Xray의 관계

클라이언트, 코어와 프로토콜은 서로 다른 계층에 속합니다. 세 가지를 구분하면 설치 패키지 선택과 설정 문제 해결이 훨씬 명확해집니다.

Project V는 프로토콜 및 도구 생태계의 출발점입니다

Project V는 V2Ray 설정 모델, 프록시 프로토콜, 전송 방식과 라우팅 기능을 중심으로 한 오픈 소스 생태계를 형성했습니다. 사용자가 일상적으로 접하는 그래픽 클라이언트는 전체 기능 자체가 아니라 설정, 코어 프로세스와 시스템 프록시를 조작하기 위한 인터페이스 계층입니다. 구독 가져오기, 설정 선택, 로그 확인과 시스템 프록시 전환은 클라이언트가 담당하고, 연결 수립, 프로토콜 처리, 라우팅 매칭과 DNS 조회는 일반적으로 코어가 수행합니다.

따라서 인터페이스 이름이 비슷하다고 같은 코어를 사용하는 것은 아니며, 같은 코어를 사용해도 클라이언트마다 메뉴가 완전히 같지는 않습니다. 문제를 해결할 때는 먼저 클라이언트 이름과 플랫폼을 기록한 다음 코어 제품군과 설정 프로토콜을 확인하세요. 단순히 “V2Ray에 연결되지 않는다”고만 하면 문제 위치를 판단하기 어렵습니다.

V2Fly와 Xray는 서로 연관된 코어 제품군입니다

V2Fly는 V2Ray 생태계의 핵심 구현, 설정 구조와 관련 구성 요소를 이어받아 유지 관리합니다. Xray는 유사한 설정 방식을 바탕으로 발전하면서 자체적으로 지원하는 프로토콜, 보안 계층과 전송 기능을 추가했습니다. 인바운드, 아웃바운드, 라우팅, DNS, 정책과 로그처럼 공통 개념이 많지만 구체적인 필드, 사용 가능한 프로토콜과 기본 동작은 다를 수 있습니다. 설정 예시를 사용하기 전에 어떤 코어를 대상으로 하는지 확인해야 하며, 파일 확장자가 같다는 이유만으로 그대로 적용해서는 안 됩니다.

v2rayNG는 주로 Xray 코어와 함께 사용하고, v2flyNG는 V2Fly 코어에 대응합니다. v2rayN은 데스크톱에서 클라이언트 인터페이스와 설정 관리 역할을 맡을 수 있으며, 실제 사용 가능한 기능은 선택한 코어와 현재 설정에 따라 달라집니다. 이 사이트의 문서에는 코어 적용 범위를 명확히 표시합니다. 공통 개념은 기초 문서에서, 차이가 있는 필드는 설정 매뉴얼에서 각각 설명합니다.

세 클라이언트 모두 오픈 소스 프로젝트 방식으로 유지 관리됩니다

v2rayN, v2rayNG와 v2flyNG는 모두 공개 코드, 버전 기록과 라이선스 파일을 바탕으로 유지 관리됩니다. 그래픽 클라이언트는 코어 매개변수, 구독 내용과 시스템 네트워크 설정을 조작 가능한 인터페이스로 정리합니다. 데스크톱은 다중 창, 트레이 상태, 시스템 프록시와 설정 편집에 중점을 두고, Android 클라이언트는 로컬 VPN 인터페이스, 앱별 프록시, 백그라운드 실행과 모바일 네트워크 전환에 중점을 둡니다.

오픈 소스라는 특성 덕분에 기능 변화는 릴리스 기록, 문서와 코드의 발전 과정으로 설명할 수 있지만, 프로젝트마다 릴리스 주기가 같을 필요는 없습니다. 클라이언트 업데이트는 인터페이스나 구독 처리를 조정할 수 있고, 코어 업데이트는 프로토콜 기능을 추가하거나 연결 동작을 수정할 수 있습니다. 업그레이드 후 설정이 달라졌다면 해당 클라이언트의 변경 사항을 먼저 읽고 기존 설정을 옮길지 결정하세요.

업데이트 순서는 필요성과 호환성에 따라 정합니다

일상적인 업데이트에서 모든 구성 요소를 동시에 교체할 필요는 없습니다. 명확한 호환성 요구, 프로토콜 지원 변경 또는 알려진 문제 수정이 있을 때 릴리스 안내에 따라 클라이언트를 업데이트하세요. 업데이트 전에는 현재 클라이언트 이름, 설정 그룹, 사용자 지정 라우팅과 시스템 프록시 모드를 기록합니다. 업데이트 후 기존 설정을 먼저 불러오고 기본 연결을 확인한 다음 복잡한 규칙을 복원하세요. 이 순서로 진행하면 설치 문제, 설정 문제와 코어 동작 변화를 구분할 수 있습니다.

구독은 서비스 제공자가 업데이트하고 클라이언트와 코어는 각 프로젝트가 유지 관리합니다. 이 사이트는 다운로드 경로와 중국어 사용 자료를 정리합니다. 세 가지 업데이트 출처는 서로 독립적입니다. 구독 내용이 바뀌었다고 클라이언트를 바로 다시 설치할 필요는 없으며, 클라이언트 인터페이스가 바뀌었다고 구독 자체가 만료된 것도 아닙니다. 먼저 변화가 어느 계층에서 발생했는지 판단한 뒤 적합한 문서로 처리하세요.

용어 매뉴얼 보기 JSON 매뉴얼 읽기 세 클라이언트 비교
최신 문서 글

프로토콜·설치·문제 해결

글은 실제 사용 중 발생하는 문제를 중심으로 구성했습니다. 프로토콜 글에서는 선택 기준을 설명하고, 설치 글에서는 첫 설정을 다루며, 문제 해결 글에서는 단계별 점검 순서를 제시합니다.

입문 가이드

VMess와 VLESS의 차이는? 일반 사용자를 위한 1분 선택 가이드

암호화 방식, 전송 오버헤드와 서버 요구 사항을 기준으로 VMess와 VLESS의 실제 차이를 설명합니다. 일반 사용자는 프로토콜 매개변수를 직접 수정할 필요가 없으며 구독 정보와 서버 설정을 우선해야 합니다. 직접 선택해야 한다면 클라이언트 지원 범위와 보안 계층 요구 사항을 기준으로 판단하세요.

글 읽기 →
문제 해결

v2rayNG 배터리가 너무 빨리 닳을 때: 백그라운드 유지 및 절전 설정 점검

앱별 프록시 범위, 연결 하트비트, Mux 설정, 시스템 절전 예외 목록과 제조사 백그라운드 제한을 차례로 확인합니다. 클라이언트의 지속 실행, 잦은 재연결과 시스템의 반복적인 깨우기를 구분해 배터리 소모가 네트워크 활동, 설정 정책 또는 백그라운드 관리 규칙에서 비롯되었는지 확인할 수 있습니다.

글 읽기 →
프로토콜 안내

VMess·VLESS·Trojan·Shadowsocks 비교: 네 가지 프록시 프로토콜 선택법

핸드셰이크 방식, 전송 오버헤드, 서버 요구 사항과 클라이언트 지원 범위를 기준으로 네 가지 프로토콜을 정리합니다. 구독 정보나 배포 매개변수를 이해해야 하는 사용자를 대상으로 하며, 프로토콜 계층·전송 계층·보안 계층을 하나의 옵션으로 혼동하지 않도록 설명합니다. 단일 지표만으로 모든 상황을 판단하지 않습니다.

글 읽기 →
전체 글 보기 →