데스크톱·Android 클라이언트 설정 안내

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

플랫폼별 오픈 소스 클라이언트를 정리하고, 구독 가져오기부터 라우팅 설정까지 데스크톱과 Android의 메뉴를 비교하며 안내합니다.

한국어 설정 안내 Xray · V2Fly 생태계
프로토콜 및 보안 방식
  • VMess
  • VLESS
  • Trojan
  • REALITY
코어 생태계
  • Xray
  • V2Fly

플랫폼별 클라이언트 선택

먼저 운영체제, 프로세서 아키텍처, 설치 패키지 형식을 확인한 다음 클라이언트를 선택하세요. 데스크톱에서는 v2rayN부터 살펴보고, Android에서는 v2rayNG를 우선 고려할 수 있습니다. V2Fly 코어가 필요한 경우에는 v2flyNG를 선택하세요. 다운로드 페이지에서 설치 경로와 시스템 요구 사항을 확인할 수 있으며, 이 페이지에서는 설치 파일을 따로 배포하지 않습니다.

Windows v2rayN · 우선 추천

데스크톱 버전과 클래식 WPF 버전

처음 설치한다면 크로스 플랫폼 인터페이스를 제공하는 데스크톱 버전부터 살펴보세요. 기존 메뉴와 창 배치에 익숙하다면 클래식 WPF 버전을 선택할 수 있습니다. 두 버전 모두 사용하는 코어에 따라 프로토콜 지원 여부가 달라지므로, 화면 모양만 보고 설정의 작동 여부를 판단해서는 안 됩니다. 설치 전에 시스템 설정에서 기기 아키텍처를 확인하고, 다운로드 페이지의 안내에 따라 알맞은 파일을 선택하세요.

기존 설정이 있다면 새 프로그램 폴더로 옮기기 전에 구독 그룹, 사용자 지정 라우팅, DNS 설정을 백업하세요. 처음 실행할 때는 신뢰할 수 있는 구독 하나만 가져오고 설정을 선택한 뒤 시스템 프록시를 켜 브라우저로 연결을 확인하는 편이 좋습니다. 우선 TUN은 함께 켜지 말고, 설치 문제와 트래픽 처리 방식을 따로 점검하세요.

macOS v2rayN

칩에 맞는 설치 파일 선택

‘이 Mac에 관하여’에서 칩 정보를 확인하세요. Apple Silicon은 arm64, Intel은 x64를 선택하면 됩니다. 설치 패키지 형식이 같아도 프로세서 아키텍처는 다를 수 있습니다. 잘못 선택하면 실행되지 않거나 별도의 호환 환경이 필요할 수 있습니다. 먼저 시스템 요구 사항을 확인한 뒤 앱을 설치하고 처음 실행하세요. 시스템 권한 안내를 구독 문제로 오해하지 않도록 주의하세요.

데스크톱 설정 방식은 Windows와 비슷하지만, 시스템 네트워크 설정과 권한 메뉴는 다릅니다. 시스템 프록시를 켠 다음 대상 앱이 시스템 프록시를 사용하는지 확인하세요. 특정 프로그램이 계속 직접 연결된다면 먼저 해당 앱의 설정을 살펴보세요. 더 많은 앱의 트래픽을 처리해야 할 때 TUN 권한, 라우팅 및 복구 안내를 확인하면 됩니다.

Android v2rayNG · 우선 추천

v2rayNG와 v2flyNG

v2rayNG는 Xray 코어를 사용하며 Android 클라이언트의 입문용으로 적합합니다. v2flyNG는 V2Fly 코어를 사용하므로 해당 코어가 필요한 경우에 고려할 수 있습니다. 최신 스마트폰은 대부분 arm64를 사용하지만, 기기에서 실제로 지원하는 아키텍처를 기준으로 선택해야 합니다. 확실하지 않다면 다운로드 페이지에서 범용 버전 안내를 확인하고, 스마트폰을 구입한 연도만으로 판단하지 마세요.

구독을 가져온 뒤 처음 연결하면 시스템에서 VPN 연결 권한을 요청합니다. 이는 클라이언트의 노드 설정과 별개입니다. 앱별 프록시를 사용하면 처리할 앱을 지정할 수 있습니다. 백그라운드에서 연결이 자주 끊긴다면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 처음부터 모든 절전 옵션을 변경할 필요는 없습니다.

Linux v2rayN

배포판에 맞는 deb 또는 rpm 선택

먼저 배포판에서 사용하는 패키지 형식을 확인하고 deb 또는 rpm을 선택하세요. x64와 arm64도 구분해야 합니다. 데스크톱 그래픽 클라이언트에는 적절한 그래픽 환경이 필요합니다. 설정 파일만으로 실행하는 서버 프로그램과 혼동하지 마세요. 다운로드 페이지에서 많이 사용하는 형식을 주요 항목으로 안내하고 arm64용 선택지도 별도로 제공합니다.

