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

V2Ray 멀티플랫폼 다운로드4개 플랫폼 클라이언트와 설정

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

무료 오픈 소스 클라이언트, 구독 및 분할 라우팅 설정, 한국어 문제 해결 단계를 정리했습니다. 클라이언트 선택과 설치부터 연결 확인까지 안내합니다.

그래픽 인터페이스 Xray · V2Fly 구독 가져오기

위 화면은 클릭할 수 없는 정적 설정 대시보드 예시입니다. 포트는 로컬 리스닝의 역할을 설명하기 위한 값입니다. 버전에 따라 혼합 리스닝을 사용하거나 포트가 다를 수 있으므로 클라이언트의 매개변수 설정과 시작 로그를 확인하세요.

운영체제별 선택

4개 플랫폼 클라이언트

↗

먼저 운영체제를 확인하고 프로세서 아키텍처를 확인하세요. 데스크톱에서는 v2rayN으로 서버, 구독 그룹, 라우팅을 관리할 수 있습니다. Android에서는 v2rayNG를 먼저 살펴보고, 기존 V2Fly 설정이 필요하다면 v2flyNG를 고려하세요. 클라이언트는 설정 관리와 연결을 담당하므로, 설치 후에는 사용 권한이 있는 서버 정보나 구독 링크가 필요합니다.

Windows

v2rayN

데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 익숙한 Windows 조작 방식을 이어갑니다. 처음 사용한다면 다운로드 페이지의 환경 안내에 따라 선택하세요. 인터페이스 차이 때문에 두 클라이언트를 모두 설치할 필요는 없습니다.

실행 전에 시스템 아키텍처와 런타임 환경을 확인하세요. 설정을 가져온 뒤 현재 서버 연결을 테스트하고 시스템 프록시를 활성화하세요. 브라우저에서는 연결되지만 특정 앱에서 연결되지 않는다면 구독을 다시 가져오기보다 해당 앱이 시스템 프록시를 사용하는지 확인하세요.

다운로드 페이지로 이동

macOS

v2rayN

칩에 따라 Apple Silicon 또는 Intel 설치 파일을 선택하세요. 시스템의 ‘이 Mac에 관하여’에서 칩이나 프로세서 이름을 확인할 수 있습니다. 기기에 맞는 아키텍처의 설치 파일을 받은 뒤 시스템 안내에 따라 앱을 설치하고 처음 실행하세요.

데스크톱 클라이언트의 서버 관리와 로컬 프록시 리스닝은 서로 다른 단계입니다. 노드를 추가해도 모든 앱이 자동으로 프록시를 사용하는 것은 아닙니다. 먼저 코어가 정상적으로 시작됐는지 확인한 뒤 시스템 네트워크 프록시 설정을 점검하세요. 사용을 마치면 프록시를 해제해 종료된 포트를 가리키는 설정이 남지 않도록 하세요.

다운로드 페이지로 이동

Android

v2rayNG / v2flyNG

v2rayNG는 Xray 코어를 사용하고, v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 다운로드 페이지에서 arm64 및 범용 패키지를 각각 제공합니다. 아키텍처를 모른다면 앱 이름만 보고 판단하지 말고 기기의 시스템 정보를 먼저 확인하세요.

처음 연결할 때는 보통 시스템 VPN 권한을 확인해야 합니다. 백그라운드로 전환하면 연결이 끊기는 경우 배터리 최적화, 백그라운드 실행, 앱별 프록시 설정을 확인하세요. 두 클라이언트의 설정 호환 범위는 코어에 따라 다르므로 전환 전에 프로토콜과 전송 방식이 지원되는지 확인해야 합니다.

다운로드 페이지로 이동

Linux

v2rayN

배포판의 패키지 관리 방식에 따라 deb 또는 rpm을 선택한 다음 x64와 arm64를 구분하세요. 패키지 형식, 프로세서 아키텍처, 데스크톱 런타임 환경이 모두 맞아야 합니다. 설치가 완료됐더라도 필요한 데스크톱 구성 요소가 모두 갖춰졌다는 뜻은 아닙니다.

