GUI 클라이언트 설정 가이드

V2Ray 설정 가이드 v2rayN 구독 가져오기와 라우팅 설정

구독 가져오기부터 라우팅 분할까지 클라이언트 메뉴에 따라 설정하고, 실행 로그에서 트래픽이 어디로 전달되는지 확인하세요.

  • VMess
  • VLESS
  • Trojan
  • REALITY

클라이언트 다운로드

운영체제 및 설치 파일

먼저 운영체제를 선택하고 CPU 아키텍처를 확인하세요. 다운로드 페이지에서 설치 파일별 시스템 요구 사항을 확인할 수 있습니다.

Windows

데스크톱에서는 v2rayN을 권장합니다. 데스크톱 버전과 클래식 WPF 버전은 같은 클라이언트의 서로 다른 인터페이스입니다. 플랫폼 간 일관된 인터페이스가 필요하면 데스크톱 버전을, 기존 사용 방식에 익숙하다면 클래식 WPF 버전을 선택하세요. 다운로드 전에 시스템 설정의 ‘시스템 → 정보’에서 시스템 종류를 확인하고, 기기가 다운로드 페이지에 표시된 아키텍처를 지원하는지 확인하세요.

이전 버전에서 마이그레이션할 때는 먼저 클라이언트가 제공하는 방법으로 설정을 백업하세요. 기존 프로그램이 작업 표시줄 알림 영역에서 실행 중이라면 종료한 뒤 새 프로그램을 시작해야 합니다. 두 프로그램이 동시에 실행되면 로컬 프록시 포트를 놓고 충돌할 수 있습니다. 실행 오류가 발생하면 구독을 삭제하고 다시 시작하기보다 포트부터 확인하세요. 마이그레이션 후에는 시스템 프록시가 새 프로그램이 수신 대기 중인 포트를 가리키는지도 확인하세요.

다운로드 페이지로 이동

macOS

‘이 Mac에 관하여’에서 프로세서 정보를 확인하세요. Apple 칩이라고 표시되면 Apple Silicon 패키지를, Intel 프로세서라고 표시되면 Intel 패키지를 선택하세요. 기기 외관이나 구매 연도로 아키텍처를 추측하지 마세요. 디스크 이미지를 연 다음 설치 안내에 따라 v2rayN을 ‘응용 프로그램’으로 옮기고 해당 폴더에서 실행하세요.

Wi-Fi와 유선 네트워크를 전환한 뒤 같은 앱이 갑자기 프록시를 우회한다면, 바로 재설치하기보다 현재 네트워크 서비스의 프록시 설정을 먼저 확인하세요. 공용 컴퓨터에서는 설정도 분리해 관리하고, 구독 주소가 포함된 내보내기 파일을 공용 폴더에 두지 마세요. 시스템 권한 요청이 표시되면 허용하기 전에 대상 앱과 작업이 맞는지 확인하세요.

다운로드 페이지로 이동

Android

Xray 코어가 필요하면 먼저 v2rayNG를 확인하고, 설정에서 V2Fly 코어를 명시적으로 요구하면 v2flyNG를 선택하세요. 시스템이 arm64를 지원한다면 해당 설치 파일을 고를 수 있습니다. 기기의 앱 아키텍처를 모르겠다면 범용 패키지를 선택하세요. 처음 연결할 때는 시스템의 VPN 권한 대화상자가 열립니다. 목록을 가져오는 것만으로는 VPN 서비스가 시작되지 않습니다.

화면을 잠근 뒤에만 연결이 끊긴다면 먼저 앱의 백그라운드 실행 제한을 확인한 다음 네트워크와 서버를 살펴보세요. 기기에서 다른 앱이 VPN 서비스를 사용 중이라면 해당 앱을 종료하고 새 설정만 따로 테스트하세요. 특정 앱만 인터넷에 연결되지 않는 경우에는 앱별 프록시 목록에서 선택이 반대로 되어 있지 않은지 먼저 확인하세요. 다른 앱이 정상이라고 해서 해당 앱도 프록시를 사용 중이라는 뜻은 아닙니다.

다운로드 페이지로 이동

Linux

v2rayN은 배포판의 패키지 형식과 프로세서 아키텍처에 따라 다운로드 항목을 제공합니다. Debian이나 Ubuntu에서는 deb를, Fedora 등 RPM을 사용하는 배포판에서는 rpm을 선택하세요. 시스템이 x64인지 arm64인지 확인한 뒤 알맞은 파일을 고르면 됩니다. 패키지 형식이 맞더라도 배포판의 모든 실행 의존성이 충족된다는 뜻은 아닙니다.

