v2rayN / v2rayNG / v2flyNG 쉬운 사용법

V2Ray 쉬운 가이드 · 클라이언트 다운로드v2rayN 설정 가이드

구독 가져오기부터 시스템 프록시까지 실제 메뉴를 따라 설정을 안내합니다. 데스크톱에서는 v2rayN, 안드로이드에서는 v2rayNG를 먼저 살펴보세요.

오픈 소스 클라이언트 GUI 사용법 설정을 쉽게 설명

위 이미지는 설정 예시입니다. 카드를 눌러 사용법을 확인하세요. 메뉴 이름은 앱 업데이트에 따라 달라질 수 있습니다. 처음 사용한다면 구독 가져오기부터 시작하세요.

운영체제별 선택

V2Ray 클라이언트 다운로드

먼저 운영체제를 확인한 다음 프로세서 아키텍처를 확인하세요. 설치 파일은 프로그램 실행 여부를, 노드 설정은 연결 호환성을 좌우하므로 각각 확인해야 합니다. 아래 링크에서 플랫폼에 맞는 다운로드 옵션을 선택할 수 있습니다.

Windows

v2rayN · 데스크톱 추천

구독 관리, 노드 전환, 라우팅 설정을 한국어 GUI로 하고 싶다면 v2rayN을 먼저 살펴보세요. 다운로드 페이지에서 크로스 플랫폼 UI를 사용하는 데스크톱 버전과 클래식 WPF 버전을 선택할 수 있습니다. 시스템 요구 사항과 사용 방식에 맞춰 고르면 되며, 인터페이스가 다르다는 이유만으로 두 버전을 모두 설치할 필요는 없습니다.

설치 후 구독을 추가하고 노드 목록이 정상적으로 업데이트되는지 확인한 다음 시스템 프록시를 켜세요. 대상 앱이 시스템 프록시 설정을 따르지 않는 경우에만 TUN을 고려하면 됩니다. 처음부터 모든 옵션을 켤 필요는 없습니다.

다운로드하기

macOS

v2rayN · 칩셋에 맞게 선택

시스템 메뉴에서 ‘이 Mac에 관하여’를 열어 기기가 Apple Silicon인지 Intel 프로세서인지 확인한 뒤 알맞은 설치 파일을 선택하세요. 두 아키텍처용 파일은 서로 다른 하드웨어를 대상으로 하므로 파일 크기만으로 판단하면 안 됩니다. 튜토리얼 화면이 다르다고 코어를 바꿀 필요도 없습니다.

처음 실행할 때 보안 경고가 표시되면 먼저 다운로드 출처를 확인한 뒤 ‘시스템 설정 → 개인정보 보호 및 보안’에서 자세한 사유를 살펴보세요. 시스템 프록시는 해당 설정을 따르는 앱에 영향을 줍니다. TUN에는 별도의 권한이 필요하므로 기본 연결이 확인된 뒤 설정하는 편이 좋습니다.

다운로드하기

Android

v2rayNG 우선 · v2flyNG 대안

일반적으로 Xray 코어를 사용하는 v2rayNG를 먼저 확인하세요. 기존 설정에서 V2Fly를 명시적으로 요구하는 경우에는 v2flyNG를 살펴보면 됩니다. 최근 출시된 대부분의 기기는 arm64를 선택하면 됩니다. 아키텍처를 모른다면 기기 정보를 확인하거나 범용 패키지를 선택하세요. 범용 패키지가 더 많은 아키텍처를 지원한다고 해서 연결 성능이 더 좋은 것은 아닙니다.

‘구독 그룹 설정’에서 구독 주소를 저장한 다음 구독 업데이트도 실행해야 합니다. 처음 연결할 때는 시스템에서 VPN 연결 권한을 요청합니다. 같은 VPN 통로를 사용하는 다른 도구를 함께 실행하면 충돌할 수 있으니 둘 중 하나를 먼저 종료하세요.

다운로드하기

Linux

v2rayN · 그래픽 데스크톱 환경

