오픈 소스 클라이언트 및 설정 문서

V2Ray 사용 가이드 클라이언트 다운로드 및 설정

클라이언트 선택과 구독 가져오기부터 시작해, 트래픽의 흐름을 따라가며 라우팅과 DNS의 역할을 알아보세요.

Xray V2Fly VMess
01플랫폼 색인

V2Ray 클라이언트 다운로드

먼저 운영체제를 확인한 다음 CPU 아키텍처와 설치 파일 형식을 살펴보세요. 같은 클라이언트도 설치 파일이 여러 종류일 수 있으며, 파일 형식의 차이가 사용 가능한 노드의 차이를 뜻하지는 않습니다.

Windows

처음 설치한다면 v2rayN 데스크톱 버전부터 시작해 보세요. 기존 인터페이스에 익숙하다면 WPF 버전을 선택할 수 있습니다. 두 버전은 주로 UI 구현 방식이 달라 메뉴 이름과 위치가 다를 수 있습니다. 가이드를 볼 때는 먼저 화면을 확인하고 구독, 라우팅, 시스템 프록시 설정에 해당하는 메뉴를 찾으세요.

이전 버전에서 마이그레이션한다면 기존 설정과 구독 정보를 먼저 보관한 뒤 새 클라이언트에서 전에 사용하던 노드 하나를 테스트하세요. 문제가 생겼을 때 인터페이스 변경, 가져오기 오류, 연결 문제를 구분하기 쉽습니다.

다운로드 페이지로 이동 →

macOS

시스템 정보에서 칩 또는 프로세서를 확인하세요. Apple Silicon은 arm64, Intel은 x64를 선택하면 됩니다. 컴퓨터의 외관이나 제품군 이름, 구입 시기만으로 판단하지 마세요. 같은 제품군에도 아키텍처가 다른 모델이 있을 수 있습니다.

앱이 실행된다는 것은 설치가 완료됐다는 뜻일 뿐입니다. 처음 연결할 때는 구독 목록을 새로고침할 수 있는지, 노드를 선택했는지, 테스트할 앱이 현재 시스템 프록시 설정을 사용하는지 각각 확인하세요.

다운로드 페이지로 이동 →

Android

v2rayNG는 Xray 코어를 사용합니다. V2Fly 코어가 필요하다면 v2flyNG를 선택하세요. 기기가 arm64를 지원하는지 확인한 뒤 해당 설치 파일을 고르고, 판단하기 어렵다면 다운로드 페이지의 범용 버전 안내를 확인하세요. 먼저 필요한 설정을 처리할 수 있는 클라이언트를 고른 다음 용량과 설치 형식을 비교하세요.

처음 연결할 때 시스템에서 VPN 연결 권한을 요청할 수 있습니다. 권한을 허용한 뒤 테스트 앱을 열어 트래픽이 클라이언트를 거치는지 확인하세요. 기기에서 다른 VPN 서비스를 사용 중이라면 시스템 VPN 연결을 점유하고 있는지 먼저 살펴보세요.

다운로드 페이지로 이동 →

Linux

데스크톱 환경에서는 v2rayN을 사용할 수 있습니다. 일반적으로 Debian·Ubuntu 계열은 deb, Fedora 계열은 rpm을 선택합니다. 패키지 형식을 확인한 뒤 아키텍처도 확인하세요. 배포판 이름과 CPU 아키텍처는 서로 다른 정보입니다. 설치에 실패하면 패키지 관리자 오류부터 확인해 아키텍처, 의존성, 권한 문제를 구분하세요.

설치가 끝난 뒤에도 앱이 클라이언트에 연결되는지 따로 확인해야 합니다. 데스크톱 환경마다 시스템 프록시 처리 방식이 다르고, 일부 앱은 자체 네트워크 설정을 사용합니다. 브라우저는 정상인데 다른 앱이 연결되지 않는다면 해당 앱의 프록시 설정을 확인하세요.