GUI 데스크톱, 터미널 프로그램, 브라우저가 같은 프록시 설정을 사용하는 것은 아닙니다. 데스크톱에서는 인터넷이 되지만 터미널에서 연결되지 않는다면 해당 터미널 프로그램이 어떤 프록시 설정을 참조하는지 먼저 확인하세요. 설치 도구에서 의존성 누락을 알리면 원래 안내를 보관하고 배포판 요구 사항과 비교하세요. 다른 아키텍처 패키지를 반복해서 다운로드하지 마세요. TUN이 필요하다면 가상 네트워크 카드 권한과 기존 라우팅도 별도로 확인하세요.

다운로드 페이지로 이동
전체 클라이언트 보기

설정 흐름

구독, 라우팅 및 트래픽 처리

왼쪽 그림은 설정 순서에 따라 읽어야 하며 패킷 흐름도는 아닙니다. 먼저 서버와 분할 라우팅을 설정한 다음, 앱 트래픽을 클라이언트에 전달할 방식을 선택하세요. 문제가 생기면 각 단계를 나눠 확인해 구독 업데이트 실패, 서버 핸드셰이크 실패, 앱이 프록시를 사용하지 않는 문제를 하나로 뭉뚱그리지 마세요.

v2rayN · 설정 순서

  1. 구독 그룹 구독 그룹 추가
  2. 서버 노드 활성 서버로 설정
  3. 라우팅 규칙 라우팅 설정
  4. 아웃바운드 / 직접 연결 outboundTag
  5. 시스템 프록시 / TUN 시스템 프록시 자동 설정 · TUN 모드 사용

구독 그룹은 서버 목록의 출처와 업데이트 범위를 관리합니다. v2rayN에서 ‘구독 그룹 → 구독 그룹 추가’를 열고 별칭과 구독 주소를 입력해 저장한 다음 ‘모든 구독 업데이트’를 실행하세요. 해당 그룹에 서버가 표시되는지 확인합니다. v2rayNG에서는 ‘구독 그룹 설정’에서 주소를 추가한 뒤 메인 목록으로 돌아와 업데이트하세요. 주소 저장과 목록 다운로드는 별개의 작업입니다. 목록이 비어 있다면 업데이트 안내, 주소의 유효 기간, 응답 형식을 확인하고 구독 주소를 공개 로그에 붙여 넣지 마세요.

초기 설정

빠른 시작: 가져오기, 연결, 확인

  1. 구독을 가져와 목록 출처 확인

    서비스 제공자가 안내한 구독 주소나 단일 서버 공유 링크를 준비하세요. 두 링크의 용도는 다릅니다. 구독 주소는 ‘구독 그룹’에 추가해 서버 목록을 가져오고 업데이트하는 데 사용합니다. 단일 서버 공유 링크는 서버 가져오기 메뉴를 사용하며 구독 주소 입력란에 넣지 않습니다. 구독 관리 웹페이지를 받았다면 관리 화면에서 클라이언트용 구독 주소를 복사하세요. 브라우저 주소창의 로그인 페이지 주소를 그대로 복사하지 마세요.

    v2rayN에서 구독 그룹을 저장하고 업데이트한 뒤 새 그룹으로 전환해 서버가 표시되는지 확인하세요. 그룹이 여러 개라면 출처를 알아볼 수 있는 별칭을 새 그룹에 지정하고 해당 그룹에서 프로토콜 종류도 확인하세요. 업데이트 후 이전 목록이 보이면 이번 업데이트가 실제로 성공했는지 먼저 확인하세요. 서버 이름만으로 판단하지 마세요. 업데이트에 실패했다면 안내를 자세히 읽어 다운로드, 인증, 파싱 중 어느 단계에서 오류가 발생했는지 확인한 뒤 해당 항목을 점검하세요. 구독 주소에는 접근 자격 증명이 포함될 수 있으므로 스크린샷이나 문의 글을 올릴 때 주소 전체를 가리세요.

  2. 활성 서버를 지정하고 트래픽 처리 방식 선택

    클라이언트 코어와 호환되는 서버를 하나 선택하세요. v2rayN에서 해당 서버를 활성 서버로 설정한 다음, 알림 영역의 ‘시스템 프록시’에서 ‘시스템 프록시 자동 설정’을 선택하고 시스템 설정을 따르는 브라우저로 테스트를 시작하세요. 클라이언트가 실행 중이라고 해서 브라우저도 프록시를 사용한다는 뜻은 아닙니다. 브라우저에 프록시 확장 프로그램이 설치되어 있다면 시스템 설정을 덮어쓰는지 먼저 확인하세요. 한 번의 테스트에서 서버 변경, DNS 수정, TUN 활성화를 동시에 하지 마세요. 결과가 좋아져도 어떤 변경이 효과가 있었는지 알 수 없습니다.

    v2rayNG 메인 화면에서 서버를 선택하고 연결을 시작한 다음 시스템 안내에 따라 VPN 권한을 허용하세요. 첫 테스트에서는 앱별 목록을 변경하지 마세요. 기본 연결을 확인한 뒤 포함하거나 제외할 앱을 지정하면 됩니다. 시스템 프록시를 사용하지 않는 데스크톱 프로그램은 먼저 로컬 프록시를 수동으로 입력하는 기능을 지원하는지 확인할 수 있습니다. TUN이 꼭 필요하다면 설치 가이드에서 해당 플랫폼의 권한과 라우팅 요구 사항을 확인하세요.

  3. 같은 대상을 다시 테스트해 실패 단계 파악

    같은 앱으로 프록시를 거쳐야 하는 대상에 접속한 다음, 직접 연결되어야 하는 대상도 테스트해 분할 라우팅을 확인하세요. 설정은 한 번에 하나씩만 변경하고 재시도 시간을 기록해 실행 로그와 대조하세요. 아이콘이 켜져 있다는 것은 서비스가 시작되었다는 뜻일 뿐입니다. 지연 시간 테스트에서 응답이 왔다고 해서 실제 앱 요청이 올바른 아웃바운드를 사용했다는 뜻은 아닙니다. 브라우저에 캐시된 콘텐츠가 있다면 새 요청을 보내 다시 테스트하세요. 페이지가 계속 보인다고 연결에 성공한 것은 아닙니다.

    로그에 해당 인바운드가 없다면 앱의 프록시 설정과 로컬 수신 포트를 확인하세요. 인바운드는 있지만 직접 연결로 처리되었다면 규칙 순서와 대상 일치 조건을 확인하세요. 프록시 아웃바운드를 선택했는데 핸드셰이크에 실패한다면 서버 매개변수, 네트워크 연결, 시스템 시간을 점검하세요. 복구가 필요하면 가장 최근 변경을 되돌려 비교하면 됩니다. 클라이언트 전체를 먼저 초기화할 필요는 없습니다. 테스트가 끝나면 임시로 올린 로그 수준을 원래대로 되돌려 일상적인 사용 중 연결 기록이 과도하게 쌓이지 않도록 하세요.

