클라이언트 이동 및 설정 문서

V2Ray 다운로드 스테이션: 클라이언트 및 설정 가이드

v2rayN·v2rayNG·v2flyNG 다운로드 경로와 사용 문서를 한곳에 정리하고, 구독 가져오기·프로토콜 선택·라우팅 설정의 실제 순서를 설명합니다.

오픈 소스 한국어 문서 Xray · V2Fly 영구 무료
4개 플랫폼 데스크톱 v2rayN Android v2rayNG · v2flyNG 코어 계열 Xray · V2Fly 프로토콜 자료 VMess · VLESS
설정 경로

클라이언트 기능 및 주요 사용법

구독 관리부터 라우팅 설정까지 실제 사용 순서에 따라 핵심 설정을 나눠 설명합니다. 테마를 전환하면 해당 화면 구성, 적합한 상황과 흔한 실수를 확인할 수 있습니다.

첫 단계

구독 가져오기 및 노드 업데이트

구독 주소는 서비스 제공자가 전달하는 노드 설정을 한꺼번에 가져오는 데 사용합니다. 데스크톱에서는 보통 구독 그룹에 주소를 추가하고 저장한 뒤 업데이트를 실행합니다. Android 클라이언트는 클립보드에서 가져오거나 서비스가 제공한 QR 코드를 스캔할 수 있습니다. 가져오기는 설정 목록에 내용을 기록하는 작업일 뿐, 사용 가능한 노드를 선택하거나 시스템 프록시 모드를 자동으로 정하는 과정은 아닙니다.

순서는 구독 주소가 완전한지 먼저 확인한 다음 수동 업데이트를 한 번 실행하고, 노드 목록에서 원하는 항목을 선택하는 방식이 올바릅니다. 구독 이름은 용도를 구분할 수 있는 짧은 표현으로 지정해 여러 출처가 한 목록에 섞이지 않게 하세요. 업데이트에 실패하면 주소가 잘리지 않았는지, 유효 기간과 기기 시간이 정상인지 먼저 확인하고 클라이언트 설정을 반복해서 삭제하지 마세요.

구독 가져오기 단계 보기 →
Subscription groups v2rayN
구독 그룹 노드 목록 업데이트 기록
현재 구독 업데이트원격 설정 목록 읽기 실행 가능
자동 업데이트클라이언트 설정 주기에 따라 처리 설정됨
그룹 메모구독 출처를 구분하는 용도 입력 권장
다운로드

플랫폼별 선택 클라이언트

데스크톱에서는 v2rayN을 사용하고, Android에서는 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 다운로드 페이지에서 패키지 유형, 시스템 요구 사항과 아키텍처 차이도 이어서 안내합니다.

Windows

Windows 데스크톱에서는 v2rayN을 사용하며, 최신 데스크톱 UI와 클래식 WPF UI 중에서 선택할 수 있습니다. 처음 설치할 때는 시스템 아키텍처를 확인한 뒤 압축 해제 또는 설치, 구독 가져오기, 노드 선택과 시스템 프록시 설정을 진행하세요. 프로그램은 실행되지만 브라우저 트래픽에 변화가 없다면 프로토콜 매개변수를 바로 바꾸기보다 시스템 프록시가 활성화되어 있는지 먼저 확인해야 합니다.

다운로드 페이지로

macOS

macOS 데스크톱에서도 v2rayN을 사용합니다. 다운로드할 때는 기기 프로세서에 맞춰 Apple Silicon 또는 Intel 패키지를 선택해야 하며, 시스템 외관만으로 구분할 수 없습니다. 설치 후 시스템 차단이 발생하면 보안 설정에서 앱 권한을 확인하세요. 구독을 가져온 뒤에는 시스템 프록시로 기본 연결을 먼저 검증하고, 더 깊은 트래픽 인계가 필요한지 판단합니다.

다운로드 페이지로

Android

