// INSTALLER INDEX · 한국어 문서

V2Ray 설치 파일 다운로드
v2rayN 및 Android 클라이언트

v2rayN 다운로드 가이드 보기

v2ray5.com을 입력하면 Windows·macOS·Android·Linux용 클라이언트를 찾을 수 있으며, 구독 가져오기, 프록시 모드 및 라우팅 분할에 관한 한국어 사용 설명도 이어서 확인할 수 있습니다.

완전 무료 오픈 소스 한국어 문서 Xray · V2Fly
PLATFORMS / 04 CLIENTS / v2rayN · v2rayNG · v2flyNG CORES / Xray · V2Fly MODEL / OPEN SOURCE

// CLIENT CAPABILITIES

클라이언트 핵심 설정

구독을 클라이언트로 가져오는 단계부터 시스템 프록시, 라우팅 분할, 실행 로그까지 일상적으로 가장 많이 사용하는 네 가지 설정 패널을 정리했습니다. 설정을 따로 떨어진 용어로 나열하지 않고, 각 항목이 어떤 문제를 해결하는지, 언제 조정해야 하는지, 변경 후 어떤 결과를 확인해야 하는지 설명합니다.

select feature → read field note

대상에 따라 연결 출구를 결정합니다

라우팅 분할은 서로 다른 도메인, IP 대역 또는 규칙 모음을 각각 다른 출구로 처리할 때 사용합니다. 일반적으로 클라이언트의 기본 규칙은 유지하고 필요한 사용자 규칙만 추가하며, 더 구체적인 규칙을 포괄적인 규칙보다 앞에 배치합니다. v2rayN의 라우팅 설정에서는 domain, ip, geosite 등의 매칭 방식을 조합할 수 있습니다. 수정할 때는 한 번에 한 그룹의 규칙만 변경하고, 저장 후 실행 로그에서 의도한 출구가 선택되었는지 확인하세요. 전체 트래픽 전달보다 분할 라우팅이 장기간 사용에 적합한 이유는 로컬 서비스, LAN 주소, 지정 사이트가 기존 연결 경로를 유지할 수 있기 때문입니다.

routing.rules[].domain · routing.rules[].ip

// PLATFORM ENTRY

운영체제에 맞는 설치 파일 선택

데스크톱에서는 v2rayN을 기본으로 선택하고, Android에서는 코어 선호도에 따라 v2rayNG 또는 v2flyNG를 선택하세요. 플랫폼 링크를 클릭하면 다운로드 페이지로 이동하며 해당 그룹이 자동으로 선택됩니다. 파일 형식, 아키텍처 차이, 시스템 요구 사항은 각 그룹에서 안내합니다.

모든 클라이언트 보기 →

01 / DESKTOP

Windows

v2rayN 사용. 다운로드 페이지에서는 차세대 데스크톱 인터페이스와 클래식 WPF 인터페이스라는 두 가지 경로를 제공합니다. 그래픽 화면에서 구독, 서버, 시스템 프록시, 라우팅 규칙을 관리하려는 사용자에게 적합합니다. 처음 설치하기 전에 시스템 아키텍처를 확인하고 설정 폴더를 안정적인 위치에 보관하세요. 폴더를 옮긴 뒤 기존 설정을 찾지 못하는 일을 예방할 수 있습니다.

다운로드 페이지로 이동

02 / DESKTOP

macOS

v2rayN 데스크톱 클라이언트를 사용하세요. 설치 파일은 Apple Silicon과 Intel 칩용으로 나뉘므로 선택하기 전에 시스템 정보에서 프로세서 유형을 확인할 수 있습니다. 설치가 끝나면 시스템 안내에 따라 필요한 네트워크 관련 권한을 부여하세요. 처음 실행이 차단되면 설치 파일을 반복해서 다시 받기보다 시스템 설정의 보안 영역에서 앱을 확인해야 합니다.

다운로드 페이지로 이동

03 / MOBILE

Android