전체 가이드 보기

오픈 소스 생태계

Project V, V2Fly 및 Xray

Project V: GUI 클라이언트와 코어의 역할

초기 Project V에서는 V2Ray가 네트워크 프록시를 처리하는 핵심 구성 요소였습니다. 코어는 로컬 인바운드에서 수신하고 라우팅 조건을 확인해 아웃바운드 연결을 만듭니다. GUI 클라이언트는 구독, 서버 목록, 주요 설정을 조작하기 쉬운 화면으로 제공합니다. 이 역할 분담은 지금도 이어집니다. 사용자는 구독 그룹을 업데이트하거나 활성 서버를 전환할 수 있고, 클라이언트가 그에 맞춰 코어 설정을 생성하므로 매번 전체 파일을 직접 수정할 필요가 없습니다.

일상적인 대화에서 ‘V2Ray 설치’는 클라이언트를 설치한다는 뜻일 수도, 코어를 설정한다는 뜻일 수도 있습니다. 가이드를 보기 전에 두 단계를 구분하세요. 메뉴를 찾을 수 없다면 클라이언트와 인터페이스 버전을 확인하고, 코어가 시작되지 않는다면 구체적인 설정 필드와 실행 로그부터 살펴보세요. 두 문제의 해결 순서는 다릅니다. 화면이 비슷하다는 이유만으로 다른 사용자의 설정 절차를 그대로 따라 하지 마세요.

V2Fly와 Xray: 공통 기반에서 각자 발전한 프로젝트

V2Fly는 V2Ray 코어를 이어받아 커뮤니티에서 유지 관리하고 있습니다. Xray는 V2Ray 코드에서 발전해 독립적인 코어 계열을 이루었습니다. 두 코어는 일부 프로토콜과 설정 개념을 공유하지만 지원하는 전송 방식, 보안 옵션, 필드가 완전히 같지는 않습니다. v2rayN에서 설정에 따라 코어를 바꿀 수 있다고 해서 모든 서버를 코어 간에 자유롭게 바꿔 쓸 수 있는 것은 아닙니다. 모바일 클라이언트를 고를 때도 인터페이스보다 현재 서버가 요구하는 조건을 먼저 확인하세요.

예를 들어 서비스 제공자가 REALITY나 XTLS Vision 흐름 제어를 명시적으로 요구한다면, 먼저 선택한 코어와 클라이언트 조합이 해당 기능을 지원하는지 확인한 뒤 서버 프로토콜, 전송 방식, 보안 계층을 살펴보세요. 호환되지 않는 매개변수는 그대로 두고 코어만 바꾸면 서버가 목록에 표시되더라도 실제 연결은 실패할 수 있습니다. 클라이언트별 기능과 차이를 확인하려면 클라이언트 3종 비교를 참고하세요.

