Android 및 데스크톱 설정 안내

V2Ray 안드로이드판 및 v2rayN 클라이언트 설정

v2rayNG Android 클라이언트, v2rayN 데스크톱 버전구독 라우팅 설정을 한곳에 정리했습니다. 플랫폼과 작업 순서에 따라 필요한 단계를 찾아보세요.

Xray · V2Fly VMess · VLESS Trojan · Shadowsocks 오픈 소스
04 지원 플랫폼 03 그래픽 클라이언트 CORE Xray · V2Fly OPEN 오픈 소스 프로토콜 DOCS 중국어 설정 문서

구독 및 라우팅작업별로 나누어 안내

먼저 클라이언트의 역할을 파악한 뒤 프로토콜, 프록시 모드와 분기 규칙을 정하세요. 아래 패널은 클라이언트에 표시되는 실제 설정 이름을 사용해 서로 다른 기능을 하나의 모호한 스위치로 혼동하지 않도록 구성했습니다.

SUBSCRIPTION

구독 관리:그룹 업데이트 및 활성 서버 선택

구독 주소는 서버 설정을 한꺼번에 가져오는 용도이며 연결 버튼과는 다릅니다. 먼저 구독 그룹을 만든 다음 업데이트하고, 마지막으로 서버 목록에서 활성 항목을 선택하세요. v2rayN에서는 용도별로 여러 그룹을 만들 수 있고, v2rayNG에서는 오른쪽 상단 메뉴에서 현재 구독을 업데이트할 수 있습니다. 업데이트에 실패하면 주소 만료, 네트워크 접속 실패, 응답 형식 오류를 먼저 구분하세요. 이미 정상적으로 작동하는 로컬 설정을 반복해서 삭제할 필요는 없습니다.

구독 그룹및 업데이트 순서

하나의 클라이언트에 여러 구독 출처를 저장할 수 있지만 업데이트는 그룹 단위로 실행해야 합니다. 주소를 추가한 뒤 그룹 이름과 주소가 완전한지 확인하고 업데이트를 실행해 결과를 확인하세요. 서버 목록이 표시된 후에도 활성 서버는 직접 선택해야 합니다. 장기간 사용하지 않는 구독은 비활성화하거나 삭제해 같은 이름의 서버가 섞이지 않도록 하세요. 임시 수동 설정은 별도 그룹에 넣는 것이 좋습니다. 그래야 구독 업데이트가 로컬 변경 사항을 덮어쓰지 않습니다.

커널 선택및 클라이언트의 역할 범위

v2rayNG는 기본적으로 Xray 커널 생태계를 대상으로 하고, v2flyNG는 V2Fly 커널을 사용하며, v2rayN은 데스크톱 그래픽 인터페이스로 관련 핵심 구성 요소를 관리합니다. 클라이언트 인터페이스는 가져오기, 전환과 시스템 연동을 담당하고 실제 프로토콜 해석과 라우팅 실행은 커널이 맡습니다. 새로운 프로토콜 매개변수를 인식하지 못한다면 서버 주소만 확인하지 말고 클라이언트와 커널이 해당 필드를 지원하는지 먼저 판단하세요.

라우팅 모드및 규칙 우선순위

전체, 직접 연결과 규칙 모드는 서로 다른 문제를 해결합니다. 전체 모드는 프록시 경로가 작동하는지 빠르게 확인할 때 유용하고, 직접 연결 모드는 트래픽 처리를 잠시 중단할 때 적합합니다. 규칙 모드는 도메인, IP, 포트 또는 프로세스에 따라 출구를 정하므로 장기간 사용에 적합합니다. 문제를 확인할 때는 단순한 모드로 범위를 좁힌 다음 규칙 모드에서 적용 순서를 점검하세요. 출처가 불분명한 규칙을 한꺼번에 많이 추가하면 어떤 규칙이 트래픽 방향을 바꿨는지 찾기 어렵습니다.

시스템 트래픽 처리및 앱 적용 범위

