본문으로 건너뛰기
v2rayN · v2rayNG · v2flyNG

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

v2rayN 다운로드 사용법 보기

오픈소스 클라이언트를 선택하고 단계에 따라 구독을 가져온 다음, 사용 중인 앱에 맞는 프록시 모드를 설정하세요.

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
GUI 클라이언트 v2rayN / v2rayNG / v2flyNG 코어 계열 Xray · V2Fly 설정 순서 구독 → 노드 → 프록시 → 라우팅

구독 및 프록시 설정

먼저 설정을 가져온 다음 트래픽 처리 방식을 선택하세요

네 가지 설정 단계를 구분해서 살펴보세요. 구독은 연결 매개변수를 제공하고, 코어는 프로토콜을 처리하며, 프록시 모드는 어떤 앱의 트래픽을 클라이언트로 보낼지 결정합니다. 라우팅 규칙은 트래픽이 나갈 경로를 정합니다. 어느 한 항목을 켰다고 나머지 설정까지 완료된 것은 아닙니다.

서비스 제공업체가 안내한 구독 주소를 구독 그룹에 추가하고 업데이트하면 해당 주소의 노드 설정을 한곳에서 가져올 수 있습니다. 단일 공유 링크와의 차이는 이후 관리 방식입니다. 구독은 내용을 다시 가져올 수 있지만, 단일 링크는 보통 한 번 가져오는 용도입니다. 처음 사용할 때는 그룹이 활성화되어 있는지, 업데이트가 성공했는지 확인한 뒤 사용할 노드를 선택하세요. 클라이언트는 설정을 읽어오는 도구이며, 이용 가능한 서비스를 자동으로 제공하지는 않습니다. 구독 주소에 접근 자격 정보가 포함될 수 있으므로 신뢰할 수 있는 기기에 보관하고 스크린샷이나 공개 로그에 노출하지 마세요.

기기별 선택

4개 플랫폼의 클라이언트

먼저 운영체제를 확인한 뒤 프로세서 아키텍처와 설치 패키지를 확인하세요. 같은 클라이언트라도 운영체제에 따라 설치 방법, 권한 안내, 트래픽 처리 설정 위치가 다를 수 있습니다. 다운로드하기 전에 네트워크 설정을 변경할 필요는 없습니다.

Windows

v2rayN은 사용 방식에 따라 데스크톱 버전과 클래식 WPF 버전을 선택할 수 있습니다. 데스크톱 버전은 크로스 플랫폼 UI를 사용하고, WPF 버전은 기존 Windows UI를 유지합니다. 메뉴 위치가 다를 수 있으므로 예전 가이드에 나온 버튼 이름만으로 설정을 찾지 마세요.

처음 실행하면 먼저 구독을 가져오고 노드를 선택한 다음 시스템 프록시를 설정하세요. 일반 브라우저 연결이 정상인지 확인한 뒤 다른 앱에 TUN을 사용할지 검토하면 됩니다. 시스템에서 실행 구성 요소가 없다는 메시지가 표시되면 안내에 따라 설치하세요. 시스템 보호 기능을 꺼서 문제를 우회하지 마세요. 자세한 단계는 전체 플랫폼 가이드를 참고하세요.

다운로드 Windows 클라이언트

macOS

v2rayN을 선택하고 시스템의 ‘이 Mac에 관하여’에서 칩을 확인하세요. Apple Silicon은 arm64, Intel은 x64를 선택합니다. 아키텍처는 구독 프로토콜과 관계가 없습니다. 올바른 설치 패키지를 선택한 뒤 기존 설정을 가져오세요.

설치 후 응용 프로그램 폴더에서 실행하고 시스템 보안 및 네트워크 권한 안내를 주의 깊게 확인하세요. 시스템 프록시를 사용할 때는 현재 네트워크 서비스의 프록시 설정이 적용됐는지 확인하세요. 네트워크를 바꾸거나 클라이언트를 종료한 뒤 웹 페이지에 접속할 수 없다면 프록시가 종료된 로컬 서비스 주소를 가리키고 있지 않은지도 점검하세요.