다운로드 페이지로 이동 →
전체 클라이언트 보기 →
02설정 색인

라우팅, DNS 및 구독 관리

클라이언트가 노드 설정을 가져오고 앱의 트래픽이 들어와야 코어가 목적지를 분석해 규칙에 따라 아웃바운드를 선택합니다. 문제를 해결할 때는 이 흐름을 따라가며 이상이 처음 발생하는 지점을 찾으세요.

노드 목록이 보인다면 설정을 가져온 것입니다. 노드에 연결된다면 해당 노드는 현재 조건에서 사용할 수 있습니다. 대상 앱에 접속할 수 있으려면 앱의 트래픽이 실제로 클라이언트에 들어오고 원하는 규칙과 일치해야 합니다. 이 세 가지 결과는 서로 대신할 수 없습니다.

처음 설정할 때는 노드 하나와 앱 하나로 반복 가능한 테스트를 먼저 구성하세요. 연결 모드, 대상 주소, 테스트 결과를 기록한 다음 라우팅 규칙을 추가하거나 DNS를 조정하세요. 기록을 남겨 두면 나중에 문제가 새 설정 때문인지 네트워크 환경 변화 때문인지 판단하기 쉽습니다.

라우팅 규칙은 같은 기기에서 대상별로 서로 다른 경로를 사용해야 할 때 설정합니다. 시스템 프록시는 어떤 앱의 요청을 클라이언트로 보낼지 결정하고, 라우팅은 코어에 들어온 트래픽을 어디로 보낼지 결정합니다. 규칙을 편집할 때는 매칭 조건과 대상 아웃바운드를 명확히 정하고, 범위가 좁은 예외 규칙을 이를 덮어쓸 수 있는 일반 규칙보다 앞에 배치하세요. 테스트할 때는 규칙에 매칭되어야 하는 대상과 매칭되지 않아야 하는 대상을 하나씩 고른 뒤, 클라이언트에서 확인할 수 있는 연결 로그로 실제 아웃바운드를 살펴보세요. 규칙은 적용됐지만 결과가 예상과 다르다면 노드보다 규칙 순서를 먼저 확인하세요.

코어
Xray / V2Fly
플랫폼
데스크톱 / 모바일
사용 사례
대상 주소에 따라 아웃바운드 선택
가이드 보기 →
03오픈 소스 생태계

Project V, V2Fly 및 Xray

프로젝트, 코어, 그래픽 클라이언트의 이름을 구분하면 같은 가이드를 모든 앱에 그대로 적용할 수 없는 이유를 이해하고 문제 해결 범위를 좁힐 수 있습니다.

인터페이스 계층
구독, 노드 목록, 설정 관리
코어 계층
인바운드, 라우팅, 아웃바운드
시스템 계층
앱 연결, 네트워크 권한

Project V의 인바운드 및 아웃바운드 모델

Project V는 관련 프록시 도구를 아우르는 프로젝트 체계이며, V2Ray는 연결을 처리하는 핵심 구성 요소입니다. 이후 V2Fly 커뮤니티가 V2Ray 개발을 이어 갔고, Xray는 같은 코드 계열에서 갈라져 독자적으로 발전했습니다. 두 프로젝트는 몇 가지 기본 개념을 공유합니다. 인바운드는 트래픽을 받고, 라우팅은 경로를 정하며, 아웃바운드는 연결을 다음 단계로 전달하거나 설정에 따라 차단합니다. 첫 화면에 표시된 네 가지 아웃바운드 이름은 예시일 뿐이며, 실제 이름과 동작은 설정에 따라 달라집니다.

브라우저를 예로 들면 로컬 프록시 설정을 사용할 때만 요청이 해당 인바운드에 도달합니다. 그러면 코어가 확인할 수 있는 목적지 정보를 바탕으로 규칙을 적용합니다. 브라우저가 프록시를 우회한다면 코어가 실행 중이어도 트래픽을 분기하지 않습니다. 이 경계를 이해하는 것이 특정 버전의 버튼 위치를 외우는 것보다 중요합니다. 설정 화면은 바뀌어도 트래픽이 먼저 코어에 들어와야 한다는 점은 변하지 않습니다.

