클라이언트 설치 · 구독 · 트래픽 분할

V2Ray 입문 가이드

플랫폼에 맞는 오픈 소스 클라이언트를 선택하고 구독을 가져온 다음 라우팅 규칙을 설정하세요.

  • v2rayN
  • v2rayNG
  • v2flyNG

구독 가져오기
및 라우팅 규칙

  • 먼저 설정을 가져오고 트래픽을 연결하세요
  • 시스템 프록시와 TUN은 별도로 설정
  • 예시 화면이며 현재 실행 상태를 나타내지 않습니다

클라이언트 설정은 세 가지 질문으로 나눠 볼 수 있습니다. 설정을 어디서 가져오는지, 앱 트래픽을 어떻게 코어로 전달하는지, 전달된 트래픽이 어떤 경로로 나가는지입니다. 구독은 첫 번째 문제를, 시스템 프록시나 TUN은 두 번째 문제를 해결합니다. 라우팅 규칙과 DNS는 세 번째 문제에 함께 영향을 줍니다. 이 순서대로 설정하면 오류가 발생했을 때 원인을 좁히기 쉬워지고, 여러 설정 화면을 오가며 반복해서 바꿀 필요가 없습니다.

아래에서는 실제 설정 항목을 바탕으로 각 계층의 역할을 설명합니다. 데스크톱은 v2rayN을 기준으로 하고, 모바일에서는 v2rayNG 또는 v2flyNG에서 해당 기능을 찾아보세요. 클라이언트마다 메뉴 위치와 명칭이 다를 수 있습니다. 가져온 노드 매개변수만으로 로컬 설정 전체가 구성되는 것은 아닙니다. PC에서 휴대폰으로 옮긴 뒤에도 앱별 정책, DNS, 라우팅 모드를 다시 확인해야 합니다.

v2rayN / 구독 관리
구독 그룹먼저 그룹을 추가한 뒤 구독 주소를 입력합니다
그룹 설정
구독 가져오기구독 주소와 단일 노드 공유 링크는 별도로 처리합니다
구독 업데이트
활성 서버가져온 목록에서 직접 선택합니다
selected
업데이트 방식처음 가져올 때는 직접 연결이 가능한지 먼저 확인합니다
직접 연결프록시 경유

구독 관리는 노드 매개변수를 한곳에서 업데이트하는 기능입니다. 신뢰할 수 있는 출처의 주소를 구독 그룹에 입력하고 저장한 뒤 업데이트를 실행해 목록에서 활성 서버를 선택하세요. 구독 주소에는 보통 접근 자격 증명이 포함되므로 공개 스크린샷이나 채팅 기록에 올리거나 온라인 변환 도구에 입력하지 않는 것이 좋습니다. 공유 링크를 하나씩 붙여 넣는 것보다 그룹 단위로 업데이트하면 여러 기기의 노드를 일관되게 관리할 수 있지만, 로컬 라우팅·DNS·앱별 설정은 대개 동기화되지 않습니다. 업데이트에 실패하면 먼저 요청에 연결할 수 있는지 확인하고, 그다음 주소가 만료되었는지 살펴보세요. 기존 설정을 전부 바로 삭제하지 마세요.

단계별 첫 설정 가이드 →

4개 플랫폼
운영체제에 맞는 설치 파일 선택

  • 데스크톱은 v2rayN 우선
  • 모바일은 v2rayNG 우선
  • 아키텍처와 패키지 형식은 다운로드 페이지에서 확인

설치 파일을 고를 때는 운영체제를 먼저 확인하고, 다음으로 프로세서 아키텍처를 확인하세요. 인터페이스 버전이나 패키지 형식은 그다음입니다. 호환되는 클라이언트라면 같은 구독을 사용할 수 있지만, 설치 파일은 플랫폼 간에 서로 바꿔 쓸 수 없습니다. 기기를 바꿀 때 프로그램 폴더 전체를 범용 백업처럼 덮어쓰지 마세요. 노드 정보, 클라이언트 기본 설정, 시스템 연동 설정은 각각 따로 관리해야 합니다.

Windows

v2rayN 추천

v2rayN 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 데스크톱 사용 방식을 유지합니다. 처음 설치한다면 데스크톱 버전부터 사용해 보세요. 기존 사용 방식에 익숙하다면 시스템 요구 사항과 현재 설정을 고려해 선택하면 됩니다. 인터페이스가 바뀌었다는 이유만으로 두 버전을 동시에 실행할 필요는 없습니다.