배포판의 패키지 관리 방식에 따라 deb 또는 rpm을 선택한 뒤 기기가 x64인지 arm64인지 확인하세요. 파일 확장자는 설치 방식을, 프로세서 아키텍처는 실행 환경을 나타내므로 두 조건이 모두 맞아야 합니다. 여기서 소개하는 것은 데스크톱 환경에서 구독과 규칙을 관리하기 좋은 GUI 클라이언트입니다.

설치가 끝나면 프로그램이 실행되는지, 코어가 작동하는지 확인한 뒤 데스크톱 환경의 프록시 설정을 점검하세요. 앱마다 시스템 프록시 지원 여부가 다릅니다. 터미널 프로그램에서 프록시가 적용되지 않는다면 같은 구독을 반복해서 가져오기보다 해당 프로그램의 프록시 설정을 먼저 확인하세요.

다운로드하기

구독 주소는 직접 준비해야 합니다. 클라이언트는 설정을 읽고 요청을 전달하는 역할을 하며, 설치만으로 사용할 수 있는 서버가 자동 생성되지는 않습니다.

전체 클라이언트 보기 →

설정 항목 → 쉬운 설명

V2Ray 용어 및 설정 비교 가이드

이름이 비슷한 설정도 역할은 다를 수 있습니다. 시스템 프록시는 앱에 ‘어디로 접속할지’를 알려주고, 라우팅은 ‘요청을 어디로 보낼지’를 정하며, DNS는 ‘도메인에서 주소를 어떻게 찾을지’를 처리합니다. 이 관계를 먼저 이해하면 문제 발생 시 어떤 메뉴를 확인할지 알 수 있습니다.

TUN 모드: 더 많은 트래픽을 처리하는 방법

TUN은 시스템에 가상 네트워크 인터페이스를 추가해 시스템 프록시 설정을 따르지 않는 앱의 요청도 클라이언트가 처리할 수 있게 하는 기능입니다. ‘요청이 클라이언트에 들어오는지’를 해결하는 기능이지 ‘노드에 연결할 수 있는지’를 해결하는 기능은 아닙니다. 먼저 시스템 프록시로 구독과 노드가 작동하는지 확인하고, 그다음 TUN을 켜서 안내에 따라 권한을 부여하세요. 다른 가상 네트워크 어댑터나 VPN 도구를 함께 실행하면 라우팅에 영향을 줄 수 있습니다. 데스크톱 플랫폼마다 권한을 부여하는 방식이 다르며, 활성화 후에는 DNS와 분할 라우팅 결과도 확인해야 합니다. 스위치가 켜졌는지만으로는 충분하지 않습니다.

v2rayN 기본 화면 → TUN 사용
먼저 노드 연결을 확인한 뒤 권한과 라우팅을 점검하세요.

설정 순서: 연결을 먼저 확인한 뒤 규칙 추가

처음 설정할 때는 ‘구독 가져오기 → 노드 업데이트 → 노드 선택 → 연결 시작 → 접속 확인’의 가장 짧은 순서를 완료하세요. 설정은 한 번에 하나씩 바꾸고 변경 전후 결과를 기록하세요. 노드 변경, TUN 활성화, DNS 교체, 라우팅 수정까지 한꺼번에 하면 문제가 해결되어도 어떤 설정이 효과가 있었는지 알기 어렵습니다. 다음에 문제가 생겼을 때도 판단 근거가 남지 않습니다.

연결을 확인할 때는 클라이언트와 실제 앱을 모두 살펴보세요. 시작 버튼이 실행 중으로 표시된다는 것은 프로그램이 작동하기 시작했다는 뜻일 뿐입니다. 테스트가 성공해도 모든 도메인이 예상한 규칙에 따라 처리된다는 보장은 없습니다. 먼저 일반 웹사이트가 열리는지 확인하고, 지정한 경로로 연결해야 하는 사이트를 테스트한 다음 로그에서 라우팅 결과를 살펴보세요. 자세한 사용법은 입문 가이드를, 플랫폼별 권한 및 설치 문제는 설치 문제 종합 가이드를 확인하세요.

자주 묻는 질문: 클라이언트, 구독, 연결 모드

