분할 라우팅 규칙 메모
  • geosite:cn → direct
  • geoip:private → direct
  • geosite:category-ads-all → block
  • final → proxy
라우팅 규칙 작성법 →
그래픽 클라이언트 · 설정 가이드

V2Ray 공식 사이트 v2rayN 클라이언트 다운로드

v2rayN 다운로드 가이드 보기

구독 가져오기부터 분할 라우팅까지, 기기에 맞는 클라이언트를 선택하고 시스템 프록시와 DNS를 설정하는 방법을 단계별로 알아보세요.

프로토콜 한눈에 보기 VMess VLESS Trojan Shadowsocks
다운로드

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

데스크톱에서는 v2rayN, Android에서는 우선 v2rayNG를 살펴보세요. 운영체제와 프로세서 아키텍처를 확인한 뒤 다운로드 센터에서 알맞은 설치 파일을 선택하면 됩니다. 클라이언트 설치와 연결 설정은 별개이므로, 구독이나 서버 정보가 있다면 따로 가져와야 합니다.

Windows

v2rayN

데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, 기존 WPF 버전은 익숙한 데스크톱 사용 방식을 유지합니다. 새로 설치한다면 데스크톱 버전 안내를 먼저 확인하세요. 기존 설정을 이어서 사용할 경우 구독과 규칙을 백업한 뒤 인터페이스 버전을 바꿀지 결정하는 것이 좋습니다. 런타임 요구 사항과 설치 방법은 다운로드 페이지에서 버전별로 안내합니다. 서로 다른 버전의 파일을 같은 폴더에 덮어쓰지 마세요.

다운로드 페이지로 이동 →

macOS

v2rayN

먼저 ‘이 Mac에 관하여’에서 칩 종류를 확인하고 Apple Silicon 또는 Intel용 설치 파일을 선택하세요. 처음 실행할 때는 시스템 안내에 따라 앱 실행을 허용하고 네트워크 권한을 부여해야 합니다. 기본 창이 열렸다고 해서 프록시가 트래픽을 처리하는 것은 아닙니다. 구독 가져오기, 서버 선택, 시스템 프록시 설정까지 마쳐야 합니다.

다운로드 페이지로 이동 →

Android

v2rayNG / v2flyNG

우선 Xray 코어를 사용하는 v2rayNG를 선택하고, V2Fly 코어가 필요하다면 v2flyNG를 확인하세요. 기기 아키텍처에 맞춰 arm64 또는 범용 패키지를 선택하고, 처음 연결할 때 시스템 VPN 권한을 허용해야 합니다. 앱을 백그라운드로 전환한 뒤 연결이 끊긴다면 구독을 반복해서 가져오기보다 배터리 최적화와 백그라운드 실행 권한을 확인하세요.

다운로드 페이지로 이동 →

Linux

v2rayN

배포판의 패키지 형식에 따라 deb 또는 rpm을 선택하고 x64와 arm64를 구분하세요. 설치 후에는 일반 시스템 프록시로 기본 연결을 확인한 다음 필요에 따라 TUN을 설정하세요. 데스크톱 환경, 권한 정책, 앱 자체의 프록시 지원 여부에 따라 트래픽 처리 범위가 달라집니다. 설치 패키지 형식만으로 네트워크 설정을 대신할 수는 없습니다.

다운로드 페이지로 이동 →

세 클라이언트의 차이가 궁금하다면 기기에 따라 선택지를 좁힌 다음 코어와 설정 방식의 차이를 비교해 보세요. 데스크톱용과 Android용 설치 파일은 서로 바꿔 쓸 수 없습니다.

전체 클라이언트 보기 → 클라이언트 비교 보기 →
설정 가이드

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

그래픽 클라이언트에서는 서버 정보, 코어 설정, 시스템 네트워크 진입 방식을 한곳에서 관리하지만 각각의 역할은 다릅니다. 아래 주제를 따라 설정 범위를 하나씩 확인하세요. 먼저 설정을 가져오는 방법을 파악하고, 어떤 연결을 코어로 보낼지 정한 뒤, 트래픽이 어떤 아웃바운드로 나가는지 확인합니다.

구독 가져오기: 설정 출처와 서버 목록 구분하기

구독은 서버 설정을 한꺼번에 가져오는 방법이지, 연결 성공을 보장하는 표시가 아닙니다. v2rayN의 ‘구독 그룹 설정’에서 주소를 추가하고 저장한 뒤 업데이트하고, 서버 목록에서 사용할 항목을 선택하세요. Android에서도 먼저 구독 그룹을 만들어야 합니다. 서버 정보를 하나씩 입력하는 것보다 그룹을 사용하면 출처를 구분하고 나중에 업데이트하기 쉽지만, 업데이트 과정에서 목록 내용이 바뀔 수 있습니다. 구독 주소에는 접근 정보가 포함될 수 있으므로 화면을 공유할 때 전체 주소를 가리세요. 목록이 비어 있다면 라우팅이나 DNS를 바로 수정하지 말고 업데이트 결과와 주소 유효성부터 확인하세요.