코어 분기와 설정 호환성

V2Fly와 Xray는 각각 프로토콜 구현과 설정 기능을 관리합니다. 두 프로젝트의 문서에 인바운드, 아웃바운드 같은 필드가 모두 나오더라도 이름이 같다고 모든 옵션을 서로 바꿔 쓸 수 있는 것은 아닙니다. VMess, VLESS 같은 이름은 프로토콜의 일부를 나타냅니다. 연결에는 전송 방식과 보안 설정, 양쪽의 구현도 영향을 줍니다. 클라이언트가 충족해야 할 조건은 서버 설정에 따라 달라지므로 노드 메모에 적힌 지역이나 회선 이름만으로 판단할 수 없습니다.

마이그레이션할 때는 기존 환경을 보존하고, 사용 가능한 것으로 확인된 설정 하나를 새 환경에 따로 가져오세요. 인터페이스에서 노드는 인식하지만 코어가 시작되지 않는다면 먼저 시작 오류를 확인하세요. 코어가 시작된 뒤 해당 노드만 연결되지 않는다면 노드 매개변수와 네트워크 연결 상태를 살펴보세요. 이런 순서로 확인하면 전송 매개변수 불일치를 구독 만료로 오해하거나 처음부터 전체 라우팅 규칙을 수정하는 일을 막을 수 있습니다.

v2rayN, v2rayNG 및 v2flyNG의 오픈 소스 여부

세 클라이언트 모두 소스 코드를 공개하고 있습니다. v2rayN은 데스크톱용으로 구독, 노드, 라우팅 설정을 관리하는 인터페이스를 제공합니다. v2rayNG는 Xray를 코어로 사용하고, v2flyNG는 V2Fly 코어를 사용하는 모바일 클라이언트입니다. 클라이언트와 코어는 서로 다른 계층의 프로젝트입니다. 구독 목록 표시 방식, 메뉴 배치, 시스템 권한 요청 절차만으로 코어가 같은 분기에 속하는지 판단할 수는 없습니다.

오픈 소스 라이선스는 코드의 사용, 수정, 재배포 조건을 정할 뿐 제3자 구독 서비스의 신뢰성까지 보장하지 않습니다. 클라이언트를 무료로 사용하는 것과 유료 회선을 구매하는 것은 별개입니다. 설정에 구독 주소나 노드 인증 정보가 포함되어 있다면 파일 전체를 공개 게시판에 올리지 마세요. 문제를 신고할 때는 운영체제, 클라이언트와 코어 이름, 오류가 발생한 단계, 민감한 필드를 제거한 오류 요약만으로 충분한 경우가 많습니다.

클라이언트 업데이트, 코어 업데이트, 구독 새로고침

클라이언트를 업데이트하면 인터페이스나 시스템 연결 방식이 달라질 수 있고, 코어 업데이트는 새 기능 지원 범위나 설정 파싱 방식에 영향을 줄 수 있습니다. 구독을 새로고침하면 노드 목록을 다시 가져옵니다. 설치 파일에 코어가 함께 포함되는 경우 한 번의 업그레이드로 앞의 두 계층이 모두 바뀔 수 있지만, 구독 새로고침으로 앱이 업데이트되거나 로컬 라우팅 오류가 자동으로 해결되지는 않습니다. 업데이트 후 문제가 생겼다면 먼저 실제로 무엇이 바뀌었는지 확인하세요.

기존 설정을 보관한 뒤 같은 네트워크, 같은 노드, 같은 테스트 대상으로 업데이트 전후를 비교하세요. 먼저 앱이 실행되는지 확인하고, 다음으로 노드가 여전히 작동하는지 살펴본 다음 기존 규칙이 제대로 매칭되는지 확인하세요. 규칙 결과만 바뀌었다면 도메인이나 IP 데이터가 업데이트와 함께 변경됐는지도 살펴보세요. 작업을 하나씩 나누면 되돌릴 지점이 명확해지고, 유지관리 담당자에게 재현에 유용한 정보를 전달할 수 있습니다.

