클라이언트 설정 · 프로토콜 및 코어 안내

V2Ray 지식베이스클라이언트 다운로드 및 설정

운영체제에 맞는 오픈 소스 클라이언트를 선택하고 구독 가져오기부터 시작해 라우팅 및 프록시 설정을 차례로 알아보세요.

그래픽 인터페이스로 설정 Xray · V2Fly 구독 / 라우팅 / TUN
구독 그룹 →

소스별로 주소를 저장하고 따로 업데이트하세요.

라우팅 →

대상 도메인과 IP를 기준으로 트래픽을 보낼 경로를 정합니다.

시스템 프록시 및 TUN →

앱별 프록시 설정과 가상 네트워크 어댑터를 통한 트래픽 처리를 구분합니다.

위 이미지는 설정 항목을 설명하기 위한 예시이며 기기 설정을 변경하지 않습니다. 메뉴 이름은 클라이언트 업데이트에 따라 달라질 수 있습니다. 라우팅 예시의 아웃바운드 태그는 실제 설정에 있어야 합니다.

설정 항목별 설정 방법 보기

먼저 트래픽이 클라이언트로 들어오는지 확인한 다음 매칭 규칙과 원격 연결을 살펴보세요. 구독, 라우팅, 시스템 프록시는 각각 다른 문제를 해결하므로 모든 설정을 한꺼번에 바꿀 필요는 없습니다.

클라이언트는 설정 인터페이스를 제공하고 코어는 연결과 라우팅을 처리합니다. 구독을 가져와 서버 정보를 저장해도 모든 앱이 자동으로 프록시를 사용하는 것은 아닙니다. 처음 설정할 때는 기본 라우팅을 유지하고 기존 구성을 하나 선택한 뒤, 시스템 프록시로 브라우저 접속을 확인하세요. 이후 필요에 따라 다른 앱을 설정하면 구독 문제, 프록시 연결 문제, 프로토콜 문제를 따로 파악하기 쉽습니다.

구독은 서버 설정을 일괄로 가져오는 기능이며 라우팅이나 프록시 연결 설정을 대신하지 않습니다. v2rayN에서 “구독 그룹” → “구독 그룹 설정”을 열고 메모를 입력한 다음 전체 주소를 붙여 넣으세요. 저장 후 구독을 업데이트하면 됩니다. 출처가 다르면 그룹을 따로 만들어 업데이트 결과를 확인하고 필요 없는 항목을 정리하기 쉽도록 하세요. 업데이트에 실패하면 먼저 로그를 확인한 다음 링크 만료 여부와 프록시를 통해 가져와야 하는지 확인하세요. 구독 주소에는 로그인 정보가 포함될 수 있으므로 화면을 공유하기 전에 주소를 가리세요. 직접 수정한 항목은 다음 업데이트 때 덮어써질 수 있습니다.

구독 가져오기 단계 보기 →

운영체제별 다운로드 경로

데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 먼저 살펴보세요. V2Fly 코어가 필요하다면 v2flyNG도 고려할 수 있습니다. 운영체제와 프로세서 아키텍처를 확인한 다음 인터페이스 버전을 선택하세요.

Windows

v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하며, WPF 버전은 Windows 기본 인터페이스 체계를 유지합니다. 기존 사용 방식에 익숙하다면 이름이 다르다는 이유만으로 모든 설정을 새로 만들 필요 없이 현재 버전을 계속 사용해도 됩니다.

다운로드 전에 시스템의 “설정” → “시스템” → “정보”에서 시스템 종류를 확인하세요. 설치하거나 이전하기 전에 기존 설정을 백업해 새 프로그램과 기존 프로그램의 폴더가 섞이지 않도록 하세요. 처음 실행할 때 구독을 가져와 서버를 선택한 다음 시스템 프록시를 설정하세요. TUN에 필요한 권한과 일반 인터페이스 실행 권한은 각각 확인해야 합니다.

다운로드 페이지로 이동

macOS