오픈 소스 범위: 인터페이스, 코어, 설정 형식

v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 GUI 클라이언트입니다. v2rayN은 데스크톱용이며, v2rayNG는 Xray 코어를 사용하고 v2flyNG는 V2Fly 코어 기반의 안드로이드 대안입니다. 클라이언트와 코어는 각각 관리되며 패키지에 포함된 구성 요소마다 오픈 소스 라이선스가 다를 수 있으므로 해당 소프트웨어 패키지의 라이선스 안내를 확인하세요. 오픈 소스는 코드와 배포 조건을 설명하는 말이지, 제3자 구독 서비스나 서버의 운영 방식을 뜻하지는 않습니다.

VMess, VLESS, Trojan은 서버에서 사용할 수 있는 프록시 프로토콜입니다. REALITY는 Xray 생태계의 보안 메커니즘이며 앞의 세 가지와 같은 종류의 프록시 프로토콜은 아닙니다. 서버 정보를 확인할 때는 프로토콜, 전송 방식, 보안 설정을 구분한 다음 코어의 지원 여부를 확인하세요. 특정 필드를 클라이언트가 입력하는지 코어가 해석하는지 알아보려면 핵심 개념 빠르게 보기부터 확인하세요.

업데이트 방식: 프로그램 업데이트와 구독 업데이트 구분

설치 파일을 업데이트하면 클라이언트 프로그램이 바뀌며 코어, 의존성, 인터페이스 메뉴도 달라질 수 있습니다. 구독 업데이트는 서비스 제공자가 게시한 서버 목록을 다시 가져오는 작업입니다. 업데이트 뒤 기존 서버가 사라졌다면 구독에서 항목이 삭제되었는지, 활성 서버를 다시 선택해야 하는지 먼저 확인하세요. 이전 설정을 옮긴 뒤 인터페이스는 표시되지만 코어가 시작되지 않는다면 설정을 생성할 때 사용한 매개변수가 아직 지원되는지도 확인하세요.

업그레이드 전에 주요 설정과 프록시 모드를 기록하고, 인터페이스에서 제공하는 방법으로 필요한 항목을 백업하세요. 업그레이드 후에는 기존 서버로 다시 테스트해 프로그램이 정상인지 확인한 다음 규칙을 조정하세요. 마이그레이션과 라우팅 재작성은 동시에 진행하지 마세요. 화면 안내와 실제 인터페이스가 다르면 메시지, 코어 로그, 시스템 요구 사항을 우선 기준으로 판단하세요. 플랫폼별 설치 순서와 일반적인 제한 사항은 플랫폼별 설치 가이드에서 확인할 수 있습니다.

더 읽어보기

클라이언트 설정 가이드

v2rayNG 안드로이드 사용 팁: VpnService 권한, 배터리 최적화 예외, 앱별 프록시

v2rayNG의 VpnService 권한 승인 절차와 제조사별 배터리 최적화 예외 설정, 앱별 프록시의 포함·제외 모드를 설명합니다.

연결은 시작되지만 화면을 잠근 뒤 끊기거나 특정 앱만 예상대로 프록시를 사용하지 않는 경우에 적합합니다. 두 현상은 원인이 다르므로 먼저 구분한 뒤 설정을 변경하세요.

REALITY와 XTLS Vision 이해하기: 핸드셰이크 위장과 흐름 제어가 더 빠른 이유

REALITY의 핸드셰이크 위장 방식과 XTLS Vision이 중복 암호화를 줄이는 흐름 제어 메커니즘, 두 기능이 Xray 코어에서 함께 작동하는 방식을 쉽게 설명합니다.

클라이언트 설정 필드부터 살펴보며 보안 계층과 흐름 제어의 역할을 구분하고, 가져오기에 성공한 뒤에도 코어 지원 여부를 확인해야 하는 이유를 알아봅니다.

V2Ray 연결됨으로 표시되지만 웹페이지가 열리지 않을 때: 단계별 점검 목록

시스템 프록시, 로컬 포트, 서버 시간, DNS, 라우팅 규칙, TUN 충돌 순서로 확인해 연결은 됐지만 인터넷이 되지 않는 원인을 찾아보세요.

문제를 안정적으로 재현할 수 있는 테스트 대상을 준비하세요. 먼저 앱 요청이 클라이언트에 들어오는지 확인한 뒤 라우팅과 핸드셰이크를 살펴보면 같은 문제를 두고 서버를 반복해서 바꾸지 않아도 됩니다.

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