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

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

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 선택하세요. 구독 가져오기와 라우팅 설정부터 시작해 메뉴를 따라 연결을 설정하면 됩니다.

  • 구독 그룹
  • 사용자 지정 라우팅
  • Xray · V2Fly
운영체제별 선택

CLIENT SETTINGS

구독·라우팅·트래픽 처리

서버 설정, 라우팅 규칙, 시스템 프록시의 역할을 먼저 구분하세요. 각각 연결 대상, 요청이 나갈 경로, 클라이언트에 트래픽을 전달할 앱을 결정합니다. 아래 화면은 설정 항목의 예시이며 실제 메뉴는 클라이언트 업데이트에 따라 달라질 수 있습니다.

출처별 구독 관리

v2rayN의 「구독 그룹 → 구독 그룹 설정」에서 새 그룹을 만들고 알아보기 쉬운 메모와 구독 주소를 입력한 뒤 저장하고 업데이트하세요. 그룹을 사용하면 출처별 서버 목록을 따로 관리해 업데이트할 때 혼동을 줄일 수 있습니다. 처음 연결을 설정하는 단계라 사용 가능한 프록시가 없다면 먼저 「구독 업데이트(프록시 사용 안 함)」을 시도하세요. 이미 사용할 수 있는 프록시가 있고 구독 주소 접속에 프록시가 필요한 경우에만 프록시를 통한 업데이트를 선택합니다. 공유 링크는 보통 단일 서버 정보를 담고, 구독 주소는 여러 설정을 가져오는 데 사용하므로 각각 알맞은 가져오기 메뉴에 입력해야 합니다. 업데이트한 뒤 목록에 항목이 표시되는지 확인하고 서버를 선택해 연결을 테스트하세요.

PLATFORM SELECTOR

운영체제에 맞는 클라이언트 선택

설치 파일을 고를 때는 먼저 운영체제와 프로세서 아키텍처를 확인하고, 그다음 설치 패키지 형식을 살펴보세요. 데스크톱에서는 v2rayN, Android에서는 우선 v2rayNG를 확인하세요. V2Fly 코어와의 호환성이 필요한 경우 v2flyNG를 고려할 수 있습니다. 다운로드 페이지에서 플랫폼별 파일과 설치 요건을 확인할 수 있습니다.

Windows

v2rayN · 데스크톱 / WPF

처음 설치한다면 크로스 플랫폼 인터페이스를 사용하는 데스크톱 버전부터 살펴보세요. 기존 창 형태의 레이아웃에 익숙하다면 WPF 버전을 선택할 수도 있습니다. 어느 인터페이스를 사용하든 서버 설정이 올바르게 구성되어야 하며, 화면 모양만으로 프로토콜 지원 여부를 판단할 수는 없습니다. 설치 전에 시스템의 「설정 → 시스템 → 정보」에서 시스템 종류를 확인하고 다운로드 페이지에서 맞는 아키텍처를 선택하세요.

실행 후 사용 가능한 설정 하나를 가져오고 서버를 선택한 다음 시스템 프록시와 라우팅 모드를 설정하세요. 일반 브라우저에서 접속이 정상적으로 되는지 확인한 뒤 Tun 사용을 검토하면 됩니다. Tun을 켤 때 권한 부족 메시지가 표시되면 서버 포트를 계속 바꾸지 말고 안내에 따라 필요한 권한으로 다시 실행하세요. 설치 폴더를 변경하기 전에는 설정을 백업하세요. 폴더를 정리하는 과정에서 구독 그룹과 사용자 지정 라우팅이 삭제될 수 있습니다.

다운로드 페이지로 이동 →

macOS

v2rayN · 칩에 맞는 버전 선택

Apple 메뉴에서 「이 Mac에 관하여」를 열어 칩 정보를 확인하세요. Apple 칩이 표시되면 Apple Silicon 설치 파일을, Intel 프로세서가 표시되면 Intel 설치 파일을 선택합니다. 아키텍처가 맞지 않으면 실행되지 않거나 별도의 호환 환경이 필요할 수 있습니다. 설치한 뒤 클라이언트를 실행해 인터페이스와 로그 창이 정상적으로 열리는지 확인하고 구독을 가져오세요.

프로그램은 실행되지만 브라우저에서 프록시를 사용하지 않는다면 현재 네트워크 서비스의 프록시 설정을 확인한 다음 브라우저가 별도의 프록시 확장 기능을 사용하는지 살펴보세요. 무선 및 유선 네트워크에 서로 다른 시스템 설정이 적용될 수 있습니다. 보안 경고가 나타나면 다운로드 출처와 경고 내용을 먼저 확인한 뒤 운영체제가 안내하는 승인 절차를 따르세요. 시스템 보호를 해제하는 것을 일반적인 설치 방법으로 삼지 마세요.