데스크톱 시스템 프록시는 주로 시스템 네트워크 설정을 따르는 프로그램에 영향을 줍니다. TUN 모드는 더 다양한 트래픽 유형을 처리할 수 있습니다. Android 클라이언트는 시스템 VPN 인터페이스로 로컬 전달을 구성하고 앱별 프록시로 적용할 앱을 제어할 수 있습니다. 선택은 실제 필요에 따라 결정하세요. 브라우저 접속은 시스템 프록시로 시작하고, 명령줄 프로그램이나 시스템 설정을 읽지 않는 소프트웨어는 별도 프록시 또는 TUN을 고려하면 됩니다.

운영체제별클라이언트 선택

데스크톱에서는 v2rayN부터 시작하고 Android에서는 v2rayNG를 우선 사용하세요. 설치 패키지 페이지에서 프로세서 아키텍처와 배포 형식에 따라 다시 세부적으로 선택할 수 있습니다.

데스크톱 추천

Windows

v2rayN을 사용하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, 클래식 WPF 버전은 기존 Windows 방식에 익숙한 사용자에게 적합합니다. 설치 후 구독을 가져오고 시스템 프록시를 활성화하세요. 프로그램이 실행되지 않으면 시스템 구성 요소, 설치 폴더 권한과 선택한 아키텍처를 다시 확인해야 합니다.

다운로드로 이동
데스크톱 플랫폼

macOS

v2rayN 크로스 플랫폼 데스크톱 버전을 사용하세요. 다운로드 전 기기가 Apple Silicon인지 Intel 프로세서인지 확인해야 하며 두 설치 패키지는 임의로 바꿔 사용할 수 없습니다. 처음 실행할 때 시스템에서 앱을 열도록 허용하고, 클라이언트 안내에 따라 시스템 프록시 또는 TUN 권한을 설정하세요.

다운로드로 이동
모바일 추천

Android

Xray 커널 기반 v2rayNG를 우선 사용하고 V2Fly 커널이 필요하면 v2flyNG를 선택하세요. 최근 출시된 대부분의 기기는 arm64 패키지가 적합하며 아키텍처를 확인하기 어려울 때만 범용 버전을 사용하세요. 연결하기 전에 시스템 VPN 권한을 허용하고 기기의 배터리 절약 정책에 맞춰 백그라운드 실행 방식을 설정해야 합니다.

다운로드로 이동
데스크톱 플랫폼

Linux

v2rayN Linux 데스크톱 버전을 사용하세요. Debian 및 Ubuntu 계열 배포판은 보통 deb를, Fedora 및 Rocky Linux 계열은 rpm을 선택하며 x64와 arm64도 구분해야 합니다. 설치 후 데스크톱 세션, 트레이 지원과 시스템 프록시 설정이 현재 배포판에 맞는지 확인하세요.

다운로드로 이동

세 단계로 완료기본 연결 설정

이 세 단계는 최소한의 사용 가능 절차만 다룹니다. 연결이 정상임을 확인한 뒤 라우팅 규칙, 앱별 프록시, DNS 또는 TUN을 설정하면 문제를 더 쉽게 찾을 수 있습니다.

  1. 01

    플랫폼에 맞는 클라이언트 설치

    Windows, macOS, Linux에서는 v2rayN을 사용하고 Android에서는 v2rayNG를 우선 사용하세요. 다운로드 전 운영체제, 프로세서 아키텍처와 설치 형식을 확인하세요. 데스크톱 설치 후 클라이언트를 실행하고, Android에서는 설치를 마친 뒤 알림과 필요한 백그라운드 실행 권한을 허용하세요. 이 단계에서는 아직 연결을 바로 켤 필요가 없습니다.

  2. 02

    구독을 가져오고 활성 서버 선택

    유효한 구독 주소를 복사해 클라이언트의 구독 그룹에 새 출처로 추가한 다음 업데이트를 실행하세요. 목록이 생성되면 서버 하나를 활성 항목으로 선택합니다. 업데이트에 실패하면 먼저 브라우저나 서비스 제공자 페이지에서 주소가 여전히 유효한지 확인한 뒤, 클라이언트 메시지가 네트워크 오류인지 형식 오류인지 인증 오류인지 살펴보세요. 수동 공유 링크도 가져올 수 있지만 프로토콜 필드가 완전한지 확인해야 합니다.

  3. 03

    프록시를 활성화하고 트래픽 경로 확인

    데스크톱에서는 먼저 시스템 프록시를 활성화하고, Android에서는 연결을 누른 뒤 시스템 VPN 요청을 허용하세요. 확인할 때는 규칙이 적은 모드로 시작해 브라우저가 예상대로 접속되는지 확인한 다음 사용자 지정 분기를 단계적으로 복원하세요. 브라우저는 정상인데 특정 프로그램만 작동하지 않으면 해당 프로그램에 별도 프록시 설정이 있는지 또는 시스템 네트워크 설정을 우회하는지 확인하세요.

