Project V · 오픈소스 클라이언트 가이드

V2Ray 오픈소스 가이드v2rayN 클라이언트 다운로드

v2rayN 다운로드 사용법 보기

v2rayN 데스크톱 설정부터 v2rayNG Android 가져오기까지, 기기에 맞는 클라이언트를 선택하고 구독·라우팅·커널을 차근차근 설정하세요.

  • Xray / V2Fly
  • VLESS + REALITY
  • 완전 무료 · 오픈소스

CONFIGURATION

구독·라우팅·커널 설정

GUI 클라이언트는 설정을 다루기 쉬운 화면으로 정리해 줍니다. 먼저 유효한 설정을 가져온 뒤 트래픽을 어떤 아웃바운드로 보낼지 확인하세요. 호환성 문제가 있을 때만 마지막으로 커널 변경을 고려하면 됩니다. 아래는 자주 쓰는 네 가지 기능의 설정 방법이며, 화면은 설정 항목의 예시입니다. 실제 메뉴는 사용하는 클라이언트에 따라 다를 수 있습니다.

구독 그룹 설정

메모사용자 지정 그룹 이름
주소(url)설정 제공자가 안내한 전체 구독 주소 입력
업데이트 사용

IMPORT

구독 가져오기

구독 주소와 개별 공유 링크는 입력 방식이 다릅니다. v2rayN에서는 먼저 구독 그룹을 만들고 전체 주소를 입력한 다음 구독을 업데이트하세요. v2rayNG에서는 메뉴에서 구독을 추가하고 목록을 업데이트하면 됩니다. 서버 정보를 하나씩 입력하는 것보다 구독을 이용하면 설정을 한곳에서 관리하기 편리합니다. 가져오기 전에 클라이언트가 해당 형식을 지원하는지 확인하고, 업데이트 후 프로토콜과 전송 설정도 살펴보세요. 목록이 비어 있다면 업데이트 결과를 다시 확인해야 합니다. 주소가 저장됐다고 해서 가져오기가 끝난 것은 아닙니다. 구독 주소에 접근 정보가 포함될 수 있으므로 화면을 공유하기 전에 가리세요.

구독 가져오기 단계 보기 →

CLIENT SHELF

플랫폼별 V2Ray 클라이언트 선택

데스크톱에서는 v2rayN, Android에서는 v2rayNG부터 살펴보세요. 설치 파일은 프로세서 아키텍처와 패키지 형식에 맞춰야 하므로 파일 확장자만 보고 판단하면 안 됩니다. 아래 버튼을 누르면 플랫폼별 다운로드 페이지로 이동합니다. 설치 파일과 시스템 요구 사항은 해당 페이지에서 확인할 수 있습니다.

Windows · v2rayN

구독 관리, 라우팅 규칙 편집, 커널 로그 확인을 컴퓨터에서 하려는 경우에 적합합니다. 다운로드 페이지에서 데스크톱 버전과 클래식 WPF 버전을 받을 수 있습니다. 데스크톱 버전은 크로스 플랫폼 GUI를 사용하고, WPF 버전은 익숙한 데스크톱 작업 화면을 유지합니다. 처음 설치할 때는 시스템 요구 사항과 프로세서 아키텍처를 확인하세요. 기존 설정이 있다면 먼저 백업한 뒤 다른 인터페이스로 바꿀지 결정하는 것이 좋습니다.

실행한 뒤 설정을 가져오고 시스템 프록시를 설정하세요. 브라우저가 시스템 프록시를 사용하는지와 클라이언트에 사용할 수 있는 아웃바운드가 있는지는 별도로 확인해야 합니다. 특정 앱에서만 프록시를 사용하려면 앱에 로컬 프록시 주소를 설정할 수도 있습니다. 처음부터 전체 네트워크 설정을 바꿀 필요는 없습니다.

다운로드 페이지로 이동

macOS · v2rayN

먼저 '이 Mac에 관하여'에서 칩 종류를 확인한 뒤 Apple Silicon 또는 Intel용 설치 파일을 선택하세요. 두 아키텍처의 다운로드 경로가 구분되어 있으므로 기기에 맞는 파일을 우선 선택하면 됩니다. 데스크톱 버전은 구독 관리, 설정 편집, 라우팅 선택을 위한 기본 작업 흐름을 제공합니다. 이전할 때는 정상 작동이 확인된 공유 링크 하나부터 가져오는 것이 좋습니다.

