클라이언트 사용 안내데스크톱 및 Android

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

운영체제에 맞는 클라이언트를 선택한 뒤 구독 가져오기, 라우팅 설정, 시스템 프록시를 차례로 설정하세요.

데스크톱 클라이언트 v2rayNAndroid 클라이언트Xray 및 V2Fly 코어

가이드 / START HERE

클라이언트를 고르고 설정 항목을 확인하세요

v2rayN은 Windows, macOS, Linux 데스크톱용이며 v2rayNG와 v2flyNG는 Android용입니다. 설치만으로 설정이 끝나는 것은 아닙니다. 사용할 서버 정보나 구독 링크를 준비하고, 서버를 선택한 뒤, 어떤 앱에서 프록시를 사용할지 정하고 코어가 정상적으로 실행되는지 확인해야 합니다. 이 페이지에서는 각 설정이 어떻게 연결되는지 먼저 살펴봅니다. 화면별 설정 방법은 시작 가이드에서 확인할 수 있습니다.

01 플랫폼 및 클라이언트 선택02 구독 또는 서버 가져오기03 라우팅 및 프록시 설정04 연결 상태 확인

구독 링크는 서버 설정을 가져오는 방법이지 클라이언트 설치 파일이 아닙니다. 라우팅 모드는 트래픽을 어디로 보낼지 정하고, 시스템 프록시는 해당 설정을 따르는 앱이 요청을 클라이언트로 전달할 수 있게 합니다. 개념을 구분해 두면 연결 문제를 하나씩 점검할 수 있어 클라이언트를 반복해서 다시 설치할 필요가 없습니다.

클라이언트 설정 / SETTINGS

자주 쓰는 설정 5가지, 순서대로 확인

아래 화면은 설정 항목 이름과 알아보기 쉬운 예시 값을 보여줍니다. 실제 서버 설정이 아니라 메뉴 위치를 안내하기 위한 예시입니다. 주제를 선택하고 오른쪽 설명을 읽은 다음 해당 가이드에서 설정을 진행하세요.

v2rayN / 구독 그룹
그룹 이름작업 설정
구독 주소 · 예시https://example.com/sub
현재 구독 업데이트 ↗
01 / 05

v2rayN 구독 가져오기

‘구독 그룹’에서 새 그룹을 만들고 서비스 제공자가 안내한 V2Ray 구독 링크를 입력한 다음 ‘구독 업데이트’를 실행하세요. 그룹 이름은 이 기기에서 구분하기 위한 것이며, 연결에 필요한 링크는 서비스 제공자가 제공해야 합니다. 화면에 표시된 예시 주소로는 연결할 수 없습니다. 업데이트가 끝나면 해당 그룹에서 서버를 선택하세요. 목록이 바뀌지 않으면 링크가 온전한지, 올바른 그룹을 선택했는지 확인한 뒤 클라이언트 로그를 살펴보세요. 여러 곳의 구독은 그룹을 따로 만들어 두면 나중에 업데이트하거나 필터링할 때 변경된 설정의 출처를 쉽게 찾을 수 있습니다.

구독 가져오기 가이드 보기 →

설정에는 정해진 순서가 있습니다. 먼저 구성을 가져와 서버를 선택하고, 코어가 해당 구성을 읽을 수 있는지 확인한 다음 라우팅과 시스템 프록시를 설정하세요. Android에서는 클라이언트 자체의 연결 제어와 앱별 프록시 옵션을 사용할 수 있습니다. 데스크톱 트레이 메뉴의 설정 이름이나 조작 방법을 휴대전화에 그대로 적용할 수는 없습니다. 문제가 발생하면 여러 항목을 한꺼번에 바꾸기보다 클라이언트, 운영체제, 프로토콜 항목, 로그 메시지를 기록해 하나씩 확인하는 편이 원인을 찾기 쉽습니다.

플랫폼별 다운로드 / DOWNLOADS

운영체제에 맞는 다운로드 페이지 선택

데스크톱에서는 v2rayN을 사용하고, Android에서는 코어 요구 사항에 따라 v2rayNG 또는 v2flyNG를 선택할 수 있습니다. 다운로드 페이지에서 프로세서 아키텍처와 설치 파일 형식을 확인하세요. 운영체제가 다른 파일은 서로 바꿔 사용할 수 없으므로 다운로드 전에 기기 정보를 확인해야 합니다.

Windows

v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 평소 사용할 인터페이스를 고려한 뒤 다운로드 페이지의 버전 설명을 확인해 선택하세요. 설치 후에는 트레이 메뉴에서 시스템 프록시를 관리할 수 있습니다.

다운로드 페이지로 이동

macOS

v2rayN은 Apple Silicon과 Intel용 다운로드를 따로 제공합니다. 시스템의 칩 정보를 확인해 해당 설치 파일을 선택하세요. 사용할 때는 브라우저와 터미널의 프록시 설정이 일치하는지도 살펴보세요.

다운로드 페이지로 이동

Android

먼저 Xray 코어를 사용하는 v2rayNG를 확인하세요. V2Fly 계열 코어가 필요하다면 v2flyNG와 비교해 선택하면 됩니다. 두 클라이언트 모두 기기 아키텍처에 맞는 설치 파일을 제공합니다.

다운로드 페이지로 이동

Linux

v2rayN은 패키지 형식과 기기 아키텍처에 따라 다운로드 항목이 다릅니다. 배포판에서 deb와 rpm 중 어떤 형식을 사용하는지 확인하고 프로세서 아키텍처도 대조하세요. 설치를 마친 뒤 구독을 가져오면 됩니다.

다운로드 페이지로 이동

전체 클라이언트 보기 →

