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

V2Ray위키 v2rayN 클라이언트 다운로드 및 설정

오픈 소스 클라이언트 3종, 4개 플랫폼 다운로드 경로, 한국어 설정 절차를 한곳에 모아 구독 가져오기부터 라우팅, DNS, 연결 문제 해결까지 주제별로 안내합니다.

Xray · V2Fly 커널 계열 오픈 소스 v2rayN · v2rayNG · v2flyNG
기기에 맞게 선택

4개 플랫폼 클라이언트 다운로드

현재 사용하는 기기에 맞는 플랫폼으로 이동한 뒤 프로세서 아키텍처와 설치 형식에 맞춰 파일을 선택하세요. 데스크톱은 v2rayN을 주로 사용하며, Android에서는 커널 요구 사항에 따라 v2rayNG 또는 v2flyNG를 선택할 수 있습니다.

데스크톱 추천

Windows

Windows에서는 v2rayN 데스크톱 버전과 클래식 WPF 버전 중에서 선택할 수 있습니다. 데스크톱 버전은 크로스플랫폼 UI를 사용해 일관된 조작 방식을 원하는 사용자에게 적합하고, WPF 버전은 전통적인 Windows 레이아웃을 유지해 시스템 프록시, 구독 그룹, 라우팅 규칙과 로그 메뉴를 주 창에서 관리합니다.

다운로드로 이동
칩셋별 패키지

macOS

macOS에서는 v2rayN 데스크톱 클라이언트를 사용하며, 다운로드 전에 기기의 칩을 확인해야 합니다. 시스템 정보에 Apple 칩이 표시되면 ARM64, Intel로 표시되면 x64를 선택하세요. 처음 실행한 뒤 구독을 가져오고 메뉴 막대와 주 창에서 연결 상태와 시스템 프록시를 관리할 수 있습니다.

다운로드로 이동
다양한 패키지 형식

Android

Android에서는 v2rayNG를 우선 선택할 수 있습니다. Xray 커널을 기반으로 구독, QR 코드 가져오기, 앱별 프록시와 일반적인 라우팅 모드를 지원합니다. V2Fly 커널이 필요하면 v2flyNG를 선택하세요. 최근 출시된 대부분의 스마트폰은 arm64를 사용하며, 아키텍처를 확인할 수 없다면 범용 설치 파일을 선택하면 됩니다.

다운로드로 이동
다양한 패키지 형식

Linux

Linux 데스크톱에서는 v2rayN을 사용할 수 있으며 배포판에 맞춰 deb 또는 rpm 패키지를 선택합니다. Debian과 Ubuntu 등은 보통 deb, Fedora와 Rocky Linux 등은 보통 rpm을 사용합니다. 프로세서에 따라 x64와 ARM64도 구분해야 합니다. 설치 후 데스크톱 메뉴에서 실행하고 기존 구독을 가져오면 됩니다.

다운로드로 이동
설정 핵심

구독부터 라우팅까지 핵심 설정

클라이언트 기능은 다양하지만 일상적인 사용에서는 네 가지 설정부터 익히면 됩니다. 구독은 설정을 가져오고, 라우팅은 트래픽 경로를 정하며, DNS는 도메인을 해석하고, TUN은 시스템 프록시를 읽지 않는 앱의 트래픽을 넘겨받습니다.

구독 관리

그룹, 업데이트 및 서버 필터

구독 링크는 서버 설정을 일괄적으로 가져오는 수단이며 클라이언트 자체를 의미하지 않습니다. 가져온 뒤에는 먼저 구독 그룹에 이름을 지정하고 수동 업데이트를 실행해 서버 목록이 현재 그룹에 저장되었는지 확인하세요. 여러 구독은 출처별로 관리해야 업데이트 과정에서 서로 덮어쓰는 일을 피할 수 있습니다. 이름 필터는 긴 목록에서 특정 지역, 프로토콜 또는 용도의 서버를 찾을 때 유용합니다. 업데이트에 실패하면 클라이언트를 반복해서 삭제하기보다 링크가 완전한지, 그룹이 비활성화되지 않았는지, 시스템 시간이 정확한지부터 확인하세요. 이렇게 구성하면 모든 설정을 하나의 목록에 쌓는 것보다 관리하기 쉽고 오래된 설정을 잘못 선택하는 일도 줄어듭니다.

다중 구독 관리 보기 →
업무용 구독별도 그룹
일상용 구독필요할 때 업데이트
이름 필터
빠른 시작

처음 연결까지 3단계

기본 연결을 먼저 완성한 다음 라우팅, DNS와 TUN을 하나씩 추가하세요. 각 단계의 결과가 분명해져 문제가 생겨도 어느 과정에서 발생했는지 빠르게 판단할 수 있습니다.

