오픈 소스 클라이언트 · 설정 가이드

V2Ray 공식 최신판클라이언트 다운로드 및 설정

v2rayN 다운로드 가이드 보기

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 사용하세요. 단계에 따라 구독·라우팅·DNS를 설정한 뒤 앱 트래픽이 프록시를 통과하는지 확인하세요.

  • Xray 코어
  • V2Fly 코어
  • VLESS · VMess · Trojan

기기에 맞는 클라이언트 선택

프로젝트 배경 Project V프록시 코어와 그래픽 클라이언트의 역할 프로토콜 용어 VLESS · VMess프로토콜·전송 방식·암호화는 각각 설정 설정 참고 구독 및 트래픽 분기그룹 관리부터 사용자 지정 아웃바운드까지

PROJECT V / V2FLY / XRAY

V2Ray 생태계와 코어 계열

먼저 코어와 클라이언트를 구분하세요. 코어는 프로토콜·연결·라우팅을 처리하고, 그래픽 클라이언트는 구독·설정·프로세스를 관리합니다. 이름이 비슷한 클라이언트라도 코어 기능과 설정 항목이 모두 같은 것은 아닙니다.

Project V

Project V는 V2Ray의 기술적 배경을 이해하는 출발점입니다. V2Ray는 인바운드, 아웃바운드, 라우팅, 전송 방식을 조합 가능한 설정 모듈로 나눕니다. 로컬 리스너 하나가 앱의 요청을 받은 뒤 규칙에 따라 서로 다른 아웃바운드로 전달할 수 있습니다. 이런 모듈식 구조 때문에 클라이언트에서 시스템 프록시, 서버, 라우팅을 각각 설정하며, 단순한 연결 스위치 하나만 제공하지 않습니다.

프로젝트 소개 보기 →

V2Fly

V2Fly는 V2Ray를 지속적으로 관리하는 커뮤니티 프로젝트로, 코어 구현에도 모듈식 설정 방식이 이어집니다. v2flyNG는 이 코어 계열을 Android에서 사용할 수 있는 대안입니다. 기존 설정이 특정 기능에 의존한다면 사용할 클라이언트를 정하기 전에 프로토콜, 전송 방식, 지원하는 설정 항목을 확인하세요. 같은 구독을 가져올 수 있다고 해서 현재 코어에서 모든 항목을 사용할 수 있는 것은 아닙니다.

코어와 클라이언트 구분하기 →

Xray

Xray는 V2Ray 기술 체계에서 발전했으며 프로토콜과 전송 방식 구현을 독자적으로 관리합니다. v2rayNG는 Xray 코어를 사용하고, v2rayN도 Xray 설정을 관리하는 데 자주 쓰입니다. VLESS, Trojan, REALITY는 서로 다른 설정 계층의 개념이므로 서로 바꿔 쓸 수 없습니다. 실제 사용 가능 여부는 서버 요구 사항, 클라이언트 설정 항목, 코어 기능이 모두 맞는지 확인해야 합니다.

고급 설정 보기 →

세 클라이언트의 오픈 소스 역할

v2rayN은 데스크톱용으로 서버 목록, 구독 그룹, 시스템 프록시, 라우팅을 한 화면에서 관리합니다. v2rayNG는 Android용으로 시스템 VPN 인터페이스를 통해 앱 트래픽을 처리하며 앱별 프록시 등의 설정을 제공합니다. v2flyNG 역시 Android용이며 V2Fly 코어가 필요한 설정에 적합합니다. 세 제품 모두 오픈 소스 프로젝트를 기반으로 하며 클라이언트 자체는 무료로 사용할 수 있습니다. 서버 주소와 구독 정보는 별도로 준비해야 하며, 설치만으로 연결 가능한 서비스가 만들어지지는 않습니다.

오픈 소스 라이선스와 업데이트 범위