Project V커널과 클라이언트의 관계

클라이언트, 커널, 프로토콜과 구독은 서로 다른 네 가지 계층입니다. 각 역할의 경계를 이해하면 선택과 문제 해결이 훨씬 명확해집니다.

01

Project V와 V2Ray 설정 체계

Project V는 JSON 설정, 인바운드, 아웃바운드와 라우팅을 중심으로 한 네트워크 프록시 체계를 구축했습니다. 일반적인 클라이언트는 별도의 프로토콜이 아니라 복잡한 설정을 조작 가능한 그래픽 인터페이스로 바꾸는 도구입니다. 구독을 가져오면 클라이언트가 서버 매개변수를 커널이 읽을 수 있는 설정으로 정리하고, 프로세스 실행, 활성 서버 전환과 시스템 네트워크 설정 연동을 담당합니다. 따라서 같은 공유 설정을 사용할 수 있는지는 클라이언트 이름뿐 아니라 커널이 해당 프로토콜과 전송 매개변수를 지원하는지에도 달려 있습니다.

02

V2Fly와 Xray 커널 계열

V2Fly는 V2Ray Core의 커뮤니티 유지보수 방향을 이어받아 검증된 인바운드, 아웃바운드, 라우팅과 전송 구조를 유지합니다. Xray는 유사한 설정 모델을 바탕으로 프로토콜과 전송 기능을 계속 확장하고 있습니다. 두 커널은 여러 기본 개념을 공유하지만 구체적인 필드와 새 기능이 항상 일치하는 것은 아닙니다. v2flyNG는 V2Fly 커널에 가깝고 v2rayNG는 보통 Xray 커널을 사용하며, v2rayN은 데스크톱에서 핵심 구성 요소를 관리합니다. 설정 호환성 문제가 발생하면 클라이언트 버전, 커널 유형과 서버 매개변수를 하나의 문제 해결 흐름에서 함께 확인하세요.

03

세 그래픽 클라이언트의 역할

v2rayN은 Windows, macOS와 Linux를 대상으로 하며 여러 구독 그룹, 라우팅 모드, 시스템 프록시와 데스크톱 실행 상태를 관리하는 데 적합합니다. v2rayNG는 Android용으로 Xray 커널을 주요 실행 계층으로 사용하고 QR 코드, 클립보드 가져오기, 앱별 프록시와 로컬 VPN 연결을 제공합니다. v2flyNG 역시 Android용이지만 V2Fly 커널을 중심으로 합니다. 세 클라이언트 모두 커뮤니티에서 유지보수하는 오픈 소스 소프트웨어이며 기능 업데이트 일정은 각 프로젝트에 따라 다르므로 인터페이스 이름과 지원 필드가 다를 수 있습니다.

04

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

v2rayN, v2rayNG와 v2flyNG의 소스 코드는 각각의 오픈 소스 라이선스에 따라 공개되며 V2Fly와 Xray 커널에도 명확한 라이선스 범위가 있습니다. 오픈 소스라는 것은 구현 방식, 설정 해석과 업데이트 기록을 커뮤니티가 검토할 수 있다는 뜻입니다. 동시에 소프트웨어, 커널과 구독 서비스가 동일한 주체가 아니라는 점도 이해해야 합니다. 이 사이트의 문서는 클라이언트 사용법과 공개된 기술 개념만 정리하며 소프트웨어 유지보수자가 제공하는 공지를 대신하지 않습니다. 또한 타사 구독 출처를 클라이언트 프로젝트에 포함하지 않습니다.

05

업데이트 방식과 설정 호환성

