V2RAY CLIENTS · CONFIGURATION GUIDE

V2Ray 공식 다운로드: v2rayN / v2rayNG 클라이언트

Windows, macOS, Android, Linux용 클라이언트 다운로드와 설정 문서를 제공하며, 구독 가져오기, 시스템 프록시, TUN 모드 및 라우팅 규칙의 실제 설정 방법을 한곳에 정리했습니다.

오픈 소스 무료 사용 Xray · V2Fly 커널 계열 한국어 사용 문서
ROUTE / LOCAL TO OUTBOUND TCP · SOCKS · ROUTING
04 SUPPORTED PLATFORMS 02 CORE FAMILIES PROJECT V ECOSYSTEM OPEN SOURCE CLIENTS

PLATFORM ENTRY

운영체제에 맞는 설치 패키지 페이지로 이동하세요

다운로드 페이지에서 플랫폼별 클라이언트, 설치 패키지 형식과 선택 방법을 확인할 수 있습니다. 데스크톱에서는 v2rayN을 사용하고, Android에서는 필요한 커널에 따라 v2rayNG 또는 v2flyNG를 선택하세요.

DESKTOP · V2RAYN

Windows

데스크톱 버전과 클래식 WPF 버전을 제공합니다. 새로 설치한다면 먼저 크로스 플랫폼 인터페이스의 데스크톱 버전을 선택할 수 있습니다. 기존 창 배치, 서버 목록과 트레이 메뉴에 익숙하다면 클래식 버전을 확인하세요. 설치 전에 시스템 아키텍처를 확인하고 클라이언트 설정 폴더의 읽기·쓰기 권한을 유지하세요.

다운로드로 이동

DESKTOP · V2RAYN

macOS

설치 패키지는 Apple Silicon과 Intel 프로세서용으로 나뉩니다. 시스템 정보에서 칩 이름을 확인한 뒤 알맞은 다운로드 항목으로 이동하세요. 처음 실행하면 시스템 안내에 따라 네트워크 구성 권한을 허용해야 합니다. 구독 가져오기와 활성 서버 선택 과정은 다른 데스크톱 플랫폼과 동일합니다.

다운로드로 이동

MOBILE · V2RAYNG / V2FLYNG

Android

v2rayNG는 Xray 커널을 사용해 일반적인 프로토콜과 라우팅 설정에 적합하며, v2flyNG는 V2Fly 커널을 사용하는 대안입니다. 최근 출시된 대부분의 기기는 arm64 패키지를 사용할 수 있고, 아키텍처를 확인하기 어려울 때는 범용 패키지를 선택하세요. 연결 시 시스템에 네트워크 연결 권한 요청이 표시됩니다.

다운로드로 이동

DESKTOP · V2RAYN

Linux

v2rayN은 주요 배포판의 패키지 관리 체계에 맞는 설치 패키지를 제공합니다. Debian·Ubuntu 계열은 보통 deb, Fedora·RHEL 계열은 보통 rpm을 선택합니다. x64와 arm64도 프로세서 아키텍처에 따라 구분해야 합니다. 설치 후 데스크톱 메뉴에서 실행한 다음 구독과 프록시 모드를 설정하세요.

다운로드로 이동

LINK INSPECTION

연결 경로 점검표

구성 출처부터 출구 연결 확인까지 각 구간을 순서대로 점검합니다. 왼쪽에서 현재 단계를 선택하면 오른쪽에 해당 단계에서 해결할 문제, 설정 위치와 확인할 매개변수가 표시됩니다.

SOURCE / UPDATE

구독 가져오기: 서버 목록을 클라이언트에서 관리하기

구독 주소는 클라이언트가 생성하는 값이 아니라 설정 제공자가 전달하는 서버 정보 묶음입니다. 올바른 그룹에 주소를 추가한 뒤 업데이트하면 클라이언트가 프로토콜, 주소, 포트, 전송 및 보안 매개변수를 해석해 선택 가능한 서버 목록을 만듭니다. 업데이트 후에는 먼저 그룹 이름과 노드 수가 바뀌었는지 확인한 다음 활성 서버를 선택하세요. 목록이 비어 있다면 프록시 모드를 반복해서 바꾸기보다 주소가 완전한지, 그룹을 올바르게 선택했는지, 업데이트 로그에 문제가 없는지 확인해야 합니다.

여러 구독을 함께 사용할 때는 출처별로 그룹을 만들고 알아보기 쉬운 메모를 추가하는 것이 좋습니다. 그룹별 업데이트·필터링·정렬이 가능해 같은 이름의 서버가 한 목록에 섞이는 일을 줄일 수 있습니다. 구독 내용이 바뀌어도 사용자가 직접 만든 로컬 설정이 자동으로 대체되지는 않으므로 수동 항목과 원격 항목을 분리해 관리하세요.