구독 그룹 설정 · 구독 업데이트 · 활성 서버로 설정

클라이언트 인터페이스가 바뀌면서 설정 이름도 달라질 수 있습니다. 진입점, 규칙, 아웃바운드의 관계를 이해한 뒤 현재 인터페이스에 맞춰 설정하세요. 사용자 지정 규칙을 추가하거나 DNS 경로를 조정하려면 고급 설정을 주제별로 살펴보세요.

고급 설정 가이드 보기 →
빠른 시작

설치 후 설정할 세 가지

처음 사용한다면 기본 연결 하나를 먼저 확인하고 모든 옵션을 한꺼번에 켜지 마세요. 아래 순서는 설정 가져오기, 트래픽 진입 방식, 연결 확인으로 구성되어 있습니다. 단계마다 한 종류의 설정만 바꾸면 문제가 생겼을 때 확인할 지점을 쉽게 찾을 수 있습니다.

  1. 구독을 가져와 활성 서버 선택하기

    기존 구독 주소나 서버 공유 정보를 준비하세요. 데스크톱에서는 구독 그룹에 주소를 저장하고 업데이트를 실행합니다. Android에서도 구독 그룹 설정으로 이동해 같은 작업을 하면 됩니다. 목록에 설정이 나타나는지 확인한 뒤 하나를 현재 서버로 선택하세요. 공유 링크를 직접 가져오는 경우에는 이름만 표시되는지 확인하지 말고 프로토콜, 주소, 포트, 전송 매개변수가 모두 있는지 살펴보세요.

    구독 업데이트는 설정을 가져오는 작업이고, 연결 버튼은 현재 설정을 실행하는 작업입니다. 두 단계의 결과를 따로 확인하세요. 업데이트에 실패하면 주소가 만료되었는지, 불필요한 공백이 포함되었는지, 현재 네트워크에서 구독 출처에 접근할 수 있는지 먼저 확인하세요. 오류 메시지를 보관하면 가져오기를 계속 반복하는 것보다 원인을 찾기 쉽습니다. 접근 정보가 포함된 구독 주소를 공개된 곳에 올리지 마세요.

  2. 라우팅 방식 선택 후 트래픽 진입 설정

    데스크톱에서는 먼저 코어가 정상적으로 시작되는지 확인한 다음 필요에 따라 시스템 프록시 자동 설정을 켜세요. Android에서 연결을 시작할 때는 시스템 창에서 VPN 권한을 허용하세요. 다음으로 사용 목적에 맞는 라우팅 모드를 선택합니다. 전역 모드에서는 일반적으로 코어에 들어온 연결이 프록시 아웃바운드를 사용하고, 중국 본토 우회 모드에서는 해당 규칙에 따라 일부 연결을 직접 연결합니다. 실제 동작은 현재 규칙 집합에 따라 달라집니다.

    ‘전역’ 모드라고 해서 기기의 모든 프로그램이 자동으로 클라이언트를 사용한다는 뜻은 아닙니다. 시스템 프록시를 무시하는 앱은 별도의 프록시 진입 방식을 설정하거나, 권한과 라우팅 영향을 이해한 뒤 TUN을 사용해야 합니다. 첫 테스트에서는 시스템 프록시 설정이 반복해서 바뀌지 않도록 다른 프록시 도구를 함께 실행하지 않는 것이 좋습니다. 로컬 네트워크 기기에 접근할 수 없다면 사설 주소의 직접 연결 규칙부터 확인하세요.

  3. 접속 경로 확인 후 설정 보관하기

    연결을 시작한 뒤 직접 연결해야 하는 대상과 프록시를 사용해야 하는 대상에 각각 접속해 브라우저와 자주 사용하는 앱이 제대로 작동하는지 확인하세요. 연결 아이콘이나 포트 테스트가 성공해도 일부 단계만 정상일 수 있으므로 전체 접속 테스트를 대신할 수는 없습니다. 특정 앱만 실패한다면 해당 앱이 시스템 프록시를 사용하는지 먼저 확인하세요. 모든 접속이 실패하면 현재 서버, 로그 오류, DNS 해석 경로를 점검합니다.

    문제를 해결할 때는 한 번에 한 항목만 바꾸고 변경 전후 결과를 기록하세요. 인증서 오류가 발생하면 검증을 바로 끄지 말고 기기 시간과 서버 이름부터 확인합니다. 포트가 사용 중이라면 다른 클라이언트가 실행 중인지 살펴보세요. 기본 연결이 안정되면 설정을 백업한 뒤 분할 라우팅, DNS, TUN을 차례로 추가하세요. 이후 문제가 생겨도 되돌아갈 기준점이 분명해집니다.

