클라이언트 다운로드 · 프로토콜 설정 안내

V2Ray 중문 커뮤니티 클라이언트 다운로드

v2rayN 다운로드 사용 가이드 보기

오픈소스 클라이언트부터 구독 가져오기까지 기기에 맞는 다운로드 경로를 선택하세요. 서버 설정과 프로토콜 및 보안 계층을 확인한 다음 시스템 프록시와 라우팅을 설정하면 됩니다.

  • 프로토콜 / 보안 계층
  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
  • REALITY
Windows Android macOS Linux

플랫폼에 맞는 클라이언트 선택

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 확인하세요. V2Fly 코어 설정과의 호환성이 필요하다면 v2flyNG도 고려할 수 있습니다. 클라이언트는 설정을 관리하고, 실제 연결 가능 여부는 코어와 서버가 함께 결정합니다. 다운로드 전에 프로토콜 이름만으로 호환성을 판단할 필요는 없습니다.

Windows

v2rayN으로 데스크톱 구독을 관리하세요. 다운로드 페이지에서 크로스플랫폼 데스크톱 버전과 클래식 WPF 버전을 비교하고, 익숙한 인터페이스와 실행 환경에 맞춰 선택할 수 있습니다.

다운로드 페이지로

macOS

v2rayN을 선택한 뒤 ‘이 Mac에 관하여’에서 칩 종류를 확인하세요. Apple Silicon과 Intel은 설치 경로가 다릅니다.

다운로드 페이지로

Android

우선 Xray 기반 v2rayNG를 선택하세요. V2Fly 설정과의 호환성이 필요하다면 v2flyNG를 확인하고 기기 아키텍처도 점검하세요.

다운로드 페이지로

Linux

v2rayN은 데스크톱 GUI 설정 기능을 제공합니다. 배포판에 맞는 deb 또는 rpm 패키지를 선택하고 프로세서가 x64인지 arm64인지 확인하세요.

다운로드 페이지로

같은 클라이언트의 설치 경로가 다르다고 해서 서비스 요금제가 다른 것은 아닙니다. 클라이언트를 설치한 뒤에는 사용 권한이 있는 서버 설정이나 구독 링크를 직접 준비해야 합니다. 이 사이트는 클라이언트와 설정 정보를 제공하며, 바로 연결할 수 있는 서버는 제공하지 않습니다. 이미 구독 중이라면 제공 업체가 안내한 클라이언트 요구 사항을 먼저 확인한 뒤 플랫폼에 맞는 프로그램을 선택하세요.

기존 클라이언트에서 옮길 예정이라면 먼저 기존 설정과 라우팅 기록을 보관하세요. 사용 가능한 설정 하나로 연결을 테스트한 다음 나머지 구독을 가져오는 편이 좋습니다. 모든 그룹을 한꺼번에 옮기고 DNS를 바꾸면서 가상 네트워크 어댑터까지 활성화하면 문제 원인을 구분하기 어려워집니다. 다운로드 페이지에서 설치 경로와 아키텍처 차이를 확인하고, 자세한 사용 순서는 가이드에서 살펴보세요.

전체 클라이언트 보기 →

프로토콜과 설정 범위

프로토콜 매개변수를 확인하고 트래픽 유입 경로를 구분하세요.

가져오기에 성공했다는 것은 설정을 인식했다는 뜻일 뿐, 연결 조건이 충족됐다는 의미는 아닙니다. 구독 가져오기, 아웃바운드 핸드셰이크, 라우팅, 프로그램 트래픽 처리 과정은 서로 다르므로 문제를 해결할 때는 한 번에 조건 하나만 변경하세요.

먼저 구독 주소에 접속할 수 있는지 확인하세요

구독 업데이트는 원격 설정을 가져오는 기능이지 프록시 연결을 자동으로 설정하는 기능이 아닙니다. 구독 그룹에 전체 주소를 저장한 다음 현재 네트워크 상태에 맞는 업데이트 방식을 선택하세요. 사용 가능한 연결이 있다면 프록시를 통해 가져올 수도 있습니다. 목록이 비어 있다면 링크 만료 여부와 응답이 설정 데이터인지 먼저 확인한 뒤 프로토콜 항목을 점검하세요. 단일 공유 링크를 가져오는 것보다 구독 그룹을 사용하면 변경 사항을 계속 동기화하기 편리하지만, 업데이트 중 원격 관리 항목이 덮어써질 수 있으므로 직접 수정한 설정은 별도로 저장하세요.