다운로드 페이지로 이동 →

Android

v2rayNG 우선 · v2flyNG 대안

대부분의 최신 Android 휴대전화에는 arm64 패키지가 적합합니다. 기기 아키텍처를 모르거나 설치 중 호환되지 않는 패키지라는 메시지가 표시되면 범용 버전을 확인하세요. Xray 코어를 사용하는 v2rayNG를 우선 고려하고, V2Fly 코어 호환성이 필요한 경우 v2flyNG를 검토하면 됩니다. 두 앱의 그룹, 앱 설정, 연결 상태는 각각 별도로 저장되므로 다른 클라이언트를 설치한 뒤에는 설정을 다시 확인해야 합니다.

처음 연결할 때 시스템 VPN 권한 요청이 표시됩니다. 권한을 허용해야 클라이언트가 해당 인터페이스를 통해 트래픽을 처리할 수 있습니다. 다른 VPN 앱이 실행 중이라면 먼저 연결을 끊고 테스트하세요. 화면이 켜져 있을 때는 연결되지만 잠금 후 끊긴다면 배터리 최적화, 백그라운드 활동 제한, 절전 설정을 확인하세요. 앱별 트래픽 분할에서 특정 앱이 제외될 수도 있으므로 브라우저가 작동한다고 해서 모든 앱의 트래픽이 같은 경로를 사용하는 것은 아닙니다.

다운로드 페이지로 이동 →

Linux

v2rayN · deb / rpm

먼저 배포판에서 사용하는 패키지 형식을 확인하세요. Debian이나 Ubuntu 계열은 보통 deb, Fedora 계열은 보통 rpm을 선택합니다. 그런 다음 x64와 arm64 중 맞는 아키텍처를 고르세요. 패키지 형식과 프로세서 아키텍처를 혼동하지 마세요. GUI 클라이언트를 실행하려면 적합한 데스크톱 환경이 필요합니다. 최소 구성 시스템이나 원격 터미널만 있는 환경에서는 GUI를 실행할 수 있는지 먼저 확인하세요.

데스크톱 환경마다 시스템 프록시를 구현하는 방식이 다릅니다. 자동 프록시를 설정한 뒤 앱이 데스크톱 프록시 설정을 읽는지 확인하세요. 터미널 프로그램은 자체 프록시를 별도로 설정해야 할 수도 있습니다. Tun은 가상 인터페이스와 권한이 필요하므로 사용 중인 배포판과 클라이언트의 요구사항에 맞게 설정하세요. 코어가 시작되지 않으면 먼저 로그에서 포트 충돌, 리소스 경로 또는 권한 오류를 확인하세요. 실행 환경 문제를 구독 오류로 오해하지 않도록 주의하세요.

다운로드 페이지로 이동 →

클라이언트를 다운로드하면 로컬에서 사용할 도구만 준비됩니다. 연결하려면 유효한 서버 설정이나 구독 주소가 필요하며, 설치 파일 자체에는 사용할 수 있는 서버가 포함되어 있지 않습니다. 구독 주소에 접속 자격 정보가 포함될 수 있으므로 화면을 캡처하거나 도움을 요청하거나 로그를 공유하기 전에 주소와 식별 정보를 가리세요.

전체 클라이언트 보기 →

PROJECT V / CORE / CLIENT

오픈소스 생태계와 코어의 관계

클라이언트와 코어의 역할을 이해하면 설정을 옮길 때 잘못 판단하는 일을 줄일 수 있습니다. 인터페이스는 설정을 관리하고 코어는 네트워크 연결을 처리합니다. 구독 서비스는 설정을 제공하며 라우팅 규칙은 요청이 향할 곳을 정합니다. 어느 단계에서 문제가 발생했는지에 따라 확인할 위치도 달라집니다.

Project VV2Fly / XrayGUI 클라이언트

Project V와 V2Fly

Project V는 네트워크 프록시 도구를 중심으로 형성된 오픈소스 프로젝트 생태계이며 V2Ray는 그 안에서 널리 쓰이는 핵심 명칭입니다. V2Fly는 관련 커뮤니티의 개발 흐름을 이어받아 V2Ray 코어와 관련 기능을 유지 관리합니다. 일상적으로 말하는 「V2Ray 클라이언트」는 독립 실행형 코어 프로그램이 아니라 GUI 관리 도구를 가리키는 경우가 많습니다. 둘을 구분해야 기능을 인터페이스 메뉴에서 설정하는지, 하위 코어의 지원 여부에 따라 달라지는지 판단할 수 있습니다.

