V2Ray 클라이언트 및 설정 문서

V2Ray중문망 v2rayN 다운로드 및 라우팅 설정

v2rayN 다운로드 튜토리얼 보기

플랫폼에 맞는 클라이언트를 선택한 뒤 한국어 안내에 따라 설정하세요. 문서는 구독 가져오기, 라우팅, DNS 및 TUN 모드를 중점적으로 다루며, 설정 항목명은 클라이언트 메뉴와 동일합니다.

완전 무료 오픈 소스 Xray · V2Fly 코어 VLESS · VMess · Trojan
구독 및 노드
라우팅 규칙
DNS 확인
TUN 모드
v2rayN 설정 / 매개변수 설정 / 라우팅
기본 설정
시스템 프록시 시스템 프록시 자동 설정
라우팅 중국 본토 우회
코어 유형 Xray
로그 수준 warning
TUN 모드 활성화
구독 그룹 구독 추가
routing.rules.json JSON 
{
  "type": "field",
  "domain": [
    "geosite:cn"
  ],
  "outboundTag": "direct"
},
{
  "type": "field",
  "ip": [
    "geoip:private"
  ],
  "outboundTag": "direct"
}
클라이언트 다운로드

운영체제에 맞는 설치 파일 선택

먼저 기기의 운영체제와 프로세서 아키텍처를 확인한 뒤 다운로드 페이지에서 알맞은 파일을 선택하세요. 홈에서는 플랫폼별 경로만 안내하며, 설치 파일·시스템 요구 사항·선택 방법은 다운로드 페이지에 정리되어 있습니다.

Windows

v2rayN 데스크톱 클라이언트를 사용하세요. 다운로드 페이지에서 크로스 플랫폼 데스크톱 인터페이스와 클래식 WPF 인터페이스 중 평소 사용 방식에 맞는 것을 선택할 수 있습니다.

다운로드 페이지로 이동

macOS

v2rayN 데스크톱 클라이언트를 사용하세요. 다운로드 페이지의 시스템 정보에서 칩 유형을 확인한 뒤 Apple Silicon 또는 Intel 설치 파일을 선택하세요.

다운로드 페이지로 이동

Android

Xray 코어를 사용하는 v2rayNG를 우선 선택하고, V2Fly 코어가 필요할 때는 v2flyNG를 선택하세요. 일반적인 기기는 arm64 아키텍처를 사용합니다.

다운로드 페이지로 이동

Linux

v2rayN 데스크톱 클라이언트를 사용하세요. Debian·Ubuntu 계열은 deb를, Fedora·Rocky Linux 등은 rpm 패키지를 선택하세요.

다운로드 페이지로 이동
전체 클라이언트 보기
자주 쓰는 설정

문제에서 해당 메뉴로 이동

먼저 현재 해결하려는 문제를 선택하면 오른쪽 패널에서 설정 위치, 핵심 옵션과 적용 범위를 안내합니다. 예시에는 클라이언트의 실제 메뉴명을 사용하며 지연 시간, 노드 수나 트래픽 데이터는 표시하지 않습니다.

구독 및 노드

그룹을 만든 뒤 구독 업데이트

v2rayN에서 “구독 그룹”을 열고 그룹을 추가한 다음 서비스 제공자가 전달한 구독 주소를 입력하세요. 저장 후 “모든 구독 업데이트”를 실행하면 클라이언트가 서버 항목을 해당 그룹에 기록합니다. 그룹 이름은 로컬 정리용이므로 용도나 출처에 맞게 지정하면 됩니다. 업데이트하기 전에 주소가 완전한지 확인하고, 복사할 때 앞뒤 공백이 들어가지 않도록 하세요. 업데이트가 끝나면 노드 하나를 선택해 활성 서버로 지정합니다.

구독 주소와 단일 노드 링크는 진입점이 다릅니다. 구독 주소는 여러 노드를 한 번에 업데이트할 때 적합하고, 단일 노드 링크는 클립보드로 가져옵니다. 여러 구독을 함께 사용할 때는 먼저 그룹을 나눈 뒤 업데이트하면 목록이 섞이는 것을 줄이고 자동 업데이트 간격과 필터 규칙도 각각 조정하기 쉽습니다.