데스크톱 환경마다 시스템 프록시를 사용하는 방식이 다를 수 있습니다. 앱이 시스템 설정을 따르지 않으면 앱에서 프록시 유형, 주소, 포트를 직접 지정하세요. 명령줄 프로그램은 별도의 프록시 설정을 사용하는 경우가 많으므로 따로 확인해야 합니다. 그래픽 인터페이스의 연결 상태만으로 모든 프로그램의 연결을 판단하지 마세요.

다운로드 페이지로 이동

전체 클라이언트 보기 →

클라이언트 설정

구독, 라우팅, 로컬 리스닝

연결 과정을 세 단계로 나누면 이해하기 쉽습니다. 앱이 요청을 로컬 리스너에 전달하면 코어가 라우팅 규칙에 따라 직접 연결 또는 프록시 아웃바운드를 선택하고, 프록시 아웃바운드는 선택한 서버를 사용합니다. 구독은 서버 정보를 갱신하는 기능이며 앞의 두 단계 설정을 대신하지 않습니다. 문제가 생기면 각 단계별로 확인하는 편이 여러 옵션을 한꺼번에 바꾸는 것보다 원인을 찾기 쉽습니다.

ROUTING

요청 전달과 라우팅을 구분하세요

↗

시스템 프록시는 앱이 요청을 클라이언트에 전달할지 결정하고, 라우팅 모드는 코어가 요청을 받은 뒤 어떤 아웃바운드를 사용할지 결정합니다. 도메인이나 주소에 따라 경로를 나누려면 적절한 라우팅 프리셋을 선택한 뒤 규칙 순서를 확인하세요. 전역 라우팅은 모든 앱을 자동으로 프록시에 연결하는 기능이 아니라, 코어에 전달된 트래픽에만 영향을 줍니다. 앱마다 프록시 주소를 직접 입력하는 대신 규칙을 중앙에서 관리하면 일괄 조정이 쉽지만, 앱의 연결 방식은 따로 확인해야 합니다. 변경 후에는 같은 대상으로 다시 테스트해 노드 변경과 규칙 적용 결과를 혼동하지 않도록 하세요.

시스템 프록시시스템 프록시 자동 설정
라우팅 프리셋중국 본토 우회
기타 프리셋차단 목록 / 전역
규칙 일치 여부현재 규칙 순서에 따라 확인

초기 설정

3단계로 연결 확인

↗

