Windows
v2rayN 사용을 권장합니다. 데스크톱 버전은 크로스플랫폼 인터페이스를 제공하며, 기존 Windows 방식에 익숙한 사용자는 클래식 WPF 버전을 선택할 수 있습니다. 설치 후 구독 그룹부터 설정하고 시스템 프록시를 활성화해 연결을 확인하세요.
클라이언트 설정 핵심
구독 가져오기부터 라우팅 및 DNS까지
그래픽 클라이언트의 핵심 작업은 구독 하나를 추가하는 데서 끝나지 않습니다. 그룹 구성, 프록시 진입점, 라우팅 규칙과 DNS 조회 경로가 연결 안정성, 프록시를 거치는 프로그램, 로컬 네트워크와 로컬 서비스의 접근 가능 여부를 함께 결정합니다. 아래에서는 실제 설정 순서에 따라 네 가지 핵심 단계를 나눠 설명합니다.
목록 관리
출처별로 구독과 서버 정리
구독 그룹은 여러 구성 출처를 동시에 관리할 때 유용합니다. 그룹마다 업데이트 간격, 활성화 상태, 서버 필터 조건을 따로 설정할 수 있어 업데이트할 때 서로 다른 출처가 한 작업에 섞이지 않습니다. 처음에는 기본 그룹 하나를 만든 뒤 구독 주소를 가져오고 수동으로 한 번 업데이트한 다음 서버 항목이 표시되는지 확인하세요. 구성 출처가 늘어나면 용도나 제공업체별로 그룹을 나누는 편이 이름 접두사로 항목을 찾는 것보다 명확합니다.
서버 목록이 너무 길다면 포함 또는 제외 키워드로 표시 범위를 좁힌 뒤 현재 그룹에 대해 실제 연결 테스트를 진행할 수 있습니다. 필터는 목록 정리 방식만 바꾸며 구독에서 제공한 원본 구성은 수정하지 않습니다. 복원하려면 조건을 지우면 됩니다.
구독 그룹
활성화됨
주요 구독
자동 업데이트 · 그룹 필터
✓
백업 구성
수동 업데이트 · 독립 관리
○
필터 조건
포함 키워드
연결 방식
시스템 프록시와 TUN 모드의 용도 구분
시스템 프록시는 브라우저와 운영체제 프록시 설정을 따르는 데스크톱 프로그램에 적합합니다. 활성화가 간단하고 처음 연결할 때 문제를 확인하기도 쉽습니다. TUN 모드는 가상 네트워크 인터페이스로 더 다양한 앱 트래픽을 처리하므로 시스템 프록시를 읽지 않는 소프트웨어에 적합하지만, 추가 권한이 필요할 수 있고 다른 네트워크 도구, 가상 네트워크 어댑터 또는 방화벽 규칙의 영향을 받을 수 있습니다.
먼저 시스템 프록시로 구독 가져오기, 서버 선택, 웹 접속을 확인하는 것이 좋습니다. 기본 연결이 정상임을 확인한 뒤 앱 요구에 따라 TUN으로 전환하세요. 전환 후 로컬 서비스에 접근할 수 없거나 네트워크가 끊기면 TUN을 먼저 종료하고 권한, 라우팅, DNS 옵션을 점검해야 합니다. 여러 설정을 동시에 변경하지 마세요.
프록시 진입점
GENERAL
시스템 프록시
브라우저 및 데스크톱 프로그램
TUN 모드
가상 네트워크 인터페이스
로컬 네트워크 연결
필요할 때 별도로 활성화
규칙 우선순위
직접 연결·프록시·차단 규칙의 순서 명확히 하기
라우팅 분기는 도메인, IP, 포트 또는 네트워크 유형에 따라 연결 출구를 결정합니다. 일반적으로 로컬 네트워크 주소와 로컬 서비스는 직접 연결로 유지하고, 프록시가 필요한 대상은 현재 서버로 보내며, 접근할 필요가 없는 대상은 차단 규칙에 넣습니다. 규칙은 대개 위에서 아래 순서로 매칭되므로 범위가 좁은 예외 규칙을 일반 규칙보다 앞에 배치해야 더 넓은 조건에 먼저 걸리지 않습니다.
분기 설정을 조정할 때는 한 번에 한 그룹의 규칙만 변경하고 특정 웹사이트나 앱으로 결과를 확인하세요. 도메인 기반 규칙인데 연결에는 IP만 나타난다면 DNS 해석과 도메인 스니핑 설정도 함께 점검해야 합니다. 복잡한 규칙에는 짧은 메모를 남겨 나중에 설정 목적을 쉽게 파악할 수 있도록 하세요.
라우팅 규칙
위에서 아래로
private
직접 연결
domain:example
프록시
protocol:bittorrent
차단
규칙을 드래그해 매칭 순서 조정
해석 경로
DNS 조회와 라우팅 결과 연결하기
DNS 설정은 도메인이 어떤 주소로 해석되는지 결정하며, 라우팅 규칙이 대상을 올바르게 식별하는 데도 간접적으로 영향을 줍니다. 기본 사용에서는 클라이언트 권장 설정을 유지한 채 구독과 시스템 프록시가 정상 작동하는지 먼저 확인하세요. 직접 연결 도메인과 프록시 도메인을 다르게 처리해야 한다면 해석 서버를 나누고 조회 경로를 최종 연결 출구와 일치시켜 해석 결과와 실제 라우팅이 충돌하지 않도록 하세요.
웹페이지는 열리지만 앱 연결에 실패하거나, 같은 도메인의 결과가 계속 바뀌거나, 모드 전환 후 잠시 이상이 생긴다면 먼저 시스템 DNS 캐시를 비우고 클라이언트를 다시 시작하세요. DNS, TUN, 라우팅 규칙을 동시에 크게 변경하면 문제가 어느 계층에서 발생했는지 판단하기 어렵습니다.
DNS 설정
DNS
직접 연결 조회
로컬 네트워크 따름
프록시 조회
라우팅 규칙에 따라 처리
해석 결과 캐시
반복 조회 줄이기
운영체제별 선택
네 플랫폼의 클라이언트 다운로드
데스크톱에서는 v2rayN을 우선 선택하고, Android에서는 코어 요구사항에 따라 v2rayNG와 v2flyNG 중에서 고를 수 있습니다. 다운로드 페이지에서 프로세서 아키텍처와 설치 형식에 맞는 파일을 선택하세요.
macOS
v2rayN macOS 빌드를 사용하세요. 다운로드 전에 시스템 정보에서 Apple Silicon 또는 Intel 프로세서인지 확인하고 알맞은 설치 파일을 선택해 아키텍처 불일치를 피하세요. 처음 실행한 뒤 시스템 안내에 따라 필요한 권한을 승인합니다.
Android
Xray 코어를 사용하는 v2rayNG를 우선 선택하세요. V2Fly 코어가 필요하다면 v2flyNG를 사용할 수 있습니다. 최근 출시된 대부분의 기기는 arm64 빌드에 적합하며, 프로세서 아키텍처를 확인할 수 없다면 범용 빌드를 선택하세요.
Linux
v2rayN Linux 빌드를 사용하고 배포판의 패키지 관리 체계에 맞춰 deb 또는 rpm을 선택하세요. x64와 arm64 아키텍처도 구분해야 합니다. 설치가 끝나면 데스크톱 실행 메뉴에서 시작해 시스템 프록시 또는 TUN을 설정할 수 있습니다.
빠른 시작
설치 후 세 가지 작업
처음 설정할 때는 정해진 순서대로 진행하는 것이 좋습니다. 먼저 구독을 가져오고, 서버를 선택해 실제 연결 테스트를 완료한 뒤 시스템 프록시를 켜고 출구 주소를 확인하세요. 각 단계의 결과가 명확해 구독, 서버, 로컬 프록시 설정 중 어디에서 문제가 생겼는지 빠르게 찾을 수 있습니다.
전체 가이드 보기 →-
01
구독 가져오기 및 그룹 업데이트
클라이언트에서 구독 그룹을 열고 새 그룹을 만든 다음 서비스 제공업체가 안내한 구독 주소를 붙여 넣어 저장하고 업데이트를 실행하세요. 업데이트가 끝나면 구성 항목이 표시되어야 합니다. 목록이 비어 있다면 그룹이 활성화되어 있는지, 주소 앞뒤에 공백이 섞이지 않았는지, 현재 네트워크에서 구독 출처에 접근할 수 있는지 먼저 확인하세요. 그룹을 계속 새로 만들기보다 로그에서 업데이트 요청 결과를 확인하는 것이 우선입니다.
-
02
서버 선택 및 실제 연결 테스트
현재 구독 그룹에서 항목 하나를 선택해 실제 연결 테스트를 실행하거나 활성 서버로 지정하세요. 테스트 결과는 실제 연결에 필요한 시간을 보여 주므로 단순한 네트워크 탐색보다 일상적인 사용 상황에 가깝습니다. 여러 항목에 모두 연결할 수 없다면 구독 만료 여부, 시스템 시간의 정확성, 코어가 정상적으로 로드되었는지를 먼저 확인하세요. 프록시 모드를 연속해서 바꾸는 것은 피해야 합니다.
-
03
시스템 프록시 활성화 및 출구 확인
처음 연결할 때는 시스템 프록시를 켠 다음 브라우저로 자주 사용하는 웹페이지에 접속해 출구 주소가 예상대로 바뀌었는지 확인하세요. 브라우저는 정상인데 다른 프로그램에 적용되지 않는다면 해당 프로그램이 시스템 프록시를 따르지 않는 경우가 많습니다. 이때 TUN 모드나 앱 자체의 프록시 옵션을 검토하세요. 확인이 끝나면 라우팅 규칙, 시작 시 실행, 구독 업데이트 간격을 설정할 수 있습니다.
오픈 소스 생태계 안내
Project V, V2Fly 및 Xray 코어 계열
클라이언트와 코어의 관계를 이해하면 업데이트 내용이 인터페이스 계층, 핵심 처리 계층, 프로토콜 구현 계층 중 어디에 해당하는지 판단하기 쉽습니다. 그래픽 클라이언트는 구독, 목록, 규칙과 시스템 통합을 담당하고, 코어는 프로토콜 처리, 라우팅 실행과 네트워크 연결을 담당합니다. 역할이 다르므로 릴리스 주기도 서로 다를 수 있습니다.
Project V 생태계의 출발점
Project V는 프록시 프로토콜, 라우팅 기능과 조합 가능한 네트워크 도구를 중심으로 형성된 오픈 소스 생태계입니다. 초기 V2Ray는 구성 구조와 다중 인바운드·다중 아웃바운드, 라우팅 매칭 등의 기본 개념을 마련했고, 이후 커뮤니티의 유지보수 방향이 여러 분기로 나뉘었습니다. 오늘날 널리 쓰이는 클라이언트는 모든 기능을 다시 구현하는 대신 코어를 호출해 복잡한 설정을 데스크톱이나 모바일 기기에서 다루기 쉬운 그래픽 인터페이스로 정리합니다.
따라서 “V2Ray 클라이언트”라는 표현을 볼 때는 세 가지 계층을 구분해야 합니다. 사용자가 조작하는 그래픽 클라이언트, 연결과 규칙을 실행하는 코어, 그리고 구독이나 수동 설정으로 정의되는 프로토콜 매개변수입니다. 장애를 점검할 때도 계층별로 판단해야 합니다. 인터페이스에 항목이 가져와지지 않으면 구독 관리 문제이고, 코어 시작에 실패하면 코어 문제이며, 특정 도메인의 출구가 예상과 다르면 대개 라우팅이나 DNS 문제입니다.
V2Fly와 Xray의 역할 차이
V2Fly는 V2Ray 커뮤니티 분기의 유지보수 방향을 이어 가며 조합 가능한 구성 체계를 유지하고 프로토콜, 전송 및 라우팅 기능을 계속 업데이트합니다. Xray는 생태계의 또 다른 코어 계열로, 일반적인 구성 방식을 호환하면서 자체적인 프로토콜 구현과 기능 조합을 발전시켜 왔습니다. 둘 다 그래픽 클라이언트가 아니며 특정 운영체제의 앱 인터페이스와 동일한 것도 아닙니다.
코어를 선택할 때는 구독에 필요한 프로토콜, 클라이언트 지원 여부와 기존 구성의 호환성을 우선 확인해야 합니다. 대부분의 사용자는 코어를 자주 수동 전환할 필요가 없습니다. 구독 제공업체가 특정 코어 기능을 명시했거나 로그에 현재 코어가 구성 필드를 인식하지 못한다는 메시지가 있을 때 안내에 따라 조정하세요. 코어 업데이트 후 동작이 달라지면 클라이언트 로그와 구성 마이그레이션 안내를 먼저 확인하고, 모든 구독과 라우팅을 한꺼번에 다시 설정하지 않는 것이 좋습니다.
세 클라이언트의 역할
v2rayN은 데스크톱 플랫폼에서 널리 사용하는 그래픽 클라이언트로 Windows, macOS, Linux를 지원하며 구독 그룹, 서버 목록, 시스템 프록시, TUN, 라우팅, DNS, 코어 관리 기능을 제공합니다. 데스크톱 운영체제마다 권한 부여 방식과 시스템 통합 세부사항은 다를 수 있지만 주요 설정 흐름은 일관적이어서 여러 데스크톱 플랫폼에서 같은 사용 방식을 유지하려는 사용자에게 적합합니다.
v2rayNG는 Android용으로, 일반적으로 Xray 코어와 함께 사용하며 구성 목록, 구독 업데이트, 라우팅과 연결 전환을 중심으로 구성되어 있습니다. v2flyNG도 Android용이지만 V2Fly 코어를 사용하므로 특정 코어가 필요한 경우의 대안으로 적합합니다. 두 모바일 클라이언트 모두 구독을 가져올 수 있고 별도 구성을 관리할 수도 있습니다. 마이그레이션할 때는 먼저 구독이 지원하는 프로토콜과 필드를 확인하세요.
오픈 소스와 업데이트 방식
클라이언트와 코어는 오픈 소스 방식으로 유지보수되며 기능 논의, 버그 수정과 릴리스는 각 프로젝트 커뮤니티가 진행합니다. 오픈 소스 라이선스는 코드 사용과 재배포의 범위를 정하고 구현 세부사항을 검토할 수 있게 합니다. 프로젝트마다 적용하는 구체적인 라이선스가 다를 수 있으므로 코드를 사용, 수정 또는 재배포할 때는 프로젝트에 포함된 라이선스 전문을 기준으로 하세요.
클라이언트 업데이트는 보통 인터페이스, 시스템 통합, 구독 처리와 코어 호출 방식에 영향을 주며, 코어 업데이트는 프로토콜 구현, 전송, 라우팅, DNS와 실행 효율에 더 집중됩니다. 두 업데이트가 항상 동시에 진행되는 것은 아닙니다. 일상적으로는 릴리스 노트를 먼저 읽고 구성 마이그레이션이나 시스템 권한 변경이 포함되어 있는지 확인한 뒤 업데이트하세요. 문제가 생겼을 때는 단순히 “연결할 수 없음”이라고 설명하는 것보다 로그와 현재 구성을 보존하는 편이 원인 파악에 도움이 됩니다.
기술 노트
클라이언트와 오픈 소스 생태계 더 알아보기
아래 세 글에서는 메인 화면 구조, 코어 생태계의 관계, 여러 구독 관리 방법을 다룹니다. 첫 연결을 완료한 뒤 이어서 읽기에 적합합니다.
v2rayN 메인 화면 기능 해설: 서버 목록, 구독 그룹, 로그 및 설정 영역
영역별로 서버 목록 각 열의 의미, 구독 그룹 태그, 로그 창과 매개변수 설정 진입점을 나누어 살펴보고 명확한 화면 조작 순서를 익힙니다.
전문 읽기 →Project V, V2Fly와 Xray의 관계: 오픈 소스 생태계 및 클라이언트 대응 정리
Project V의 기원, V2Fly 커뮤니티 분기와 Xray 코어 계열, 그리고 v2rayN·v2rayNG·v2flyNG 각각의 플랫폼과 코어를 정리합니다.
전문 읽기 →v2rayN 구독 그룹 설정: 여러 출처의 구독 관리와 서버 필터링 실전
구독 그룹으로 서로 다른 출처를 분리하고 업데이트 시간과 키워드 필터 조건을 각각 설정한 뒤 그룹별로 서버 목록을 일괄 테스트하고 정리합니다.
전문 읽기 →자주 묻는 질문
설치·구독·연결의 점검 순서
처음 사용할 때 발생하는 대부분의 문제는 “설치 파일—구독 업데이트—서버 연결—시스템 프록시—라우팅 및 DNS” 순서로 점검할 수 있습니다. 한 번의 작업에서 여러 계층을 동시에 수정하지 마세요. 어떤 변경이 결과를 만들었는지 확인하기 어려워집니다.
데스크톱에서는 어떤 클라이언트를 먼저 선택해야 하나요?
Windows, macOS, Linux에서는 먼저 v2rayN을 선택할 수 있습니다. 구독 그룹, 서버 목록, 시스템 프록시, TUN, 라우팅과 DNS를 하나의 데스크톱 인터페이스에서 관리할 수 있습니다. 다운로드 전에 운영체제와 프로세서 아키텍처를 확인하고, 설치 후 시스템 프록시로 기본 연결을 검증한 다음 앱 요구사항에 따라 TUN 사용 여부를 결정하세요.
구독을 가져온 뒤 서버 목록이 비어 있으면 어떻게 하나요?
먼저 구독 그룹이 활성화되어 있는지 확인하고 수동으로 한 번 업데이트하세요. 그런 다음 로그에 주소에 접근할 수 없음, 콘텐츠 형식을 인식할 수 없음, 네트워크 요청 실패 등의 메시지가 있는지 확인합니다. 구독 주소 앞뒤에 공백이 포함되어 있지 않은지도 점검하세요. 업데이트는 성공했지만 필터 적용 후 목록이 비어 있다면 그룹 필터 조건을 지우고 원본 항목을 다시 확인하세요.
시스템 프록시와 TUN 모드를 동시에 켜야 하나요?
처음 사용할 때는 동시에 켜지 않는 것이 좋습니다. 먼저 시스템 프록시로 브라우저와 자주 사용하는 데스크톱 프로그램을 확인하고 구독, 서버, 코어가 정상적으로 작동하는지 검증하세요. 시스템 프록시를 사용하지 않는 앱을 실제로 인계해야 할 때만 TUN을 별도로 테스트하세요. 전환 중 네트워크 문제가 생기면 원래 모드로 되돌린 뒤 권한, 가상 네트워크 어댑터, 라우팅과 DNS를 하나씩 점검하세요.
테스트는 정상인데 특정 앱만 연결되지 않는 이유는 무엇인가요?
테스트가 정상이라는 것은 클라이언트가 현재 서버와 연결을 수립할 수 있다는 뜻일 뿐, 모든 앱이 자동으로 시스템 프록시를 사용한다는 의미는 아닙니다. 먼저 해당 앱이 시스템 프록시를 따르는지 확인하고, 앱 자체의 독립 프록시 설정 여부, 특수 네트워크 인터페이스 사용 여부, 라우팅 규칙이 대상을 직접 연결 또는 차단으로 지정했는지를 점검하세요. 도메인 접속에서만 문제가 발생한다면 DNS 해석 경로도 확인해야 합니다.