데스크톱·안드로이드 · 구독 설정

V2Ray Windows판 v2rayN 다운로드 및 사용 가이드

v2rayN 다운로드 가이드 보기

오픈 소스 클라이언트로 데스크톱과 안드로이드를 지원합니다. 구독 가져오기부터 설정해 보세요.

  • VLESS
  • VMess
  • Trojan
  • REALITY
  • Xray 코어

클라이언트 화면을 정적으로 재현한 예시입니다. 메뉴 이름과 레이아웃은 배포 버전에 따라 달라질 수 있습니다.

클라이언트 설정

시스템 프록시, 라우팅 및 구독

트래픽을 가로채는 방식과 전달 경로를 먼저 구분하세요. 네 가지 설정은 각각 다른 문제를 다룹니다.

설정 화면 예시 · 클라이언트 조작 화면이 아닙니다

시스템 프록시는 운영체제 설정에 프록시 접속 정보를 등록합니다. 먼저 v2rayN에서 사용할 서버를 선택한 다음 ‘시스템 프록시 자동 설정’을 켜세요. 시스템 설정을 따르는 앱이 이 프록시를 사용합니다. ‘시스템 프록시 해제’는 운영체제 설정을 복원하고, ‘시스템 프록시 변경 안 함’은 기존 설정을 유지합니다. 이 설정은 라우팅 모드와 별개이며 모든 프로그램의 트래픽을 가로채는 기능도 아닙니다. 앱마다 프록시를 입력하는 것보다 데스크톱에서 편리하게 사용할 수 있지만, 특정 앱이 프록시를 따르지 않는다면 해당 앱의 네트워크 옵션을 확인하세요.

프록시 및 라우팅 설정 보기 →

설정 순서: 먼저 연결한 다음 트래픽 분기

처음 사용할 때는 구독을 가져온 뒤 목록에 설정이 표시되는지 확인하고, 그중 하나를 활성 서버로 선택하세요. 다음으로 적절한 트래픽 가로채기 방식을 켜고 마지막으로 라우팅을 조정합니다. 이렇게 한 번에 한 단계씩 변경하면 문제가 생겨도 쉽게 되돌릴 수 있습니다. 처음부터 DNS, 라우팅, 포트, 전송 매개변수를 한꺼번에 바꾸면 연결이 복구되더라도 무엇이 원인이었는지 파악하기 어렵습니다.

데스크톱의 시스템 프록시와 안드로이드의 VPN 모드는 플랫폼별로 다른 연결 방식입니다. v2rayNG는 시스템 VPN 권한을 받아 로컬 트래픽 진입점을 만들고, 앱별 프록시로 대상 앱을 더 제한할 수 있습니다. v2rayN은 시스템 프록시를 사용하거나 필요에 따라 다른 트래픽 가로채기 방식을 설정할 수 있습니다. 가이드의 설정 명칭은 기능을 찾기 위한 것이므로 두 플랫폼의 스위치를 하나씩 그대로 따라 하지 마세요. 연결 상태, 앱의 프록시 경유 여부, 원격 서비스 접속 가능 여부를 각각 확인해야 합니다.

구독 업데이트만 실패한다면 먼저 구독 업데이트 실패 해결 방법을 확인하세요. 구독은 가져왔지만 웹페이지가 열리지 않는다면 활성 서버, 시스템 프록시, 라우팅 순서로 점검합니다. 한 번의 테스트는 해당 테스트 경로의 상태만 보여 주며, 모든 앱과 웹사이트에 접속할 수 있음을 증명하지는 않습니다.

다운로드

네 가지 플랫폼 중 운영체제에 맞게 선택

데스크톱에서는 v2rayN, 안드로이드에서는 v2rayNG를 먼저 확인하세요. 설치 파일 형식과 프로세서 아키텍처는 다운로드 페이지에서 각각 안내합니다.

Windows

v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 익숙한 Windows 레이아웃을 유지합니다. 먼저 시스템 요구 사항을 확인하고 사용 방식에 맞는 버전을 선택하세요. 설정을 가져온 뒤에는 활성 서버, 시스템 프록시, 라우팅을 중점적으로 확인하세요.

