클라이언트 설치 및 설정 참고 자료

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

v2rayN 다운로드 가이드 보기

v2rayN, v2rayNG, v2flyNG 설치 경로를 한곳에서 확인하고 단계별로 구독 가져오기, 연결 테스트와 라우팅 분할을 진행하세요. 데스크톱과 Android 클라이언트를 다루며 복잡한 코어 설정을 먼저 이해할 필요는 없습니다.

영구 무료 오픈 소스 한국어 문서 다양한 코어 생태계
현재 시스템에 맞게 선택

네 가지 플랫폼의 클라이언트 다운로드 경로

플랫폼 경로는 해당 설치 그룹으로 안내하는 역할만 합니다. 다운로드 페이지에서는 프로세서 아키텍처, 데스크톱 인터페이스 종류와 설치 패키지 형식을 다시 구분하고 각 클라이언트의 사용 범위를 설명합니다. 현재 시스템 아키텍처를 잘 모르겠다면 먼저 플랫폼 페이지에서 선택 기준을 확인한 뒤 파일을 고르세요.

Windows

데스크톱에서는 v2rayN을 우선 고려하세요. 다운로드 페이지에는 최신 크로스플랫폼 데스크톱 인터페이스와 기존 WPF 인터페이스가 함께 정리되어 있어 구독 그룹, 시스템 프록시, 라우팅 규칙과 TUN 모드를 사용하려는 사용자에게 적합합니다.

다운로드 페이지로 이동

macOS

macOS에서는 v2rayN 크로스플랫폼 데스크톱 인터페이스를 사용할 수 있습니다. 설치 전에 기기가 Apple Silicon인지 Intel 프로세서인지 확인해야 합니다. 다운로드 페이지는 두 아키텍처별 경로를 제공하고 시스템 정보에서 칩 종류를 확인하는 방법도 설명합니다.

다운로드 페이지로 이동

Android

Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 선택할 수 있으며, 서비스 설정에 따라 V2Fly 코어를 사용하는 v2flyNG도 고려할 수 있습니다. 다운로드 페이지에는 arm64와 범용 설치 경로를 각각 제공하고 일반적인 기기에서의 선택 기준을 안내합니다.

다운로드 페이지로 이동

Linux

Linux 데스크톱에서는 v2rayN을 사용할 수 있습니다. 다운로드 페이지는 일반적인 deb 및 rpm 설치 형식으로 구성되어 있으며 x64와 arm64 아키텍처를 각각 제공하므로 배포판의 패키지 체계에 맞춰 선택할 수 있습니다.

다운로드 페이지로 이동
전체 클라이언트 보기 →
세 클라이언트 집중 안내

실제 설정 항목으로 이해하는 클라이언트 차이

v2rayN, v2rayNG, v2flyNG는 모두 그래픽 클라이언트지만 플랫폼, 기본 코어와 사용 방식은 서로 다릅니다. 아래에서는 구독 목록, 자동 업데이트와 코어 정보라는 세 가지 주요 화면을 기준으로 각각 어떤 문제에 적합한지 설명합니다.

v2rayN · 구독 그룹 사용 중
일상 사용
구독 그룹 · 자동 업데이트
라우팅 설정
로컬 네트워크 및 자주 사용하는 직접 연결 규칙 우회
시스템 프록시
시스템 프록시 자동 설정

v2rayN: 데스크톱 설정 허브

v2rayN은 Windows, macOS, Linux 데스크톱 환경에서 구독 그룹, 서버 선택, 시스템 프록시, 라우팅 규칙과 TUN 모드를 하나의 그래픽 인터페이스로 관리합니다. 처음에는 구독 주소를 추가하고 그룹을 업데이트한 뒤 사용 가능한 항목을 선택하고 시스템 프록시를 켜면 됩니다. 세밀한 제어가 필요하다면 도메인이나 IP 기준의 라우팅 규칙을 추가로 설정할 수 있습니다. 단순한 켜기·끄기 기능만 제공하는 도구보다 여러 구독을 장기간 관리하고 라우팅 정책을 전환하며 실행 로그를 확인하려는 데스크톱 사용자에게 적합합니다.

