데스크톱 및 Android 클라이언트 가이드

V2Ray 가이드 v2rayN 다운로드

v2rayN 다운로드 가이드 보기

구독 가져오기부터 시작해 기기에 맞는 클라이언트를 선택하고, 라우팅을 설정하세요. 연결 문제가 생기면 문제 해결 가이드를 확인하세요.

  • 완전 무료
  • 오픈 소스
  • Xray · V2Fly
GUI 설정 · 구독 관리 코어 계열 · Xray / V2Fly 아웃바운드 선택 · direct / proxy / block

v2rayN 설정의 주요 기능 5가지

클라이언트는 설정을 관리하고 코어는 연결을 처리합니다. 먼저 구독, 노드, 프록시 모드를 구분한 뒤 라우팅과 규칙 세트를 설정하세요. 아래 목차는 자주 사용하는 설정을 정리한 것으로, 항목을 선택해 주요 작업을 확인할 수 있습니다.

구독 그룹
  메모: 일상적인 사용
  주소: 구독 제공업체에서 확인
  작업: 현재 구독 업데이트
노드 목록
  작업: 활성 서버로 설정

구독 가져오기 및 노드 새로고침

구독은 노드 정보를 업데이트하는 수단이지 연결을 켜는 기능이 아닙니다. v2rayN의 구독 그룹에 주소와 메모를 입력해 저장한 뒤 그룹을 업데이트하고, 노드 목록에서 활성 서버를 선택하세요. v2rayNG도 먼저 구독을 추가한 다음 업데이트해야 합니다. QR 코드는 노드 하나를 임시로 전달할 때 편리하며, 장기적으로 관리하려면 구독 그룹을 사용하는 편이 좋습니다. 업데이트에 실패하면 주소와 구독 유효 기간, 업데이트 시의 네트워크 경로부터 확인하세요. 같은 그룹을 반복해서 만들지 마세요. 화면을 공유하기 전에는 전체 구독 주소를 가리세요. 주소에 접속 자격 증명이 포함될 수 있습니다.

구독을 업데이트한 뒤에도 활성 노드를 직접 선택해야 합니다.

처음 설정할 때는 작동하는 연결 경로 하나부터 확보하세요

클라이언트를 처음 실행할 때 구독, 라우팅, DNS, TUN을 한꺼번에 변경할 필요는 없습니다. 먼저 정상 작동이 확인된 노드 하나를 가져와 활성 서버로 지정하고, 시스템 프록시로 브라우저 연결을 테스트하세요. 이 경로가 작동하는 것을 확인한 뒤 라우팅 규칙을 조정하면 됩니다. 설정을 변경할 때마다 어떤 변경이 영향을 줬는지 확인할 수 있어, 여러 옵션을 동시에 바꿔 원인을 찾기 어려워지는 일을 막을 수 있습니다.

테스트할 때는 로컬 프록시 연결, 원격 서버 연결, 목적지 사이트를 각각 구분해야 합니다. 노드 테스트에 성공해도 테스트 대상 하나가 응답했다는 뜻일 뿐, 모든 앱이 프록시를 사용한다는 보장은 없습니다. 브라우저에서 사이트가 열려도 규칙의 모든 도메인이 의도한 아웃바운드로 연결된다는 뜻은 아닙니다. 필요하면 로그에서 목적지, 아웃바운드 태그, 오류 유형을 확인하고, 반복해서 재설치하기보다 증상을 기록하세요. 전체 절차는 v2rayN 사용 가이드에서, 증상별 확인 방법은 문제 해결 가이드에서 볼 수 있습니다.

기기에 맞는 클라이언트 선택

데스크톱에서는 v2rayN, Android에서는 우선 v2rayNG를 확인하세요. V2Fly 코어가 필요한 설정이라면 v2flyNG를 고려할 수 있습니다. 설치 파일은 운영체제와 프로세서 아키텍처에 맞게 선택해야 합니다. 다운로드 페이지에서 해당 파일과 시스템 요구사항을 확인하세요.

Windowsv2rayN · 데스크톱 버전 / WPF 버전 다운로드 페이지 → macOSv2rayN · Apple Silicon / Intel 다운로드 페이지 → Androidv2rayNG 권장 · v2flyNG 대안 다운로드 페이지 → Linuxv2rayN · deb / rpm 다운로드 페이지 →