설치 후 구독을 가져와 활성 서버를 선택하고 시스템 프록시를 설정하세요. TUN이 필요하다면 관리자 권한, 가상 네트워크 어댑터, 다른 네트워크 도구의 점유 여부를 따로 확인하세요. 클라이언트를 종료한 뒤에도 브라우저에 접속할 수 없다면 프로그램을 반복해서 재설치하기보다 시스템 프록시가 복구되었는지 먼저 살펴보세요.

macOS

v2rayN

v2rayN은 Apple Silicon용과 Intel용 설치 파일을 제공합니다. 시스템의 “이 Mac에 관하여”에서 칩 정보를 확인하고 해당 아키텍처를 선택하세요. 설치한 뒤 응용 프로그램 폴더에서 실행하고, 시스템 안내에 따라 필요한 권한을 허용하면 됩니다. 보안 제한이 표시되면 파일 출처와 안내 내용을 먼저 확인하세요. 기기의 보안 기능을 통째로 끄지 마세요.

시스템 프록시 설정은 브라우저 확장 프로그램, 다른 프록시 앱, 현재 네트워크 서비스의 수동 설정과 충돌할 수 있습니다. 처음 연결을 확인할 때는 트래픽을 연결하는 방식을 하나만 사용하세요. 무선 네트워크를 바꾼 뒤 동작이 달라진다면 네트워크 서비스별 프록시 설정도 확인해야 합니다. 메뉴 막대의 연결 상태만으로 모든 앱이 프록시를 사용하는지 판단할 수는 없습니다.

Android

v2rayNG 추천

Xray 코어를 사용하는 v2rayNG를 우선 추천하며, v2fly 코어 환경이 필요할 때는 v2flyNG를 고려하세요. 최신 스마트폰 대부분에는 arm64 패키지가 적합합니다. 기기 아키텍처를 모르겠다면 다운로드 페이지에서 범용 버전 안내를 확인하세요. QR 코드, 공유 링크, 구독 주소는 용도가 서로 다르므로 가져오기 전에 제공된 설정 유형을 확인해야 합니다.

처음 연결할 때 시스템 VPN 권한을 허용해야 합니다. 앱별 프록시로 클라이언트에 연결할 앱을 정하고, 라우팅 규칙으로 해당 트래픽이 나갈 경로를 결정합니다. 백그라운드에서 연결이 끊기면 배터리 최적화와 제조사별 백그라운드 관리 설정을 확인하세요. 배터리가 계속 소모된다면 알림을 끄는 데 그치지 말고 실제 트래픽, 재연결, 앱 깨우기 동작을 살펴봐야 합니다.

Linux

v2rayN

배포판의 패키지 관리 체계에 맞춰 v2rayN deb 또는 rpm 패키지를 선택한 뒤 x64와 arm64 중 해당 아키텍처를 고르세요. 여기서 안내하는 데스크톱 클라이언트는 그래픽 세션이 필요하며 백그라운드 서비스와는 다릅니다. 설치 전에 데스크톱 환경과 실행 종속성을 확인하고, 설치 후에는 앱 메뉴에서 실행하세요. 서로 다른 아키텍처나 형식의 패키지를 섞어 설치하지 마세요.

데스크톱 환경에서 설정한 시스템 프록시를 터미널이나 일부 앱이 따르지 않을 수 있습니다. 브라우저에서는 접속되지만 특정 도구에서 연결되지 않는다면 해당 도구의 프록시 지원 여부를 확인하세요. TUN을 활성화하려면 가상 네트워크 인터페이스 권한과 시스템 라우팅도 고려해야 합니다. 컨테이너, 가상 머신 또는 다른 VPN을 사용 중이라면 네트워크 대역과 라우팅 우선순위가 충돌하지 않는지 살펴보세요.

설치 파일은 클라이언트만 설치합니다. 실제로 연결하려면 유효한 노드 설정이나 구독, 현재 네트워크에 맞는 트래픽 연결 방식이 필요합니다.

전체 클라이언트 보기 →

Project V 생태계
클라이언트와 코어의 역할

  • 그래픽 인터페이스는 관리와 시스템 연동 담당
  • 코어는 프로토콜·DNS 조회·라우팅 담당
  • 오픈 소스 라이선스와 노드 서비스는 별개
설정 실행 흐름 / 역할 안내client → core → outbound
그래픽 클라이언트v2rayN · v2rayNG · v2flyNG
구독 및 로컬 설정
코어 계열Xray · V2Fly
프로토콜 및 라우팅 실행
실제 아웃바운드규칙이 아웃바운드를 참조하며 인터페이스 이름으로 정해지지 않습니다
proxy / direct / block

