GUI 클라이언트 · 구독 및 라우팅 설정

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

v2rayN 다운로드 사용법 보기

구독 가져오기, 분할 라우팅, DNS 설정을 중심으로 데스크톱과 Android 클라이언트를 설정합니다.

VMess VLESS Trojan REALITY
Windows Android macOS Linux

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

운영체제와 CPU 아키텍처를 먼저 확인한 다음, 클라이언트에 필요한 코어 기능을 살펴보세요. 다운로드 페이지에서 설치 파일 형식과 선택 기준을 확인할 수 있습니다. 홈페이지에서는 설치 파일을 직접 배포하지 않습니다.

Windows

 v2rayN 추천

v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하려는 경우에 적합한 크로스 플랫폼 인터페이스를 사용합니다. WPF 버전은 기존 인터페이스를 유지하므로 사용 경험이 있는 환경에 알맞습니다. 지원되는 운영체제인지 먼저 확인한 뒤 선호하는 인터페이스를 선택하세요. 인터페이스를 바꾼다고 서버 매개변수를 임의로 수정할 필요는 없습니다.

처음 실행하면 구독을 가져와 서버를 선택한 다음 시스템 프록시를 설정하세요. 브라우저에서 접속된다고 해서 명령줄 도구나 모든 앱도 프록시를 사용한다는 뜻은 아닙니다. 앱이 시스템 프록시를 따르는지, 프록시 주소를 직접 설정해야 하는지 각각 확인해야 합니다. 프로그램 폴더를 옮기거나 기기를 교체하기 전에는 클라이언트에서 사용자 지정 규칙과 매개변수를 백업하세요.

다운로드 페이지 →
설치 옵션: 데스크톱 버전과 클래식 WPF 버전을 각각 확인하세요. 연결 방식: 먼저 시스템 프록시를 사용하고, 필요하면 TUN을 검토하세요.

macOS

 v2rayN

macOS에서는 v2rayN을 사용할 수 있으며, 설치 파일은 Apple Silicon과 Intel 칩에 따라 다릅니다. 시스템의 ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인한 뒤 알맞은 아키텍처를 선택하세요. 외관이나 구입 연도만으로 판단하면 안 됩니다. 클라이언트 인터페이스, 코어 프로세스, 시스템 네트워크 설정은 서로 다른 계층이므로 프로그램을 실행한 뒤 시스템 프록시가 켜져 있는지 확인해야 합니다.

다른 데스크톱 기기에서 옮기는 경우 구독 링크는 다시 가져올 수 있지만 로컬 경로, 수신 포트, 권한 설정은 다시 확인해야 합니다. 다른 네트워크 도구가 시스템 프록시를 변경했다면 해당 도구를 먼저 종료한 뒤 테스트하세요. 여러 프로그램이 설정을 번갈아 덮어쓰는 일을 방지할 수 있습니다. 절전 모드에서 깨어나거나 네트워크를 바꾼 뒤 문제가 생기면 현재 서버, 시스템 프록시, DNS부터 확인하고 설정 재구성은 그다음에 고려하세요.

다운로드 페이지 →
칩 선택: Apple Silicon은 arm64, Intel은 x64에 해당합니다. 자세한 시스템 요구 사항은 다운로드 페이지를 확인하세요.

Android

 v2rayNG 추천

Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 고려하세요. 기존 설정이 V2Fly 동작에 의존한다면 v2flyNG도 확인해 볼 수 있습니다. 두 클라이언트의 조작 방식은 비슷하지만 코어 기능을 이름만 보고 서로 바꿔 쓸 수는 없습니다. VLESS, REALITY 등의 조합을 사용하려면 클라이언트와 코어, 공유 링크의 필드를 함께 확인하세요. 가져오기에 성공했다고 해서 설정이 호환되는 것은 아닙니다.

설치 파일은 arm64와 범용 버전으로 제공됩니다. 최신 기기는 대체로 arm64를 사용하며, 확실하지 않다면 시스템 아키텍처 안내를 확인하세요. 처음 연결할 때는 시스템 VPN 권한을 허용해야 합니다. VPN 채널을 사용하는 다른 앱을 동시에 켜면 연결이 바뀔 수 있습니다. 백그라운드에서 연결이 끊기면 배터리 제한과 백그라운드 실행 권한부터 확인하세요. 처음부터 프로토콜을 바꿀 필요는 없습니다.

다운로드 페이지 →
다운로드 순서: v2rayNG를 먼저, v2flyNG를 다음에 확인하세요. 앱별 프록시와 백그라운드 동작은 기기에서 따로 설정해야 합니다.