다운로드 페이지에서 v2rayN 보기

지원 플랫폼: Windows macOS Linux

v2rayNG · 구독 설정 Xray
구독 자동 업데이트
설정한 간격으로 새로 고침
업데이트 간격
시간 단위로 설정
현재 그룹만 업데이트
다른 구독은 변경하지 않음

v2rayNG: Android 일상 연결

v2rayNG는 Xray 코어를 사용하며 Android 기기에서 구독을 관리하고 VPN 연결을 구성하는 데 적합합니다. 구독을 가져오면 클라이언트가 원격 설정을 선택 가능한 항목으로 정리합니다. 현재 그룹 업데이트, 연결 테스트, 자동 새로 고침 간격 설정과 필요에 따른 앱별 프록시 또는 라우팅 규칙 사용이 가능합니다. 데스크톱과 달리 트래픽을 시스템 VPN 인터페이스가 처리하며 데스크톱의 시스템 프록시 설정에 의존하지 않습니다. VLESS, VMess, Trojan 또는 REALITY 매개변수를 사용하는 설정은 먼저 구독 내용이 현재 코어의 기능과 호환되는지 확인해야 합니다.

다운로드 페이지에서 v2rayNG 보기

지원 플랫폼: Android

v2flyNG · 코어 정보 V2Fly
실행 코어
V2Fly Core
로컬 DNS
설정 파일 따름
로컬 네트워크 우회
로컬 기기 접근 유지

v2flyNG: V2Fly 코어 대안

v2flyNG 역시 Android용이지만 V2Fly 코어를 사용하므로 V2Fly 생태계의 동작 방식이 필요하거나 관련 설정에 익숙한 사용자에게 적합합니다. 기본 사용법은 구독 가져오기, 설정 선택, 연결 시작과 로그 확인으로 v2rayNG와 비슷합니다. 선택할 때는 화면 외관보다 서비스 설정이 요구하는 프로토콜, 전송 방식과 확장 기능을 우선 확인해야 합니다. 구독 제공자가 권장 코어를 명시했다면 해당 안내를 따르세요. 특별한 요구가 없다면 일반적인 최신 프로토콜 매개변수를 폭넓게 지원하는 v2rayNG부터 시작하는 편이 편리합니다.

다운로드 페이지에서 v2flyNG 보기

지원 플랫폼: Android

01

구독 업데이트와 서버 전환을 나누어 이해하기

구독 링크는 설정을 일괄적으로 가져오고 업데이트하는 용도이며, 그 자체가 바로 연결할 수 있는 서버는 아닙니다. 올바른 순서는 구독 설정에서 먼저 그룹을 만들고 전체 주소를 붙여 넣어 저장한 다음 업데이트를 실행하고, 생성된 항목 중 하나를 활성 설정으로 선택하는 것입니다. 업데이트에 실패하면 주소가 완전한지, 현재 프록시를 통해 구독에 접근해야 하는지, 시스템 시간이 정확한지, 클라이언트 로그에 시간 초과나 파싱 오류가 나타나는지를 차례로 확인하세요. 자동 업데이트는 장기 관리에 유용하지만 처음 가져올 때는 수동으로 한 번 새로 고쳐 그룹 이름과 항목 수가 예상과 맞는지 확인하는 것이 좋습니다. 전체 과정은 시작하기에서 확인할 수 있습니다.

오픈 소스 생태계 안내

Project V, V2Fly와 Xray의 관계

클라이언트, 코어와 구독 서비스는 서로 다른 계층에 속합니다. 각 계층의 경계를 이해하면 적절한 소프트웨어를 선택할 수 있고 연결 문제가 생겼을 때 인터페이스 설정, 코어 기능 또는 원격 설정 중 무엇을 확인해야 하는지 빠르게 판단할 수 있습니다.