Project V에서 코어 계열까지

Project V는 네트워크 프록시 기능을 중심으로 형성된 오픈 소스 생태계이며, V2Ray는 널리 사용되는 프로젝트 이름입니다. 생태계가 발전하면서 V2Fly는 관련 코어를 커뮤니티 중심으로 이어서 관리하고, Xray는 공통 기술 기반 위에서 독립적으로 발전했습니다. 두 프로젝트는 역사적으로 연결되어 있고 일부 프로토콜과 설정 개념을 공유하지만, 지원 기능과 구체적인 필드가 항상 같은 것은 아닙니다.

“V2Ray”를 검색하면 프로토콜, 코어, 클라이언트, 구독 서비스가 함께 나오는 경우가 많습니다. 하지만 이들은 같은 종류의 제품이 아닙니다. 클라이언트는 조작 인터페이스를 제공하고, 코어는 설정을 실행하며, 서버는 연결 대상을 제공합니다. 구독은 여러 노드 매개변수를 한 번에 배포하는 방식입니다. 계층을 구분해야 문제가 인터페이스, 설정, 시스템 네트워크, 서버 중 어디에 있는지 판단할 수 있습니다.

따라서 공유 링크를 인식했다고 해서 모든 매개변수가 현재 실행 환경에 맞게 설정되었다는 뜻은 아닙니다. 프로토콜이나 전송 방식이 호환되지 않는다면 “V2Ray 지원”이라는 포괄적인 설명만 믿기보다 서버 요구 사항에 맞는 코어 기능을 확인하세요.

Xray 코어 및 클라이언트 선택

v2rayN은 데스크톱용 그래픽 클라이언트로, 노드 관리와 구독 업데이트, 시스템 연동을 담당하고 지원 여부에 따라 해당 코어를 실행할 수 있습니다. v2rayNG는 Android용이며 Xray 코어를 사용합니다. v2flyNG는 v2fly 코어를 위한 Android 대안입니다. 클라이언트를 고를 때는 플랫폼과 설정 요구 사항을 먼저 보고, 사용 방식은 그다음에 고려하세요.

코어 이름은 연결 품질 순위가 아닙니다. 실제 성능은 서버 상태, 전송 조합, DNS 조회 경로, 로컬 네트워크의 영향을 받습니다. 같은 노드인데 두 클라이언트에서 결과가 다르다면 코어 성능 차이라고 단정하지 말고 활성 노드, 라우팅 모드, DNS, 트래픽 연결 범위를 먼저 비교하세요.

세 클라이언트 중에서 고르려면 먼저 클라이언트 비교를 읽어 보세요. 사용 가능한 설정이 있고 뚜렷한 호환성 문제가 없다면 재현 가능한 실행 환경을 유지하는 편이 좋습니다. 클라이언트, 코어, 규칙 세트를 한꺼번에 바꾸기보다 필요한 부분만 옮겨야 결과를 확인하기 쉽습니다.

오픈 소스 라이선스 및 사용 범위

세 클라이언트 모두 오픈 소스 소프트웨어이며 클라이언트 자체는 무료로 사용할 수 있습니다. 각 프로젝트의 사용, 수정, 재배포 범위는 해당 프로젝트와 함께 제공되는 구성 요소의 라이선스 문서를 기준으로 확인해야 합니다. 그래픽 클라이언트와 코어는 별도의 소프트웨어 구성 요소이므로 한 프로젝트의 라이선스를 모든 구성 요소에 그대로 적용할 수 없습니다.

오픈 소스는 코드와 라이선스에 관한 설명이지, 사용할 구독 서비스를 대신 선택해 주거나 네트워크의 모든 아웃바운드를 신뢰할 수 있다는 뜻은 아닙니다. 구독 주소, 노드 자격 증명, 백업 파일은 안전하게 보관하세요. 로그를 공유할 때는 서버 주소, 사용자 식별 정보, 접근 자격 증명 등 개인을 식별할 수 있는 내용을 지우고 문제 파악에 필요한 오류 유형과 관련 설정만 남기세요.

이 사이트는 다운로드 링크와 중국어 사용 안내를 제공하며 노드를 배포하거나 구독을 호스팅하지 않습니다. 클라이언트가 연결되는지는 유효한 설정, 호환되는 서버, 로컬 네트워크 환경에 따라 달라집니다. 설치 완료와 네트워크 연결 가능 여부는 각각 따로 확인해야 합니다.

클라이언트·코어·규칙은 각각 업데이트