Linux

 v2rayN

Linux 데스크톱에서는 v2rayN을 사용할 수 있습니다. 먼저 배포판의 패키지 형식에 따라 deb 또는 rpm을 선택한 뒤 x64와 arm64 중 맞는 아키텍처를 고르세요. 패키지 형식은 설치 방식을, 아키텍처는 프로그램 실행 가능 여부를 결정하므로 둘 다 맞아야 합니다. GUI 클라이언트는 구독과 라우팅을 관리하기 편리합니다. 데스크톱 환경마다 시스템 프록시 지원이 다르므로 특정 브라우저에서의 결과를 모든 앱에 적용할 수는 없습니다.

구독을 가져온 뒤 프록시 설정을 명시적으로 지원하는 앱 하나로 먼저 테스트한 다음 데스크톱 프록시와 다른 프로그램을 차례로 확인하세요. 더 많은 연결을 처리해야 한다면 TUN 모드의 권한과 라우팅 영향을 알아보세요. 연결이 시작되지 않을 때는 서버를 계속 바꾸기보다 로그에 표시된 권한, 포트 충돌, 설정 필드 관련 메시지를 확인하는 편이 효과적입니다. 사용자 지정 규칙은 따로 저장해 두면 나중에 옮기거나 복원하기 쉽습니다.

다운로드 페이지 →
패키지 형식: deb / rpm. CPU 아키텍처: x64 / arm64. 먼저 기본 연결을 확인한 뒤 처리 범위를 넓히세요.
모든 클라이언트 보기 →

구독·라우팅·연결 매개변수

클라이언트 설정 화면의 순서대로 확인하세요. 입력 경로, 트래픽의 목적지, DNS 조회 경로를 구분한 다음 수정할 항목을 판단하고, 여러 매개변수를 한꺼번에 바꾸지 마세요.

구독과 로컬 설정을 분리해 관리

구독은 서버 설정을 제공처에서 일괄 관리하고, 클라이언트는 이를 가져와 파싱하고 그룹별로 표시합니다. 추가할 때 알아보기 쉬운 이름을 입력하고 업데이트한 뒤 프로토콜 필드를 확인하세요. 수동으로 추가한 노드는 별도 그룹에 넣어 구독에서 생성된 항목과 섞이지 않게 하세요. 구독 노드를 로컬에서 수정하면 다음 업데이트 때 변경 내용이 덮어써질 수 있습니다. 공유 링크를 하나씩 복사하는 것보다 구독을 사용하면 계속 동기화하기 편하지만, 라우팅·DNS·시스템 프록시 설정까지 함께 옮겨지지는 않는 경우가 많습니다. 구독 주소에 접근 정보가 포함될 수 있으므로 문제를 공유하기 전에 가리세요.

구독 관리 / 작업 순서
구독 그룹 추가
  → 이름과 구독 주소 입력
  → 현재 그룹 업데이트
  → 서버 매개변수 확인
  → 활성 서버 선택

수동 설정 → 별도 그룹
사용자 지정 라우팅 → 별도 백업
구독 가져오기 단계 보기 →

구독 가져오기부터 연결 확인까지

