클라이언트 설정 안내서

V2Ray 사용 가이드
v2rayN 다운로드 및 설정

클라이언트를 선택한 뒤 구독 가져오기, 라우팅 분할연결 확인을 순서대로 진행합니다. 페이지의 설정 이름은 v2rayN과 v2rayNG의 일반적인 화면을 기준으로 하며, 설정 예시는 Xray와 V2Fly에서 공통으로 사용하는 필드를 사용합니다.

VMess / VLESS Xray / V2Fly 라우팅 및 DNS
Configuration index

설정 인덱스

먼저 클라이언트가 관리할 범위를 정한 다음 라우팅, DNS 및 구독을 설정합니다. 왼쪽에서 작업을 전환하면 오른쪽에 해당 설정의 논리와 확인 가능한 구성 필드가 표시됩니다.

routing.json

매칭 순서에 따라 트래픽 출구 설정

먼저 사설 주소와 로컬 도메인은 직접 연결 아웃바운드로 보내고, 나머지 대상은 프록시 아웃바운드로 보냅니다. 라우팅 규칙은 위에서 아래로 매칭되며 첫 번째 규칙이 일치하면 더 이상 확인하지 않으므로 범위가 명확한 규칙을 앞에 배치해야 합니다. v2rayN의 ‘중국 본토 우회’는 미리 정의된 규칙 모음이며 시스템 프록시 스위치와는 다릅니다. 시스템 프록시는 애플리케이션 트래픽을 클라이언트로 전달하고, 라우팅 모듈이 실제 출구를 결정합니다. 변경 후에는 설정을 저장하고 코어를 재시작해 이전 규칙이 현재 프로세스에 남지 않도록 하세요.

{
  "domainStrategy": "IPIfNonMatch",
  "rules": [
    { "ip": ["geoip:private"], "outboundTag": "direct" },
    { "domain": ["geosite:cn"], "outboundTag": "direct" },
    { "domain": ["geosite:geolocation-!cn"], "outboundTag": "proxy" }
  ]
}
Platform entry

플랫폼별 클라이언트 선택

데스크톱에서는 v2rayN을 사용하고 Android에서는 코어 요구 사항에 따라 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 플랫폼 링크를 누르면 다운로드 페이지의 해당 분류가 바로 열립니다.

DESKTOP / 01

Windows

v2rayN 데스크톱 버전 또는 클래식 WPF 버전을 사용하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용해 새로 설치하는 환경에 적합합니다. WPF 버전은 기존 Windows 방식의 조작 구조를 유지하므로 익숙한 환경에 알맞습니다. 다운로드 후 압축을 풀거나 설치한 다음 클라이언트를 시작해 코어를 사용할 수 있는지 확인하세요.

  • 시스템 프록시 및 TUN 모드 지원
  • 여러 구독과 라우팅 규칙 관리
  • 데스크톱 버전과 클래식 인터페이스 제공
다운로드 페이지로 이동
DESKTOP / 02

macOS

v2rayN을 사용하고 프로세서 종류에 따라 Apple Silicon 또는 Intel 설치 파일을 선택하세요. 시스템 정보에서 칩 정보를 확인할 수 있습니다. Apple M 시리즈가 표시되면 arm64, Intel이 표시되면 x64를 선택하세요. 처음 실행할 때 시스템 안내에 따라 필요한 권한을 허용한 뒤 구독을 가져오면 됩니다.

  • 칩 아키텍처에 맞는 설치 파일 선택
  • 데스크톱 버전과 동일한 구성 구조
  • 구독 및 분할 라우팅 규칙 재사용에 적합
다운로드 페이지로 이동
MOBILE / 03

Android

Xray 코어 기반의 v2rayNG를 우선 사용하고, V2Fly 코어가 필요하면 v2flyNG를 선택하세요. 최근 출시된 대부분의 기기에서는 arm64 설치 파일을 사용할 수 있으며 아키텍처를 확인하기 어렵다면 범용 버전을 선택하세요. 구독을 가져온 후에는 먼저 하나의 구성을 선택하고 연결 스위치를 켠 다음 시스템 연결 안내를 확인합니다.

  • v2rayNG는 Xray 코어 사용
  • v2flyNG는 V2Fly 코어 사용
  • arm64 및 범용 설치 파일 제공