그룹 이름일상 구독
사용 가능
자동 업데이트 간격필요에 따라 설정
업데이트 방식모든 구독 업데이트
메뉴 경로: 구독 그룹 → 추가 → 모든 구독 업데이트
하나의 설정으로 네 플랫폼에서 사용: Windows macOS Android Linux
빠른 시작

설치, 가져오기, 활성화

처음에는 세 가지만 처리하면 됩니다. 시스템에 맞는 클라이언트를 설치하고, 구독 또는 노드를 가져온 다음, 적절한 프록시 모드를 선택하세요. 최소 설정으로 연결을 확인한 뒤 라우팅, DNS와 TUN을 조정하는 것이 좋습니다.

  1. 01

    클라이언트 설치

    데스크톱 기기에서는 v2rayN을, Android 기기에서는 v2rayNG를 우선 선택하세요. 다운로드 전에 운영체제, 프로세서 아키텍처와 설치 파일 형식을 확인합니다. Windows는 데스크톱 버전과 클래식 WPF 버전 중에서, macOS는 칩 유형에 맞는 설치 파일을, Linux는 배포판의 패키지 체계에 맞춰 deb 또는 rpm을 선택하세요.

    설치가 끝나면 먼저 클라이언트를 정상적으로 실행하고 모든 고급 설정을 서둘러 변경하지 마세요. 시스템에서 네트워크 접근, 알림 또는 가상 네트워크 권한을 요청하면 사용할 기능에 따라 허용 여부를 결정합니다. 시스템 프록지만 사용할 때는 보통 기본 설정을 유지하고, TUN을 사용할 때 가상 네트워크 인터페이스 권한을 추가로 설정하세요.

  2. 02

    구독 또는 단일 노드 가져오기

    구독 사용자는 “구독 그룹”에서 새 그룹을 만들고 전체 구독 주소를 입력한 뒤 업데이트를 실행하세요. 단일 노드 사용자는 먼저 공유 링크를 복사한 다음 “클립보드에서 일괄 URL 가져오기”를 사용합니다. 가져온 후 프로토콜, 주소, 포트와 전송 보안이 올바른지 확인하고, 특히 VLESS REALITY 설정의 공개 키, 서버 이름과 Short ID를 점검하세요.

    클라이언트 목록의 메모는 항목을 식별하기 위한 용도일 뿐 연결에는 사용되지 않습니다. 여러 출처를 함께 사용할 때는 그룹, 메모 접두사와 필터 규칙으로 노드를 먼저 정리한 뒤 업데이트 주기를 설정하는 것이 좋습니다. 이렇게 하면 구독 업데이트 후에도 목록 구조를 안정적으로 유지하고 노드의 설정 출처도 쉽게 확인할 수 있습니다.

  3. 03

    서버 및 프록시 모드 선택

    목록에서 서버를 선택해 활성 서버로 지정한 다음 시스템 프록시 자동 설정을 켜세요. 브라우저가 정상적으로 연결된 후 필요에 따라 중국 본토 우회 라우팅을 활성화합니다. 일반 데스크톱 프로그램은 시스템 프록시를 우선 사용하고, 앱이 시스템 프록시를 읽지 않거나 더 많은 시스템 트래픽을 코어로 보내야 할 때만 TUN 모드를 켜세요.

    연결에 실패하면 다음 순서로 확인하세요. 구독 업데이트가 성공했는지, 활성 서버가 선택되었는지, 시스템 프록시가 켜져 있는지, 코어 로그에 확인 또는 핸드셰이크 오류가 있는지 점검합니다. 한 번에 하나의 설정만 변경하고 다시 테스트해야 문제가 노드 매개변수, DNS, 라우팅 또는 로컬 네트워크 환경 중 어디에서 비롯되었는지 판단할 수 있습니다.

전체 튜토리얼 보기
오픈 소스 생태계

Project V, V2Fly와 Xray의 관계

클라이언트, 코어와 프로토콜은 서로 다른 계층에 속합니다. 세 요소의 관계를 이해하면 소프트웨어 선택과 설정 문제 해결이 한층 쉬워집니다.

생태계의 출발점과 코어 분기

Project V는 프록시 프로토콜, 전송 방식과 라우팅 기능을 중심으로 형성된 오픈 소스 기술 생태계입니다. 초기 V2Ray는 이 생태계를 위한 설정 모델을 마련했습니다. 인바운드는 로컬 앱 트래픽을 받고, 아웃바운드는 대상 또는 원격 서비스에 연결하며, 라우팅 규칙은 요청별 아웃바운드를 결정하고 DNS 모듈은 도메인 확인 과정을 설정할 수 있게 합니다. 이 구조는 이후 클라이언트의 화면 구성 방식에도 영향을 주었습니다.