Xray 코어를 사용하는 v2rayNG를 우선 선택하세요. V2Fly 코어가 필요하다면 v2flyNG를 사용할 수 있습니다. 최근 출시된 대부분의 기기는 arm64 설치 파일에 적합하며, 프로세서 아키텍처를 모르겠다면 범용 버전을 선택하세요. 구독을 가져온 뒤에는 서버 목록을 직접 업데이트하고 항목 하나를 선택한 다음 시스템의 네트워크 연결 권한이 적용되었는지 확인해야 합니다.

다운로드 페이지로 이동

04 / DESKTOP

Linux

v2rayN을 사용하고 배포판의 패키지 체계에 맞춰 deb 또는 rpm을 선택하세요. ARM 아키텍처 기기라면 arm64도 맞게 선택해야 합니다. 설치 후에는 터미널이나 앱 메뉴에서 클라이언트가 정상적으로 시작되는지 먼저 확인한 뒤 구독을 가져오세요. 창은 열리지만 코어가 실행되지 않는다면 실행 권한, 포트 충돌, 로그 경로를 우선 확인해야 합니다.

다운로드 페이지로 이동

// QUICK START

설치부터 활성화까지 세 단계

처음 사용할 때는 클라이언트 설치, 구독 가져오기, 프록시 활성화를 나누어 진행하세요. 각 단계가 끝날 때 결과를 먼저 확인한 후 다음 단계로 넘어가면 여러 설정이 동시에 바뀌어 원인을 찾기 어려워지는 일을 피할 수 있습니다.

전체 가이드 보기 →
  1. 01

    클라이언트 선택 및 설치 완료

    데스크톱 플랫폼은 v2rayN, Android는 v2rayNG부터 시작하세요. 다운로드할 때는 운영체제, 프로세서 아키텍처, 설치 파일 형식을 먼저 확인하고 파일명의 특정 부분 하나만 보고 판단하지 마세요. 설치가 끝나면 클라이언트를 한 번 실행해 메인 창, 설정 메뉴, 로그 영역이 열리는지 확인합니다. 데스크톱에서는 설정 폴더를 장기간 유지할 위치에 두는 것이 좋습니다. 모바일에서는 로컬 연결 인터페이스를 만들 수 있도록 시스템이 요구하는 네트워크 연결 권한을 허용해야 합니다.

    프로그램이 정상적으로 시작되지 않았다면 아직 구독을 가져오지 않은 상태이므로 점검 범위는 대개 시스템 호환성, 파일 권한, 실행 환경으로 좁혀집니다. 먼저 시작 문제를 해결한 뒤 설정을 진행하세요. 처음부터 라우팅, DNS, TUN을 수정하는 것보다 원인을 명확히 파악하기 쉽습니다.

  2. 02

    구독 추가 및 서버 목록 업데이트

    구독 관리 영역에서 새 그룹을 만들고 전체 링크를 붙여넣어 저장한 다음 수동 업데이트를 한 번 실행하세요. 구독 추가와 구독 업데이트는 별개의 작업입니다. 링크만 저장했다고 서버 항목이 목록에 나타나는 것은 아닙니다. 업데이트가 끝나면 그룹 이름, 항목 수, 업데이트 시간이 예상과 맞는지 확인하고 서버 하나를 활성 항목으로 선택하세요.

    목록이 비어 있다면 링크를 다시 복사하고 앞뒤에 공백이 붙지 않았는지 확인한 다음 로그에서 읽기 또는 파싱 오류를 살펴보세요. 여러 구독은 각각 이름을 지정해야 나중에 어느 그룹에서 온 항목인지 판단하기 쉽습니다. 정기 업데이트로 서버 측 변경 사항을 동기화할 수 있지만, 클라이언트를 실행할 때마다 그룹을 삭제하고 다시 만들 필요는 없습니다.

  3. 03

    프록시 활성화 및 실제 경로 확인

    데스크톱에서는 먼저 시스템 프록시를 활성화하고, Android에서는 서버를 선택한 후 연결을 시작할 수 있습니다. 화면에 실행 중이라고 표시되는 것을 모든 프로그램이 해당 연결을 사용한다는 뜻으로 받아들여서는 안 됩니다. 앱의 시스템 프록시 준수 여부, 라우팅 규칙 매칭 여부, DNS 작동 방식이 최종 결과에 영향을 줍니다. 확인할 때는 먼저 일반적인 네트워크 요청으로 기본 연결을 확인한 뒤 분할 라우팅이 필요한 도메인과 앱을 단계적으로 테스트하세요.

    기본 연결이 안정된 후 LAN 우회, 규칙 모드, TUN을 필요에 따라 조정하세요. 한 번에 한 항목만 변경하고 변경 전 작동하던 설정을 보존해야 합니다. 연결이 끊기면 여러 서버와 모드를 계속 전환하기보다 최근 변경 후의 시작 및 라우팅 기록을 로그에서 확인하세요.

