데스크톱·안드로이드 · 설정 가이드

V2Ray 공식 다운로드v2rayN·v2rayNG 클라이언트

오픈소스 클라이언트, 구독 그룹, 사용자 지정 라우팅 설정을 설치부터 라우팅 구성까지 안내합니다.

위 화면은 정적인 UI 예시입니다. 메뉴 이름과 옵션 위치는 클라이언트 배포판에 따라 달라질 수 있으며, 라우팅 태그·포트·네트워크 모드는 현재 기기의 설정을 기준으로 확인하세요.

설정의 다섯 가지 계층

구독·라우팅·네트워크 트래픽 처리

구독은 서버 매개변수를 제공하고, 라우팅은 트래픽의 경로를 결정하며, DNS는 도메인 조회 결과를 제공합니다. TUN은 트래픽이 클라이언트로 들어오는 방식을 바꿉니다. 각 계층을 나눠 확인하면 여러 옵션을 한꺼번에 바꾸는 것보다 문제를 쉽게 찾을 수 있습니다.

v2rayN · 구독 그룹 설정

설정 항목 예시

그룹 이름구독 출처를 기준으로 지정
구독 주소신뢰할 수 있는 출처의 링크 입력
서버 필터필요한 항목만 남기기
구독 업데이트업데이트 결과 확인

구독 주소에는 계정 접근 정보가 포함될 수 있으므로 공개적으로 공유하지 마세요.

구독 그룹은 서버 항목과 구독 출처를 연결합니다. 먼저 구독 그룹 설정에서 출처를 추가한 뒤 업데이트하세요. 서로 다른 출처의 항목이 한 목록에 섞이는 것을 막을 수 있습니다. 그룹 이름은 기기에서 구분하기 위한 용도일 뿐, 원격 권한을 바꾸지는 않습니다. 필터를 적용할 때는 먼저 구독을 정상적으로 가져올 수 있는지 확인한 다음 범위를 좁혀 보세요. 링크를 하나씩 붙여 넣는 것보다 그룹으로 관리하면 지속적인 업데이트가 편리하지만, 업데이트 과정에서 원격에서 삭제된 항목이 반영될 수 있습니다. 직접 수정한 중요 설정은 별도로 저장해 두세요. 안드로이드 클라이언트로 바꿀 때는 그룹과 업데이트 옵션을 다시 확인해야 합니다.

화면 예시는 설정 구조를 설명하기 위한 것이며, 기능이 실제로 활성화된 상태를 뜻하지 않습니다. 변경 전 현재 정상 작동하는 설정을 저장하고, 한 번에 한 계층씩 조정한 뒤 로그로 실제 동작을 확인하세요.

고급 설정 보기 →

클라이언트 및 설치 패키지 선택

운영체제에 맞는 다운로드

데스크톱에서는 v2rayN, 안드로이드에서는 v2rayNG를 우선 고려하고, V2Fly 코어가 필요하면 v2flyNG를 선택할 수 있습니다. 먼저 운영체제와 CPU 아키텍처를 확인한 다음 설치 패키지 형식을 살펴보세요. 각 플랫폼 링크는 다운로드 센터의 해당 분류로 연결되며, 파일과 릴리스 정보는 다운로드 센터에서 관리합니다.

Windows

v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 UI를 사용하고, WPF 버전은 익숙한 클래식 데스크톱 조작 방식을 유지합니다. 두 버전 모두 서버 관리, 구독 업데이트, 라우팅 설정을 중심으로 구성되어 있습니다. 실제 메뉴와 실행 환경 요구 사항은 다운로드 페이지에서 확인하세요. 처음 설치할 때는 운영체제 아키텍처에 맞는 버전을 선택하면 되며, 기본 연결을 위해 두 UI를 모두 설치할 필요는 없습니다.

