다운로드 · 설정 · 라우팅 분할 · 문제 해결

V2Ray 설정 가이드

클라이언트 설치부터 시작해 구독 가져오기, 라우팅 분할, 문제 원인 파악까지 데스크톱과 Android에서 자주 사용하는 절차를 안내합니다.

한국어 문서 오픈 소스 코드 Xray · V2Fly 그래픽 클라이언트
connection path

구독 입력부터 출구 연결 확인까지의 설정 흐름

클라이언트 설정은 서로 무관한 스위치의 모음이 아닙니다. 구독은 노드 정보를 제공하고, 라우팅은 트래픽의 경로를 결정하며, 시스템 프록시 또는 TUN 모드는 애플리케이션 요청을 넘겨받습니다. 로그와 연결 테스트는 각 단계가 예상대로 작동하는지 확인하는 데 사용됩니다.

subscribe / input

구독 링크 가져오기, 업데이트 및 노드 확인

구독 링크는 클라이언트가 노드 설정을 가져오는 시작점입니다. 데스크톱에서는 보통 구독 그룹에 주소를 추가한 뒤 업데이트를 실행하고, Android 클라이언트에서는 클립보드로 가져오거나 신뢰할 수 있는 출처의 QR 코드를 스캔할 수 있습니다. 가져오기가 완료되었다고 연결까지 정상인 것은 아닙니다. 먼저 노드 목록이 표시되는지, 이름이 올바른지, 그룹이 예상한 출처와 일치하는지 확인하세요. 목록이 비어 있다면 시스템 프록시를 반복해서 바꾸기보다 주소가 완전한지, 네트워크 요청이 성공했는지, 클라이언트 로그의 응답 상태가 어떤지부터 점검해야 합니다.

구독을 업데이트하면 클라이언트가 원격 콘텐츠를 다시 읽으며 같은 그룹의 기존 노드를 덮어쓸 수 있습니다. 장기간 보관할 수동 설정은 별도 그룹에 저장해 구독 업데이트와 섞이지 않도록 하세요. 노드가 나타난 뒤에는 연결 테스트를 한 번 더 실행해 ‘구독 읽기 성공’과 ‘특정 노드 연결 가능’이라는 두 결과를 구분해야 합니다. 이 순서대로 확인하면 문제를 입력, 파싱 또는 연결 단계로 좁힐 수 있어 DNS, 포트, 라우팅 규칙을 목적 없이 바꾸는 일을 줄일 수 있습니다.

platform entry

Windows, macOS, Android 및 Linux 다운로드入口

데스크톱 플랫폼은 모두 v2rayN을 사용하며, Android에서는 커널 요구 사항에 따라 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 플랫폼入口는 다운로드 페이지의 해당 탭으로 이동하며, 설치 패키지 유형, 시스템 요구 사항, 칩셋 선택 안내가 한곳에 정리되어 있습니다.

desktop / windows

Windows · v2rayN

Windows 사용자는 차세대 데스크톱 인터페이스와 클래식 WPF 인터페이스 중에서 선택할 수 있습니다. 설치가 끝나면 먼저 구독을 가져오고 노드를 선택한 다음 시스템 프록시를 설정하세요. 시작할 때 로컬 포트가 이미 사용 중이라는 메시지가 표시되면 점유 프로세스를 확인하거나 수신 포트를 변경한 뒤 프록시 설정도 함께 업데이트해야 합니다. 다운로드 페이지에는 두 인터페이스의 용도 차이도 안내되어 있어 현재 시스템 환경에 맞게 선택할 수 있습니다.

다운로드 페이지로 이동
desktop / macos

macOS · v2rayN

macOS를 다운로드하기 전 프로세서 아키텍처를 확인해야 하며, Apple Silicon과 Intel에는 서로 다른 설치 파일이 제공됩니다. 처음 실행할 때 시스템 보안 확인이나 네트워크 접근 권한 요청이 나타날 수도 있습니다. 시스템 설정에서 권한을 승인한 뒤 클라이언트로 돌아와 구독을 가져오세요. 연결 후에는 먼저 메뉴 막대 상태와 시스템 프록시를 확인하고 애플리케이션 접속을 테스트해 권한 문제를 노드 이상으로 오해하지 않도록 하세요.

다운로드 페이지로 이동
mobile / android

Android · v2rayNG / v2flyNG

