클라이언트 선택 · 구독 가져오기 · 라우팅 설정

V2Ray 백과v2rayN 클라이언트 다운로드 및 가이드

플랫폼에 맞는 오픈 소스 클라이언트를 선택하고 구독 가져오기부터 프록시 모드와 라우팅 설정까지 차례로 구성하세요.

V2Ray 클라이언트 다운로드

데스크톱에서는 v2rayN, 안드로이드에서는 v2rayNG를 먼저 살펴보세요. 다운로드 페이지에서 프로세서 아키텍처와 설치 파일 형식에 맞는 항목을 선택하면 됩니다.

Windows

v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 익숙한 클래식 레이아웃을 유지합니다. 두 버전 모두 구독과 라우팅을 관리할 수 있습니다.

설치 전에 시스템 설정에서 프로세서 종류를 확인하세요. 런타임 설치 안내가 나타나면 해당 지침을 따르세요. 구독을 계속 바꿀 필요는 없습니다. 프로그램이 실행되지 않는 문제와 구독 사용 가능 여부는 서로 별개의 문제입니다.

다운로드 페이지로 Windows 클라이언트→

macOS

v2rayN을 선택한 뒤 ‘이 Mac에 관하여’에 표시된 칩 정보를 확인해 Apple Silicon 또는 Intel용 설치 파일을 고르세요. 기기 외관으로 판단하기보다 설치 파일의 아키텍처를 컴퓨터 칩에 맞추는 편이 정확합니다.

처음 실행할 때 시스템 보안 알림이 표시되면 소프트웨어 출처와 알림 내용을 먼저 확인한 뒤 시스템에서 제공하는 절차에 따라 진행하세요. 설정을 마친 후 시스템 프록시가 적용되었는지 확인하고, 관리자 권한이 필요한 기능은 별도로 허용하세요.

다운로드 페이지로 macOS 클라이언트→

Android

Xray 코어를 사용하는 v2rayNG를 우선 살펴보세요. V2Fly 코어가 필요하다면 v2flyNG를 확인할 수 있습니다. 최근 출시된 주요 스마트폰은 대부분 arm64를 사용합니다. 아키텍처를 확인하기 어렵다면 범용 버전 안내를 참고하세요.

안드로이드는 VPN 인터페이스로 연결을 처리하므로 처음 실행할 때 시스템 권한을 허용해야 합니다. 백그라운드로 전환한 뒤 연결이 끊긴다면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 모든 문제를 구독 형식 탓으로 돌리지는 마세요.

다운로드 페이지로 Android 클라이언트→

Linux

v2rayN은 deb 및 rpm 설치 파일을 제공하며 x64와 arm64 아키텍처를 구분합니다. 먼저 배포판의 패키지 형식을 확인한 다음 아키텍처가 맞는 파일을 선택하세요. 설치 파일 형식과 프로세서 종류를 혼동하지 않도록 주의하세요.

데스크톱 환경마다 시스템 프록시를 읽는 방식이 다를 수 있습니다. 브라우저는 연결되지만 다른 프로그램은 연결되지 않는다면 해당 프로그램이 데스크톱 프록시 설정을 따르는지 확인하세요. 더 많은 연결을 처리해야 한다면 TUN 설정을 살펴보세요.

다운로드 페이지로 Linux 클라이언트→

클라이언트는 설정을 읽고 연결을 수립하는 프로그램이며, 설치 파일 자체에는 연결할 서버 정보가 포함되어 있지 않습니다. 신뢰할 수 있는 출처의 구독 주소나 공유 링크를 준비한 뒤 가져오세요. 컴퓨터나 휴대폰을 바꿀 때도 클라이언트 이름이 비슷하다는 이유만으로 기존 설정을 그대로 쓰지 말고, 프로토콜 지원 여부와 가져온 결과를 다시 확인하세요.

모든 클라이언트 보기 →

구독, 라우팅 및 프록시 모드