첫 설정은 하나의 흐름으로 완성하세요. 서버 하나와 앱 하나의 연결을 먼저 확인한 뒤 규칙, 앱별 설정, 더 넓은 트래픽 처리 범위를 추가하세요.

  1. 구독을 가져오고 활성 서버 확인

    클라이언트를 설치하고 실행한 뒤 구독 그룹을 추가하고 이름과 구독 주소를 입력한 다음 해당 그룹을 업데이트하세요. 데스크톱 v2rayN과 Android v2rayNG는 메뉴 위치가 다르지만, 모두 ‘구독 추가’와 ‘서버 가져오기’를 구분해야 합니다. 구독 주소를 저장했는데 목록이 비어 있다면 먼저 업데이트를 실행했는지 확인하고, 로그에서 네트워크 또는 DNS 관련 메시지를 살펴보세요.

    서버 하나를 활성 항목으로 선택하고 주소, 포트, 프로토콜, 전송 및 보안 필드를 확인하세요. 구독 링크, 단일 공유 링크, 전체 설정 파일은 서로 다른 입력 형식이므로 아무 가져오기 메뉴에나 넣을 수 없습니다. QR 코드만 있다면 단일 노드인지 구독 주소인지 먼저 확인하세요. 구독에는 모든 로컬 환경설정이 포함되지 않으므로 기기를 옮긴 뒤 라우팅과 DNS를 다시 살펴봐야 합니다. 관련 개념은 용어집에서 비교해 보세요.

  2. 모드를 선택하고 기본 라우팅 유지

    데스크톱에서는 먼저 시스템 프록시를 사용하고 테스트 앱이 해당 설정을 따르는지 확인하세요. Android에서는 VPN 권한을 허용한 뒤 연결을 시작합니다. 처음에는 클라이언트에서 사용할 수 있는 기본 라우팅 프리셋을 유지하고 출처가 불분명한 복잡한 규칙은 추가하지 마세요. 로컬 네트워크 기기에 접근해야 한다면 로컬 네트워크 우회 설정을 확인하세요. 앱별 프록시는 현재 포함 목록과 제외 목록 중 어느 방식인지 확인해 테스트할 앱을 반대 범위에 넣지 않도록 주의하세요.

    시스템 프록시를 변경하거나 VPN 채널을 사용하는 도구를 여러 개 동시에 실행하지 마세요. 브라우저에서는 접속되지만 다른 앱에서 실패한다면 구독을 바로 바꾸기보다 해당 앱의 프록시 동작부터 확인하세요. TUN이나 FakeDNS가 필요하다면 기본 연결을 검증한 뒤 하나씩 켜고 변경 전 상태를 기록해 두세요. 조건을 한 번에 하나씩 바꿔야 권한, 라우팅, DNS 중 무엇이 원인인지 알 수 있습니다.

  3. 접속을 확인한 뒤 DNS와 로그 점검

    연결을 시작한 다음 실제로 사용할 앱에서 요청을 보내고 클라이언트 로그를 확인하세요. 코어가 실행되었는지, 아웃바운드 연결이 수립되었는지 살펴본 뒤 앱 요청이 프록시로 전달되는지 확인합니다. 서버 테스트 성공은 해당 테스트에서 사용한 경로만 작동한다는 뜻이며, 브라우저·앱·DNS를 직접 확인하는 과정을 대신하지 않습니다. 분할 라우팅을 검증하려면 한 사이트만 방문하지 말고 직접 연결해야 할 대상과 프록시를 거쳐야 할 대상을 각각 테스트하세요.

    오류가 발생하면 재현 시각, 사용 모드, 로그에 표시된 오류 유형을 기록하세요. 로그를 공유하기 전에는 구독 주소, 사용자 식별자 및 기타 민감한 매개변수를 지우세요. 인증서, 인증, 도메인 조회, 포트 충돌은 각각 확인할 항목이 다르므로 재설치가 첫 번째 해결책은 아닙니다. 연결이 안정되면 로컬 설정을 백업하세요. 이후 변경 사항을 되돌릴 수 있는 기준점이 됩니다. 자주 발생하는 오류는 자주 묻는 질문에서 확인하고, 전체 절차는 사용 가이드를 참고하세요.

전체 사용법 보기 →

Project V와 코어 계열

클라이언트는 설정과 사용자 인터페이스를 담당하고 코어는 연결을 실행합니다. 두 계층을 구분해야 프로토콜 지원, 설정 호환성, 업데이트 후 동작 변화를 이해할 수 있습니다.

PROJECT V

V2Ray 생태계

기술적 뿌리는 같지만 기능은 서로 다르게 발전합니다.

V2FlyV2Ray 커뮤니티 개발을 이어감
XrayV2Ray에서 분기해 독자적으로 발전

GUI 클라이언트가 설정을 만들고 선택한 코어가 이를 실행합니다. 일부 개념을 공유해도 모든 확장 필드가 서로 호환되는 것은 아닙니다.

생태계의 역사: 뿌리가 같아도 기능은 다릅니다

Project V는 V2Ray 기술 생태계를 이해하는 출발점입니다. V2Fly는 V2Ray 커뮤니티 개발을 이어가고, Xray는 V2Ray에서 분기해 독자적인 기능 발전 경로를 갖추었습니다. 세 프로젝트는 인바운드, 아웃바운드, 라우팅 같은 설정 개념을 공유하지만 지원하는 프로토콜 확장, 설정 필드, 기본 동작은 점차 달라집니다. 따라서 ‘V2Ray 생태계에 속한다’는 사실만으로 설정을 그대로 옮길 수 있다고 판단해서는 안 됩니다.

클라이언트 이름과 코어 이름도 일대일로 대응하지 않습니다. GUI는 구독을 받아 설정을 생성하고 코어를 호출하며, 실제 인증·전송·라우팅은 실행 중인 코어가 처리합니다. 호환성 문제를 점검할 때는 클라이언트와 코어 정보를 모두 기록하세요. 안내서의 특정 옵션을 사용할 수 있는지는 화면에 표시된 메뉴 이름만 보지 말고 현재 인터페이스와 실제 코어의 지원 범위로 판단해야 합니다.