Android의 기본 선택지는 Xray 커널을 사용하는 v2rayNG이며, V2Fly 커널을 선호한다면 v2flyNG를 선택할 수 있습니다. 최신 기기 대부분은 arm64 아키텍처를 사용하지만 아키텍처를 확인하기 어렵다면 다운로드 페이지에서 범용 설치 파일을 확인하세요. 구독을 가져온 뒤 노드를 선택하고 시스템 네트워크 연결을 시작해야 합니다. 이후 연결 상태, 앱별 설정, 배터리 백그라운드 제한을 각각 점검해 화면이 잠긴 뒤 클라이언트가 시스템에 의해 중지되지 않도록 하세요.

다운로드 페이지로 이동
desktop / linux

Linux · v2rayN

Linux 데스크톱에서는 배포판에 맞춰 deb 또는 rpm 설치 파일을 선택하고 x64와 arm64 아키텍처도 확인해야 합니다. 설치 후에는 그래픽 인터페이스로 구독, 노드, 라우팅 규칙을 관리할 수 있습니다. 시스템 프록시가 대상 애플리케이션에 영향을 주지 않는다면 데스크톱 환경의 프록시 설정과 애플리케이션이 자체 네트워크 설정을 사용하는지 확인하세요. 더 넓은 처리 범위가 필요할 때 TUN 권한과 가상 네트워크 어댑터 상태를 검토하면 됩니다.

다운로드 페이지로 이동
open ecosystem

Project V, V2Fly 및 Xray 커널의 관계

클라이언트, 커널, 프로토콜의 역할을 구분하면 설정 문제가 어느 계층에서 발생했는지 판단하기 쉽고, 그래픽 인터페이스 이름과 구독 형식, 전송 프로토콜을 혼동하는 일도 줄일 수 있습니다.

project / lineage

V2Ray 프로젝트에서 커널 계열로

V2Ray는 Project V 생태계에서 시작되었으며, 인바운드, 라우팅, 아웃바운드, 하위 전송 계층을 조합 가능한 설정 모듈로 나누는 설계를 핵심으로 삼았습니다. 커뮤니티의 유지보수 방향이 발전하면서 V2Fly는 v2ray-core 체계를 이어갔고, Xray는 유사한 설정 철학을 바탕으로 별도의 커널 계열로 발전했습니다. 두 커널 모두 다양한 프록시 프로토콜과 전송 방식을 처리할 수 있지만 구체적인 필드, 기능 지원 범위, 기본 동작은 다를 수 있습니다. 따라서 설정을 가져오기 전에 클라이언트가 사용하는 커널과 구독 내용에 해당 커널이 인식할 수 있는 매개변수가 포함되어 있는지 확인해야 합니다.

그래픽 클라이언트는 커널 위에서 작동하며 구독 관리, 노드 선택, 시스템 프록시, 로그 확인, 업데이트 설정을 담당합니다. v2rayN은 데스크톱 플랫폼용으로 소프트웨어에서 제공하는 옵션에 따라 해당 커널을 호출할 수 있고, v2rayNG는 주로 Xray 커널을 사용하며, v2flyNG는 V2Fly 커널 계열을 대상으로 합니다. 클라이언트 이름은 프로토콜 이름과 같지 않으며, 특정 클라이언트를 선택했다고 해서 모든 노드가 같은 프로토콜을 사용하는 것도 아닙니다. 실제 연결 경로는 노드 설정, 전송 계층, TLS 설정, 라우팅 규칙, 클라이언트 처리 방식이 함께 결정합니다.

license

오픈 소스 라이선스와 코드 범위

V2Fly 코어, Xray 코어, 세 가지 그래픽 클라이언트는 각각 자체 코드와 라이선스 파일을 관리합니다. 핵심 프로젝트와 클라이언트는 서로 다른 오픈 소스 라이선스를 사용할 수 있으며, 배포 패키지에는 각자의 의존 구성 요소도 포함됩니다. 라이선스를 확인할 때는 생태계 전체를 하나의 프로젝트로 간주하지 말고 해당 소프트웨어 배포물에 포함된 안내를 기준으로 삼아야 합니다. 공개된 코드와 설정 형식은 커뮤니티가 구현을 검토하고 호환성을 논의하며 문제를 지속적으로 수정하는 데 도움이 됩니다.

maintenance

클라이언트와 커널은 별도로 업데이트