다음 순서는 처음 설정할 때뿐 아니라 기존 설정을 정리할 때도 유용합니다. 데스크톱은 v2rayN을 기준으로 설명하며, Android 사용자는 v2rayNG의 가져오기 및 권한 설정 절차를 참고할 수 있습니다. 메뉴 이름은 버전에 따라 달라질 수 있습니다. 버튼 색상만 보지 말고 목록에 항목이 표시되는지, 코어 로그와 실제 접속 결과가 어떤지 확인하세요.

  1. 구독 또는 서버 가져오기

    전체 구독 링크나 단일 서버 공유 정보를 준비하세요. 구독을 사용한다면 먼저 그룹을 만든 뒤 해당 그룹을 업데이트하세요. 단일 서버를 사용하는 경우 클라이언트가 제공하는 가져오기 방식으로 목록에 추가하면 됩니다. 두 방식 모두 가져온 후 선택 가능한 항목이 나타나는지 확인해야 합니다. 목록이 비어 있다면 설정이 완료된 것이 아닙니다.

    파싱에 실패하면 복사한 내용에 불필요한 공백이나 줄바꿈이 있는지, 문자가 빠지지 않았는지 확인한 다음 클라이언트가 지원하는 형식인지 점검하세요. 서버 주소, 포트, 인증 매개변수를 임의로 수정하지 마세요. 해당 값은 서버 설정과 일치해야 합니다. 구독 업데이트 성공은 정보를 가져왔다는 뜻일 뿐, 모든 노드의 연결을 보장하지는 않습니다.

  2. 서버와 연결 방식 선택

    목록에서 사용할 서버를 하나 선택하고 연결 테스트와 시작 로그를 확인한 뒤 라우팅을 설정하세요. 데스크톱에서는 필요에 따라 ‘시스템 프록시 자동 설정’을 활성화합니다. Android에서 처음 연결할 때는 시스템 VPN 권한 안내를 읽고 승인하세요. 앱별 규칙을 사용한다면 대상 앱이 실제로 프록시 범위에 포함됐는지도 확인하세요.

    처음 연결을 확인할 때는 설정을 단순하게 유지하고 명확한 연결 방식과 다시 테스트할 수 있는 대상을 하나 사용하세요. 시스템 프록시, 전역 라우팅, 가상 네트워크 인터페이스는 서로 다른 기능이므로 이름이 비슷하다고 동시에 활성화하지 마세요. 다른 네트워크 제어 프로그램이 실행 중이라면 같은 인터페이스를 사용하거나 같은 시스템 설정을 변경하는지 먼저 확인하세요.

  3. 접속을 확인하고 결과 기록

    대상 앱에서 실제 페이지를 열어 연결 실패, 도메인 이름 확인 실패, 특정 기능만 사용할 수 없는 경우를 구분하세요. 지연 시간 테스트는 특정 방식으로 측정한 결과일 뿐 다운로드 속도를 나타내지 않으며 실제 접속을 대신할 수도 없습니다. 웹 페이지는 열리지만 대상 앱에서 실패한다면 앱 자체의 프록시 설정과 연결 프로토콜을 먼저 확인하세요.

    문제가 계속되면 오류가 발생한 시간과 관련 로그 일부를 보관하되 구독 주소, 인증 정보, 민감한 서버 정보는 가리세요. 로컬 리스닝, 앱 연결, 라우팅 규칙, 서버 설정 순서로 확인하세요. 사용을 마친 뒤 필요 없는 시스템 프록시를 해제해야 클라이언트 종료 후 앱이 이전 포트로 계속 연결을 시도하지 않습니다.

전체 가이드 보기 →

오픈 소스 생태계 및 유지 관리

Project V, V2Fly, Xray

‘V2Ray’는 서로 관련된 여러 프록시 도구를 통칭하는 말로 자주 쓰이지만, 클라이언트 이름, 코어 계열, 프로토콜 이름은 서로 다른 개념입니다. 각각의 차이를 이해하면 어떤 앱을 다운로드할지, 어떤 설정을 가져올지, 오류 발생 시 인터페이스 설정과 코어 기능 중 어디를 확인할지 판단하기 쉽습니다.

Project V / V2Ray 생태계 V2Fly · Xray 코어 계열 그래픽 클라이언트 및 설정 관리

생태계의 배경과 코어 분기

Project V는 조합해 사용할 수 있는 네트워크 프록시 도구를 중심으로 발전했으며, V2Ray는 널리 알려진 구현체입니다. V2Fly 커뮤니티는 관련 핵심 프로젝트의 유지 관리를 이어가고, Xray는 관련 기술 기반에서 출발해 독자적인 기능 방향으로 발전했습니다. 두 코어는 일부 개념을 공유하지만 구현과 설정에 차이가 있으므로, 코어만 바꾸면 모든 설정이 그대로 작동한다고 볼 수 없습니다.

프로토콜, 전송 방식, 보안 계층은 함께 이해해야 합니다. 예를 들어 VLESS와 VMess는 프록시 프로토콜 이름이고, REALITY는 연결 보안 메커니즘과 관련된 기능입니다. 전송 방식은 또 다른 설정 항목입니다. 서버 공유 정보에는 이런 내용이 함께 포함되는 경우가 많습니다. 한 가지 이름만 보고 호환성을 판단하면 서버가 요구하는 추가 매개변수를 놓쳐 가져오기는 성공했지만 핸드셰이크에 실패할 수 있습니다.

