V2Ray 클라이언트 설정 질문과 답변

V2Ray 질문답변 허브: v2rayN 클라이언트 다운로드 및 설정

v2rayN 다운로드 사용법 보기

현재 기기에 맞는 클라이언트를 선택한 뒤 구독 가져오기, 시스템 프록시, 라우팅 분할을 차례로 설정하세요. 각 항목에 설정 위치, 적용 상황, 확인 방법을 함께 안내합니다.

영구 무료 오픈 소스 한국어 단계 안내 다중 코어 생태계
플랫폼 선택 Windows Android macOS Linux
구독 업데이트 완료
v2rayN · 설정
라우팅 모드
전체 로컬 네트워크 및 중국 본토 우회 사용자 지정

시스템 프록시

시스템 네트워크 설정을 사용하는 앱을 현재 노드로 연결합니다

TUN 모드

시스템 프록시 설정을 읽지 않는 앱의 트래픽을 가로챕니다

구독 업데이트 노드 목록이 새로 고쳐졌습니다
설정 문제 바로 답하기

구독 가져오기부터 라우팅 분할까지, 문제별 설정 찾기

현재 막힌 단계를 먼저 선택하세요. 각 답변에는 설정 위치, 권장 순서, 완료 후 확인 방법이 포함되어 있어 여러 메뉴를 오가며 반복해서 수정할 필요가 없습니다.

구독 관리

구독 링크를 가져온 뒤 왜 수동으로 업데이트해야 하나요?

구독 추가는 클라이언트에 주소를 저장하는 단계일 뿐이며, 노드 목록은 보통 “구독 업데이트”를 실행해야 기록됩니다. 링크 전체를 복사해 구독 그룹에 항목을 추가하고 저장한 다음 업데이트를 한 번 실행하세요. 이후 메인 창에 노드가 표시되는지 확인합니다. 목록이 계속 비어 있다면 먼저 업데이트 알림을 확인하고 링크가 잘리지 않았는지, 구독이 유효한지, 현재 네트워크에서 구독 주소에 접속할 수 있는지 차례로 점검하세요. 같은 그룹을 여러 개 연속으로 만들지는 마세요.

노드가 표시되면 기본 그룹 구조는 그대로 둔 채 노드 하나를 선택해 연결 테스트를 실행하세요. 기본 연결이 정상인지 확인한 뒤 라우팅과 프록시 모드를 조정하면 “구독 파싱 문제”와 “로컬 프록시 설정 문제”를 나누어 판단할 수 있습니다.

구독 그룹

링크와 그룹 이름 저장

추가됨
구독 업데이트

노드 목록 다시 가져오기 및 파싱

업데이트 실행
결과 확인

메인 창으로 돌아가 노드 항목 확인

완료
시스템별 선택

네 가지 플랫폼의 V2Ray 클라이언트 안내

데스크톱에서는 먼저 v2rayN을 확인하고, Android에서는 코어 요구 사항에 따라 v2rayNG와 v2flyNG 중에서 선택하세요. 플랫폼별 페이지에서 설치 방식, 시스템 요구 사항, 아키텍처 선택도 이어서 안내합니다.

Windows

Windows 사용자는 v2rayN의 최신 데스크톱 인터페이스와 클래식 WPF 인터페이스 중에서 선택할 수 있습니다. 처음에는 프로그램이 정상적으로 실행되는지 확인한 뒤 구독을 가져오고 노드를 선택해 시스템 프록시를 켜세요. 시스템 프록시를 사용하지 않는 앱까지 연결해야 한다면 그때 TUN을 별도로 설정해 초기 단계에서 네트워크 조건을 과도하게 바꾸지 않도록 합니다.

  • 일반적인 데스크톱 프록시와 규칙 기반 라우팅에 적합
  • 데스크톱 인터페이스와 클래식 WPF 선택 제공
  • 시스템 프록시, 라우팅 규칙, TUN 지원
다운로드 페이지로 이동

macOS

macOS에서 v2rayN을 사용할 때는 먼저 시스템 정보에서 프로세서 유형을 확인한 뒤 Apple Silicon 또는 Intel에 맞는 설치 항목을 선택하세요. 처음 실행할 때 필요한 권한을 승인한 후 구독을 가져오고, 시스템 프록시로 기본 연결을 먼저 확인합니다. 앱이 독립 네트워크 스택을 사용한다면 로그를 바탕으로 연결 범위를 넓혀야 하는지 판단하세요.

  • 프로세서 유형에 맞는 설치 항목 선택
  • 처음 실행할 때 시스템 권한 승인 필요
  • 설정 방식은 데스크톱 버전과 동일