전체 가이드 보기 →

가이드에서는 데스크톱과 Android의 설정 차이를 설명합니다. 용어가 낯설다면 먼저 개념 빠른 참조에서 구독, 노드, 인바운드, 아웃바운드를 구분한 다음 설정을 진행하세요.

오픈소스 생태계

Project V, 코어, 그래픽 클라이언트

V2Ray 관련 이름은 다운로드 및 설정 안내에 함께 등장하는 경우가 많습니다. 프로젝트 배경, 연결을 처리하는 코어, 사용자 인터페이스를 제공하는 클라이언트를 구분하면 같은 구독을 여러 기기에서 사용할 때도 설정을 각각 확인해야 하는 이유를 이해할 수 있습니다.

Project V: 생태계와 프로젝트의 흐름

Project V는 네트워크 통신 도구를 중심으로 형성된 오픈소스 생태계의 배경이며, V2Ray는 그 안에서 널리 사용되는 핵심 프로젝트 이름입니다. V2Fly 커뮤니티는 V2Ray의 개발과 유지 관리를 이어 왔고, Xray는 관련 코드와 기술을 바탕으로 발전한 별도의 코어 계열입니다. 일부 역사와 설정 개념을 공유하지만 이후 기능은 각기 다르게 발전했으므로 이름이 비슷하다고 해서 모든 항목이 완전히 호환된다고 볼 수는 없습니다.

실제 사용자는 보통 모든 코어 설정을 직접 편집하지 않고 그래픽 클라이언트로 구독, 서버, 라우팅을 관리합니다. 따라서 ‘V2Ray 다운로드’는 그래픽 클라이언트나 코어 자체를 가리킬 수 있습니다. 이 사이트에서는 v2rayN, v2rayNG, v2flyNG를 중심으로 다운로드 옵션을 안내합니다. 처음에는 기기에 맞는 클라이언트를 선택한 다음 서버 매개변수를 확인해 필요한 코어를 고르면 순서를 이해하기 쉽습니다.

코어 계열: 설정이 비슷해도 기능은 따로 확인

코어는 설정을 읽고 연결을 수립하며 라우팅과 관련된 DNS 처리 과정을 수행합니다. 클라이언트 인터페이스는 사용자의 선택을 실행 가능한 설정으로 변환합니다. Xray와 V2Fly는 모두 이 실행 계층에 속하지만 프로토콜 확장, 전송 매개변수, 설정 항목은 각 코어의 지원 범위를 확인해야 합니다. 공유 링크를 가져올 수 있다고 해서 현재 코어가 링크에 필요한 모든 기능을 지원하는 것은 아닙니다. 시작 로그도 중요한 판단 기준입니다.

v2rayNG는 Xray 코어를 기반으로 하고 v2flyNG는 V2Fly 코어를 사용합니다. 데스크톱용 v2rayN은 해당 코어를 설정하고 관리하는 기능을 제공합니다. 특정 코어를 모든 상황에 맞는 정답으로 여기기보다 기존 서버의 프로토콜, 전송 방식, 보안 매개변수에 맞춰 선택하세요. 코어를 전환하기 전에 정상 작동하는 설정을 보관하고, 전환 후에는 시작 결과와 실제 접속을 확인한 뒤 라우팅이나 DNS를 추가로 조정할지 결정하세요.

오픈소스 라이선스: 소스 코드와 사용 조건 확인하기

v2rayN, v2rayNG, v2flyNG는 모두 오픈소스 그래픽 클라이언트입니다. 오픈소스란 해당 라이선스의 조건에 따라 소스 코드를 열람하고 연구하거나 수정할 수 있다는 뜻이지, 서로 다른 프로젝트의 코드를 제한 없이 복사할 수 있다는 뜻은 아닙니다. 클라이언트와 코어, 종속 구성 요소는 각기 다른 라이선스를 적용할 수 있습니다. 재배포, 수정, 통합을 고려한다면 ‘오픈소스’라는 표시만으로 사용 조건을 판단하지 말고 각 프로젝트에 포함된 라이선스와 저작권 안내를 따로 확인하세요.

일반 사용자에게 오픈소스 생태계가 중요한 이유는 설정 방식을 함께 논의하고 로그와 구체적인 단계로 문제를 재현하며 실제 설정 항목에 맞춰 문서를 계속 개선할 수 있다는 점입니다. 클라이언트에 바로 사용할 수 있는 서버가 포함되어 있지는 않으므로 설치 후에는 기존 구독이나 서버 설정이 필요합니다. 소프트웨어의 오픈소스 여부, 연결 서비스의 출처, 네트워크 사용 권한은 서로 다른 문제입니다. 각각 확인하고 사용 권한을 확보한 네트워크 환경에서 이용하세요.