연결 테스트와 문제 단계별 확인

처음에는 구독 가져오기 가이드에 따라 정상 작동 상태를 만든 다음 복잡한 규칙을 추가하세요. 목록이 갱신되지 않는다면 구독 출처와 가져오기 과정을 확인하세요. 목록은 정상인데 모든 노드 연결에 실패한다면 현재 네트워크, 연결 모드, 코어 실행 상태를 먼저 점검하세요. 특정 앱만 연결되지 않는다면 시스템 프록시 사용 여부, 앱 자체 DNS 설정, 대상에 적용된 규칙을 확인하세요.

연결 품질을 비교할 때 한 번 측정한 지연 시간만으로 실제 사용 경험을 판단하지 마세요. 짧은 웹 요청은 응답 시간에, 파일 전송은 지속적인 전송 속도에 더 크게 영향을 받으며 두 결과에는 서로 다른 요소가 작용합니다. 같은 네트워크와 테스트 대상을 사용해 반복해서 비교하고 네트워크 전환, 노드 변경, 설정 변경을 각각 기록하세요. 설정을 되돌린 뒤에도 요청이 불안정하다면 로컬 규칙을 계속 추가하기보다 노드와 회선을 다시 확인하세요.

04주제별 가이드

배포, 노드 선택 및 라우팅 실무

단일 기기 연결부터 LAN 배포까지, 세 글에서 연결 범위와 노드 선택, 규칙 우선순위를 각각 다룹니다. 필요한 내용을 골라 읽어 보세요.

/ 배포 실무

라우터와 바이패스 라우터에서 Xray 코어 실행하기: 배포 방식과 장단점

메인 라우터와 바이패스 라우터에서 Xray 코어를 직접 실행하는 방법을 살펴보고 성능 요구 사항, 투명 프록시 적용, 유지관리 비용을 비교해 배포가 적합한지 판단할 수 있도록 돕습니다.

전용 설정이 필요한 컴퓨터가 한 대뿐이라면 단일 기기 배포가 테스트와 복구에 더 간편합니다. 게이트웨이에 설정을 적용하기 전에는 영향을 받을 기기, 장애 발생 시 네트워크를 복구할 담당자, LAN 서비스 간 통신을 확인할 방법을 먼저 정하세요. 배포의 어려움은 대개 코어를 실행하는 것보다 트래픽을 가로채는 범위를 예상대로 맞추는 데 있습니다.

/ 입문 가이드

노드 선택 방법: 지연 시간, 트래픽 배율, 지역, 프로토콜 비교

구독에 노드가 수십 개 있을 때 지연 시간 테스트와 트래픽 배율, 지역별 용도부터 VMess, VLESS, Trojan 프로토콜의 차이까지 초보자를 위한 선택 기준을 안내합니다.

먼저 사용 목적에 맞지 않는 지역이나 요금 방식을 제외한 뒤 같은 네트워크 환경에서 후보 노드를 비교하세요. 한 번의 속도 테스트 순위보다 응답 속도와 안정성을 종합적으로 살펴보세요.

/ 라우팅

사용자 지정 라우팅 규칙 작성법: domain, ip, geosite 문법과 매칭 우선순위

domain, full, regexp, ip, geosite, geoip 문법을 하나씩 살펴보고 규칙이 위에서 아래로 매칭되는 순서와 자주 발생하는 충돌의 해결 방법을 설명합니다.

규칙 하나만 수정한 다음 직접 연결되어야 하는 대상과 프록시를 사용해야 하는 대상을 함께 확인하면 규칙의 매칭 범위가 예상보다 넓은지 빠르게 파악할 수 있습니다.

전체 글 보기 →