데스크톱은 v2rayN, Android는 v2rayNG를 선택하세요. 구독 가져오기부터 라우팅까지 설정 항목별로 안내합니다.
GUI는 설정을 관리하고, 코어는 연결과 규칙을 처리합니다. 지원 프로토콜은 실제 코어에 따라 달라집니다.
세 클라이언트는 모두 오픈 소스 프로젝트입니다. 코어와 의존성에는 각각 별도의 라이선스가 적용됩니다.
서버 매개변수에 맞춰 가져오고, 이름만 보고 프로토콜을 바꾸지 마세요.
먼저 세 가지 단계를 구분하세요. 구독은 연결 매개변수를 제공하고, 프록시 모드는 어떤 앱의 트래픽을 클라이언트로 보낼지 정하며, 라우팅은 전달된 요청의 경로를 결정합니다. 연결에 문제가 생기면 이 순서대로 확인하는 편이 여러 설정을 한꺼번에 바꾸는 것보다 원인을 찾기 쉽습니다. 아래 화면은 설정을 설명하기 위한 예시이며 실제 연결 상태를 나타내지 않습니다.
구독 주소는 여러 연결 설정을 가져오는 데 사용하며, 개별 노드 공유 링크와는 다릅니다. v2rayN에서는 구독 그룹 설정을 열어 이름과 주소를 입력하고 저장한 뒤 구독을 업데이트하세요. v2rayNG에서는 사이드 메뉴에서 구독 그룹을 관리합니다. 클라이언트는 보통 주소만 저장하며, 저장하는 즉시 모든 노드를 가져오지는 않습니다. 처음 가져온 뒤에는 업데이트 결과를 확인하고 노드를 선택해 연결을 테스트하세요. 노드를 하나씩 직접 입력하는 것보다 그룹을 사용하면 출처를 구분하고 설정을 새로고침하기 편리합니다. 업데이트만으로 서버 계정이나 요금제의 유효성이 확인되는 것은 아닙니다.
시스템 프록시는 시스템 설정을 따르는 앱에 로컬 프록시 연결을 제공하므로, 먼저 브라우저 연결을 확인할 때 유용합니다. v2rayN에서 시스템 프록시를 자동 설정하면 시스템 프록시 설정이 변경되고, 시스템 프록시를 해제하면 해당 연결 설정이 취소됩니다. 다른 앱에서 로컬 포트를 직접 지정하는 경우에는 시스템 프록시를 변경하지 않는 옵션을 사용할 수 있습니다. 일부 앱은 시스템 프록시를 무시하므로 브라우저는 연결되지만 다른 프로그램은 연결되지 않을 수 있습니다. 이것만으로 노드가 작동하지 않는다고 단정할 수는 없습니다. 먼저 연결 방식을 하나로 정한 뒤, 앱이 클라이언트에 트래픽을 전달하지 않는 문제인지, 전달된 트래픽이 라우팅 규칙에 따라 다른 출구로 분배되는 문제인지 확인하세요.
라우팅 규칙은 요청을 프록시로 보낼지, 직접 연결할지, 차단할지 결정합니다. 일반적으로 로컬 네트워크 주소와 특정 도메인은 직접 연결하고 나머지 트래픽은 기본 출구로 처리합니다. 규칙은 순서대로 적용되므로 범위가 넓은 규칙이 앞에 있으면 뒤에 있는 세부 규칙이 적용되지 않을 수 있습니다. 수정하기 전에 설정을 백업하고 출구 태그가 실제로 정의되어 있는지 확인하세요. 도메인 및 IP 분류 규칙에는 관련 데이터 파일도 필요합니다. 오른쪽 예시는 라우팅 설정 일부일 뿐, 그대로 실행할 수 있는 전체 설정이 아닙니다. 기존 인바운드·아웃바운드 및 DNS 설정과 함께 확인해야 합니다.
{
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
},
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}TUN은 가상 네트워크 인터페이스로 트래픽을 받아 시스템 프록시를 따르지 않는 앱에 사용할 수 있습니다. 트래픽이 클라이언트로 들어오는 방식이 바뀌는 것이며, 모든 요청이 자동으로 프록시를 거치는 것은 아닙니다. 실제 출구는 라우팅 규칙에 따라 결정됩니다. 데스크톱에서는 관리자 권한이나 네트워크 구성 요소가 필요할 수 있고, Android에서는 시스템 VPN 권한을 요청합니다. 먼저 기본 모드에서 노드 연결을 확인한 다음 TUN을 별도로 켜세요. 다른 네트워크 트래픽 처리 도구를 함께 사용한다면 라우팅과 DNS 설정이 서로 덮어쓰지 않도록 하나를 먼저 중지하세요.
코어는 연결 프로토콜과 전송 방식, 라우팅을 처리하고 클라이언트는 설정을 가져오고 관리하는 인터페이스를 제공합니다. v2rayN은 여러 코어를 설정할 수 있지만, 선택 가능한 항목은 배포 패키지에 따라 다릅니다. v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용합니다. 인터페이스와 링크 형식이 비슷해도 기능이 완전히 같다는 뜻은 아닙니다. 특히 새로운 프로토콜 매개변수와 보안 전송 조합은 차이가 날 수 있습니다. 인식할 수 없는 필드가 있으면 매개변수를 무작정 삭제해 저장하기 전에 클라이언트와 코어의 지원 범위를 확인하세요. 코어를 바꾼 뒤에는 연결 및 라우팅 동작도 다시 점검해야 합니다.
먼저 운영체제를 확인하고 프로세서 아키텍처를 선택하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 고려하고 V2Fly 코어가 필요하면 v2flyNG를 선택할 수 있습니다. 설치 패키지 형식과 노드 프로토콜은 별개입니다. 패키지 형식은 기기에서 실행 가능한지를, 프로토콜은 클라이언트가 서버의 연결 설정을 사용할 수 있는지를 결정합니다.
Desktop 데스크톱 버전과 클래식 WPF 버전을 제공합니다. Desktop은 차세대 크로스 플랫폼 인터페이스를 사용하고, WPF는 기존 데스크톱 사용 방식을 유지합니다. 시스템 요구 사항과 사용 환경에 맞춰 하나를 선택하면 되며 두 버전을 모두 설치할 필요는 없습니다. 처음 실행할 때 의존성 안내가 나타나면 해당 릴리스 안내에 따라 런타임을 설치하세요. 실행 환경이 없는 문제를 노드 문제로 오해하지 마세요.
압축을 풀거나 설치한 뒤 메인 창이 정상적으로 열리는지 확인하고 구독을 가져오세요. 시스템 프록시를 켠 다음 브라우저로 접속을 확인할 수 있습니다. 특정 앱만 프록시를 사용하게 하려면 앱 설정에 클라이언트에 표시된 로컬 수신 주소와 포트를 입력하세요.
칩에 맞춰 Apple Silicon 또는 Intel 설치 패키지를 선택하세요. ‘이 Mac에 관하여’에서 확인할 수 있습니다. 프로세서 아키텍처와 운영체제 버전 모두 릴리스 요구 사항을 충족해야 합니다. 처음 실행할 때 시스템 보안 경고가 표시되면 파일 출처를 확인하고 시스템에서 제공하는 보안 설정에 따라 처리하세요. 클라이언트를 실행하기 위해 전반적인 보안 설정을 계속 낮추는 것은 권장하지 않습니다.
시스템 프록시와 TUN은 권한을 부여하는 방식이 다릅니다. 먼저 기본 프록시 설정으로 연결을 확인하세요. 네트워크를 바꾸거나 절전 모드에서 복귀한 뒤 일부 앱만 연결되지 않으면 프록시 진입점과 DNS 상태를 확인한 후 서비스를 다시 시작할지 결정하세요.
v2rayNG는 Xray 코어를 사용하고 v2flyNG는 V2Fly 코어를 대안으로 제공합니다. 비교적 최신 기기에서는 일반적으로 arm64를 선택하세요. 기기 아키텍처를 확인하기 어렵다면 범용 패키지 안내를 살펴볼 수 있습니다. 범용 패키지는 설치 아키텍처 호환성을 위한 것이며 전용 패키지보다 연결 속도가 빠르다는 뜻은 아닙니다. 두 앱은 설정을 별도로 저장하므로 클라이언트를 바꾼 뒤에는 구독과 라우팅을 다시 확인하세요.
처음 연결할 때 시스템 VPN 요청을 승인해야 합니다. 백그라운드 연결이 자주 끊기면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 다른 VPN 앱이 실행 중이라면 먼저 연결을 중지한 뒤 현재 클라이언트를 시작해 시스템 트래픽 제어 권한이 충돌하지 않도록 하세요.
배포판의 패키지 체계에 따라 deb 또는 rpm을 선택한 다음 x64와 arm64를 구분하세요. 패키지 확장자만으로 모든 배포판에서 바로 설치할 수 있는 것은 아니므로 시스템 의존성과 데스크톱 환경도 확인해야 합니다. GUI 클라이언트로 구독, 노드, 라우팅을 관리할 수 있어 처음부터 코어 설정 파일 전체를 직접 작성할 필요는 없습니다.
데스크톱 환경마다 시스템 프록시를 읽는 방식이 다를 수 있고, 터미널 프로그램은 데스크톱 프록시 설정을 사용하지 않을 수도 있습니다. 브라우저는 연결되지만 터미널이 연결되지 않으면 먼저 프로그램 자체의 프록시 설정을 확인하세요. 트래픽을 직접 처리해야 하는 경우에만 TUN과 필요한 권한을 설정하세요.
전체 클라이언트 보기 →다운로드 페이지에서 설치 파일, 아키텍처 선택 및 시스템 요구 사항을 확인할 수 있습니다.
설정 가져오기 → 연결 방식 확인 → 라우팅 검증
클라이언트는 준비된 연결 설정을 사용하는 도구이며, 바로 쓸 수 있는 원격 서비스를 제공하지 않습니다. 유효한 구독 주소나 노드 공유 링크를 준비한 뒤 아래 절차를 진행하세요. 매개변수는 신뢰할 수 있는 출처에서 받아야 합니다. 서버 주소만 있고 인증 및 전송 설정이 없다면 클라이언트가 자동으로 나머지를 채울 수 없습니다.
v2rayN에서는 구독 그룹 설정에 주소를 저장한 뒤 구독 메뉴에서 업데이트하세요. v2rayNG에서는 사이드 메뉴에서 구독 그룹 설정으로 이동한 뒤 목록으로 돌아와 구독을 업데이트합니다. 개별 공유 링크는 클립보드 가져오기나 QR 코드 스캔 메뉴를 사용하고 구독 주소 입력란에 넣지 마세요. 가져온 뒤에는 프로토콜 유형과 전송 매개변수가 모두 있는지 확인하고 노드 하나를 선택해 연결하세요.
목록이 계속 비어 있으면 업데이트 로그를 확인해 주소에 접근할 수 없는 문제인지, 응답 내용을 인식하지 못하는지, 구독이 만료됐는지 구분하세요. 같은 그룹을 반복해서 새로 만들어도 보통 해결되지 않습니다. 그룹을 정리할 때 출처를 알아보기 쉽게 기록하되 구독 주소를 공개적인 문의 글에 복사하지 마세요.
데스크톱에서는 시스템 설정을 따르는 브라우저가 클라이언트에 연결되도록 시스템 프록시 자동 설정을 먼저 사용할 수 있습니다. Android에서는 연결을 누른 뒤 시스템 안내에 따라 VPN 요청을 승인하세요. 이 단계에서는 기본 라우팅을 유지하고 여러 트래픽 처리 도구를 동시에 켜지 마세요. 클라이언트 시작 오류가 표시되면 원격 연결을 확인하기 전에 로컬 포트 충돌, 권한 또는 매개변수 오류부터 해결하세요.
‘전역 라우팅’과 ‘시스템 프록시’는 서로 다른 설정입니다. 전자는 클라이언트로 들어온 트래픽의 출구를, 후자는 앱이 요청을 클라이언트로 전달할지를 결정합니다. 라우팅만 바꿔서는 시스템 프록시를 무시하는 앱이 자동으로 연결되지 않습니다. 이 차이를 이해한 뒤 TUN이 필요한지 판단하세요.
대상 웹사이트를 열어 페이지가 로드되는지 확인한 뒤 클라이언트 로그에서 연결 오류를 살펴보세요. 지연 시간 테스트는 참고 정보일 뿐 웹페이지, 동영상 또는 특정 앱이 반드시 작동한다는 뜻은 아닙니다. 브라우저는 정상인데 특정 앱만 실패하면 해당 앱이 프록시를 사용하는지 먼저 확인하세요. 모두 연결되지 않으면 노드 매개변수, 시스템 시간, 구독 상태, DNS를 점검하세요.
기본 연결을 확인한 다음 라우팅 규칙을 하나씩 추가하고, 변경할 때마다 대상 사이트와 로컬 네트워크 접속을 확인하세요. 사용을 마칠 때는 데스크톱에서 시스템 프록시가 해제됐는지, Android에서 VPN 연결이 중지됐는지 확인하세요. 정상 작동한 설정 조합을 기록해 두면 다음에 노드를 바꿀 때 문제를 더 쉽게 찾을 수 있습니다.
전체 가이드 보기 →릴리스 종류에 따라 메뉴 위치가 다를 수 있으니 실제 화면을 기준으로 확인하세요.
클라이언트, 코어, 프로토콜, 구독은 서로 다른 계층에 속합니다. 클라이언트 다운로드는 로컬 설정 인터페이스를 마련하고, 코어는 연결을 처리하며, 프로토콜은 통신 방식을 정의하고, 구독은 설정을 배포합니다. 이 관계를 이해하면 앱을 업데이트해야 하는지, 규칙을 조정해야 하는지, 설정 제공자에게 매개변수를 확인해야 하는지 판단하는 데 도움이 됩니다.
Project V는 프록시 통신 도구를 중심으로 형성된 오픈 소스 생태계이며 V2Ray는 널리 사용되는 핵심 프로젝트 중 하나입니다. V2Fly는 V2Ray의 커뮤니티 개발을 이어 왔습니다. Xray는 관련 코드 기반에서 발전해 독립 프로젝트가 되었으며 자체 프로토콜 및 전송 기능을 확장했습니다. 두 프로젝트는 공통된 배경이 있지만 현재 기능, 설정 세부 사항, 업데이트 주기가 완전히 같지는 않습니다. 한쪽의 가이드를 다른 쪽에 그대로 적용할 수는 없습니다.
일상적인 사용에서는 코어 이름만 비교하기보다 노드에 필요한 기능을 확인하는 것이 중요합니다. 노드는 보통 프로토콜, 전송 방식, 보안 계층, 인증 매개변수의 조합으로 구성됩니다. VMess와 VLESS는 프로토콜 이름이고 REALITY는 보안 전송 관련 방식이므로 서로 같은 계층의 대체 가능한 옵션으로 볼 수 없습니다. 중요한 필드 하나라도 맞지 않으면 연결이 성립하지 않을 수 있습니다.
v2rayN은 데스크톱용 클라이언트로 GUI에서 서버, 구독, 시스템 프록시, 라우팅을 관리하며 여러 코어를 설정할 수 있습니다. 플랫폼과 배포 형태에 따라 메뉴 위치가 다를 수 있으므로 화면이 다르면 사용 중인 데스크톱 패키지부터 확인하세요. 선택할 수 있는 코어도 실제 설치된 구성에 따라 다릅니다. 튜토리얼 화면만 보고 모든 플랫폼에서 같은 옵션을 제공한다고 단정하지 마세요.
v2rayNG는 Android 기기용으로 Xray 코어를 사용하고 시스템 VPN 인터페이스를 통해 트래픽을 처리합니다. v2flyNG는 V2Fly 코어를 사용하며 해당 코어 기능이 필요한 설정에 적합합니다. 이름은 비슷하지만 같은 앱의 테마 버전이 아니며 설정을 모두 공유하지도 않습니다. 구독을 옮길 때는 노드 이름만 같은지 확인하지 말고 프로토콜 호환성, 라우팅 모드, 앱별 트래픽 분배, 시스템 권한을 각각 점검하세요.
세 클라이언트는 모두 GPL-3.0 라이선스로 소스 코드를 공개하며, 코어와 기타 의존성에는 각 프로젝트의 라이선스가 적용됩니다. 오픈 소스는 소스 코드와 라이선스 조건을 확인할 수 있고 사용·수정·배포에 관한 규칙이 정해져 있다는 의미입니다. 클라이언트 프로젝트가 원격 구독 서비스를 제공한다는 뜻은 아니며 구독 출처의 신뢰성을 보장하지도 않습니다. 클라이언트 무료 다운로드와 원격 서비스 유료 여부는 별개의 문제입니다.
구독 주소에는 개인 설정을 가져오는 데 필요한 인증 정보가 포함될 수 있고 노드 설정에도 인증 정보가 들어갈 수 있습니다. 백업할 때는 민감 정보로 취급해 신뢰할 수 있는 위치에만 보관하세요. 로그나 스크린샷을 공유하기 전에 구독 주소, 서버 인증 필드, QR 코드가 노출되지 않았는지 확인하세요. 문의할 때는 전체 원본 설정 대신 오류 유형, 작업 순서, 민감 정보를 제거한 매개변수 구조를 제공하는 편이 안전합니다.
구독 업데이트는 일반적으로 서비스 제공자가 배포한 노드 매개변수만 새로고침하며 클라이언트 프로그램을 업그레이드하지 않습니다. 클라이언트를 업데이트하면 인터페이스, 코어, 설정 생성 방식이 바뀔 수 있지만 원격 노드가 복구된다는 보장은 없습니다. 지역 분류 데이터, 라우팅 규칙, DNS 설정도 각각 별도로 관리해야 합니다. 문제가 생기면 먼저 어느 계층에서 변화가 발생했는지 확인한 뒤 해당 항목을 조치하세요. 원인을 건드리지 않은 채 업데이트만 반복하지 마세요.
업그레이드 전에 구독 출처, 사용자 지정 라우팅, 필요한 설정을 백업하세요. 업그레이드 후에는 기존에 작동하던 기본 연결을 먼저 확인한 다음 앱별 라우팅, 로컬 네트워크 접속, TUN 동작을 차례로 점검하세요. 새 매개변수를 인식하지 못하면 클라이언트와 코어의 지원 여부를 확인하세요. 경고를 없애려고 보안 관련 필드를 임의로 삭제하거나 다른 코어에 기존 설정 전체를 점검 없이 덮어쓰지 마세요.
구독을 안정적으로 가져오고 연결할 수 있게 되면 인바운드, 아웃바운드, 라우팅 순서로 생성된 설정을 살펴볼 수 있습니다. 인바운드는 로컬 요청을 받는 방식, 아웃바운드는 대상 또는 상위 서버에 연결하는 방식, 라우팅은 태그를 통해 두 설정을 연결하는 방식입니다. 홈 화면의 직접 연결 규칙은 해당 아웃바운드와 분류 데이터가 있을 때만 의미가 있습니다. 설정 일부만 복사해서는 전체 구성이 완성되지 않습니다.
계속 알아보려면 용어집에서 프로토콜, 전송 방식, 코어, 라우팅을 구분하고 클라이언트 비교에서 지원 플랫폼을 확인하세요. 설정 순서와 유지 관리를 체계적으로 살펴보려면 사용 설명서를 읽고, 구체적인 연결 문제는 도움말 센터에서 증상별로 확인하세요. 여러 설정을 무작정 바꾸기보다 한 번 정상적으로 작동한 구성을 기록해 두는 것이 문제 해결에 더 유용합니다.
아래 세 글에서는 프로토콜 차이, 데스크톱 설치, 노드 선택을 각각 다룹니다. 먼저 기본 연결 절차를 익힌 다음 현재 문제에 맞는 글을 읽어 보세요. 노드 이름에 표시된 지역이나 프로토콜은 참고 정보일 뿐이며 실제 동작은 전체 매개변수와 연결 결과를 함께 확인해야 합니다.
VMess와 VLESS의 암호화 방식, 시간 검증, 전송 조합 차이와 두 프로토콜의 노드를 클라이언트에 가져올 때 확인할 점을 쉽게 설명합니다.
v2rayN의 두 가지 Windows 배포 버전을 비교하고 압축 해제와 실행, 런타임 의존성, 시스템 프록시 설정, 시작 프로그램 등록 절차와 자주 발생하는 문제를 정리합니다.
구독에 표시된 노드 이름과 표기 정보를 설명하고 지연 시간 측정 방법, 트래픽 배율 계산, 지역 및 프로토콜별 사용 사례를 안내합니다.