Android에서는 Xray 코어 기반의 v2rayNG 또는 v2fly 코어를 사용하는 v2flyNG를 선택할 수 있습니다. 최근 출시된 대부분의 기기는 arm64 패키지가 적합하며, 아키텍처를 알 수 없을 때만 범용 패키지를 확인하세요. 구독을 가져온 뒤에는 노드를 직접 선택하고 연결을 시작해야 합니다. 네트워크 환경을 바꾼 후 상태가 이상하면 같은 구독을 반복해서 가져오기보다 먼저 중지한 다음 다시 시작해 보세요.

다운로드 페이지로

Linux

Linux 데스크톱에서는 v2rayN을 사용합니다. 다운로드 페이지에서 일반적인 배포판용 deb 및 rpm 패키지를 제공하고 x64와 arm64 아키텍처를 구분합니다. 설치 후 데스크톱 세션, 트레이 지원과 권한 설정을 확인하세요. 그래픽 데스크톱에서만 사용할 계획이라면 먼저 클라이언트 화면에서 구독과 시스템 프록시를 설정하세요. 라우터 배포는 별도의 사용 방식입니다.

다운로드 페이지로

설치 패키지 선택 방법

플랫폼 이름이 같아도 설치 패키지를 서로 바꿔 쓸 수 있다는 뜻은 아닙니다. 데스크톱에서는 운영체제, 프로세서 아키텍처와 패키지 형식을 확인하고, Android에서는 arm64와 범용 패키지 중 하나를 선택해야 합니다. 확실하지 않다면 먼저 시스템 정보에서 기기 유형을 확인한 뒤 다운로드 페이지의 해당 항목으로 이동하세요. 파일명 길이만 보고 판단하지 마세요.

클라이언트 선택 방법

Windows, macOS와 Linux는 v2rayN부터 시작하면 됩니다. Android에서는 일반적인 구독·라우팅·연결 설정을 제공하는 Xray 코어 기반 v2rayNG를 먼저 살펴보세요. v2fly 코어가 필요할 때 v2flyNG를 고려하면 됩니다. 클라이언트는 여러 개를 설치해 번갈아 쓰기보다 플랫폼과 코어 요구 사항에 따라 선택해야 합니다.

생태계 관계

Project V · V2Fly 및 Xray

프로토콜, 코어, 클라이언트와 구독 서비스라는 네 계층을 먼저 구분한 뒤 문제가 어느 계층에서 발생했는지 판단하세요.

Project V는 단일 데스크톱 프로그램이 아닌 기술 생태계입니다

Project V는 프록시 프로토콜, 전송 방식, 라우팅 규칙과 코어 프로그램을 중심으로 기술 생태계를 이루고 있습니다. 사용자가 일상적으로 접하는 v2rayN, v2rayNG와 v2flyNG는 그래픽 클라이언트로, 화면을 제공하고 구독을 관리하며 설정을 생성하고 코어 실행을 제어합니다. 실제로 인바운드·아웃바운드·프로토콜·라우팅 규칙을 처리하는 것은 클라이언트가 호출하는 코어 프로그램입니다. 따라서 “클라이언트가 열린다”는 것은 UI 계층이 정상이라는 뜻일 뿐, 구독 내용·코어 설정·네트워크 인계까지 올바르게 작동한다는 의미는 아닙니다.

이 관계를 이해하면 문제 해결이 더 명확해집니다. 가져오기에 실패하면 먼저 구독 주소와 클라이언트 파싱을 확인하고, 코어 실행 실패는 프로토콜 필드·포트 점유·로그를 확인해야 합니다. 브라우저가 프록시를 사용하지 않으면 시스템 프록시 또는 TUN을 점검하고, 일부 도메인만 잘못된 출구로 나갈 때는 라우팅 규칙과 DNS를 확인하세요. 모든 장애를 노드 탓으로 돌리면 실제 원인을 놓치고 무의미한 재설치를 반복하게 됩니다.

V2Fly와 Xray는 연관되어 있지만 독립적으로 발전한 코어 계열입니다