source: subscription · action: update · result: server list

QUICK START

설치부터 검증까지 3단계

처음 설정할 때는 과정을 단순하게 유지하세요. 올바른 설치 패키지를 선택하고, 사용할 수 있는 설정을 가져온 뒤, 시스템 프록시로 기본 연결을 한 번 확인합니다. 기본 경로가 확인된 후 TUN과 복잡한 라우팅을 설정하세요.

  1. 01

    플랫폼과 아키텍처에 맞는 클라이언트 선택

    Windows, macOS와 Linux에서는 v2rayN을 사용하고, Android에서는 v2rayNG 또는 v2flyNG를 선택할 수 있습니다. 다운로드 전에 프로세서 아키텍처와 설치 패키지 형식을 확인하세요. 데스크톱에서는 현재 계정에 설정 폴더 쓰기 권한이 있고 클라이언트가 로컬 수신 포트를 만들 수 있는지도 확인해야 합니다. 설치가 끝나면 방화벽, DNS와 라우팅을 동시에 변경하지 말고 먼저 정상적으로 한 번 실행해 기본 화면이 표시되는지 확인하세요.

  2. 02

    구독 추가 및 활성 서버 선택

    구독 관리에서 전체 주소를 입력하고 출처를 쉽게 알아볼 수 있는 그룹 이름을 지정한 다음 업데이트를 실행하세요. 서버 목록이 나타나면 항목 하나를 선택해 활성 서버로 설정합니다. 이때 프로토콜, 주소, 포트와 전송 필드가 정상적으로 해석되었는지 확인해야 합니다. 구독 주소는 설정을 전달하고 클라이언트는 이를 읽어 실행합니다. 업데이트에 실패했다면 커널을 사용할 수 없다고 단정하지 말고 먼저 구독 작업 로그를 확인하세요.

  3. 03

    시스템 프록시 활성화 후 단계별 검증

    먼저 커널을 시작하고 시스템 프록시를 활성화한 다음, 시스템 프록시 설정을 따르는 브라우저에서 테스트 요청을 보내세요. 접속할 수 없다면 로컬 포트, 시스템 프록시, DNS, 라우팅 규칙, 원격 연결 순서로 확인합니다. 기본 모드 검증에 성공한 뒤 앱 적용 범위에 따라 TUN을 활성화할지 결정하세요. 이렇게 하면 가상 네트워크 어댑터 문제와 서버 설정 문제를 분리해 서로의 영향을 줄일 수 있습니다.

전체 가이드 보기 →

OPEN ECOSYSTEM

Project V, V2Fly와 Xray의 관계

클라이언트, 커널과 설정 출처는 서로 다른 세 계층의 구성 요소입니다. 각자의 경계를 이해해야 업데이트, 호환성 및 장애가 어느 계층에서 발생했는지 정확히 판단할 수 있습니다.

Project V는 프로토콜과 도구 생태계의 출발점입니다

Project V는 프록시 프로토콜, 전송 방식, 라우팅 규칙과 로컬 인바운드를 중심으로 한 도구 생태계를 형성했습니다. 그래픽 클라이언트는 프로토콜 자체가 아닙니다. 구독, 서버 목록, 시스템 프록시, 라우팅과 로그를 조작 가능한 화면으로 정리한 뒤 생성된 설정을 커널에 전달해 실행합니다. 화면에서 서버를 선택하거나 모드를 전환할 때 실제로는 클라이언트가 설정을 다시 구성하고 커널 프로세스를 제어하는 것입니다.

이 구분은 문제 분석 방식에 직접 영향을 줍니다. 구독 업데이트 실패는 대개 설정 출처 또는 클라이언트의 네트워크 요청 문제입니다. 커널이 시작 직후 종료된다면 설정 필드, 포트 또는 실행 환경과 관련된 경우가 많습니다. 특정 대상만 접속되지 않는다면 DNS, 라우팅 매칭, 전송 매개변수 또는 원격 상태일 가능성이 큽니다. 모든 현상을 ‘클라이언트가 고장 났다’고 부르면 실제 문제가 끊긴 지점을 찾기 어렵습니다.

V2Fly와 Xray는 같은 기술 계보에 속한 서로 다른 커널 계열입니다

V2Fly는 Project V 생태계의 핵심 구현과 설정 체계를 이어가고, Xray는 기존 개념과의 호환성을 유지하면서 일부 프로토콜, 전송 방식과 하위 기능을 확장했습니다. 두 커널 모두 인바운드, 아웃바운드, 라우팅, DNS와 정책 등의 구조로 설정을 구성하지만, 지원하는 필드와 동작은 구현에 따라 달라질 수 있습니다. 설정을 가져올 때 클라이언트는 구독 내용을 현재 커널이 인식할 수 있는 형식으로 변환해야 합니다.