클라이언트를 다운로드한 뒤 무엇이 더 필요한가요?사용할 수 있는 노드 설정이나 구독 주소가 필요합니다. 클라이언트는 설정을 저장하고 코어를 실행하며 상태를 보여주는 제어판과 같습니다. 서버 주소, 포트, 인증 정보는 이용 중인 서비스에서 제공받아야 합니다. 클라이언트만 있고 설정이 없으면 해당 프록시 연결을 만들 수 없습니다.

전역 모드와 TUN은 같은 기능인가요?아닙니다. 전역 모드는 클라이언트에 들어온 요청의 연결 경로를 선택하는 방식을 가리키는 경우가 많고, TUN은 요청을 가져오는 방식을 뜻합니다. TUN을 켜도 라우팅 규칙에 따라 일부 요청은 직접 연결될 수 있습니다. 전역 모드를 선택해도 클라이언트에 들어오지 않은 앱 요청이 자동으로 처리되지는 않습니다.

구독을 업데이트하면 직접 수정한 내용이 덮어써지나요?구독 노드는 업데이트 중 다시 생성되거나 교체될 수 있으므로 임시 수정 내용을 장기간 보관하는 방법으로 적합하지 않습니다. 유지해야 하는 설정은 별도로 백업하고 구독 그룹에 속하는 설정인지 확인하세요. 개념별 내용은 용어집에서 확인할 수 있습니다. 처음 사용할 때 모든 약어를 외울 필요는 없습니다.

클라이언트 / 코어 / 프로토콜

Project V, V2Fly 및 Xray 생태계

이 용어들은 서로 다른 계층을 가리킵니다. 클라이언트는 조작할 수 있는 인터페이스를 제공하고, 코어는 네트워크 연결을 처리하며, 프로토콜은 통신 방식을 정의합니다. 다운로드 이름 하나만 외우기보다 세 요소의 관계를 이해하는 편이 유용합니다.

GUI 클라이언트v2rayN · v2rayNG · v2flyNG
연결 및 라우팅 코어Xray · V2Fly
설정에 사용하는 통신 규약VLESS · VMess · 전송 및 보안 설정

Project V: 네트워크 도구에서 클라이언트 생태계까지

Project V는 V2Ray의 배경을 이해하는 출발점입니다. 프록시 연결, 라우팅, 전송 기능을 설정 가능한 모듈로 구성하는 것이 핵심입니다. 일상적인 대화에서 ‘V2Ray’는 특정 코어를 가리키기도 하고 관련 프로토콜을 사용하는 도구 전체를 뜻하기도 합니다. 같은 이름으로 검색해도 다운로드 대상은 다를 수 있습니다. 이 사이트에서는 다운로드 항목을 GUI 클라이언트로 분류해 백그라운드에서 실행되는 프로그램과 직접 조작하는 앱을 구분합니다.

V2Fly는 V2Ray 관련 구현과 커뮤니티 유지보수 작업을 이어가고 있으며, Xray는 관련 기술을 바탕으로 독자적인 구현과 기능을 발전시켜 왔습니다. 기술적 배경은 공유하지만 설정 필드, 기능 개발 상황, 프로토콜 확장이 언제나 같은 것은 아닙니다. 가이드를 읽을 때는 대상 클라이언트와 코어를 함께 확인하세요. 메뉴가 비슷하다고 해서 내부 동작까지 완전히 같다는 뜻은 아닙니다.

오픈 소스 클라이언트 3종: 인터페이스와 코어 선택

v2rayN은 데스크톱용 오픈 소스 GUI 클라이언트로 구독 관리, 노드 선택, 설정 생성, 코어 실행 등을 담당합니다. 여러 코어와 함께 사용할 수 있지만 구체적인 지원 범위는 클라이언트의 통합 방식과 선택한 코어에 따라 달라집니다. 데스크톱 버전과 클래식 WPF 버전은 우선 UI 기술과 지원 플랫폼에서 차이가 있습니다. 새 인터페이스라고 같은 노드의 연결 속도가 더 빠른 것은 아닙니다.

