vmess:// · vless://trojan:// · ss://v2rayN은 클립보드에서 공유 링크를 여러 개 가져올 수 있으며, v2rayNG에서도 클립보드와 QR 코드로 가져올 수 있습니다. 가져온 뒤 프로토콜, 주소, 포트, 전송 방식을 확인하고 TLS, SNI 등의 항목도 살펴보세요. VMess, VLESS, Trojan, Shadowsocks는 설정 항목이 서로 달라 프로토콜 이름만 바꿔 설정을 재사용할 수 없습니다. 새 전송 옵션 지원 여부는 클라이언트에 포함된 코어에 따라 다릅니다. 인식할 수 없는 매개변수가 있다면 항목을 임의로 삭제해 저장하지 말고 호환성 안내를 확인하세요. 구독 주소는 구독 그룹에 등록한 뒤 업데이트해야 합니다.
IPIfNonMatchgeosite:category-ads-all → blockgeoip:private → direct라우팅을 설정하면 목적지에 따라 직접 연결, 프록시 또는 차단을 적용할 수 있습니다. v2rayN에서는 도메인, IP, 포트를 기준으로 규칙을 구성할 수 있습니다. geosite, geoip 항목을 사용하려면 해당 규칙 데이터가 필요합니다. 일반적으로 구체적인 예외 규칙을 먼저 두고 범위가 넓은 규칙을 뒤에 배치해야 앞선 포괄 규칙이 이후 설정을 가리지 않습니다. 도메인 전략은 도메인을 언제 해석할지 결정하는 설정이며 DNS 서버 주소와는 다릅니다. v2rayNG의 기본 라우팅과 사용자 지정 규칙 메뉴는 다를 수 있으므로 설정을 옮길 때 실제로 생성된 규칙을 확인하세요. 모드 이름만으로 두 클라이언트의 동작이 같다고 볼 수 없습니다.
127.0.0.1:10808127.0.0.1:10809시스템 프록시는 운영체제의 프록시 설정을 변경하지만, 해당 설정을 사용할지는 앱에 따라 다릅니다. v2rayN의 TUN 모드는 가상 네트워크 인터페이스로 트래픽을 연결하며, 지원 여부는 플랫폼과 권한, 관련 구성 요소에 따라 달라집니다. 단순한 전체 프록시 스위치가 아닙니다. 먼저 시스템 프록시로 기본 연결을 확인한 다음 필요에 따라 TUN을 활성화하세요. 라우팅과 DNS를 동시에 변경하면 문제 원인을 찾기 어려워질 수 있습니다. Android의 v2rayNG는 보통 시스템 VPN 권한을 통해 트래픽을 연결합니다. 데스크톱 TUN과 메뉴, 권한, 앱별 설정 방식이 다르므로 그대로 적용하지 마세요.
구독 그룹은 설정 출처를 구분하고 개별 업데이트와 필터링을 쉽게 해줍니다. v2rayN의 구독 그룹 설정에서 주소와 메모를 입력할 수 있습니다. 업데이트한 뒤에는 현재 활성 설정이 여전히 유효한지 다시 확인하세요. 구독 내용은 주소 제공자가 관리하므로 업데이트 과정에서 그룹 내 항목이 바뀔 수 있습니다. 장기간 수정해 사용할 설정은 로컬 항목으로 따로 저장하는 편이 좋습니다. v2rayNG와 v2flyNG는 그룹 화면과 지원하는 구독 형식이 다를 수 있으므로, 가져오기 전에 내용이 줄별 공유 링크인지 기본 JSON인지 확인하세요. 구독 주소에 접근 정보가 포함될 수 있으니 스크린샷, 공개 로그, 온라인 변환 도구에 노출하지 마세요.
Xray / v2flyv2rayNGv2flyNG그래픽 클라이언트와 프록시 코어는 서로 다른 구성 요소입니다. v2rayN에서 선택할 수 있는 Core 유형은 배포 패키지와 프로토콜 지원에 따라 달라집니다. 전환하기 전에 대상 코어가 전체 설정을 처리할 수 있는지 확인하세요. Xray와 V2Fly는 기술적 기반을 일부 공유하지만 이후 기능과 설정 항목은 별도로 발전해 완전히 호환되지 않습니다. Android에서는 v2rayNG가 Xray 생태계에 중점을 두며, v2flyNG는 V2Fly 코어를 선택할 수 있는 대안입니다. REALITY 같은 기능은 클라이언트에 실제로 통합된 코어의 지원 여부를 확인해야 합니다. 기존 설정이 안정적으로 작동한다면 코어 이름이 다르다는 이유만으로 옮길 필요는 없습니다.
DOWNLOAD BY PLATFORM
데스크톱에서는 v2rayN을 사용하고, Android에서는 v2rayNG를 먼저 확인하세요. 코어 요구 사항에 따라 v2flyNG를 선택할 수도 있습니다. 설치 패키지 형식과 프로세서 아키텍처는 다운로드 페이지에서 확인할 수 있습니다.
v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 데스크톱 사용 방식을 유지합니다. 익숙한 사용 환경이 있다면 각 인터페이스 안내를 먼저 읽고 설치할 버전을 선택하세요.
처음 실행한 뒤에는 코어가 정상적으로 시작되는지 확인하고 설정을 가져오세요. 로컬 수신 포트를 다른 앱에서 사용 중이라면 포트를 변경하고 앱의 프록시 설정도 함께 맞추세요. 반복해서 재설치할 필요는 없습니다. 두 인터페이스 버전이 있다고 해서 클라이언트 두 개를 동시에 실행할 필요는 없습니다.
다운로드 페이지로 이동v2rayN은 Apple Silicon과 Intel용 설치 파일을 구분해 제공합니다. 시스템의 ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인한 뒤 해당 아키텍처를 선택하세요. 익숙하지 않은 파일명 약어만 보고 판단하지 마세요.
설치 후 앱이 정상적으로 열리는지 확인하고 필요한 네트워크 권한을 허용하세요. 시스템 프록시와 TUN은 트래픽을 연결하는 방식이 달라 필요한 권한도 다를 수 있습니다. 브라우저에서는 연결되지만 다른 앱에서 되지 않는다면 먼저 해당 앱이 시스템 프록시를 사용하는지 확인하세요.
다운로드 페이지로 이동v2rayNG는 Xray 코어를 사용하며, v2flyNG는 V2Fly 코어를 선택할 수 있는 대안입니다. 비교적 최신 기기는 대체로 arm64에 해당합니다. 기기 아키텍처를 모르면 기기 정보를 확인하거나 범용 패키지를 선택하고, 설치 페이지의 시스템 요구 사항을 기준으로 판단하세요.
연결하려면 시스템 VPN 권한을 허용해야 합니다. 백그라운드로 전환한 뒤 연결이 끊기면 배터리 최적화, 백그라운드 실행, 제조사별 절전 정책을 확인하세요. 앱별 프록시로 프록시 경로를 사용할 앱을 지정할 수 있습니다. 설정을 바꾼 뒤에는 다시 연결해 실제 동작을 확인하세요.
다운로드 페이지로 이동v2rayN은 deb 및 rpm 패키지를 제공하며 x64와 arm64 아키텍처로 구분됩니다. 설치 형식은 배포판의 패키지 관리 체계에 맞춰야 하고, 프로세서 아키텍처도 시스템 정보와 일치해야 합니다. 두 조건을 모두 확인하세요.
그래픽 데스크톱의 시스템 프록시가 터미널 프로그램까지 적용되는 것은 아닙니다. 특정 앱에 프록시를 설정하려면 로컬 수신 주소와 포트를 확인하세요. TUN을 사용하기 전에 현재 배포 패키지의 권한 및 구성 요소 요구 사항을 살펴보세요. 문제가 생기면 코어 로그와 포트 사용 상태부터 확인하세요.
다운로드 페이지로 이동다운로드 페이지에서 현재 설치 파일과 시스템 요구 사항을 확인할 수 있습니다. 오래된 정보가 설치 결정에 영향을 주지 않도록 홈페이지에는 특정 배포 버전을 고정해 표시하지 않습니다.
QUICK START
클라이언트는 설정을 읽고 실행합니다. 설치만으로 연결을 사용할 수 있는 것은 아니며 유효한 공유 링크, 구독 주소 또는 완전한 설정이 필요합니다. 먼저 기본 절차를 확인한 다음 라우팅과 자동화 설정을 추가하세요.
공유 링크 전체를 복사한 뒤 v2rayN에서 클립보드 가져오기를 선택하세요. 구독 주소가 있다면 구독 그룹 설정에서 주소와 메모를 입력하고 업데이트하세요. 두 방식은 서로 바꿔 쓸 수 없습니다. 구독 주소는 설정 모음을 가져오고, 공유 링크는 단일 설정을 나타냅니다. 가져온 뒤 목록에 항목이 나타났다는 것만으로 설정이 완전하다고 판단하지 말고 프로토콜, 서버 주소, 포트, 전송 방식, TLS 관련 옵션을 확인하세요.
v2rayNG에서는 보통 설정 추가 또는 구독 설정 메뉴에서 가져올 수 있습니다. 복사한 내용에 설명 문구가 섞이거나 줄바꿈으로 잘리지 않았는지 확인하세요. QR 코드로 가져온 경우에도 편집 화면을 열어 각 항목을 다시 살펴보세요. 공유 링크와 구독 주소에 연결 정보가 포함될 수 있으므로, 문제를 확인할 때 필요한 항목만 표시하고 민감한 내용은 가리세요.
사용할 설정을 활성화한 뒤 연결을 시작하세요. 데스크톱에서는 먼저 시스템 프록시 자동 설정을 선택하고, 시스템 프록시를 따르는 브라우저로 테스트할 수 있습니다. Android에서는 안내에 따라 VPN 연결을 허용하세요. 라우팅 규칙은 트래픽이 어느 아웃바운드로 향할지 정하고, 시스템 프록시나 TUN은 트래픽이 클라이언트에 어떻게 들어올지 결정합니다. 서로 다른 단계의 설정입니다.
처음 테스트할 때는 기본 설정을 가능한 한 유지하고 여러 프록시 프로그램을 동시에 켜지 마세요. TUN, 앱별 프록시, 사용자 지정 DNS가 필요하다면 한 번에 한 종류만 변경하고 결과를 기록하세요. 그러면 설정 자체의 문제와 트래픽 연결 문제를 구분하기 쉽고, 실패했을 때 정상 작동하던 상태로 되돌리기도 편합니다.
프록시를 사용할 앱을 열어 페이지나 서비스에 실제로 접속되는지 확인하고 클라이언트 로그도 살펴보세요. 목록의 테스트 결과는 특정 테스트 방식만 반영하므로 모든 앱이 연결된다는 뜻은 아닙니다. 브라우저에서 성공해도 터미널이나 다른 프로그램이 같은 프록시를 사용한다고 볼 수 없습니다. 평소 사용할 앱을 각각 확인하세요.
TLS 핸드셰이크 오류가 발생하면 기기 시간, SNI, 인증서 관련 설정부터 확인하세요. 이름 해석에 실패한다면 DNS와 라우팅 전략을 살펴보세요. 연결 로그가 전혀 없다면 시스템 프록시, 로컬 포트, 앱 자체의 프록시 설정을 확인하세요. 인증서 검증은 켜 둬야 하며, 검증을 건너뛰는 방법을 장기적인 해결책으로 사용하지 마세요. 자세한 절차와 상황별 점검 방법은 전체 가이드에서 확인하세요.
PROJECT V ECOSYSTEM
기능을 비교하기 전에 인터페이스, 코어, 프로토콜을 구분하세요. 클라이언트 이름이 비슷해도 설정을 그대로 서로 바꿔 사용할 수 있는 것은 아닙니다. 실제로 사용할 프로토콜, 전송 방식, 운영체제 환경을 기준으로 선택하세요.
프로토콜·전송·라우팅·아웃바운드를 모듈별로 구성하는 방식
V2Ray 코어를 이어받아 커뮤니티에서 유지 관리합니다. v2flyNG는 Android용 그래픽 인터페이스를 제공하며, v2rayN에서 선택할 수 있는 코어는 실제 배포 패키지와 기능 지원에 따라 다릅니다.
공통 기술 기반에서 독립적인 기능과 설정 지원으로 발전했습니다. v2rayNG는 Xray 코어를 사용하며, REALITY 같은 기능은 코어 지원 여부를 확인해야 합니다.
Project V 기술 체계는 인바운드, 라우팅, 아웃바운드를 분리해 구성합니다. V2Ray 코어는 로컬 트래픽을 받아 규칙을 적용하고 원격 서버에 연결합니다. 그래픽 클라이언트는 설정 편집, 구독 관리, 로그 확인, 시스템 연동 기능을 사용하기 쉬운 인터페이스로 제공합니다. 따라서 다운로드한 v2rayN이나 v2rayNG는 단순한 프로토콜 이름이 아니라 코어를 관리하는 도구이기도 합니다.
문제를 확인할 때도 이 두 계층을 구분해야 합니다. 인터페이스가 정상적으로 열려도 코어가 시작된 것은 아니며, 코어가 시작되어도 대상 앱의 트래픽이 코어로 전달된다는 보장은 없습니다. 먼저 로그에서 시작 오류가 있는지 확인하고, 그다음 프록시 연결 방식과 활성 설정을 살펴보세요. 프로토콜을 계속 바꾸는 것보다 원인을 찾기 쉽습니다. 사이트의 용어 가이드에서 낯선 설정 항목을 확인할 수 있습니다.
V2Fly와 Xray는 공통된 역사적 기반과 일부 프로토콜 및 설정 방식을 공유하지만, 각각 별도로 개발되고 있습니다. 프로토콜 지원, 전송 옵션, DNS 동작, 새 설정 항목에 차이가 있을 수 있습니다. JSON을 사용한다는 이유만으로 기본 설정 파일을 코어 간에 그대로 사용할 수 있다고 보면 안 됩니다. 그래픽 클라이언트가 가져오기 매개변수를 변환하는 방식에도 구현상 한계가 있습니다.
VMess, VLESS, Trojan, Shadowsocks는 프로토콜 선택지이며 TLS, REALITY, 구체적인 전송 방식은 별도의 계층에 해당합니다. REALITY는 VMess를 대신해 임의로 선택할 수 있는 독립 프록시 프로토콜이 아닙니다. 일반적으로 이를 지원하는 코어와 해당 프로토콜을 함께 사용해야 합니다. 서버가 제공하는 설정에 맞는 기능을 클라이언트가 지원해야 하므로, 이름이 더 최신인지보다 호환성을 기준으로 선택하세요.
v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 그래픽 클라이언트이며, 소스 코드와 라이선스를 바탕으로 개발과 사용이 이루어집니다. v2rayN은 데스크톱 사용자를 위한 설정 관리와 시스템 연동에 중점을 둡니다. v2rayNG는 Android에서 Xray 코어와 시스템 VPN 인터페이스를 연결하며, v2flyNG는 V2Fly 코어를 사용하려는 Android 사용자에게 다른 선택지를 제공합니다.
오픈 소스라고 해서 세 클라이언트의 기능이 모두 같거나 서로의 로컬 데이터를 전부 읽을 수 있는 것은 아닙니다. 다른 클라이언트로 옮길 때는 양쪽에서 지원하는 공유 링크 또는 구독 형식을 우선 사용한 뒤 라우팅, DNS, 앱별 프록시, 백그라운드 권한을 다시 확인하세요. 재배포하거나 수정할 때는 클라이언트와 포함된 구성 요소의 라이선스를 각각 확인해야 합니다. 전체 생태계가 하나의 라이선스를 따르는 것은 아닙니다.
클라이언트 인터페이스, 코어, 규칙 데이터는 각각 변경될 수 있습니다. 인터페이스 업데이트는 메뉴 위치나 가져오기 동작을 바꿀 수 있고, 코어 업데이트는 프로토콜 기능을 추가하거나 설정 요구 사항을 변경할 수 있습니다. geosite, geoip 등의 규칙 데이터가 바뀌면 같은 규칙의 매칭 범위도 달라질 수 있습니다. 업데이트 전후 동작이 달라졌다면 먼저 어느 계층이 바뀌었는지 확인한 뒤 설정을 수정하세요.
업데이트 전에 필요한 로컬 설정과 사용자 지정 규칙을 보관하고, 릴리스 노트에서 시스템 요구 사항과 호환성 안내를 확인하세요. 구독 업데이트는 구독 제공자가 관리하는 설정을 갱신할 뿐, 클라이언트나 코어를 업데이트하지 않습니다. 안정적으로 작동하는 설정은 목적에 맞게 관리하세요. 클라이언트, 코어, 구독, 라우팅을 한꺼번에 바꾼 뒤 원인을 찾으려 하지 마세요. 더 자세한 프로토콜 비교는 프로토콜 및 코어 기술 참고 자료에서 확인할 수 있습니다.
CONFIGURATION NOTES
구체적인 오류와 설정 문제부터 살펴보세요. 각 글은 프로토콜 항목, 클라이언트 옵션, 시스템 동작을 나눠 설명하므로 모든 연결 문제를 하나의 스위치로 설명하지 않습니다.
주요 구독 형식의 구조와 지원 클라이언트를 설명합니다. Base64 구독을 줄별 공유 링크로 디코딩하는 방법, 공유 링크와 기본 JSON 설정의 대응 관계, 가져오기 실패를 일으키는 형식 문제를 알아봅니다.
글 읽기 →DNS 누수가 발생하는 원인과 확인 방법을 설명하고, v2rayN의 원격 DNS, 도메인 전략, TUN 모드를 단계별로 설정합니다. v2rayNG에서 확인할 항목도 정리했습니다.
글 읽기 →TLS 및 인증서 오류의 주요 원인을 정리합니다. 기기 시간 불일치, SNI와 위장 도메인의 불일치, 핑거프린트 설정 문제를 살펴보고 인증서 검증을 장기간 건너뛰면 안 되는 이유를 설명합니다.
글 읽기 →