데스크톱 인터페이스와 설치 파일 선택

Windows용 v2rayN은 최신 크로스 플랫폼 데스크톱 인터페이스와 클래식 WPF 인터페이스를 제공합니다. 두 버전은 인터페이스 선호도에 따라 선택하면 되며, 하나를 정해 기본 설정을 마친 뒤 연결 문제를 해결하기 위해 계속 전환할 필요는 없습니다. 설치 전에 시스템 정보에서 프로세서 종류를 확인하세요. 다른 아키텍처용 설치 파일을 범용 파일처럼 사용해서는 안 됩니다. 처음 실행했을 때 기본 창이 나타나지 않으면 프록시 설정으로 넘어가기 전에 시스템 알림, 실행 환경, 클라이언트 로그를 확인하세요.

macOS에서는 먼저 시스템의 '이 Mac에 관하여'에서 칩 정보를 확인하세요. Apple Silicon과 Intel은 다운로드 경로가 다릅니다. 설치한 뒤 클라이언트가 정상적으로 시작되는지 확인하고, 시스템 안내에 따라 필요한 권한을 설정하세요. 권한 부여 실패, 코어 시작 실패, 노드 연결 실패를 하나의 문제로 취급하지 마세요. 시스템 프록시를 전환할 때 브라우저 자체의 프록시 설정도 확인해야 합니다. 브라우저 설정이 시스템 설정을 덮어쓰면 실제 연결 경로와 클라이언트에 표시된 모드가 달라질 수 있습니다.

모바일 연결 및 배포판별 차이

Android에서는 v2rayNG를 우선 권장합니다. 최신 기기는 대부분 arm64 패키지를 사용하며, 프로세서 아키텍처를 확인하기 어렵다면 범용 버전 다운로드 경로를 확인하세요. 처음 연결할 때 시스템 VPN 권한 요청이 표시되며, 권한을 허용해야 클라이언트가 앱 트래픽을 처리할 수 있습니다. 화면을 잠근 뒤 연결이 끊기면 배터리 최적화와 백그라운드 제한을 확인하세요. 특정 앱에서만 문제가 생기면 앱별 라우팅 설정을 점검합니다. v2flyNG는 V2Fly 코어 계열이 필요한 설정에 적합하며, 한 번의 테스트에서 두 클라이언트가 VPN 연결을 동시에 사용하지 않도록 하세요.

Linux용 v2rayN 설치 파일은 배포판의 패키지 관리 방식에 따라 구분됩니다. deb 기반과 rpm 기반 시스템에 맞는 파일을 선택한 뒤 x64 또는 arm64 아키텍처를 확인하세요. 설치를 마쳐도 현재 데스크톱 환경의 모든 앱이 시스템 프록시를 사용하는 것은 아닙니다. 프록시 설정을 지원하는 브라우저로 먼저 테스트해 로컬 연결이 작동하는지 확인한 뒤 TUN 사용 여부를 결정하세요. 가상 네트워크 인터페이스와 라우팅 권한이 필요한 경우 인터페이스의 안내에 따라 설정하고, 권한 문제를 해결하기 위해 재설치부터 하지 마세요.

모든 클라이언트 보기 →

Project V, V2Fly, Xray 코어의 관계

클라이언트와 코어의 역할을 먼저 이해한 뒤 설정 호환성을 확인하세요. 인터페이스 이름, 노드 프로토콜, 코어 프로젝트는 서로 다른 개념이며 서로 바꿔 쓸 수 없습니다.

Project V

프록시 도구 생태계와 설정 방식

  • inbound
  • routing
  • outbound

V2Fly / V2Ray

V2Ray의 기술 계보를 이어 프록시 프로토콜, 전송, 라우팅 기능을 제공합니다. v2flyNG는 이 코어 계열을 사용하는 Android GUI 클라이언트입니다.

Xray

관련 기술 생태계에서 발전해 자체적인 프로토콜과 전송 기능을 갖추고 있습니다. v2rayNG는 주로 Xray 코어를 사용하며, 매개변수 지원 여부는 실제 코어를 기준으로 확인해야 합니다.

v2rayN