구독을 가져온 뒤 설정이 완전한 서버 하나를 선택하고 시스템 프록시를 설정하세요. 브라우저는 연결되는데 다른 프로그램이 연결되지 않는다면 해당 프로그램이 시스템 프록시를 사용하는지 확인해야 합니다. 이를 근거로 서버가 작동하지 않는다고 단정할 수는 없습니다. TUN이 필요하다면 정상 작동하는 설정을 먼저 저장한 뒤 관리자 권한과 다른 가상 네트워크 어댑터를 확인하세요. 클라이언트를 종료하기 전에 시스템 프록시가 원래대로 복구되었는지도 확인해야 합니다. 중지된 포트를 가리키는 설정이 남을 수 있습니다.

다운로드 페이지로 이동

macOS

v2rayN은 Apple Silicon과 Intel 칩에 따라 별도의 다운로드 항목을 제공합니다. 시스템의 ‘이 Mac에 관하여’에서 칩 또는 프로세서 이름을 확인한 다음 아키텍처에 맞는 버전을 선택하세요. 컴퓨터 외관이나 구입 연도만으로 판단하지 마세요. 설치한 뒤에는 앱이 실행되고 설정을 저장할 수 있는지 먼저 확인한 다음 구독을 가져오세요. 시스템 보안 알림이 표시되면 내용을 읽고 앱 권한 문제와 네트워크 연결 문제를 구분해야 합니다.

데스크톱과 안드로이드 클라이언트는 메뉴 사용 방식이 다르지만, 서버 주소·포트·전송 방식·TLS 항목은 서버 측 설정과 일치해야 합니다. 시스템 프록시의 영향을 받는 프로그램은 각 프로그램의 네트워크 구현에 따라 다릅니다. 테스트할 때는 먼저 시스템 프록시 설정을 따르는 브라우저를 사용한 뒤 다른 앱을 확인하세요. 네트워크 트래픽 처리 기능을 켰다면 시스템 권한, DNS 동작, 로컬 네트워크 접근도 확인해야 합니다. 메뉴 스위치만 보고 설정이 적용되었다고 판단하지 마세요.

다운로드 페이지로 이동

Android

v2rayNG는 Xray 코어를 사용하며 안드로이드에서 널리 쓰이는 클라이언트입니다. V2Fly 코어가 필요하다면 v2flyNG를 확인하세요. 일반적인 기기는 대개 arm64를 선택하면 되며, 아키텍처를 알 수 없다면 범용 버전 안내를 확인하세요. 이름이 비슷하다고 해서 코어 기능, 프로토콜 항목, 가져오기 방식까지 모두 같은 것은 아닙니다. 선택하기 전에 구독의 프로토콜과 전송 방식 조합을 확인한 다음 클라이언트를 결정하세요.

처음 연결할 때 시스템 VPN 권한을 요청합니다. 이 권한은 로컬 트래픽 인터페이스를 만드는 데 쓰이며 구독 인증과는 무관합니다. 권한을 부여한 뒤에는 현재 서버와 라우팅 모드도 확인하세요. 안드로이드의 배터리 절약 정책과 백그라운드 제한, 다른 VPN 앱이 연결 유지에 영향을 줄 수 있습니다. 앱을 다시 열어야 연결이 복구된다면 먼저 백그라운드 실행 설정을 살펴보세요. 앱별 프록시 설정은 트래픽 처리 범위를 바꿉니다. 문제를 확인할 때는 현재 허용 목록이나 차단 목록이 어떤 의미인지 기록해 두어, 트래픽이 처리되지 않은 앱을 연결 오류로 오해하지 않도록 하세요.

다운로드 페이지로 이동

Linux

v2rayN은 deb와 rpm 형식을 제공합니다. 먼저 배포판의 패키지 시스템에 맞는 형식을 고른 다음 x64 또는 arm64 아키텍처를 확인하세요. 다운로드 센터에서는 x64 패키지를 기본 항목으로 제공하고 arm64 옵션도 안내합니다. GUI 클라이언트는 데스크톱 환경에서 구독과 규칙을 관리하는 데 적합합니다. 패키지 관리자가 설치 파일을 인식하더라도 현재 데스크톱 세션의 프록시 설정까지 완료된 것은 아닙니다. 설치와 트래픽 처리는 별도로 확인하세요.

