클라이언트 다운로드 · 설정 문서
구독 가져오기부터 시작해 플랫폼에 맞는 클라이언트를 선택하고, 트래픽 분할 라우팅과 DNS 설정을 알아보세요.
구독 → 규칙 → 아웃바운드
클라이언트는 설정을 관리하고 코어는 연결을 처리합니다. 먼저 연결 하나를 정상 작동시킨 뒤 규칙을 하나씩 추가하면, 문제 발생 시 어떤 변경이 원인인지 파악하기 쉽습니다.
여러 구독이 한 목록에 섞여 있으면 서버가 어디에서 왔는지 파악하기 어렵습니다. 먼저 v2rayN에서 출처별 그룹을 만들고 구독 주소를 입력한 뒤 업데이트하세요. 목록을 좁혀 보려면 메모의 키워드로 필터링하면 됩니다. 필터는 표시 범위만 바꾸며 원격 구독 내용에는 영향을 주지 않습니다. 업데이트 전에는 현재 그룹과 선택 항목을 기록하고, 업데이트 후에는 로그를 확인하세요. 목록이 비어 있는 것을 연결 실패로 오해하지 않도록 주의해야 합니다. 공유 링크를 하나씩 붙여 넣는 것보다 그룹으로 관리하면 일괄 업데이트와 복원이 편리합니다.
구독 주소는 설정을 불러오는 데 사용되므로 민감 정보로 취급해야 합니다. 매뉴얼에서 해당 항목 보기 →geosite:category-ads-allblockgeoip:privatedirectgeosite:cndirect매칭되지 않은 트래픽proxy라우팅은 모든 요청을 같은 출구로 보내는 방식이 아닙니다. 도메인이나 대상 주소 등의 조건에 따라 아웃바운드를 선택합니다. 먼저 차단할 요청과 LAN 연결을 처리하고, 명확한 도메인 분류 규칙을 추가한 다음 매칭되지 않은 트래픽의 경로를 지정하세요. 예시의 proxy, direct, block은 아웃바운드 태그이므로 실제 설정과 일치해야 합니다. 규칙 세트에 해당하는 데이터 파일도 필요합니다. 기기 전체 모드를 자주 바꾸는 대신 분할 라우팅 규칙을 명확히 설정하면 연결 범위를 예측할 수 있고, 문제가 생겼을 때 어떤 규칙이 적용됐는지도 찾기 쉽습니다.
규칙 순서와 매칭 조건은 모두 중요합니다. 매뉴얼에서 해당 항목 보기 →시스템 프록시는 해당 설정을 따르는 앱에만 영향을 주지만, TUN은 가상 네트워크 인터페이스를 통해 더 많은 연결을 처리하므로 적용 범위가 다릅니다. 먼저 시스템 프록시로 구독과 서버 설정을 확인한 다음, 필요한 앱에 따라 TUN을 테스트하세요. 연결 경로와 DNS 정책을 동시에 바꾸지 않는 것이 좋습니다. DNS는 도메인을 주소로 변환하며 일부 라우팅 조건에도 영향을 줍니다. 브라우저 설정만 바꾸는 경우와 달리 TUN을 사용할 때는 권한, 라우팅, 다른 네트워크 프로그램과의 충돌도 확인해야 합니다. 사용 설정 후 웹사이트, LAN 서비스, 도메인 확인을 각각 테스트하세요.
TUN은 구독 오류를 해결하는 만능 설정이 아닙니다. 매뉴얼에서 해당 항목 보기 →운영체제에 맞는 설치 파일 선택
데스크톱에서는 v2rayN, 안드로이드에서는 v2rayNG부터 확인하세요. 설치 파일의 프로세서 아키텍처는 기기와 일치해야 합니다. 같은 클라이언트라도 화면이나 패키징 방식이 다를 뿐, 구독을 다시 구매하거나 바꿀 필요는 없습니다.
v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 익숙한 기존 레이아웃을 유지합니다. 사용 방식에 맞춰 선택한 뒤 운영체제가 각 버전의 설치 요구 사항을 충족하는지 확인하세요.
업데이트 전에 구독 그룹과 사용자 지정 라우팅 규칙을 보관하세요. 실행 오류가 발생하면 설정을 계속 덮어쓰지 말고 실행 환경과 압축 해제 위치부터 확인하세요.
먼저 시스템의 ‘이 Mac에 관하여’에서 칩 정보를 확인한 뒤 Apple Silicon 또는 Intel용 v2rayN 설치 파일을 선택하세요. 두 아키텍처의 설정 방법은 같으며, 차이는 주로 프로그램 실행 환경에 있습니다.
설치 후 시스템에서 요구하는 권한을 승인하고 시스템 프록시를 테스트하세요. 다른 프록시 도구를 사용 중이라면 설정이 서로 덮어쓰이지 않도록 해당 프로그램을 먼저 종료하세요.
v2rayNG는 Xray 코어를 사용하므로 안드로이드에서 우선 고려할 만한 클라이언트입니다. V2Fly 코어 환경이 필요하다면 v2flyNG를 확인하세요. 최근 출시된 기기 대부분은 arm64를 선택할 수 있으며, 아키텍처를 모를 때는 범용 버전을 확인하세요.
처음 연결할 때는 VPN 권한을 승인해야 합니다. 클라이언트를 바꾸기 전에 기존 연결을 끊고, 시스템의 백그라운드 제한도 확인하세요. 권한이나 절전 문제를 서버 오류로 오해하지 않도록 주의하세요.
배포판에 맞는 deb 또는 rpm 패키지를 선택한 뒤 x64 또는 arm64 아키텍처를 확인하세요. 먼저 데스크톱 인터페이스에서 구독을 가져와 연결을 테스트하고, 기본 설정이 정상 작동하는지 확인한 다음 가상 네트워크 인터페이스 설정을 검토하세요.
데스크톱 시스템 프록시와 터미널 환경 변수는 서로 다른 연결 경로입니다. 브라우저에서는 정상인데 명령줄에서 문제가 생긴다면 각 설정을 따로 확인하세요. 바로 클라이언트를 다시 설치하거나 구독을 바꿀 필요는 없습니다.
첫 설정 순서
다음 세 단계로 확인하기 쉬운 기본 상태를 설정합니다. 데스크톱에서 v2rayN을, 안드로이드에서 v2rayNG를 사용할 때 메뉴 이름은 다를 수 있지만 설정을 가져오고 연결 경로를 선택한 뒤 결과를 확인하는 순서는 같습니다.
구독 설정에서 새 그룹을 만들고 출처를 알아볼 수 있는 이름을 지정한 다음 전체 구독 주소를 붙여 넣고 업데이트하세요. 공유 링크는 보통 서버 하나를 지정하고 구독 링크는 여러 설정을 가져오는 데 사용합니다. 링크 길이만으로 형식을 판단할 수는 없습니다. 가져온 뒤 서버 목록과 업데이트 로그를 확인해 공백이 들어갔거나 주소가 잘리지 않았는지, 웹페이지 주소를 구독 주소로 잘못 입력하지 않았는지 확인하세요.
구독에는 로그인 정보나 접속 권한이 포함될 수 있습니다. 문제를 문의할 때는 민감한 정보를 지운 오류 메시지만 공유하고 전체 링크나 QR 코드는 공개하지 마세요.
서버 설정 하나를 선택하고 이해하기 쉬운 기본 라우팅을 유지하세요. v2rayN에서는 시스템 프록시를 사용 설정해 해당 설정을 따르는 브라우저가 클라이언트를 거치도록 합니다. v2rayNG에서는 연결을 시작하고 시스템 권한을 승인하세요. 프록시 프로그램 여러 개를 동시에 사용하거나 TUN, DNS, 라우팅을 한 번에 바꾸지 마세요. 문제가 생겼을 때 원인을 찾기 어려워집니다.
‘클라이언트가 실행 중’이라는 상태는 프로그램이 켜져 있다는 뜻일 뿐, 모든 앱이 프록시를 사용한다는 의미는 아닙니다. 연결 경로 설정을 별도로 확인해야 합니다.
먼저 평소 이용하는 웹사이트에 접속하고, 클라이언트 로그에 연결 또는 DNS 오류가 있는지 확인하세요. LAN 기기에 계속 접속할 수 있는지도 점검합니다. 특정 앱에서만 문제가 생기면 해당 앱이 시스템 프록시를 따르는지 확인하세요. 모든 요청이 실패한다면 구독 유효성, 서버 설정, 네트워크 상태를 다시 살펴보세요. 연결 테스트가 성공한 뒤 세부 라우팅 규칙을 하나씩 추가하고 변경 사항을 기록하세요.
사용을 마치면 더 이상 필요하지 않은 시스템 프록시 설정을 해제하세요. 클라이언트를 종료한 뒤에도 앱이 닫힌 로컬 포트로 요청을 보내는 상황을 막을 수 있습니다.
Project V · V2Fly · Xray
클라이언트를 고르기 전에 세 가지 구성 요소를 구분하세요. 프로토콜은 통신 방식을 정의하고, 코어는 연결과 라우팅을 처리하며, 그래픽 클라이언트는 이러한 기능을 조작하기 쉬운 인터페이스로 제공합니다. 이름이 비슷해도 기능 범위와 설정 형식이 모두 같은 것은 아닙니다.
V2Ray 프로젝트 구조와 모듈화 방식
커뮤니티가 유지 관리하는 V2Ray 코어 계열
v2flyNGV2Ray에서 파생된 독립 코어
v2rayNGv2rayN은 여러 코어를 관리할 수 있습니다. 실제 지원 범위는 선택한 코어와 설정에 따라 달라집니다.
V2Ray는 Project V 생태계의 네트워크 프록시 도구로, 인바운드, 아웃바운드, 라우팅, DNS 기능을 나누어 구성합니다. 그래픽 클라이언트가 자주 사용하는 설정을 메뉴에 모아 두어도 이러한 구성 요소는 그대로 존재합니다. 구조를 이해하면 ‘앱이 로컬 연결 경로에 진입하지 않은 문제’와 ‘요청이 코어에 도달한 뒤 잘못된 아웃바운드를 선택한 문제’를 구분할 수 있습니다. 모든 연결 문제를 서버 장애로 단정하지 않게 됩니다.
V2Fly는 V2Ray를 이어받아 커뮤니티에서 유지 관리되고 있으며, Xray는 V2Ray에서 파생되어 독립적인 방향으로 발전했습니다. 두 코어는 일부 개념과 역사를 공유하지만 지원하는 프로토콜 기능, 설정 필드, 기본 동작은 다를 수 있습니다. 프로토콜 이름을 확인할 때는 실제 전송 방식과 보안 설정, 코어의 지원 여부도 살펴보세요. 한 코어의 전체 설정을 다른 코어에서도 그대로 쓸 수 있다고 가정해서는 안 됩니다.
v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 그래픽 클라이언트입니다. v2rayN은 데스크톱 사용과 설정 관리를 위한 클라이언트이며, v2rayNG와 v2flyNG는 안드로이드용으로 서로 다른 코어 계열을 사용합니다. 오픈 소스 라이선스는 코드의 사용, 수정, 배포 조건을 정하며 자세한 내용은 각 프로젝트의 라이선스를 확인해야 합니다. 클라이언트 소스가 공개되어 있다고 해서 서버 운영자, 구독 서비스, 클라이언트 프로젝트가 같은 주체라는 뜻은 아닙니다.
클라이언트 업데이트는 프로그램을 교체하는 것이고, 구독 업데이트는 서버 설정을 다시 가져오는 것입니다. 두 업데이트는 해결하는 문제가 다릅니다. 프로토콜 기능이 부족하다면 클라이언트와 코어를 확인하고, 구독 항목이 바뀌었다면 먼저 구독 업데이트 기록을 살펴보세요. 업데이트 전에 사용자 지정 규칙을 보관하고, 업데이트 후 시스템 프록시와 권한을 다시 확인하세요. 새 옵션이 보인다고 전부 사용 설정하지 말고, 안정적인 설정을 위해 각 옵션의 용도를 파악해야 합니다.
클라이언트에는 서버가 포함되어 있지 않습니다. 프로그램을 설치한 뒤에도 사용할 권한이 있는 설정을 가져와야 합니다. 구독 기간, 서비스 범위, 계정 상태는 구독을 제공한 곳에서 결정합니다. 이 사이트의 문서는 클라이언트 사용법과 설정 개념을 다룹니다. 클라이언트를 선택하기 전에 세 클라이언트 비교를 읽고, 생소한 용어는 용어 설명에서 확인하세요.
설정 가이드와 문제 해결
기본 설정을 마친 다음에는 구체적인 증상에 맞는 글을 찾아보세요. 실행 실패, 시스템 프록시 미작동, 코어 선택은 서로 다른 문제입니다. 모든 설정을 한꺼번에 바꾸기보다 문제가 발생한 계층을 먼저 파악하고 알맞은 해결 절차를 따르면 원인을 더 명확히 찾을 수 있습니다.
데스크톱에서 갑자기 종료되는 문제는 .NET 런타임, 압축 해제 경로, 관리자 권한과 관련된 경우가 많습니다. 안드로이드에서는 VPN 권한이나 백그라운드 제한을 확인하세요. 플랫폼별 실행 환경을 점검하고 필요한 경우 권한을 조정해, 반복적인 재설치로 원래 문제를 가리지 않도록 하세요.
글 읽기 →Project V의 시작부터 V2Fly 커뮤니티 유지 관리와 Xray 파생까지 살펴보고 코어와 그래픽 클라이언트의 역할을 구분합니다. v2rayNG와 v2flyNG의 코어 차이를 이해한 뒤 이름만 비교하지 말고 실제 설정 요구에 따라 선택하세요.
글 읽기 →연결된 상태인데 웹페이지가 열리지 않는다면 브라우저 확장 프로그램과 시스템 프록시 설정, 터미널 환경 변수를 각각 확인하세요. PAC 모드, 예외 목록, 포트 사용 여부를 점검하는 순서를 안내해 앱의 연결 경로 문제와 실제 연결 문제를 구분할 수 있도록 돕습니다.
글 읽기 →