클라이언트 다운로드
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하고 V2Fly 코어가 필요하다면 v2flyNG를 고려하세요. 먼저 기기의 아키텍처를 확인한 뒤 다운로드 페이지에서 맞는 항목을 선택하세요. 클라이언트 설치 후 연결하려면 유효한 서버 설정이나 구독 링크가 필요합니다.
v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용해 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하려는 경우에 적합합니다. WPF 버전은 익숙한 클래식 데스크톱 인터페이스를 유지하므로 기존 사용 방식에 맞춰 선택할 수 있습니다. 두 버전 모두 서버 매개변수에 맞춰 프로토콜, 전송 방식, 보안 계층을 설정해야 합니다. 화면 모양만으로 연결 지원 여부를 판단하지 마세요.
처음 설치할 때는 시스템 요구 사항과 실행 환경부터 확인하세요. 이미 사용 가능한 설정이 있다면 업그레이드 전에 구독 그룹, 라우팅 규칙, 로컬 수신 설정을 기록해 두세요. 여러 항목을 한꺼번에 바꾸면 문제 원인을 찾기 어려워질 수 있습니다.
다운로드 페이지로 이동v2rayN은 Apple Silicon과 Intel 칩에 따라 설치 항목이 다릅니다. 시스템의 ‘이 Mac에 관하여’에서 칩 정보를 확인한 다음 해당 아키텍처에 맞는 파일을 선택하세요. 칩 아키텍처는 프로그램 실행 여부를 결정하고 프로토콜은 클라이언트와 서버의 연결 방식을 결정합니다. 컴퓨터를 바꿨다고 구독의 프로토콜을 직접 변경할 필요는 없습니다.
설치 후 먼저 일반 시스템 프록시가 작동하는지 확인한 뒤 필요에 따라 더 넓은 범위의 트래픽을 처리하도록 설정하세요. 권한 요청이 표시되면 시스템 안내를 읽고 작업 대상이 다운로드한 클라이언트와 일치하는지 확인하세요.
다운로드 페이지로 이동v2rayNG는 Xray 코어를 사용하며 Android에서 우선 권장되는 클라이언트입니다. v2flyNG는 V2Fly 코어를 사용하므로 해당 설정을 이미 보유한 경우 대안으로 고려할 수 있습니다. 대부분의 기기에서는 arm64를 선택하면 됩니다. 아키텍처를 확인하기 어렵다면 범용 버전 안내를 참고하세요. 구독을 가져온 뒤에는 항목에 현재 코어가 지원하는 프로토콜과 보안 계층이 포함되어 있는지 확인하세요. 호환되지 않는 설정을 두 클라이언트에 번갈아 가져오지 마세요.
연결하려면 시스템 VPN 권한을 허용해야 합니다. 앱을 전환한 뒤 연결이 끊긴다면 배터리 최적화, 백그라운드 실행 권한, 다른 앱의 VPN 인터페이스 사용 여부를 확인하세요. 이러한 시스템 동작이 구독 만료를 의미하는 것은 아닙니다.
다운로드 페이지로 이동v2rayN은 deb 및 rpm 설치 파일을 제공하며 x64와 arm64를 구분합니다. 먼저 배포판의 패키지 관리 방식에 맞는 형식을 고르고 프로세서 아키텍처를 확인하세요. GUI 클라이언트는 데스크톱 환경에서 구독과 서버를 관리하고 라우팅을 조정하는 데 적합합니다. 설치 파일 형식은 프로토콜 지원에 영향을 주지 않으며, 실제 지원 범위는 클라이언트가 사용하는 코어에 따라 달라집니다.
데스크톱 시스템 프록시 설정이 모든 앱에 적용되는 것은 아닙니다. 브라우저는 연결되지만 다른 프로그램은 작동하지 않는다면 해당 프로그램이 시스템 프록시 설정을 따르는지 먼저 확인하세요. 그다음 TUN과 필요한 권한을 검토하면 됩니다. 곧바로 클라이언트를 다시 설치할 필요는 없습니다.
다운로드 페이지로 이동설정 기능
왼쪽에서 설정 항목을 선택하세요. 화면 예시는 설정 항목을 설명하기 위한 것으로, 실제 메뉴 이름은 클라이언트에 따라 다를 수 있습니다. 매개변수를 입력할 때는 서버에서 제공한 정보와 현재 코어의 지원 범위를 기준으로 삼으세요.
구독은 여러 서버 설정을 하나의 주소로 관리해 항목을 정기적으로 동기화할 수 있게 합니다. v2rayN에서는 구독 그룹별로 출처를 구분할 수 있고, v2rayNG에서는 구독 설정에 주소를 추가해 업데이트할 수 있습니다. 처음 가져올 때는 원본 링크를 보관하고 그룹에 식별 가능한 설정이 표시되는지 확인한 다음 연결할 항목을 선택하세요. 업데이트에 실패하면 주소 만료, 네트워크 연결 불가, 응답 형식 비호환 여부를 구분해 확인해야 합니다. 프록시를 통해 업데이트할지는 구독 주소에 실제로 접속할 수 있는지에 따라 결정하세요. 개별 공유 링크를 하나씩 붙여 넣는 것보다 구독으로 동기화하기 편리하지만, 업데이트 과정에서 직접 수정한 항목이 바뀔 수도 있습니다.
구독 가져오기 단계 보기 →라우팅은 연결을 직접 연결할지 프록시로 보낼지 결정하고, DNS는 도메인 조회와 일부 IP 규칙의 일치 여부에 영향을 줍니다. 용도에 맞는 프리셋을 먼저 선택한 다음 로컬 네트워크, 업무 서비스, 특정 도메인 등의 예외를 설정하세요. 규칙은 일반적으로 순서대로 적용되므로 범위가 넓은 규칙을 앞에 두면 뒤에 있는 세부 규칙이 적용되지 않을 수 있습니다. 도메인 전략은 라우팅 판단을 위해 도메인을 조회할지 결정하는 설정이지, 모든 DNS 요청이 프록시를 통과한다는 뜻은 아닙니다. 전역 모드만 전환하는 것보다 트래픽을 세밀하게 나눌 수 있지만, 규칙 순서와 DNS 조회 위치, 규칙 데이터의 적용 범위를 함께 이해해야 합니다.
라우팅 규칙 활용 가이드 →VMess, VLESS, Trojan, Shadowsocks는 서로 다른 프록시 프로토콜이며 REALITY는 VLESS 등과 함께 사용할 수 있는 보안 계층 방식입니다. 서로 같은 계층의 요소로 보고 임의로 바꾸면 안 됩니다. 공유 링크를 가져온 뒤에는 주소, 인증 정보, 전송 방식, 보안 계층 매개변수가 모두 입력되었는지 확인하세요. 메뉴에서 특정 항목을 선택할 수 있다고 해서 모든 코어가 해당 조합을 실행할 수 있는 것은 아닙니다. 다중 프로토콜 클라이언트의 장점은 여러 설정을 한곳에서 관리하는 것이지, 한 프로토콜을 다른 프로토콜로 자동 변환하는 것이 아닙니다. 클라이언트 선택 시 서버 호환성을 우선 확인하고 기기 성능과 유지 관리 편의성도 고려하세요.
프로토콜 선택 가이드 보기 →GUI 클라이언트는 설정을 편집하고 관리하며, 실제 연결 처리는 코어가 담당합니다. Xray와 V2Fly는 기술적 뿌리를 공유하지만 기능 발전 방향과 설정 필드가 완전히 같지는 않습니다. v2rayN에서 선택할 수 있는 코어는 배포 패키지와 설정 유형에 따라 달라집니다. v2rayNG는 Xray를, v2flyNG는 V2Fly를 사용합니다. 지원되지 않는 필드가 있다면 인증 정보를 반복해서 바꾸기보다 먼저 코어의 지원 범위를 확인하세요. GUI는 직접 설정 파일을 관리하는 수고를 줄여 주지만, 설정을 내보내거나 코어를 전환하거나 클라이언트를 옮길 때는 프로토콜 조합과 생성된 필드의 호환성을 확인해야 합니다.
코어 종류별 차이 알아보기 →시스템 프록시는 시스템 프록시 설정을 따르는 앱에 주로 적용되며, 기기 전체의 트래픽이 처리된다는 뜻은 아닙니다. TUN은 가상 네트워크 인터페이스를 통해 더 많은 트래픽을 처리하며, 대개 권한과 라우팅, DNS 설정도 함께 필요합니다. 설정 메뉴는 플랫폼과 클라이언트 구현에 따라 달라집니다. 처음에는 일반 프록시 연결부터 확인한 뒤 앱 사용 방식에 따라 TUN을 고려하세요. Android 클라이언트는 시스템 VPN 인터페이스로 트래픽을 처리하는 경우가 많고 앱별 범위도 설정할 수 있습니다. 브라우저 프록시만 바꾸는 것보다 적용 범위가 넓지만, 다른 VPN 도구와 로컬 네트워크 접근, 절전 후 연결 복구 동작도 확인해야 합니다.
연결 및 작동 확인 방법 보기 →오픈 소스 생태계와 설정 범위
V2Ray는 Project V 생태계의 핵심 프로젝트 중 하나입니다. 설정 이름을 외우는 것보다 ‘클라이언트, 코어, 프로토콜’의 관계를 이해하는 편이 유용합니다. 클라이언트는 조작 인터페이스를 제공하고, 코어는 연결을 처리하며, 프로토콜은 양측의 통신 방식을 정합니다. 데스크톱과 모바일에서 서로 다른 클라이언트를 사용할 수 있지만, 서버 매개변수는 각 클라이언트에서 올바르게 설정해야 합니다.
Project V는 모듈형 네트워크 프록시 도구를 지향하며, V2Ray는 인바운드, 아웃바운드, 라우팅, 전송 등의 기능을 하나의 설정 체계로 구성합니다. V2Fly는 V2Ray를 바탕으로 커뮤니티의 유지 관리와 개발을 이어 갑니다. Xray는 관련 코드 기반에서 발전해 일부 프로토콜과 보안 계층에서 자체 구현을 발전시켰습니다. 둘은 같은 프로그램의 스킨만 다른 것이 아니며 이름이 비슷하다고 설정을 그대로 바꿔 쓸 수 있는 것도 아닙니다.
GUI 클라이언트는 이런 기능에 구독 그룹, 공유 링크 해석, 메뉴 설정, 로그 확인 기능을 더합니다. 사용자가 인터페이스에서 설정을 선택하면 클라이언트가 이를 코어가 이해할 수 있는 설정으로 변환하는 경우가 많습니다. 따라서 인터페이스에 저장되었다는 것은 입력이 받아들여졌다는 뜻일 뿐입니다. 실제 실행과 연결 여부는 코어 로그와 서버 상태를 함께 확인해야 합니다.
따라서 가이드에는 클라이언트 이름과 코어 이름을 함께 표기해야 합니다. ‘라우팅 설정’이라는 이름의 메뉴라도 프리셋이 다를 수 있고, 같은 공유 링크도 구현체에 따라 필드 인식이 달라질 수 있습니다. 기기를 옮길 때는 먼저 기본 연결을 확인하고 사용자 지정 규칙을 하나씩 옮기는 편이 기존 설정을 한꺼번에 가져오는 것보다 문제를 쉽게 찾을 수 있습니다.
Xray와 V2Fly는 여러 프록시 설정을 처리할 수 있지만, 지원하는 세부 필드와 전송 조합, 확장 기능은 각 프로젝트의 발전에 따라 달라집니다. REALITY 같은 특정 기능을 사용할 때는 해당 기능을 명확히 지원하는 코어를 선택해야 합니다. 기존 V2Fly 설정도 지원되는 형식에 맞춰 사용해야 하며, 프로토콜 이름 하나만 바꾼다고 같은 결과를 기대할 수는 없습니다.
연결 품질은 서버 부하, 네트워크 경로, 전송 방식, 기기 성능에도 영향을 받습니다. 프로토콜 이름만으로 지연 시간 단축, 배터리 절약, 속도 향상을 보장할 수는 없습니다. 모바일에서는 백그라운드 연결의 안정성, 잦은 재연결 여부, 불필요한 기능의 활성화 여부를 특히 확인하세요. 실제 필요가 없다면 기본 설정을 유지하고 한 번에 한 항목씩 조정해야 각 설정의 영향을 파악하기 쉽습니다.
구독에 여러 프로토콜이 포함되어 있다면 클라이언트가 지원하는 방식으로 설정을 생성할 수 있습니다. 로그에 알 수 없는 필드, 필수 매개변수 누락, 지원되지 않는 보안 계층이 표시되면 가져온 설정과 코어의 지원 범위를 확인한 뒤 설정 제공자에게 매개변수를 문의하세요. 같은 오류 필드를 둔 채 서버만 계속 바꿔도 이런 실행 문제는 해결되지 않는 경우가 많습니다.
v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 GUI 클라이언트이며 핵심 코드는 GPL 계열 라이선스를 사용합니다. V2Fly의 v2ray-core와 Xray-core 핵심 코드는 MPL 2.0을 사용합니다. 클라이언트와 코어, 함께 포함된 종속성의 라이선스가 반드시 같은 것은 아닙니다. 각 배포물에 포함된 라이선스와 제3자 고지를 확인해야 하며 특정 코어의 라이선스를 설치 패키지 전체에 적용해서는 안 됩니다.
일반 사용자에게 오픈 소스란 프로그램의 구현을 살펴볼 수 있고, 커뮤니티가 문제 제보와 호환성 개선, 기능 개발을 함께 진행할 수 있다는 뜻입니다. 그렇다고 설정 출처를 따져 볼 필요가 없어지거나 모든 구독 서비스를 신뢰할 수 있는 것은 아닙니다. 클라이언트는 도구일 뿐입니다. 서버 운영자와 구독 주소 제공자, 로그에 기록되는 정보는 각각 확인해야 합니다.
문제를 공유할 때는 오류 유형과 관련 설정 이름, 필요한 환경 정보만 남기는 것이 좋습니다. 구독 링크와 인증 정보, 전체 설정에는 접속 자격 증명이 포함될 수 있으므로 공개된 곳에 그대로 올리지 마세요. 문제를 파악하는 데 필요한 것은 대개 오류가 발생한 상황이지 개인 설정 전체가 아닙니다.
클라이언트, 코어, 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 인터페이스와 링크 해석, 기능 통합에 주로 영향을 줍니다. 코어 업데이트는 하위 프로토콜 및 설정 동작에 영향을 미치고, 구독 업데이트는 서버 항목을 동기화합니다. 구독 업데이트만 실패했다고 클라이언트 설치가 손상되었다고 단정하지 마세요. 코어가 시작되지 않을 때도 먼저 모든 구독을 삭제하고 다시 만들 필요는 없습니다.
업데이트 전에 현재 작동하는 설정과 사용자 지정 항목을 기록해 두세요. 업데이트 후에는 기존 연결 방식을 유지한 채 일반적인 웹 접속과 자주 쓰는 앱을 확인하고, 새 기능은 하나씩 시험하세요. 코어와 DNS, 라우팅, 트래픽 처리 모드를 한꺼번에 바꾸면 문제가 생겨도 원인을 찾기 어렵습니다.
사이트 홈에서는 플랫폼별 다운로드 경로와 설정 안내를 제공하며, 구체적인 설치 파일 정보는 다운로드 페이지에서 확인할 수 있습니다. 업데이트 필요 여부는 숫자 변화만 볼 것이 아니라 현재 문제와 필요한 기능, 릴리스 정보를 함께 고려하세요. 오래 사용하기 쉬운 설정은 간결해야 합니다. 사용자 지정 규칙마다 분명한 목적이 있어야 하며 더 이상 필요하지 않으면 삭제하세요.
v2rayN: 데스크톱용으로 여러 구독 그룹을 관리하고 로그를 확인하며 자주 쓰는 라우팅을 유지하는 데 적합합니다. 데스크톱 플랫폼에 따라 인터페이스와 시스템 프록시 연동, 권한 동작이 다를 수 있으므로 한 플랫폼의 사용법을 다른 플랫폼에 그대로 적용하지 마세요. 기존 설정을 사용한다면 인터페이스나 코어 옵션을 조정하기 전에 자주 쓰는 프로토콜과 사용자 지정 규칙이 정상적으로 불러와지는지 확인하세요.
v2rayNG: Android용 클라이언트로 Xray 코어를 사용하며 구독, 공유 링크, 연결 설정을 모바일 인터페이스에서 관리합니다. 실제 사용 범위는 시스템 VPN 권한과 앱별 프록시, 백그라운드 실행 정책에 따라 달라집니다. 특정 앱에서 연결할 수 없다면 프록시 규칙뿐 아니라 해당 앱이 트래픽 처리 대상에서 제외되었는지도 확인하세요. 구독을 다시 가져오는 것만으로 해결하려 해서는 안 됩니다.
v2flyNG: V2Fly 코어가 필요한 Android 환경을 위한 클라이언트로, 해당 코어에 맞는 설정을 이미 보유한 경우 대안으로 사용할 수 있습니다. 이름은 v2rayNG와 비슷하지만 코어 기능을 동일하다고 가정해서는 안 됩니다. 선택하기 전에 프로토콜과 전송 매개변수를 확인하세요. 설정이 특정 코어 확장 기능에 의존한다면 해당 기능을 지원하는 클라이언트를 사용해야 합니다. 가져온 뒤 핵심 필드를 계속 삭제하거나 바꾸지 마세요.
세 클라이언트 모두 유효한 연결 설정을 사용자가 직접 준비해야 합니다. GUI는 설정을 관리할 뿐 설치만으로 서버를 만들어 주지는 않습니다. 처음 사용하는 경우 설정 가이드를 먼저 확인하세요. 프로토콜과 보안 계층, 코어 호환성을 비교하려면 프로토콜 자세히 알아보기를 참고하세요. 구독 업데이트나 연결 문제가 발생하면 자주 묻는 질문에서 증상에 따라 원인을 좁혀 보세요.
설정 가이드
기본 연결이 작동하면 규칙과 관리 설정을 하나씩 살펴보세요. 아래 세 글은 각각 트래픽 경로, 핸드셰이크 오류, 여러 구독 관리 방법을 다룹니다. 현재 겪는 문제에 맞춰 읽으면 되며 모든 설정을 먼저 바꿀 필요는 없습니다.
로컬 사이트는 직접 연결하고 다른 대상은 프록시를 사용하는 일반적인 상황을 바탕으로 도메인 규칙과 IP 규칙, 일치 순서를 알아봅니다. 규칙 데이터와 도메인 전략이 판단에 미치는 영향을 설명하고 v2rayN과 v2rayNG에 규칙을 적용해 DNS 조회 문제를 서버 오류로 오해하지 않도록 돕습니다.
글 읽기 →TLS 오류가 발생하면 먼저 기기 시간과 인증서 도메인을 확인한 다음 SNI가 서버 요구 사항과 일치하는지 살펴보세요. 이 글에서는 흔한 오류 원인을 구분하고 인증서 검증을 건너뛸 때의 위험을 설명해, 검증을 끄는 설정을 장기간 사용하는 대신 문제를 찾도록 돕습니다.
글 읽기 →여러 구독이 한 목록에 섞여 있다면 그룹으로 출처를 구분한 뒤 메모의 키워드로 필터링하고 정렬하세요. 이 글에서는 구독 업데이트 후 항목이 어떻게 바뀌는지, 어떤 설정을 그룹에 적용해야 하는지, 중복 가져오기로 인한 관리 혼란을 줄이는 방법을 설명합니다.
글 읽기 →