V2Fly는 Project V 체계의 핵심 구현과 커뮤니티 유지보수 흐름을 이어받아 일반적인 프로토콜·전송·라우팅 기능을 계속 발전시키고 있습니다. Xray는 관련 기술을 바탕으로 독립적인 코어 구현으로 발전했으며 프로토콜 조합, 전송 방식과 설정 기능을 확장했습니다. 인바운드·아웃바운드·라우팅·DNS처럼 비슷한 개념이 많지만 지원 범위, 필드 세부 사항과 기능 개발 속도는 완전히 같지 않습니다.

설정 파일이나 구독 노드를 사용할 수 있는지는 클라이언트가 호출하는 코어가 해당 프로토콜과 전송 조합을 지원하는지에 달려 있습니다. VMess, VLESS, Trojan, REALITY 같은 이름을 봤을 때 클라이언트 이름만 확인해서는 안 되며 코어 유형과 매개변수의 일치 여부도 확인해야 합니다. 이 사이트의 용어 페이지는 개념 사이의 경계를 설명하고, 설정 매뉴얼은 클라이언트 화면에서 코어 설정으로 이어지는 실제 순서에 따라 안내합니다.

오픈 소스 프로토콜은 검토·분기·지속적인 유지보수를 위한 기반을 제공합니다

v2rayN, v2rayNG, v2flyNG와 관련 코어는 오픈 소스 프로젝트와 커뮤니티의 협업으로 유지됩니다. 오픈 소스는 구현 방식, 설정 구조와 변경 기록을 개발자가 검토할 수 있고, 서로 다른 유지보수 방향이 공통 기술 기반 위에서 계속 발전할 수 있음을 뜻합니다. 일반 사용자에게는 문서·이슈 기록·기능 범위를 공개적으로 논의할 수 있고 클라이언트와 코어 사이의 의존 관계도 쉽게 확인할 수 있다는 점이 직접적인 장점입니다.

오픈 소스라고 해서 모든 설정이 자동으로 올바른 것은 아닙니다. 구독 내용은 해당 서비스 제공자가 전달하고, 라우팅 규칙은 사용자나 클라이언트의 사전 설정에 따라 달라지며, 시스템 권한은 로컬 환경이 제어합니다. 사용할 때는 소프트웨어 자체, 타사 구독과 개인 설정을 구분하고 세 요소를 하나의 판단으로 묶지 마세요. 이 사이트는 클라이언트 경로와 설정 지식만 정리하며 구독 서비스의 계정·회선·고객 지원을 대신하지 않습니다.

업데이트는 클라이언트·코어·구독 세 갈래로 나눠야 합니다

클라이언트 업데이트는 주로 UI, 플랫폼 호환성과 설정 관리를 다루고, 코어 업데이트는 프로토콜 구현·전송 기능·실행 동작에 영향을 줍니다. 구독 업데이트는 노드 목록을 다시 가져오는 작업일 뿐입니다. 세 업데이트의 주기와 출처는 서로 다릅니다. 구독이 갱신되지 않을 때 클라이언트를 업데이트해도 해결되지 않을 수 있고, 코어가 실행되지 않을 때 구독을 반복해서 새로 고쳐도 필드 호환성은 바뀌지 않습니다. 먼저 장애 계층을 판단한 뒤 업데이트 대상을 정하는 것이 안정적인 관리 방법입니다.

업그레이드 전에는 현재 프록시 모드, 사용자 지정 라우팅과 DNS 설정을 기록하세요. 업그레이드 후에는 최소 설정으로 기본 연결을 먼저 확인한 다음 TUN, 프로세스 규칙 또는 복잡한 분할 라우팅을 복원합니다. 새 버전과 이전 버전의 동작이 다르면 로그의 구체적인 단계를 우선 확인하세요. 구독 파싱, 설정 생성, 코어 실행, 시스템 프록시 적용, DNS 조회와 라우팅 매칭은 각각 점검 방향이 다릅니다.

v2rayN: 데스크톱 설정 허브