v2rayN 데스크톱 버전은 Apple Silicon과 Intel용 다운로드 경로가 다릅니다. 시스템 메뉴에서 “이 Mac에 관하여”를 열어 “칩” 또는 “프로세서” 정보를 확인한 뒤 맞는 설치 파일을 선택하세요. 컴퓨터 외관이나 구매 연도만으로 판단하지 마세요.

설치한 앱은 자주 사용하는 앱 폴더로 옮긴 뒤 실행하세요. 시스템 보안 경고가 표시되면 다운로드 출처와 경고 내용을 확인하고 적절히 처리하세요. 브라우저는 접속되지만 다른 프로그램은 되지 않는다면 해당 프로그램이 시스템 프록시를 따르는지 확인하세요. TUN을 켜기 전에 권한 승인을 완료하고, 다른 네트워크 도구가 동시에 트래픽을 처리하고 있지 않은지도 살펴보세요.

다운로드 페이지로 이동

Android

v2rayNG는 Xray 코어를 사용하므로 이 사이트에서 우선 추천하는 Android 클라이언트입니다. v2flyNG는 V2Fly 코어를 위한 대안입니다. 최신 기기는 대부분 arm64 패키지를 사용할 수 있습니다. 아키텍처를 모르겠다면 기기 정보를 확인한 뒤 다운로드 페이지의 범용 패키지 안내와 비교하세요.

클라이언트에서 구독 또는 공유 링크를 가져오고 구성을 선택해 연결을 시작한 다음 Android의 VPN 연결 요청을 승인하세요. Android의 로컬 VPN 인터페이스는 앱 트래픽을 클라이언트로 전달하는 기능이며 원격 서버에 연결할 수 있는지와는 별개의 문제입니다. 백그라운드에서 연결이 끊기면 로그뿐 아니라 배터리 최적화, 백그라운드 실행 권한, 다른 VPN 앱의 점유 여부도 확인하세요.

다운로드 페이지로 이동

Linux

v2rayN 데스크톱 버전은 deb 및 rpm 패키지를 제공하며 x64와 arm64로 나뉩니다. 먼저 배포판의 패키지 형식과 프로세서 아키텍처를 확인한 뒤 시스템 패키지 설치 도구로 해당 파일을 여세요. 패키지 형식 차이를 프로그램 오류로 오해하지 않도록 주의하세요.

데스크톱 환경마다 시스템 프록시를 적용하는 방식이 조금씩 다릅니다. 설정을 가져온 뒤 수동 프록시를 지원하는 앱에서 로컬 수신 주소와 포트를 먼저 확인하세요. TUN을 사용할 계획이라면 권한과 라우팅을 따로 점검하고 데스크톱 세션 전체를 관리자 권한으로 실행하지 마세요. 연결에 문제가 생기면 클라이언트 로그와 시스템 네트워크 설정을 함께 살펴보면 원인을 찾기 쉽습니다.

다운로드 페이지로 이동

설정 전 자주 묻는 질문

구독을 가져왔는데 브라우저에서 여전히 접속할 수 없는 이유는 무엇인가요?

먼저 서버를 선택했는지, 코어가 정상적으로 실행 중인지 확인한 다음 시스템 프록시가 현재 클라이언트를 가리키는지 살펴보세요. 서버 목록에 항목이 보인다는 것은 설정을 읽어왔다는 뜻일 뿐입니다. 브라우저 확장 프로그램의 자체 프록시 설정이 시스템 설정을 덮어쓸 수도 있습니다. 구독을 반복해서 삭제하기보다 “코어 로그 → 시스템 프록시 → 앱 자체 설정” 순서로 확인하세요. 사용 및 문제 해결 Q&A 보기 →

REALITY와 VLESS 중 무엇을 선택해야 하나요?