설치 후 일반 데스크톱 세션에서 구독을 가져오고 기본 연결을 테스트하세요. 데스크톱 환경마다 시스템 프록시를 사용하는 방식이 다를 수 있고, 앱 자체에 별도의 프록시 설정이 있을 수도 있습니다. TUN이 필요하다면 배포판과 클라이언트 안내에 따라 권한을 설정하세요. 문제가 생기면 로그를 저장하고 기존 네트워크 설정을 복원한 뒤 원인을 살펴보세요. 권한 설정을 반복해서 추가하지 마세요.

클라이언트는 설정과 연결을 위한 인터페이스일 뿐, 사용할 수 있는 원격 서버를 자동으로 만들어 주지는 않습니다. 구독 주소, 공유 링크, 직접 입력하는 매개변수는 신뢰할 수 있고 사용 권한이 있는 출처에서 받아야 합니다. 구독에는 접속 정보가 포함되는 경우가 많으므로 화면 캡처, 설정 내보내기, 문의를 할 때 전체 주소와 사용자 식별 정보, 관련 키를 가리세요.

모든 클라이언트 보기 →

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

같은 연결 매개변수라도 데스크톱과 Android에서는 설정 메뉴가 다릅니다. 먼저 트래픽이 어떤 경로로 클라이언트에 들어오는지 파악한 뒤 어떤 규칙으로 처리할지 정하세요. 아래에서는 설정 목적별로 설명합니다. 화면 예시는 메뉴 위치를 찾기 위한 것으로, 실제 항목 이름은 설치한 클라이언트에 따라 다를 수 있습니다.

시스템 프록시의 적용 범위

시스템 프록시는 시스템 설정을 따르는 앱이 연결을 로컬 프록시 포트로 전달하도록 합니다. v2rayN에서 시스템 프록시 자동 설정을 선택하면 보통 브라우저로 바로 테스트할 수 있습니다. 자체 네트워크 설정이 있는 프로그램은 별도로 확인해야 합니다. 시스템 프록시를 설정했다고 해서 모든 트래픽이 클라이언트로 들어오거나 라우팅이 전역 모드로 바뀌는 것은 아닙니다. Android에서 흔히 사용하는 VPN 방식과 비교하면 데스크톱의 기본 연결을 먼저 확인하기에 적합합니다. 클라이언트를 종료하거나 전환하기 전에 시스템 프록시를 해제하면 포트가 닫힌 뒤에도 앱이 해당 포트를 사용하는 상황을 줄일 수 있습니다.

v2rayN · 시스템 프록시

시스템 프록시 자동 설정시스템 프록시 해제
로컬 수신 포트10808

‘구독 가져오기 → 시스템 프록시 또는 VPN 연결 확인 → 라우팅 선택 → 필요에 따라 고급 트래픽 처리 사용’ 순서로 진행하는 것이 좋습니다. 전체 절차는 설정 가이드를 참고하세요. 도메인 해석, 규칙 우선순위, 일상적인 관리 방법을 알아보려면 전체 가이드를 이어서 읽어 보세요.

Project V, V2Fly 및 Xray

프로젝트, 코어, 그래픽 클라이언트를 구분한 다음 프로토콜 안내를 읽어 보세요. 각각 다루는 영역이 다릅니다. 프로젝트는 기술 생태계를 이루고, 코어는 연결 기능을 구현하며, 클라이언트는 설정 작업을 데스크톱이나 모바일 인터페이스로 제공합니다.

생태계 관계: 설치 순서가 아닙니다

V2Ray는 Project V 생태계의 프록시 도구이며, V2Fly는 V2Ray를 커뮤니티에서 이어서 관리합니다. Xray는 이 생태계에서 발전해 자체 구현과 기능을 확장했습니다. 가이드에서 이 이름들을 함께 볼 수 있지만, 반드시 세 프로그램을 차례로 설치해야 한다는 뜻은 아닙니다. 그래픽 클라이언트를 사용할 때는 현재 설정을 어떤 코어가 실행하는지, 그 코어가 필요한 프로토콜과 전송 방식, 보안 옵션을 지원하는지가 중요합니다.

VMess와 VLESS는 프록시 프로토콜 이름입니다. REALITY는 구체적인 설정과 함께 살펴봐야 하는 보안 방식이며, 이들을 클라이언트 플랫폼과 같은 범주로 볼 수는 없습니다. 구독에 특정 이름이 포함되어 있다면 이름만 보고 속도나 안정성을 추측하지 말고 전체 매개변수와 호환 조건을 확인하세요. 구현별 지원 항목은 유지보수 진행에 따라 달라질 수 있으며, 오래된 가이드의 기본값이 현재 환경에 적합하지 않을 수도 있습니다.

클라이언트의 역할: 설정 저장과 작업 구성

v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 그래픽 클라이언트지만 지원 플랫폼과 코어 조합이 다릅니다. v2rayN은 데스크톱용으로 구독 그룹 관리, 시스템 프록시 전환, 라우팅 편집에 편리합니다. v2rayNG는 Android의 VPN 연결과 앱 관리를 중심으로 설정을 구성합니다. v2flyNG는 Android에서 V2Fly 코어가 필요한 경우 선택할 수 있는 대안입니다. 클라이언트를 고를 때는 플랫폼과 설정 호환성을 먼저 살펴보고 사용 편의성을 고려하세요. 이름이 비슷하다는 이유로 모두 설치할 필요는 없습니다.