오픈 소스 생태계 / CONTEXT

Project V, 코어 및 클라이언트의 관계

세 가지 계층을 이해하고 프로토콜과 클라이언트를 선택하세요.

Project V
프로젝트 배경
V2Fly / Xray
코어 계열
v2rayN / v2rayNG / v2flyNG
그래픽 클라이언트

Project V에서 코어 계열까지

Project V는 V2Ray 관련 소프트웨어와 프로토콜이 발전해 온 중요한 배경입니다. 프로젝트와 커뮤니티가 발전하면서 V2Fly와 Xray는 서로 다른 코어 개발 경로를 형성했습니다. 두 코어 모두 설정을 해석하고 인바운드·아웃바운드 연결을 처리하며 라우팅 규칙을 적용하지만, 지원 기능과 설정 항목이 항상 똑같지는 않습니다. 서버 설정을 살펴볼 때는 ‘어떤 프로토콜을 사용하는가’와 ‘어떤 코어로 실행하는가’를 구분하세요. 그래픽 인터페이스에 특정 옵션이 보인다고 해서 모든 코어가 그 옵션을 같은 방식으로 처리하는 것은 아닙니다.

일상적인 관리는 그래픽 클라이언트에서

v2rayN, v2rayNG, v2flyNG는 기기에 따라 선택하는 오픈 소스 그래픽 클라이언트입니다. 서버 편집, 구독 업데이트, 라우팅 선택, 연결 제어를 사용하기 쉬운 화면에 모아 설정 파일을 직접 편집할 일을 줄여 줍니다. v2rayN은 데스크톱 운영체제용이고 v2rayNG와 v2flyNG는 Android용이며, 두 Android 클라이언트는 사용하는 코어 계열이 다릅니다. 클라이언트 이름, 프로토콜 이름, 코어 이름은 서로 다른 계층입니다. 설치 파일을 고를 때는 운영체제를, 설정 호환성을 확인할 때는 코어와 프로토콜을 살펴보세요.

오픈 소스 코드와 업데이트

이 클라이언트와 관련 코어는 오픈 소스 커뮤니티에서 유지 관리합니다. 공개된 코드는 개발자가 구현을 검토하고 개선 사항을 제안하며 프로토콜 기능의 변화를 따라가는 데 도움이 됩니다. 오픈 소스라고 해서 일상적인 설정 확인이 필요 없어지는 것은 아닙니다. 구독 제공자가 서버 설정을 바꿀 수 있고 코어 업데이트에 따라 항목 처리 방식이 달라질 수도 있습니다. 원본 구독 정보를 보관하고 클라이언트 업데이트 안내를 확인하며 문제가 생기면 로그를 살펴보는 것이 연결 아이콘만 확인하는 것보다 안전한 관리 방법입니다. 여러 기기에서 같은 구독을 사용하더라도 각 클라이언트가 해당 프로토콜과 전송 옵션을 지원하는지 따로 확인해야 합니다.

이 정보를 바탕으로 클라이언트 선택하기

주로 컴퓨터에서 사용한다면 운영체제에 맞는 v2rayN을 선택하고 기기 아키텍처에 맞는 설치 파일을 받으세요. 휴대전화에서는 v2rayNG부터 살펴보고, 현재 설정에 V2Fly 계열 코어가 필요한 경우 v2flyNG를 고려할 수 있습니다. 기존 구독을 사용하는 경우에는 구독에 실제로 포함된 프로토콜과 전송 설정부터 확인하세요. 이름이 더 새로워 보인다는 이유만으로 정상 작동하는 서버 설정을 바꿀 필요는 없습니다. VMess, VLESS, Trojan, Shadowsocks 및 REALITY의 차이와 역할을 자세히 비교하려면 기술 참고 자료를 확인하세요.

프로토콜 및 코어 기술 참고 자료 보기 →

자주 묻는 질문 / QUICK ANSWERS

설정 전에 확인할 질문

아래 답변은 설치와 연결 과정에서 자주 헷갈리는 내용을 다룹니다. 전체 설정 절차나 더 많은 문제 해결 방법은 시작 가이드와 자주 묻는 질문 페이지에서 확인하세요.

구독 링크는 어디에 입력하나요?

데스크톱에서는 v2rayN의 ‘구독 그룹’에서 새 그룹을 만들고 링크를 입력한 다음 해당 그룹을 업데이트하세요. 구독 주소를 개별 서버 편집 창의 서버 주소 칸에 입력하면 안 됩니다. 설정 단계 보기 →

서버를 선택했는데 앱에서 프록시를 사용하지 않는 이유는 무엇인가요?

먼저 코어가 정상적으로 실행되는지 확인한 다음 ‘시스템 프록시 자동 설정’과 앱 자체의 프록시 설정을 살펴보세요. 터미널 명령줄과 브라우저는 서로 다른 설정을 참조할 수 있습니다. 문제 해결 순서 보기 →

REALITY는 클라이언트인가요?

REALITY는 설정에서 전송 계층 보안과 관련된 옵션이며 별도로 설치하는 클라이언트가 아닙니다. 직접 설정을 입력할 때는 프로토콜 유형, 전송 방식, 서버 매개변수를 각각 확인하세요. 개념 빠르게 보기 →

휴대전화와 컴퓨터에서 같은 구독을 사용할 수 있나요?

대체로 각 기기의 클라이언트에서 구독을 가져온 뒤 양쪽 모두 구독에 포함된 프로토콜과 전송 설정을 지원하는지 확인해야 합니다. 연결 제어와 시스템 프록시 설정 위치는 기기마다 다르므로 각각 설정하세요. 클라이언트 비교 →