다운로드 페이지로 이동

Android

Android에서는 Xray 코어를 사용하는 v2rayNG를 먼저 확인하고, 구독 및 프로토콜 요구 사항에 따라 V2Fly 코어를 사용하는 v2flyNG를 선택할 수도 있습니다. 최근 출시된 대부분의 기기는 먼저 arm64 설치 항목을 확인하세요. 아키텍처를 모를 때는 범용 설치 항목 안내를 읽으면 됩니다. 구독을 가져온 뒤에는 로컬 네트워크 연결 권한을 요청하므로 연결하기 전에 선택한 노드와 라우팅 모드를 확인하세요.

  • v2rayNG는 Xray 코어 사용
  • v2flyNG는 V2Fly 코어 선택 제공
  • 기기 아키텍처에 맞는 설치 항목 선택
다운로드 페이지로 이동

Linux

Linux에서는 배포판의 패키지 체계에 맞춰 v2rayN을 선택하세요. Debian, Ubuntu 등은 보통 deb 패키지를, RPM 패키지 관리자를 사용하는 배포판은 rpm 패키지를 확인하고 프로세서 아키텍처도 함께 점검해야 합니다. 설치 후에는 먼저 GUI에서 구독과 노드를 확인한 다음 데스크톱 환경의 프록시를 설정하면 명령줄 매개변수와 클라이언트 설정이 서로 덮어쓰는 문제를 줄일 수 있습니다.

  • 배포판에 따라 deb 또는 rpm 선택
  • x64와 arm64 아키텍처도 함께 확인
  • 먼저 클라이언트 확인 후 데스크톱 프록시 설정
다운로드 페이지로 이동
전체 클라이언트 보기
세 단계로 시작하기

최소한의 작동 설정부터 구성한 뒤 고급 설정 추가

처음 설정할 때는 구독, 노드, 시스템 프록시 세 가지만 처리하세요. 기본 연결이 정상인지 확인한 다음 사용자 지정 라우팅이나 TUN을 추가하면 각 단계의 확인 결과가 분명해집니다.

  1. 01

    구독 가져오기 및 노드 업데이트

    클라이언트의 구독 그룹 또는 구독 설정에서 링크를 추가하고 저장한 뒤 업데이트를 실행하세요. 완료 기준은 “링크를 입력했다”가 아니라 메인 창에 선택 가능한 노드 항목이 표시되는 것입니다. 업데이트 오류가 반환되면 먼저 알림 내용을 보존하고 링크의 완전성, 구독 상태, 네트워크 접속 조건을 확인하세요. 원인을 찾기 전에 같은 구독을 반복해서 추가하지 마세요. 중복 그룹이 판단을 어렵게 만듭니다.

    노드 목록이 표시되면 먼저 노드 하나를 선택해 기본 연결 테스트를 실행하세요. 이 단계에서는 고급 라우팅 규칙을 수정하거나 여러 연결 옵션을 동시에 켜지 말고, 클라이언트 자체가 연결을 만들 수 있는지 확인합니다.

  2. 02

    라우팅 모드와 시스템 프록시 선택

    일상적인 설정은 “로컬 네트워크 및 중국 본토 우회”에서 시작한 뒤 시스템 프록시를 켜면 됩니다. 브라우저를 다시 열어 테스트할 페이지에 접속하고 클라이언트 로그에 해당 도메인이 표시되는지 확인하세요. 로그에 요청은 있지만 연결에 실패하면 노드와 프로토콜 매개변수를 확인하고, 요청이 없다면 브라우저가 시스템 네트워크 설정을 읽는지와 별도 프록시 설정이 있는지를 점검하세요.

    라우팅 모드는 트래픽 매칭 방식을 바꾸고, 시스템 프록시는 앱이 연결을 클라이언트에 넘길지를 결정합니다. 두 설정은 해결하는 문제가 다르므로 각각 따로 확인해야 프록시가 트래픽을 가로채지 못한 상황을 라우팅 규칙 오류로 오해하지 않습니다.

  3. 03

    결과 확인 후 TUN 설정

    브라우저가 시스템 프록시로 정상 접속하지만 특정 프로그램의 트래픽이 계속 클라이언트에 들어오지 않을 때 TUN을 고려하세요. 시스템에서 요구하는 권한을 승인한 후 대상 프로그램을 다시 시작하고 로그를 확인합니다. 로컬 네트워크 접속이나 이름 확인이 달라지면 라우팅 제외 항목, DNS 설정, 권한 상태를 차례로 점검하고 구독과 노드를 동시에 교체하지 마세요.

    최종 확인에는 세 가지 결과가 포함되어야 합니다. 클라이언트에 현재 노드가 선택된 것으로 표시되고, 대상 앱의 요청이 로그에 들어오며, 연결 가로채기 설정을 끄면 네트워크 동작이 복구되어야 합니다. 세 결과를 모두 재현할 수 있다면 기본 설정 경로가 명확해진 것입니다.