오픈 소스 라이선스에는 코드의 사용·수정·배포 조건이 규정되어 있으므로 각 구성 요소의 라이선스를 따로 확인해야 합니다. 그래픽 인터페이스, 프록시 코어, 라우팅 데이터는 각각 업데이트될 수 있습니다. 따라서 클라이언트 업데이트, 구독 업데이트, 규칙 데이터 업데이트는 서로 다른 작업입니다. 업그레이드 전에 구독 그룹, 사용자 지정 라우팅, DNS 설정을 백업하세요. 업그레이드 후에는 기존 설정으로 먼저 확인한 다음 새 기능을 하나씩 활성화하세요. 오류가 발생하면 오류 위치와 관련 설정을 기록하는 편이 반복 설치보다 문제 범위를 좁히기 쉽습니다.

이 사이트에서는 클라이언트 선택, 설치, 설정에 관한 안내를 제공합니다. 프로젝트 이름은 기술적 관계를 설명하기 위한 것이며, 사이트 브랜드가 Project V, V2Fly, Xray 프로젝트의 공식 관리 주체임을 뜻하지 않습니다. 화면 예시는 설정 구조를 보여 주며, 실제 메뉴 이름은 설치한 클라이언트에 따라 다를 수 있습니다.

4개 플랫폼 클라이언트 다운로드

먼저 기기의 운영체제와 프로세서 아키텍처를 확인한 뒤 설치 파일을 선택하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 확인하고, V2Fly 코어가 필요하다면 v2flyNG를 고려하세요. 다운로드 페이지에서 설치 경로, 지원 조건, 설치 전 확인 사항을 한눈에 볼 수 있습니다.

Windows

v2rayN을 사용하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, WPF 버전은 클래식 데스크톱 인터페이스를 유지합니다. 먼저 시스템의 ‘정보’ 페이지에서 아키텍처를 확인한 뒤 다운로드 페이지 안내에 따라 선택하세요. 두 인터페이스는 서버 구성이 별개라는 뜻이 아니므로, 이전하기 전에 설정을 백업하세요.

다운로드 페이지로 이동

macOS

v2rayN을 사용하세요. ‘이 Mac에 관하여’에서 칩 이름을 확인하고 Apple Silicon 또는 Intel에 맞는 설치 파일을 선택하세요. 처음 실행할 때 시스템 안내에 따라 권한을 허용한 다음 네트워크 프록시 설정을 확인하세요. 다른 프록시 도구가 현재 설정을 덮어쓰지 않도록 주의하세요.

다운로드 페이지로 이동

Android

v2rayNG를 우선 선택하고, v2flyNG는 다른 코어가 필요할 때 고려하세요. 대부분의 기기에서는 arm64를 선택하면 됩니다. 아키텍처를 모르겠다면 범용 패키지 안내를 확인하세요. 처음 연결할 때 시스템 VPN 요청을 허용해야 합니다. 앱별 프록시를 켜기 전에 기본 연결이 정상인지 확인하세요.

다운로드 페이지로 이동

Linux

v2rayN을 사용하세요. Debian·Ubuntu 계열은 deb, Fedora 등은 rpm을 선택하고 x64 또는 arm64 아키텍처도 확인하세요. 그래픽 데스크톱의 시스템 프록시와 터미널 환경 변수는 각각 따로 적용됩니다. 설치 후에는 실제로 사용할 앱에서 동작을 확인하세요.

다운로드 페이지로 이동

설치가 끝나면 기존 구독이나 서버 설정을 가져온 뒤 사용할 수 있는 항목을 선택하세요. 구독은 설정을 업데이트하는 경로이며 클라이언트는 내용을 읽고 관리하는 역할을 합니다. 구독 주소는 민감한 정보이므로 공개 스크린샷에 노출하거나 관계없는 사람과 공유하지 마세요. 설정을 복구할 때는 구독 내용과 클라이언트 매개변수 중 무엇을 복원할지 먼저 판단해야 합니다. 두 항목의 복구 방법은 서로 다릅니다.

처음 사용할 때는 시스템 프록시 또는 기본 VPN 모드부터 시작하는 것이 좋습니다. 브라우저와 자주 쓰는 앱에서 연결을 확인한 뒤 트래픽 분기, 로컬 네트워크 공유, TUN을 설정하세요. 한 번에 하나씩만 바꾸고 정상 작동하는 기본 설정을 유지하면 문제를 확인할 기준이 분명해집니다.

전체 클라이언트 보기 →

구독·라우팅·연결 설정