시스템 프록시와 브라우저 자체 설정을 함께 확인하세요. 앱마다 접속 결과가 다르면 해당 앱이 시스템 프록시를 따르는지 먼저 확인한 뒤 클라이언트 로그를 살펴보세요. DNS와 프로토콜 항목을 동시에 바꾸지는 마세요. 처음 실행할 때 권한 안내가 나타나면 앱의 출처와 시스템 설명을 확인해 항목별로 처리하세요.

다운로드 페이지로 이동

Android · v2rayNG / v2flyNG

v2rayNG는 Xray 관련 프로토콜 기능이 필요한 Android 기기에 적합하며, v2flyNG는 V2Fly 커널을 사용하는 대안입니다. 최근 출시된 대부분의 주류 스마트폰에서는 arm64 패키지를 먼저 확인하세요. 아키텍처를 모른다면 다운로드 페이지에서 범용 패키지 안내를 살펴보면 됩니다. 두 클라이언트는 각각 별도로 관리되므로 이름이 비슷하다고 설정까지 완전히 호환된다고 볼 수는 없습니다.

구독을 가져온 뒤 처음 연결할 때는 보통 시스템 VPN 권한을 허용해야 합니다. 백그라운드에서 연결이 자주 끊긴다면 배터리 최적화, 백그라운드 실행, 앱 프록시 범위를 확인하세요. 연결 버튼의 상태는 로컬 서비스가 시작됐다는 뜻일 뿐입니다. 실제 접속은 설정값, 서버 상태, 현재 네트워크 경로에 따라 달라집니다.

다운로드 페이지로 이동

Linux · v2rayN

배포판의 패키지 형식에 따라 deb 또는 rpm을 선택한 뒤 기기가 x64인지 arm64인지 확인하세요. 데스크톱 GUI 환경에서는 v2rayN으로 구독과 라우팅 설정을 관리할 수 있습니다. 패키지가 설치됐다고 해서 시스템 프록시가 모든 프로그램에 자동 적용되는 것은 아닙니다. 데스크톱 환경과 앱이 프록시 설정을 읽는 방식에 따라서도 결과가 달라질 수 있습니다.

먼저 브라우저에서 최소 범위로 연결을 확인한 뒤 다른 앱을 설정하세요. 더 많은 트래픽을 프록시로 보내려면 해당 모드의 권한 요구 사항과 라우팅 영향을 먼저 이해해야 합니다. 되돌릴 수 있도록 설정을 보관하고, 기본 연결이 확인되기 전에는 네트워크 경로를 바꿀 수 있는 기능을 여러 개 동시에 켜지 마세요.

다운로드 페이지로 이동

전체 클라이언트 보기 →

PROJECT V / V2FLY / XRAY

Project V 생태계와 클라이언트 선택

V2Ray는 여러 도구를 통칭하는 이름으로 자주 쓰이지만, GUI 클라이언트와 프록시 커널, 프로토콜은 서로 다른 계층입니다. 세 계층을 나눠 보면 다운로드와 설정을 알맞게 연결하기 쉽습니다. 인터페이스는 설정을 관리하고, 커널은 이를 실행하며, 프로토콜은 통신 방식을 정합니다.

CLIENT → CORE → CONFIGURATION

v2rayNXray / V2Fly 등 커널 설정 관리
v2rayNGAndroid · Xray 커널 기반
v2flyNGAndroid · V2Fly 커널 기반

실제 지원 범위는 클라이언트 배포 패키지, 커널 기능, 가져오기 형식에 따라 달라집니다.

커널을 먼저 확인한 뒤 프로토콜 지원 여부를 판단하세요

설정을 가져올 수 있다는 것은 클라이언트가 내용을 파싱했다는 뜻일 뿐입니다. 연결이 되는지는 커널이 프로토콜·전송·보안 항목을 지원하는지, 서버가 같은 매개변수를 사용하는지에 달려 있습니다. 화면에 특정 옵션이 보인다는 사실만으로 실제 사용 중인 커널을 확인할 수는 없습니다.

클라이언트 비교 보기 →

Project V의 배경: 프록시 커널에서 GUI 도구까지