다운로드 페이지로 이동 →

macOS

v2rayN은 Apple Silicon과 Intel용 설치 파일을 각각 제공합니다. 시스템의 ‘이 Mac에 관하여’에서 칩 유형을 확인해 아키텍처를 혼동하지 않도록 하세요. 설치 후 권한이 필요하다면 시스템 안내를 참고해 출처와 작업을 확인하세요. 클라이언트를 실행하려고 보안 설정을 일괄 해제하지 마세요.

다운로드 페이지로 이동 →

Android

Xray 코어를 사용하는 v2rayNG를 우선 선택하고, V2Fly 생태계와의 호환성이 필요할 때 v2flyNG를 확인하세요. 기기에서 지원하는 아키텍처에 맞춰 arm64 또는 범용 패키지를 선택합니다. 처음 연결할 때는 시스템 VPN 권한을 확인해야 하며, 백그라운드 실행 정책에 따라 연결이 유지되지 않을 수도 있습니다.

다운로드 페이지로 이동 →

Linux

v2rayN은 deb 및 rpm 형식으로 제공되며 x64와 arm64 아키텍처를 구분합니다. 배포판의 패키지 관리 방식에 맞는 형식을 선택하세요. 데스크톱 환경마다 프록시 설정 위치가 다를 수 있습니다. 설치 후에는 클라이언트가 실행되는지만 보지 말고 앱이 시스템 프록시를 따르는지도 확인해야 합니다.

다운로드 페이지로 이동 →

전체 클라이언트 보기 →

설치 파일과 구독은 별도로 준비

클라이언트는 설정을 읽고 코어를 실행하며 연결을 관리하는 프로그램이지, 원격 서비스를 제공하는 것은 아닙니다. 다운로드만으로 사용할 수 있는 서버가 자동 생성되지는 않습니다. 사용 권한이 있는 구독 주소나 공유 링크를 별도로 준비하세요. 구독을 복사할 때는 전체 내용을 그대로 유지하고, 웹페이지 제목이나 설명 또는 앞뒤 공백이 주소 입력란에 포함되지 않도록 하세요. 구독의 프로토콜 지원 범위도 선택한 클라이언트와 코어에 맞아야 합니다.

기기를 바꾸기 전에 기존 설정을 보관하세요

호환되는 같은 구독을 데스크톱과 안드로이드에 각각 가져올 수 있지만, 앱 설정, 앱별 목록, 사용자 지정 라우팅은 보통 따로 설정해야 합니다. 이전하기 전에 현재 사용 중인 트래픽 가로채기 방식을 기록하고 필요한 로컬 설정을 백업한 뒤 새 기기에서 확인하세요. 주소나 계정 정보가 포함된 내보내기 파일을 공개 게시판에 올리지 마세요. 문제 해결용 스크린샷에서도 구독 주소와 인증 정보를 가려야 합니다.

오픈 소스 생태계

Project V, V2Fly 및 Xray

클라이언트는 조작 화면을 제공하고 코어는 연결과 라우팅을 처리합니다. 이름이 비슷해도 역할은 다릅니다.

생태계 구조

Project V / V2Ray

프록시 구성 요소와 설정 체계를 이해하는 출발점입니다.

V2FlyV2Ray 코어 개발을 이어갑니다
XrayV2Ray에서 분기해 발전했습니다

각 분기는 독립적으로 발전하므로 프로토콜과 설정 기능은 실제 코어를 기준으로 확인해야 합니다.

V2Ray 코어 차이 알아보기 →

프로젝트 이름부터 실제 클라이언트까지

Project V는 V2Ray 생태계를 이해하기 위한 배경입니다. V2Ray 코어는 인바운드, 아웃바운드, 라우팅, 전송 등의 구성 요소로 네트워크 요청을 처리합니다. 이 구성 요소를 직접 관리하려면 설정을 읽어야 하지만, v2rayN, v2rayNG, v2flyNG는 구독, 서버, 설정 같은 메뉴로 자주 쓰는 기능을 그래픽 인터페이스에 정리해 제공합니다. ‘V2Ray 클라이언트’를 검색했다면 코어 이름만 보고 파일을 고르기보다 현재 시스템에 맞는 그래픽 클라이언트를 다운로드하는 경우가 대부분입니다.