코어 선택: 기존 설정에서 필요한 기능 파악

REALITY, XTLS Vision 등의 기능이 필요하다면 Xray의 지원 여부와 필수 필드를 중점적으로 확인하세요. 기존에 VMess나 다른 일반적인 프로토콜을 사용하더라도 전송 계층과 보안 매개변수를 확인해야 하며, 프로토콜 이름만으로 호환된다고 판단할 수 없습니다. V2Fly와 Xray는 일부 기본 구조가 비슷하지만 확장 기능과 DNS 동작은 다를 수 있습니다. 전환하기 전에 기존 설정을 보존하고 최소 연결로 검증한 뒤 사용자 지정 규칙을 단계적으로 복원하세요.

프로토콜은 속도 순위가 아닙니다. 핸드셰이크 방식, 서버 부하, 전송 경로, 다중화 설정, 단말 네트워크가 모두 사용 경험에 영향을 줍니다. 모바일에서는 백그라운드 정책과 연결 유지에 따른 배터리 소모도 고려해야 합니다. 클라이언트를 선택할 때는 기능과 호환 조건을 먼저 충족한 뒤 같은 기기와 네트워크에서 실제 동작을 비교하세요. 구체적인 차이는 프로토콜 안내서에서 확인할 수 있으며, 고급 옵션을 한꺼번에 모두 켤 필요는 없습니다.

오픈소스 이해하기: 클라이언트와 코어는 별개

v2rayN, v2rayNG, v2flyNG는 모두 오픈소스 GUI 클라이언트입니다. v2rayN은 데스크톱 설정 관리용이며, v2rayNG는 Xray 코어를 사용하고 v2flyNG는 V2Fly 코어 기반의 Android 선택지를 제공합니다. 이 클라이언트는 연결 도구와 설정 인터페이스를 제공할 뿐, 설치만으로 사용할 수 있는 서버 설정이 만들어지지는 않습니다. 구독이나 서버 매개변수는 별도로 확보하고 출처와 사용 권한을 확인해야 합니다.

오픈소스 라이선스는 코드 사용과 재배포 조건을 규정하며, 클라이언트와 코어를 각각 확인해야 합니다. V2Fly는 MIT 라이선스, Xray-core는 MPL-2.0 라이선스를 사용합니다. 라이선스는 프로젝트 코드의 사용 조건을 설명하며 구체적인 설정이나 실행 환경에 대한 판단을 대신하지 않습니다. 문제가 발생하면 인터페이스 조작, 구독 파싱, 코어 실행 중 어느 계층의 증상인지 먼저 구분하면 점검 범위를 좁힐 수 있습니다.

업데이트 관리: 프로그램과 구독은 따로 관리

프로그램, 코어, 규칙 데이터, 구독 업데이트는 각각 다른 작업입니다. 구독 업데이트는 주로 서버 항목을 갱신하며 클라이언트의 새 필드 파싱 기능을 보완하지는 않습니다. 프로그램을 업데이트해도 만료된 구독 주소가 자동으로 수정되는 것은 아닙니다. 새 기능 안내를 확인했다면 어떤 계층에 해당하는지 먼저 파악한 뒤 필요한 부분을 업데이트하세요. 장기간 사용하는 기기에서는 구독 링크만 보관하지 말고 복원 가능한 로컬 설정도 유지해야 합니다.

업그레이드 전에 사용자 지정 라우팅, DNS, 수동 노드를 백업하고, 업그레이드 후에는 사용 가능한 설정으로 먼저 검증하세요. 기본 접속, 분할 라우팅, DNS 조회가 모두 예상대로 동작하는지 확인한 다음 다른 고급 설정을 복원합니다. 이 사이트는 클라이언트 다운로드 경로와 한국어 사용 안내를 제공하며 서버 구독은 제공하지 않습니다. 또한 제3자 매개변수를 기본적으로 신뢰할 수 있는 것으로 취급하지 않습니다. 클라이언트를 선택한 뒤 다운로드 페이지에서 설치 방법을 확인하고 사용 가이드에 따라 설정을 완료하세요.

설정 방법과 문제 해결

여러 구독 관리, DNS 경로, Android 백그라운드 동작부터 살펴봅니다. 각 글은 하나의 구체적인 문제에 집중해 설정 방법, 적용 조건, 검증 절차를 안내합니다.

모든 글 보기 →