전체 사용법 보기
오픈 소스 생태계 관계

Project V, V2Fly, Xray는 각각 어떤 위치에 있나요?

코어, 클라이언트, 구독의 계층을 이해하면 선택 과정에서 혼동을 줄일 수 있습니다. 클라이언트는 GUI, 구독 관리, 시스템 프록시 조작을 담당하고 코어는 프로토콜 처리, 전송, 라우팅을 실행하며 구독은 노드 매개변수를 제공합니다. 서로 관련되어 있지만 같은 구성 요소는 아닙니다.

생태계 개념 Project V
코어 계열 V2Fly
코어 계열 Xray
GUI 클라이언트 v2rayN · v2rayNG · v2flyNG

Project V는 생태계의 배경이며 특정 GUI 클라이언트와 동일하지 않습니다

Project V는 프록시 프로토콜, 전송 방식, 라우팅 기능을 중심으로 오픈 소스 기술 생태계를 형성했습니다. 사용자가 일상적으로 접하는 v2rayN, v2rayNG, v2flyNG는 GUI 클라이언트로, 구독·노드·라우팅·시스템 연결 기능을 조작 가능한 화면으로 구성합니다. 문제가 발생하면 모든 현상을 “V2Ray이 작동하지 않는다”로 묶기보다 클라이언트 화면, 코어 실행, 구독 데이터, 로컬 네트워크 중 어디에서 문제가 생겼는지 먼저 판단해야 합니다.

예를 들어 구독 업데이트 후 노드가 비어 있다면 먼저 구독 파싱을 확인하고, 노드 테스트는 되지만 앱 요청이 로그에 없다면 시스템 프록시나 TUN 연결을 확인하세요. 요청이 이미 코어에 들어왔는데 연결에 실패한다면 프로토콜 매개변수, 노드 상태, 시스템 시간, 회선을 점검합니다. 계층별로 원인을 좁히는 편이 클라이언트를 계속 바꾸는 것보다 재현 가능한 결론을 얻기 쉽습니다.

V2Fly와 Xray는 대표적인 두 코어 계열입니다

V2Fly는 V2Ray 관련 핵심 기능을 이어받아 유지하고 있으며, Xray는 유사한 설정 방식을 바탕으로 자체 구현과 기능 범위를 발전시켰습니다. 두 코어 모두 인바운드, 아웃바운드, 라우팅, DNS, 전송 등의 개념을 다루지만 지원 항목과 설정 세부 사항은 다를 수 있습니다. 구독 서비스가 특정 프로토콜이나 전송 매개변수를 제공한다면 클라이언트가 호출하는 코어가 해당 내용을 인식할 수 있어야 합니다.

따라서 클라이언트는 화면 이름만 보고 선택해서는 안 되며 어떤 코어를 사용하는지도 확인해야 합니다. v2rayNG는 일반적으로 Xray 코어에 해당하고 v2flyNG는 V2Fly 코어에 해당합니다. v2rayN은 데스크톱 플랫폼의 GUI 관리 진입점으로 노드, 라우팅, 시스템 프록시, TUN 등 주요 설정을 제공합니다. 프로토콜 호환 문제가 발생하면 단순히 “노드가 작동하지 않는다”고 말하기보다 클라이언트 이름, 사용 코어, 구체적인 오류를 기록하는 편이 문제 해결에 도움이 됩니다.

세 클라이언트는 역할이 다르지만 설정 개념은 서로 대응할 수 있습니다