v2rayNG는 Xray 코어를 사용하는 오픈 소스 안드로이드 클라이언트이고, v2flyNG는 V2Fly 코어를 사용하는 오픈 소스 대안입니다. 사용 방식은 비슷하지만 노드 요구 사항과 기능 호환성을 기준으로 선택해야 합니다. 기존 설정에 특정 확장 매개변수가 있다면 먼저 코어가 지원하는지 확인한 뒤 클라이언트를 고르세요. 차이를 비교하려면 클라이언트 비교를 확인하세요. 이름이 비슷하다는 이유로 구독을 반복해서 옮길 필요는 없습니다.

오픈 소스 라이선스: 코드 이용 조건과 서비스 구분

오픈 소스는 해당 라이선스에 따라 소스 코드를 제공한다는 뜻이며, 라이선스 범위 내에서 코드를 읽고 사용하고 수정하거나 배포할 수 있습니다. 클라이언트, 코어, 종속성마다 라이선스가 다를 수 있으므로 구체적인 조건은 각 프로젝트에 포함된 라이선스 문서를 확인하세요. 코드를 공개하면 기술 검토와 커뮤니티 협업에 도움이 되지만, 사용자는 설치 출처, 시스템 권한, 설정 내용, 서버 측의 요청 처리 방식도 살펴야 합니다.

클라이언트 소프트웨어와 구독 서비스도 별개의 항목입니다. 오픈 소스 클라이언트는 무료로 사용할 수 있지만 구독 요금과 이용 기간, 노드 사용 가능 여부는 서비스 제공자가 결정합니다. 이 사이트는 다운로드 경로와 설정 정보를 제공하며 노드를 판매하거나 서비스 계정을 관리하지 않습니다. 구독이 만료되었다면 주소와 서비스 상태부터 확인하세요. 클라이언트를 반복해서 재설치해도 서버 측 문제는 보통 해결되지 않습니다.

업데이트 방식: 앱, 코어, 규칙을 따로 관리

‘업데이트’는 적어도 세 가지 작업을 뜻할 수 있습니다. 클라이언트 앱 업그레이드, 연결에 사용하는 코어 업데이트, 구독에 포함된 노드 목록 새로고침입니다. 라우팅은 GeoIP, GeoSite 등의 규칙 데이터에 의존할 수 있으며, 이 데이터도 별도로 업데이트해야 합니다. 구독을 업데이트해도 앱이 자동으로 업그레이드되지는 않으며, 앱을 업그레이드해도 만료된 구독 주소가 자동으로 복구되지는 않습니다. 무엇을 업데이트할지 먼저 정한 뒤 해당 메뉴를 사용하세요.

환경을 변경하기 전에 그룹, 라우팅, 직접 추가한 노드를 백업하고 현재 정상 작동하는 설정을 보관하세요. 업데이트 후에는 구독, 기본 노드, 프록시 모드를 하나씩 확인하세요. 문제가 생기면 로그의 구체적인 오류를 살펴보고 매개변수 호환성 문제인지 권한 변경인지 판단하세요. 문제를 해결하는 동안 모든 설정을 연달아 덮어쓰지 마세요. 페이지의 메뉴 경로는 기능을 찾기 위한 안내이며, 실제 화면이 달라졌다면 현재 클라이언트의 해당 기능 이름과 설명을 기준으로 하세요.

구독 링크에 접속 정보가 포함될 수 있고 로그에 서버 주소가 기록될 수도 있습니다. 도움을 요청할 때는 해당 정보를 가리고 오류 유형, 관련 설정, 재현 방법만 공유하세요. 거주 지역의 법률과 이용 중인 네트워크의 관리 규정을 준수하세요.

프로토콜 및 코어 용어 더 알아보기 →

설정 가이드

v2rayN 및 v2rayNG 사용 정보

기본 연결을 확인한 뒤 실제 문제에 맞춰 더 자세히 알아보세요. DNS 조회 경로, 데스크톱 버전 선택, 구독 가져오기 실패 원인 등을 다룹니다. 각 글은 하나의 설정을 중심으로 구성해 클라이언트에서 직접 비교하기 쉽습니다.

전체 글 보기 →