데스크톱 GUI 클라이언트는 노드, 구독, 라우팅 설정을 관리하고 호환되는 코어를 실행해 연결을 처리합니다. 특정 프록시 프로토콜의 이름이 아닙니다.

생태계의 계보가 같아도 기능이 완전히 동일한 것은 아닙니다

Project V는 이러한 도구를 이해하는 데 중요한 배경입니다. V2Ray의 설정 방식은 트래픽 처리를 인바운드, 라우팅, 아웃바운드로 나눕니다. 인바운드는 로컬 앱의 연결을 받고, 라우팅은 조건에 따라 처리 방식을 선택하며, 아웃바운드는 직접 연결, 프록시, 차단을 수행합니다. V2Fly 커뮤니티는 관련 프로젝트의 유지보수를 이어가고, Xray는 연관 기술을 바탕으로 자체 구현을 발전시켜 왔습니다. 이러한 관계를 알면 설정이 비슷한 이유를 이해할 수 있지만, 어떤 설정이든 두 코어 계열 간에 그대로 호환된다는 뜻은 아닙니다.

VMess, VLESS, Trojan, Shadowsocks는 프로토콜 이름이며 TLS와 REALITY 등은 연결 보안이나 핸드셰이크 방식과 관련이 있습니다. 라우팅 규칙은 또 다른 트래픽 선택 계층입니다. 구독 매개변수를 확인할 때는 각 계층을 나눠 살펴보세요. 클라이언트에 노드가 표시되더라도 현재 코어가 해당 노드의 모든 전송 및 보안 옵션을 지원한다는 뜻은 아닙니다. 호환성 오류가 발생하면 먼저 요구 매개변수를 확인하고 적합한 클라이언트와 코어를 선택하세요. 보안 검사를 끄는 방식으로 문제를 우회하지 마세요.

오픈 소스 라이선스와 GUI 클라이언트의 역할

v2rayN, v2rayNG, v2flyNG는 모두 소스 코드가 공개된 GUI 클라이언트 프로젝트입니다. v2rayN과 v2rayNG는 GPL-3.0 라이선스를, v2flyNG도 GPL-3.0 라이선스를 적용합니다. V2Fly와 Xray 코어 프로젝트는 MPL-2.0 라이선스를 사용합니다. 오픈 소스 라이선스는 코드 사용, 수정, 재배포 조건을 규정하며 노드 서비스의 품질을 보장하지 않습니다. 클라이언트를 무료로 사용할 수 있다고 해서 구독 제공업체의 서비스까지 반드시 무료인 것은 아닙니다. 유지보수 주체와 이용 조건을 각각 확인하세요.

GUI 클라이언트는 구독 새로고침, 활성 노드 선택, 규칙 프리셋, 로그 확인을 명확한 메뉴로 제공한다는 장점이 있습니다. 데스크톱용 v2rayN은 여러 설정 그룹을 꾸준히 관리하는 데 적합합니다. Android용 v2rayNG는 시스템 VPN 인터페이스로 모바일 앱 트래픽을 처리하며, v2flyNG는 V2Fly 계열을 위한 대안입니다. 모든 클라이언트를 설치할 필요는 없습니다. 현재 설정이 노드 매개변수를 지원하고 기기 사용 방식에 맞으며 로그로 문제를 파악할 수 있으면 충분합니다.

업데이트 전 설정을 기록하고, 업데이트 후 단계별로 확인하세요

클라이언트 업데이트, 코어 업데이트, 구독 업데이트, 규칙 데이터 업데이트는 각각 다른 문제를 해결합니다. 클라이언트 업데이트는 인터페이스나 설정 생성 방식을 바꿀 수 있고, 코어 업데이트는 프로토콜 지원에 영향을 줄 수 있습니다. 구독 업데이트는 원격 노드 정보를 새로 가져오며, 규칙 데이터 업데이트는 도메인이나 주소 분류를 변경합니다. 이러한 작업을 나눠 실행하면 문제가 생겼을 때 원인을 좁히기 쉽습니다. 사용 중인 설정이 있다면 필요한 로컬 백업을 먼저 보관하세요. 백업에는 민감한 매개변수가 들어 있을 수 있으므로 공개 게시판에 올리지 마세요.

