Windows / macOS / Android / Linux 네 플랫폼 지원

V2Ray 설정 튜토리얼
v2rayN 다운로드 및 설정 방법

클라이언트 선택부터 연결 확인까지 구독 가져오기, 라우팅 분기, 문제 해결을 한곳에서 설명하고 v2rayN·v2rayNG·Xray·V2Fly의 실제 관계도 정리합니다.

주요 회선 지역 미국 일본 홍콩 싱가포르 한국

핵심 설정

시스템 프록시부터 라우팅 규칙까지 클라이언트 화면의 항목별 대응

설정 문제는 대개 하나의 스위치 때문에 발생하지 않습니다. 먼저 클라이언트·코어·구독이 정상인지 확인한 뒤 시스템 프록시, 라우팅과 DNS를 점검하면 노드를 계속 바꾸는 것보다 원인을 명확히 찾을 수 있습니다.

연결 입구

시스템 프록시 모드
연결할 앱을 결정

v2rayN에서 노드가 사용 가능으로 표시되어도 브라우저 트래픽이 이미 클라이언트로 전달된다는 뜻은 아닙니다. 시스템 프록시 모드는 운영체제의 프록시 설정을 따르는 앱을 로컬 인바운드 포트로 연결합니다. 일상적인 사용에서는 먼저 시스템 프록시 자동 설정을 선택한 다음 브라우저를 완전히 종료하고 다시 열어 기존 연결이 이전 경로를 계속 사용하지 않도록 하세요. 특정 프로그램만 연결되지 않는다면 노드 설정을 바로 바꾸기보다 해당 프로그램이 별도 프록시를 사용하는지, 시스템 설정을 우회하는지 확인해야 합니다.

이 단계에서 확인하는 것은 “앱이 클라이언트로 들어왔는가”이며, 프로토콜·회선·원격 서비스에 도달할 수 있는지는 별도의 문제입니다. 입구 문제와 노드 문제를 나누어 검증하면 구독을 반복해서 가져오거나 전송 매개변수를 계속 바꾸는 일을 줄일 수 있습니다.

시스템 프록시
시스템 프록시 자동 설정
기존 시스템 프록시 유지
로컬 네트워크 주소 우회
변경 후 앱 연결 다시 설정

클라이언트 다운로드

운영체제에 맞는 클라이언트 선택

데스크톱에서는 v2rayN을 기본 입구로 사용하고, Android에서는 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 다운로드 페이지에서 프로세서 아키텍처와 배포판에 맞는 파일을 추가로 확인할 수 있습니다.

Windows

v2rayN 데스크톱 버전 또는 클래식 WPF 버전을 사용하세요. 트레이 제어, 시스템 프록시 전환, 구독 그룹과 세부 라우팅 설정이 필요한 데스크톱 환경에 적합합니다.

다운로드 페이지로 이동

macOS

v2rayN 크로스플랫폼 데스크톱 인터페이스를 사용하세요. 다운로드할 때 기기의 프로세서에 맞는 빌드를 선택하고, 설치 후 시스템 프록시 권한과 구독 가져오기를 완료해야 합니다.

다운로드 페이지로 이동

Android

Xray 코어를 사용하는 v2rayNG를 우선 권장하며, 구독과 코어 선호도에 따라 v2flyNG를 선택할 수도 있습니다. 일반적인 기기는 보통 arm64 아키텍처를 사용합니다.

다운로드 페이지로 이동

Linux

v2rayN은 Debian·Ubuntu·Fedora 계열 배포판용 데스크톱 설치 항목을 제공하며 x64와 arm64 프로세서 아키텍처를 구분합니다.

다운로드 페이지로 이동

빠른 시작

가져오기·선택·확인의 세 단계로 기본 설정 완료

처음부터 모든 고급 옵션을 동시에 조정하지 마세요. 먼저 최소한의 연결을 만든 다음 앱 사용 목적에 맞춰 라우팅과 DNS 규칙을 추가하는 것이 좋습니다.

  1. STEP 01

    구독 또는 공유 링크 가져오기

    데스크톱에서는 클립보드에서 구독 주소나 단일 노드 공유 링크를 가져올 수 있으며 Android 클라이언트에도 해당 메뉴가 있습니다. 구독을 가져온 뒤 한 번 업데이트해 서버 목록이 표시되는지 확인하세요. 목록이 비어 있으면 먼저 복사한 내용에 불필요한 공백이 없는지, 주소가 완전한지, 기기 시간이 정확한지 점검하세요. 노드 목록을 받기 전에는 라우팅 규칙을 바꾸지 마세요. 이 단계의 문제는 아직 구독 가져오기 과정에 있기 때문입니다.

  2. STEP 02

    노드 선택 후 프록시 활성화

    구독 그룹에서 사용할 노드를 선택한 뒤 클라이언트 코어를 실행하세요. Windows·macOS·Linux 데스크톱에서는 시스템 프록시 모드도 설정해야 하며, Android에서는 시스템 연결 권한을 확인해야 합니다. 노드 선택은 설정이 사용 대기 상태가 되었다는 의미일 뿐입니다. 코어가 정상적으로 실행되어 앱 트래픽을 넘겨받아야 완전한 연결이 성립합니다. 첫 확인에서는 고급 규칙이 영향을 주지 않도록 기본 라우팅을 유지하세요.

  3. STEP 03

    로그와 실제 접속 확인

    연결이 완료되면 먼저 새 브라우저 창을 열어 접속을 테스트한 뒤 클라이언트 로그에서 도메인 확인, TLS 핸드셰이크 또는 연결 시간 초과 메시지를 살펴보세요. 지연 시간 테스트는 탐색 요청의 응답만 보여줄 뿐 전체 웹페이지 접속을 대신할 수 없습니다. 브라우저가 기존 연결을 계속 사용한다면 완전히 종료한 후 다시 여세요. 모든 노드가 실패한다면 시스템 프록시, DNS, 로컬 네트워크, 구독 유효성, 원격 상태 순서로 단계별 점검을 진행하세요.