다운로드 macOS 클라이언트

Android

Xray 코어를 사용하는 v2rayNG를 우선 고려하고, v2fly 코어가 필요할 때 v2flyNG를 선택하세요. 대부분의 최신 휴대전화는 arm64에 적합합니다. 아키텍처를 모르겠다면 기기 정보를 확인하거나 다운로드 페이지의 범용 패키지 안내를 참고하세요.

구독을 가져온 뒤 목록을 업데이트하고 노드를 선택해 연결을 시작한 다음 시스템 VPN 권한을 확인하세요. 화면을 잠근 뒤 연결이 끊기면 백그라운드 실행과 배터리 제한을 점검하세요. VPN 연결을 사용하는 다른 앱이 설치되어 있다면 어느 앱이 네트워크를 처리할지 먼저 정해 설정이 서로 덮어쓰지 않도록 하세요.

다운로드 Android 클라이언트

Linux

v2rayN을 선택하고 배포판의 패키지 형식에 맞춰 deb 또는 rpm을 고른 다음 x64와 arm64를 구분하세요. 데스크톱 환경, 시스템 프록시 구현, 권한 관리 방식은 배포판마다 다릅니다. 설치에 성공했다고 모든 앱이 자동으로 프록시를 사용하는 것은 아닙니다.

먼저 GUI에서 구독을 설정한 뒤 데스크톱 프록시 설정을 따르는 앱으로 연결을 확인하세요. 브라우저는 연결되지만 다른 앱이 계속 직접 연결된다면 해당 앱에서 프록시를 별도로 설정해야 하는지 확인하세요. TUN이 필요하다면 현재 빌드의 의존성과 권한 요건을 확인하세요. 처음부터 전체 네트워크 설정을 바꿀 필요는 없습니다.

다운로드 Linux 클라이언트

전체 클라이언트 보기 →

빠른 시작

설치, 가져오기, 연결 확인

사용할 수 있는 구독 또는 단일 노드 공유 링크를 준비하세요. 클라이언트는 설정 및 연결 도구입니다. 설치만으로 노드가 생기거나 서비스 제공업체의 계정, 이용 기간, 트래픽 한도가 대체되지는 않습니다. 다음 세 단계는 최소한의 설정으로 연결을 확인하는 방법입니다. 전체 메뉴 조작은 사용법 가이드를 참고하세요.

  1. 설치 패키지를 선택해 실행하기

    다운로드 페이지에서 플랫폼과 프로세서 아키텍처에 맞는 패키지를 선택하고 설치한 다음 메인 화면을 여세요. 먼저 클라이언트가 정상적으로 실행되는지 확인한 뒤 네트워크 처리 권한을 설정하세요. 권한을 부여하는 위치는 운영체제마다 다르므로 다른 플랫폼의 설정 경로를 그대로 따르지 마세요.

    실행에 실패하면 시스템 안내를 기록하고 설치 패키지 형식, 실행 의존성, 설치 폴더 권한을 확인하세요. 업데이트하기 전에 구독 그룹과 필요한 설정을 보관해 문제를 해결하는 과정에서 기존 설정을 잃지 않도록 하세요.

  2. 구독 추가 및 노드 업데이트

    구독 관리에서 새 그룹을 만들고 전체 주소를 붙여 넣은 뒤 저장하고 업데이트하세요. 업데이트 결과와 노드 목록을 확인하고 사용할 노드를 선택하세요. 그룹만 추가하고 업데이트하지 않으면 목록이 비어 있을 수 있습니다.

    vmess:// 또는 vless:// 같은 공유 링크를 받았다면 구독 주소 입력란이 아니라 해당 링크를 클립보드에서 가져오는 기능을 사용하세요. QR 코드와 클립보드는 입력 방법일 뿐입니다. 가져오기 전에 출처를 확인하세요.

  3. 프록시 설정 및 접속 확인

    데스크톱에서는 먼저 시스템 프록시와 기본 라우팅 구성을 사용하세요. Android에서는 연결을 시작하고 VPN 권한을 확인합니다. 실제로 접속하려는 페이지를 열고 클라이언트 로그를 확인해 요청이 프록시를 통과했는지 판단하세요. 지연 시간 테스트에 숫자가 표시된다고 설정이 완료된 것은 아닙니다.

    브라우저 연결이 확인되면 다른 앱, 로컬 네트워크 기기, 자주 사용하는 서비스를 테스트하세요. 한 번에 설정 하나만 바꾸고 언제든 되돌릴 수 있도록 기준 설정을 보관하세요. 클라이언트를 종료하기 전에 필요에 따라 시스템 프록시를 해제해야 합니다. 프록시 설정이 남아 있으면 이후 연결에 문제가 생길 수 있습니다.