그래픽 인터페이스는 설정을 직접 편집하는 수고를 덜어 주지만 원격 서비스를 대신하거나 서비스 자체의 가용성 문제를 해결하지는 않습니다. 구독을 가져왔다는 것은 클라이언트가 내용을 읽었다는 뜻이고, 코어가 시작되었다는 것은 로컬 설정을 받아들였다는 뜻입니다. 대상 웹페이지에 접속할 수 있는지는 전체 연결 경로를 확인하는 과정 중 하나입니다. 단계를 나눠 점검하면 ‘가져오기에 성공했으니 연결도 정상일 것’이라고 오해하는 일을 줄일 수 있습니다.

오픈 소스 라이선스: 구성 요소별로 확인

오픈 소스 소프트웨어는 해당 라이선스에 따라 코드가 공개되어 사용자가 조건 내에서 읽고 사용하고 수정할 수 있다는 뜻입니다. 클라이언트, 코어, 함께 제공되는 구성 요소는 서로 다른 라이선스를 적용할 수 있으므로 한 프로젝트의 라이선스 안내를 전체 구성 요소에 그대로 적용해서는 안 됩니다. 프로그램을 재배포하거나 수정하려면 동봉된 라이선스 문서를 각각 확인하고 필요한 저작권 및 라이선스 고지를 유지하세요. 일반 사용자는 이 정보를 통해 프로젝트의 출처와 관리 방식을 확인할 수 있습니다.

커뮤니티에서 관리한다고 해서 모든 클라이언트에 같은 기능이 동시에 추가되는 것은 아닙니다. 데스크톱 메뉴의 위치, Android 권한 처리, 새 설정 항목에 대한 코어 지원은 각각 달라질 수 있습니다. 이 페이지는 특정 버튼 위치를 계속 유지될 기준으로 삼지 않고 기능의 목적에 따라 설명합니다. 화면이 다르다면 ‘시스템 프록시, 라우팅, 구독, DNS, TUN’의 개념을 기준으로 현재 버전에서 해당 설정을 찾아보세요.

업데이트와 관리: 복구할 수 있는 설정 유지

클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 관리 작업입니다. 클라이언트 업데이트는 인터페이스, 통합 방식, 시스템 호환성에 영향을 주고 코어 업데이트는 프로토콜 구현과 작동 방식에 영향을 줍니다. 구독 업데이트는 서비스 제공자가 배포한 설정을 다시 가져옵니다. 한 번에 한 종류씩 변경하고 업데이트 후 기본 연결을 확인하면 문제가 어느 단계에서 생겼는지 파악하기 쉽습니다. 장기간 사용할 사용자 지정 라우팅, DNS, 앱별 설정은 따로 기록해 이전 과정에서 빠뜨리지 않도록 하세요.

일상 점검은 자주 사용하는 앱부터 시작하세요. 클라이언트가 실행 중인지, 현재 설정을 사용할 수 있는지, 시스템 프록시 또는 VPN 상태가 예상과 맞는지 확인한 다음 라우팅과 DNS를 살펴보세요. 로그의 해석 실패, 연결 거부, 핸드셰이크 오류는 서로 다른 단계를 가리키므로 발생 시점을 함께 확인해야 합니다. 로그를 공유하기 전에 구독 주소와 연결 정보를 삭제하세요. 속도를 측정할 때는 테스트 대상과 방법을 이해하고, 한 번의 결과를 실제 다운로드 속도의 보장으로 받아들이지 마세요.

전체 설정 순서는 처음부터 완성까지, 전체 가이드를 참고하세요. 도메인 해석 문제는 DNS 설정 장에서, 속도 측정과 업데이트 방법은 일상 관리 장에서 확인할 수 있습니다. 기본 연결이 안정적으로 작동하면 스니핑, FakeDNS, 세부 라우팅 규칙을 하나씩 시험해 보세요. 고급 옵션을 한꺼번에 켜는 것보다 관리하기 쉽습니다.

V2Ray 설정 및 문제 해결 글

가이드는 작업 순서에 따라 설명하고, 글은 구체적인 문제를 다룹니다. 설치를 마쳤다면 초보자 FAQ부터 읽어 보세요. 연결은 되지만 안정적이지 않다면 노드, 네트워크 경로, 로컬 설정을 차례로 점검하세요. 프로토콜을 비교할 때는 이름보다 매개변수와 보안 방식을 살펴보는 것이 중요합니다.

V2Ray 초보자 FAQ 10가지: 구독 가져오기, 프록시 모드, 연결 오류 빠른 답변

초보자가 자주 묻는 10가지 문제를 정리했습니다. 구독 가져오기, 시스템 프록시와 TUN의 차이, 연결은 됐지만 웹페이지가 열리지 않는 문제 등을 하나씩 간단히 설명합니다. 로컬 트래픽 처리, 라우팅 선택, 원격 설정을 먼저 구분한 뒤 어느 부분을 바꿔야 할지 확인하세요.

글 읽기 →