데스크톱 환경마다 시스템 프록시를 읽는 방식이 다르며, 터미널 프로그램은 자체 프록시 설정을 사용할 수도 있습니다. 먼저 로컬 수신 주소와 포트를 확인한 뒤 대상 프로그램이 사용하는 프록시 유형을 살펴보세요. 가상 네트워크 어댑터로 트래픽을 처리하려면 권한, 라우팅, DNS 서비스의 관계를 확인해야 합니다. 변경 전에 기존 네트워크 설정을 기록하고, LAN 주소에 접근할 수 없거나 DNS 오류가 발생하면 항목별로 되돌리세요. 설치 패키지, 코어, 네트워크 모드를 한꺼번에 바꾸면 어떤 계층에서 변화가 생겼는지 파악하기 어렵습니다.

다운로드 페이지로 이동

클라이언트는 로컬 설정과 트래픽 전달을 담당하며, 서버나 구독을 자동으로 제공하지 않습니다. 설치한 뒤 신뢰할 수 있는 출처에서 받은 유효한 매개변수를 가져와야 합니다. 공유 링크에 표시된 프로토콜 이름은 정보의 일부일 뿐입니다. 전송 방식, 암호화 옵션, 서버 측 요구 사항도 함께 확인해야 합니다.

모든 클라이언트 보기 → 세 가지 클라이언트 비교 →

Project V / V2Fly / Xray

코어와 클라이언트의 역할 구분

클라이언트 UI, 프록시 코어, 원격 서버는 서로 다른 구성 요소입니다. 오픈소스는 코드와 라이선스가 공개되는 방식을 설명합니다. 실제 연결 여부는 로컬 설정, 네트워크 경로, 서버 상태에 따라 달라집니다. 각 계층의 역할을 알아야 업데이트와 문제 해결을 적절한 위치에서 진행할 수 있습니다.

01 / Project V

도구 모음에서 설정 체계까지

Project V는 네트워크 통신 도구를 중심으로 구성되어 있으며 V2Ray는 널리 사용되는 프록시 소프트웨어입니다. V2Ray는 단일 전송 프로토콜의 이름이 아니라 인바운드, 아웃바운드, 라우팅, DNS를 구성하는 체계입니다. 흔히 말하는 ‘V2Ray 클라이언트’는 이런 설정을 만들고 코어를 실행하는 GUI 프로그램을 가리키는 경우가 많습니다. 이를 이해하면 특정 UI의 스위치를 모든 코어에서 공통으로 지원하는 기능이라고 오해하지 않을 수 있습니다.

일반적으로 연결은 로컬 인바운드로 들어온 뒤 라우팅에 따라 아웃바운드가 선택되고, 해당 프로토콜을 통해 원격 서버와 통신합니다. 서버 목록은 매개변수 관리, 시스템 프록시는 트래픽 진입점, 라우팅 모드는 목적지 선택을 담당합니다. 세 요소는 사용 경험에 함께 영향을 주지만 서로 대체할 수는 없습니다. 문제가 생기면 먼저 요청이 클라이언트에 들어왔는지 확인하고, 예상한 아웃바운드와 매칭되었는지 살펴본 다음 원격 핸드셰이크를 확인하세요. 이 순서로 점검하면 원인을 더 명확하게 찾을 수 있습니다.

02 / V2Fly · Xray

같은 생태계의 서로 다른 코어

V2Fly는 V2Ray를 이어 커뮤니티에서 유지 관리하고, Xray는 관련 기술 체계에서 발전해 별도의 코어 방향을 갖추었습니다. 두 코어는 여러 설정 개념을 공유하지만 기능과 항목 세부 사항이 완전히 같지는 않습니다. 공유 링크를 UI가 인식하더라도 현재 코어가 모든 매개변수를 지원한다고 볼 수 없습니다. 특히 특정 보안 기능, 흐름 제어 설정, 새로운 전송 방식 조합은 클라이언트의 가져오기 기능과 실제 실행 코어를 모두 확인해야 합니다.