클라이언트 업데이트, 커널 업데이트와 구독 업데이트는 서로 독립적인 세 가지 작업입니다. 클라이언트 업데이트는 주로 인터페이스, 가져오기 로직과 시스템 연동을 바꾸고, 커널 업데이트는 새 프로토콜 필드를 추가하거나 전송 문제를 수정하고 동작을 조정할 수 있습니다. 구독 업데이트는 서버에서 서버 목록을 다시 가져옵니다. 문제가 발생했을 때 클라이언트를 재설치하고 설정을 삭제하며 구독까지 동시에 바꾸면 판단 근거를 잃게 됩니다. 현재 설정을 기록한 뒤 한 번에 하나의 변수만 바꾸고 오류 메시지가 달라지는지 확인하는 것이 더 안전합니다.

연결 전후먼저 확인할 항목

구독을 가져온 뒤 왜 자동으로 연결되지 않나요?

구독 가져오기는 서버 목록을 생성할 뿐입니다. 활성 서버를 선택하고 데스크톱에서는 시스템 프록시를 활성화하거나 Android에서는 시스템 VPN 연결을 시작해야 합니다. 목록이 비어 있다면 현재 구독 그룹을 다시 업데이트하고 오류 메시지를 확인하세요. 관련 용어는 구독 및 노드 설명에서 확인할 수 있습니다.

전체 모드와 규칙 모드는 어떻게 선택해야 하나요?

전체 모드는 짧은 시간 동안 프록시 경로를 확인할 때 적합하며 클라이언트가 처리하는 모든 트래픽을 같은 출구로 보냅니다. 규칙 모드는 도메인, IP, 포트 또는 프로세스에 따라 직접 연결과 프록시를 결정하므로 일상적인 설정에 더 적합합니다. 먼저 전체 모드로 연결을 확인한 뒤 규칙 모드로 돌아가 구체적인 규칙을 점검하는 방법이 가장 명확합니다.

노드 속도 테스트는 정상인데 앱에 접속할 수 없으면 어떻게 하나요?

속도 테스트 결과는 특정 테스트 요청이 완료되었다는 것만 보여줄 뿐 모든 앱이 시스템 프록시를 읽는다는 뜻은 아닙니다. 시스템 프록시 상태, 앱별 목록, 라우팅 적용 여부, DNS 설정과 대상 앱 자체의 프록시 옵션을 계속 확인하세요. 한 프로그램에서만 문제가 발생한다면 해당 프로그램이 시스템 네트워크 설정을 우회하는지 먼저 살펴보세요.

v2rayNG와 v2flyNG의 주요 차이점은 무엇인가요?

두 제품 모두 Android 그래픽 클라이언트이며 주요 차이는 사용하는 커널 계열입니다. v2rayNG는 Xray 커널을 중심으로 하고 v2flyNG는 V2Fly 커널을 사용합니다. 선택할 때는 구독에 포함된 프로토콜과 매개변수를 기준으로 판단하세요. 현재 클라이언트에서 기존 설정이 안정적으로 작동한다면 이름이 다르다는 이유만으로 자주 옮길 필요는 없습니다.

설정 원리및 문제 해결 기록

각 글은 구체적인 문제를 기준으로 클라이언트 동작을 분석하며, 막연한 결론으로 설정 단계를 대신하지 않습니다.

전체 글 보기 →
고급 활용

FakeDNS 원리 해설: 가상 IP로 도메인 분기를 빠르게 처리하는 방법

FakeDNS의 응답 과정과 예약 대역의 용도, 도메인 스니핑·TUN 모드·라우팅 규칙을 함께 사용할 때 주의해야 할 범위를 설명합니다.

전체 내용 보기 →
문제 해결

구독 링크가 만료되었거나 파싱에 실패하나요? 문제의 원인을 찾는 6단계 점검

주소 유효성, 응답 내용, 네트워크 접속, 클라이언트 요청 방식과 로컬 설정 순서로 확인해 구독 출처 문제와 클라이언트 가져오기 문제를 구분합니다.

전체 내용 보기 →
프로토콜

VMess, VLESS, Trojan, Shadowsocks 차이와 사용 환경별 선택 가이드

암호화 역할, 핸드셰이크 오버헤드, 전송 조합과 기기 조건의 네 가지 관점에서 프로토콜을 비교하고, 서버 측 기능에 맞는 설정 선택 방법을 설명합니다.

전체 내용 보기 →