// OPEN SOURCE ECOSYSTEM

Project V·V2Fly·Xray의 관계

V2Ray는 일반적으로 특정 그래픽 프로그램 하나가 아니라 개방형 네트워크 프록시 기술 생태계 전체를 가리키는 말로 사용됩니다. 초기 Project V는 설정 구조, 프로토콜 구현, 모듈식 처리 방식을 마련했고, 이후 커뮤니티는 서로 다른 유지보수 방향에 따라 V2Fly와 Xray 같은 코어 계열을 발전시켰습니다. 그래픽 클라이언트는 구독, 서버 목록, 시스템 프록시, 라우팅 규칙, 로그 메뉴를 조작 가능한 화면으로 구성합니다. 실제 연결, 전송, 라우팅, DNS 처리는 선택한 코어가 담당합니다.

클라이언트 화면과 코어의 경계를 이해하면 문제를 더 쉽게 진단할 수 있습니다. 화면이 실행되지 않으면 운영체제 호환성과 프로그램 권한을 먼저 확인하세요. 화면은 정상인데 코어 시작에 실패한다면 포트, 설정 생성, 실행 로그를 살펴봐야 합니다. 코어는 정상인데 특정 요청의 경로가 예상과 다르면 DNS, 라우팅 규칙, 적용 범위를 추가로 확인해야 합니다. 모든 현상을 클라이언트 문제로만 보면 실제 오류가 발생한 계층을 놓치기 쉽습니다.

ECOSYSTEM Project V 기술 생태계

프로토콜, 전송, 라우팅, 설정 모델을 개방적으로 구현하는 기술 체계입니다.

V2Fly 코어 계열

V2Ray 체계를 잇는 커뮤니티 유지보수 방향으로, v2flyNG 같은 그래픽 클라이언트에서 호출할 수 있습니다.

Xray 코어 계열

일반적인 설정 개념과의 호환성을 유지하면서 독자적인 기능을 발전시킨 계열로, v2rayN과 v2rayNG에서 흔히 사용합니다.

01 / CLIENT

v2rayN: 데스크톱 그래픽 관리 계층

v2rayN은 Windows, macOS, Linux에서 구독 그룹, 서버 항목, 시스템 프록시, 라우팅 규칙, DNS, TUN, 코어 실행 상태를 통합 관리합니다. 핵심 가치는 구조화된 설정을 반복해서 사용할 수 있는 화면 흐름으로 바꾸고 로그와 고급 매개변수 메뉴를 제공하는 데 있습니다. 일반 데스크톱 사용자는 구독 업데이트, 활성 서버 선택, 시스템 프록시라는 세 가지 작업부터 익히면 안정적인 기본 사용 환경을 만들 수 있습니다. 세밀한 분할 라우팅이 필요할 때 라우팅 및 고급 설정으로 이동하세요.

02 / CLIENT

v2rayNG: Android 및 Xray 계열