‘설정 출처 → 트래픽 경로 → 적용할 앱 → 도메인 조회’ 순서로 확인하세요. 아래 설정 예시는 펼쳐 두어 항목별로 비교하기 쉽고, 작업 탭에서는 단계별 점검 사항을 볼 수 있습니다.

먼저 설정을 읽어 왔는지 확인하세요. 업데이트 후 현재 그룹과 서버 목록을 살펴보세요. 목록이 비어 있다고 해서 네트워크 연결 오류라고 단정하면 안 됩니다. 구독 업데이트에 실패했다면 로그의 오류 유형을 기록한 다음 주소와 업데이트 방식을 확인하세요.

구독 그룹 설정 비교 ↓

구독 그룹 및 서버 필터링

‘구독 그룹 설정’에서 출처별 그룹을 만들고 구독 주소 전체를 입력한 뒤 업데이트하세요. 그룹은 구독 출처를 관리하는 기능이며 서버의 프로토콜이나 사용 가능 여부를 자동으로 바꾸지는 않습니다. 업데이트 후 선택된 그룹을 확인하고 이름 필터로 목록을 좁히세요. 목록이 비어 있다면 구독이 만료된 것으로 단정하기 전에 필터 조건을 확인하세요. 공유 링크 하나를 직접 가져오는 방식과 달리 구독은 설정을 계속 갱신할 수 있지만, 직접 수정한 항목은 업데이트 과정에서 덮어쓸 수 있습니다. 중요한 변경 사항은 따로 보관하세요.

구독 그룹 및 여러 구독 관리 보기 →
v2rayN / 구독 그룹 설정
그룹 이름업데이트 방식사용 기본 그룹수동 업데이트예
서버 필터현재 그룹에서 이름으로 필터링
업데이트 전 출처를 확인하고, 업데이트 후 현재 그룹을 확인하세요.

도메인 및 IP 라우팅

필요에 가까운 라우팅 사전 설정을 선택한 뒤 사용자 지정 규칙을 몇 개만 추가하세요. 도메인 일치와 IP 일치는 서로 다른 조건이며 규칙 순서도 최종 결과에 영향을 줍니다. 예시에서는 로컬 네트워크 주소를 직접 연결로, 지정한 도메인을 프록시로 보냅니다. 이 문구는 일치 문법을 설명하는 예시이며 그대로 붙여 넣어 실행할 수 있는 완성된 설정은 아닙니다. 전체 모드를 바꾸는 대신 대상별로 트래픽을 분기하면 로컬 네트워크 접근을 유지할 수 있지만, DNS와 대상 일치의 관계를 함께 이해해야 합니다. 변경할 때마다 저장하고 동일한 대상을 사용해 다시 확인하세요.

라우팅 규칙 및 아웃바운드 매칭 보기 →
라우팅 조건 / 문법 예시
도메인 조건 → proxydomain:example.com
비공개 도메인 → directgeosite:private
로컬 네트워크 대역 → directip:192.168.0.0/16
일치 조건과 아웃바운드 태그는 각각 입력하세요. 구체적인 항목은 클라이언트의 규칙 편집기를 기준으로 확인하세요.

VPN 모드 및 앱별 프록시

v2rayNG에서 처음 연결하면 시스템 VPN 권한을 요청합니다. 권한을 허용해야 가상 네트워크 인터페이스로 트래픽을 처리할 수 있습니다. 일부 앱만 프록시를 사용하게 하려면 ‘앱별 프록시’로 이동해 현재 모드가 허용 목록인지 제외 목록인지 확인하세요. 두 모드에서는 같은 앱을 선택해도 의미가 달라집니다. 데스크톱 시스템 프록시보다 VPN 모드의 적용 범위가 넓지만, 실제 동작은 앱 목록, 라우팅, 시스템 제한에 따라 달라집니다. 목록을 바꾼 뒤에는 클라이언트 안내에 따라 다시 연결하고 백그라운드 배터리 제한도 확인하세요. 프로세스가 일시 중지된 상황을 서버 연결 끊김으로 오해하지 않도록 주의하세요.

