V2Ray GUI 클라이언트 · 데스크톱 및 Android
구독 그룹으로 구성을 정리하고 라우팅으로 트래픽 경로를 지정하세요. 클라이언트 설치부터 TUN 설정까지 필요한 항목별로 살펴볼 수 있습니다.
클라이언트 인터페이스 구성 예시입니다. 메뉴와 항목 이름은 플랫폼 및 버전에 따라 달라질 수 있습니다.
먼저 구성 출처를 관리한 다음 시스템 프록시, 라우팅, 가상 네트워크 인터페이스를 구분하세요. 각 설정은 구성의 출처, 트래픽이 코어로 들어오는 방식, 최종 출구를 각각 결정합니다.
구독 그룹에서는 주소, 별칭, 업데이트 정책을 한곳에서 관리할 수 있어 여러 구성 출처를 함께 유지하기 편리합니다. 구독 그룹 설정에 주소를 입력하고 업데이트한 다음, 해당 그룹에서 서버를 선택하세요. 자동 업데이트 간격은 분 단위로 지정하며, 기능을 켜더라도 클라이언트가 구독 주소에 연결할 수 있는 네트워크 환경이 필요합니다. 모든 항목을 하나의 목록에 섞어 두는 것보다 그룹별로 관리하면 작동하지 않는 출처를 찾고 업데이트 대상을 제어하기 쉽습니다. 구독 내용은 제공업체가 관리합니다. 업데이트에 실패하면 기존 구성을 반복해서 삭제하지 말고 주소와 인증서 오류부터 확인하세요.
구독 그룹 → 구독 그룹 설정구독 그룹 설정
라우팅은 도메인, 대상 주소 또는 기타 조건에 따라 코어에 들어온 요청을 지정된 아웃바운드로 전달합니다. 처음에는 중국 본토 우회 프리셋을 선택하고 로컬 네트워크나 업무용 도메인 등의 예외를 확인하세요. 규칙은 보통 순서대로 적용되므로, 범위가 넓은 조건을 앞에 두면 뒤의 세부 조건이 가려질 수 있습니다. 시스템 프록시처럼 트래픽 진입 설정만 바꾸는 것과 달리 라우팅은 코어 처리 단계에 적용되며 TUN으로 들어온 트래픽에도 영향을 줍니다. GeoIP 또는 GeoSite 분류를 사용할 때는 데이터베이스가 설치되어 있고 현재 코어와 호환되는지 확인하세요. 데이터베이스 누락을 서버 오류로 오해하지 않도록 주의해야 합니다.
메인 창 → 라우팅라우팅 프리셋
시스템 프록시 자동 설정은 운영체제의 프록시 진입점을 로컬 클라이언트로 지정합니다. 시스템 프록시 해제는 운영체제의 프록시 설정을 취소하고, 시스템 프록시 변경 안 함은 현재 상태를 유지합니다. 세 가지 모드는 시스템 설정을 관리하는 것으로, 서로 다른 라우팅 규칙을 뜻하지 않습니다. 브라우저는 대개 시스템 프록시를 사용하지만 일부 명령줄 도구나 독립 네트워크 프로그램은 별도로 설정해야 합니다. 따라서 브라우저만 연결되고 다른 앱은 연결되지 않는다면 서버를 바로 바꾸기보다 해당 앱의 프록시 진입점부터 확인하세요. TUN보다 시스템 프록시가 기본 연결을 먼저 확인하기에 적합하고 문제 범위도 좁히기 쉽습니다.
메인 창 → 시스템 프록시시스템 프록시
TUN은 가상 네트워크 인터페이스와 라우팅을 통해 트래픽을 받아 시스템 프록시를 사용하지 않는 앱에서도 사용할 수 있습니다. 켜기 전에 일반 프록시 모드에서 서버 구성이 유효한지 확인하고, 운영체제 요구 사항에 따라 관리자 권한을 부여하세요. 활성화한 뒤에는 DNS, 로컬 네트워크 접근, 다른 가상 네트워크 인터페이스와의 라우팅 충돌을 중점적으로 확인해야 합니다. TUN은 더 넓은 범위의 트래픽을 받아들이지만 모든 요청이 프록시를 거치는 것은 아니며, 최종 출구는 코어의 라우팅 설정에 따라 결정됩니다. 앱마다 프록시를 입력할 필요가 줄어드는 대신 문제를 확인할 범위는 넓어집니다. 이상이 생기면 먼저 TUN을 끄고 일반 모드와 비교해 원인을 찾으세요.
메인 창 → TUN 활성화TUN 연결
예시용 스위치입니다. 실제 설정은 클라이언트에서 변경하세요.
v2rayN은 그래픽 관리 인터페이스를 제공하고, 실제 연결은 선택한 코어가 처리합니다. Xray-core와 sing-box 중에서 고를 때는 이름만 비교하지 말고 프로토콜, 전송 방식, 필요한 기능을 함께 고려하세요. 코어마다 DNS와 라우팅 필드가 다르므로 사용자 지정 구성을 그대로 공유해서는 안 됩니다. 단일 코어만 사용하는 클라이언트와 달리 멀티 코어 관리 방식은 다양한 구성에 맞출 수 있지만, 코어를 바꾼 뒤에는 로그와 출구 동작을 다시 확인해야 합니다. 문제를 진단할 때 현재 코어, 진입 모드, 라우팅 프리셋을 기록하고 한 번에 하나씩 설정을 바꾸면 원인을 파악하기 쉽습니다.
설정 → 매개변수 설정 → Core: 기본 설정Core: 기본 설정
Xray-core / sing-box
선택 가능한 항목은 클라이언트 설정과 설치된 구성 요소에 따라 달라집니다.
요청 처리 순서는 다음과 같이 볼 수 있습니다. 앱이 연결을 시작하면 시스템 프록시나 가상 네트워크 인터페이스가 트래픽을 로컬 진입점으로 전달하고, 코어가 규칙을 확인한 뒤 직접 연결 또는 프록시 아웃바운드를 선택합니다. 구독 그룹은 이 실시간 처리 과정에 참여하지 않고 서버 구성을 제공합니다. 각 역할을 구분하면 구독 업데이트, 시스템 프록시 변경, 라우팅 조정이 서로 대체할 수 있는 작업이 아님을 알 수 있습니다.
처음 사용할 때는 기본 설정을 유지하고 재현 가능한 연결을 한 번 확인한 뒤 자동 업데이트, 라우팅 예외, TUN을 차례로 추가하세요. JSON을 수정해야 한다면 구성 가이드의 인바운드, 아웃바운드 및 라우팅 설명을 먼저 읽어보세요. 그래픽 인터페이스에서 설정만 하면 된다면 사용 가이드를 따라 진행하면 됩니다.
데스크톱에서는 v2rayN을 선택하고, Android에서는 코어 요구 사항에 따라 v2rayNG와 v2flyNG 중에서 고르세요. 먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 해당 플랫폼의 다운로드 페이지로 이동하세요.
v2rayN은 Desktop 데스크톱 버전과 기존 WPF 버전을 제공합니다. Desktop은 크로스 플랫폼 인터페이스를 사용하고 WPF는 해당 운영체제의 데스크톱 환경을 대상으로 합니다. 두 인터페이스는 메뉴 위치가 다를 수 있으므로 창 모양보다 가이드에 나온 설정 이름을 기준으로 찾는 편이 좋습니다.
처음 설치할 때는 다운로드 페이지의 안내에 따라 적합한 설치 파일을 선택하세요. 이미 설정을 사용 중인 기기라면 먼저 백업한 다음 인터페이스 버전을 옮길지 결정하세요. 두 인스턴스를 동시에 실행해 발생한 로컬 포트 충돌을 구독 오류로 오해하지 않도록 주의하세요.
다운로드 Windows 클라이언트v2rayN 크로스 플랫폼 데스크톱 버전을 선택하세요. Apple Silicon과 Intel 프로세서는 서로 다른 설치 파일을 사용하므로 시스템의 '이 Mac에 관하여'에서 칩 정보를 확인할 수 있습니다. 아키텍처를 확인한 다음 다운로드 페이지의 안내에 따라 설치하고 처음 실행하세요.
시스템 프록시와 TUN은 권한을 부여하는 방식이 다릅니다. 먼저 시스템 프록시로 연결을 확인한 뒤 가상 네트워크 인터페이스 관련 권한을 설정하세요. 데스크톱 구성을 옮길 때는 파일 경로와 로컬 수신 포트도 다시 확인해야 합니다.
다운로드 macOS 클라이언트먼저 Xray 코어를 사용하는 v2rayNG를 확인하고, V2Fly 코어가 필요할 때 v2flyNG를 고려하세요. 비교적 최신 스마트폰 대부분에는 arm64 패키지가 적합합니다. 기기 아키텍처를 모른다면 범용 패키지와 다운로드 페이지의 선택 안내를 확인하세요.
모바일 기기는 대개 운영체제의 VPN 인터페이스로 트래픽을 연결하므로 처음 연결할 때 시스템 권한을 확인해야 합니다. 데스크톱의 시스템 프록시 모드는 모바일의 토글과 같은 기능이 아닙니다. 앱별 설정과 백그라운드 실행 제한도 실제 연결 범위에 영향을 줍니다.
다운로드 Android 클라이언트v2rayN 데스크톱 버전은 deb 및 rpm 설치 패키지를 제공하며 프로세서 아키텍처도 구분합니다. 배포판의 패키지 형식에 맞는 파일을 고르고 기기가 x64인지 arm64인지 확인하세요. 파일 확장자만 보고 설치하지 않도록 주의해야 합니다.
데스크톱 환경에 따라 시스템 프록시와 시스템 트레이 지원이 다르며, 일부 앱은 프록시 진입점을 직접 지정해야 합니다. TUN을 사용하기 전에는 권한과 라우팅 환경을 확인하고, 이미 실행 중인 가상 네트워크 인터페이스와 컨테이너 네트워크도 점검하세요.
다운로드 Linux 클라이언트클라이언트 설치 파일은 소프트웨어를 설치하지만 사용할 수 있는 원격 서버를 자동으로 제공하지는 않습니다. 연결하려면 유효한 구독 주소나 서버 구성이 필요하며, 현재 코어가 해당 구성의 프로토콜을 지원하는지 확인해야 합니다. 구독 링크에는 접속 정보가 포함될 수 있으므로 클라이언트에만 저장하고 공개 게시물이나 로그 화면에 올리지 마세요.
다른 기기에서 옮길 때는 구독 그룹, 필요한 사용자 지정 규칙, 설정 기록을 우선 보존하세요. 시스템 권한, 로컬 경로, 네트워크 인터페이스 이름은 새 기기에서 다시 확인해야 합니다. 다운로드 페이지에서 설치 파일 형식과 시스템 요구 사항을 확인하고, 각 클라이언트의 차이는 클라이언트 비교에서 살펴보세요.
클라이언트는 구성과 조작 인터페이스를 담당하고, 코어는 연결, 전송, 라우팅을 처리합니다. 소프트웨어 이름만으로 기능을 판단하기보다 두 역할의 차이를 이해하는 편이 정확합니다.
Project V는 V2Ray 생태계를 이해하는 출발점입니다. 인바운드, 아웃바운드, 전송, 라우팅을 조합해 설정 가능한 네트워크 도구를 만든다는 것이 핵심입니다. 이후 V2Ray를 중심으로 여러 커뮤니티 프로젝트가 생겼습니다. V2Fly는 V2Ray의 커뮤니티 유지·보수 흐름을 이어가고, Xray는 관련 코드 기반에서 출발해 독립적으로 발전한 코어 프로젝트입니다. 두 프로젝트는 역사적으로 연결되어 있지만 모든 필드, 프로토콜 기능, 기본 동작이 항상 같다는 뜻은 아닙니다.
여기서 말하는 '코어'는 운영체제 커널이 아니라 프록시 연결을 실행하는 핵심 프로그램입니다. 그래픽 클라이언트는 서버 정보와 사용자 옵션을 코어가 읽을 수 있는 구성으로 변환한 뒤 해당 프로세스를 실행하고 관리합니다. 따라서 인터페이스에서 옵션을 저장할 수 있다고 해서 현재 선택한 코어가 반드시 그 기능을 실행할 수 있는 것은 아닙니다. 사용 가능 여부를 판단하려면 클라이언트 지원과 코어 기능을 모두 확인해야 합니다.
VMess와 VLESS는 일반적으로 프로토콜을 가리킵니다. TLS와 REALITY는 연결 보안 및 핸드셰이크 방식과 관련이 있고, 라우팅 규칙은 요청을 어느 아웃바운드로 보낼지 결정합니다. 각 개념은 서로 다른 계층에 있습니다. 클라이언트를 고를 때는 먼저 플랫폼을 확인하고, 연결을 설정할 때 프로토콜과 코어를 검토한 다음 진입 방식과 라우팅을 설정하면 여러 페이지를 오가며 시행착오를 줄일 수 있습니다.
v2rayN은 데스크톱 GUI 관리에 중점을 두고 구독, 서버 목록, 시스템 프록시, 라우팅 기능을 통합합니다. 크로스 플랫폼 데스크톱 인터페이스와 기존 WPF 인터페이스는 구현 방식의 차이일 뿐 프로토콜 이름과는 관계가 없습니다. 선택 가능한 코어에는 별도 프로젝트인 sing-box도 포함됩니다. sing-box 구성 형식을 Xray 구성에 그대로 적용할 수는 없습니다.
v2rayNG는 Android 기기용이며 Xray 코어를 사용합니다. v2flyNG도 Android용이지만 V2Fly 코어를 사용합니다. 이름이 비슷하더라도 기존 구성과의 호환성 및 필요한 기능을 기준으로 선택해야 하며, 어느 한쪽을 다른 쪽의 단순한 대체 설치 파일로 여겨서는 안 됩니다. 처음에는 다운로드 페이지의 권장 순서에 따라 선택하고, 특정 코어가 필요할 때 변경하세요.
v2rayN, v2rayNG, v2flyNG는 모두 오픈소스 클라이언트이며 각 클라이언트 프로젝트는 GPL-3.0 라이선스를 사용합니다. Xray-core와 V2Fly 코어는 MPL-2.0 라이선스를 사용합니다. GUI와 코어는 서로 다른 프로젝트이므로 라이선스 적용 범위도 구분해서 이해해야 합니다. 오픈소스란 라이선스에 따라 코드를 열람, 사용, 수정할 수 있다는 뜻이지 모든 네트워크 구성이 현재 기기에 적합하다는 뜻은 아닙니다.
클라이언트, 코어, 포함 구성 요소에는 각각 별도의 라이선스 안내가 제공될 수 있습니다. 개인 사용자는 오픈소스 여부를 통해 기술적 출처를 확인할 수 있습니다. 수정하거나 재배포해야 한다면 해당 라이선스 전문을 읽고 실제로 포함된 코드와 구성 요소에 따른 의무를 이행하세요. 이 사이트는 다운로드 링크와 설정 문서를 제공하며 클라이언트 프로젝트의 유지·보수를 맡지 않습니다.
클라이언트 업데이트는 주로 인터페이스, 구성 관리, 통합 방식을 변경합니다. 코어 업데이트는 프로토콜 처리, 구성 해석, 연결 동작에 영향을 줄 수 있습니다. GeoIP, GeoSite 등의 규칙 데이터베이스 업데이트는 분류 데이터를 변경합니다. 목적이 서로 다르므로 구독 업데이트로 코어를 업데이트할 수 없으며, 인터페이스를 업그레이드해도 모든 라우팅 매칭 문제가 자동으로 해결되지는 않습니다.
구독 업데이트는 구성 출처의 내용을 다시 가져오는 작업입니다. 업데이트 후 서버 항목이 추가, 삭제 또는 변경될 수 있으며 구독 관리 방식에 따라 직접 편집한 항목에도 영향을 줄 수 있습니다. 업데이트하기 전에 그룹을 확인하고 결과를 검토하세요. 인증서 오류가 발생하거나 주소에 연결할 수 없다면 시스템 시간, 네트워크 연결, 구독 유효성 순으로 확인하세요. 여러 프록시 설정을 한꺼번에 바꾸지 않는 것이 좋습니다.
사용자 지정 구성이 있는 기기는 업그레이드 전에 설정을 백업하고 사용 중인 코어와 라우팅 프리셋을 기록해 두세요. 업그레이드 후 기본 연결을 확인한 다음 DNS, 로컬 네트워크, 업무용 앱을 점검하세요. 로그는 오류가 발생한 단계를 파악하는 데 유용하지만 공유하기 전에 구독 주소, 인증 정보, 서버를 식별할 수 있는 자료를 삭제해야 합니다. 필드 간 관계는 V2Ray 구성 파일 참고에서 자세히 확인할 수 있습니다.
연결되지 않으면 먼저 로컬 진입점이 실행 중인지 확인하고, 다음으로 코어가 구성을 정상적으로 불러왔는지, 마지막으로 원격 연결 상태를 확인하세요. 브라우저와 다른 프로그램의 동작이 다르면 동일한 프록시 진입점을 사용하는지 비교하세요. 도메인은 연결되지만 일부 대상에만 접속할 수 없다면 DNS와 규칙 매칭을 확인하세요. 한 번에 한 계층만 변경하고 변경 전 상태를 기록하면 프리셋을 계속 바꾸는 것보다 원인을 찾기 쉽습니다.
처음 설치하는 방법이 필요하다면 사용 가이드를 확인하세요. 오류가 발생한 위치를 알고 있다면 문제 해결에서 설치 및 설정, 사용 팁, 오류 해결 항목을 찾아보세요. 필드별 구성 구조를 확인해야 할 때는 구성 가이드로 이동하면 됩니다. 간단한 시작 절차와 코어 설정 참고 자료를 혼동하지 않도록 구분해 두었습니다.
규칙 데이터베이스, 데스크톱 인터페이스 선택, TUN 연결 등 구체적인 설정부터 살펴보세요. 각 글은 하나의 문제를 중심으로 설명하므로 기본 연결을 완료한 뒤 이어서 읽기 좋습니다.
GeoIP와 GeoSite 규칙 데이터베이스의 역할, v2rayN에서 업데이트하는 방법과 저장 위치를 소개합니다. 라우팅 규칙 예시를 통해 국가 및 도메인 분류를 참조하는 방법도 살펴봅니다.
Avalonia 크로스 플랫폼 데스크톱 버전과 Windows 전용 WPF 버전의 인터페이스, 시스템 트레이, 지원 플랫폼 차이를 비교하고 운영체제에 맞는 설치 파일을 안내합니다.
시스템 프록시와 TUN 가상 네트워크 인터페이스의 차이 및 TUN 연결이 필요한 프로그램을 설명합니다. TUN 스위치 활성화, 관리자 권한, DNS 가로채기 관련 설정을 단계별로 안내합니다.
v2rayN