처음 사용하는 중이라 연결이 아직 없다면 ‘프록시를 통해 업데이트’만으로 구독을 가져오려 하지 마세요.

설치부터 연결 확인까지

구독 가져오기 3단계

전체 가이드 보기 →

설정 출처를 확인하고 연결을 점검한 뒤 트래픽 처리 범위를 넓히세요. 다음 순서는 처음 사용하는 경우뿐 아니라 설정을 옮길 때도 문제를 쉽게 추적할 수 있는 출발점이 됩니다. 클라이언트 메뉴 이름은 인터페이스 변경에 따라 달라질 수 있지만 세 단계의 순서는 같습니다.

  1. 클라이언트를 설치하고 구독 그룹 저장

    다운로드 페이지에서 기기에 맞는 플랫폼을 선택하고 프로세서 아키텍처에 맞는 설치 파일을 받으세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 사용하세요. 처음 실행한 뒤 프로그램이 정상적으로 열리고 코어가 시작되는지 확인한 다음 구독 관리에서 새 그룹을 추가합니다. 제공 업체가 안내한 전체 구독 주소를 입력란에 붙여넣고 알아보기 쉬운 그룹 이름을 지정하세요.

    구독 링크와 웹페이지 주소는 서로 다를 수 있습니다. 로그인 페이지, 안내 페이지, 추가 인증이 필요한 페이지는 대개 구독으로 바로 가져올 수 없습니다. 복사할 때 주소 앞뒤의 공백이나 줄바꿈, 메신저에서 붙은 문장부호가 포함되지 않도록 주의하세요. 구독 주소에는 접근 인증 정보가 들어 있을 수 있으므로 문제를 해결할 때 전체 링크를 공개 게시물이나 스크린샷에 노출하지 마세요.

    그룹을 저장한 뒤 업데이트를 실행하고 목록에 인식 가능한 설정이 표시되는지 확인하세요. 공유 링크가 하나만 있다면 해당 가져오기 기능을 사용하고 원격 구독 주소 입력란에 억지로 넣지 마세요. 자세한 경로는 구독 준비 및 가져오기 안내를 확인하세요.

  2. 설정을 선택하고 트래픽 유입 경로 지정

    가져온 목록에서 사용할 설정 하나를 선택하고 주소, 포트, 프로토콜이 모두 입력됐는지 확인하세요. v2rayN에서는 먼저 시스템 프록시로 연결을 테스트합니다. 브라우저에 수동 프록시를 설정한 적이 있다면 브라우저가 시스템 프록시를 따르는지, 별도로 지정한 포트를 계속 사용하는지도 확인해야 합니다. 두 경로가 동시에 설정돼 있으면 클라이언트는 전환했지만 브라우저는 이전 설정을 사용하는 상황이 생길 수 있습니다.

    Android에서 연결을 시작할 때는 시스템에서 표시하는 VPN 연결 권한을 확인하세요. 권한 허용은 클라이언트가 로컬 트래픽 경로를 만들 수 있다는 뜻이지 원격 서버에 연결됐다는 뜻은 아닙니다. 앱별로 트래픽을 처리한다면 테스트할 앱이 대상에 포함돼 있는지도 확인하세요. 시스템에 연결 아이콘이 표시된다는 이유만으로 구독이 유효하거나 원격 핸드셰이크가 성공했다고 판단하지 마세요.

    이 단계에서는 목적이 분명한 라우팅 프리셋을 사용하고 복잡한 예외 규칙은 나중에 추가하세요. 데스크톱에서 가져오는 방법은 v2rayN 구독 가져오기, Android 사용법은 v2rayNG 구독 가져오기를 확인하세요.

  3. 실제 요청을 확인한 뒤 트래픽 분기 조정

    선택한 아웃바운드를 반드시 거쳐야 하는 요청을 하나 골라 테스트하고, 일반 직접 연결과 LAN 접속도 예상대로 작동하는지 확인하세요. 클라이언트 내 연결 테스트, 브라우저에서의 실제 접속, 다른 앱의 요청은 각각 확인 범위가 다릅니다. 하나가 성공했다고 해서 다른 프로그램도 같은 트래픽 경로와 DNS 경로를 사용한다고 볼 수는 없습니다.

    연결에 실패하면 구독을 가져오지 못한 것인지, 코어가 시작되지 않은 것인지, 원격 핸드셰이크가 실패했는지, 요청이 클라이언트에 들어오지 않은 것인지 먼저 구분하세요. 관련 로그를 확인할 때는 오류 유형과 발생 순서를 기록하고 구독 주소, 인증 정보, 개인 네트워크 정보는 가리세요. 라우팅이나 DNS를 수정했다면 변경 전 값을 기록해 두세요. 항목별로 되돌려 비교하는 편이 클라이언트를 계속 재설치하는 것보다 원인을 찾기 쉽습니다.

    일반 프록시 연결이 확인된 뒤 필요에 따라 TUN을 활성화하거나 앱별 처리 범위를 지정하세요. 클라이언트를 종료한 뒤 시스템 프록시가 복구됐는지도 확인해야 합니다. 프로그램이 로컬 포트에서 더 이상 요청을 받지 않는데 다른 앱이 계속 그 포트로 요청을 보낼 수 있습니다. 추가 점검은 문제 해결을 참고하고, 프로토콜과 코어, 라우팅을 한꺼번에 바꾸지는 마세요.