Project V는 조합해서 사용할 수 있는 프록시 도구를 중심으로 구성되며, V2Ray는 널리 사용되는 핵심 프로젝트입니다. 인바운드, 아웃바운드, 라우팅, DNS 등의 모듈을 통해 네트워크 처리 작업을 나눠 설정할 수 있습니다. 일상적으로 사용하는 v2rayN과 v2rayNG는 커널의 이름만 바꾼 것이 아닙니다. 커널을 바깥에서 관리하는 구독 관리, 매개변수 편집, 모드 전환, 로그 확인 기능을 제공합니다. GUI는 조작을 쉽게 해 주지만, 실제 연결은 여전히 기반 프로그램이 처리합니다.

따라서 안내에서 말하는 '클라이언트 열기'와 '커널 실행'은 서로 다른 단계를 가리킬 수 있습니다. 화면이 정상적으로 표시되더라도 설정 필드가 잘못되면 커널이 종료될 수 있습니다. 반대로 GUI의 시스템 프록시 옵션이 꺼져 있어도 커널이 로컬 포트에서 요청을 받고 있을 수 있습니다. 문제를 해결할 때는 재설치를 반복하기보다 먼저 어느 계층에서 문제가 생겼는지 확인하는 편이 효과적입니다.

V2Fly와 Xray: 같은 계보라도 기능이 모두 호환되는 것은 아닙니다

V2Fly 커뮤니티는 V2Ray 프로젝트를 이어서 관리하고, Xray는 관련 코드 기반에서 자체 구현 방향으로 발전했습니다. 두 프로젝트는 개념과 설정 방식의 상당 부분을 공유하지만 기능은 각자 발전하고 있습니다. REALITY 등의 기능은 Xray의 지원 범위를 기준으로 확인하세요. 기존 V2Fly 설정도 실제 필드를 하나씩 살펴봐야 합니다. 실행 파일만 바꾸면 같은 결과가 나온다고 가정해서는 안 됩니다.

v2rayN은 데스크톱에서 자주 쓰는 설정을 한곳에서 관리할 수 있습니다. v2rayNG는 Android 기기에서 Xray 기반 기능을 사용할 수 있는 인터페이스를 제공하고, v2flyNG는 V2Fly의 동작 방식과 설정을 명확히 필요로 하는 사용자에게 적합합니다. 세 클라이언트는 모두 오픈소스지만 업데이트 주기, 메뉴 구성, 커널 조합은 서로 다릅니다. 클라이언트 이름을 프로토콜 지원 목록처럼 여기기보다 현재 설정에 필요한 기능을 기준으로 선택하세요.

VLESS·VMess·REALITY: 설정 항목을 함께 이해하기

VMess, VLESS, Trojan, Shadowsocks는 프록시 프로토콜 관련 선택지이고, REALITY는 보안 계층 방식으로 VLESS와 함께 쓰이는 경우가 많습니다. 'VLESS + REALITY'를 두 개의 대체 가능한 프로토콜로 이해하면 안 됩니다. 전송 방식, 서버 주소, 포트, 사용자 ID, 보안 계층 매개변수를 함께 맞춰야 합니다. 항목이 빠지거나 잘못 복사되면 핸드셰이크가 실패할 수 있습니다.

프로토콜 이름만으로 속도를 순위 매길 수도 없습니다. 같은 프로토콜이라도 서버, 네트워크 경로, 전송 조합에 따라 사용 경험이 크게 달라질 수 있습니다. 모바일 기기의 배터리 소모는 재연결 빈도, 백그라운드 정책, 실제 트래픽에도 영향을 받습니다. 이미 작동하는 설정이 있다면 기존 조합을 유지하세요. 다른 방식을 비교하려면 기기와 네트워크 조건을 고정하고 항목별로 살펴보세요. 프로토콜 가이드에서 설계 선택과 적용 범위를 더 자세히 확인할 수 있습니다.

오픈소스 라이선스와 커뮤니티 관리: 소프트웨어와 연결 서비스 구분하기

v2rayN·v2rayNG·v2flyNG는 오픈소스로 배포되며, 관련 클라이언트는 보통 GPL 계열 라이선스를 사용합니다. V2Fly와 Xray 코어는 MPL 계열 라이선스를 사용합니다. 구체적인 사용 범위는 각 프로젝트에 포함된 라이선스 전문을 확인하세요. 소스 코드, 릴리스 노트, 문제 제보는 커뮤니티 유지 관리의 일부입니다. 오픈소스라는 사실은 코드의 사용과 배포 규칙을 설명할 뿐, 출처가 불분명한 설정을 바로 가져와도 된다는 뜻은 아닙니다.