전체 사용법 보기 →

오픈소스 생태계 이해하기

Project V, 코어, GUI 클라이언트 구분하기

이름이 비슷해도 역할은 다릅니다. 설정을 관리하는 구성 요소와 연결을 처리하는 구성 요소를 구분한 뒤 클라이언트를 업데이트할지, 매개변수를 조정할지, 구독 서비스 제공업체에 노드 상태를 문의할지 판단하세요.

구성 요소별 역할

GUI에서 설정 관리
코어에서 연결 처리

  1. Project V프로젝트의 시작과 기술적 배경 이해
  2. V2Fly / Xray코어 계열과 프로토콜 기능 확인
  3. v2rayN / v2rayNG / v2flyNGGUI와 기기에 맞는 클라이언트 선택
  4. 구독 및 노드 설정실제 연결에 필요한 매개변수 제공

역할을 설명하기 위한 그림이며 프로젝트 간에 단일 운영 주체가 있다는 뜻도, 클라이언트가 구독 서비스를 제공한다는 뜻도 아닙니다.

생태계 구성 살펴보기 →

Project V로 기술적 배경 이해하기

Project V는 V2Ray의 기술적 배경을 이해하는 출발점입니다. 관련 도구는 네트워크 연결, 프록시 프로토콜, 트래픽 라우팅을 중심으로 구성됩니다. 일상적으로 ‘V2Ray’는 코어 프로그램을 가리키기도 하고 전체 사용 생태계를 뜻하기도 해 튜토리얼을 찾을 때 GUI 클라이언트, 프로토콜 이름, 서비스 설정을 혼동하기 쉽습니다. 사용자 입장에서 실용적인 구분은 다음과 같습니다. 클라이언트는 설정을 다루기 쉬운 화면으로 구성하고, 코어는 설정을 읽어 연결을 만들며, 노드는 원격 연결에 필요한 주소와 매개변수를 제공합니다. 이 중 하나를 다운로드했다고 나머지 구성 요소까지 준비된 것은 아닙니다.

설정 요구 사항에 맞는 코어 계열 선택

V2Fly 커뮤니티는 V2Ray 관련 구현을 지속적으로 관리하며, Xray는 관련 기술을 바탕으로 발전한 포크입니다. 두 프로젝트는 일부 역사와 설정 개념을 공유하지만 기능과 구현 세부 사항은 각자 발전해 왔습니다. 프로토콜 이름이 같아도 전송 방식, 암호화, 확장 매개변수를 모두 서로 바꿔 쓸 수 있는 것은 아닙니다. 예를 들어 공유 링크를 GUI에서 인식하더라도 선택한 코어가 링크에 포함된 옵션을 지원하지 않으면 연결이 시작되지 않을 수 있습니다. 문제를 확인할 때는 프로토콜, 전송 방식, 코어 오류 메시지를 함께 기록하세요. ‘VLESS 지원’ 같은 단일 표시만으로 전체 호환성을 판단하지 마세요.

기기에 맞는 세 가지 GUI 클라이언트 선택

