구독 관리로 연결 설정을 정리하고, 라우팅으로 트래픽 경로를 나누세요. 앱에 따라 시스템 프록시 또는 TUN 모드를 선택하면 됩니다.
CONFIGURATION / WORKSPACE
GUI 클라이언트는 설정을 관리하고, 코어는 실제 연결을 담당합니다. 먼저 설정 출처를 확인한 다음 트래픽을 클라이언트로 보내는 방식을 조정하고, 마지막으로 규칙이 적용되는지 확인하세요. 아래에서는 주요 기능을 일상적인 작업 순서에 따라 설명합니다. 예시는 항목 간 관계를 보여 주기 위한 것으로, 완전한 연결 설정은 아닙니다.
구독을 사용하면 여러 서버 설정을 하나의 주소로 관리할 수 있습니다. 구독 그룹 설정을 열고 알아보기 쉬운 이름과 링크를 입력한 뒤 저장하고 구독을 업데이트해야 목록에 설정이 표시됩니다. 공유 링크를 하나씩 붙여 넣는 것보다 그룹별로 새로고침하고 출처를 구분하기 쉽지만, 업데이트하면 그룹 내 항목이 바뀔 수도 있습니다. 업데이트 전에 직접 수정한 항목을 따로 보관하고, 업데이트 후에는 활성 서버를 다시 확인하세요. 구독 주소에는 인증 정보가 포함될 수 있으므로 민감한 정보로 취급해야 합니다. 문제를 확인할 때는 오류 유형만 기록하고 전체 주소를 공개하지 마세요.
구독 주소 형식 예시(예시 도메인):
https://example.com/subscription
작업 순서:
구독 그룹 → 추가 → 저장 → 구독 업데이트라우팅은 도메인이나 대상 주소 등의 조건을 지정된 아웃바운드에 연결합니다. 일반적인 처리 방식은 직접 연결, 프록시, 차단입니다. 시스템 프록시만 전환하는 것과 달리 라우팅은 트래픽이 코어에 들어온 뒤의 처리 방식을 바꿉니다. 규칙은 보통 순서대로 적용되므로 구체적인 예외 규칙을 포괄적인 조건보다 앞에 두고, 지정한 아웃바운드 태그가 실제로 있는지 확인하세요. 도메인 분류를 사용하려면 해당 규칙 데이터베이스도 필요합니다. 아래 예시는 조건에 맞는 도메인을 direct 아웃바운드로 전달하는 규칙 일부입니다. 이 규칙만으로 직접 연결 아웃바운드가 생성되지는 않으며 DNS 설정을 대신하지도 않습니다.
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}시스템 프록시는 앱이 시스템 설정을 읽어야 작동합니다. TUN은 가상 네트워크 인터페이스를 통해 지정된 트래픽을 받아 시스템 프록시 설정을 따르지 않는 앱에도 적용할 수 있습니다. 두 기능은 작동하는 계층이 다르므로 TUN을 연결 실패를 해결하는 만능 버튼처럼 사용해서는 안 됩니다. 먼저 일반 프록시로 서버 연결을 확인한 뒤 권한, 가상 네트워크 인터페이스, DNS, 기본 경로를 점검하세요. 데스크톱 환경에서는 권한 상승이 필요할 수 있고, 모바일에서는 시스템 연결 권한을 확인해야 합니다. TUN을 켠 뒤 로컬 네트워크나 기존 연결에 문제가 생기면 먼저 TUN을 끄고 이전 상태로 되돌린 다음 예외 규칙을 하나씩 조정하세요.
활성화 전:
시스템 프록시 연결 테스트 → 정상 작동 확인
다른 트래픽 처리 도구 → 충돌하는 인스턴스 일시 중지
TUN 모드 → 켜기
확인 항목 → 도메인 확인 / 로컬 네트워크 / 대상 앱GUI와 연결 코어는 서로 다른 계층입니다. GUI는 구독과 설정을 저장하고, 코어는 설정을 해석해 연결을 수립합니다. v2rayN에서 선택할 수 있는 코어는 클라이언트 빌드와 프로토콜 지원에 따라 달라집니다. v2rayNG는 Xray 코어를 사용하며, v2flyNG는 V2Fly 계열을 사용하는 대안입니다. 클라이언트 이름만 비교하기보다 프로토콜, 전송 방식, 보안 매개변수를 확인해야 호환 여부를 더 정확히 판단할 수 있습니다. 전환 전에는 현재 설정을 저장하고, 전환 후에는 시작 로그를 확인하세요. 특정 항목을 인식하지 못한다면 서버 주소나 포트를 계속 바꾸기보다 먼저 지원 범위를 확인하세요.
코어 계열:
Xray → 프로토콜, 전송 방식 및 보안 매개변수 확인
V2Fly → 설정 형식 및 지원 범위 확인
문제 해결 순서:
설정 해석 → 코어 시작 → 연결 수립 → 앱 요청데스크톱에서는 v2rayN으로 구독과 라우팅을 관리하고, 모바일에서는 v2rayNG 또는 v2flyNG를 선택할 수 있습니다. 플랫폼 간에 구독 출처는 공유할 수 있지만 시스템 프록시, 권한 부여 방식, 설치 패키지 아키텍처를 그대로 적용할 수는 없습니다. 파일 확장자만 보고 패키지를 고르기보다 프로세서 아키텍처와 OS 버전을 먼저 확인하는 편이 안전합니다. 기기를 옮길 때는 클라이언트 설정, 규칙 데이터베이스, 시스템 트래픽 처리 상태를 각각 확인하세요. 링크를 가져오면 모든 설정이 동기화된다고 가정하지 마세요. 처음 설치할 때는 기본 설정을 유지하고 기본 연결을 확인한 뒤 자동 시작과 세부 라우팅 정책을 설정하세요.
데스크톱 설정 관리: v2rayN
모바일 설정 관리: v2rayNG / v2flyNG
패키지 선택 순서:
운영체제 → 프로세서 아키텍처 → 패키지 형식 → 설치 방법CLIENT / PLATFORM
먼저 시스템 정보에서 프로세서 아키텍처를 확인한 뒤 해당 다운로드 항목으로 이동하세요. 데스크톱에서는 v2rayN을 기본으로 사용하고, Android에서는 필요한 코어에 따라 클라이언트를 선택하면 됩니다. 클라이언트는 로컬 설정 관리 기능을 제공하지만, 설치만으로 사용할 수 있는 서버가 생기는 것은 아닙니다. 이용 권한이 있는 구독이나 설정을 별도로 준비해야 합니다.
v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 데스크톱 UI를 유지합니다. 패키지를 선택하기 전에 OS 종류와 실행 요구 사항을 확인하세요. 설치 후에는 프로그램과 설정을 쓸 수 있는 위치에 저장해야 권한 문제로 설정이 저장되지 않는 일을 방지할 수 있습니다.
처음 실행하면 구독을 가져오고 서버를 선택한 다음 시스템 프록시 자동 설정을 켜세요. 브라우저에서는 연결되지만 다른 앱에서 작동하지 않는다면 해당 앱이 시스템 프록시를 읽는지 확인하세요. 문제를 곧바로 구독 탓으로 돌리지 마세요. 더 폭넓은 트래픽 처리가 필요하다면 가이드에 따라 TUN에 필요한 권한을 확인하세요.
다운로드 페이지로 이동v2rayN은 Apple Silicon과 Intel 칩에 따라 설치 패키지가 다릅니다. ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인해 맞는 아키텍처를 선택하세요. 설치 후 응용 프로그램 폴더에서 실행하면 됩니다. 출처 확인을 요구하는 경우 먼저 앱 출처를 확인한 뒤 시스템 보안 설정에서 실행을 승인하세요.
시스템 프록시와 가상 네트워크 인터페이스를 통한 트래픽 처리는 서로 다른 시스템 기능을 사용합니다. 처음 설정할 때는 일반 프록시부터 확인하고 브라우저 요청과 클라이언트 로그를 살펴보세요. 네트워크 확장, 권한 또는 다른 연결 도구와 충돌하면 현재 상태를 기록하고 하나씩 점검하세요. 시스템 네트워크 설정을 한꺼번에 여러 개 변경하지 마세요.
다운로드 페이지로 이동먼저 Xray 코어를 사용하는 v2rayNG를 확인하세요. V2Fly 코어가 필요하다면 v2flyNG를 살펴볼 수 있습니다. 비교적 최신 기기는 대체로 arm64 패키지를 선택하면 됩니다. 아키텍처를 모르겠다면 기기 정보를 확인하거나 범용 버전 안내를 참고하세요. 설치 권한은 실제 사용하는 설치 출처에만 허용하고, 설치가 끝나면 필요에 따라 설정을 원래대로 되돌리세요.
구독을 가져온 뒤 업데이트하고 설정을 선택해 연결을 시작하세요. 처음 연결할 때는 시스템 연결 권한을 승인해야 합니다. 절전 정책으로 백그라운드 연결이 끊길 수 있으니 기기 설정에서 필요한 백그라운드 실행을 허용하세요. 클라이언트를 바꾸기 전에는 기존 연결을 중지해 여러 트래픽 처리 인스턴스가 충돌하지 않도록 하세요.
다운로드 페이지로 이동v2rayN은 deb 및 rpm 패키지를 제공하며 x64와 arm64 아키텍처를 구분합니다. Debian·Ubuntu 계열은 보통 deb, Fedora 등은 보통 rpm을 선택하지만 실제 패키지 형식은 배포판의 패키지 관리 방식에 따라야 합니다. 먼저 데스크톱 실행과 의존성을 확인한 다음 사용자 세션의 자동 시작을 설정하세요.
데스크톱 환경마다 시스템 프록시 지원 방식이 다르며, 일부 앱은 프록시를 별도로 설정해야 합니다. 설치 후에는 GUI, 코어 시작, 앱 요청을 각각 확인하세요. TUN에 필요한 권한과 네트워크 경로도 별도로 설정해야 합니다. 설치 패키지가 정상적으로 설치됐다고 해서 트래픽 처리가 적용된 것은 아닙니다.
다운로드 페이지로 이동QUICKSTART / THREE STEPS
설정, 트래픽 처리, 연결 확인을 나눠서 진행하세요. 그래야 문제가 발생한 계층을 파악하기 쉽고, 변경이 잘못됐을 때 이전의 정상 설정으로 되돌리기도 편합니다. 아래 데스크톱 안내는 v2rayN을 기준으로 합니다. Android의 v2rayNG는 메뉴 이름이 다를 수 있지만 진행 순서는 같습니다.
구독 그룹으로 이동해 이름과 전체 구독 주소를 입력하고 저장한 뒤 업데이트하세요. 링크 끝의 쿼리 매개변수는 인증에 사용될 수 있으므로 임의로 잘라내지 마세요. 채팅이나 문서에서 복사했다면 공백, 줄바꿈, 전각 문장 부호가 섞이지 않았는지 확인하세요. 업데이트가 완료되어야 설정 항목이 서버 목록에 나타납니다.
목록이 비어 있다면 먼저 선택한 그룹을 확인하고 업데이트 로그를 살펴보세요. 웹페이지 응답, 인증 실패, 구문 분석 실패는 서로 다른 문제이므로 각각 해결해야 합니다. 수동 공유 링크는 해당 가져오기 메뉴에서 사용해야 하며, 모양만 보고 구독 주소 입력란에 붙여 넣어서는 안 됩니다.
사용할 설정을 선택해 활성 서버로 지정하고, 현재 요구에 맞는 라우팅 프리셋을 우선 유지하세요. 데스크톱에서 시스템 프록시 자동 설정을 켠 뒤 시스템 설정을 따르는 브라우저로 테스트합니다. Android에서는 연결을 시작할 때 시스템 권한을 승인하고 상태 표시줄에 연결 아이콘이 나타나는지 확인하세요.
시스템 프록시는 앱이 요청을 로컬 프록시로 전달하는 방식을 결정하고, 라우팅은 코어에 들어온 요청의 아웃바운드를 결정합니다. 두 기능은 서로 대신할 수 없습니다. 먼저 일반 연결을 확인한 뒤 TUN을 검토하세요. DNS, 라우팅, 트래픽 처리 방식을 한꺼번에 바꾸면 실패 원인을 찾기 어렵습니다.
대상 페이지를 열고 로그를 확인해 요청이 클라이언트에 들어왔는지, 코어가 시작됐는지, 원격 서버가 응답했는지 살펴보세요. 한 번의 연결 테스트는 해당 테스트 경로의 결과만 보여 줄 뿐, 모든 앱과 도메인, 전송 방식이 작동한다는 뜻은 아닙니다. 확인 과정에서 직접 연결도 하나 유지해 로컬 네트워크 서비스에 계속 접근할 수 있는지 점검하세요.
연결에 실패하면 설정 해석, 코어 시작, 도메인 확인, 연결 수립 순으로 원인을 찾으세요. 오류 유형과 발생시킨 작업을 기록하고, 로그를 공유하기 전에는 구독 주소와 개인 정보를 지우세요. 클라이언트를 종료하기 전에 시스템 프록시를 해제해야 앱이 닫힌 로컬 포트로 계속 요청을 보내지 않습니다.
PROJECT V / CORE / CLIENT
V2Ray, V2Fly, Xray와 GUI 클라이언트는 서로 같은 종류의 구성 요소가 아닙니다. 이름만 비교하기보다 각 구성 요소의 역할을 이해하면 적합한 제품을 고르기 쉽고 설정 오류의 범위도 좁힐 수 있습니다.
CONCEPT
모듈형 프록시 및 라우팅 설계
CORE FAMILY
설정 해석, 전송 및 아웃바운드 처리
GRAPHICAL CLIENT
구독, 인터페이스 및 시스템 설정
Project V는 V2Ray의 기술적 배경을 이해하는 출발점입니다. 모듈형 설계로 인바운드, 아웃바운드, 전송, 라우팅 등의 역할을 분리합니다. V2Fly 커뮤니티는 V2Ray 개발과 유지 관리를 이어 가고 있으며, Xray는 관련 코드 기반에서 발전한 별도의 코어 계열입니다. 두 코어는 기술적 배경을 공유하지만 기능 발전 방향과 지원하는 설정 항목이 완전히 같지는 않습니다. 프로토콜 이름이 같더라도 구체적인 전송 방식과 보안 매개변수를 확인해야 하며, 이를 근거로 설정을 그대로 바꿔 쓸 수 있다고 판단해서는 안 됩니다.
코어는 실제 연결을 수립하고, GUI 클라이언트는 설정을 생성·저장·관리합니다. 시작에 실패하면 먼저 코어의 설정 해석 로그를 확인하세요. 구독 그룹, 인터페이스 설정, 자동 시작에만 문제가 있다면 클라이언트 계층을 점검해야 할 가능성이 큽니다. 두 계층을 구분하면 인터페이스 설정만 반복해서 바꾸면서 실제로 지원되지 않는 프로토콜 항목을 놓치는 일을 줄일 수 있습니다.
v2rayN은 데스크톱용으로 서버 목록, 구독 그룹, 라우팅 설정, 시스템 프록시 등의 관리 기능을 제공합니다. v2rayNG는 Xray 코어를 사용하는 Android 클라이언트입니다. v2flyNG도 Android용이며 V2Fly 코어를 사용하는 대안입니다. 세 클라이언트 모두 오픈 소스 프로젝트를 기반으로 하지만, 같은 프로그램의 다른 이름은 아닙니다. 설정 메뉴, 시스템 권한, 지원 기능은 각각 확인해야 합니다. 먼저 기기 플랫폼에 맞는 클라이언트를 고른 다음 필요한 프로토콜과 코어 호환성을 확인하세요.
오픈 소스 라이선스는 코드를 사용·수정·배포할 때 지켜야 할 조건을 정하며, 모든 실행 환경에서의 호환성을 보장하지는 않습니다. V2Fly의 V2Ray와 Xray-core는 서로 다른 오픈 소스 라이선스 체계를 따르며, GUI 클라이언트와 함께 제공되는 구성 요소에도 각각 별도의 라이선스가 적용될 수 있습니다. 일반적인 사용과 재패키징 후 배포는 다른 상황입니다. 재배포할 때는 해당 배포물에 포함된 라이선스 파일을 확인하고, 요구되는 저작권 및 라이선스 고지를 유지하세요.
클라이언트, 코어, 규칙 데이터베이스, 구독은 서로 다른 업데이트 대상입니다. 클라이언트 업데이트는 인터페이스와 설정 생성 방식에 영향을 줄 수 있고, 코어 업데이트는 프로토콜 지원과 연결 동작에 영향을 줍니다. GeoIP 및 GeoSite 업데이트는 분류 규칙 매칭에 영향을 주고, 구독 업데이트는 서버 항목을 새로 고칩니다. 한 항목을 업데이트했다고 다른 항목까지 함께 바뀌는 것은 아닙니다. 규칙이 적용되지 않는다면 구독만 반복해서 업데이트하지 말고 사용 중인 태그, 규칙 데이터베이스 출처, 로드 위치를 함께 확인하세요.
설정을 변경하기 전에 현재 정상 작동하는 구성을 보관하고 변경할 항목을 기록하세요. 한 번에 한 종류만 변경하고 같은 요청으로 다시 테스트하면 문제가 생겼을 때 빠르게 되돌릴 수 있습니다. 서버 매개변수 문제는 설정 제공자에게 확인해야 합니다. 클라이언트 자체가 서버를 만들어 주거나 만료된 인증 정보를 자동으로 고쳐 주지는 않습니다. 플랫폼별 차이와 설치 방법은 전체 플랫폼 설치 및 설정 가이드에서 확인하세요.
NOTES / CONFIGURATION
실제 작업에 맞춰 내용을 보충합니다. 먼저 메인 창에서 설정 메뉴를 찾고, 이어서 코어의 역할을 이해한 다음 트래픽 분할에 필요한 규칙 데이터베이스를 관리하세요. 문서의 설정 예시는 사용 중인 클라이언트와 코어가 지원하는 범위에 맞춰 적용해야 합니다. 변경 후에는 로그와 실제 요청 결과를 확인하세요.
GeoIP와 GeoSite 규칙 데이터베이스의 역할과 차이를 설명하고, v2rayN 및 v2rayNG에서 규칙 파일을 업데이트하는 방법과 geosite:cn 등의 라우팅 태그 사용법을 안내합니다.
Project V에서 V2Fly 커뮤니티의 유지 관리, Xray 분기까지 이어지는 변화를 살펴보고, 세 GUI 클라이언트의 코어 계열과 선택 시 확인할 설정 조건을 설명합니다.
v2rayN 메인 창의 기능을 항목별로 살펴봅니다. 서버 목록의 마우스 오른쪽 버튼 메뉴, 구독 그룹 업데이트 방법, 로그 패널 확인법, 매개변수 설정에서 자주 바꾸는 항목을 설명합니다.