두 항목은 같은 계층에서 서로 대체하는 설정이 아닙니다. VLESS는 프록시 프로토콜이고 REALITY는 관련 연결에 사용하는 보안 메커니즘으로, 실제 설정에서는 함께 사용할 수 있습니다. 연결 여부는 전송 방식, 서버 설정, 코어 지원 여부에도 달려 있습니다. 설정을 가져온 뒤에는 제공업체가 지정한 조합을 유지하고 이름만 보고 임의로 바꾸지 마세요. REALITY 용어 설명 보기 →

처음부터 TUN을 켜야 하나요?

처음부터 TUN을 사용할 필요는 없습니다. 대상 앱이 시스템 프록시를 따른다면 먼저 해당 방식으로 연결을 확인하세요. 앱이 시스템 프록시를 무시하고 전체 트래픽을 처리해야 할 때 TUN 권한, DNS, 라우팅을 점검하면 됩니다. Android 클라이언트는 데스크톱의 시스템 프록시와 달리 시스템 VPN 인터페이스를 사용하므로 각 가이드에 따라 설정하세요. 프록시 및 TUN 설정 보기 →

Project V와 코어 계열

프로젝트 생태계, 실행 코어, 그래픽 클라이언트를 구분해서 살펴보세요. 이름이 비슷해도 설정 항목, 업데이트 주기, 기능 범위가 모두 같지는 않습니다.

프로젝트 및 기술 생태계

Project V

V2Ray는 Project V 생태계에서 시작해 인바운드, 아웃바운드, 라우팅, 전송 등의 기능을 조합 가능한 설정으로 구성합니다. 특정 클라이언트 버튼의 위치를 외우는 것보다 구조를 이해하는 편이 설정을 옮길 때 도움이 됩니다.

커뮤니티 유지 관리 분기

V2Fly

V2Fly는 V2Ray 핵심 프로젝트를 이어받아 커뮤니티에서 관리하며 자체적으로 지원하는 설정 형식과 전송 기능을 발전시킵니다. v2flyNG는 Android 그래픽 인터페이스를 제공하며 V2Fly 코어가 필요한 구성에 적합합니다.

독립적으로 발전한 코어

Xray

Xray는 V2Ray에서 파생된 뒤 독립적으로 유지 관리되고 있습니다. VLESS, REALITY 등의 설정은 사용하는 코어가 지원하는지 확인해야 합니다. v2rayNG는 Xray의 관련 기능을 Android 그래픽 클라이언트에서 사용할 수 있도록 제공합니다.

클라이언트와 코어의 역할

v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 그래픽 클라이언트지만, 같은 프로그램의 운영체제별 이름만 다른 것은 아닙니다. 클라이언트는 구독을 관리하고 서버를 표시하며 인터페이스 설정을 저장하고 코어 실행에 필요한 구성을 준비합니다. 코어는 해당 구성에 따라 연결을 만들고 전송을 처리하며 라우팅을 실행합니다. 따라서 인터페이스가 정상적으로 열려도 코어가 성공적으로 시작됐다는 뜻은 아닙니다. 구독 업데이트에 성공했더라도 서버 설정이 현재 코어에 적합하다는 보장은 없습니다.

v2rayN은 데스크톱용 클라이언트로, 여러 코어에 필요한 설정을 관리할 수 있습니다. 구체적으로 사용할 수 있는 기능은 설치된 구성과 인터페이스를 기준으로 확인하세요. v2rayNG와 v2flyNG는 각각 Xray와 V2Fly 생태계를 기반으로 Android 설정을 제공합니다. 다른 기기로 옮길 때는 표준 공유 링크나 구독을 먼저 이전한 다음 기기별 설정을 다시 확인하세요. 시스템 프록시 포트, TUN 권한, 앱별 라우팅 목록, 파일 경로는 보통 다른 기기에서 그대로 가져올 수 없습니다.

오픈 소스 라이선스와 설정 정보 보호