세 클라이언트의 역할과 범위

v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 그래픽 클라이언트입니다. 구독, 서버 선택, 매개변수 관리를 조작 가능한 인터페이스로 제공하며, 실제 네트워크 처리는 해당 코어가 담당합니다. v2rayN은 데스크톱용이고, v2rayNG와 v2flyNG는 Android용으로 각각 Xray와 V2Fly 기반 연결 기능을 제공합니다.

클라이언트를 고를 때는 기기의 운영체제를 먼저 확인하고 기존 설정에 필요한 기능도 살펴보세요. 인터페이스에 같은 프로토콜 이름이 표시되어도 모든 전송 조합을 똑같이 지원한다는 뜻은 아닙니다. 이미 작동하는 설정이 있다면 주요 매개변수를 유지하세요. 이전이 필요하다면 먼저 소규모로 확인한 뒤 구독과 규칙을 정리해 인터페이스 이전과 네트워크 문제를 혼동하지 않도록 하세요.

오픈 소스 라이선스 및 설정 자료

오픈 소스란 해당 라이선스 조건에 따라 코드를 확인하고 사용하거나 수정할 수 있다는 뜻이지, 관련 구성 요소가 모두 같은 라이선스를 따른다는 뜻은 아닙니다. 클라이언트, 코어, 포함된 규칙 데이터는 각각 다른 조건을 적용받을 수 있습니다. 재배포하거나 수정할 때는 전체 생태계를 하나의 소프트웨어로 취급하지 말고 각 구성 요소의 라이선스를 확인해 필요한 고지 사항을 유지하세요.

클라이언트를 무료로 사용할 수 있는지와 원격 서버 이용료가 있는지는 별개입니다. 앱을 설치해도 사용할 수 있는 서버가 자동으로 만들어지지 않으며, 구독 기간, 접근 권한, 노드 관리는 제공자가 결정합니다. 이 사이트는 설치 경로와 사용 정보를 정리하며 구독 계정을 제공하지 않습니다. 정보를 가져오기 전에 출처를 신뢰할 수 있는지, 사용 권한이 있는지, 어떤 네트워크 설정이 포함되는지 확인하세요.

업데이트 전후 점검 순서

그래픽 인터페이스, 코어, 라우팅 데이터의 업데이트는 서로 다른 작업일 수 있습니다. 클라이언트를 업데이트한 뒤에는 선택한 코어, 활성 서버, 로컬 리스닝을 다시 확인하세요. 구독 업데이트 후에는 현재 노드가 제공자 목록에 남아 있는지 확인해야 합니다. 한 번 연결에 실패했다고 모든 구성 요소를 연이어 업데이트하지 마세요. 변경 사항이 많아지면 변수가 늘어나 문제를 재현하기 어려워집니다.

업데이트 전에 클라이언트에 내보내기 기능이 있다면 필요한 설정을 저장하고 민감한 정보가 포함된 파일은 안전하게 보관하세요. 업데이트 후에는 기존에 작동하던 설정 하나를 먼저 테스트한 뒤 사용자 지정 DNS, 라우팅 규칙, 앱 연결 방식을 확인하세요. 새로운 오류가 발생하면 구체적인 오류 내용과 변경 단계를 기록해 증상에 따라 원인을 찾으세요. 업데이트 완료를 연결 복구와 동일하게 보아서는 안 됩니다.

최근 사용 노트

연결 및 구독 문제 해결

↗

증상에 맞는 글부터 확인하세요. 코어가 시작되지 않으면 로컬 포트를 먼저 살펴보고, 구독 업데이트 후 목록이 비어 있다면 출처와 파싱을 확인하세요. 노드 연결 시간이 초과되면 연결 경로를 단계적으로 점검하세요. 같은 ‘연결할 수 없음’ 메시지도 원인은 다를 수 있으므로 로그와 재테스트 결과에 따라 순서를 정해야 합니다.

전체 글 보기 →

v2rayN 다운로드