그래픽 인터페이스와 네트워크 커널은 서로 다른 출시 주기를 가집니다. 클라이언트 업데이트는 구독 관리, 화면 상호작용, 시스템 통합을 조정할 수 있고, 커널 업데이트는 프로토콜 구현, 전송 기능, 라우팅, 네트워크 동작에 더 중점을 둡니다. 업그레이드 후 이상이 발생하면 먼저 변화가 클라이언트에서 왔는지 커널에서 왔는지 구분한 다음 로그와 설정 마이그레이션 안내를 함께 확인하세요. 다운로드 페이지에는 현재 설치入口를 모아 제공하며, 홈페이지에는 빠르게 바뀔 수 있는 출시 정보를 고정해 표시하지 않습니다.

configuration

프로토콜, 전송, 라우팅 계층

VMess, VLESS, Trojan 등의 이름은 프로토콜 계층 설정을 가리키고, WebSocket, gRPC 등은 전송 방식을 의미합니다. TLS와 REALITY는 연결 인증 및 보안 전송과 관련되며, 라우팅 규칙은 요청이 어떤 아웃바운드를 사용할지 결정합니다. 문제를 점검할 때는 계층별로 확인해야 합니다. 도메인 조회가 실패했다고 바로 프로토콜 매개변수를 바꾸거나, 애플리케이션이 로컬 프록시에 들어오지 않는데 원격 노드를 반복해서 조정해서는 안 됩니다.

v2rayN

데스크톱 그래픽 클라이언트

Windows, macOS, Linux에서 구독, 노드, 라우팅, 시스템 프록시, TUN 설정을 한곳에서 관리합니다. 데스크톱 환경에서 로그를 확인하고 여러 구독 그룹을 관리하며 트래픽 처리 방식을 세밀하게 조정해야 하는 사용자에게 적합합니다.

v2rayNG

Android · Xray 계열

모바일 사용 흐름을 중심으로 구독 가져오기, 노드 선택, 앱별 프록시, 라우팅, 시스템 네트워크 연결을 관리할 수 있습니다. 백그라운드에서 연결이 끊기면 기기의 배터리 정책과 백그라운드 실행 권한도 함께 확인해야 합니다.

v2flyNG

Android · V2Fly 계열

V2Fly 커널 구현이 필요한 모바일 설정을 대상으로 하며, Android 플랫폼에서 선택할 수 있는 또 다른 커널입니다. 가져오기 전에 구독 매개변수와 커널 지원 범위를 확인해 커널 차이를 구독 주소 오류로 오해하지 않도록 하세요.

latest notes

고급 설정 및 문제 해결 문서

구체적인 증상과 설정 단계를 중심으로 원리, 조작 절차, 결과 확인, 되돌리기 방법을 설명합니다. 먼저 기본 설치와 구독 가져오기를 완료한 뒤 실제 문제에 맞는 주제를 읽는 것을 권장합니다.

TUN 모드 활성화 방법: 가상 네트워크 어댑터로 전체 트래픽을 처리하는 원리와 설정 단계

TUN 모드와 시스템 프록시의 본질적인 차이를 설명하고, 가상 네트워크 어댑터, 라우팅 테이블, DNS, 애플리케이션 트래픽의 관계를 정리합니다. 또한 v2rayN과 v2rayNG에서 활성화하는 단계와 권한 부족, 네트워크 미복구, 다른 가상 네트워크 어댑터 충돌 시 점검 방법을 안내합니다.

전체 문서 읽기

포트가 사용 중일 때: 점유 프로세스 확인 및 V2Ray 로컬 수신 포트 변경

클라이언트 시작 시 포트 충돌이 발생하면 먼저 수신 포트와 점유 프로세스를 확인한 뒤 기존 프로세스를 종료할지 설정을 변경할지 결정해야 합니다. 주요 데스크톱 시스템에서 확인하는 방법과 포트를 변경한 뒤 시스템 프록시 및 애플리케이션 프록시 설정도 반드시 함께 업데이트해야 하는 이유를 설명합니다.

전체 문서 읽기

DNS 누수 점검 및 해결: 도메인 조회와 트래픽을 같은 경로로 보내기

도메인 조회 경로를 바탕으로 클라이언트가 이미 연결된 상태에서도 조회 요청이 다른 네트워크 인터페이스로 전송될 수 있는 이유를 설명합니다. 점검 방법과 v2rayN, v2rayNG의 DNS 설정 확인 항목을 제시하고, 변경 전후 요청 경로를 비교해 해결 여부를 검증합니다.

전체 문서 읽기
클라이언트 다운로드