v2rayN은 데스크톱용으로 구독 관리, 노드 선택, 프록시 설정, 라우팅 설정 기능을 제공해 컴퓨터에서 연결 구성을 관리하기 편리합니다. v2rayNG는 Android용이며 Xray 코어를 사용하고 시스템 VPN 인터페이스를 통해 트래픽을 처리합니다. v2flyNG도 Android용으로, v2fly 코어가 필요한 설정에 사용할 수 있습니다. 세 프로젝트 모두 오픈소스지만 UI와 기능 위치, 유지 관리 주기는 서로 다릅니다. 가이드의 메뉴 이름은 현재 사용 중인 클라이언트에 맞춰 확인하세요. 한 프로젝트의 모든 기능을 다른 프로젝트에도 그대로 적용할 수는 없습니다.

오픈소스 라이선스와 서비스 약관 구분하기

오픈소스란 해당 라이선스의 조건에 따라 소스 코드가 공개되어 있다는 뜻입니다. 사용, 수정, 재배포 시에는 각 프로젝트의 구체적인 라이선스 조건을 따라야 합니다. V2Fly의 V2Ray 코어는 주로 MIT 라이선스를 사용하고, Xray-core는 MPL 2.0을 사용합니다. 클라이언트와 포함된 의존성은 서로 다른 라이선스를 적용할 수 있으므로 각 프로젝트에 포함된 라이선스 문서를 확인하세요. 라이선스는 코드를 사용하는 방법을 설명할 뿐, 특정 구독 서비스의 품질이나 노드 가용성, 데이터 처리 방식을 보장하지 않습니다. 서드파티 설정을 사용하기 전에 서비스 출처와 적용 약관을 확인하고, 코드 공개 여부와 소프트웨어 작동, 서비스 신뢰성을 각각 판단하세요.

클라이언트, 코어, 구독을 따로 관리하기

클라이언트 업데이트는 보통 UI, 구독 파싱, 설정 관리에 영향을 줍니다. 코어 업데이트는 프로토콜 지원, 연결 동작, 오류 메시지를 바꿀 수 있습니다. 구독 업데이트는 서비스 제공업체가 배포한 노드 매개변수를 다시 가져오는 작업입니다. 이 세 가지 업데이트는 서로 대체할 수 없습니다. 특정 노드가 갑자기 작동하지 않는다면 먼저 구독 변경 여부와 서비스 유효성을 확인하고 소프트웨어 호환성을 살펴보세요. 소프트웨어를 업데이트하기 전에는 설정을 백업하고 변경 사항을 확인한 뒤, 업데이트 후에는 기존에 연결되던 환경에서 다시 테스트하세요. GUI에 별도의 코어 관리 메뉴가 있다면 설치된 구성 요소만 보지 말고 현재 실제로 선택된 코어를 확인하세요.

재현 가능한 점검으로 연결 기준 만들기

간단한 검증 순서를 정해 두세요. 확인된 설정 하나를 유지한 채 브라우저를 먼저 테스트하고, 이어서 트래픽을 처리해야 하는 다른 앱을 테스트한 다음 직접 연결 사이트, 로컬 네트워크, DNS 동작을 확인합니다. 지연 시간 테스트, 다운로드 속도 측정, 실제 접속은 서로 다른 구간을 측정하므로 한 가지 결과만으로 전체 설정을 검증할 수 없습니다. 문제를 문의할 때는 오류 유형과 재현 절차를 기록하고 구독 주소, 사용자 식별 정보, 연결 자격 증명은 가리세요. 불필요한 정보 노출을 줄이는 동시에 문제가 가져오기, 코어 실행, 트래픽 처리, 원격 연결 중 어느 단계에서 발생했는지 파악하는 데 도움이 됩니다.

전체 플랫폼 설치 및 설정 가이드 보기 →

설정 및 진단 글

라우팅, 속도 측정, 코어 선택 더 알아보기

첫 연결을 마친 뒤 구체적인 사용 환경에 맞춰 설정을 살펴보세요. 문제에 따라 순서대로 읽으면 됩니다. 측정값이 이해되지 않으면 먼저 테스트 방법을 확인하고, 사이트가 잘못된 경로로 연결되면 규칙 순서를 살펴보세요. 클라이언트나 코어를 바꾸려면 생태계 구성부터 확인하세요.

전체 글 보기 →