오픈소스 생태계

Project V·V2Fly·Xray와 그래픽 클라이언트의 관계

이름이 비슷하다고 역할까지 같은 것은 아닙니다. 생태계·코어·클라이언트의 세 계층을 이해하면 튜토리얼의 설정이 화면 조작인지, 설정 형식인지, 프로토콜 구현인지 판단하기 쉬워집니다.

Project V는 기술 생태계의 출발점입니다

Project V는 프록시 프로토콜·전송 방식·라우팅·설정 구조를 중심으로 오픈소스 기술 생태계를 형성했습니다. VMess · VLESS · WebSocket · gRPC · TLS · REALITY · routing 같은 용어는 서로 다른 계층에 속합니다. 일부는 인증과 데이터 전달을 담당하고, 일부는 연결을 운반하며, 일부는 트래픽의 최종 경로를 결정합니다. 클라이언트 화면은 이 필드들을 양식으로 정리하지만, 내부에서는 여전히 코어가 읽을 수 있는 설정으로 변환합니다.

따라서 이른바 “V2Ray 설정”은 하나의 스위치가 아니라 인바운드·아웃바운드·전송·보안·DNS·라우팅이 함께 만든 결과입니다. 일반 사용자는 보통 구독으로 전체 매개변수를 받은 뒤 클라이언트 가져오기와 시스템 프록시만 처리하면 됩니다. 규칙을 직접 관리해야 할 때는 거대한 설정을 그대로 복사하기보다 각 영역의 역할을 단계적으로 이해하는 편이 오류를 찾기 쉽습니다.

V2Fly와 Xray는 서로 다른 코어 계열입니다

V2Fly는 Project V 관련 기술의 커뮤니티 유지 노선을 이어가며 익숙한 설정 구조와 프로토콜 기능을 유지합니다. Xray는 유사한 설정 체계에서 발전했으며 VLESS·REALITY 같은 일반적인 배포 조합을 지원합니다. 둘 다 실행 코어로서 설정을 읽고 로컬 인바운드를 수신하며 도메인 확인과 라우팅 매칭을 수행하고 실제 아웃바운드 연결을 만듭니다. 코어 자체는 데스크톱 창이나 모바일 화면과 동일하지 않습니다.

어떤 코어를 선택할지는 노드 요구 사항, 클라이언트 지원 여부, 설정 필드를 기준으로 결정해야 합니다. 가져오기는 성공했지만 실행되지 않는다면 먼저 로그에 지원되지 않는 필드나 형식 오류가 있는지 확인하세요. 코어는 실행되지만 접속에 실패한다면 네트워크·DNS·인증서 이름·원격 응답을 점검해야 합니다. “설정을 해석할 수 있는가”와 “연결을 만들 수 있는가”를 나누어 보는 것이 복잡한 문제를 해결하는 핵심입니다.

그래픽 클라이언트는 시스템 통합과 일상 관리를 담당합니다

v2rayN은 Windows·macOS·Linux 데스크톱 환경을 대상으로 구독 업데이트, 노드 선택, 시스템 프록시, 라우팅 규칙 편집, 코어 전환과 로그 확인을 주로 담당합니다. v2rayNG는 Android용이며 보통 Xray 코어와 함께 사용합니다. v2flyNG 역시 Android용으로 V2Fly 코어 노선에 중점을 둡니다. 세 클라이언트 모두 공개 오픈소스 협업 방식으로 유지되지만 출시 주기·화면 구성·지원 필드는 완전히 같지 않습니다.

클라이언트 업그레이드에는 화면 변경, 실행 코어 업데이트 또는 설정 호환성 변화가 포함될 수 있습니다. 업데이트 전에는 현재 사용할 수 있는 구독 그룹, 시스템 프록시 모드와 사용자 지정 라우팅을 기록해 두고, 업데이트 후에는 최소 연결을 먼저 확인한 다음 고급 설정을 복원하세요. 기존 설정을 바로 사용할 수 없다면 로그와 현재 필드 설명을 기준으로 조정해야 하며, 서로 다른 클라이언트의 설정 폴더를 그대로 덮어쓰면 안 됩니다.