V2Fly는 V2Ray의 개발과 유지 관리를 이어가고, Xray는 V2Ray에서 분기해 독립적으로 발전했습니다. 두 코어는 설정의 공통된 기반이 있지만 기능과 문법에는 차이가 있습니다. 특정 프로토콜을 가져올 수 있다고 해서 모든 전송 조합을 사용할 수 있는 것은 아닙니다. 호환성을 판단할 때는 프로토콜, 전송 방식, 보안 계층, 코어 지원 여부를 함께 확인해야 합니다. 서버 매개변수를 설정 기준으로 삼고, 가이드를 따라 하기 위해 중요한 항목을 임의로 바꾸지 마세요.

오픈 소스 클라이언트 세 가지의 역할

v2rayN은 데스크톱용으로 서버와 구독을 관리하고, 인터페이스 설정을 코어에서 사용할 수 있는 설정으로 변환합니다. v2rayNG는 안드로이드용이며 Xray 코어를 사용합니다. 이 사이트의 안드로이드 다운로드에서 우선 안내하는 앱입니다. v2flyNG는 V2Fly 코어를 사용하는 안드로이드 대안입니다. 모두 오픈 소스 프로젝트지만 같은 설치 파일의 다른 이름이 아닙니다. 메뉴, 설정 지원 범위, 실행 환경도 완전히 동일하지 않습니다.

먼저 운영체제를 기준으로 선택하고, 기존 설정에 어떤 코어 기능이 필요한지 확인하세요. 현재 설정이 잘 작동하고 호환성 문제가 없다면 이름이 다르다는 이유만으로 클라이언트를 바꿀 필요는 없습니다. 이전해야 한다면 소량의 설정을 먼저 가져와 기본 연결을 확인한 다음 구독과 라우팅 규칙을 옮기세요. 클라이언트 비교 페이지에서 세 앱의 용도를 확인하면 데스크톱 시스템 프록시 설정을 안드로이드에 그대로 적용하는 실수를 피할 수 있습니다.

클라이언트 선택 가이드 보기 →

오픈 소스 라이선스와 설정 관리

오픈 소스는 코드와 사용, 수정, 배포 방식이 해당 라이선스의 적용을 받는다는 뜻이지, 모든 배포 형태에 같은 조건이 적용된다는 뜻은 아닙니다. V2Fly와 Xray의 핵심 프로젝트는 MPL 2.0을 따릅니다. 그래픽 클라이언트와 의존성에는 다른 라이선스가 적용될 수 있으므로 각 프로젝트에 포함된 라이선스 파일을 확인하세요. 일반 사용자는 릴리스 노트, 기능 변경, 현재 시스템의 호환 요구 사항을 확인하면 됩니다.

오픈 소스라는 사실만으로 구독 출처를 신뢰할 수 있는 것은 아닙니다. 서버 제공자, 허용된 사용 목적, 인증 필요 여부는 원격 서비스에 관한 사항입니다. 클라이언트 화면에 설정이 표시된다고 해서 그 설정이 계속 유효하다는 뜻은 아닙니다. 스크린샷, 로그, 설정을 공유하기 전에는 구독 주소와 계정 정보를 삭제하세요. 문제를 문의할 때는 전체 설정을 공개하는 대신 작업 단계와 오류 유형을 설명하는 편이 안전하고 효과적입니다.

클라이언트 업데이트와 구독 업데이트