설정을 네 단계로 나눠 살펴보세요. 먼저 설정이 제대로 가져와졌는지 확인한 다음, 어떤 프로그램을 프록시에 연결할지 정하고, 연결이 코어에 들어온 뒤 어떻게 라우팅될지 구성합니다.

구독 가져오기 및 그룹별 업데이트

구독 주소는 여러 설정을 가져오는 경로이지, 브라우저에서 일반 웹페이지를 여는 링크가 아닙니다. v2rayN의 구독 그룹 설정에 메모와 주소를 입력하고 저장한 뒤 업데이트하세요. 안드로이드에서는 구독 그룹 메뉴에서 추가하면 됩니다. 그룹을 나누면 출처별 설정을 구분할 수 있어 업데이트가 영향을 미치는 범위도 쉽게 파악할 수 있습니다. 공유 링크 하나를 한 번 붙여 넣는 방식과 달리, 구독은 설정을 다시 가져올 수 있는 경로를 유지합니다. 업데이트에 실패하면 주소가 완전한지, 만료되지는 않았는지 먼저 확인한 뒤 가져오기 실패와 파싱 실패를 구분하세요. 같은 이름의 그룹을 반복해서 만들지 마세요.

위 내용은 설정 항목과 규칙의 의미를 보여 주는 예시이며, 그대로 가져올 수 있는 완성 설정이 아닙니다. 자세한 설정 순서는 시작 가이드 →를 확인하세요.

Project V, V2Fly 및 Xray 생태계

클라이언트, 코어, 프로토콜의 차이를 먼저 알아두세요. 세 이름은 서로 다른 계층을 가리키며, 인터페이스가 비슷해도 모든 설정을 서로 바꿔 쓸 수 있는 것은 아닙니다.

클라이언트는 인터페이스를, 코어는 연결을 담당합니다

Project V는 V2Ray 기술 생태계를 이해하기 위한 출발점입니다. V2Ray는 인바운드, 아웃바운드, 전송, 라우팅, DNS 등의 기능을 설정 가능한 모듈로 나눕니다. GUI 클라이언트는 이러한 기능을 바탕으로 구독 관리, 모드 전환, 로그 확인 등의 메뉴를 제공합니다. 따라서 ‘클라이언트 설치를 마침’과 ‘사용 가능한 설정을 갖춤’은 별개의 일입니다. 클라이언트가 실행된다는 것은 프로그램이 동작한다는 뜻일 뿐입니다. 실제로 연결하려면 서버 정보가 완전해야 하고, 프로토콜과 네트워크 연결 방식도 맞아야 합니다.

V2Fly는 V2Ray 관련 프로젝트의 커뮤니티 개발을 이어가고 있으며, Xray는 관련 코드 기반에서 발전한 별도의 코어 계열입니다. 두 프로젝트는 기술적 배경을 공유하면서도 각자 기능을 발전시켜 왔습니다. 가이드를 읽을 때는 클라이언트 이름뿐 아니라 실제로 사용하는 코어도 확인하세요. 특정 프로토콜을 지원한다고 해서 모든 확장 매개변수까지 지원한다고 단정할 수는 없습니다. 서버 설정에 필요한 항목을 클라이언트에서 사용할 수 있는 코어 기능과 하나씩 대조해야 합니다.

오픈 소스 클라이언트 3종 비교

v2rayN은 데스크톱 환경을 위한 클라이언트로, GUI에서 구독 그룹과 시스템 프록시, 라우팅 설정을 관리할 수 있습니다. 데스크톱에서는 같은 클라이언트의 사용법을 익힌 뒤 운영체제에 맞는 설치 파일을 선택하면 됩니다. Xray와 V2Fly 등의 코어 생태계를 사용하므로 ‘인터페이스 프로그램’과 ‘실제 연결을 처리하는 코어’를 구분해서 이해해야 합니다. 사용할 수 있는 코어와 기능은 배포 패키지와 인터페이스 옵션을 기준으로 확인하세요. 다른 플랫폼의 화면에 나온 기능을 그대로 적용하면 안 됩니다.