Android 연결 및 확인 절차 보기 →
v2rayNG / 연결 설정 예시
VPN 모드
앱별 프록시
로컬 네트워크에서의 연결 허용
트래픽 스니핑 사용
먼저 목록 모드를 확인한 뒤 앱을 선택하세요. 이 화면은 정적인 설정 예시입니다.

DNS 조회 및 연결 문제 해결

도메인은 열리지 않지만 IP 주소로는 접속될 때는 모든 서버를 바꾸기 전에 DNS 로그부터 확인하세요. 조회 요청이 로컬 네트워크와 프록시 중 어디로 전달되는지 확인하고, 상위 DNS 서버에 연결할 수 있는지도 살펴보세요. 암호화 DNS 주소 자체를 먼저 조회해야 하는 경우 설정에 따라 시작 단계에서 의존성 문제가 생길 수 있습니다. DNS 주소 하나만 바꾸는 것보다 도메인별 조회 경로를 설정하면 더 세밀하게 제어할 수 있지만 라우팅과 일치시켜야 합니다. FakeDNS는 매핑된 주소를 반환하므로 사용 전에 관련 설정을 확인하세요. 문제를 해결할 때는 먼저 단순하고 검증 가능한 조회 경로로 되돌리세요.

DNS 최적화 및 FakeDNS 보기 →
DNS / 기본 항목 예시
로컬 리졸버 예시223.5.5.5
암호화 리졸버 형식 예시https://dns.example.com/dns-query
조회 정책UseIPv4
example.com 주소는 형식을 보여 주기 위한 예시입니다. 실제 리졸버는 직접 선택하고 연결 가능 여부를 확인하세요.

설정 적용 후 확인 순서

먼저 코어 프로세스가 시작되었는지 확인하고, 로컬 리스너 포트, 시스템 프록시 또는 VPN 상태를 차례로 점검한 다음 대상 앱에서 요청을 보내세요. 클라이언트에 ‘연결됨’이라고 표시되어도 연결 절차가 시작되었다는 뜻일 뿐 앱에서의 동작까지 확인된 것은 아닙니다. 브라우저에서는 접속되지만 터미널에서는 안 된다면 브라우저 확장 프로그램, 터미널 프록시 환경 변수, 앱 자체 설정을 각각 확인하세요. 로그를 보면 오류가 DNS 조회, 연결 수립, 프로토콜 핸드셰이크 중 어디서 발생했는지 파악할 수 있습니다. 로그를 공유하기 전에 구독 주소, 계정 정보, 서버 인증 정보를 삭제하세요.

특정 사이트에서만 문제가 발생하면 현재 클라이언트와 서버 설정을 유지한 채 다른 대상을 먼저 확인하고 해당 사이트에 적용된 라우팅 규칙을 살펴보세요. 모든 앱에서 문제가 발생한다면 로컬 네트워크와 코어 작동 상태부터 확인하세요. 영향 범위에 따라 단계적으로 점검하면 구독, DNS, 라우팅 설정을 오가며 바꾸다가 처음 단서를 놓치는 일을 줄일 수 있습니다. 기본 절차는 사용 가이드를, 증상별 해결 방법은 도움말 센터를 확인하세요.

기술 노트 및 설정 파일 해설

현재 증상과 관련된 글을 먼저 읽고 설정을 변경할지 결정하세요. 아래 글은 최신 글부터 정렬되어 있으며 앱 프록시 적용 범위, 설정 파일 구조, 데스크톱 설치를 다룹니다. 가상 네트워크 어댑터나 로컬 네트워크 공유가 필요하다면 글 목록에서 관련 주제를 더 확인하세요.

문제 해결

V2Ray 시스템 프록시가 작동하지 않을 때: 브라우저는 프록시를 쓰지만 터미널은 쓰지 않는 이유

브라우저와 터미널을 나누어 점검하세요. 브라우저에서는 확장 프로그램과 프록시 설정이 시스템 설정을 덮어쓰는지 살펴보고, 터미널에서는 http_proxy 환경 변수를 설정한 뒤 명령어로 항목별 동작을 확인하세요. 먼저 앱이 어느 계층의 설정을 읽는지 파악한 다음 프록시 경로를 조정하세요.

문제 해결 단계 보기 →

전체 글 보기 →