코어는 일반적으로 인바운드 수신, 아웃바운드 연결, 라우팅 규칙 매칭, DNS 처리 등을 담당합니다. GUI 클라이언트는 이러한 옵션을 서버 편집 화면, 구독 그룹, 설정 메뉴로 구성합니다. 사용자가 인터페이스에서 설정을 저장하면 클라이언트가 코어에 필요한 설정을 생성하거나 조정한 뒤 서비스를 시작합니다. 따라서 가져오기에 성공했다는 사실만으로 링크를 인터페이스가 인식했을 뿐, 원격 설정이 올바르거나 코어가 정상적으로 실행되었다고 볼 수는 없습니다.

Xray 호환성 범위

Xray는 V2Ray 생태계에서 발전했으며 프로토콜과 전송 기능을 자체적으로 확장해 왔습니다. VLESS, VMess, Trojan은 서로 다른 프로토콜을 가리키고 REALITY는 연결 보안 방식과 관련된 기술입니다. 이 명칭을 모두 서로 바꿔 쓸 수 있는 노드 유형으로 이해해서는 안 됩니다. 서버에 설정된 조합에 맞춰 프로토콜, 전송 방식, 보안 매개변수와 해당 코어의 기능을 확인해야 합니다.

설정을 옮길 때는 주소, 포트, 사용자 식별자, 전송 방식, TLS 또는 REALITY 매개변수를 하나씩 확인하세요. 일부 필드는 특정 코어에서만 사용할 수 있고 클라이언트 인터페이스에 모든 옵션이 표시되지 않을 수도 있습니다. 「알 수 없는 필드」나 지원되지 않는 보안 유형이 나타나면 먼저 호환성을 확인하세요. SNI를 무작정 지우거나 인증서 검증을 끄고 전송 경로를 바꾸면 명확했던 문제를 오히려 찾기 어려워질 수 있습니다.

세 클라이언트의 오픈소스 역할

v2rayN은 서버, 구독, 시스템 프록시, 라우팅을 한 창에서 관리할 수 있는 데스크톱 GUI 클라이언트입니다. v2rayNG는 Android용으로 시스템 VPN 인터페이스를 통해 앱 트래픽을 처리하며 Xray 코어를 사용합니다. v2flyNG는 V2Fly 코어를 선호하는 Android 환경을 위한 대안입니다. 세 프로젝트의 기능 업데이트 주기는 서로 다르므로 한 클라이언트의 메뉴 경로를 다른 클라이언트에 그대로 적용하지 마세요.

세 클라이언트는 GPL-3.0 라이선스로 공개되어 있으며 코어와 함께 제공되는 구성 요소는 각각의 라이선스도 확인해야 합니다. 오픈소스 라이선스는 코드의 사용, 수정, 재배포 조건을 규정할 뿐 서버 서비스 약관을 대신하거나 연결 품질을 결정하지 않습니다. 클라이언트는 무료로 사용할 수 있지만 서버, 구독 또는 기타 네트워크 서비스의 요금은 해당 서비스 제공자의 정책을 따릅니다.

업데이트 전에 정상 작동 기준을 보존하세요

클라이언트를 업데이트하면 인터페이스, 설정 생성 방식, 코어 기능이 함께 달라질 수 있습니다. 업그레이드 전에 구독 그룹, 사용자 지정 라우팅, 주요 매개변수를 보관하고 현재 정상 연결되는 설정을 기록해 두세요. 업데이트한 뒤에는 같은 서버, 같은 라우팅, 같은 네트워크로 먼저 테스트한 다음 새 기능을 하나씩 활성화하세요. 이렇게 하면 모든 조건을 한꺼번에 바꾸지 않고도 업데이트로 인한 변화와 서버 자체의 변동을 구분할 수 있습니다.

업데이트 안내를 읽을 때는 버전 숫자만 비교하지 말고 설정 마이그레이션, 시스템 요구사항, 코어 변경 사항, 알려진 문제를 먼저 확인하세요. 이상이 발생하면 반복되는 후속 오류보다 로그에 처음 나타난 오류가 더 중요한 단서일 수 있습니다. 도움을 요청하기 전에 운영체제, 클라이언트 종류, 작업 순서, 이미 확인한 사항을 정리하되 구독 주소, 사용자 식별자, 기타 연결 자격 정보는 삭제하세요. 자세한 절차는 문제 해결 가이드를 참고하세요.

TECHNICAL NOTES

라우팅 설정과 로그 문제 해결

기술 노트에서 설정 항목별 방법을 확인하세요. 연결은 정상인데 트래픽 경로를 바꾸려면 라우팅 규칙을 살펴보고, 서비스 시작 실패가 표시되면 로그와 설정 오류부터 확인하세요. 시작 오류를 해결하기 전에는 라우팅 구성을 반복해서 바꾸지 마세요.