v2rayNG는 안드로이드에서 널리 쓰이는 오픈 소스 클라이언트로 Xray 코어를 사용합니다. 안드로이드는 VPN 권한을 통해 연결을 처리하므로 실행 방식이 데스크톱의 시스템 프록시 메뉴와 다릅니다. v2flyNG는 V2Fly 코어를 사용하는 안드로이드 클라이언트입니다. 이름은 비슷하지만 기존 설정에 필요한 코어 계열을 기준으로 선택하세요. 한쪽을 다른 쪽의 범용 문제 해결 도구처럼 취급해서는 안 됩니다. 클라이언트를 바꾸기 전에 설정 항목과 프로토콜 기능이 호환되는지 확인하세요.

클라이언트와 코어별 확인 사항
클라이언트주요 용도먼저 확인할 항목
v2rayN데스크톱 GUI 설정 및 구독 관리설치 파일 아키텍처, 실행 환경, 실제 선택한 코어
v2rayNG안드로이드 Xray 설정프로토콜 지원, VPN 권한, 백그라운드 실행 제한
v2flyNG안드로이드 V2Fly 설정코어 호환성, 가져온 설정 항목, 시스템 권한

오픈 소스 라이선스와 설정 출처를 따로 확인하세요

세 클라이언트는 모두 오픈 소스 소프트웨어입니다. 공개된 소스 코드와 라이선스를 통해 구현 방식과 사용 조건을 확인할 수 있습니다. 생태계의 프로젝트마다 라이선스가 다를 수 있으므로 코드를 수정하거나 재배포하고 인용할 때는 각 프로젝트의 라이선스 조건을 따로 확인하세요. 오픈 소스는 소프트웨어의 개발 및 라이선스 방식을 뜻합니다. 출처가 불분명한 구독이나 서버를 신뢰해도 된다는 의미가 아니며, 연결 기록과 서비스 품질, 이용 가능 범위를 클라이언트 프로젝트가 보장한다는 뜻도 아닙니다.

구독 주소에는 사용자를 식별할 수 있는 매개변수가 포함되는 경우가 많으므로 민감한 설정 정보로 보관해야 합니다. 도움을 요청할 때 오류 유형, 클라이언트 이름, 관련 설정 항목은 남기되 전체 주소와 식별 정보, 인증 정보는 가리세요. 출처를 알 수 없는 설정을 가져오기 전에는 추가 라우팅이나 DNS 설정이 포함되어 있는지도 확인해야 합니다. 인터페이스에 ‘실행 중’이라고 표시되는지만 보는 것보다 이런 경계를 이해하는 편이 연결 상태를 올바르게 판단하는 데 도움이 됩니다.

프로그램 업데이트, 구독 업데이트, 규칙 업데이트

프로그램 업데이트는 클라이언트와 관련 구성 요소를 변경하고, 구독 업데이트는 원격에서 제공하는 연결 설정을 다시 가져오며, 규칙 업데이트는 도메인과 IP 매칭 목록을 바꿀 수 있습니다. 세 작업은 서로 다릅니다. 기존 주소가 만료된 경우 프로그램을 업데이트해도 해결되지 않을 수 있습니다. 새 프로토콜 매개변수를 파싱하지 못하는 경우 구독을 반복해서 새로 고쳐도 소용없을 수 있습니다. 먼저 어느 계층에서 변경이 필요한지 파악한 다음 업데이트 대상을 선택하면 불필요한 작업과 설정 손실을 줄일 수 있습니다.

업그레이드 전에 현재 정상적으로 작동하는 프록시 모드와 라우팅 방식, 필요한 사용자 설정을 기록하고 클라이언트가 제공하는 방법으로 설정을 저장하세요. 업그레이드 후에는 정상 작동이 확인된 같은 설정으로 대조해 프로그램 실행, 구독 읽기, 기본 접속이 되는지 확인한 다음 추가 기능을 복원하세요. 코어를 바꾸고 낯선 규칙을 가져오면서 TUN까지 동시에 켜지 마세요. 여러 변수를 한꺼번에 바꾸면 문제가 생겨도 로그만으로 원인을 찾기 어렵습니다.

