v2rayN 데스크톱 클라이언트와 v2rayNG·v2flyNG Android 클라이언트의 설치 경로를 한곳에 모았습니다. 실제 설정 항목을 바탕으로 구독 그룹, 시스템 프록시, TUN 모드, 라우팅 규칙과 코어 선택을 설명하며, 최초 가져오기부터 프로토콜 선택까지 전체 과정을 다룹니다.
CLIENT SETTINGS
시스템 프록시, 구독 그룹, 라우팅 규칙과 코어는 서로 독립적인 스위치가 아닙니다. 각 기능이 담당하는 계층을 먼저 이해한 뒤 기기와 사용 환경에 맞게 조합하면, 가져오기는 성공했지만 연결 동작이 예상과 다른 문제를 줄일 수 있습니다.
PROXY MODE
시스템 프록시는 운영체제의 프록시 설정을 읽는 브라우저와 데스크톱 앱에 주로 영향을 줍니다. 활성화하면 클라이언트가 현재 사용자의 프록시 주소를 기록합니다. TUN 모드는 네트워크 인터페이스에 더 가까운 계층에서 동작하므로 프록시 설정 메뉴가 없는 앱도 처리할 수 있습니다. 둘 다 많이 켠다고 좋은 것은 아닙니다. 일반 웹 브라우징과 개발 도구는 먼저 시스템 프록시를 사용하고, 특정 프로그램이 시스템 설정을 읽지 않을 때 권한·DNS·라우팅을 확인한 뒤 TUN을 활성화하세요. 모드를 바꾼 후에는 현재 서버가 활성 항목으로 지정되어 있는지도 확인해야 합니다. 스위치만 켜고 사용 가능한 아웃바운드가 없는 상황을 피할 수 있습니다.
SUBSCRIPTION GROUP
구독 링크는 보통 여러 서버 설정을 반환하며, 클라이언트는 이를 지정한 그룹에 넣습니다. 링크 자체를 단일 노드로 취급하는 것은 아닙니다. 그룹 이름, 업데이트 주소, 자동 업데이트 주기와 필터 규칙이 목록 관리 방식을 함께 결정합니다. 여러 출처는 각각 별도 그룹으로 만들어 개별 업데이트·비활성화·형식 오류 확인이 가능하도록 하세요. 가져온 뒤 목록이 비어 있으면 주소 내용, 구독 형식, 업데이트 기록과 필터 조건을 순서대로 확인하고 기존 그룹을 반복해서 덮어쓰지 마세요. 단일 vmess:// 또는 vless:// 공유 링크는 클립보드로 직접 가져오는 방식이 적합합니다.
ROUTING RULES
라우팅은 도메인, IP, 포트 또는 프로세스 등의 조건으로 연결을 매칭한 뒤 프록시, 직접 연결 또는 차단과 같은 아웃바운드로 전달합니다. 규칙에는 명확한 순서가 있으며 일반적으로 먼저 일치한 항목이 우선 실행됩니다. 따라서 범위가 지나치게 넓은 규칙은 뒤의 세부 설정을 덮어쓸 수 있습니다. 처음에는 클라이언트 기본 규칙으로 시작하고, 자주 쓰는 사이트와 앱의 동작을 확인한 뒤 사용자 지정 규칙을 추가하세요. 규칙을 수정한 후에는 설정을 다시 불러오고 도메인 요청과 순수 IP 요청을 각각 테스트해야 DNS 결과와 라우팅 일치를 혼동하지 않습니다.
CORE FAMILY
그래픽 클라이언트는 설정을 가져오고 편집하며 표시하지만, 실제 연결을 만드는 것은 하위 코어입니다. V2Fly는 Project V의 커뮤니티 구현과 범용 설정 체계를 이어가고, Xray는 유사한 설정 모델을 바탕으로 VLESS, REALITY, XTLS Vision 등의 기능을 확장했습니다. 기본 필드 중에는 서로 이해할 수 있는 항목도 많지만, 확장 프로토콜과 전송 세부 사항은 이름만 바꿔서 변환할 수 없습니다. 코어를 선택할 때는 서버가 제공한 프로토콜, 전송 방식, 보안 유형과 클라이언트 지원 범위를 먼저 확인한 뒤 기본 코어를 사용할지 해당 구현을 선택하세요.
PLATFORM ENTRIES
데스크톱 플랫폼은 주로 v2rayN을 사용하며, Android에서는 코어 요구 사항에 따라 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 플랫폼 링크를 누르면 다운로드 페이지의 해당 탭이 열리고, 설치 패키지 유형·아키텍처·시스템 요구 사항이 표시됩니다.
Windows에서는 v2rayN 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용해 일반적인 설치에 적합하고, WPF 버전은 기존 Windows 작업 구성을 유지합니다. 다운로드 페이지에서 실행 환경과 사용 습관에 따라 선택하면 되며, 두 인터페이스를 동시에 설치할 필요는 없습니다.
다운로드로 이동macOS에서는 v2rayN 데스크톱 클라이언트를 사용하며, 설치 패키지는 Apple Silicon과 Intel 프로세서용으로 나뉩니다. 칩 아키텍처는 기기와 일치해야 합니다. 확실하지 않다면 시스템 정보에서 칩 이름을 확인한 후 ARM64 또는 x64 링크를 선택하세요.
다운로드로 이동Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 고려하고, V2Fly 코어 구현이 필요하면 v2flyNG를 선택할 수 있습니다. 최신 스마트폰 대부분은 ARM64 패키지에 적합하며, 아키텍처가 확실하지 않거나 호환 범위를 넓혀야 할 때는 범용 버전을 사용하세요.
다운로드로 이동Linux에서는 v2rayN의 deb 및 rpm 설치 패키지를 제공하며 x64와 ARM64 아키텍처로 구분합니다. Debian·Ubuntu 계열은 보통 deb를, Fedora·RHEL 계열은 보통 rpm을 선택합니다. 설치 전에 데스크톱 환경과 프로세서 아키텍처도 확인하세요.
다운로드로 이동QUICK START
처음부터 모든 고급 옵션을 한꺼번에 수정할 필요는 없습니다. 먼저 가져오기·선택·연결을 완료한 다음 실제 앱 사용에 맞춰 TUN, 라우팅과 프로토콜 매개변수를 추가하면 문제 범위를 더 쉽게 좁힐 수 있습니다.
해당 플랫폼의 다운로드 페이지로 이동해 운영체제와 프로세서 아키텍처에 맞는 설치 패키지를 선택하세요. Windows는 데스크톱 버전과 WPF 버전 중에서 고르고, macOS와 Linux는 아키텍처를 특히 확인해야 합니다. Android는 필요한 코어에 따라 v2rayNG 또는 v2flyNG를 선택하세요. 처음 실행한 뒤에는 클라이언트 메인 화면, 트레이 진입점 또는 백그라운드 서비스가 정상적으로 표시되는지 확인한 후 설정을 가져오세요.
구독 주소는 구독 그룹에 추가한 뒤 수동 업데이트를 한 번 실행하세요. vmess://·vless://·trojan:// 같은 단일 링크는 클립보드로 가져올 수 있습니다. 가져온 후 목록 생성 여부, 프로토콜 이름 일치 여부, 필터 규칙으로 서버 항목이 숨겨지지 않았는지를 확인하세요. QR 코드와 클립보드는 입력 방식일 뿐이며, 최종적으로는 클라이언트가 읽을 수 있는 설정 필드로 변환됩니다.
목록에서 설정 하나를 활성 서버로 선택한 뒤 먼저 시스템 프록시를 켜서 기본 연결을 확인하세요. 브라우저와 자주 사용하는 프로그램이 정상 작동하면 규칙 모드·전역 모드·TUN 모드가 필요한지 결정합니다. 연결이 예상대로 작동하지 않으면 서버 활성화 여부, 프록시 모드 적용 여부, 시스템 시간의 정확성, 프로토콜과 전송 매개변수의 조합을 각각 확인하세요.
OPEN ECOSYSTEM
클라이언트·코어·프로토콜의 역할을 이해하는 것이 특정 버튼의 위치만 외우는 것보다 중요합니다. 인터페이스는 관리하고, 코어는 실행하며, 구독은 설정을 전달합니다.
Project V는 설정 중심, 다중 인바운드·아웃바운드와 조합 가능한 전송을 핵심으로 하는 도구 생태계를 만들었습니다. 커뮤니티의 유지보수 방향이 발전하면서 V2Fly는 범용 프록시 코어와 설정 체계를 이어갔고, Xray는 유사한 모델 위에 더 많은 프로토콜과 전송 기능을 확장했습니다. 두 계열은 인바운드·아웃바운드·라우팅·DNS 같은 개념을 상당 부분 공유하지만, 구체적인 필드와 사용 가능한 전송·확장 기능은 선택한 코어의 지원 범위를 기준으로 판단해야 합니다.
이러한 계열 관계는 서로 다른 클라이언트가 비슷한 서버 필드를 표시하면서도 완전히 동일한 옵션을 지원하지 않는 이유를 설명합니다. 클라이언트 폼은 사용자의 입력을 코어 설정으로 변환할 뿐입니다. 특정 기능이 특정 코어의 확장에 속한다면 다른 코어가 기본 프로토콜을 이해하더라도 해당 보안 계층이나 흐름 제어 매개변수를 처리하지 못할 수 있습니다.
v2rayN은 Windows·macOS·Linux 데스크톱 환경에서 구독 관리, 서버 편집, 시스템 프록시, TUN, 라우팅 규칙과 코어 호출을 담당합니다. 여러 구독 그룹을 관리하고 실행 로그를 확인하며 라우팅 모드를 전환하거나 프로토콜 세부 사항을 조정해야 하는 사용자에게 적합합니다. 데스크톱 인터페이스와 하위 코어가 분리되어 있으므로 클라이언트 인터페이스 업그레이드, 코어 전환, 구독 업데이트는 서로 다른 작업이며 한 번의 작업으로 혼동해서는 안 됩니다.
v2rayNG는 Android에서 널리 사용되는 Xray 클라이언트로, VLESS·REALITY·XTLS Vision 등 Xray 기능을 사용하는 설정에 적합합니다. v2flyNG는 V2Fly 코어를 사용하며 해당 생태계 설정을 위한 선택지가 될 수 있습니다. 두 클라이언트 모두 구독, 공유 링크 가져오기, 라우팅과 연결 제어를 제공하지만 코어가 다르므로 프로토콜 확장 범위도 다릅니다. 선택할 때는 인터페이스 이름보다 설정 출처가 명시한 프로토콜·전송 방식·보안 유형·흐름 제어 매개변수를 기준으로 판단하세요.
세 클라이언트와 해당 코어는 오픈 소스 커뮤니티에서 지속적으로 유지보수하며, 코드 변경·문제 수정·기능 발전은 각 프로젝트가 채택한 오픈 소스 라이선스를 따릅니다. 오픈 소스이므로 설정 구조와 구현 로직을 공개적으로 논의할 수 있고, 서로 다른 클라이언트가 같은 프로토콜 개념을 바탕으로 각자의 인터페이스를 만들 수도 있습니다. 사용자에게 더 실용적인 판단 기준은 변경 사항, 코어 호환 범위와 설정 마이그레이션 안내를 확인하는 것입니다. ‘클라이언트 업데이트’, ‘코어 업데이트’, ‘구독 업데이트’를 같은 작업으로 보지 마세요.
클라이언트 업데이트는 보통 인터페이스, 플랫폼 호환성과 관리 기능을 바꾸고, 코어 업데이트는 프로토콜 구현·전송 동작·실행 안정성에 주로 영향을 줍니다. 구독 업데이트는 서버 설정 목록만 새로 고칩니다. 문제가 생기면 먼저 어느 계층의 문제인지 판단한 뒤 업데이트하거나 해당 부분만 되돌리면 원인을 찾지 못한 상태에서 여러 변수를 동시에 바꾸는 일을 피할 수 있습니다.
COMMON QUESTIONS
아래 질문은 구독 가져오기, 프록시 모드와 프로토콜 호환에 초점을 맞췄습니다. 전체 과정은 시작 가이드에서 단계별로 확인할 수 있습니다.
먼저 구독 그룹에서 수동 업데이트를 실행해 클라이언트가 형식 오류나 네트워크 오류를 반환하는지 확인하세요. 그런 다음 주소가 실제 구독 내용을 반환하는지, 필터 조건에서 제외된 것은 아닌지 살펴보세요. 웹페이지 안내 주소를 구독 데이터 주소로 착각하지 마세요.
구독 가져오기 단계 보기 →먼저 시스템 프록시로 기본 연결을 확인하는 것이 좋습니다. 운영체제의 프록시 설정을 읽는 앱에 적합합니다. 특정 프로그램이 시스템 프록시를 사용하지 않을 때만 권한·DNS·라우팅 요구 사항을 확인한 뒤 TUN을 활성화하세요.
프록시 모드 설명 보기 →가져오기가 된다는 것은 형식을 해석할 수 있다는 뜻일 뿐, 프로토콜 매개변수가 완전히 일치한다는 의미는 아닙니다. 프로토콜 유형, 주소, 포트, 사용자 식별자, 전송 방식, 보안 유형, SNI와 흐름 제어 등의 필드를 확인하고 시스템 시간이 정확한지도 점검하세요.
프로토콜 매뉴얼 보기 →서버에서 제공하는 프로토콜과 전송 조합에 따라 결정되며, 서버 지원이 없으면 클라이언트가 임의로 변환할 수 없습니다. VLESS는 최신 전송 방식 및 Xray 확장과 함께 사용되는 경우가 많고, VMess는 Project V의 고전적인 프로토콜이며, Trojan은 별도의 인증 모델을 사용합니다.
프로토콜 비교 보기 →TECH NOTES
설치 세부 사항부터 구독 형식과 프로토콜 핸드셰이크 경로까지 구체적인 문제별로 설명합니다. 기본 설정을 마친 뒤 이어서 읽기에 적합합니다.
다운로드와 압축 해제, 실행 환경부터 최초 실행까지 Windows 설치 과정을 단계별로 설명하고 데스크톱 버전과 WPF 버전의 인터페이스 및 사용 환경을 비교합니다. 시스템 프록시가 적용되지 않거나 트레이 진입점이 나타나지 않을 때의 점검 순서도 정리했습니다.
전체 글 읽기 →통합 구독, 기본 JSON 설정과 단일 공유 링크의 구조적 차이를 분석하고, 클라이언트가 콘텐츠를 식별하는 방식과 호환 범위에 영향을 주는 필드를 설명합니다. 구독 가져오기가 실패했을 때 먼저 확인할 형식 계층도 안내합니다.
전체 글 읽기 →핸드셰이크, 인증서 검증 경로와 데이터 전달 계층을 바탕으로 REALITY와 XTLS Vision의 설계 선택을 설명합니다. 클라이언트에서 프로토콜, 보안 유형, 흐름 제어와 서버 이름 필드를 어떻게 함께 설정해야 하는지도 다룹니다.
전체 글 읽기 →