클라이언트 다운로드
데스크톱에서는 v2rayN을, 모바일에서는 v2rayNG를 먼저 확인하세요. 다운로드 페이지에서 기기 아키텍처에 맞는 설치 파일을 선택하면 됩니다.
v2rayN은 데스크톱 버전과 기존 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 익숙한 데스크톱 조작 방식을 유지합니다. 먼저 시스템 아키텍처를 확인한 뒤 원하는 인터페이스를 선택하세요.
처음 사용할 때는 클라이언트를 쓰기 권한이 있는 폴더에 설치하는 것이 좋습니다. 구독을 가져온 뒤 서버를 선택하고 시스템 프록시를 설정하세요. 실행에 문제가 있으면 런타임 환경과 폴더 권한부터 확인하세요.
다운로드 페이지로 이동v2rayN은 Apple Silicon과 Intel 칩에 따라 다운로드 항목이 다릅니다. 시스템의 ‘이 Mac에 관하여’에서 칩 정보를 확인하고, 외관만 보고 설치 파일 아키텍처를 판단하지 마세요.
설치 후 시스템에서 요구하는 필수 권한을 먼저 허용하세요. 일반적인 웹 브라우징은 시스템 프록시로 시작하면 됩니다. 더 많은 앱의 트래픽을 처리하려면 TUN을 확인하고 네트워크 확장 권한 요청에 유의하세요.
다운로드 페이지로 이동먼저 Xray 코어를 사용하는 v2rayNG를 확인하세요. V2Fly 코어가 필요하다면 v2flyNG를 살펴보세요. 대부분의 기기에서는 arm64를 선택하면 되며, 아키텍처가 확실하지 않으면 범용 버전 안내를 확인하세요.
처음 연결할 때 시스템 VPN 권한 요청이 표시됩니다. 권한을 허용한 뒤 실제 연결 테스트를 하고 앱 접속 여부를 확인하세요. 백그라운드에서 연결이 자주 끊기면 배터리 관리와 백그라운드 실행 제한을 점검하세요.
다운로드 페이지로 이동v2rayN은 deb 및 rpm 설치 파일을 제공하며 arm64 아키텍처도 지원합니다. 배포판의 패키지 형식과 프로세서 아키텍처를 각각 확인해 두 조건에 맞는 파일을 선택하세요.
그래픽 인터페이스를 실행한 뒤 노드 설정과 로컬 프록시 포트를 먼저 확인하세요. 데스크톱 환경마다 시스템 프록시를 사용하는 방식이 다를 수 있으므로 앱 자체의 프록시 설정도 확인해야 합니다.
다운로드 페이지로 이동설치 파일에는 클라이언트 프로그램이 포함되며, 바로 사용할 수 있는 서버는 포함되지 않습니다. 설정을 시작하기 전에 유효한 구독 주소나 서버 정보를 준비하세요. 구독 주소에는 계정 정보가 포함될 수 있으므로 공개 페이지나 스크린샷에 노출하지 마세요.
전체 클라이언트 보기 →주요 설정
먼저 연결이 정상적으로 되는지 확인한 다음 설정을 하나씩 조정하세요. 아래 화면은 설정 예시이며, 실제 메뉴 이름은 사용 중인 클라이언트에 따라 다를 수 있습니다.
시스템 프록시는 로컬 프록시 주소를 시스템 설정을 따르는 앱에 전달하므로 브라우저 접속을 먼저 확인할 때 적합합니다. 구독을 가져오고 서버를 선택한 뒤 클라이언트에서 시스템 프록시를 설정하고 새 웹페이지를 열어 결과를 확인하세요. TUN 방식과 달리 보통 가상 네트워크 인터페이스를 만들 필요는 없지만, 일부 앱은 시스템 설정을 따르지 않으므로 프록시를 별도로 지정해야 합니다. 클라이언트를 종료하기 전에 시스템 프록시를 해제해야 꺼진 로컬 포트를 계속 가리키는 일을 막을 수 있습니다. 연결되지 않으면 먼저 코어가 실행 중인지 확인한 다음 앱이 시스템 프록시를 사용하는지 점검하세요. 한꺼번에 모든 설정을 바꿀 필요는 없습니다.
기본 연결부터 확인 →라우팅 규칙은 요청을 직접 연결할지, 프록시로 보낼지, 차단할지를 결정합니다. 단순히 서버를 바꾸는 기능은 아닙니다. 현재 네트워크에 맞는 사전 설정을 선택한 뒤 도메인이나 주소 규칙을 필요한 만큼 추가하세요. 전역 프록시와 달리 라우팅을 사용하면 로컬 리소스는 직접 연결하고 지정한 서비스만 프록시로 보낼 수 있습니다. 규칙은 보통 위에서부터 순서대로 적용되며, 조건이 일치하면 이후 규칙은 확인하지 않습니다. 범위가 넓은 규칙을 앞에 두면 뒤의 구체적인 규칙이 적용되지 않을 수 있습니다. 설정을 바꾼 뒤에는 접속 결과와 로그에서 적용된 경로를 확인하고, 문제가 생기면 가장 최근 변경부터 되돌리세요.
라우팅 설정 보기 →구독 주소는 서버 설정을 가져오는 주소이지, 웹사이트에 접속하는 주소가 아닙니다. 서로 다른 출처의 구독을 각각 별도 그룹에 넣고 업데이트하면 서버를 찾거나 문제를 확인하기 쉽습니다. 노드 링크를 하나씩 붙여 넣는 것과 달리 구독 업데이트는 제공 측의 설정 변경을 반영할 수 있지만 기존 항목을 바꿀 수도 있으므로 직접 수정한 설정은 먼저 백업하세요. 업데이트에 실패하면 주소 유효성, 계정 상태, 업데이트에 사용된 네트워크 경로를 차례로 확인하세요. 같은 구독을 반복해서 추가해 중복 그룹을 만들지 말고, 접속 정보가 포함된 전체 주소를 공개하지 마세요.
구독 관리 보기 →TUN은 가상 네트워크 인터페이스로 트래픽을 받아 시스템 프록시를 직접 사용할 수 없는 앱에 적합합니다. 먼저 일반 프록시 모드에서 서버가 정상적으로 작동하는지 확인한 다음, 클라이언트 안내에 따라 필요한 권한을 허용하고 TUN을 켜세요. 시스템 프록시와 트래픽을 처리하는 계층은 다르지만 모든 요청이 자동으로 프록시를 통과하는 것은 아닙니다. 실제 경로는 라우팅 및 제외 설정에 따라 달라집니다. 켜기 전에 다른 네트워크 도구가 연결을 가로채고 있지 않은지 확인하고, 켠 뒤에는 프록시 접속과 로컬 리소스를 모두 테스트하세요. 인터넷이 끊기면 TUN을 먼저 꺼서 기존 네트워크를 복구한 다음 권한, 라우팅, DNS를 각각 점검하세요.
TUN 설정 보기 →그래픽 클라이언트는 설정과 조작을 담당하고, 코어는 실제 연결을 처리합니다. v2rayN은 지원되는 설정 범위에서 여러 코어를 사용할 수 있습니다. 선택하기 전에 서버 프로토콜, 전송 방식, 관련 매개변수를 확인하세요. 프로토콜 이름만 보는 것보다 전체 설정을 확인해야 가져오기는 성공했지만 연결되지 않는 문제를 줄일 수 있습니다. 코어를 바꿔도 만료된 구독이나 서버 문제는 해결되지 않으며 기존 사용자 설정이 그대로 호환된다는 보장도 없습니다. 사용 가능한 설정을 보관하고 항목별로 옮기면서 시작 로그를 확인하세요. 모바일에서는 v2rayNG와 v2flyNG를 각 코어의 요구 사항에 맞춰 선택해야 합니다.
코어와 클라이언트 알아보기 →오픈 소스 생태계와 설정의 범위
클라이언트, 코어, 서버의 역할을 구분해 두면 단순히 설정 스위치만 외우는 것보다 유용합니다. 문제가 생겼을 때도 원인을 좁히기 쉽습니다.
V2Ray는 Project V 생태계의 네트워크 프록시 도구로, 인바운드·아웃바운드·라우팅·전송 등의 모듈을 조합해 연결을 처리합니다. V2Fly 커뮤니티는 V2Ray 관련 프로젝트의 개발을 이어가고 있으며, Xray는 자체적인 발전 방향을 가진 관련 코어 프로젝트입니다. 기술적 배경을 공유하지만 이름만 다르고 설정이 완전히 같은 소프트웨어라고 볼 수는 없습니다. 프로토콜 지원, 필드의 의미, 기본 동작은 실제 사용 중인 코어를 기준으로 확인해야 합니다.
v2rayN, v2rayNG, v2flyNG는 사용자를 위한 그래픽 클라이언트입니다. 구독 가져오기, 서버 선택, 로그 확인 등의 기능을 인터페이스에 제공하고 설정을 코어에 전달해 실행합니다. 따라서 인터페이스에 항목을 저장할 수 있다고 해서 해당 서버에 연결된다는 뜻은 아닙니다. 설정을 가져왔다는 것은 클라이언트가 내용을 받아들였다는 의미일 뿐입니다. 이후 코어가 정상적으로 시작되고, 서버에 네트워크로 연결되며, 양쪽 설정이 일치해야 합니다.
가이드를 읽을 때는 먼저 문제가 발생한 계층을 구분하세요. 프로그램이 열리지 않으면 설치 환경을, 코어가 시작되지 않으면 설정과 권한을 확인합니다. 코어가 실행 중인데 접속되지 않는다면 서버, 라우팅, 이름 확인을 점검하세요. 이 순서대로 확인하면 관련 없는 설정을 바꾸는 일을 줄일 수 있습니다. 서로 다른 계층의 문제를 한꺼번에 해결하려고 하면 한 가지 문제를 고친 뒤 다른 설정이 영향을 가릴 수 있습니다.
데스크톱에서는 v2rayN을 주요 선택지로 사용하면 그래픽 인터페이스 하나에서 서버, 구독, 라우팅을 관리하기 편리합니다. 다만 운영체제마다 설치 방식과 권한 설정이 다르고, 크로스 플랫폼 인터페이스를 사용하더라도 시스템 네트워크 동작까지 동일한 것은 아닙니다. 기기를 바꿀 때 설정 방식은 참고할 수 있지만 시스템 프록시, TUN 권한, 로컬 파일 경로는 새 기기에서 다시 확인하세요. 다른 컴퓨터의 환경 설정을 그대로 옮기지 않는 것이 좋습니다.
모바일에서는 Xray 코어를 사용하는 v2rayNG를 먼저 확인하세요. V2Fly 코어 설정이 필요하다면 v2flyNG를 살펴보세요. 선택할 때는 이름의 유사성보다 구독 내용, 서버 요구 사항, 기기 호환성을 기준으로 삼아야 합니다. 두 앱 모두 오픈 소스 클라이언트 프로젝트지만 기능 위치, 코어 지원, 업데이트 주기는 각각 다릅니다. 한 앱의 메뉴 위치를 다른 앱에서도 동일한 조작 단계라고 생각하지 마세요.
클라이언트 자체에는 바로 연결할 수 있는 서버가 포함되어 있지 않으며 구독 서비스도 제공하지 않습니다. 설치 후에는 적법하게 제공받은 설정을 준비하고 해당 지역의 법률과 네트워크 이용 규정을 준수해야 합니다. 요금제, 트래픽 배율, 유효 기간, 서버 가용성은 구독을 제공하는 곳에서 결정합니다. 프로그램이 실행되는 것은 로컬 설치가 완료됐다는 뜻일 뿐입니다. 실제 사용 가능 여부는 연결 테스트와 직접 접속을 통해 확인해야 합니다.
V2Ray, Xray 및 관련 클라이언트의 코드는 오픈 소스로 제공됩니다. V2Ray와 Xray 코어는 MPL 2.0을 따르며, 이 문서에서 다루는 세 가지 그래픽 클라이언트 프로젝트는 GPL 3.0 계열 라이선스를 사용합니다. 구체적인 적용 범위와 추가 고지는 각 프로젝트에 포함된 라이선스 파일을 확인하세요. 오픈 소스 라이선스는 코드의 사용, 수정, 배포 조건을 설명하며 서버 제공자의 서비스 약관을 대신하거나 모든 설정 출처를 보증하지 않습니다.
일반 사용자는 권한과 데이터 흐름을 이해하는 것이 더 중요합니다. 시스템 프록시는 일부 앱에 로컬 프록시 포트를 사용하도록 알립니다. TUN은 더 넓은 범위의 네트워크 트래픽을 받습니다. LAN 연결을 허용하면 같은 네트워크의 다른 기기에서 로컬 프록시에 접속할 수도 있습니다. 기능을 켜기 전에 해결하려는 문제가 무엇인지 분명히 하세요. 특히 네트워크 경계를 잘 모르는 상태에서 수신 대상을 무분별하게 넓히지 마세요.
구독 주소에는 계정 식별 정보나 접속 자격 증명이 포함될 수 있으며, 클라이언트 설정에는 서버 비밀번호와 사용자 식별 정보가 들어갈 수 있습니다. 다른 사람에게 문제를 설명할 때는 민감한 내용을 가린 로그 일부, 오류 이름, 작업 순서를 우선 제공하고 설정 폴더 전체를 공개하지 마세요. 백업 파일도 안전하게 보관해야 합니다. 코드를 공개해 프로그램 동작을 확인할 수 있더라도 일상적인 정보 보호에는 올바른 설정과 공유 습관이 필요합니다.
클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 주로 인터페이스와 설정 관리 기능에 영향을 줍니다. 코어 업데이트는 프로토콜 구현이나 설정 지원을 바꿀 수 있습니다. 구독 업데이트는 설정 제공처에서 서버 항목을 다시 가져옵니다. 문제가 생겼을 때 세 가지를 한꺼번에 진행하지 마세요. 현재 증상과 최근 변경 사항을 기록한 뒤 문제와 관련된 항목 하나만 처리해야 결과를 정확히 확인할 수 있습니다.
업데이트 전에는 현재 설정을 백업하고 구독 그룹, 사용자 지정 라우팅, DNS 설정을 확인하세요. 업데이트 후에는 프로그램이 정상적으로 시작되는지 살펴보고, 이전에 사용 가능했던 연결을 테스트한 다음 특수 규칙을 확인하세요. 메뉴 이름이나 옵션 위치가 바뀌면 현재 인터페이스를 기준으로 사용하세요. 예전 가이드와 화면을 맞추려고 설정을 반복해서 덮어쓰지 마세요. 다운로드 페이지에서는 운영체제와 설치 파일을 선택하고, 가이드에서는 첫 설정을 다루며, 고급 안내서에서는 설정 간 관계를 설명합니다.
테스트는 범위를 좁혀 시작하세요. 서버 하나를 선택하고 코어가 실행되는지 확인한 다음 브라우저 접속을 점검합니다. 브라우저는 정상인데 다른 앱이 실패한다면 앱의 프록시 방식을 확인하세요. 모든 앱이 실패하면 서버 연결과 로그부터 살펴보세요. 특정 도메인만 문제가 있다면 라우팅 규칙 적용과 DNS를 확인합니다. 지연 시간이 표시된다고 해서 모든 프로토콜과 대상이 정상이라는 뜻은 아닙니다. 실제 연결 속도 테스트도 직접 접속 결과와 함께 판단해야 합니다.
이 사이트는 다운로드 경로와 기술 안내를 정리합니다. 브랜드 이름은 사이트를 식별하기 위한 것이며 각 오픈 소스 프로젝트의 소속 관계를 바꾸지 않습니다. 클라이언트의 구체적인 기능과 라이선스는 프로젝트에 포함된 안내를 확인하세요. 사이트 소개와 콘텐츠 관리 원칙은 사이트 소개에서 확인할 수 있습니다.
최근 글
먼저 설정이 정상적으로 작동하는지 확인한 뒤 서버 선택과 규칙 우선순위를 살펴보세요. 현재 문제에 맞는 글부터 읽으면 전체 설정을 한꺼번에 바꾸지 않아도 됩니다.
구독을 가져온 뒤 첫 연결까지 필요한 과정을 안내합니다. 사용 가능한 서버를 고르고 실제 연결 속도를 테스트해 가짜 연결을 걸러낸 다음, IP 조회와 접속 테스트로 프록시가 제대로 적용됐는지 확인하세요.
글 읽기 →domain, full, regexp, geosite, geoip 등 매칭 접두사의 작성법과 차이를 설명하고, 규칙이 위에서 아래로 적용되는 순서와 자주 발생하는 충돌의 해결 방법을 안내합니다.
글 읽기 →구독에 포함된 서버를 네 가지 기준으로 비교합니다. 지연 시간의 의미, 배율에 따른 트래픽 소모, 지역과 용도의 적합성, VMess·VLESS·Trojan 프로토콜별 선택 기준을 살펴보세요.
글 읽기 →