v2rayNG는 Xray 코어를 기반으로 하며 v2flyNG는 안드로이드에서 V2Fly 코어를 선택할 수 있는 클라이언트입니다. v2rayN은 데스크톱 UI에서 서버, 규칙, 코어 실행 매개변수를 관리하며, 선택 가능한 항목은 배포 패키지와 설정에 따라 다릅니다. 코어를 바꾸기 전에 기존 매개변수를 보존하고 생성된 설정의 차이를 확인하세요. 연결이 실패했다는 이유만으로 코어를 반복해서 바꾸지 마세요. 주소, 시간, 포트, TLS 이름이 맞지 않으면 다른 코어로 바꿔도 대개 해결되지 않습니다.

03 / Open source

오픈소스 코드와 라이선스

v2rayN, v2rayNG, v2flyNG는 모두 오픈소스 클라이언트 프로젝트입니다. V2Fly와 Xray 코어는 MPL 2.0을 따르며, GUI 클라이언트와 함께 제공되는 구성 요소는 각각의 라이선스를 확인해야 합니다. 오픈소스는 설정 구현과 코드 수정, 문제 논의를 공개적으로 확인할 수 있게 해 줍니다. 하지만 현재 기기에 적합한지는 운영체제 요구 사항과 실제 테스트를 바탕으로 판단해야 합니다. 앱 배포, 코드 수정, 구성 요소 재배포 시에도 각 라이선스 조건을 따라야 하며, 모든 프로젝트에 같은 라이선스가 적용된다고 볼 수는 없습니다.

일상적으로 사용할 때는 설정과 권한의 경계를 특히 주의해야 합니다. 구독 주소에는 접근 자격 증명이 포함될 수 있고, 공유 링크에는 사용자 식별 정보가 담길 수 있으며, 로그에는 접속 대상이 기록될 수도 있습니다. 다른 사람에게 문제 해결 자료를 보낼 때는 이런 정보를 먼저 삭제하고 오류 유형, 발생 순서, 필요한 항목만 남기세요. 오픈소스라고 해서 원격 서비스에 대한 신뢰 관계가 달라지는 것은 아니며 구독 출처를 직접 확인하는 일도 대신해 주지 않습니다. 클라이언트 설치와 서비스 출처 선택은 별개의 결정입니다.

04 / Configuration maintenance

UI·코어·규칙 데이터 업데이트

클라이언트, 코어, 구독, 규칙 데이터 업데이트는 각각 다른 내용을 다룹니다. 클라이언트 업데이트는 메뉴와 설정 생성 방식을 바꿀 수 있고, 코어 업데이트는 프로토콜 구현과 실행 동작에 영향을 줍니다. 구독 업데이트는 원격 서버 매개변수를 새로 고치며, 규칙 데이터 업데이트는 geosite, geoip 등의 분류 매칭 결과를 바꿉니다. 구독 업데이트가 성공했다고 클라이언트까지 최신 버전이라는 뜻은 아닙니다. 마찬가지로 클라이언트를 새로 설치해도 만료된 구독이 다시 유효해지지는 않습니다.

업데이트 전에 현재 사용 중인 설정을 저장하세요. 특히 사용자 지정 라우팅, DNS, 수신 포트, 앱별 설정은 따로 보관하는 것이 좋습니다. 업데이트 후에는 기존 모드로 기본 연결을 확인한 다음 추가 기능을 테스트하세요. 특정 규칙 하나만 달라졌다면 데이터 세트와 규칙 순서를 확인하고, 모든 서버가 실행되지 않는다면 먼저 코어 시작 로그를 살펴보세요. 한 번에 한 계층만 변경하면 모든 설정을 초기화하는 것보다 원인을 파악하고 기존의 정상 상태로 복구하기 쉽습니다.