인터페이스, 코어, 구독, 규칙 리소스 업데이트는 서로 다른 내용을 다룹니다. 클라이언트 업데이트는 메뉴, 시스템 연동, 설정 생성 방식을 바꿀 수 있습니다. 코어 업데이트는 프로토콜과 실행 동작에 영향을 주고, 구독 업데이트는 노드 매개변수를 바꾸며, 규칙 리소스 업데이트는 분류와 매칭에 영향을 줍니다. 어느 한 항목을 업데이트해도 나머지 항목까지 함께 바뀌는 것은 아닙니다.

설정을 바꾸기 전에 기존 설정을 백업하고 현재 사용하는 노드와 라우팅 모드를 기록하세요. 업데이트 후에는 원래 연결되던 환경부터 다시 확인한 다음 새 기능을 켜세요. 문제가 생기면 로그를 보관하고 설정을 하나씩 되돌리는 편이 구독을 모두 지우고 클라이언트를 재설치한 뒤 DNS까지 바꾸는 것보다 원인을 찾기 쉽습니다.

배포 버전에 따라 메뉴 위치와 기본 동작이 달라질 수 있으므로, 이 사이트에서는 설정의 역할과 작업 순서에 따라 가이드를 구성합니다. 설치 파일은 다운로드 페이지에서 선택하고, 플랫폼별 준비 사항과 권한 처리, 설정 확인은 전체 플랫폼 설치 및 설정 가이드를 참조하세요.

첫 설정 후 확인 순서

구독을 업데이트한 뒤 선택할 수 있는 노드가 실제로 표시되는지 확인하고, 활성 서버를 직접 지정하세요. 그다음 코어가 실행되는지 확인한 뒤 대상 앱을 테스트합니다. 브라우저는 접속되는데 다른 앱이 실패한다면 트래픽 연결 범위를 확인하세요. 로그에 DNS 조회 실패가 표시되면 먼저 DNS 경로를 점검합니다. 모든 앱이 접속되지 않으면 시스템 프록시 설정이 남아 있는지, TUN 라우팅과 로컬 네트워크에 문제가 없는지 살펴보세요. 한 번에 한 가지 조건만 바꿔야 점검 결과를 비교할 수 있습니다.

V2Ray 노드 속도 측정은 후보를 추리는 데 도움이 되지만 실제 접속 테스트를 대신하지는 않습니다. 테스트 요청의 주소, 프로토콜, 시간 제한이 결과에 영향을 줍니다. 한 번 시간 초과가 발생했다고 노드가 영구적으로 끊겼다고 단정할 수 없고, 한 번 성공했다고 모든 앱에서 사용할 수 있는 것도 아닙니다. 같은 조건으로 먼저 비교한 뒤 실제로 필요한 서비스에 접속해 보세요. V2Ray 구독 변환은 대상 클라이언트가 특정 형식을 요구할 때만 고려하세요. 변환 과정에서 필드가 누락되거나 구독 주소 전체가 노출될 수 있으므로 가져오기에 실패했을 때 기본 해결책으로 사용하지 않는 것이 좋습니다.

시스템 프록시는 라우팅 모드가 아니며, TUN도 “모든 트래픽을 프록시로 보낸다”는 뜻이 아닙니다. 시스템 프록시는 트래픽이 클라이언트로 들어오는 방식을 정하고, 나갈 경로는 규칙이 결정합니다. V2Ray DNS 설정도 트래픽 연결 방식과 함께 이해해야 합니다. 앱, 시스템, 코어에서 수행하는 DNS 조회는 서로 다른 경로를 사용할 수 있습니다. 먼저 최소한의 설정으로 연결을 확인한 다음 규칙, 스니핑, FakeDNS를 하나씩 추가하면 기능 간 상호작용으로 인한 오판을 줄일 수 있습니다.

구독 가져오기부터 시작하는 v2rayN 설정 가이드 →

설정 가이드
및 문제 해결

  • 최신 기술 문서 3편
  • 사용 사례별 설정 영향 살펴보기
  • 기본 조작은 시작 가이드부터

기본 연결을 마친 뒤 여러 기기 간 동기화, 도메인 매핑, DNS 조회 경로를 설정하세요. 주제별 문서에서는 각 기능의 사용 조건과 부작용을 설명하므로, 특정 환경의 설정을 모든 기기에 그대로 복사하지 않아도 됩니다. 읽기 전에 현재 사용하는 클라이언트와 코어, 트래픽 연결 방식을 확인하면 문서의 내용을 실제 환경에 맞춰 적용하기 쉽습니다.