v2rayN은 Windows, macOS와 Linux 데스크톱 환경을 대상으로 구독 그룹, 노드 관리, 시스템 프록시, 라우팅 규칙, TUN과 로그 확인 기능을 제공합니다. 데스크톱 사용자는 하나의 클라이언트에서 가져오기부터 문제 해결까지 전체 과정을 진행할 수 있습니다. 플랫폼별 설치 패키지와 시스템 권한에는 차이가 있지만 설정 개념은 대체로 같아 여러 데스크톱 기기에서 비슷한 사용 흐름을 유지하려는 사용자에게 적합합니다.

v2rayNG: Android 및 Xray 코어

v2rayNG는 Android에서 널리 사용하는 그래픽 클라이언트로 Xray 코어를 통해 프로토콜과 라우팅 설정을 처리합니다. 구독 또는 단일 노드 공유 링크로 설정을 가져오고, 앱별 프록시·라우팅·DNS·연결 로그 기능을 사용할 수 있습니다. 모바일 데이터와 Wi-Fi를 전환하면 연결 상태가 달라질 수 있으므로 문제 해결 시 시스템 네트워크, 클라이언트 연결과 구독 노드를 함께 확인해야 합니다.

v2flyNG: Android 및 V2Fly 코어

v2flyNG는 v2fly 코어 계열을 사용해야 하는 Android 사용자를 위한 클라이언트로, 설정 개념은 Project V 생태계와 연결되어 있습니다. 선택하기 전에 구독 내용과 프로토콜 조합을 해당 코어가 처리할 수 있는지 확인하세요. 같은 노드가 클라이언트마다 다르게 작동한다면 코어 지원 범위, DNS 설정과 라우팅 규칙을 대조해야 하며 모든 고급 옵션을 그대로 복사해서는 안 됩니다.

사용 환경별 판단

자주 묻는 질문 모음

아래 질문은 관련 장을 빠르게 찾기 위한 것입니다. 자세한 정의, 설정 예시와 문제 해결 순서는 가이드와 용어 설명에서 확인할 수 있습니다.

구독 가져오기는 성공했는데 노드 목록이 비어 있는 이유는 무엇인가요?

구독 주소를 저장한 뒤에는 보통 수동 업데이트를 한 번 실행해야 합니다. 업데이트 후에도 비어 있다면 주소가 완전한지, 구독이 유효한지, 기기 시간이 정확한지, 클라이언트 로그에 파싱 오류가 있는지를 순서대로 확인하세요. 구독 주소와 단일 노드 공유 링크는 서로 다른 입력 유형이므로 각각 알맞은 가져오기 메뉴에 넣어야 합니다.

시스템 프록시, 규칙 모드와 TUN 중 무엇부터 사용해야 하나요?

데스크톱에서는 먼저 시스템 프록시로 브라우저와 일반 앱의 연결을 확인하세요. 도메인이나 주소에 따라 출구를 정해야 할 때는 라우팅 규칙을 사용하고, 시스템 프록시를 읽지 않는 프로그램에는 TUN을 검토합니다. 단계적으로 활성화하면 노드·규칙·시스템 트래픽 인계 문제를 나눠 판단할 수 있습니다.

VMess와 VLESS는 무엇을 기준으로 선택하나요?

서버가 제공하는 프로토콜과 전송 조합, 클라이언트 코어의 지원 여부에 따라 결정해야 하며 프로토콜 이름만 비교해서는 안 됩니다. VMess는 자체 인증 및 암호화 설계를 포함하고, VLESS는 더 가벼운 구조로 TLS·REALITY 같은 보안 전송과 함께 사용하는 경우가 많습니다. 클라이언트 매개변수는 서버 설정과 항목별로 일치해야 합니다.

구독을 업데이트하면 사용자 지정 라우팅이 덮어써지나요?

클라이언트가 구독 그룹과 라우팅 설정을 저장하는 방식에 따라 다릅니다. 일반적으로 사용자 지정 라우팅은 별도 규칙 집합이나 독립 설정으로 분리하고, 크게 변경하기 전에는 백업을 내보내는 것이 좋습니다. 구독 업데이트는 주로 노드 목록을 교체하는 작업이므로 구독 이름·노드·라우팅 규칙을 하나의 객체로 취급해서는 안 됩니다.

프로토콜·코어·라우팅 용어 더 보기 →