오픈소스 라이선스가 만드는 검토 가능한 유지 방식

오픈소스 라이선스는 코드의 사용·수정·배포 범위를 명확히 하고 프로토콜 구현, 설정 처리와 문제 수정 과정을 커뮤니티가 검토할 수 있게 합니다. 일반 사용자에게 더 실질적인 가치는 문서·이슈 기록·버전 변경 사항이 추적 가능한 기술 자료로 쌓인다는 점입니다. 그렇다고 올바른 설정을 대신해 주거나 모든 서드파티 구독 출처의 신뢰성을 보장하는 것은 아닙니다. 클라이언트·코어·노드 서비스는 각각 따로 판단해야 합니다.

이 사이트의 튜토리얼은 공개된 설정 의미와 실제 클라이언트 화면을 바탕으로 각 옵션의 역할, 의존 관계와 점검 순서를 설명합니다. 구독은 가져오기와 관리 방법만 다루고, 프로토콜은 필드와 연결 방식만 설명합니다. 이처럼 계층을 나누면 클라이언트 문제·코어 문제·원격 서비스 문제를 하나의 결론에 섞는 일을 피할 수 있습니다.

자주 묻는 질문

먼저 문제가 발생한 계층을 확인하세요

구독·노드·시스템 프록시·DNS·라우팅은 순서대로 연결에 영향을 줍니다. 증상으로 문제 구간을 찾는 것이 클라이언트를 반복해서 삭제하고 재설치하는 것보다 효과적입니다.

구독 업데이트는 성공했는데 왜 목록이 비어 있나요?

먼저 구독 응답이 클라이언트가 지원하는 노드 형식인지 확인하고 그룹 필터 조건, 기기 시간과 업데이트 로그를 점검하세요. 단일 공유 링크를 복사했다면 구독 업데이트 메뉴가 아니라 클립보드에서 노드를 가져오는 메뉴를 사용해야 합니다.

구독 및 노드 용어 보기 →

지연 시간 테스트는 정상인데 왜 브라우저에서 웹페이지가 열리지 않나요?

탐색 응답과 전체 접속은 같은 과정이 아닙니다. 시스템 프록시가 켜져 있는지, 브라우저가 기존 연결을 재사용하는지, DNS가 사용 가능한 결과를 반환하는지, 라우팅 규칙이 대상 도메인을 예상한 아웃바운드로 보내는지 계속 확인하세요.

인터넷 연결 불가 문제 해결 보기 →

VLESS·VMess·REALITY는 각각 무엇인가요?

VLESS와 VMess는 클라이언트와 서버 사이에서 사용하는 프로토콜 유형이고, REALITY는 연결 보안과 핸드셰이크에 관련된 방식입니다. 서로 바로 교체할 수 없으므로 가져올 때 노드가 제공한 프로토콜·전송·보안 필드를 모두 유지해야 합니다.

프로토콜 용어 보기 →

라우팅을 바꾼 뒤 일부 웹사이트만 문제가 생기면 어떻게 하나요?

일단 더 단순한 기본 규칙으로 되돌려 기본 연결이 복구되는지 확인한 다음 도메인과 IP 조건을 하나씩 추가하세요. 규칙 순서와 매칭 범위, 같은 서비스의 기본 도메인·API 도메인·정적 리소스 도메인이 서로 다른 아웃바운드로 향하지 않는지 중점적으로 확인해야 합니다.

DNS 및 라우팅 분기 문제 해결 보기 →

기술 노트

설정 구조·인증서 오류·공유 링크

최신 글에서는 클라이언트 화면 뒤에 있는 설정 로직을 설명하며, 기본 연결을 완료한 뒤 이어서 읽기에 적합합니다.

고급 원리

V2Ray 설정 파일 구조 한눈에 보기: inbounds·outbounds·routing의 역할

최소한으로 작동하는 V2Ray JSON 설정을 분해해 인바운드·아웃바운드·라우팅 영역의 역할과 v2rayN 그래픽 설정의 대응 관계를 설명합니다.

전체 글 읽기 →
문제 해결

TLS 핸드셰이크 실패와 인증서 오류 해결: 시스템 시간·SNI·allowInsecure 핵심 세 가지

시스템 시간·SNI·인증서 체인·클라이언트 로그를 기준으로 점검 순서를 정리하고, 인증서 검사를 완화할 때 발생하는 실제 위험도 설명합니다.

전체 글 읽기 →
입문 가이드

vmess://와 vless:// 공유 링크는 어떻게 사용하나요? 구독 주소와의 차이까지 한 번에 정리

단일 노드 공유 링크와 업데이트 가능한 구독 목록의 구조적 차이를 설명하고 v2rayN과 v2rayNG에서 사용하는 가져오기 메뉴를 안내합니다.

전체 글 읽기 →