v2rayN은 데스크톱 플랫폼에서 관련 커널과 설정 과정을 관리할 수 있고, v2rayNG는 주로 Xray 커널을 사용하며, v2flyNG는 V2Fly 커널에 대응합니다. 클라이언트를 선택할 때 그래픽 인터페이스와 커널을 하나로 생각할 필요는 없습니다. 인터페이스는 조작 방식을 결정하고, 커널은 설정 실행과 프로토콜 처리를 담당하며, 구독은 서버 매개변수를 제공합니다. 세 계층이 호환되어야 연결이 정상적으로 성립합니다.

오픈 소스 라이선스와 커뮤니티 유지보수로 확인 가능한 업데이트 이력

세 클라이언트 모두 오픈 소스 방식으로 유지보수되며, 기능 변경, 설정 형식 조정과 문제 수정은 유지관리자와 커뮤니티가 계속 진행합니다. 오픈 소스의 실제 의미는 추상적인 보안 문구가 아니라 구현과 변경 사항을 기술 커뮤니티가 검토하고 논의하며 재현할 수 있다는 데 있습니다. 새 빌드를 설치한 뒤에도 변경 사항을 읽고 설정 폴더, 커널 선택, 권한 요구 사항과 시스템 프록시 동작이 달라졌는지 확인하세요.

클라이언트 업데이트와 구독 업데이트는 같은 작업이 아닙니다. 클라이언트 업데이트는 프로그램 자체와 지원 기능을 바꾸고, 구독 업데이트는 서버 설정만 새로 고칩니다. 프로토콜 필드를 인식하지 못한다면 구독 내용이 잘못된 것인지, 클라이언트의 파싱 기능이 부족한 것인지, 현재 커널이 해당 매개변수를 지원하지 않는 것인지 판단해야 합니다. 계층별로 확인하는 편이 모든 설정을 자주 삭제하는 것보다 훨씬 안정적입니다.

COMMON QUESTIONS

자주 묻는 질문

아래 내용은 처음 사용할 때 가장 혼동하기 쉬운 설정의 경계를 다룹니다. 전체 분류와 문제 해결 과정은 문제 해결 페이지에서 확인할 수 있습니다.

v2rayN과 V2Ray 커널은 같은 프로그램인가요?

아닙니다. v2rayN은 구독, 서버 목록, 프록시 모드, 라우팅과 로그를 관리하는 그래픽 클라이언트이고, 커널은 설정을 해석해 실제 연결을 처리합니다. 클라이언트는 설정과 플랫폼에 따라 적절한 커널을 호출할 수 있으므로, 인터페이스가 정상적으로 시작되었다고 해서 커널까지 반드시 정상 실행 중인 것은 아닙니다. 연결 문제가 발생하면 기본 화면의 상태와 커널 로그를 함께 확인해야 합니다.

구독을 가져온 뒤에도 서버를 직접 선택해야 하는 이유는 무엇인가요?

구독 업데이트는 원격 설정을 서버 목록으로 변환할 뿐, 현재 어떤 항목을 사용해야 할지 대신 판단하지는 않습니다. 업데이트가 끝나면 올바른 그룹에서 활성 서버를 선택한 뒤 커널을 시작해야 합니다. 자동 선택 정책을 제공하는 클라이언트라도 먼저 수동 연결을 한 번 검증해 설정이 정상적으로 실행되는지 확인하는 것이 좋습니다.

시스템 프록시와 TUN 모드 중 무엇을 먼저 사용해야 하나요?

처음 설정할 때는 시스템 프록시부터 사용하는 것이 좋습니다. 적용 범위와 장애 경계를 더 쉽게 확인할 수 있기 때문입니다. 브라우저 같은 일반 앱의 연결을 확인한 뒤 명령줄 도구, 게임 또는 다른 앱의 필요에 따라 TUN을 활성화하세요. TUN은 가상 네트워크 인터페이스, 라우팅과 DNS를 사용하므로 문제가 발생하면 권한과 네트워크 인터페이스 충돌을 점검해야 합니다.

클라이언트에는 실행 중이라고 표시되지만 웹페이지가 열리지 않을 때 먼저 무엇을 확인해야 하나요?

먼저 활성 서버를 선택했는지 확인한 다음 시스템 프록시가 켜져 있는지, 로컬 수신 포트가 존재하는지, 브라우저에 별도 프록시가 설정되어 있지 않은지 확인하세요. 이어서 DNS, 라우팅 적용 규칙과 원격 연결 로그를 살펴봅니다. 연결 경로에 따라 하나씩 확인하면 요청이 클라이언트에 들어오지 않은 경우, 잘못된 출구가 선택된 경우와 원격 연결에 실패한 경우를 구분할 수 있습니다.

클라이언트 다운로드