오픈소스 클라이언트Project V

V2Ray 중문판 클라이언트 다운로드

운영체제에 맞는 그래픽 클라이언트를 선택하고 구독을 가져와 설정하세요. 연결에 문제가 생기면 증상별로 하나씩 확인하면 됩니다.

V2Ray 클라이언트 주요 설정

노드가 표시된다고 해서 설정이 모두 끝난 것은 아닙니다. 앱이 프록시를 사용하는지, 코어가 노드와 핸드셰이크할 수 있는지, 요청이 규칙에 따라 라우팅되는지는 각각 다른 설정에 달려 있습니다. 아래 눈금을 증상에 맞춰 선택하고 확인할 항목부터 찾아보세요.

프로토콜, 전송 방식 및 보안 설정

노드를 정상적으로 가져왔는데 핸드셰이크에 계속 실패한다면, 우선 프로토콜과 전송 방식, 보안 설정이 서버와 일치하는지 확인하세요. VMess, VLESS, Trojan, Shadowsocks의 설정값은 서로 바꿔 쓸 수 없으며, 같은 프로토콜도 전송 방식에 따라 설정이 달라질 수 있습니다. 여러 코어를 지원하는 데스크톱 클라이언트에서는 노드 편집 화면에서 값을 확인한 뒤 실제로 활성화된 코어도 점검하세요. 단일 프로토콜 도구보다 다중 프로토콜 클라이언트가 관리에 편리하지만, 코어를 바꿔도 기존 설정값이 자동으로 변경되지는 않습니다. 서로 다른 것이 확인된 항목만 수정한 뒤 실제 연결을 테스트하세요.

관련 문제 해결: 인터넷에 연결되지 않음 →
노드 편집 · 확인 순서
  • 프로토콜 유형
  • 전송 프로토콜 (network)
  • 전송 계층 보안 (security)
  • 서버 이름 (serverName)

운영체제에 맞는 설치 파일 선택

프로그램이 실행되지 않으면 노드를 바꾸기 전에 운영체제, CPU 아키텍처, 패키지 형식부터 확인하세요. 설치와 연결은 별개의 단계입니다. 클라이언트가 정상적으로 실행되고 설정 화면을 열 수 있는지 확인한 다음 구성을 가져와 네트워크 문제를 점검하세요.

Windows

v2rayN 데스크톱 버전 또는 클래식 WPF 버전을 선택하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용합니다. 기존 조작 방식에 익숙하거나 이전 버전 메뉴를 참고해야 한다면 WPF 버전도 확인해 보세요. 먼저 시스템 정보에서 x64인지 확인하세요.

배포 패키지를 압축 해제해야 한다면 쓰기 권한이 있는 폴더에 전체 압축을 푼 뒤 프로그램을 실행하세요. 런타임 관련 안내가 표시되면 누락된 구성 요소 이름을 확인하고 다운로드 페이지의 안내에 따라 설치한 뒤 다시 시도하세요.

다운로드 페이지로 이동

macOS

v2rayN에 맞는 칩 패키지를 선택하세요. ‘이 Mac에 관하여’에서 칩 또는 프로세서를 확인할 수 있습니다. Apple 칩은 arm64, Intel 프로세서는 x64에 해당합니다. 운영체제 버전만으로는 아키텍처를 판단할 수 없습니다.

디스크 이미지에서 설치한 뒤 ‘응용 프로그램’ 폴더에서 클라이언트를 다시 실행하세요. 시스템 경고가 표시되면 아키텍처 불일치, 운영체제 버전 요구 사항, 권한 안내 중 무엇인지 먼저 확인하세요. 각각 해결 방법이 다릅니다.

다운로드 페이지로 이동

Android

일반적으로 Xray 기반 v2rayNG를 사용합니다. V2Fly 설정이 필요한 경우에는 v2flyNG를 확인하세요. 먼저 기기에서 지원하는 앱 아키텍처를 확인하고, arm64를 지원하면 해당 패키지를 선택하세요. 확실하지 않다면 범용 패키지를 확인할 수 있습니다.

설치 후 앱을 연 상태에서 처음 VPN 권한을 승인하세요. 네트워크를 바꾸거나 화면을 잠근 뒤에만 연결이 끊긴다면 같은 노드로 다시 테스트하고, 다른 VPN 연결과 백그라운드 배터리 제한을 차례로 확인하세요.

다운로드 페이지로 이동

Linux

배포판에서 사용하는 패키지 형식부터 확인하세요. Debian 및 Ubuntu 계열은 보통 deb, Fedora 계열은 보통 rpm을 선택합니다. 그런 다음 시스템 정보에서 x64 또는 arm64를 확인하세요. 패키지 이름에 표시된 아키텍처는 서로 바꿔 사용할 수 없습니다.