v2rayNG는 Android에서 널리 사용되는 그래픽 클라이언트로, 보통 Xray 코어와 함께 실행됩니다. 구독, 공유 링크, 개별 설정, 라우팅 규칙, 로컬 연결 제어를 모바일 화면에서 관리할 수 있습니다. 모바일 운영체제는 백그라운드 실행, 배터리 정책, 네트워크 연결 권한을 추가로 관리하므로 데스크톱에서 작동하는 동일한 서버 설정이 모바일에서 다르게 보일 수 있습니다. 이것이 반드시 프로토콜 매개변수 변경을 의미하는 것은 아니며, 시스템이 백그라운드 프로세스나 네트워크 적용을 제한하는지도 확인해야 합니다.

03 / CLIENT

v2flyNG: V2Fly 코어 대안

v2flyNG 역시 Android용 클라이언트이지만 V2Fly 코어 계열을 사용합니다. V2Fly 설정 방식을 유지해야 하거나 같은 플랫폼에서 서로 다른 코어의 동작을 비교하려는 사용자에게 적합합니다. 클라이언트를 선택할 때는 이름의 유사성보다 코어 계열, 지원하는 설정 범위, 현재 구독과의 호환성을 확인해야 합니다. 일반 사용자는 먼저 v2rayNG를 사용하고, V2Fly가 명확히 필요한 경우 v2flyNG를 선택하는 편이 좋습니다. 차이를 모르는 상태에서 설정을 반복적으로 옮기는 일을 피할 수 있습니다.

오픈 소스 라이선스와 검토 가능한 구현

세 클라이언트와 관련 코어는 모두 오픈 소스 생태계에 속합니다. 개방형 구현은 설정 생성, 프로토콜 처리, 기능 변경을 커뮤니티가 논의하고 검토할 수 있게 하며, 서로 다른 클라이언트가 같은 기본 개념을 각자의 화면으로 제공할 수 있게 합니다. 사용자에게 더 중요한 판단 기준은 화면 디자인이나 이름이 아니라 프로젝트 유지보수 상태, 문서 완성도, 시스템 호환 범위, 변경 기록입니다.

업데이트 방식과 설정 이전

클라이언트 업데이트에는 화면, 코어, 규칙 데이터, 기본 설정의 변경이 포함될 수 있습니다. 업데이트 전에는 현재 클라이언트 종류와 설정 폴더 위치를 기억해 두고, 업데이트 후 구독 그룹, 활성 서버, 프록시 모드가 그대로 있는지 먼저 확인한 다음 새 옵션을 살펴보세요. 클라이언트 간 이전에서는 전체 설정 폴더를 수동으로 복사하기보다 구독 링크를 사용하는 편이 안전한 경우가 많습니다. 사용자 지정 라우팅 및 DNS 규칙은 별도로 기록해야 합니다. 클라이언트마다 화면의 필드가 완전히 대응하지 않을 수 있기 때문입니다.

코어 변화와 일상적인 유지 관리

코어 기능은 유지보수 방향에 따라 발전하며 클라이언트도 표시하는 설정 항목을 조정합니다. 일상적인 사용에서 새 매개변수를 모두 따라갈 필요는 없습니다. 안정적인 설정은 ‘시작 가능, 구독 업데이트 가능, 요청 경로가 규칙에 맞음, 로그에 지속적인 오류가 없음’을 기본 기준으로 삼으면 됩니다. 업그레이드 후 동작이 달라졌다면 먼저 변경 사항을 읽고, 업그레이드 전후의 라우팅, DNS, TUN 설정을 비교하세요. 바로 재설치하는 것보다 차이를 찾기 쉽습니다.

// COMMON QUESTIONS

자주 묻는 질문

아래 네 가지 항목은 최초 설치 후 가장 자주 확인하는 내용을 다룹니다. 구독, 프록시 모드, 서버 속도 측정, 문제 해결에 관한 자세한 설명은 문제 해결 페이지에서 확인할 수 있습니다.

문제 해결 보기 →
v2rayN·v2rayNG·v2flyNG는 어떻게 선택해야 하나요?