클라이언트 업데이트는 앱과 관련 구성 요소를 교체하는 것이고, 구독 업데이트는 원격에서 제공하는 서버 설정을 다시 가져오는 것입니다. 두 업데이트는 서로 다른 문제를 해결합니다. 구독 주소가 만료된 경우 클라이언트를 다시 설치해도 보통 해결되지 않으며, 프로토콜 지원이 부족한 경우 구독을 계속 새로고침해도 해결되지 않습니다. 업그레이드 전에는 변경 사항을 확인하고 필요한 설정을 백업한 뒤 기존 규칙이 새 설정 방식에서도 유효한지 살펴보세요.

다운로드 페이지에서는 플랫폼별 다운로드와 이용 가능한 버전을 한곳에서 확인할 수 있으며, 홈에서는 클라이언트 선택과 설정 경로를 안내합니다. 설치한 뒤에는 먼저 기존 기본 연결이 작동하는지 확인하고 개인 설정을 복원하세요. 업데이트 후 문제가 생기면 플랫폼, 클라이언트 종류, 트래픽 가로채기 방식, 오류가 발생한 단계를 기록한 뒤 문제 해결 절차에 따라 하나씩 원인을 찾으세요. 모든 네트워크 매개변수를 동시에 바꾸지 마세요.

프로토콜 명칭과 연결 방식

VMess, VLESS, Trojan은 설정에서 흔히 볼 수 있는 프로토콜 이름이며, REALITY는 VLESS 등과 함께 사용하는 전송 보안 방식입니다. 서로 자유롭게 바꿔 쓸 수 있는 가속 옵션이 아닙니다. 프로토콜, 대상 주소, 포트, 인증 정보, 전송 매개변수는 서버 설정과 일치해야 합니다. 하나라도 빠지면 가져온 뒤에도 연결되지 않을 수 있습니다.

낯선 용어가 나오면 먼저 REALITY 프로토콜 안내와 용어집에서 개념을 확인한 뒤 서버에서 제공한 전체 매개변수를 점검하세요. 공유 링크로 가져오는 경우에는 클라이언트가 모든 항목을 인식했는지도 살펴봐야 합니다. 테스트 결과는 실제 앱 접속 여부와 함께 판단하세요. 특정 연결 확인에 성공했더라도 해당 구간에 도달할 수 있다는 뜻일 뿐, 전체 요청이 정상 작동한다고 단정할 수는 없습니다.

설정 전 자주 묻는 질문

구독 주소와 단일 노드 공유 링크는 어떻게 다른가요?

단일 노드 공유 링크에는 서버 설정 하나가 담기고, 구독 주소에서는 업데이트할 수 있는 설정 목록을 가져옵니다. 각각 해당하는 가져오기 메뉴에 입력해야 합니다. 구독 웹페이지 주소를 단일 노드 매개변수로 입력하지 마세요. 먼저 구독 및 노드 용어 안내를 읽고 가이드에 따라 가져오기 방식을 선택하세요.

전역 라우팅을 선택하면 모든 앱이 프록시를 사용하나요?

라우팅 옵션만으로 결정되지는 않습니다. 라우팅은 코어에 들어온 요청을 처리하며, 앱이 프록시에 연결되는지는 시스템 프록시, 앱 자체 설정 또는 다른 트래픽 가로채기 방식에도 달려 있습니다. 먼저 앱이 프록시에 연결되는지 확인한 다음 트래픽 경로를 점검하세요. 자세한 내용은 라우팅 및 트래픽 분기 안내를 참고하세요.

데스크톱과 안드로이드에서 같은 구독을 쓰면 로컬 설정도 동기화되나요?

같은 구독을 사용한다는 것은 두 기기에서 호환되는 서버 설정을 각각 가져온다는 뜻입니다. 시스템 프록시, 앱별 목록, 사용자 지정 라우팅은 자동으로 동기화되지 않습니다. 구독 제공자가 동시 사용 기기를 제한할 수도 있으므로 서비스 이용 조건을 확인하세요. 안드로이드 설정은 v2rayNG 사용 가이드를 참고하세요.

블로그

가져오기와 설치 및 연결 테스트

실제 사용 절차를 중심으로 설정 개념을 설명합니다. 입력 내용을 확인한 다음 실행 환경과 테스트 방법을 점검하세요.

전체 글 보기 →