05 / Reading path

설치 안내부터 설정 가이드까지

처음 사용하는 경우 먼저 가이드에 따라 설치, 구독 가져오기, 서버 선택, 연결 확인을 마치세요. 기본 경로가 정상적으로 작동하면 용어집을 참고해 시스템 프록시, 전역 라우팅, TUN, DNS의 차이를 이해하세요. 일반적으로 말하는 전역 프록시는 라우팅 정책을 가리키며, 모든 프로그램의 트래픽이 클라이언트로 전달된다는 뜻은 아닙니다. 반대로 가상 네트워크 어댑터를 활성화해도 규칙에 따라 일부 주소를 직접 연결할 수 있습니다. 두 개념을 따로 이해해야 현재 네트워크 상태를 정확히 설명할 수 있습니다.

이미 정상 작동하는 설정이 있다면 예시를 따라 하기 위해 전부 다시 작성할 필요는 없습니다. 먼저 LAN 직접 연결 유지, 특정 도메인 예외 추가, 여러 구독 출처 정리처럼 구체적인 목적 하나를 정하세요. 변경 전후 동작을 기록하고 로그로 결과를 확인하면 됩니다. 사이트의 설정 예시는 항목과 관계를 설명하기 위한 자료입니다. 실제 실행에는 인바운드, 아웃바운드, 인증 매개변수, 데이터 파일이 필요하므로 JSON 일부만 복사해서는 클라이언트 설정 전체를 대체할 수 없습니다.

설정 가이드

프로토콜 선택과 규칙 문제 해결

모든 스위치를 한꺼번에 조정하기보다 설정 주제별로 살펴보세요. 아래 세 글에서는 프로토콜 선택, 규칙 우선순위, 연결 시간 초과를 다룹니다. 매개변수 호환성, 라우팅 매칭, 기본 연결 문제 중 어떤 상황인지 먼저 확인한 뒤 해당 점검 절차를 따라가세요.

선택 가이드

VMess·VLESS·Trojan·Shadowsocks 프로토콜 차이와 사용 사례 비교

암호화 방식, 핸드셰이크 오버헤드, 전송 계층 조합, 클라이언트 지원 여부의 네 가지 기준으로 비교합니다. 프로토콜을 선택할 때는 먼저 서버에서 제공하는 전체 매개변수를 확인하고, 로컬 코어가 해당 조합을 지원하는지 살펴보세요. 프로토콜 이름만으로 연결 성능을 판단할 수 없으며, 네트워크 환경을 고려하지 않고 속도만 비교해서도 안 됩니다.

프로토콜 비교 보기 →
고급 설정

V2Ray 사용자 지정 라우팅 규칙 작성법: domain·ip·geosite 매칭 문법과 우선순위

full, domain, keyword, regexp 접두사와 geosite, geoip 데이터 세트의 사용법을 항목별로 설명합니다. 구체적인 규칙으로 위에서부터 매칭되는 순서를 이해하고, 예외가 넓은 규칙에 가려지는지 확인하세요. 아웃바운드 태그가 실제 정의와 일치하는지도 점검해 규칙이 맞아 보여도 예상한 경로를 타지 않는 상황을 방지할 수 있습니다.

라우팅 규칙 가이드 읽기 →
문제 해결

v2rayNG 연결 시간 초과 해결: 로컬 네트워크부터 서버 설정까지 점검 순서

로컬 네트워크, 시스템 시간, 구독 상태, 전송 계층 매개변수, TLS 설정, 서버 상태를 차례로 확인합니다. 모든 서버에서 시간 초과가 발생하는지 특정 항목만 실패하는지 구분하고, 오류가 어느 단계에서 나타나는지 기록하세요. 그런 다음 로컬 트래픽 처리 방식이나 원격 매개변수 중 무엇을 확인할지 결정하면 반복적인 재설치로 시간을 낭비하지 않을 수 있습니다.

시간 초과 점검 목록 보기 →

전체 글 보기 →