01

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

Windows, macOS와 Linux 데스크톱에서는 v2rayN을 사용하고 Android에서는 v2rayNG를 우선 선택하세요. V2Fly 커널이 필요하다면 v2flyNG를 사용합니다. 다운로드 전에 운영체제, 프로세서 아키텍처와 패키지 형식을 확인하고 설치 후에는 고급 옵션을 서둘러 변경하지 말고 클라이언트의 기본 화면부터 여세요. 데스크톱에서 시스템 구성 요소 안내가 표시되면 설치 페이지의 설명에 따라 실행 환경을 준비하세요. Android에서 처음 연결할 때는 시스템 네트워크 권한 창이 나타나며, 승인해야 클라이언트가 연결을 만들 수 있습니다.

첫 실행의 목표는 클라이언트가 정상적으로 열리고 메뉴와 설정 페이지에 접근할 수 있는지 확인하는 것입니다. 이 단계에서는 기본 라우팅과 기본 DNS를 유지하고, 설정을 가져오기 전에 많은 스위치를 바꾸지 마세요.

02

구독을 가져오고 서버 선택

서비스 제공업체에서 완전한 구독 링크를 받아 클라이언트에 새 구독 그룹을 만들고 링크를 붙여 넣은 다음 업데이트를 실행하세요. 업데이트가 끝나면 서버 목록에 항목이 표시되는지 확인하고 그중 하나를 활성 서버로 선택합니다. 목록이 비어 있다면 링크가 빠짐없이 복사되었는지, 구독 그룹이 활성화되어 있는지, 네트워크와 시스템 시간이 정상인지부터 확인하세요. 구독 주소를 브라우저 검색창에 직접 붙여 넣지 말고, 출처가 다른 링크를 하나의 기록으로 합치지도 마세요.

서버 이름은 식별을 위한 라벨일 뿐이며 실제 사용 가능 여부는 연결 결과와 로그로 판단해야 합니다. 처음 테스트할 때는 설정 하나를 선택해 기본 접속이 정상인지 확인한 뒤 다른 서버와 비교하세요. 여러 설정을 계속 바꾸면 결과가 혼란스러워집니다.

03

연결을 시작하고 프록시 상태 확인

서버를 선택한 뒤 클라이언트를 시작하고 데스크톱에서는 시스템 프록시를 활성화하세요. Android에서는 시스템 네트워크 권한을 승인합니다. 이후 브라우저로 자주 사용하는 웹페이지를 열어 도메인 해석과 페이지 로딩이 모두 정상인지 확인하세요. 클라이언트가 실행 중으로 표시된다는 것은 프로세스가 시작되었다는 뜻일 뿐 모든 앱이 자동으로 프록시를 읽는다는 의미는 아닙니다. 브라우저는 정상인데 다른 프로그램이 연결되지 않는다면 해당 프로그램이 시스템 프록시를 따르는지 먼저 확인하고, 앱 내부 프록시를 설정할지 TUN을 활성화할지 결정하세요.

문제가 발생하면 “구독에 내용이 있는지, 서버가 선택되었는지, 시스템 프록시가 켜져 있는지, DNS가 적절한 결과를 반환하는지, 라우팅이 예상한 규칙과 매칭되는지” 순서로 확인하세요. 연결 과정을 따라 하나씩 점검하는 편이 여러 모드를 동시에 바꾸는 것보다 원인을 찾기 쉽습니다.

오픈 소스 생태계

Project V, V2Fly와 Xray의 관계

커널, 프로토콜과 그래픽 클라이언트의 역할을 이해하면 “클라이언트 이름”, “커널 이름”과 “서버 프로토콜”을 서로 혼동하는 일을 피할 수 있습니다.

프로토콜 코어부터 그래픽 클라이언트까지

Project V는 네트워크 프록시 프로토콜과 도구를 중심으로 형성된 오픈 소스 기술 생태계입니다. 초기 V2Ray는 설정 구조, 인바운드·아웃바운드 모델, 라우팅 시스템과 다양한 전송 조합의 기반을 마련했습니다. 커뮤니티가 계속 발전하면서 V2Fly와 Xray는 대표적인 커널 계열 분기로 자리 잡았습니다. 두 커널 모두 설정을 바탕으로 트래픽을 처리하는 방식을 이어가지만 프로토콜 지원, 전송 기능, 설정 세부 사항과 업데이트 주기에는 각기 다른 중점이 있습니다.

