구독 가져오기부터 라우팅 설정까지, 실제 메뉴를 기준으로 프록시 설정과 연결 확인 순서를 안내합니다.
첫 설정
먼저 유효한 설정을 가져온 뒤 트래픽이 클라이언트로 들어오는지 확인하세요. 프로그램 설치, 노드 구독, 시스템 프록시는 서로 다른 단계이므로 순서대로 진행하면 문제를 어디서부터 확인할지 명확해집니다.
준비 및 가져오기
클라이언트는 설정을 관리할 뿐, 설치만으로 사용할 수 있는 노드가 자동 생성되지는 않습니다. 출처가 명확하고 유효 기간이 남은 구독 주소를 준비하세요. 구독 주소에는 계정 식별 정보가 포함되는 경우가 많으므로 복사할 때 전체 내용을 유지하고, 브라우저의 관리 페이지 주소를 구독 링크로 착각하지 않도록 주의하세요.
v2rayN 상단 메뉴에서 ‘구독 그룹’의 ‘구독 그룹 설정’을 열고 새 그룹을 만든 다음 주소를 입력해 저장하세요. 이어서 ‘현재 구독 업데이트(프록시 사용 안 함)’를 실행합니다. 현재 네트워크에서 구독 서버에 직접 접속할 수 없다면 이미 사용 가능한 프록시를 통해 업데이트하는 방법을 고려하세요. 작업 후 로그에서 서버 목록에 노드가 표시되는지 확인합니다. 업데이트에 실패하면 주소와 응답 내용을 먼저 확인하고, 클라이언트를 반복해서 재설치할 필요는 없습니다.
노드 및 모드
서버 목록에서 사용할 노드를 선택한 뒤, 마우스 오른쪽 버튼 메뉴에서 ‘활성 서버로 설정’을 눌러 적용하세요. 서버 이름은 메모일 뿐 프로토콜 호환성을 판단하는 기준이 아닙니다. 가져온 뒤 주소, 포트, 전송 설정이 온전히 유지됐는지 확인하고 ‘서버 실제 연결 지연 시간 테스트’를 실행해 프록시 핸드셰이크가 완료되는지 살펴보세요.
처음 연결을 확인할 때는 기본 라우팅 규칙을 사용해 설정을 단순하게 유지하세요. 메인 창 하단의 ‘시스템 프록시’에서 ‘시스템 프록시 자동 설정’을 선택한 다음 ‘라우팅’ 옵션을 확인합니다. 시스템 프록시는 시스템 설정을 따르는 앱이 로컬 프록시에 연결되도록 하고, 라우팅 규칙은 코어에 전달된 트래픽의 경로를 결정합니다. 두 설정은 서로 대체할 수 없습니다.
접속 및 확인
테스트할 웹페이지를 열고 v2rayN 하단의 로그를 함께 확인하세요. 해당 연결 기록이 보여야 앱의 요청이 클라이언트로 들어온 것입니다. 브라우저에서 페이지가 열린다고 모든 앱이 프록시를 사용하는 것은 아닙니다. 일부 프로그램은 별도의 프록시 설정을 사용하고, 시스템 설정을 시작할 때만 읽는 프로그램도 있습니다.
페이지가 계속 열리지 않으면 시스템 시간, 활성 노드, 로컬 수신 포트, TLS 매개변수, 라우팅 규칙을 차례로 확인하고 한 번에 하나씩만 변경하세요. 클라이언트를 종료하기 전에 시스템 프록시를 해제해야 시스템이 이미 닫힌 로컬 포트를 계속 가리키는 일을 막을 수 있습니다. Android에서 v2rayNG를 사용할 때는 시스템 연결 권한과 백그라운드 실행 상태도 확인하세요. 데스크톱의 트레이 메뉴 조작을 그대로 적용할 수는 없습니다.
플랫폼 및 클라이언트
데스크톱에서는 v2rayN을 사용하세요. Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 고려하고, V2Fly 코어가 필요할 때 v2flyNG를 선택하면 됩니다. 다운로드 페이지에서 설치 파일 형식, CPU 아키텍처, 클라이언트별 차이를 확인할 수 있습니다. 먼저 운영체제를 고른 다음 설치 파일을 선택하세요.
새로 설치한다면 크로스 플랫폼 인터페이스를 사용하는 데스크톱 버전을 먼저 살펴보세요. 클래식한 화면 구성이 익숙하다면 WPF 버전을 선택할 수 있습니다. 두 버전은 메뉴 위치가 다를 수 있지만, 가이드의 ‘구독 그룹’, ‘시스템 프록시’, ‘라우팅’은 각각 구독 관리, 앱 트래픽의 진입 경로, 코어의 트래픽 분배를 뜻합니다. 버튼 모양만 보고 설정 적용 여부를 판단하지 마세요.
설치 전에 시스템의 ‘설정 → 시스템 → 시스템 정보’에서 시스템 종류를 확인하고 다운로드 페이지의 지원 안내를 읽으세요. 실행 후에는 일반 시스템 프록시부터 확인하고, 앱 요구사항에 따라 TUN 사용을 검토하세요. 권한 상승이 필요한 기능은 일반 프록시와 점검 경로가 다릅니다. 문제가 생기면 먼저 로그를 확인하고 여러 스위치를 한꺼번에 바꾸지 마세요.
시스템 메뉴의 ‘이 Mac에 관하여’에서 ‘칩’ 또는 ‘프로세서’를 확인한 다음 해당 아키텍처에 맞는 파일을 선택하세요. Apple Silicon과 Intel은 설치 경로가 다르며, 설치 파일 형식이 같다고 서로 바꿔 사용할 수 있는 것은 아닙니다. 구독을 가져오기 전에 처음 실행과 시스템 권한 설정을 마치고 클라이언트 창과 로그가 정상적으로 표시되는지 확인하세요.
시스템 프록시는 ‘시스템 설정 → 네트워크 → 현재 네트워크 서비스 → 세부사항 → 프록시’에서 확인할 수 있습니다. 클라이언트를 종료한 뒤 웹페이지에 접속할 수 없다면 프록시가 여전히 로컬 수신 주소를 가리키는지 먼저 확인하세요. Wi-Fi, 유선 네트워크 또는 다른 네트워크 서비스로 전환한 뒤에는 이전에 연결했던 항목만 확인하지 말고 현재 사용 중인 서비스도 점검해야 합니다.
대부분의 최신 휴대전화에서는 arm64 설치 옵션을 먼저 확인하세요. 아키텍처가 확실하지 않다면 범용 버전 안내를 살펴보면 됩니다. v2rayNG와 v2flyNG의 주요 차이는 사용하는 코어와 그에 따른 설정 호환성입니다. 화면이 비슷해 보여도 모든 프로토콜과 전송 매개변수를 서로 옮겨 쓸 수 있는 것은 아닙니다. 구독 요구사항을 확인한 뒤 대체 클라이언트 사용 여부를 결정하세요.
v2rayNG 오른쪽 상단 메뉴에서 ‘구독 그룹 설정’으로 이동해 구독을 추가한 다음 돌아와 노드를 업데이트하세요. 처음 연결할 때 시스템에 VPN 연결 권한 요청이 표시됩니다. 이 권한은 로컬 트래픽을 전달하는 통로를 만들기 위한 것이며 원격 노드 연결 성공을 의미하지는 않습니다. 화면을 잠근 뒤 연결이 끊긴다면 시스템 앱 설정에서 배터리 최적화와 백그라운드 활동 권한을 확인하세요.
먼저 배포판에서 사용하는 패키지 형식을 확인한 뒤 프로세서 아키텍처를 확인하세요. deb와 rpm은 서로 다른 패키지 관리 체계에 해당하고, x64와 arm64는 서로 다른 하드웨어를 가리킵니다. 따라서 네 가지 조합을 파일 확장자만 보고 선택해서는 안 됩니다. 배포판의 소프트웨어 설치 화면에서 설치와 첫 실행을 진행할 수 있으며, 데스크톱 환경에 필요한 의존성은 다운로드 페이지 안내를 따르세요.
Linux에서 앱이 시스템 프록시를 사용하는지는 데스크톱 환경과 앱 자체 구현에 따라 달라집니다. 브라우저는 시스템 설정을 사용할 수 있지만 터미널 프로그램과 백그라운드 서비스는 별도로 설정해야 할 수 있습니다. 확인할 때는 먼저 프록시 설정을 지원하는 앱을 하나 골라 로컬 진입점이 작동하는지 테스트한 다음 다른 프로그램으로 범위를 넓히세요. 앱에 트래픽이 전달되지 않는 문제를 구독 가져오기 실패로 오해하지 마세요.
설정을 옮길 때는 먼저 노드를 이전하고 로컬 설정을 확인하세요. 구독 주소는 여러 기기에서 재사용할 수 있지만 수신 포트, 시스템 프록시 상태, 권한, 라우팅 선택은 대개 기기별 실행 환경에 속합니다. 공유 링크와 QR 코드에도 계정 정보가 포함될 수 있으므로 캡처하거나 전송하기 전에 공유 범위를 확인하세요. 공개 게시물에는 문제 해결에 필요한 설정만 남기세요.
전체 클라이언트 보기 → 클라이언트 3종 비교 →설정 단계별 안내
구독은 사용할 수 있는 노드를 정하고, 라우팅은 요청이 이동할 경로를 정하며, 코어는 프로토콜을 실행합니다. 먼저 이 세 계층을 구분해야 문제를 정확히 찾을 수 있습니다. 클라이언트는 실행 설정을 생성하고, 공유 링크는 코어에서 바로 읽을 수 있는 완전한 설정 파일이 아닙니다.
구독 주소는 노드 목록을 가져오는 경로이며, 공유 링크는 보통 노드 하나의 정보를 담습니다. v2rayN의 ‘구독 그룹 설정’에 주소를 입력하고 저장한 다음 해당 그룹을 업데이트하세요. 목록이 바뀌지 않으면 업데이트 로그를 확인해 네트워크 요청 실패, 응답 내용을 인식하지 못한 경우, 구독 만료를 구분하세요. 기존 VMess 공유 링크는 노드 정보를 인코딩해 프로토콜 접두사 뒤에 담습니다. 이는 코어에서 바로 사용하는 JSON 형식이 아니므로 클라이언트에서 해석해야 하며, 코어 실행 설정에 그대로 붙여 넣을 수 없습니다.
v2rayN · 메뉴 및 형식 구성
구독 그룹
구독 그룹 설정
현재 구독 업데이트(프록시 사용 안 함)
현재 구독 업데이트(프록시 사용)
기존 VMess 공유 링크 형식
vmess:// + Base64(JSON)
디코딩 후 자주 보이는 필드
add → 서버 주소
port → 서버 포트
id → 사용자 ID
net → 전송 방식
tls → 전송 보안 설정시스템 프록시는 앱이 로컬 프록시에 접속하는 진입점이고, 라우팅은 코어가 요청을 받은 뒤 트래픽을 나누는 규칙입니다. v2rayN 메인 창 하단에서 ‘시스템 프록시’와 ‘라우팅’을 확인하고, 전체 라우팅과 트래픽을 프록시로 전달하는 범위를 혼동하지 마세요. 오른쪽 예시는 중국 도메인 모음과 일치하는 요청을 직접 연결 출구로 보내는 규칙이며, 해당 도메인 데이터와 출구 태그가 미리 정의되어 있어야 합니다. 규칙은 보통 순서대로 적용됩니다. 범위가 넓은 규칙을 앞에 두면 뒤의 요청까지 먼저 처리될 수 있으므로 변경 후 로그에서 실제로 어떤 규칙이 적용됐는지 확인하세요.
routing · 도메인 모음 → direct
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}
]
}
}
규칙 필드: domain
일치 항목: geosite:cn
출구 태그: direct코어는 프로토콜 핸드셰이크, 전송, 라우팅을 실행하고 클라이언트 인터페이스는 이러한 설정을 관리합니다. v2rayN에서 ‘설정 → 매개변수 설정 → Core 유형 설정’을 열어 프로토콜별 코어 옵션을 확인할 수 있습니다. 실제로 선택 가능한 항목은 클라이언트마다 다릅니다. v2rayNG는 Xray를, v2flyNG는 V2Fly를 사용합니다. 같은 공유 링크를 가져올 수 있다고 해서 모든 추가 매개변수가 대상 코어에서 지원되는 것은 아닙니다. 설정을 옮길 때는 프로토콜, 전송 방식, TLS 필드를 확인하세요. 코어 변경이 모든 연결 실패를 해결하는 것은 아닙니다.
클라이언트 · 코어 설정 위치
v2rayN
설정
매개변수 설정
Core 유형 설정
프로토콜별 코어 옵션 확인
Xray
V2Fly
Android 클라이언트별 코어
v2rayNG → Xray
v2flyNG → V2FlyDNS도 계층별로 점검해야 합니다. 시스템 DNS, 브라우저의 보안 DNS, 코어의 DNS 설정은 서로 다른 경로를 사용할 수 있습니다. 시스템 DNS만 변경해도 코어의 이름 해석 방식은 바뀌지 않을 수 있고, 코어 DNS만 변경해도 프록시를 우회하는 앱에는 영향을 주지 않을 수 있습니다. 요청을 보낸 앱과 트래픽 전달 방식을 기록한 뒤 해당 설정을 조정하면 모든 DNS 주소를 한꺼번에 바꾸는 것보다 문제를 재현하기 쉽습니다. 자세한 내용은 V2Ray DNS 설정을 참고하세요.
Project V · V2Fly · Xray
클라이언트, 코어, 노드 서비스는 서로 다른 역할을 합니다. 오픈소스 여부는 코드의 라이선스와 협업 방식을 설명하며, 실제 연결 가능 여부는 설정, 원격 서비스, 현재 네트워크에 따라 달라집니다. 클라이언트 이름만으로 연결 가능성을 판단할 수 없습니다.
V2Ray는 인바운드, 아웃바운드, 라우팅, 전송 모듈을 분리해 설정하는 방식을 중심으로 한 Project V 프록시 도구 생태계에서 시작했습니다. V2Fly는 V2Ray의 커뮤니티 개발을 이어가고, Xray는 관련 코드 기반에서 독자적인 코어 개발 방향을 발전시켰습니다. 세 프로젝트는 개념과 일부 설정 필드가 연결되어 있지만 새 기능까지 모두 동일하게 지원되는 것은 아닙니다. 가이드를 읽을 때는 클라이언트뿐 아니라 실제 실행 중인 코어도 확인하세요. ‘V2Ray 설정’이라는 표현만으로는 호환 범위를 특정하기 어렵습니다.
VMess, VLESS, Trojan, Shadowsocks는 프로토콜 이름이고 TCP와 WebSocket 등은 전송 방식이며 TLS는 전송 보안과 관련됩니다. 서로 다른 계층이므로 같은 종류의 옵션이 아닙니다. 서버 주소가 맞는데도 연결되지 않는다면 포트, 프로토콜 인증 정보, 전송 경로, 서버 이름을 추가로 확인해야 합니다. 노드 메모만 비교해서는 원인을 찾기 어렵습니다.
v2rayN은 데스크톱용 클라이언트로 구독 관리, 서버 목록, 로그 확인, 시스템 프록시, 라우팅 설정 기능을 제공합니다. v2rayNG는 Android용이며 Xray 코어를 사용하고, v2flyNG는 V2Fly 코어를 기반으로 한 Android용 선택지입니다. 세 클라이언트 모두 소스 코드가 공개되어 있으며 로컬 설정 관리와 연결 제어를 담당합니다. 원격 서비스를 제공하지 않으며 설치만으로 사용할 수 있는 구독이 자동 생성되지도 않습니다.
데스크톱과 휴대전화에서 같은 출처의 구독을 가져올 수 있지만 시스템 권한, 트래픽 전달, 백그라운드 실행 방식은 서로 다릅니다. 데스크톱 가이드의 트레이 조작은 휴대전화에 그대로 적용할 수 없고, 휴대전화의 연결 권한은 데스크톱의 시스템 프록시 설정을 대신하지 않습니다. 여러 기기에서 사용하려면 먼저 구독 출처를 동기화한 뒤 각 기기의 실행 상태를 따로 확인하세요.
v2rayN·v2rayNG·v2flyNG 클라이언트 프로젝트는 GPL-3.0 라이선스를 사용하고, V2Fly와 Xray 코어 코드는 MPL-2.0 라이선스를 사용합니다. 개별 파일과 포함된 의존성의 라이선스는 각 프로젝트의 라이선스 고지를 확인하세요. 오픈소스 라이선스는 코드의 사용, 수정, 재배포 조건을 정하며 원격 노드 서비스의 이용 가능성을 보장하지 않습니다. 클라이언트가 무료라고 해서 모든 타사 구독이 무료이거나 계속 유효한 것도 아닙니다.
설정에 포함된 구독 주소, 사용자 ID, 인증 정보는 개인 계정과 연결될 수 있습니다. 전체 설정은 신뢰할 수 있는 기기에만 전달하고 공개 로그에서는 관련 정보를 삭제하세요. 도움을 요청할 때는 오류 유형, 프로토콜 이름, 필요한 설정 항목만 남기고 구독 주소 전체나 노드 QR 코드를 공개하지 마세요.
클라이언트, 코어, 구독, 라우팅 데이터 업데이트는 각각 서로 다른 내용을 바꿉니다. 클라이언트 업데이트는 화면과 설정 생성 방식을 바꿀 수 있고, 코어 업데이트는 프로토콜 구현에 영향을 주며, 구독 업데이트는 원격 노드를 가져오고 라우팅 데이터 업데이트는 도메인 또는 주소 목록에 영향을 줍니다. 하나를 업데이트해도 나머지가 자동으로 모두 갱신되지는 않습니다. 문제를 확인하기 전에 방금 수행한 작업을 기록해 두면 변화가 발생한 계층을 찾는 데 도움이 됩니다.
문제가 생기면 먼저 재현 가능한 최소 설정을 보존하고 시스템 시간과 로컬 포트를 확인한 다음 TLS, 라우팅, DNS를 살펴보세요. 한 번의 테스트에서 노드 교체, 코어 변경, TUN 활성화를 동시에 하지 마세요. 플랫폼별 메뉴 위치를 확인하려면 전체 플랫폼 가이드를, 특정 개념만 확인하려면 자주 묻는 질문을 먼저 참고한 뒤 현재 작업으로 돌아오세요.
설정 기록
첫 연결을 마친 뒤 속도 측정, 기기 간 동기화, 간헐적 시간 초과 문제를 살펴보세요. 먼저 글에서 다루는 연결 계층을 확인한 다음 해당 설정을 조정해야 합니다. 포트에 접속할 수 있다는 사실만으로 프록시가 정상이라고 판단하거나, 설정이 같다는 이유로 네트워크 환경까지 같다고 볼 수는 없습니다.
TCPing은 포트까지의 연결을 확인하고, 실제 연결 지연 시간은 프록시 핸드셰이크 전체를 측정하며, 다운로드 테스트는 실제 처리량을 봅니다. 각 측정값이 답하는 질문은 서로 다르므로 숫자 하나만으로 순위를 매길 수 없습니다. 글에서 테스트별 연결 범위를 나누어 설명하고 노드 선택 시 참고할 지표와 지연 시간이 낮아도 다운로드 속도가 더 빠르지 않을 수 있는 이유를 살펴봅니다.
글 읽기 →구독 공유는 지속적인 업데이트에 적합하고, QR 코드는 단일 노드 전달에, 공유 링크는 여러 노드 일괄 가져오기에 편리합니다. 설정 백업은 로컬 매개변수에 주의해야 합니다. 글에서 네 가지 동기화 방법을 비교하고 재사용할 수 있는 노드 정보와 기기별로 다시 확인해야 할 설정을 구분하며 민감 정보의 취급 범위도 안내합니다.
글 읽기 →노드 시간 초과의 원인은 원격 서버에만 있는 것이 아닙니다. 로컬 시간 오차, 수신 포트 충돌, TLS 서버 이름 불일치, 라우팅 설정도 연결을 끊을 수 있습니다. 글에서 확인 비용이 낮은 순서대로 점검 절차와 클라이언트에서 확인할 위치를 안내합니다. 먼저 오류를 기록한 다음 한 번에 하나씩 설정을 바꿔 원인을 확인하세요.
글 읽기 →