다운로드 페이지로 이동
DESKTOP / 04

Linux

v2rayN의 deb 또는 rpm 설치 파일을 사용하세요. Debian, Ubuntu 및 파생 배포판은 deb를, Fedora와 Rocky Linux 등 rpm 계열 배포판은 rpm을 선택합니다. 기기의 프로세서에 따라 x64 또는 arm64도 선택해야 합니다. 설치 후에는 먼저 그래픽 인터페이스에서 구독과 라우팅을 설정하세요.

  • deb 및 rpm 설치 경로 제공
  • x64 및 arm64 아키텍처 지원
  • 다른 데스크톱 플랫폼과 유사한 설정 방식
다운로드 페이지로 이동
Project V ecosystem

Project V, V2Fly 및 Xray

클라이언트는 그래픽 인터페이스와 시스템 인계를 담당하고, 코어는 프로토콜, 전송, 라우팅 및 DNS를 처리합니다. 두 계층을 구분해야 문제가 화면 설정에 있는지 핵심 구성에 있는지 정확히 판단할 수 있습니다.

생태계 관계

Project V는 프록시 프로토콜, 전송 방식 및 라우팅 기능을 중심으로 형성된 오픈 소스 기술 생태계입니다. 초기에는 V2Ray라는 이름이 널리 사용되었고, 이후 커뮤니티의 유지보수 방향에 따라 V2Fly와 Xray라는 두 주요 코어 계열이 자리 잡았습니다. 두 계열은 인바운드, 아웃바운드, 라우팅 규칙, DNS 서버 및 전송 계층 설정과 같은 많은 구성 개념을 공유하지만 새로운 프로토콜 기능, 필드 확장 및 기능 개발 속도에는 차이가 있습니다.

그래픽 클라이언트는 코어 자체가 아닙니다. v2rayN은 데스크톱에서 구독 관리, 구성 선택, 시스템 프록시, TUN 및 로그 확인을 담당하고 해당 코어를 호출해 네트워크 작업을 실행합니다. v2rayNG와 v2flyNG는 Android에서 인터페이스, 연결 상태 및 구성 저장을 담당합니다. 문제를 해결할 때는 먼저 클라이언트가 코어를 시작할 수 있는지 확인하고, 다음으로 코어가 구성을 파싱할 수 있는지 점검한 뒤 마지막으로 실제 네트워크 경로를 확인해야 합니다.

코어 선택

Xray는 VLESS, XTLS 및 REALITY와 같은 기능을 비교적 폭넓게 지원하므로 v2rayNG는 이러한 구성 형식이 필요한 환경에서 자주 사용됩니다. V2Fly는 Project V의 커뮤니티 유지보수 방향을 이어가며 v2flyNG는 해당 구성 체계에 직접 대응합니다. VMess, 기본 VLESS, 일반적인 WebSocket 또는 gRPC 전송만 사용하는 경우 두 코어의 기본 개념은 비슷하지만 확장 필드를 사용할 때는 구성 출처가 요구하는 코어를 기준으로 선택해야 합니다.

공유 링크의 시작 부분만 보고 전체 호환성을 판단하지 마세요. 링크의 프로토콜 이름은 주요 아웃바운드 프로토콜만 보여 줄 뿐이며 실제 연결에는 전송 계층, 보안 계층, 서버 이름, 지문 및 흐름 제어 필드가 추가로 필요할 수 있습니다. 가져온 후 클라이언트에서 지원하지 않는 필드라고 표시되면 먼저 현재 코어 유형을 확인하고 공유 내용이 다른 코어의 확장 기능에 의존하는지 점검하세요.

오픈 소스 라이선스와 유지보수 방식

v2rayN, v2rayNG, v2flyNG 및 관련 코어는 모두 오픈 소스 커뮤니티에서 지속적으로 유지보수됩니다. 오픈 소스 라이선스는 코드 사용, 복제 및 배포 조건을 정하고 구성 파싱, 네트워크 처리 및 인터페이스 동작을 검토할 수 있는 기반을 제공합니다. 실제로 설치할 때는 명확한 클라이언트 경로에서 플랫폼과 아키텍처에 맞는 파일을 선택하고, 제3자가 재패키징한 버전과 원 프로젝트 배포 파일을 혼용하지 마세요.