Project V 생태계에서 여러 코어 계열로

Project V는 프록시 프로토콜, 전송 방식, 라우팅과 DNS 설정을 중심으로 한 오픈 소스 기술 체계를 구축했습니다. 커뮤니티가 계속 발전하면서 V2Fly와 Xray는 대표적인 두 코어 계열로 자리 잡았습니다. 두 코어는 인바운드, 아웃바운드, 라우팅 규칙과 DNS 모듈 등 비슷한 설정 개념을 많이 공유하므로 기본 지식을 서로 적용할 수 있습니다. 다만 지원하는 확장 기능, 매개변수 세부 사항과 릴리스 주기는 완전히 같지 않습니다.

그래픽 클라이언트가 곧 코어인 것은 아닙니다. v2rayN은 구독 관리, 서버 목록, 시스템 프록시와 로그 확인을 데스크톱 인터페이스로 정리하고 설정에 따라 해당 코어를 호출합니다. v2rayNG는 Xray 코어 기능을 Android VPN 서비스에 연결하며, v2flyNG는 V2Fly 코어를 중심으로 모바일 사용 경로를 제공합니다. 프로토콜 매개변수가 인식되지 않는다면 클라이언트 이름만 비교하지 말고 실제로 사용하는 코어부터 확인해야 합니다.

A

공개 라이선스와 코드 검토

V2Fly Core의 일반적인 배포에는 MIT 라이선스가 적용되고 Xray-core에는 MPL 2.0이 적용되며, 그래픽 클라이언트도 각자의 공개 라이선스에 따라 배포됩니다. 라이선스는 코드 사용, 수정과 재배포의 범위를 정하고, 공개 개발 과정에서는 프로토콜 구현, 설정 변경과 문제 수정 사항을 커뮤니티가 지속적으로 논의하고 검토할 수 있습니다. 오픈 소스는 검토 가능한 엔지니어링 기반을 제공하지만 설정 출처와 사용 환경에 대한 사용자의 판단을 대신하지는 않습니다.

B

클라이언트 업데이트와 코어 업데이트는 별개의 과정

클라이언트 인터페이스, 내장 코어와 GeoIP·GeoSite 데이터 파일은 서로 다른 주기로 업데이트될 수 있습니다. 인터페이스 업데이트는 주로 조작 과정과 플랫폼 호환성을 개선하고, 코어 업데이트는 프로토콜 구현, 전송 기능과 오류 처리를 다룹니다. 지리 데이터 업데이트는 도메인 및 IP 분류 결과에 영향을 줍니다. 문제를 해결할 때는 어느 계층에 변화가 있었는지 기록해야 합니다. 오래된 데이터 파일을 구독 만료로 잘못 판단하지 말고, 인터페이스 설정 문제를 프로토콜 자체의 문제로 돌리지도 마세요.

C

구독은 설정 전달만 담당합니다

구독 주소는 일반적으로 인코딩되거나 구조화된 연결 매개변수 묶음을 반환하며, 클라이언트가 이를 파싱하고 저장한 뒤 코어에 전달해 실행합니다. 구독 새로 고침 가능 여부, 설정 인식 여부와 원격 서비스 연결 여부는 따로 검증해야 하는 세 단계입니다. 신뢰할 수 있는 설정 출처를 선택하고 구독 주소를 안전하게 보관하며 만료된 그룹을 정기적으로 정리하는 것이 클라이언트를 자주 바꾸는 것보다 설정을 깔끔하게 유지하는 데 도움이 됩니다.

자주 묻는 질문

설치 전에 확인할 네 가지

처음 설정할 때 발생하는 대부분의 문제는 플랫폼 선택, 구독 가져오기, 프록시 적용 범위와 코어 호환성에 집중됩니다. 먼저 이 개념을 분명히 하면 반복 설치와 목적 없는 설정 전환을 줄일 수 있습니다.

