v2rayN · v2rayNG · v2flyNG

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

구독 가져오기부터 라우팅 분할까지 실제 설정을 확인하고, 코어 로그로 문제를 진단하세요.

VMessVLESSTrojanREALITY
Xray 코어V2Fly 코어
설정 안내 / SETTINGS

구독·프록시·라우팅 설정

먼저 연결이 어느 단계에서 끊기는지 확인한 뒤 해당 설정을 변경하세요. 시스템 프록시는 트래픽을 클라이언트로 전달하고, 라우팅은 트래픽을 분배하며, 코어는 실제 처리를 담당합니다. 서로 대체할 수 없습니다.

v2rayN / 구독 그룹
구독 그룹 설정수정 →
구독 업데이트(프록시 사용 안 함)직접 연결
구독 업데이트(프록시 사용)프록시 연결
클립보드에서 URL 일괄 가져오기공유 링크

구독 주소는 서버 설정을 가져오는 데 사용하고, 공유 링크는 보통 단일 연결 정보를 담습니다. 먼저 v2rayN의 구독 그룹 설정에 주소를 저장한 뒤 구독을 업데이트하세요. 현재 프록시 연결이 되지 않는다면 ‘구독 업데이트(프록시 사용 안 함)’부터 시도할 수 있습니다. 주소에 프록시 연결이 필요한 경우에는 사용 가능한 연결을 확보한 뒤 프록시를 통해 업데이트하세요. 공유 링크를 하나씩 붙여 넣는 것보다 구독 그룹을 이용하면 이후 갱신이 편리하지만, 만료된 주소가 자동으로 복구되지는 않습니다. v2rayNG에서는 사이드 메뉴에서 구독 그룹 설정을 찾을 수 있으며, 메뉴 이름은 설치된 버전에 따라 다를 수 있습니다.

클라이언트 선택 / CLIENTS

운영체제에 맞는 다운로드 선택

데스크톱에서는 v2rayN을, 모바일에서는 주로 v2rayNG를 사용하고 V2Fly 설정과의 호환성이 필요할 때 v2flyNG를 고려하세요. 설치 파일은 프로세서 아키텍처와 시스템 패키지 형식에도 맞아야 합니다. 한 기기에 모든 버전을 설치할 필요는 없습니다.

Windows

v2rayN

일반 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 일반 버전은 크로스 플랫폼 인터페이스를 사용하며, WPF 버전은 익숙한 기존 데스크톱 구성을 유지합니다. 기존 사용 방식이 있다면 원하는 인터페이스를 선택한 뒤 시스템 요구사항에 맞는 설치 조건을 확인하세요.

처음 실행하면 코어 로그에서 정상적으로 시작했는지 확인한 다음 시스템 프록시 자동 설정을 켜세요. 브라우저에 수동 프록시나 확장 프로그램 규칙을 설정해 둔 경우 이전 포트로 요청이 전달되지 않도록 함께 확인해야 합니다.

macOS

v2rayN

칩에 따라 Apple Silicon 또는 Intel용 설치 파일을 선택하세요. ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인할 수 있습니다. 두 아키텍처는 서로 다른 설치 파일을 사용하므로 기기의 외형이나 구입 시기만으로 판단하면 안 됩니다.

설치 후 앱 실행 상태와 네트워크 프록시 설정을 각각 확인하세요. Wi-Fi, 유선 네트워크 또는 다른 네트워크 서비스를 전환했다면 현재 서비스의 프록시 항목을 다시 확인하고, 시스템 설정이 실행 중인 클라이언트를 가리키는지 살펴보세요.

Android

v2rayNG / v2flyNG

우선 Xray 기반 v2rayNG를 사용하고, V2Fly 생태계 설정과의 호환성이 필요하면 대안으로 v2flyNG를 확인하세요. 최신 기기는 대부분 arm64를 선택하면 됩니다. 아키텍처를 알 수 없다면 범용 설치 패키지 안내를 확인하세요.

연결을 시작하려면 시스템 VPN 권한을 허용해야 합니다. 백그라운드에서 연결이 끊기면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 일부 앱만 접속할 수 없다면 구독을 삭제하고 다시 가져오기 전에 앱별 프록시 설정부터 점검하세요.

Linux