클라이언트 업데이트와 코어 업데이트는 서로 다른 계층의 작업입니다. 클라이언트 업데이트는 인터페이스, 구독 처리 및 시스템 통합을 변경할 수 있고, 코어 업데이트는 프로토콜 필드를 추가하거나 라우팅 및 전송 문제를 수정할 수 있습니다. 기존 구성은 시작되지만 새 구성을 파싱하지 못한다면 먼저 오류 필드를 확인한 뒤 코어 업데이트가 필요한지 판단하세요. 인터페이스 경로가 바뀐 경우에는 현재 클라이언트의 설정 이름을 기준으로 다시 찾고 기존 구성을 바로 삭제하지 마세요.

구성 검증 순서

설치를 마친 뒤 먼저 구조가 명확한 구성 하나를 가져와 코어를 시작하세요. 그다음 로컬 수신 포트가 열렸는지 확인하고 시스템 프록시 또는 TUN 인계를 활성화합니다. 브라우저는 접속되지만 명령줄 도구가 연결되지 않는다면 해당 애플리케이션이 시스템 프록시를 읽지 않는 경우가 많습니다. 모든 애플리케이션이 연결되지 않으면 코어 시작 로그를 먼저 확인하세요. 일부 도메인만 이상할 때 라우팅과 DNS를 점검합니다. 이 순서를 따르면 클라이언트, 코어, 시스템 인계 및 규칙 계층을 단계별로 분리해 확인할 수 있습니다.

클라이언트와 코어는 어떻게 다른가요?

클라이언트는 조작 화면을 제공하고 시스템 프록시를 관리하며, 코어는 구성을 읽고 연결을 처리합니다. 시작 오류가 발생하면 코어 로그를 확인하고 구독 또는 인터페이스 문제가 발생하면 클라이언트 설정을 점검하세요.

용어 설명 보기 →

구독을 업데이트했는데 새 구성이 나타나지 않는 이유는 무엇인가요?

먼저 현재 구독 그룹을 업데이트했는지 확인한 다음 포함 및 제외 필터 조건을 점검하세요. 필터 규칙은 구독 파싱 후 이름이 일치하지 않는 항목을 걸러냅니다.

가져오기 단계 보기 →

시스템 프록시와 TUN 중 무엇을 선택해야 하나요?

브라우저처럼 시스템 프록시를 따르는 애플리케이션은 먼저 시스템 프록시를 사용하세요. 프록시 설정을 읽지 않는 애플리케이션까지 인계해야 할 때 TUN을 활성화하고 사설 네트워크 대역의 직접 연결 규칙은 유지합니다.

고급 설정 보기 →
Configuration notes

최신 설정 문서

프록시 모드, 분할 라우팅 데이터베이스 및 코어 차이를 중심으로 정리했습니다. 기초 설치를 마친 뒤 구체적인 설정을 계속 확인하기 쉽도록 문제별로 나누어 설명합니다.

V2Ray 시스템 프록시, 전체 모드와 중국 본토 우회 모드의 차이: v2rayN 라우팅 방식 선택법

시스템 프록시 스위치와 라우팅 모드의 계층 관계를 분석하고 전체 모드, 중국 본토 우회 및 직접 연결 규칙의 실제 흐름을 비교합니다. 브라우저, 명령줄 및 게임 환경별 선택 방법도 설명합니다.

전체 글 읽기

geoip.dat 및 geosite.dat 업데이트 방법: v2rayN 분할 라우팅 데이터베이스 수동 교체와 자동 업데이트 설정

GeoIP 및 GeoSite 데이터가 라우팅 규칙에서 어떤 역할을 하는지 설명하고, 클라이언트 업데이트 경로, 자주 사용하는 분류명 작성법과 업데이트 후 규칙이 작동하지 않을 때의 점검 순서를 정리합니다.

전체 글 읽기

Xray 코어와 V2Fly 코어 차이 해설: VLESS·XTLS·REALITY 지원 비교 및 선택

Project V 생태계의 분기 관계를 바탕으로 프로토콜 지원, 전송 특성 및 구성 호환 범위를 비교하고 세 가지 그래픽 클라이언트에서 자주 사용하는 코어 조합을 설명합니다.

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