문제 해결 보기
데스크톱 플랫폼에서는 어떤 클라이언트를 우선 선택해야 하나요?

Windows, macOS와 Linux에서는 v2rayN을 우선 선택할 수 있습니다. 구독 관리, 시스템 프록시, 라우팅 규칙, 로그와 TUN 모드를 하나의 인터페이스에서 제공합니다. 플랫폼에 맞는 아키텍처와 설치 형식을 선택해야 하며 자세한 내용은 설치 패키지 페이지에서 확인하세요.

구독 링크를 복사했는데 서버 항목이 나타나지 않는 이유는 무엇인가요?

구독을 추가하는 것은 주소를 저장하는 단계일 뿐이며 업데이트를 한 번 실행해야 합니다. 업데이트 후에도 비어 있다면 링크가 완전한지, 공백이 잘못 포함되지 않았는지, 구독이 만료되지 않았는지, 업데이트에 현재 프록시가 필요한지를 확인하세요. 실행 로그의 네트워크 오류가 추가 단서를 제공할 수 있습니다.

시스템 프록시와 TUN 모드는 어떻게 다른가요?

시스템 프록시는 운영체제의 프록시 설정을 읽는 애플리케이션에 주로 영향을 줍니다. TUN 모드는 가상 네트워크 카드를 통해 더 넓은 범위의 트래픽을 가로채므로 시스템 프록시를 따르지 않는 프로그램에 적합합니다. 트래픽 경로를 이해하지 못한 상태에서 두 기능을 무작정 함께 사용하지 말고, 먼저 시스템 프록시로 기본 연결을 확인하는 것이 좋습니다.

v2rayNG와 v2flyNG는 어떻게 선택해야 하나요?

둘 다 Android용이며 주요 차이는 코어 계열입니다. 일반적인 최신 프로토콜 매개변수는 Xray 코어를 사용하는 v2rayNG부터 시도하고, 기존 V2Fly 설정이 있거나 V2Fly 동작이 명확히 필요할 때는 v2flyNG를 선택할 수 있습니다. 최종 선택은 구독 설정에 필요한 기능을 기준으로 해야 합니다.

설정 및 문제 해결 문서

최근 가이드 업데이트

문서는 재현 가능한 사용 문제를 중심으로 판단 순서, 클라이언트 경로와 변경 후 검증 방법을 각각 설명합니다. 오류가 발생하면 현재 증상과 가장 가까운 주제를 먼저 읽고 단계별로 로그와 설정 변경 사항을 기록하는 것이 좋습니다.

2026-08-16 · 시작하기

v2rayN 구독 업데이트 실패 해결법: 일반적인 원인 점검과 자동 업데이트 설정

구독 링크 만료, 프록시 포트 점유와 프록시를 통해 업데이트해야 하는 구독은 새로 고침 실패 시 우선 확인할 항목입니다. v2rayN과 v2rayNG의 자동 업데이트 간격 설정도 함께 설명합니다.

전체 글 읽기
2026-07-29 · 고급 활용

GeoIP 및 GeoSite 데이터 파일 업데이트 방법: 라우팅 분할 규칙의 데이터 기반

GeoIP와 GeoSite는 도메인 및 IP 분류 결과를 결정합니다. 두 데이터의 역할, 클라이언트에서 업데이트하는 경로와 데이터가 오래됐을 때 발생할 수 있는 라우팅 오판을 설명합니다.

전체 글 읽기
2026-07-11 · 고급 활용

TUN 모드의 전체 트래픽 가로채기 원리: v2rayN 및 v2rayNG 활성화 단계

TUN 모드는 가상 네트워크 카드를 통해 시스템 계층에서 트래픽을 가로챕니다. 시스템 프록시 모드와의 차이를 비교하고 데스크톱 및 Android 클라이언트에서 일반적으로 활성화하는 경로를 설명합니다.

전체 글 읽기
전체 글 보기 →