오픈소스 생태계와 유지 관리 범위

Project V, V2Fly와 Xray

V2Ray는 생태계를 가리키는 이름이자 프로토콜과 코어의 관계를 이해하는 출발점입니다. GUI 클라이언트, 연결 코어, 원격 서버, 구독 제공 업체는 각각 역할이 다릅니다. 각 계층을 구분해야 기능을 어디에서 설정해야 하는지, 업데이트가 무엇에 영향을 줄 수 있는지 판단할 수 있습니다.

CLIENTv2rayN / v2rayNG / v2flyNG

구독 관리, 화면 조작 및 설정 구성

COREXray / V2Fly

프로토콜 구현, 연결 처리 및 라우팅 실행

Project V: 프로토콜 모음에서 설정 체계까지

Project V는 V2Ray를 중심으로 인바운드, 아웃바운드, 전송, 라우팅을 구성해 네트워크 연결을 관리하는 설정 체계를 발전시켜 왔습니다. VMess는 대표적인 프로토콜이지만 V2Ray가 VMess만을 의미하는 것은 아니며 관련 클라이언트가 모두 같은 프로그램인 것도 아닙니다. GUI에 여러 프로토콜이 표시된다면 클라이언트가 하위 코어용 설정을 여러 방식으로 생성할 수 있다는 뜻일 수 있습니다. 모든 조합이 현재 사용 중인 서버에 적합하다는 의미는 아닙니다.

일상적인 사용에서는 계층별 흐름을 이해하는 것이 가장 중요합니다. 로컬 프로그램이 요청을 인바운드로 전달하고, 라우팅 규칙이 사용할 아웃바운드를 정한 뒤, 아웃바운드가 약속된 프로토콜과 보안 계층으로 원격 서버에 연결합니다. 어느 한 계층이라도 맞지 않으면 ‘사이트에 연결할 수 없음’으로 나타날 수 있습니다. 따라서 프로토콜 선택은 서버의 전체 설정과 함께 판단해야 하며, 특정 이름이 더 최신인지 비교하는 것만으로 결정할 수 없습니다.

V2Fly와 Xray: 연관성은 있지만 자유롭게 바꿔 쓸 수는 없습니다