v2rayN은 Windows, macOS, Linux 데스크톱 환경을 대상으로 하며 구독 그룹, 라우팅 규칙, 시스템 프록시, TUN을 관리해야 하는 상황에 적합합니다. v2rayNG는 Android용으로 Xray 코어에 맞는 구독과 프로토콜에 주로 사용됩니다. v2flyNG 역시 Android용이지만 V2Fly 코어 방향의 선택을 제공합니다. 세 제품의 화면과 진입점은 다르지만 핵심 작업은 설정 가져오기, 노드 선택, 라우팅 결정, 연결 가로채기 활성화, 로그 확인으로 정리할 수 있습니다.

기기 간에 설정을 옮길 때는 버튼 이름만 비교하지 마세요. 먼저 구독이 정상적으로 파싱되는지 확인하고 노드 프로토콜, 전송 매개변수, 라우팅 정책, DNS 동작을 대조하세요. 설정을 이런 안정적인 개념으로 나누면 화면 배치가 달라져도 대응하는 항목을 빠르게 찾을 수 있습니다.

오픈 소스이므로 구성 요소와 변경 기록을 기준으로 문제를 논의할 수 있습니다

오픈 소스 클라이언트와 코어는 커뮤니티에서 지속적으로 유지 관리되며 기능 변경, 프로토콜 지원, 문제 수정이 화면 계층과 코어 계층에서 별도로 이루어질 수 있습니다. 클라이언트를 업데이트할 때는 먼저 릴리스 노트를 읽고 이번 변경이 화면, 코어, 시스템 통합 중 어디에 해당하는지 확인하세요. 현재 구독과 사용자 지정 라우팅을 백업한 뒤 업데이트하고 회귀 테스트를 진행합니다. 업데이트 후 차이가 발생하면 같은 노드, 같은 라우팅 모드, 같은 테스트 대상을 기준으로 비교하세요.

확인 가능한 유지 관리 습관에는 주요 설정 기록, 한 번에 조건 하나만 변경, 오류 메시지 보존, 시스템 시간 확인, 만료된 구독 그룹 정기 정리가 포함됩니다. 이런 방식은 특정 화면 위치에 의존하는 것보다 안정적이며 여러 플랫폼에서 문제 해결 방법을 재사용할 수 있습니다.

최근 글

설치, 구독, 라우팅 규칙 추가 안내

아래 글은 각기 하나의 구체적인 문제를 다룹니다. 기본 연결을 완료한 뒤 플랫폼 차이, 구독 오류, 사용자 지정 규칙 작성법을 더 확인할 때 적합합니다.

시작 가이드

v2rayN 처음 설치하고 설정하는 전체 과정: Windows와 macOS 공통 사항 및 자주 겪는 문제

다운로드와 첫 실행부터 시작해 데스크톱 플랫폼별 실행 조건, 시스템 권한, 시작 프로그램 등록, 시스템 프록시 설정을 설명합니다. 공통 작업과 플랫폼별 차이를 나누어 다루고 단계마다 완료 후 확인 위치를 제시하므로 v2rayN을 처음 설정할 때 항목별로 따라 하기 좋습니다.

설치 및 설정
문제 해결

V2Ray 구독이 작동하지 않을 때: 파싱 실패의 주요 원인 6가지와 점검 순서

구독 업데이트 오류, 빈 노드 목록, 일부 항목만 표시되는 경우에는 먼저 링크 가져오기 실패와 콘텐츠 파싱 실패를 구분하세요. 링크 완전성, 구독 상태, 인코딩된 콘텐츠, 접속 경로, 클라이언트 호환성, 시간 요인을 순서대로 점검해 여러 조건을 동시에 바꾸지 않도록 안내합니다.

구독 관리
고급 활용

V2Ray 사용자 지정 라우팅 규칙 작성법: domain, ip, geosite 문법과 매칭 우선순위

사용자 지정 라우팅의 핵심은 규칙을 작성하는 데 그치지 않고 매칭 대상, 규칙 순서, 최종 아웃바운드를 명확히 하는 것입니다. domain, ip, geosite의 적용 범위를 각각 설명하고 위에서부터 규칙을 판단할 때 발생하기 쉬운 덮어쓰기 관계와 확인하기 쉬운 테스트 절차를 소개합니다.

라우팅 분할
전체 글 보기
V2Ray 클라이언트 다운로드