클라이언트 자체가 연결 서비스를 제공하는 것은 아닙니다. 소프트웨어를 설치한 뒤에도 사용 권한이 있는 서버 설정이나 구독이 필요합니다. 구독의 서버 정보는 제공자가 관리하며, 연결 가능 여부는 서버와 네트워크 환경의 영향을 받습니다. V2Ray 오픈소스 가이드는 클라이언트 다운로드 경로와 한국어 지식을 정리합니다. 홈페이지에 바로 사용할 수 있는 서버 목록을 게시하지 않으며, 소프트웨어 실행 상태만으로 서비스 사용 가능 여부를 판단하지 않습니다.

업데이트 순서: 클라이언트·커널·구독을 따로 확인하세요

클라이언트 업데이트는 주로 인터페이스, 설정 생성, 통합 기능에 영향을 줍니다. 커널 업데이트는 프로토콜 구현, 기능 지원, 실행 방식과 관련이 있습니다. 구독 업데이트는 보통 서버 항목과 연결 매개변수를 바꿉니다. 이 세 가지는 서로 다른 시점에 업데이트될 수 있습니다. 구독 업데이트에 실패하면 먼저 주소, 응답 내용, 가져오기 형식을 확인하세요. 커널이 실행되지 않으면 로그의 필드 오류나 기능 관련 안내부터 살펴보세요. 모든 로컬 설정을 바로 덮어쓸 필요는 없습니다.

업데이트 전에 구독 그룹, 사용자 지정 라우팅, 기타 로컬 설정을 백업하세요. 업데이트 후에는 정상 작동이 확인된 설정 하나로 기본 접속을 확인한 다음 추가 규칙을 단계적으로 복원하세요. 클라이언트나 커널을 바꿨다면 기존 설정의 지원 범위도 다시 확인해야 합니다. 설치 파일은 다운로드 페이지에서 확인할 수 있으며, 버전 정보는 페이지에 표시된 내용을 기준으로 하세요. 안내 문서의 화면과 다르다는 이유만으로 설치 오류라고 판단하지 마세요.

초기 설정 관련 자주 묻는 질문

구독 업데이트에 성공했는데 왜 접속할 수 없나요?
업데이트 성공은 파싱할 수 있는 내용을 가져왔다는 뜻일 뿐입니다. 사용할 수 있는 설정을 선택하고 커널을 실행한 뒤 앱이 프록시를 사용하는지 확인해야 합니다. 확인 순서는 사용법 안내를 참고하세요.
시스템 프록시와 TUN 모드를 함께 켜야 하나요?
두 기능은 서로 다른 트래픽 처리 방식입니다. 먼저 한 가지 방식으로 기본 접속을 확인한 뒤 앱 사용에 맞춰 조정하세요. 적용 범위는 자주 묻는 질문에서 확인할 수 있습니다.
휴대폰을 바꿀 때 컴퓨터 설정 폴더를 그대로 복사해도 되나요?
호환되는 구독이나 공유 링크를 다시 가져온 뒤 휴대폰의 앱 프록시와 백그라운드 설정을 따로 구성하는 편이 안전합니다. 이전하기 전에 클라이언트 지원 범위를 확인하세요.
테스트가 정상이라면 웹페이지도 반드시 열리나요?
개별 테스트는 일부 연결 경로만 확인합니다. 브라우저 프록시, DNS, 라우팅이 접속에 영향을 줄 수 있으므로 실제 요청과 로그를 함께 살펴보세요. 용어는 네트워크 기초 안내에서 확인할 수 있습니다.

TECHNICAL NOTES

V2Ray 기술 노트

생태계 관계부터 DNS, 커널 실행 로그까지 문제별로 살펴봅니다. 설정을 바꾸기 전에 해당 문서의 전제 조건을 확인하세요. 같은 안내 메시지도 원인이 여러 가지일 수 있습니다. 원래 설정과 작업 과정을 처음부터 끝까지 보관하면 오류 한 줄만 캡처하는 것보다 원인을 찾기 쉽습니다.

전체 글 보기 →