플랫폼과 코어별 클라이언트 비교 →
클라이언트와 실행 계층 구분하기
그래픽 클라이언트
구독 관리, 설정 편집, 시스템 연동
코어
프로토콜 처리, 라우팅 실행, 연결 수립
라이선스
열람, 수정, 재배포에 적용되는 조건

이름이 비슷해도 같은 프로젝트가 아니며, 인터페이스가 비슷해도 설정이 모두 호환되는 것은 아닙니다.

업데이트 방식: 클라이언트, 코어, 규칙은 각각 관리

클라이언트 업데이트는 주로 인터페이스, 설정 관리, 시스템 연동에 영향을 줍니다. 코어 업데이트는 프로토콜 기능과 매개변수 처리에 영향을 줄 수 있고, 규칙 리소스 업데이트는 도메인과 주소 분류에 영향을 줍니다. 구독 업데이트는 서버 설정을 가져오는 별도의 과정입니다. 문제를 해결할 때 각 업데이트를 구분해야 어떤 계층이 바뀌었는지 알 수 있습니다. 구독 목록이 정상적으로 갱신되었다고 해서 로컬 규칙 리소스나 코어 설정도 함께 업데이트된 것은 아닙니다.

업데이트 전에 구독 그룹, 사용자 지정 라우팅, DNS 설정을 백업하고 현재 사용 중인 트래픽 처리 방식을 기록하세요. 업데이트 후에는 기존 설정이 작동하는지 먼저 확인한 다음 새 설정을 시도합니다. 기존 규칙이 더 이상 적용되지 않는다면 클라이언트 인터페이스가 바뀌었는지만 볼 것이 아니라 규칙 리소스, 적용 순서, 아웃바운드 태그를 확인하세요. 다운로드 페이지에서는 설치 파일과 버전 정보를 확인할 수 있고, 홈페이지에서는 플랫폼별 항목을 찾을 수 있습니다. 시작 실패, 연결 시간 초과, 규칙 로드 오류가 발생하면 블로그의 로그 문제 해결 글을 참고해 원인을 좁혀 보세요.

구독, 라우팅, DNS 고급 설정 보기 →
블로그 및 문제 해결

실행 로그부터 클라이언트 선택까지

기본 가이드에서는 첫 연결 방법을, 주제별 글에서는 구체적인 문제 해결 방법을 안내합니다. 문제가 발생하면 운영체제, 클라이언트 이름, 현재 트래픽 처리 방식, 관련 로그 한 줄을 기록한 뒤 문제 유형에 맞는 글을 확인하세요. 로그를 공유하기 전에는 서버 주소, 구독 정보, 접근 인증 정보를 가려야 합니다.

문제 해결

V2Ray 실행 로그 읽는 법: 자주 발생하는 오류와 단계별 확인 방법

로그 수준과 로그 줄의 구조를 설명하고 연결 시간 초과, 인증서 검증 실패, 포트 사용 중, 규칙 파일 누락 등 자주 발생하는 오류를 살펴봅니다. 오류가 발생한 단계를 기준으로 로컬 실행, DNS 해석, 원격 연결 중 어디에 문제가 있는지 판단한 뒤 해당 설정을 확인하세요. 관련 없는 옵션을 반복해서 바꾸지 않아도 문제를 좁힐 수 있습니다.

글 읽기 →
문제 해결

v2rayN 실행 직후 종료되거나 시작 중 충돌할 때: .NET 런타임, 폴더 권한, 설정 파일 점검

자주 발생하는 시작 실패 원인을 발생 빈도에 따라 정리합니다. 런타임 누락, 보호된 압축 해제 폴더, 손상된 설정 파일, Android에서 회수된 권한 등을 다룹니다. 기본 창이 열리지 않는 문제와 코어 시작 실패를 구분한 뒤 설치 환경이나 연결 설정을 확인하세요. 기존 설정을 보관하고 항목별로 점검하면 안전하게 문제를 해결할 수 있습니다.

글 읽기 →
생태계

Project V 생태계 한눈에 보기: V2Fly, Xray 코어, v2rayN/v2rayNG의 관계와 발전 과정

Project V의 시작, V2Fly 커뮤니티의 유지 관리, Xray 계열의 발전 배경을 정리하고 세 그래픽 클라이언트와 코어의 관계를 설명합니다. 프로젝트, 프로토콜, 앱 이름을 구분한 뒤 기기 플랫폼과 기존 설정에 맞춰 선택하세요. 생태계 관계를 설치 순서로 오해하지 않도록 살펴봅니다.

글 읽기 →
전체 글 보기 →

설정 하나만 빠르게 찾고 싶다면 자주 묻는 질문을 확인하세요. 구독 그룹, 라우팅 규칙, DNS 정책을 단계별로 조정하려면 고급 설정 가이드를 이어서 읽어 보세요.