Windows·macOS·Linux 데스크톱에서는 v2rayN을 우선 선택하세요. Android 사용자는 일반적으로 Xray 코어를 사용하는 v2rayNG를 먼저 선택하고, V2Fly 코어가 명확히 필요할 때 v2flyNG를 사용합니다. 운영체제, 코어 계열, 기존 설정의 출처를 기준으로 선택해야 하며, 세 이름을 같은 프로그램의 서로 다른 설치 파일로 보면 안 됩니다.

구독을 추가했는데 서버 목록이 비어 있는 이유는 무엇인가요?

링크를 추가한 후에는 구독 업데이트를 실행해야 합니다. 업데이트 후에도 비어 있다면 링크가 완전한지, 그룹이 활성화되어 있는지, 네트워크 요청이 성공했는지 확인하고 로그에서 읽기 또는 파싱 오류를 찾으세요. 로그를 확인하기 전에 같은 그룹을 여러 개 만들면 이후 정리와 원인 파악이 더 어려워집니다.

시스템 프록시와 TUN의 차이는 무엇인가요?

시스템 프록시는 운영체제의 프록시 설정을 직접 읽는 앱에 주로 적용되며 설정이 간단해 데스크톱의 시작점으로 적합합니다. TUN은 적용 범위가 더 넓지만 라우팅, DNS, 권한, 가상 네트워크 인터페이스라는 변수가 추가됩니다. 먼저 시스템 프록시를 안정적으로 작동시킨 후, 특정 앱이 프록시를 우회하는지에 따라 TUN 활성화 여부를 결정하세요.

클라이언트에는 실행 중으로 표시되는데 실제 요청이 규칙대로 처리되지 않는 이유는 무엇인가요?

실행 중이라는 표시는 클라이언트 또는 코어 프로세스가 시작되었다는 뜻일 뿐입니다. 활성 서버, 시스템 프록시 상태, 앱 적용 범위, DNS, 라우팅 규칙도 확인해야 합니다. 먼저 로그에서 요청이 코어로 들어갔는지 확인한 다음 어떤 규칙과 출구가 매칭되었는지 살펴보세요. 로그에 해당 요청이 없다면 문제는 대개 앱의 프록시 설정이나 시스템 적용 단계에 있습니다.

// LATEST NOTES

클라이언트 및 라우팅 노트

최근 글에서는 클라이언트 비교, 라우팅 규칙 우선순위, v2rayN 화면 구성을 다룹니다. 각 글은 하나의 구체적인 문제에 집중하므로 설치 과정에서 구독 관리와 고급 설정으로 자연스럽게 이어서 확인할 수 있습니다.

전체 글 보기 →
2026-08-12 클라이언트 비교

v2rayN·v2rayNG·v2flyNG 선택 가이드: 세 클라이언트 기능 및 플랫폼 비교

실행 플랫폼, 코어 계열, 구독 관리, 라우팅 기능의 네 가지 기준으로 세 클라이언트를 비교하고 데스크톱 및 Android의 기본 선택을 제시합니다. 어떤 경우에 v2flyNG로 바꾸면 좋은지도 설명합니다.

전체 글 읽기 →
2026-07-27 고급 활용

V2Ray 사용자 지정 라우팅 규칙 작성법: domain·ip·geosite 매칭 및 우선순위

domain·ip·geosite 세 가지 매칭 문법을 정리하고, 위에서 아래로 적용되는 규칙 순서와 구체적인 규칙 및 포괄적인 규칙의 배치 방법을 설명합니다.

전체 글 읽기 →
2026-07-08 시작하기

v2rayN 화면 기능 한눈에 보기: 서버 목록·구독 그룹·로그 및 설정

메인 창의 영역별로 서버 목록, 구독 그룹, 로그 패널, 자주 쓰는 설정 메뉴를 소개해 v2rayN을 처음 실행한 사용자가 전체 화면 구성을 파악할 수 있도록 안내합니다.

전체 글 읽기 →