구독 가져오기부터 연결 확인까지

처음 설정할 때는 순서대로 진행하세요. 정상적으로 실행되는 클라이언트를 설치하고, 구독 그룹을 추가해 설정을 업데이트한 다음, 사용할 구성을 선택하고 현재 시스템에 맞는 연결 처리 방식을 켭니다. 데스크톱에서는 시스템 프록시부터 시작하고, 안드로이드에서는 VPN 권한을 허용하세요. 설정을 마치면 실제로 사용할 앱을 열어 요청이 성공하는지 확인하고 클라이언트 로그에서 연결이 처리되는지도 살펴보세요. 상태 표시줄에 실행 중이라고 나와도 실제 앱에서 접속되는지 확인해야 합니다.

접속에 실패하면 먼저 모든 앱에서 실패하는지 특정 앱에서만 실패하는지 확인하세요. 그다음 도메인 확인 실패, 연결 시간 초과, 서버 거부 중 어떤 상황인지 구분합니다. 브라우저는 작동하지만 다른 프로그램은 연결되지 않는다면 연결 처리 범위를 먼저 확인하세요. 구독 목록이 비어 있다면 가져오기와 파싱을 점검하고, 특정 도메인만 문제가 있다면 라우팅 순서와 DNS를 살펴보세요. 증상에 따라 범위를 좁히면 바로 재설치하는 것보다 원인을 찾기 쉽습니다. 단계별로 알아보려면 V2Ray 시스템 가이드를 계속 읽어 보세요.

자주 묻는 질문

구독 링크와 단일 공유 링크는 같은 방법으로 가져오나요?

아니요. 구독 주소는 구독 그룹에 저장한 뒤 업데이트해야 합니다. 단일 공유 링크는 일반적으로 클립보드 가져오기 등의 메뉴에서 추가합니다. 먼저 링크 유형을 확인한 다음 시작 가이드를 따라 하세요. 구독 주소를 단일 설정으로 가져오지 않도록 주의하세요.

시스템 프록시를 자동 설정한 뒤에도 라우팅 규칙이 필요한가요?

두 기능의 역할은 다릅니다. 시스템 프록시는 이를 지원하는 앱이 로컬 프록시에 연결되도록 하고, 라우팅 규칙은 연결이 코어에 들어온 뒤 어떤 아웃바운드를 사용할지 정합니다. 시스템 프록시를 켜도 라우팅 규칙을 대신할 수 없습니다. 설정 순서는 가이드에서 확인할 수 있습니다.

구독 업데이트는 성공했는데 연결되지 않는 이유는 무엇인가요?

업데이트 성공은 설정을 가져와 파싱했다는 뜻이지, 서버 연결을 보장한다는 뜻은 아닙니다. 현재 선택한 설정과 시스템 연결 처리 방식, 로그 오류를 확인한 다음 서버 매개변수와 네트워크 상태를 점검하세요. 연결 확인 절차에 따라 문제의 계층을 하나씩 구분해 보세요.

처음 설정할 때 바로 TUN을 켜야 하나요?

데스크톱에서는 먼저 일반 프록시 방식으로 기본 연결을 확인한 뒤 앱의 필요에 따라 TUN을 켜는 것이 좋습니다. 이렇게 하면 설정 자체의 문제와 가상 네트워크 어댑터, 권한, 시스템 라우팅 문제를 구분할 수 있습니다. 기본 가이드부터 시작하세요.

구독 가져오기 및 설정 관련 글

최근 글에서는 실제 문제를 중심으로 다룹니다. 먼저 설정 메뉴를 찾고, 설정 구조를 확인한 뒤, 실행 문제가 생기면 실행 환경을 하나씩 점검하세요.

모든 글 보기 →