업데이트 후에는 먼저 코어가 시작되는지 확인하고, 정상 작동이 확인된 목적지 하나로 테스트한 다음 자주 쓰는 앱과 라우팅 시나리오를 점검하세요. 인증서 오류가 나면 시스템 시간, 서버 이름, 보안 매개변수를 확인하고, 도메인 조회 오류가 나면 DNS 경로를 확인하세요. 특정 앱만 실패한다면 시스템 프록시를 사용하는 앱인지 점검해야 합니다. 이 사이트의 중국어 문서는 작업별·증상별로 구성되어 있습니다. 클라이언트 업데이트에 따라 버튼 이름은 달라질 수 있으므로, 스크린샷의 위치를 외우기보다 연결 경로를 이해하는 편이 유용합니다.

구독 동기화 및 연결 문제 해결 글

실제 설정 문제를 다룹니다. PC와 휴대폰에서 노드를 함께 사용하는 방법, REALITY와 Vision의 조합, TLS 핸드셰이크 오류를 확인할 지점을 살펴보세요.

전체 글 보기 →

설정 전 알아둘 핵심 용어

구독을 업데이트했는데도 브라우저가 연결되지 않는 이유는 무엇인가요?

구독 업데이트는 노드 정보를 가져오는 작업입니다. 활성 노드를 선택하고 코어가 실행되는지 확인한 뒤 브라우저가 올바른 프록시 연결을 사용하도록 설정해야 합니다. 먼저 클라이언트에서 현재 서버를 확인하고, 시스템 프록시 모드를 점검한 다음 로그의 오류를 살펴보세요. 이름 조회에 실패했다면 DNS를 먼저 확인하고, 연결 시간 초과라면 원격 매개변수와 네트워크 경로를 확인하세요. 구독, 노드, 아웃바운드의 차이는 용어 빠른 안내에서 볼 수 있습니다.

시스템 프록시의 '전역'과 라우팅의 '전역'은 같은 뜻인가요?

꼭 그렇지는 않습니다. 시스템 프록시 설정은 앱이 로컬 클라이언트에 연결을 전달할지 결정하고, 라우팅 모드는 코어에 들어온 트래픽이 어떤 아웃바운드를 사용할지 결정합니다. 앱이 시스템 프록시를 사용하더라도 라우팅 규칙에 따라 일부 목적지는 직접 연결될 수 있습니다. 반대로 프록시 라우팅을 선택해도 시스템 프록시를 무시하는 앱이 자동으로 연결되는 것은 아닙니다. 문제를 확인할 때는 먼저 연결 진입점을, 그다음 아웃바운드를 확인하세요. 관련 용어는 시스템 프록시와 라우팅 개념에서 확인할 수 있습니다.

PC와 휴대폰에서 같은 구독을 사용할 수 있나요?

여러 기기에서 사용할 수 있는지는 구독 제공업체의 이용 조건에 달려 있으며, 클라이언트가 제한을 변경해 주지는 않습니다. 매개변수가 호환된다면 두 기기에 각각 가져올 수 있지만, 프록시 연결 방식과 앱별 라우팅은 기기마다 설정해야 합니다. QR 코드 하나를 공유해도 보통 노드 정보만 전달되며 데스크톱 라우팅 설정까지 옮겨지지는 않습니다. 공개된 곳에서 도움을 요청할 때는 오류 유형과 필요한 매개변수만 민감 정보를 가려 공유하세요. 구독과 노드의 관계는 구독 및 노드 용어 설명에서 확인할 수 있습니다.

geosite와 geoip는 각각 무엇을 매칭하나요?

geosite는 주로 도메인 분류를 참조하고, geoip는 주로 IP 주소 분류를 참조합니다. 도메인 규칙은 사이트별 분류에, 주소 규칙은 로컬 네트워크나 알려진 주소 범위 처리에 적합합니다. 두 규칙은 서로 바꿔 쓸 수 없으며, 도메인 조회 방식에 따라 주소 규칙이 적용되는 시점도 달라질 수 있습니다. 먼저 사용 중인 분류가 데이터에 있는지 확인한 다음 규칙 순서와 아웃바운드 태그를 점검하세요. 규칙 불일치를 노드 오류로 오해하는 일을 줄일 수 있습니다. 자세한 내용은 라우팅 및 분할 규칙 빠른 안내에서 확인하세요.

v2rayN 다운로드