V2Fly는 V2Ray를 이어 커뮤니티에서 유지 관리하고 있으며, Xray는 관련 코드 기반에서 별도의 코어 방향으로 발전했습니다. 설정의 공통된 배경은 있지만 기능과 매개변수는 각자 발전해 왔습니다. VLESS, REALITY, 특정 흐름 제어 조합을 사용할 때는 해당 코어의 지원 여부를 특히 확인해야 합니다. 프로토콜 이름을 인식한다고 해서 다른 코어가 서버의 모든 확장 기능까지 지원하는 것은 아닙니다.

구독을 가져올 때는 클라이언트 자체의 형식 파싱과 설정 변환도 거칠 수 있습니다. 코어가 비슷한 두 클라이언트라도 공유 링크 필드, 기본값, 전송 옵션을 처리하는 방식이 다를 수 있습니다. 코어를 바꾸기 전에 제공 업체가 요구하는 프로토콜 조합을 확인하고 원본 설정을 보관하세요. VMess의 사용 조건, 시간 동기화 요구 사항, 프로토콜 차이를 더 자세히 알아보려면 VMess 프로토콜 안내를 참고하세요.

세 가지 클라이언트: GUI 관리와 코어 선택

v2rayN은 데스크톱용 클라이언트로 구독 그룹, 활성 설정, 시스템 프록시, 라우팅 등을 GUI에서 관리할 수 있으며 지원되는 코어를 사용할 수 있습니다. v2rayNG는 Android용 Xray 코어 클라이언트이고, v2flyNG는 V2Fly 코어를 사용하는 Android 대안입니다. Android 클라이언트를 고를 때는 화면 사용 방식보다 서버 요구 사항과 매개변수 호환성을 먼저 확인하세요. 두 클라이언트는 이름만 다른 동일한 설치 파일이 아닙니다.

세 클라이언트 모두 GPL-3.0 라이선스로 배포됩니다. 오픈소스 라이선스는 코드의 사용, 수정, 배포 조건을 설명하지만 구독 출처, 원격 서비스, 실제 네트워크 동작을 판단하는 기준은 아닙니다. 코어별 라이선스 범위도 다릅니다. 예를 들어 V2Fly와 Xray의 핵심 코드는 MPL-2.0을 사용합니다. 재배포할 때는 클라이언트 이름만으로 판단하지 말고 각 구성 요소의 라이선스와 고지 사항을 따로 확인하세요.

업데이트 관리: 클라이언트·코어·구독을 따로 확인

클라이언트 업데이트는 화면, 가져오기 로직, 설정 생성 방식을 바꿀 수 있습니다. 코어 업데이트는 실제 프로토콜 구현에 영향을 주고 구독 업데이트는 원격에서 제공하는 설정 내용을 바꿉니다. 각각 해결하는 문제가 다릅니다. 구독이 만료됐다면 클라이언트를 업그레이드해도 서비스가 복구되지 않습니다. 코어가 인식하지 못하는 항목이 있다면 구독만 반복해서 업데이트해도 해결되지 않을 수 있습니다. 먼저 문제가 발생한 계층을 확인한 뒤 적절한 조치를 선택하세요.

업데이트하기 전에 구독 그룹, 직접 설정한 아웃바운드, 사용자 지정 라우팅을 백업하고 현재 사용하는 코어 유형을 기록하세요. 업데이트 후에는 기존에 작동하던 설정으로 비교한 다음 새 기능을 시험하세요. 모바일 기기에서는 백그라운드 실행 제한과 절전 설정도 살펴봐야 합니다. 배터리 사용량은 프로토콜뿐 아니라 연결 수, DNS 요청, 신호 상태, 앱 동작에도 영향을 받으므로 프로토콜 이름만으로 일률적인 배터리 소모 순위를 정할 수 없습니다.

작업 기록과 설정 안내

최근 기술 문서

전체 글 보기 →

현재 겪는 문제에 맞춰 살펴보세요. 처음 설치할 때는 폴더, 권한, 프록시 모드를 확인하고 구독 업데이트 문제는 주소 접속과 내용 파싱을 구분하세요. 라우터 배포에서는 기기 자원과 네트워크 구성을 따로 고려해야 하므로 데스크톱 클라이언트 설정을 그대로 적용하지 않는 것이 좋습니다.