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

V2Ray 지식 베이스
클라이언트 다운로드 및 설정

v2rayN 다운로드 가이드 보기

v2rayN 및 v2rayNG 다운로드, 구독 가져오기, 라우팅 분기와 문제 원인 파악 방법을 한곳에 정리했습니다. 먼저 운영체제에 맞는 클라이언트를 선택한 뒤 문서에 따라 설정하세요.

영구 무료 오픈 소스 다중 코어 생태계 한국어 문서
Windows Android macOS Linux

클라이언트 기능

구독 가져오기부터 라우팅 분기까지

v2rayN과 v2rayNG는 코어 설정, 서버 관리, 시스템 네트워크 설정을 그래픽 인터페이스에서 통합 관리합니다. 아래 기능은 실제 사용 순서에 맞춰 구성했으므로 먼저 진입점을 파악한 다음 트래픽을 더 깊게 가로챌지 결정하세요.

v2rayN · 서버 관리
서버 목록
구독 그룹
라우팅 설정
매개변수 설정
로그
별칭 프로토콜 그룹
현재 서버 VLESS 기본 그룹
보조 설정 VMess 수동 관리
시스템 프록시: 자동 설정 · 라우팅: 규칙 모드

서버 관리

구독 주소 가져오기 및 그룹 관리

구독 가져오기는 여러 서버 설정을 한 번에 받아 관리할 때 유용합니다. 데스크톱에서는 보통 ‘구독 그룹’에서 항목을 만든 뒤 전체 주소를 입력하고 업데이트를 실행하며, Android에서는 구독 설정에서 추가할 수 있습니다. 클라이언트는 응답 내용을 서버 목록으로 변환하지만, 구독 주소가 있다고 연결이 자동으로 설정되는 것은 아닙니다.

가져온 뒤에는 목록에 선택 가능한 설정이 표시되는지 먼저 확인하고, 항목 하나를 현재 서버로 선택하세요. 여러 출처를 사용한다면 그룹을 나누어 업데이트 시 섞이지 않도록 하는 것이 좋습니다. 업데이트가 끝났는데 목록이 비어 있다면 주소가 완전한지, 그룹이 활성화되어 있는지, 로그에 파싱 오류가 있는지부터 확인하세요.

운영체제별 선택

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

데스크톱에서는 먼저 v2rayN을 확인하고, Android에서는 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 다운로드 페이지에서 프로세서 아키텍처, 설치 패키지 유형, 시스템 요구 사항을 자세히 구분합니다.

Windows

v2rayN 데스크톱 버전 또는 클래식 WPF 버전을 사용하세요. 데스크톱 버전은 크로스플랫폼 인터페이스를 사용하고, WPF 버전은 전통적인 Windows 사용 방식을 선호하는 사용자에게 적합합니다. 설치 전에 시스템 아키텍처와 실행 환경을 확인하세요.

다운로드 페이지로 이동

macOS

v2rayN 데스크톱 버전을 사용하세요. 다운로드할 때 Apple Silicon과 Intel 프로세서를 구분해야 하며, 처음 실행할 때 시스템의 개인정보 보호 및 보안 설정에서 앱과 네트워크 권한을 확인해야 할 수 있습니다.

다운로드 페이지로 이동

Android

v2rayNG를 우선 사용하고, 코어 요구 사항에 따라 v2flyNG를 선택할 수도 있습니다. 대부분의 최신 기기는 arm64 설치 패키지를 사용하며, 프로세서 유형을 확인하기 어렵다면 다운로드 페이지의 범용 버전 안내를 참고하세요.

다운로드 페이지로 이동

Linux

v2rayN 데스크톱 버전을 사용하고 배포판에 맞춰 deb 또는 rpm 패키지를 선택한 뒤 프로세서에 따라 x64 또는 arm64를 고르세요. 설치 후 시작되지 않으면 데스크톱 실행 항목과 터미널 로그를 각각 확인해 의존성 문제를 점검하세요.

다운로드 페이지로 이동
모든 클라이언트 보기 →

빠른 시작

설치, 가져오기, 확인의 세 단계

처음부터 모든 고급 옵션을 동시에 조정할 필요는 없습니다. 먼저 클라이언트가 정상적으로 불러올 수 있는 연결을 하나 만든 뒤 자동 업데이트, 라우팅 규칙, TUN 설정을 단계적으로 추가하세요.

  1. 01

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

    Windows, macOS, Linux에서는 v2rayN을 사용하고 Android에서는 v2rayNG 또는 v2flyNG를 사용합니다. 설치 전에 프로세서 아키텍처와 설치 패키지 형식을 확인하고, 처음 실행할 때 시스템 안내에 따라 필요한 권한을 설정하세요. 프로그램이 시작되지 않으면 먼저 실행 환경, 압축 해제 폴더, 폴더 쓰기 권한을 확인하고 서둘러 설정을 가져오지 마세요.

  2. 02

    구독을 가져오고 서버 선택

    구독 관리에서 그룹을 추가하고 전체 구독 주소를 붙여 넣은 뒤 수동으로 업데이트하세요. 목록에 내용이 표시되면 서버 하나를 선택해 활성 항목으로 지정합니다. 단일 공유 링크를 사용하는 경우 클립보드에서 가져올 수 있지만, 프로토콜, 주소, 포트, 전송 매개변수가 빠짐없이 인식되었는지 확인해야 합니다. 구독 업데이트와 클라이언트 업데이트는 별개의 작업입니다.

  3. 03

    프록시를 켜고 단계별로 확인

    데스크톱에서는 먼저 시스템 프록시를 활성화하고, Android에서는 시스템 안내에 따라 네트워크 연결을 설정하세요. 확인할 때는 클라이언트 상태, 로그, 대상 앱의 동작을 각각 관찰합니다. 시스템 프록시가 정상적으로 작동한 뒤 실제 필요에 따라 라우팅 분기나 TUN을 설정하세요. 터미널 프로그램만 연결되지 않는다면 해당 프로그램의 프록시 변수와 포트 설정을 별도로 확인하세요.