v2rayN

배포판에 맞춰 deb 또는 rpm을 선택하고, x64와 arm64 아키텍처를 구분하세요. 패키지 형식은 설치 방법을, 프로세서 아키텍처는 프로그램 실행 가능 여부를 결정합니다. 두 항목을 각각 확인해야 하며 배포판 이름을 아키텍처로 혼동하면 안 됩니다.

데스크톱 환경과 앱마다 시스템 프록시 지원이 다릅니다. 브라우저는 접속되는데 다른 프로그램이 계속 직접 연결한다면 해당 프로그램의 프록시 설정을 먼저 확인하세요. 그래픽 인터페이스에 연결됨으로 표시되어도 모든 프로세스가 같은 네트워크 경로를 사용한다는 뜻은 아닙니다.

첫 연결 / QUICK START

가져오기, 연결, 확인

클라이언트 자체는 원격 연결 서비스를 제공하지 않습니다. 시작하기 전에 사용할 수 있는 구독 주소나 공유 링크를 준비하고 출처와 사용 권한을 확인하세요. 설정 없이 프로그램만 설치해서는 이후 웹 접속을 할 수 없습니다.

  1. 구독을 가져오고 서버 선택

    데스크톱에서는 구독 그룹 설정에 주소를 저장하고 구독을 한 번 업데이트한 뒤 사용할 서버를 선택하세요. 단일 공유 링크는 클립보드에서 가져오기 기능을 사용할 수 있습니다. 모바일에서도 구독 주소와 단일 링크를 구분해 올바른 항목에 입력해야 합니다. 가져온 뒤 프로토콜 유형과 서버 정보가 모두 있는지 확인하세요. 목록이 비어 있다면 업데이트 로그, 주소 만료 여부, 현재 네트워크에서 구독 내용을 가져올 수 있는지부터 점검하세요.

  2. 연결 방식 및 라우팅 모드 설정

    v2rayN을 일상적으로 사용할 때는 먼저 ‘시스템 프록시 자동 설정’을 선택하고, 분할 라우팅은 ‘중국 본토 우회(Whitelist)’로 시작할 수 있습니다. v2rayNG는 연결을 시작하고 시스템 VPN 권한을 허용해야 합니다. 시스템 프록시, VPN 연결, 라우팅 규칙은 서로 다른 단계입니다. 앞의 두 설정은 앱 요청을 클라이언트로 전달하고, 라우팅은 요청이 들어온 뒤의 출구를 결정합니다. 먼저 기본 규칙으로 연결을 확인한 후 사용자 지정 예외를 추가하면 여러 옵션을 동시에 바꾸는 것보다 문제를 찾기 쉽습니다.

  3. 접속 결과와 로그를 함께 확인

    직접 연결되어야 하는 웹사이트와 프록시를 사용해야 하는 웹사이트에 각각 접속해 로그에 요청 및 아웃바운드 선택이 기록되는지 확인하세요. 코어가 시작되었다는 것은 설정을 불러왔다는 뜻일 뿐이며, 브라우저에 페이지가 표시되어도 모든 트래픽이 예상대로 분할 라우팅된다고 단정할 수는 없습니다. 요청 로그가 없다면 앱의 프록시 설정과 로그 수준을 먼저 확인하세요. 연결 오류가 있다면 원격 주소, 프로토콜 매개변수, DNS를 점검하세요. 한 번에 하나씩만 수정하고 같은 테스트를 반복해 변경 전후를 비교할 수 있도록 기록을 남기세요.

오픈소스 생태계 / PROJECT & CORE

Project V, V2Fly, Xray

프로젝트 생태계, 프록시 코어, 그래픽 클라이언트를 구분해서 살펴보세요. 이름이 비슷하다고 설정을 그대로 서로 바꿔 쓸 수 있는 것은 아니며, 같은 프로토콜을 지원하더라도 모든 확장 필드가 일치하는 것은 아닙니다.

생태계의 시작

Project V / V2Ray

코어 계열

V2Fly · Xray

그래픽 클라이언트

v2rayN · v2rayNG · v2flyNG

생태계의 역사와 역할 구분