V2Fly는 V2Ray 코어와 관련 구성 요소를 커뮤니티 방식으로 이어서 유지하며, 일반적으로 v2fly-core라고 부릅니다. Xray는 유사한 설정 모델을 기반으로 발전하면서 VLESS, REALITY 등의 기능을 추가하고 유지합니다. 둘 다 그래픽 클라이언트가 아니라 프로토콜 처리, 전송, 라우팅과 DNS를 담당하는 코어 프로그램입니다. 클라이언트에서 “코어 유형”을 선택한다는 것은 현재 설정을 해석하고 실행할 코어를 선택하는 것입니다.

프로토콜은 클라이언트와 같은 개념이 아닙니다. VMess, VLESS, Trojan은 연결 양측이 인증과 데이터를 구성하는 방식을 설명하고, TCP, WebSocket, gRPC 등은 전송 계층 선택입니다. TLS와 REALITY는 전송 보안 관련 매개변수를 처리합니다. 노드 연결 여부는 프로토콜 이름만이 아니라 클라이언트가 지원하는 코어 기능과 서버 매개변수가 항목별로 일치하는지에 달려 있습니다.

데스크톱 클라이언트

v2rayN

v2rayN은 Windows, macOS와 Linux용 그래픽 클라이언트로, 구독 관리, 노드 편집, 시스템 프록시, 라우팅 규칙, DNS, TUN과 코어 전환을 담당합니다. 하위 JSON 설정을 조작 가능한 설정 항목으로 보여 주므로 여러 구독을 관리하거나 세밀한 라우팅이 필요한 데스크톱 환경에 적합합니다.

Android 클라이언트

v2rayNG

v2rayNG는 Xray 코어를 주요 실행 기반으로 하며 구독, QR 코드와 공유 링크 가져오기를 지원하고 시스템 VPN 인터페이스를 통해 선택한 트래픽을 전달합니다. VLESS, REALITY 또는 Xray 라우팅 기능을 사용할 때는 노드 매개변수와 클라이언트 코어 지원 여부를 먼저 확인하세요.

Android 대안

v2flyNG

v2flyNG는 V2Fly 코어를 사용하며 동종 Android 클라이언트와 비슷한 방식으로 조작합니다. v2fly-core 동작이 필요하거나 기존 V2Fly 설정을 사용하는 사용자에게 적합합니다. 선택 기준은 화면의 유사성이 아니라 노드 프로토콜, 전송 방식과 대상 코어의 호환 여부입니다.

오픈 소스 라이선스와 코드 검토

이 프로젝트들은 오픈 소스로 배포되며 라이선스에 따라 소스 코드의 사용, 수정과 재배포 조건이 정해집니다. 오픈 소스이므로 구현 세부 사항, 설정 구조와 변경 기록을 커뮤니티가 지속적으로 검토할 수 있고, 여러 클라이언트가 검증된 코어를 재사용할 수도 있습니다. 설치할 때는 여전히 이 사이트의 다운로드 페이지에서 최신 배포 파일로 이동해 시스템과 아키텍처에 맞는 패키지를 선택하세요.

업데이트 방식과 호환 범위

클라이언트 업데이트, 코어 업데이트와 라우팅 데이터베이스 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 화면과 관리 기능에 영향을 주고, 코어 업데이트는 프로토콜과 실행 동작에 영향을 주며, geoip·geosite 데이터 업데이트는 규칙 매칭 범위를 바꿉니다. 문제를 해결할 때는 이 세 계층을 나누어 확인해 데이터베이스 만료를 클라이언트 오류로 오해하지 않도록 하세요.

설정 이전과 일상적인 유지 관리

기기 간 이전 시에는 임시 노드 목록에 의존하기보다 구독 출처와 필요한 사용자 지정 라우팅을 우선 보관하세요. 구독은 서버 측 변경에 따라 달라지고 라우팅 규칙은 개인의 사용 요구를 반영합니다. 정기적으로 구독을 업데이트한 뒤 활성 서버가 여전히 존재하는지 확인하고, DNS나 TUN을 조정했다면 변경 위치를 기록해 이상 발생 시 되돌릴 수 있도록 하세요.

