클라이언트 비교 / 설치 / 설정
Windows / macOS / Android / Linux용 v2rayN · v2rayNG 클라이언트. 오픈소스 클라이언트를 중심으로 4개 플랫폼 설치와 구독 가져오기 방법을 정리했습니다. 시스템 프록시부터 라우팅 규칙까지 설정 단계별로 확인하세요.
Xray-core · V2Fly-core · GPL-3.0 오픈소스 클라이언트
주요 기능
V2Ray 클라이언트의 일상적인 설정은 네 단계로 나눌 수 있습니다. 구독은 연결 설정을 가져와 관리하고, 코어는 프로토콜과 전송을 처리합니다. 시스템 프록시는 일부 앱의 트래픽을 클라이언트로 보낼지 결정하며, 라우팅은 클라이언트에 들어온 트래픽의 출구를 정합니다. 문제가 생기면 모든 설정을 바꾸기보다 어느 단계에서 발생했는지 먼저 구분하는 편이 원인을 찾기 쉽습니다.
아래 그림은 v2rayN 메뉴 구조를 기준으로 설정 위치를 설명합니다. 목록이 비어 있는 창은 예시일 뿐, 설정을 가져오거나 연결된 상태를 나타내지 않습니다. 운영체제나 클라이언트 배포판에 따라 메뉴 위치는 다를 수 있습니다. 각 설정의 역할을 먼저 이해한 뒤 안내에 따라 조작하면 라우팅 모드를 시스템 프록시 스위치로 착각하거나 구독 업데이트를 코어 업데이트와 혼동하는 일을 줄일 수 있습니다.
문제 해결도 이 네 단계를 따라 진행하세요. 목록이 비어 있으면 설정 가져오기를 확인하고, 코어가 시작되지 않으면 설정과 포트를 살펴보세요. 브라우저 요청이 클라이언트에 들어오지 않으면 연결 방식을 확인하고, 일부 목적지만 문제가 있을 때 라우팅 규칙과 이름 해석을 점검하면 됩니다. 한 번에 한 항목만 바꾸고 변경 전후의 증상을 기록해야 설정 오류와 원격 서비스 문제를 구분할 수 있습니다. 구체적인 증상은 문제 해결 안내서에서 하나씩 확인하세요.
플랫폼별 다운로드
데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 먼저 확인하세요. V2Fly 설정이 필요한 경우 v2flyNG도 비교해 볼 수 있습니다. 설치 패키지는 먼저 운영체제와 프로세서 아키텍처에 맞춰야 하며, 그다음에 인터페이스와 코어를 선택하면 됩니다. 다운로드 페이지에서 각 플랫폼의 설치 파일과 안내를 확인할 수 있습니다. 클라이언트는 연결 설정을 처리하는 도구이며 원격 서비스를 제공하지 않습니다. 처음 실행할 때는 합법적으로 제공받은 유효한 구독이나 서버 설정이 필요합니다.
Windows 데스크톱에서는 v2rayN을 사용합니다. 다운로드 페이지에는 차세대 크로스 플랫폼 인터페이스 버전과 클래식 WPF 버전이 구분되어 있어 선호하는 UI에 따라 선택할 수 있습니다. 처음 설치한다면 각 버전의 시스템 요구 사항을 먼저 확인하세요. 기존 설정을 사용 중이라면 이전 여부를 결정하기 전에 구독 그룹, 라우팅 및 사용자 지정 설정을 백업하는 것이 좋습니다.
실행한 뒤에는 설정이 정상적으로 저장되고 코어가 시작되는지 확인한 다음 구독을 가져오고 서버와 시스템 프록시를 설정하세요. 종료 후에도 브라우저에 접속 문제가 생기면 시스템 프록시가 중지된 로컬 포트를 가리키는지 확인해야 합니다. 여러 프록시 프로그램이 같은 시스템 설정을 동시에 관리하지 않도록 하세요. 연결 문제가 생길 때마다 재설치를 먼저 시도하는 것도 바람직하지 않습니다.
다운로드 페이지로 이동macOS에서 v2rayN을 사용하려면 먼저 ‘이 Mac에 관하여’에서 칩 정보를 확인하세요. Apple Silicon은 ARM64, Intel 프로세서는 x64에 해당합니다. 칩에 맞는 설치 패키지를 선택하면 아키텍처 불일치로 인한 실행 문제를 줄일 수 있습니다. 구체적인 시스템 요구 사항은 다운로드 페이지와 선택한 배포판 안내를 확인하세요. 기기 외관이나 구매 연도만으로 판단하지 마세요.
설치한 뒤 앱에서 구독을 관리하고 시스템 네트워크 프록시를 확인하세요. 네트워크 서비스마다 별도의 프록시 설정이 유지될 수 있으므로 네트워크를 바꾼 뒤 동작이 달라지면 현재 연결된 네트워크를 점검해야 합니다. 시스템 보안 경고가 표시되면 안내에 따라 앱 출처와 필요한 권한을 확인하세요. 설치를 위해 시스템 보안 기능 전체를 끌 필요는 없습니다.
다운로드 페이지로 이동Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 권장합니다. V2Fly 코어가 필요한 경우 대안으로 v2flyNG를 확인할 수 있습니다. 최신 스마트폰 대부분은 ARM64 패키지를 사용할 수 있습니다. 기기 아키텍처를 모른다면 시스템 정보나 다운로드 페이지의 범용 패키지 안내를 확인하세요. 두 앱은 이름이 비슷하지만 설정 지원 범위는 사용하는 코어에 따라 달라지므로 화면만 보고 매개변수 호환성을 판단할 수 없습니다.
처음 연결을 시작할 때 Android는 로컬 VPN 인터페이스를 만들기 위한 권한을 요청합니다. 이는 Android 클라이언트가 기기의 트래픽을 처리하는 방식입니다. 권한을 허용한 뒤에는 구독이 업데이트됐고 현재 설정이 선택됐는지 확인하세요. 앱을 백그라운드로 보냈을 때 연결이 끊기면 배터리 최적화와 백그라운드 실행 제한을 점검하세요. 일부 앱만 문제가 있다면 앱별 규칙과 VPN 인터페이스를 사용하는 다른 프로그램이 있는지 확인해야 합니다.
다운로드 페이지로 이동Linux 데스크톱에서는 v2rayN을 사용합니다. 배포판의 패키지 체계에 맞춰 deb 또는 rpm을 고르고, 프로세서에 따라 x64 또는 ARM64를 선택하세요. Debian·Ubuntu 계열은 보통 deb, Fedora 계열은 보통 rpm을 사용합니다. 패키지 형식과 프로세서 아키텍처는 별개의 조건이므로 하나가 맞더라도 다른 하나까지 맞는 것은 아닙니다.
설치 후에는 GUI 의존성, 사용자 설정 디렉터리의 쓰기 권한, 코어 실행 상태를 확인하세요. 시스템 프록시 지원 방식은 데스크톱 환경마다 다를 수 있습니다. 특정 앱에서 프록시가 작동하지 않으면 먼저 해당 앱의 네트워크 설정을 살펴보세요. 데스크톱 로그인 시 자동 실행을 설정하려면 수동 실행과 접속 테스트를 먼저 마치세요. 그래야 실행 순서 문제와 구독 문제를 혼동하지 않습니다.
다운로드 페이지로 이동빠른 시작
처음 설정할 때는 유효한 설정 하나로 가장 단순한 연결 경로를 확인한 다음 규칙을 단계적으로 추가하세요. 데스크톱용 v2rayN과 Android용 v2rayNG는 메뉴 위치와 트래픽 연결 방식이 다르지만 기본 순서는 같습니다. 설정 가져오기, 사용할 서버 선택, 트래픽 연결 방식 활성화, 접속 확인 순입니다. 아래에는 필수 단계만 정리했으며, 전체 가이드에서는 화면별로 자세히 설명합니다.
전체 구독 주소를 복사한 뒤 구독 그룹 설정에서 새 그룹을 만들고 알아보기 쉬운 이름을 입력해 저장하세요. 그런 다음 업데이트를 실행합니다. 구독 주소와 단일 서버 공유 링크는 가져오는 메뉴가 다르므로 붙여넣기 전에 내용 유형을 확인해야 합니다. 업데이트 후 설정 항목이 목록에 나타나는지 확인하세요. 목록이 비어 있다면 주소 만료 여부, 복사할 때 불필요한 공백이 들어갔는지, 현재 네트워크에서 구독 서비스에 접속할 수 있는지부터 점검하세요.
구독 업데이트는 서비스를 구매하거나 개통하는 것과 다릅니다. 클라이언트는 설정을 읽어올 뿐이며 구독의 유효 기간과 접근 권한은 제공자가 관리합니다. 다른 사람에게 문제를 문의할 때 오류 메시지는 공유해도 되지만 전체 구독 주소, 식별 정보, 인증 매개변수는 반드시 가리세요.
목록에서 사용할 서버를 선택하고, 우선 기본 라우팅 설정을 유지한 채 데스크톱 시스템 프록시 또는 Android 연결 스위치를 활성화하세요. 데스크톱 시스템 프록시는 해당 설정을 따르는 앱에 주로 영향을 줍니다. Android 클라이언트는 보통 로컬 VPN 인터페이스로 트래픽을 연결합니다. 어느 쪽이든 모든 프로그램이 같은 네트워크 경로를 사용한다고 보장하지 않으므로 스위치 상태만으로 기기 전체의 연결을 판단할 수 없습니다.
이 단계에서는 사용자 지정 DNS, 복잡한 규칙, 여러 프록시 프로그램을 한꺼번에 추가하지 마세요. 코어가 정상적으로 시작되고 로컬 수신 포트가 작동하는지 확인한 뒤 도메인별 직접 연결, 로컬 네트워크 접근 또는 앱별 설정을 다루세요. 이후 규칙을 변경할 때는 문제가 생기면 비교하고 복구할 수 있도록 기존 설정을 보관하세요.
프록시를 사용할 대상과 직접 연결할 대상을 각각 방문하고 클라이언트 로그에 요청이 기록되는지 확인하세요. 연결 버튼이 켜져 있다는 것은 클라이언트가 실행을 시도한다는 뜻일 뿐, 실제 접속 확인을 대신하지 않습니다. 요청이 클라이언트에 들어오지 않으면 앱의 프록시 설정을 확인하세요. 요청은 들어왔지만 연결이 완료되지 않는다면 서버 매개변수, 코어 호환성, 원격 서버 접속 가능성을 점검해야 합니다.
문제가 발생한 시간과 네트워크 환경, 구체적인 오류를 기록하고 한 번에 한 항목씩 확인하세요. 데스크톱 클라이언트를 종료하기 전에는 필요한 경우 시스템 프록시가 해제됐는지 확인해야 합니다. 간헐적인 문제는 한 번의 테스트 결과만으로 클라이언트나 서버의 정상 여부를 판단하지 말고 서로 다른 네트워크에서 비교하세요.
오픈소스 생태계
Project V는 V2Ray 생태계를 이해하는 출발점입니다. 일상적으로 말하는 ‘V2Ray’는 프록시 코어를 가리키기도 하고, 관련 프로토콜과 설정을 중심으로 한 도구 생태계를 통칭하기도 합니다. GUI 클라이언트는 코어에 서버 목록, 구독 그룹, 시스템 연결 설정, 로그 확인 화면을 더합니다. 이 두 종류의 소프트웨어를 구분해야 ‘클라이언트가 실행된다’는 것과 ‘코어가 특정 설정을 처리할 수 있다’는 것이 왜 서로 다른지 정확히 이해할 수 있습니다.
V2Fly 커뮤니티는 V2Ray를 이어서 유지·발전시키고 있으며, Xray는 관련 코드와 기술적 배경을 바탕으로 발전한 독립 분기입니다. 두 코어 계열은 공통된 배경이 있지만 각자 기능을 추가하고 설정과 릴리스 방식을 조정합니다. 같은 프로그램의 이름만 다른 것도 아니며, 단순히 ‘구버전을 신버전으로 대체’하는 관계로 설명할 수도 없습니다. 실제 프로토콜, 전송 방식, 보안 매개변수와 클라이언트 지원 여부를 기준으로 선택하세요.
VMess, VLESS, Trojan, Shadowsocks는 연결 설정에서 자주 볼 수 있는 프로토콜 이름입니다. REALITY는 연결 보안 메커니즘과 관련되므로 앞의 프로토콜과 같은 계층의 선택지로 단순 비교해서는 안 됩니다. 클라이언트에 특정 프로토콜이 표시되더라도 모든 코어가 그 프로토콜의 관련 매개변수를 전부 지원한다는 뜻은 아닙니다. 구성을 비교할 때는 프로토콜, 전송 방식, 보안 설정, 원격 서버의 요구 사항을 함께 확인해야 합니다.
예를 들어 REALITY 설정을 사용하는 경우 선택한 코어와 클라이언트가 해당 필드를 올바르게 처리하는지 확인하세요. 다른 코어 계열로 전환하기 전에 기능 차이를 살펴보고 복구할 수 있는 설정 사본을 보관해야 합니다. 필드를 인식하지 못하거나 시작에 실패하면 오류가 사라질 때까지 매개변수를 임의로 삭제하기보다 먼저 호환성 문제를 확인하세요. 자세한 용어 설명은 용어집에서 분류별로 확인할 수 있습니다.
v2rayN, v2rayNG, v2flyNG는 GPL-3.0 오픈소스 라이선스를 따릅니다. 오픈소스는 코드를 연구하고 라이선스 조건을 확인할 수 있다는 뜻이며, 사용·수정·배포에는 해당 조건을 준수해야 합니다. 클라이언트와 호출하는 코어, 함께 제공되는 다른 구성 요소에는 각각 별도의 라이선스가 적용될 수 있습니다. GUI 프로젝트의 라이선스가 생태계 전체에 동일하게 적용된다고 볼 수는 없습니다.
클라이언트가 무료라는 사실과 원격 서비스에 요금이 부과되는지는 별개의 문제입니다. GUI 도구를 설치해도 유효한 연결 권한이 자동으로 생기지 않습니다. 구독 출처와 설정 용도, 이용 중인 네트워크 환경의 요구 사항을 확인하세요. 소프트웨어 이름이나 사이트 브랜드를 원격 서비스 이용 권한의 증명으로 오해해서는 안 됩니다.
클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 각각 인터페이스 프로그램, 연결 처리 구성 요소, 서버 설정을 갱신합니다. 서로 다른 설정에 영향을 줄 수 있으므로 문제가 생겼을 때 한꺼번에 모두 바꾸지 마세요. 클라이언트를 업데이트하기 전에 구독 그룹, 사용자 지정 라우팅, 필요한 앱 설정을 백업하세요. 업데이트가 끝나면 기존 연결을 먼저 테스트한 뒤 새 기능을 활성화하세요.
이 사이트에서는 다운로드와 한국어 사용 방법을 안내하며, 브랜드명은 사이트 이름으로 사용될 뿐 각 상위 프로젝트의 공식 권한을 뜻하지 않습니다. 설치 파일은 다운로드 페이지에서 확인할 수 있으며, 홈페이지에는 특정 릴리스 번호를 고정 표시하지 않습니다. 실제로 사용할 때는 다운로드 페이지의 설치 파일, 해당 운영체제 요구 사항, 설정 호환성 안내를 기준으로 선택하세요. 업데이트 후 문제가 생기면 문제 해결 절차에 따라 원인을 찾아보세요.
기술 문서
기본 설정을 마친 뒤 생태계와 동작 방식에 관한 설명을 살펴보세요. 클라이언트와 코어를 구분하고 시스템 프록시와 라우팅의 차이를 이해하면 기능 비교와 문제 해결에 필요한 공통 기준을 갖출 수 있습니다. 아래에는 프로젝트 관계, 코어 차이, 트래픽 흐름을 다룬 최신 글 세 편을 게시일 순으로 소개합니다.
Project V의 시작부터 V2Fly 커뮤니티의 유지·관리와 Xray 분기까지 살펴본 뒤, v2rayN·v2rayNG·v2flyNG의 생태계 내 역할과 오픈소스 라이선스를 설명합니다. 프로젝트 이름과 클라이언트의 역할, 코어의 범위를 구분하고 싶은 독자에게 적합합니다. 읽은 뒤 실제 플랫폼에 맞는 도구를 선택해 보세요.
글 읽기 →Xray-core와 V2Fly-core의 분기 배경, 프로토콜 및 전송 지원 차이, 클라이언트에서 코어를 전환할 때 확인해야 할 설정 호환성을 정리합니다. 코어 이름만으로 연결 성능을 단순 비교하기보다 현재 설정에 적합한지 판단하는 방법을 중점적으로 설명합니다.
글 읽기 →시스템 프록시 스위치와 라우팅 모드가 서로 다른 계층의 설정임을 설명하고, 전역·중국 본토 우회·직접 연결 모드의 트래픽 흐름과 사용 상황을 비교합니다. ‘스위치는 켜졌는데 일부 앱은 달라지지 않는다’면 이 글을 참고해 트래픽이 실제로 클라이언트에 들어오는지 확인하세요.
글 읽기 →