이 링크에서는 그래픽 클라이언트를 다운로드할 수 있습니다. 설치에 성공해도 현재 데스크톱 환경이 모든 앱의 프록시 설정을 처리하는 것은 아닙니다. 설정 후 브라우저로 확인하고 문제가 생긴 앱이 데스크톱 프록시 설정을 따르는지 점검하세요.

다운로드 페이지로 이동
전체 클라이언트 보기 →

구독 가져오기, 연결 및 확인

처음 설정할 때는 기기 하나, 네트워크 하나, 노드 하나로 연결 경로를 확인하세요. 각 단계에서 확인한 결과를 기록해 두면 다른 기기에서도 성공 조건을 재현하거나 실패 지점을 찾기 쉽습니다.

  1. 구독을 가져와 노드가 그룹에 추가됐는지 확인

    데스크톱 v2rayN에서 구독 그룹을 추가하고 주소를 저장한 뒤 해당 그룹을 수동으로 업데이트하세요. v2rayNG에서는 구독 그룹 관리에 주소를 추가한 다음 업데이트해야 합니다. 노드 목록에 항목이 나타나면 방금 업데이트한 그룹에 속하는지 확인해 이전 노드를 새 구독 결과로 착각하지 않도록 하세요.

    노드 수가 그대로라면 업데이트 중 표시된 안내를 확인하세요. 시간 초과라면 가져오는 경로를 확인하고, 지원되지 않는 형식이라는 안내가 나오면 구독 유형을 점검하세요. 구독 주소에 접근 정보가 포함될 수 있으므로 문제 해결용 스크린샷에서는 주소 전체를 가리세요.

  2. 노드를 선택하고 연결 활성화

    방금 가져온 그룹에서 클라이언트 코어와 호환되는 노드를 선택하세요. 데스크톱에서는 해당 설정이 활성화되어 있는지 확인한 뒤 시스템 프록시를 켜고, 모바일에서는 연결을 시작해 시스템 VPN 권한을 승인하세요. 첫 테스트는 기본 규칙으로 진행하고 사용자 지정 라우팅이나 DNS 설정은 추가하지 마세요.

    연결 버튼을 눌렀는데 곧바로 연결 해제 상태로 돌아오면 로그의 첫 오류부터 확인하세요. 포트 충돌, 인식되지 않는 설정, 핸드셰이크 실패는 서로 다른 문제입니다. 먼저 실행 오류를 해결한 뒤 접속을 테스트하세요.

  3. 같은 앱으로 요청 경로 확인

    시스템 프록시를 사용하는 브라우저에서 새 요청을 보내고 연결 전후의 접속 결과를 기록하세요. 필요하면 외부 IP와 클라이언트 로그도 비교해 보세요. 노드 지연 시간을 측정할 수 있어도 브라우저 요청이 같은 경로를 거쳤다는 뜻은 아닙니다.

    사이트 하나만 접속되지 않는다면 같은 브라우저에서 동일한 아웃바운드를 사용할 것으로 예상되는 다른 대상도 테스트한 뒤 규칙 적용 여부와 도메인 조회를 확인하세요. 프록시를 꺼도 접속할 수 없다면 먼저 기본 네트워크를 복구하세요. 여러 노드와 규칙을 한꺼번에 바꾸지는 마세요.

전체 사용 안내 보기 →

Project V, V2Fly, Xray의 관계

프로젝트, 코어, 클라이언트, 노드 프로토콜은 서로 다른 개념입니다. 사용 안내를 읽거나 문제를 보고하기 전에 어느 단계에 관한 내용인지 먼저 확인하세요. 특히 시작 단계에서 오류가 발생했다면 화면에 표시된 이름만으로 실제 실행 중인 코어를 판단할 수 없습니다.