설정 문제는 범위를 먼저 좁히세요

먼저 클라이언트가 시작되는지 확인하고, 다음으로 구독이 업데이트되는지 확인한 뒤 서버 하나를 테스트하고 마지막으로 시스템 트래픽 가로채기를 점검하세요. 한 번에 하나의 조건만 바꾸면 로그의 오류를 특정 단계와 더 쉽게 연결할 수 있습니다.

전체 가이드 보기

오픈 소스 생태계

Project V, V2Fly, Xray의 관계

클라이언트, 코어, 프로토콜, 구독 서비스는 서로 다른 계층에 있습니다. 이 계층을 이해하면 인터페이스 문제, 설정 문제, 코어 문제를 혼동하지 않을 수 있습니다.

생태계의 역사와 프로젝트 분기

Project V는 V2Ray 설정 모델과 프로토콜 생태계의 기반을 마련했습니다. 커뮤니티가 성장하면서 V2Fly는 관련 핵심 기능을 이어받아 유지했고, Xray는 기존 설정 방식을 호환하면서 프로토콜, 전송, 라우팅 기능을 확장했습니다. 두 프로젝트 모두 개방형 협업으로 발전한 코어 계열이지만, 릴리스 주기와 설정 필드, 기능 지원이 항상 완전히 일치하는 것은 아닙니다.

따라서 ‘V2Ray 클라이언트’는 일반적으로 특정 코어 파일 하나가 아니라 이 생태계를 기반으로 만든 그래픽 관리 도구를 뜻합니다. VMess, VLESS, Trojan, REALITY, gRPC 같은 용어를 보았다면 각각 프로토콜, 보안 계층, 전송 방식 중 어디에 해당하는지 구분한 뒤 현재 클라이언트가 호출하는 코어가 해당 조합을 지원하는지 확인하세요.

세 클라이언트의 역할

v2rayN은 데스크톱 시스템에서 구독 그룹, 서버 목록, 시스템 프록시, TUN, 라우팅, 로그 진입점을 관리합니다. v2rayNG는 Android용으로, 일반적인 설정을 Xray 코어가 처리합니다. v2flyNG 역시 Android용이지만 V2Fly 코어 생태계에 더 가깝습니다. 세 클라이언트 모두 그래픽 인터페이스로 설정 관리 부담을 줄이지만, 실제 연결 기능은 코어와 설정에 의해 결정됩니다.

클라이언트 코드는 공개되어 있어 기능 변경, 설정 생성 방식, 문제 수정 기록을 확인할 수 있습니다. 오픈 소스라고 해서 모든 분기의 인터페이스나 기본값이 동일한 것은 아닙니다. 클라이언트를 옮길 때는 이름만 비교하지 말고 구독 호환성, 라우팅 규칙, DNS 설정, 로컬 수신 포트를 확인하세요.

프로토콜 라이선스와 커뮤니티 유지 관리

오픈 소스 라이선스는 코드 사용, 수정, 재배포 조건을 규정하며 구체적인 조항은 각 프로젝트가 소프트웨어와 함께 제공하는 라이선스 파일을 기준으로 합니다. 클라이언트와 코어는 서로 다른 유지 관리자와 커뮤니티 참여자들이 계속 개선하며 릴리스 주기도 독립적입니다. 클라이언트를 업데이트할 때 인터페이스와 코어가 함께 바뀔 수도 있고, 클라이언트가 두 구성 요소를 별도로 관리할 수도 있습니다.

일상적인 관리에서는 현재 작동하는 설정과 핵심 옵션을 기록해 두세요. 업데이트 후에는 먼저 코어가 정상적으로 시작되는지 확인하고 구독, 라우팅, 시스템 트래픽 가로채기를 점검합니다. 새 설정 필드를 인식하지 못한다면 로그의 명확한 오류를 확인하고 클라이언트와 코어의 지원 범위를 점검하세요. 여러 옵션을 반복해서 바꾸기보다 재현 가능한 단계로 돌아가는 편이 원인을 찾는 데 유리합니다.

최근 문서

클라이언트 설정과 문제 해결

아래 세 글에서는 코어 시작 실패, 데스크톱 버전 선택, 시스템 프록시가 적용되지 않는 문제를 각각 다룹니다. 모두 관찰 가능한 증상에 따라 점검 경로를 나누어 로그나 시스템 설정에서부터 원인을 찾기 쉽도록 구성했습니다.

문제 해결

코어가 시작되지 않아도 재설치부터 하지 마세요: 로그로 설정 오류 찾기

로그 위치와 시작 실패 시 자주 나타나는 메시지, 포트 충돌·설정 필드 오류·불완전한 구독 정보에 맞는 조치 방법을 설명합니다.

글 읽기 →
플랫폼 가이드

v2rayN 데스크톱 버전과 WPF 버전의 차이: 두 설치 패키지 중 무엇을 선택할까

시스템 지원, 인터페이스 차이, 실행 환경, 업그레이드 방식 네 가지 기준으로 데스크톱 버전과 Windows 전용 WPF 버전을 비교합니다.

글 읽기 →
문제 해결

시스템 프록시를 켰는데 적용되지 않을 때: 브라우저와 터미널을 나눠 점검하기

브라우저에서는 시스템 설정 적용 여부와 확장 프로그램 충돌을 확인하고, 터미널에서는 프록시 환경 변수, 수신 주소, 로컬 포트를 점검합니다.

글 읽기 →
전체 글 보기 →