CLIENT RELEASE INDEX / ZH-CN
v2rayN 및 v2rayNG 클라이언트 다운로드 경로를 한곳에 모아 구독 가져오기, 라우팅 분할, 연결 문제 해결을 안내합니다. 플랫폼에 맞는 클라이언트를 선택한 뒤 그래픽 인터페이스의 단계별 안내에 따라 설정하세요.
CONFIGURATION LEDGER
아래 항목은 클라이언트에서 실제로 수행하는 작업 경로를 보여줍니다. 왼쪽 항목을 선택하면 용도, 설정 방법, 적용 범위를 확인할 수 있습니다.
01 / SUBSCRIPTION INPUT
구독 가져오기는 서버에서 제공한 노드 목록을 클라이언트에 등록하는 기능입니다. 데스크톱에서는 보통 ‘구독 그룹’에 주소를 추가하고, Android에서는 오른쪽 상단 메뉴에서 구독 설정으로 이동합니다. 저장한 뒤 직접 업데이트해야 원격 내용을 읽어 서버 항목을 생성합니다. 구독은 설정의 출처일 뿐 연결 상태를 의미하지 않으므로, 업데이트 후에도 서버를 선택해 연결을 시작해야 합니다.
업데이트 결과가 비어 있다면 링크가 완전한지, 응답에 접근할 수 있는지, 클라이언트가 인코딩 형식을 인식하는지, 현재 클라이언트가 너무 오래되지 않았는지를 순서대로 확인하세요. 같은 주소를 반복해서 추가하면 중복 그룹이 생길 수 있습니다. 서비스를 바꿀 때는 기존 그룹을 먼저 비활성화한 뒤 새 주소를 추가하면 설정 출처와 이후 업데이트 결과를 구분하기 쉽습니다.
구독 가져오기 단계 보기 →02 / ROUTING RULES
라우팅 분할은 연결 진입점과 최종 아웃바운드 사이에서 작동합니다. 도메인, 대상 IP, 포트 또는 프로세스 이름에 따라 요청을 프록시 출구, 직접 연결 출구 또는 차단 출구로 보낼 수 있습니다. 먼저 클라이언트의 기본 규칙으로 기본 연결을 확인한 뒤, 로컬 네트워크·업무용 프로그램·개발 도구에 필요한 항목만 추가하는 방식이 일반적입니다. 규칙이 많다고 결과가 더 정확해지는 것은 아니며, 매칭 순서와 적용 범위가 더 중요합니다.
라우팅을 변경한 뒤에는 새 설정이 현재 코어 프로세스에 적용되도록 다시 연결해야 합니다. 특정 사이트의 출구가 예상과 다르면 먼저 적용된 규칙을 확인하고 도메인 해석 결과를 점검하세요. 브라우저 화면만으로 판단해서는 안 됩니다. 데스크톱과 Android의 메뉴 이름은 다를 수 있지만 핵심 흐름은 같습니다. 인바운드 트래픽이 먼저 규칙과 매칭되고, 매칭 결과에 따라 해당 아웃바운드에서 처리됩니다.
라우팅 및 프로토콜 참고 문서 보기 →03 / TRAFFIC MODE
시스템 프록시는 운영체제의 프록시 설정을 따르는 브라우저와 데스크톱 프로그램에 적합하며 설정이 간단하고 클라이언트를 종료한 뒤에도 복구하기 쉽습니다. 일부 프로그램이 시스템 프록시를 우회한다면 필요에 따라 TUN 모드를 사용할 수 있습니다. TUN은 가상 네트워크 카드와 시스템 라우팅 테이블로 더 넓은 범위의 트래픽을 처리합니다. 글로벌 모드는 일반적으로 매칭 가능한 모든 트래픽을 프록시 출구로 보내며, 규칙 모드는 라우팅 조건에 따라 직접 연결 또는 프록시를 선택합니다.
가장 좁은 적용 범위부터 모드를 선택하세요. 먼저 시스템 프록시로 충분한지 확인한 뒤 TUN을 고려하는 것이 좋습니다. TUN을 활성화하려면 시스템 권한이 필요할 수 있으며 다른 가상 네트워크 카드, 네트워크 필터 도구 또는 오래된 라우팅 테이블과 충돌할 수 있습니다. 인터넷이 끊기면 먼저 적용 모드를 끄고 시스템 프록시를 복구한 다음 가상 네트워크 카드와 DNS 설정을 점검하세요.
TUN 모드 원리 알아보기 →04 / PROTOCOL CORE
VMess, VLESS, Trojan, Shadowsocks, REALITY는 서로 다른 계층에 있으며, 클라이언트 인터페이스는 프로토콜 필드·전송 방식·보안 매개변수를 조합해 코어 설정을 만듭니다. 비슷해 보이는 용어를 임의로 바꿔 사용할 수 있는 선택지로 생각할 필요는 없습니다. 노드가 제공하는 유형 그대로 원래 매개변수를 가져오세요. 수동 입력 시에는 주소, 포트, 사용자 식별자, 전송 방식, 서버 이름, 지문 등의 필드를 특히 주의해서 확인해야 합니다.
v2rayNG는 일반적으로 Xray 코어를 사용하고, v2flyNG는 V2Fly 계열에 해당하며, v2rayN은 그래픽 인터페이스로 데스크톱 설정을 관리합니다. 코어마다 확장 필드와 신규 기능의 지원 시점이 다를 수 있습니다. 구독에 특정 확장 필드가 포함되어 있다면 화면 모양보다 해당 설정을 완전히 인식할 수 있는 클라이언트와 코어를 우선 선택하세요.
프로토콜 및 코어 설명 보기 →05 / CORE DIAGNOSTICS
클라이언트 연결이 실패했을 때 화면 메시지는 대개 최종 상태만 보여주지만, 코어 로그에는 포트 바인딩, 설정 해석, 인증서 핸드셰이크, 라우팅 초기화 등의 세부 정보가 남습니다. 문제 해결은 로그 끝부분만 보지 말고 이번 시작 이후 처음 나타난 오류부터 확인해야 합니다. 포트 사용 중, 설정 필드 오타, JSON 구조 오류, 시스템 시간 차이 등이 코어의 정상 시작이나 연결 수립을 방해할 수 있습니다.
오류 키워드를 먼저 기록한 뒤 한 번에 하나의 변수만 변경하고 다시 연결하면 여러 조작이 서로 영향을 주는 것을 막을 수 있습니다. 구독 업데이트는 정상인데 모든 서버를 사용할 수 없다면 ‘구독 읽기 실패’, ‘코어 시작 실패’, ‘대상 연결 실패’를 구분하세요. 세 문제는 발생 지점과 처리 경로가 다르므로 노드를 반복해서 바꾸는 것만으로 해결할 수 없습니다.
코어 로그 문제 해결 방법 보기 →PLATFORM DIRECTORY
플랫폼 링크는 해당 다운로드 분류로 이동하는 역할만 합니다. 구체적인 설치 패키지 유형, 프로세서 아키텍처, 시스템 요구 사항은 다운로드 페이지에 정리되어 있습니다.
데스크톱에서는 v2rayN을 사용합니다. 다운로드 페이지에는 최신 크로스플랫폼 데스크톱 인터페이스와 기존 WPF 인터페이스가 함께 제공되며, 시스템 프록시·라우팅 규칙·구독 그룹·TUN 적용이 필요한 환경에 적합합니다. 선택하기 전에 시스템 아키텍처와 실행 환경을 확인하세요.
다운로드 페이지로 이동v2rayN의 크로스플랫폼 데스크톱 인터페이스를 사용합니다. 다운로드할 때 Apple Silicon과 Intel 프로세서를 구분해야 하며 두 설치 패키지는 서로 바꿔 사용할 수 없습니다. 설치 후 가이드에 따라 구독을 가져오고 서버를 선택한 다음 소프트웨어가 요청하는 필요한 네트워크 권한을 허용하세요.
다운로드 페이지로 이동Xray 코어를 사용하는 v2rayNG를 우선 선택하고, V2Fly 코어가 필요하면 v2flyNG를 사용할 수 있습니다. 일반적인 기기는 arm64 아키텍처를 사용하며, 아키텍처를 확인하기 어려울 때만 범용 빌드를 고려하세요. 두 클라이언트의 구독 가져오기 방식은 비슷하지만 코어 확장 지원 범위에는 차이가 있습니다.
다운로드 페이지로 이동데스크톱에서는 v2rayN을 사용하고 배포판에 맞는 deb 또는 rpm 패키지를 선택하세요. 프로세서 아키텍처마다 빌드가 다르므로 설치 전에 시스템 아키텍처를 확인해야 합니다. 그래픽 인터페이스로 구독과 라우팅을 관리할 수 있지만 시스템 수준의 트래픽 적용은 배포판의 네트워크 설정과 함께 처리해야 합니다.
다운로드 페이지로 이동QUICK START SEQUENCE
먼저 가장 짧은 경로로 기본 설정을 완료한 뒤 고급 항목을 조정하세요. 이렇게 하면 설치, 구독, 라우팅 문제를 분리해 확인할 수 있습니다.
Windows, macOS, Linux에서는 v2rayN을 사용하고, Android에서는 v2rayNG를 우선 선택합니다. V2Fly 코어가 필요하면 v2flyNG를 사용하세요. 다운로드 전에 운영체제, 프로세서 아키텍처, 설치 패키지 유형을 확인해야 합니다. 처음 실행한 뒤에는 기본 라우팅과 기본 포트를 유지하고 여러 고급 설정을 동시에 변경하지 마세요. 시스템에서 네트워크 권한이나 가상 네트워크 카드 권한을 요청하면 용도를 먼저 이해한 후 현재 사용 모드에 맞게 처리하세요.
완전한 구독 링크를 복사해 클라이언트의 구독 관리 화면에서 새 그룹을 추가하세요. 이름은 로컬에서 구분하기 위한 용도이므로 서비스 출처나 사용 목적에 맞게 입력하면 됩니다. 저장 후 업데이트를 실행하고 서버 목록이 나타나는지 확인한 다음 항목 하나를 선택해 테스트하세요. 업데이트 후 아무 내용도 없다면 먼저 링크와 응답 형식을 확인해야 하며, 바로 프록시 모드를 바꿔서는 안 됩니다. 이 단계의 문제는 아직 설정 입력에 있습니다.
서버를 선택해 클라이언트를 시작한 뒤 시스템 프록시 또는 클라이언트 기본 모드로 기본 연결을 먼저 확인하세요. 연결이 성립한 후 소프트웨어의 적용 범위에 따라 규칙 분할이나 TUN 사용 여부를 결정합니다. 확인할 때는 클라이언트 상태와 코어 로그를 함께 살펴보세요. 코어가 시작되었다고 대상 연결까지 성공한 것은 아니며, 브라우저에서 접속된다고 모든 프로그램이 같은 출구를 사용하는 것도 아닙니다. 문제가 생기면 구독, 코어, 네트워크의 세 계층을 순서대로 점검하세요.
전체 가이드에서는 구독 업데이트, 서버 선택, 시스템 프록시, 라우팅 모드, TUN 권한, DNS 설정, 연결 확인을 다룹니다. 클라이언트마다 메뉴 위치는 다를 수 있지만 작업 순서는 동일합니다.
전체 가이드 보기OPEN SOURCE ECOSYSTEM
클라이언트, 코어, 프로토콜, 구독 형식은 서로 같은 개념이 아닙니다. 각 계층의 관계를 이해해야 설정 호환성과 기능 범위를 판단할 수 있습니다.
Project V는 프록시 프로토콜, 전송 계층, 보안 매개변수, 라우팅 시스템을 중심으로 오픈 소스 기술 생태계를 구축했습니다. 실제 사용에서는 그래픽 클라이언트를 접하는 경우가 많지만 연결, 설정 해석, 전송 수립, 라우팅 규칙 실행은 주로 코어가 담당합니다. 클라이언트는 구독 관리, 서버 선택, 시스템 프록시, 로그 확인을 조작 가능한 화면으로 구성한 뒤 그 결과를 코어가 읽을 수 있는 설정으로 변환합니다.
이러한 계층 분리 때문에 화면이 비슷한 클라이언트라도 다른 코어를 사용할 수 있으며, 같은 기본 설정도 확장 필드 차이로 호환성 문제가 생길 수 있습니다. 문제를 해결할 때는 먼저 실패 계층을 확인해야 합니다. 클라이언트가 설정을 저장하는지, 구독이 항목을 생성하는지, 코어가 설정을 해석하는지, 연결이 핸드셰이크를 완료하는지, 라우팅 규칙이 매칭되는지를 단계별로 확인하세요. 이 과정을 섞으면 설정 오류를 회선 문제로 잘못 판단하기 쉽습니다.
V2Fly는 Project V 생태계의 핵심 기능을 이어받아 프로토콜 구현, 전송 조합, 라우팅, 크로스플랫폼 실행에 중점을 둡니다. Xray는 유사한 설정 체계에서 발전하며 일부 프로토콜 기능, 전송 옵션, 보안 매개변수를 확장했습니다. 두 코어는 기본 필드 상당 부분이 비슷하지만 모든 확장 기능을 그대로 호환하지는 않습니다. 특히 구독에 최신 필드가 포함된 경우 클라이언트가 사용하는 코어와 지원 범위가 가져오기 결과에 직접 영향을 줍니다.
코어는 이름만 보고 선택해서는 안 됩니다. 서버에서 프로토콜 유형과 설정 요구 사항을 명확히 제시했다면 해당 필드를 완전히 인식할 수 있는 클라이언트를 사용하세요. Xray 코어를 사용하는 v2rayNG는 일반적인 Android 설정에 적합하고, v2flyNG는 V2Fly 계열이 필요한 사용자에게 대안이 됩니다. 데스크톱 v2rayN은 여러 코어 관련 설정과 시스템 프록시 기능을 하나의 화면에서 관리하지만, 실제 사용 가능한 항목은 현재 빌드에 포함된 구성 요소에 따라 달라집니다.
v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 클라이언트입니다. 오픈 소스 라이선스는 소스 코드의 사용, 수정, 재배포 범위를 정하고 프로토콜 구현, 설정 변환, 화면 동작을 공개적으로 논의할 수 있게 합니다. 오픈 소스라고 해서 모든 빌드의 기능이 동일한 것은 아닙니다. 클라이언트 출시 주기, 의존 구성 요소, 코어 업데이트 시점이 다를 수 있으므로 새 프로토콜 필드를 인식하지 못한다면 먼저 클라이언트 유형과 출시 시점을 확인하세요.
커뮤니티 유지 관리는 보통 버그 수정, 시스템 호환성, 코어 업그레이드, 설정 형식 변경을 중심으로 이루어집니다. 새 빌드에서는 필드 지원이 추가되거나 메뉴 위치와 기본값이 변경될 수 있습니다. 업그레이드 전 현재 구독 그룹과 주요 라우팅 설정을 기록하고, 업그레이드 후 기본 연결을 확인한 다음 복잡한 규칙을 복원하세요. 출처가 불분명하고 오래된 설정을 계속 사용하면 문제 해결 비용이 커집니다. 현재 클라이언트가 지원하는 필드에 맞춰 설정을 다시 정리하는 편이 유지 관리에 유리합니다.
구독 링크는 설정을 배포하는 진입점이며, 응답 내용은 단일 링크 모음, 인코딩된 텍스트, 구조화된 설정일 수 있습니다. 클라이언트는 먼저 응답을 가져온 다음 지원하는 형식으로 해석해 서버 항목을 만듭니다. 링크에 접근할 수 있지만 목록이 비어 있다면 응답 형식, 인코딩 방식, 필드 지원 범위가 서로 맞지 않을 가능성이 큽니다. 목록은 정상인데 연결되지 않는다면 코어 시작 상태와 대상 매개변수를 계속 확인해야 합니다. 구독 업데이트는 수동으로 덮어쓴 잘못된 설정을 자동으로 고치지 않으며 라우팅 모드를 대신 결정하지도 않습니다.
구독 그룹, 클라이언트 설정, 코어 로그를 분리해 관리하면 실수를 줄일 수 있습니다. 구독은 노드 매개변수를 제공하고, 클라이언트는 로컬 진입점과 화면 상태를 관리하며, 라우팅은 트래픽 출구를 결정하고, 로그는 실행 결과를 기록합니다. 네 요소는 각각 명확한 역할을 맡습니다. 기기를 옮길 때는 새 기기에서 먼저 독립적으로 가져오기와 확인을 완료한 뒤 기존 기기 설정을 중지해야 이전 환경의 포트나 권한 문제까지 함께 옮기는 일을 피할 수 있습니다.
LATEST TECH NOTES
클라이언트 기능을 실제 작업 경로에 따라 나누어 설명합니다. 날짜는 문서 게시 순서를 나타내며 클라이언트 빌드 시점을 의미하지 않습니다.
ICMP 도달 가능성, 전체 프록시 핸드셰이크, 대역폭 테스트를 구분하고 세 결과가 자주 일치하지 않는 이유와 클라이언트 속도 측정 결과를 읽는 방법을 설명합니다.
문서 읽기 →v2rayN과 v2rayNG에서 코어 로그를 열고 포트 사용 중, 설정 문법, 필드 오타, 인증서 문제를 확인하는 방법을 안내합니다.
문서 읽기 →링크 만료, 주소 오류, 인코딩 불일치, 오래된 클라이언트, 네트워크 접근 문제, 빈 응답 내용을 순서대로 확인하세요.
문서 읽기 →