Project V는 네트워크 프록시 도구를 중심으로 형성된 오픈소스 생태계이며, V2Ray는 그중 주요 프로젝트입니다. 프로젝트가 발전하면서 V2Fly 커뮤니티가 관련 코어를 이어서 관리했고, Xray는 별도의 코어 발전 경로를 형성했습니다. 그래픽 클라이언트는 이러한 기능을 바탕으로 구독 관리, 서버 선택, 설정 인터페이스를 제공합니다. 사용자가 보는 버튼은 클라이언트가 구성하지만, 실제 연결과 라우팅은 보통 백그라운드 코어가 처리합니다. 따라서 인터페이스 업데이트와 프로토콜 기능의 변화가 항상 일치하는 것은 아닙니다.

코어 계열과 프로토콜 지원

VMess, VLESS, Trojan은 연결 설정에서 자주 쓰이는 프로토콜 이름이며, REALITY는 보안 계층과 관련된 방식이지 독립된 클라이언트가 아닙니다. 실제 설정에는 전송 방식, 서버 이름 및 기타 핸드셰이크 매개변수가 포함될 수 있습니다. 설정이 호환되지 않는다면 클라이언트가 해당 필드를 생성할 수 있는지, 선택한 코어가 필드를 읽을 수 있는지, 원격 서버 설정이 일치하는지 확인하세요. 구독을 정상적으로 가져왔다는 이유만으로 특정 프로토콜 조합을 사용할 수 있다고 단정할 수는 없습니다.

클라이언트 3종의 오픈소스 라이선스

v2rayN, v2rayNG, v2flyNG는 모두 오픈소스 프로젝트로 제공되며 무료로 사용할 수 있습니다. v2rayN은 데스크톱 환경에서 구독과 라우팅을 통합 관리하는 데 적합합니다. v2rayNG는 주로 Xray 생태계 설정에 사용되며, v2flyNG는 V2Fly 기반 모바일 클라이언트입니다. 오픈소스란 해당 라이선스 조건에 따라 코드를 살펴보고 사용할 수 있다는 뜻이며, 모든 구성 요소가 같은 라이선스를 따른다는 의미는 아닙니다. V2Fly와 Xray 코어는 보통 MPL 2.0을 사용하지만, 클라이언트와 의존성은 각각 해당 프로젝트의 라이선스를 따라야 합니다.

업데이트 방식과 설정 보존

클라이언트, 코어, 구독 내용, geosite·geoip 데이터는 각각 다른 주기로 업데이트됩니다. 구독 업데이트는 서버 설정을 새로 가져오는 기능이지 프로그램을 업그레이드하는 기능이 아닙니다. 규칙 데이터를 업데이트해도 코어가 교체되는 것은 아닙니다. 문제가 발생하면 어떤 항목을 업데이트해야 하는지 먼저 파악하고 현재 설정과 사용자 지정 규칙을 기록하세요. 업그레이드 후에는 기존 접속 환경을 다시 테스트하고, 특히 라우팅 순서, 수신 포트, 프로토콜 호환성을 확인하세요. 모든 구성 요소를 한꺼번에 업데이트한 뒤 원인을 추측하는 것보다 변경 사항을 추적할 수 있도록 설정을 기록해 두는 편이 효과적입니다.

설정 노트 / FIELD NOTES

라우팅 규칙과 코어 로그 가이드

기본 연결이 정상이라면 규칙 예외와 복잡한 설정을 살펴보세요. 아래 글에서는 매칭 구문을 익히고, 시작 로그를 읽은 뒤, 국내외 웹사이트 분할 라우팅 사례를 구성합니다. 특정 문제가 있다면 해당 주제로 바로 이동해도 됩니다. 설정 전체를 처음부터 수정할 필요는 없습니다.

문제 해결

v2rayN 코어 시작 실패 해결: 코어 로그로 config 설정 오류 진단

시작 실패 원인을 포트 충돌, 설정 구문 오류, 알 수 없는 필드, 규칙 데이터 누락으로 나눠 살펴봅니다. 로그에서 처음 나타나는 핵심 오류를 확인한 뒤 해당 설정을 점검해 후속 오류를 별개의 문제로 오인하지 않도록 하세요.

Linux 펭귄 그래픽: Font Awesome Tux, CC BY 4.0 라이선스에 따라 사용.

v2rayN 다운로드