오픈 소스 프로그램은 해당 라이선스에 따라 소스 코드를 공개하며, 라이선스 조건에 맞춰 열람하고 사용하거나 개선에 참여할 수 있습니다. v2rayN, v2rayNG, v2flyNG 클라이언트 프로젝트는 GPL 계열 라이선스를 사용하며 V2Fly와 Xray 코어 프로젝트는 MPL 2.0을 사용합니다. 클라이언트, 코어, 의존성은 각각 별도의 라이선스 대상이므로 배포하거나 수정할 때는 프로젝트 이름 하나만 확인하지 말고 소프트웨어와 함께 제공된 라이선스를 각각 확인하세요.

오픈 소스 여부만으로 원격 서비스와 설정 출처를 신뢰할 수 있는 것은 아닙니다. 구독 주소에는 계정 식별 정보가 포함될 수 있고 공유 링크에는 인증 정보가 들어갈 수 있습니다. 다른 사람에게 도움을 요청할 때는 전체 주소, 사용자 ID, 비밀번호, 키 정보를 가리고 오류 메시지와 필요한 설정 이름만 남기세요. 출처를 알 수 없는 웹사이트에 실제 설정을 붙여 넣어 형식을 변환하지 마세요. 이 사이트의 용어 설명은 설정 항목의 의미를 안내하며 개인 설정을 제출할 필요가 없습니다.

클라이언트, 코어, 규칙 데이터를 따로 업데이트

인터페이스 프로그램, 실행 코어, GeoIP 및 GeoSite 업데이트는 각각 별개의 작업입니다. 인터페이스 업데이트는 메뉴나 구독 해석 방식을 바꿀 수 있고, 코어 업데이트는 설정 항목 지원을 추가하거나 매개변수 검증 방식을 변경할 수 있습니다. 규칙 데이터 업데이트는 분류 매칭 항목에 영향을 줍니다. 문제가 생기면 먼저 어떤 구성 요소가 바뀌었는지 기록하세요. 모든 구성 요소를 한꺼번에 바꾸면 원인을 찾기 어렵습니다.

업데이트 전에 작동하는 설정을 백업하고 사용 중인 라우팅 구성과 프록시 연결 방식을 기록하세요. 업데이트 후에는 기존에 작동했던 설정으로 기본 연결을 확인한 다음 새 설정을 테스트하세요. 로그에 분류를 찾을 수 없다는 메시지가 있으면 규칙 데이터를 확인하고, 알 수 없는 항목이 표시되면 코어 호환성을 살펴보세요. 특정 앱에서만 문제가 생긴다면 해당 앱의 연결 설정을 확인하세요. 이 순서대로 살펴보면 문제와 관계없는 재설치를 줄일 수 있습니다.

연결 확인과 속도 측정 결과의 차이

TCPing, 실제 연결 지연 시간, 다운로드 속도 측정은 각각 다른 구간을 확인합니다. TCP 연결이 성립해도 프록시 핸드셰이크, 도메인 확인, 대상 웹사이트 접속까지 모두 정상이라는 뜻은 아닙니다. 실제 연결 테스트는 테스트 주소, 라우팅, DNS의 영향을 받으며 다운로드 속도는 전송 시간, 대상 서버, 현재 네트워크 상태에 더 크게 좌우됩니다. 결과를 비교할 때는 같은 테스트 방법과 조건을 사용했는지 확인하세요.

처음 설정할 때는 명확한 접속 대상을 정해 먼저 연결을 확인한 뒤 로그의 오류 위치를 살펴보는 편이 좋습니다. 한 가지 테스트에서 값이 나오지 않는다고 모든 설정이 실패했다고 단정하지 말고, 포트 테스트에 한 번 성공했다고 앱의 접속 문제를 무시하지도 마세요. 테스트 결과를 이해하기 어렵다면 속도 측정 원리 안내를 먼저 읽고 서버, DNS, 분할 라우팅을 조정할지 결정하세요.

설정 가이드 및 실전 사례

구체적인 궁금증부터 살펴보세요. 테스트 결과를 해석하는 법, 데스크톱 인터페이스 선택, 여러 기기 간 설정 이전을 안내합니다. 글에 나온 조작 방법은 현재 클라이언트의 설정 항목과 대조해 확인하세요.