클라이언트는 설정을 읽고 연결을 수립하는 프로그램이며, 설치 파일 자체에는 연결할 서버 정보가 포함되어 있지 않습니다. 신뢰할 수 있는 출처의 구독 주소나 공유 링크를 준비한 뒤 가져오세요. 컴퓨터나 휴대폰을 바꿀 때도 클라이언트 이름이 비슷하다는 이유만으로 기존 설정을 그대로 쓰지 말고, 프로토콜 지원 여부와 가져온 결과를 다시 확인하세요.
설정을 네 단계로 나눠 살펴보세요. 먼저 설정이 제대로 가져와졌는지 확인한 다음, 어떤 프로그램을 프록시에 연결할지 정하고, 연결이 코어에 들어온 뒤 어떻게 라우팅될지 구성합니다.
구독 가져오기 및 그룹별 업데이트
구독 주소는 여러 설정을 가져오는 경로이지, 브라우저에서 일반 웹페이지를 여는 링크가 아닙니다. v2rayN의 구독 그룹 설정에 메모와 주소를 입력하고 저장한 뒤 업데이트하세요. 안드로이드에서는 구독 그룹 메뉴에서 추가하면 됩니다. 그룹을 나누면 출처별 설정을 구분할 수 있어 업데이트가 영향을 미치는 범위도 쉽게 파악할 수 있습니다. 공유 링크 하나를 한 번 붙여 넣는 방식과 달리, 구독은 설정을 다시 가져올 수 있는 경로를 유지합니다. 업데이트에 실패하면 주소가 완전한지, 만료되지는 않았는지 먼저 확인한 뒤 가져오기 실패와 파싱 실패를 구분하세요. 같은 이름의 그룹을 반복해서 만들지 마세요.
구독 그룹 설정
메모일반 구독
선택 주소(url)https://example.com/sub
업데이트 사용
자동 업데이트 간격사용 안 함
규칙을 매칭한 뒤 아웃바운드 선택
라우팅은 코어에 들어온 연결을 어떤 아웃바운드로 보낼지 결정합니다. 도메인, IP 또는 규칙 세트로 매칭한 뒤 direct, proxy 또는 block으로 보낼 수 있으며, 이 이름은 실제 설정의 아웃바운드 태그와 일치해야 합니다. 규칙은 일반적으로 위에서 아래 순서로 확인하므로 구체적인 조건을 포괄적인 조건보다 앞에 두세요. 모든 연결을 하나의 아웃바운드로 보내는 대신 라우팅을 세분화하면 로컬 네트워크 접근을 유지하면서 연결별 처리 범위를 조정할 수 있습니다. 규칙을 수정할 때는 한 종류씩 변경하고 로그에서 매칭 결과를 확인하세요. 규칙 세트가 없거나 DNS 전략이 다르면 예상과 다른 결과가 나올 수 있습니다.
라우팅 규칙 · 의미 안내
geosite:category-ads-all → block
geosite:cn → direct
geoip:private → direct
final → proxy
마지막 행은 기본 아웃바운드를 나타내며 JSON 필드가 아닙니다.
시스템 프록시와 전역 라우팅 구분하기
시스템 프록시는 이 설정을 따르는 앱이 연결을 로컬 프록시로 보내도록 합니다. v2rayN의 ‘시스템 프록시 자동 설정’은 이 설정을 적용하는 기능일 뿐, 모든 프로그램을 연결한다는 뜻도 라우팅의 전역 프록시와 같다는 뜻도 아닙니다. 각 앱에 주소를 직접 입력하는 대신 먼저 브라우저 연결을 확인할 때 유용합니다. 브라우저는 작동하지만 다른 앱은 실패한다면 클라이언트를 바로 다시 설치하지 말고 해당 앱의 프록시 동작을 확인하세요. 종료하기 전 시스템 프록시를 해제하면 프로그램이 꺼진 뒤에도 시스템이 응답하지 않는 로컬 포트를 가리키는 일을 막을 수 있습니다.
시스템 프록시 모드
시스템 프록시 해제
시스템 프록시 자동 설정
시스템 프록시 변경 안 함
더 많은 연결을 처리해야 할 때 TUN 사용
TUN은 가상 네트워크 인터페이스를 통해 연결을 처리하므로 시스템 프록시를 따르지 않는 프로그램에 적합합니다. TUN과 라우팅은 서로 다른 계층에서 작동합니다. TUN은 연결을 가져오고, 라우팅은 아웃바운드를 결정합니다. 시스템 프록시만 설정하는 것보다 더 많은 시스템 권한과 라우팅, DNS 동작에 영향을 주므로 다른 VPN이나 가상 네트워크 어댑터와의 충돌도 확인해야 합니다. 먼저 일반 프록시 모드에서 같은 설정으로 연결되는지 확인한 다음 TUN을 켜세요. 문제가 생기면 새로 추가한 연결 처리 기능을 끄고 비교하면서 권한, 네트워크 어댑터, DNS 기록을 각각 점검하세요. 구독과 규칙을 동시에 바꾸지는 마세요.
TUN 설정 확인
TUN 모드
시스템 권한시스템 안내에 따라 허용
DNS 설정라우팅 정책과 함께 설정
연결 문제끄고 비교 테스트
위 내용은 설정 항목과 규칙의 의미를 보여 주는 예시이며, 그대로 가져올 수 있는 완성 설정이 아닙니다. 자세한 설정 순서는 시작 가이드 →를 확인하세요.
Project V, V2Fly 및 Xray 생태계
클라이언트, 코어, 프로토콜의 차이를 먼저 알아두세요. 세 이름은 서로 다른 계층을 가리키며, 인터페이스가 비슷해도 모든 설정을 서로 바꿔 쓸 수 있는 것은 아닙니다.
클라이언트는 인터페이스를, 코어는 연결을 담당합니다
Project V는 V2Ray 기술 생태계를 이해하기 위한 출발점입니다. V2Ray는 인바운드, 아웃바운드, 전송, 라우팅, DNS 등의 기능을 설정 가능한 모듈로 나눕니다. GUI 클라이언트는 이러한 기능을 바탕으로 구독 관리, 모드 전환, 로그 확인 등의 메뉴를 제공합니다. 따라서 ‘클라이언트 설치를 마침’과 ‘사용 가능한 설정을 갖춤’은 별개의 일입니다. 클라이언트가 실행된다는 것은 프로그램이 동작한다는 뜻일 뿐입니다. 실제로 연결하려면 서버 정보가 완전해야 하고, 프로토콜과 네트워크 연결 방식도 맞아야 합니다.
V2Fly는 V2Ray 관련 프로젝트의 커뮤니티 개발을 이어가고 있으며, Xray는 관련 코드 기반에서 발전한 별도의 코어 계열입니다. 두 프로젝트는 기술적 배경을 공유하면서도 각자 기능을 발전시켜 왔습니다. 가이드를 읽을 때는 클라이언트 이름뿐 아니라 실제로 사용하는 코어도 확인하세요. 특정 프로토콜을 지원한다고 해서 모든 확장 매개변수까지 지원한다고 단정할 수는 없습니다. 서버 설정에 필요한 항목을 클라이언트에서 사용할 수 있는 코어 기능과 하나씩 대조해야 합니다.
오픈 소스 클라이언트 3종 비교
v2rayN은 데스크톱 환경을 위한 클라이언트로, GUI에서 구독 그룹과 시스템 프록시, 라우팅 설정을 관리할 수 있습니다. 데스크톱에서는 같은 클라이언트의 사용법을 익힌 뒤 운영체제에 맞는 설치 파일을 선택하면 됩니다. Xray와 V2Fly 등의 코어 생태계를 사용하므로 ‘인터페이스 프로그램’과 ‘실제 연결을 처리하는 코어’를 구분해서 이해해야 합니다. 사용할 수 있는 코어와 기능은 배포 패키지와 인터페이스 옵션을 기준으로 확인하세요. 다른 플랫폼의 화면에 나온 기능을 그대로 적용하면 안 됩니다.
v2rayNG는 안드로이드에서 널리 쓰이는 오픈 소스 클라이언트로 Xray 코어를 사용합니다. 안드로이드는 VPN 권한을 통해 연결을 처리하므로 실행 방식이 데스크톱의 시스템 프록시 메뉴와 다릅니다. v2flyNG는 V2Fly 코어를 사용하는 안드로이드 클라이언트입니다. 이름은 비슷하지만 기존 설정에 필요한 코어 계열을 기준으로 선택하세요. 한쪽을 다른 쪽의 범용 문제 해결 도구처럼 취급해서는 안 됩니다. 클라이언트를 바꾸기 전에 설정 항목과 프로토콜 기능이 호환되는지 확인하세요.
클라이언트와 코어별 확인 사항
클라이언트
주요 용도
먼저 확인할 항목
v2rayN
데스크톱 GUI 설정 및 구독 관리
설치 파일 아키텍처, 실행 환경, 실제 선택한 코어
v2rayNG
안드로이드 Xray 설정
프로토콜 지원, VPN 권한, 백그라운드 실행 제한
v2flyNG
안드로이드 V2Fly 설정
코어 호환성, 가져온 설정 항목, 시스템 권한
오픈 소스 라이선스와 설정 출처를 따로 확인하세요
세 클라이언트는 모두 오픈 소스 소프트웨어입니다. 공개된 소스 코드와 라이선스를 통해 구현 방식과 사용 조건을 확인할 수 있습니다. 생태계의 프로젝트마다 라이선스가 다를 수 있으므로 코드를 수정하거나 재배포하고 인용할 때는 각 프로젝트의 라이선스 조건을 따로 확인하세요. 오픈 소스는 소프트웨어의 개발 및 라이선스 방식을 뜻합니다. 출처가 불분명한 구독이나 서버를 신뢰해도 된다는 의미가 아니며, 연결 기록과 서비스 품질, 이용 가능 범위를 클라이언트 프로젝트가 보장한다는 뜻도 아닙니다.
구독 주소에는 사용자를 식별할 수 있는 매개변수가 포함되는 경우가 많으므로 민감한 설정 정보로 보관해야 합니다. 도움을 요청할 때 오류 유형, 클라이언트 이름, 관련 설정 항목은 남기되 전체 주소와 식별 정보, 인증 정보는 가리세요. 출처를 알 수 없는 설정을 가져오기 전에는 추가 라우팅이나 DNS 설정이 포함되어 있는지도 확인해야 합니다. 인터페이스에 ‘실행 중’이라고 표시되는지만 보는 것보다 이런 경계를 이해하는 편이 연결 상태를 올바르게 판단하는 데 도움이 됩니다.
프로그램 업데이트, 구독 업데이트, 규칙 업데이트
프로그램 업데이트는 클라이언트와 관련 구성 요소를 변경하고, 구독 업데이트는 원격에서 제공하는 연결 설정을 다시 가져오며, 규칙 업데이트는 도메인과 IP 매칭 목록을 바꿀 수 있습니다. 세 작업은 서로 다릅니다. 기존 주소가 만료된 경우 프로그램을 업데이트해도 해결되지 않을 수 있습니다. 새 프로토콜 매개변수를 파싱하지 못하는 경우 구독을 반복해서 새로 고쳐도 소용없을 수 있습니다. 먼저 어느 계층에서 변경이 필요한지 파악한 다음 업데이트 대상을 선택하면 불필요한 작업과 설정 손실을 줄일 수 있습니다.
업그레이드 전에 현재 정상적으로 작동하는 프록시 모드와 라우팅 방식, 필요한 사용자 설정을 기록하고 클라이언트가 제공하는 방법으로 설정을 저장하세요. 업그레이드 후에는 정상 작동이 확인된 같은 설정으로 대조해 프로그램 실행, 구독 읽기, 기본 접속이 되는지 확인한 다음 추가 기능을 복원하세요. 코어를 바꾸고 낯선 규칙을 가져오면서 TUN까지 동시에 켜지 마세요. 여러 변수를 한꺼번에 바꾸면 문제가 생겨도 로그만으로 원인을 찾기 어렵습니다.
구독 가져오기부터 연결 확인까지
처음 설정할 때는 순서대로 진행하세요. 정상적으로 실행되는 클라이언트를 설치하고, 구독 그룹을 추가해 설정을 업데이트한 다음, 사용할 구성을 선택하고 현재 시스템에 맞는 연결 처리 방식을 켭니다. 데스크톱에서는 시스템 프록시부터 시작하고, 안드로이드에서는 VPN 권한을 허용하세요. 설정을 마치면 실제로 사용할 앱을 열어 요청이 성공하는지 확인하고 클라이언트 로그에서 연결이 처리되는지도 살펴보세요. 상태 표시줄에 실행 중이라고 나와도 실제 앱에서 접속되는지 확인해야 합니다.
접속에 실패하면 먼저 모든 앱에서 실패하는지 특정 앱에서만 실패하는지 확인하세요. 그다음 도메인 확인 실패, 연결 시간 초과, 서버 거부 중 어떤 상황인지 구분합니다. 브라우저는 작동하지만 다른 프로그램은 연결되지 않는다면 연결 처리 범위를 먼저 확인하세요. 구독 목록이 비어 있다면 가져오기와 파싱을 점검하고, 특정 도메인만 문제가 있다면 라우팅 순서와 DNS를 살펴보세요. 증상에 따라 범위를 좁히면 바로 재설치하는 것보다 원인을 찾기 쉽습니다. 단계별로 알아보려면 V2Ray 시스템 가이드를 계속 읽어 보세요.
자주 묻는 질문
구독 링크와 단일 공유 링크는 같은 방법으로 가져오나요?
아니요. 구독 주소는 구독 그룹에 저장한 뒤 업데이트해야 합니다. 단일 공유 링크는 일반적으로 클립보드 가져오기 등의 메뉴에서 추가합니다. 먼저 링크 유형을 확인한 다음 시작 가이드를 따라 하세요. 구독 주소를 단일 설정으로 가져오지 않도록 주의하세요.
시스템 프록시를 자동 설정한 뒤에도 라우팅 규칙이 필요한가요?
두 기능의 역할은 다릅니다. 시스템 프록시는 이를 지원하는 앱이 로컬 프록시에 연결되도록 하고, 라우팅 규칙은 연결이 코어에 들어온 뒤 어떤 아웃바운드를 사용할지 정합니다. 시스템 프록시를 켜도 라우팅 규칙을 대신할 수 없습니다. 설정 순서는 가이드에서 확인할 수 있습니다.
구독 업데이트는 성공했는데 연결되지 않는 이유는 무엇인가요?
업데이트 성공은 설정을 가져와 파싱했다는 뜻이지, 서버 연결을 보장한다는 뜻은 아닙니다. 현재 선택한 설정과 시스템 연결 처리 방식, 로그 오류를 확인한 다음 서버 매개변수와 네트워크 상태를 점검하세요. 연결 확인 절차에 따라 문제의 계층을 하나씩 구분해 보세요.
처음 설정할 때 바로 TUN을 켜야 하나요?
데스크톱에서는 먼저 일반 프록시 방식으로 기본 연결을 확인한 뒤 앱의 필요에 따라 TUN을 켜는 것이 좋습니다. 이렇게 하면 설정 자체의 문제와 가상 네트워크 어댑터, 권한, 시스템 라우팅 문제를 구분할 수 있습니다. 기본 가이드부터 시작하세요.
구독 가져오기 및 설정 관련 글
최근 글에서는 실제 문제를 중심으로 다룹니다. 먼저 설정 메뉴를 찾고, 설정 구조를 확인한 뒤, 실행 문제가 생기면 실행 환경을 하나씩 점검하세요.