프로젝트 계보
Project V
코어 계열
V2Fly / Xray
그래픽 클라이언트
v2rayN / v2rayNG / v2flyNG
핵심 개념 확인 →
  1. Project V로 이해하는 모듈형 프록시

    V2Ray는 Project V에서 시작됐습니다. 요청을 받는 인바운드, 요청을 전달하는 아웃바운드, 요청의 경로를 정하는 라우팅을 각각 독립된 설정으로 나눕니다. 인바운드는 브라우저나 다른 앱의 요청을 코어에 전달합니다. 라우팅은 조건에 따라 아웃바운드를 선택하고, 아웃바운드는 직접 연결, 프록시 또는 기타 처리를 담당합니다.

    이 세 단계는 자주 발생하는 문제 유형과도 연결됩니다. 코어가 연결을 받지 못한다면 로컬 연결 설정을 확인하세요. 요청이 코어에 전달됐지만 잘못된 경로로 나간다면 라우팅 순서를 점검하세요. 요청이 예상한 아웃바운드에 도달했는데도 실패한다면 서버 설정과 네트워크 접근성을 확인하세요. ‘웹페이지가 열리지 않는다’는 증상만으로 원인을 추측하는 것보다 문제를 이 세 단계로 나누는 편이 정확합니다.

  2. V2Fly와 Xray는 각각 지원 범위가 다릅니다

    V2Fly 커뮤니티는 V2Ray 핵심 프로젝트를 이어갑니다. Xray는 해당 코드 계보에서 파생된 뒤 독립적으로 발전해 왔으며, 두 프로젝트는 각 커뮤니티에서 관리합니다. 공통된 설정 개념도 있지만 지원하는 전송 방식, 보안 계층, 필드는 다를 수 있습니다. 프로토콜 이름이 같다고 해서 양쪽 코어가 모든 설정을 동일하게 지원하는 것은 아닙니다.

    ‘항목은 가져왔는데 코어가 시작되지 않는’ 경우 로그에 표시된 필드를 먼저 확인한 뒤 해당 코어에서 그 옵션을 지원하지 않는 것인지, 클라이언트가 설정을 생성할 때 값이 빠진 것인지 판단하세요. 코어를 바꾸기 전에 기존 선택을 기록해 두세요. 비교 테스트에서는 같은 노드와 네트워크를 유지해야 차이가 어느 단계에서 비롯됐는지 알 수 있습니다.

  3. 프로토콜 구현이 공개되어도 설정값까지 호환되는 것은 아닙니다

    VMess, VLESS, Trojan, Shadowsocks는 모두 오픈소스 프록시 생태계에서 구현되어 있습니다. 프로토콜은 양쪽에서 데이터를 주고받는 방식을 정하고, 전송 방식과 보안 계층은 데이터를 전달하고 보호하는 방법을 결정합니다. 예를 들어 VLESS라는 프로토콜 이름만으로 TLS가 설정됐다고 판단할 수는 없습니다. TLS와 전송 방식을 같은 항목으로 취급해서도 안 됩니다.

    공유된 설정을 살펴볼 때는 먼저 프로토콜을 확인하고, 전송 방식과 보안 계층을 각각 서버 설정 및 해당 필드와 비교하세요. 다른 안내에서 설정값 하나만 복사하면 양쪽에서 일치하던 설정이 달라질 수 있습니다. 프로토콜이 공개되어 있으면 구현을 비교하고 문제를 해결하기 쉽지만, 특정 구독이나 제3자 서비스가 클라이언트 프로젝트에 속한다는 뜻은 아닙니다.

  4. 세 가지 오픈소스 클라이언트의 그래픽 설정 기능

    v2rayN은 노드, 구독, 라우팅을 관리하고 설정에 맞는 코어를 선택할 수 있는 데스크톱 그래픽 클라이언트입니다. v2rayNG는 Xray 기반으로 모바일 구독과 VPN 연결을 지원합니다. v2flyNG는 V2Fly 기반으로 V2Fly 호환성을 확인해야 하는 모바일 설정에 적합합니다. 세 제품 모두 오픈소스 클라이언트이며, 화면에서 설정을 관리하고 실제 연결은 하위 코어가 처리합니다.

    구독 서비스와 클라이언트도 서로 다른 것입니다. 클라이언트를 설치해도 노드가 자동으로 생기지 않으며, 앱이 실행된다고 구독이 여전히 유효한 것도 아닙니다. 원격 서버 오류, 만료된 항목, 앱 권한 부족은 각각 구독 제공처, 노드 설정, 기기 설정을 확인해야 합니다. 먼저 오류가 어느 쪽에서 발생했는지 파악한 뒤 관련 안내를 찾아보세요.

  5. 소프트웨어, 코어, 구독의 업데이트 주기는 서로 다릅니다

    클라이언트 업데이트는 화면 구성, 시스템 지원, 패키징 방식을 바꿀 수 있습니다. 코어 업데이트는 새 필드를 추가하거나 연결 동작을 수정할 수 있습니다. 구독 업데이트는 제공처의 노드 목록만 동기화합니다. 구독 업데이트에 성공해도 소프트웨어 업그레이드를 대신할 수 없으며, 클라이언트를 다시 설치해도 만료된 구독이 되살아나지는 않습니다.

    업그레이드 전에 사용자 지정 라우팅과 설정을 백업하고 현재 코어와 정상 작동하는 연결 모드를 기록해 두세요. 업그레이드 후에는 기존 노드부터 확인한 다음 선택 설정을 하나씩 복원하세요. 문제가 다시 발생하면 발생 시각, 플랫폼과 아키텍처, 선택한 코어, 재현 단계, 민감 정보를 가린 로그를 기록해 두세요. 인터넷에 연결되지 않는다는 스크린샷만 제공하는 것보다 원인을 찾기 쉽습니다.

구독, 연결 및 프록시 모드 안내

문제가 발생한 단계에 따라 문서를 선택하세요. 구독 업데이트에 실패하면 가져오기와 파싱을, 노드가 표시되지만 첫 연결에 실패하면 노드와 아웃바운드를 확인하세요. 특정 앱에서만 문제가 다르게 나타난다면 시스템 프록시와 라우팅을 구분해 점검하세요.

전체 글 보기 →