커널은 프로토콜 해석, 연결 수립, 라우팅 매칭, DNS 조회와 트래픽 전달을 담당하고, 그래픽 클라이언트는 이를 구독 관리, 서버 목록, 시스템 프록시 스위치, 로그와 설정 화면으로 정리합니다. 따라서 v2rayN, v2rayNG와 v2flyNG는 서로 무관한 세 가지 프로토콜이 아닙니다. 각기 다른 플랫폼과 커널 선택을 위한 클라이언트 외피이며, 사용자가 화면에서 가져온 VMess, VLESS, Trojan, REALITY 등의 설정은 결국 해당 커널이 처리합니다.

이런 계층 구조는 동일한 구독이 클라이언트마다 조금씩 다른 설정 항목으로 표시될 수 있는 이유도 설명합니다. 구독 내용은 서버 매개변수를 제공하고, 클라이언트는 이를 해석해 표시하며, 커널은 실제 지원 범위를 결정합니다. 가져오기에 실패하면 먼저 프로토콜 필드와 클라이언트 지원 여부를 확인하고, 연결 후 라우팅이 비정상적이면 클라이언트 이름만 보지 말고 라우팅, DNS와 현재 커널을 중점적으로 살펴보세요.

V2Fly

V2Ray 설정 체계의 계승

V2Fly 커뮤니티가 유지 관리하는 커널은 인바운드, 아웃바운드, 라우팅, DNS와 다양한 전송 설정을 포함해 V2Ray의 핵심 아키텍처를 이어갑니다. v2flyNG는 이 커널 계열을 기반으로 하므로 관련 설정 호환성이 필요한 Android 사용자에게 적합합니다.

Xray

v2rayN과 v2rayNG에서 주로 사용

Xray 커널은 VLESS, XTLS Vision, REALITY 등의 조합에서 자주 사용됩니다. v2rayN과 v2rayNG는 보통 Xray 기능을 중심으로 그래픽 설정을 제공하지만, 실제 사용 가능한 항목은 현재 설정과 클라이언트 구현에 따라 달라집니다.

v2rayN: 데스크톱 플랫폼 클라이언트

Windows, macOS와 Linux를 대상으로 구독, 서버, 시스템 프록시, 라우팅 규칙, DNS와 TUN을 한곳에서 관리합니다. 데스크톱 환경이 달라도 조작 방식이 비슷해 여러 컴퓨터에서 동일한 설정 절차를 사용하기 좋습니다.

v2rayNG: Android용 Xray 클라이언트

QR 코드, 클립보드와 구독 가져오기를 제공하며 앱별 프록시와 시스템 네트워크 권한을 지원합니다. 모바일 기기의 연결 흐름에 맞춘 화면으로 구성되어 있어 일반적인 Xray 설정을 서버 목록에서 바로 관리할 수 있습니다.

v2flyNG: V2Fly 커널 대안

이 클라이언트 역시 Android용이며 V2Fly 커널 계열을 사용하는 점이 가장 큰 차이입니다. 클라이언트를 선택할 때는 화면 이름만 비교하지 말고 구독에 필요한 프로토콜, 전송 방식과 커널 호환성을 확인해야 합니다.

설정 글

최근 업데이트된 활용 포인트

모바일 권한, 프로토콜 원리부터 DNS 라우팅까지 구체적인 문제별로 설명합니다. 기본 연결을 마친 뒤 이어서 읽기 좋습니다.

안드로이드 활용

v2rayNG Android 사용 핵심: VpnService 권한, 배터리 최적화 예외와 앱별 프록시 설정

Android에서 v2rayNG를 사용할 때 중요한 세 가지 설정을 정리합니다. 처음 연결할 때의 시스템 네트워크 권한 절차, 백그라운드 연결 끊김을 막기 위한 배터리 최적화 예외 설정, 앱별 트래픽 경로 지정 방법을 다룹니다.

전체 글 읽기 →
프로토콜 해설

REALITY와 XTLS Vision 원리 해설: 차세대 전송 방식이 더 빠른 이유

TLS 핸드셰이크와 암호화 처리 비용부터 시작해 REALITY의 핸드셰이크 방식과 XTLS Vision이 중복 처리를 줄이는 원리를 설명하고, 두 기술의 조합이 연결 지연 시간과 처리량에 미치는 영향을 살펴봅니다.

전체 글 읽기 →
DNS와 라우팅

V2Ray DNS 설정 상세 가이드: 중국 본토·해외 도메인 분할 해석과 오염 방지

도메인별 DNS 경로 구분, 상위 서버 지정, DoH 암호화 조회 설정 방법을 설명하고, 라우팅 매칭과 DNS 결과를 기준으로 연결 문제를 점검하는 방법을 안내합니다.

전체 글 읽기 →