자주 묻는 질문

먼저 설정 계층을 확인하세요

대부분의 문제는 클라이언트, 코어, 노드 매개변수와 시스템 네트워크 설정의 계층을 혼동해서 발생합니다. 아래 답변에서는 가장 짧은 점검 경로를 제시하며, 전체 작업은 빠른 시작과 고급 매뉴얼에서 이어서 확인할 수 있습니다.

구독 업데이트는 성공했는데 왜 연결되지 않나요?
업데이트 성공은 클라이언트가 구독 내용을 가져왔다는 뜻일 뿐입니다. 서버 목록에서 항목을 선택해 활성 서버로 지정한 다음 시스템 프록시 또는 TUN을 켜야 합니다. 그래도 연결되지 않으면 코어 로그를 확인하고 주소 확인, 포트 연결, 사용자 ID와 전송 보안 매개변수를 순서대로 점검하세요.
시스템 프록시와 TUN 모드 중 무엇을 선택해야 하나요?
브라우저와 일반 데스크톱 프로그램은 설정이 간단하고 문제를 추적하기 쉬운 시스템 프록시부터 사용하세요. 앱이 시스템 프록시를 읽지 않거나 명령줄 트래픽을 통합 처리해야 하거나 더 많은 시스템 연결을 포함하려면 TUN을 활성화합니다. TUN을 켠 뒤에는 DNS, 사설 주소 직결과 가상 네트워크 카드 권한도 함께 확인해야 합니다.
중국 본토 우회 규칙이 특정 사이트에서 작동하지 않는 이유는 무엇인가요?
먼저 대상 요청이 도메인 규칙과 IP 규칙 중 어디에 매칭되었는지 확인하고, DNS가 예상한 주소를 반환하는지도 점검하세요. 사용자 지정 규칙은 더 일반적인 규칙보다 앞에 배치해야 합니다. 문제가 있는 도메인에만 정확한 규칙을 추가하고 저장 후 코어를 재시작하세요. 단일 사이트 문제를 해결하려고 전체 규칙 그룹을 확대하지 마세요.
REALITY 노드에서 가장 자주 잘못 입력하는 항목은 무엇인가요?
서버 이름, 공개 키, Short ID, 지문과 흐름 제어를 중점적으로 확인하세요. 공개 키와 Short ID는 서버 설정과 일치해야 하며 서버 이름은 핸드셰이크에 사용되므로 임의로 바꾸면 안 됩니다. 공유 링크를 가져온 뒤에도 링크가 완전한지, 특히 복사 과정에서 마지막 매개변수가 빠지지 않았는지 확인하세요.
빠른 시작 보기 초급부터 고급까지 매뉴얼 읽기
사용 후기

최근 설정 문서

구체적인 설정과 장애 현상을 중심으로, 먼저 점검 메뉴를 제시한 뒤 설정 간의 연관성을 설명합니다.

문제 해결

v2rayN DNS 누출 확인 방법: 세 가지 점검법과 누출 방지 설정

프록시가 연결된 상태에서도 DNS 요청이 로컬 네트워크를 통해 전송될 수 있는 이유를 설명하고, 브라우저 검사·명령줄 조회·클라이언트 로그로 교차 검증합니다. 원격 확인, DNS 아웃바운드와 TUN 모드에서의 설정 순서도 함께 다룹니다.

전체 글 읽기
고급 설정

v2rayN 여러 구독 그룹 관리: 서버 필터링, 메모 규칙과 자동 업데이트 활용법

구독별 독립 그룹을 만들고 키워드로 서버를 필터링하며 그룹별 업데이트 간격과 선행 프록시를 설정하는 방법을 설명합니다. 일관된 메모 접두사와 필터 규칙으로 긴 서버 목록을 읽기 쉽고 검색·관리하기 편하게 정리할 수 있습니다.

전체 글 읽기
라우팅

geoip.dat 및 geosite.dat 업데이트 가이드: v2rayN 라우팅 데이터베이스의 역할과 수동 교체

geoip와 geosite 데이터가 매칭하는 대상을 구분하고 geosite:cn, geoip:private 등 자주 쓰는 태그를 설명합니다. 클라이언트의 원클릭 업데이트, 파일 교체와 일반적인 오류 처리 절차도 정리했습니다.

전체 글 읽기
전체 글 보기
클라이언트 다운로드