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

V2Ray 무료 다운로드 설정 가이드

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 선택하세요. 무료 오픈소스 클라이언트로 구독을 가져온 뒤 라우팅을 설정하면 됩니다.

클라이언트v2rayN · v2rayNG · v2flyNG 코어 생태계Xray · V2Fly · sing-box 설정 순서구독 → 프록시 → 라우팅

구독·프록시·라우팅 설정

먼저 연결에 필요한 설정을 갖춘 다음, 어떤 트래픽을 프록시로 보낼지 정하세요. 다섯 가지 설정은 각각 다른 역할을 하므로 한꺼번에 모두 켤 필요는 없습니다.

구독 관리 · 설정 예시

출처를 저장한 뒤 설정 업데이트

구독 그룹 추가
구독 업데이트(프록시 사용 안 함)
구독 업데이트(프록시 사용)

주소에 실제로 접속할 수 있는지 확인한 뒤 업데이트 방식을 선택하세요.

이 다섯 항목은 서로 대체하는 연결 방식이 아니라 설정 과정의 서로 다른 단계입니다. 구독은 노드 정보를 제공하고, 시스템 프록시나 TUN은 트래픽을 클라이언트로 전달하며, 라우팅은 요청의 경로를 결정하고, 코어는 실제 연결을 처리합니다. 이 순서대로 확인하면 설정 누락, 앱에서 트래픽이 들어오지 않는 문제, 잘못된 연결 경로, 프로토콜 비호환을 구분할 수 있습니다. 자세한 단계는 v2rayN 설정 가이드를, 용어가 궁금하다면 용어집을 참고하세요.

운영체제에 맞는 V2Ray 클라이언트 선택

먼저 운영체제와 프로세서 아키텍처를 확인하세요. 데스크톱에서는 v2rayN으로 시작하고, Android에서는 v2rayNG를 우선 선택하면 됩니다.

Windows

v2rayN · 데스크톱 추천

다운로드 페이지에서 Desktop과 클래식 WPF 버전을 선택할 수 있습니다. Desktop은 크로스 플랫폼 인터페이스를 사용하고, WPF는 익숙한 기존 데스크톱 사용 방식을 유지합니다. 시스템 요구 사항과 사용 환경에 맞는 한 가지를 선택하면 되며 둘 다 설치할 필요는 없습니다. 처음 실행한 뒤 데이터 폴더에 쓰기 권한이 있는지 확인하고 구독을 추가하세요. 권한이 제한된 폴더에 프로그램을 설치하면 설정이 저장되지 않을 수 있습니다.

이미 설정을 사용 중이라면 업데이트 전에 구독 그룹과 라우팅 설정을 백업하세요. 인터페이스 버전을 바꾼 뒤에는 데이터가 제대로 가져와졌는지 확인하고 시스템 프록시를 테스트하세요. 실행 중인 프로그램 파일을 바로 덮어쓰지 마세요.

다운로드 Windows 클라이언트 →

macOS

v2rayN · 칩에 맞춰 선택

먼저 시스템의 '이 Mac에 관하여'에서 칩 정보를 확인한 뒤 Apple Silicon 또는 Intel에 맞는 설치 파일을 선택하세요. 같은 클라이언트라도 프로세서 아키텍처에 맞는 파일이 필요합니다. 올바른 설치 파일을 선택한 다음 시스템 안내에 따라 앱을 설치하고 처음 실행하세요. 시스템 프록시와 TUN에는 서로 다른 권한이 필요하므로 각 기능의 역할을 구분해 알아두세요.

브라우저에서 연결된다고 해서 모든 앱이 프록시를 사용한다는 뜻은 아닙니다. 시스템 프록시를 따르지 않는 앱은 먼저 앱 자체의 네트워크 설정을 확인하세요. 트래픽을 직접 처리해야 한다면 고급 가이드를 참고해 TUN 사용을 검토하세요.

다운로드 macOS 클라이언트 →

Android

v2rayNG 우선 · v2flyNG 대안

v2rayNG는 Xray 생태계를 사용하며 대부분의 Android 초보자 설정에 적합합니다. V2Fly 계열이 필요할 때는 v2flyNG를 고려하세요. 다운로드할 때 기기 아키텍처에 맞춰 arm64 또는 범용 패키지를 선택합니다. 설치 후 구독을 가져와 노드를 선택하고, 시스템에 표시되는 VPN 연결 권한 요청을 승인하세요. 이 권한은 로컬에서 트래픽을 처리하는 인터페이스를 만드는 데 사용됩니다.

화면을 잠근 뒤 연결이 끊긴다면 백그라운드 실행과 배터리 최적화 제한을 확인하세요. 앱별 프록시를 사용하면 처리 범위를 좁힐 수 있지만, 변경한 뒤에는 실제 앱에서 다시 테스트해야 합니다. 알림 표시만 보고 연결 상태를 판단하지 마세요.

다운로드 Android 클라이언트 →

Linux

v2rayN · deb / rpm

배포판의 패키지 형식에 따라 deb 또는 rpm을 선택한 다음 x64와 arm64를 구분하세요. 설치와 일상적인 설정은 그래픽 인터페이스에서 진행할 수 있습니다. 데스크톱 환경마다 시스템 프록시를 읽는 방식이 다를 수 있습니다. 브라우저에서는 연결되지만 다른 프로그램에서는 안 된다면 클라이언트를 다시 설치하기 전에 해당 앱의 프록시 설정이 어디에서 오는지 확인하세요.

TUN을 사용하기 전에 실행 권한과 기기에 이미 설정된 네트워크 서비스를 확인하세요. 기존 네트워크 설정을 기록해 두고 변경 후에는 도메인 해석, 로컬 네트워크 접속, 대상 앱을 각각 테스트하면 문제가 생겼을 때 쉽게 되돌릴 수 있습니다.

다운로드 Linux 클라이언트 →

처음 설정은 3단계로

클라이언트 설치는 시작일 뿐입니다. 사용할 설정을 준비하고, 트래픽 진입 경로를 설정한 다음, 앱에서 접속을 확인하세요.

1단계 · 설정 준비

구독 또는 공유 링크 가져오기

가져온 항목이 구독 주소인지 단일 노드 공유 링크인지 확인하세요. 구독 주소는 구독 그룹에 추가한 뒤 업데이트하고, 공유 링크는 클립보드에서 가져오기 메뉴를 사용합니다. 가져온 뒤 노드 목록에 예상한 항목이 있는지 확인하고 하나를 선택해 현재 설정으로 지정하세요.

클라이언트 자체는 원격 서비스를 제공하지 않으므로 설치가 끝나도 연결할 수 있는 것은 아닙니다. 업데이트 결과가 비어 있다면 복사한 주소가 완전한지, 유효한지, 업데이트 요청이 도달할 수 있는지 먼저 확인하세요. 구독 인증 정보를 공개 게시판에 붙여 넣거나 출처가 불분명한 설정을 시험 삼아 가져오지 마세요.

2단계 · 트래픽 연결

프록시와 라우팅 모드 선택

데스크톱에서는 시스템 프록시 자동 설정을 사용한 다음 용도에 맞는 라우팅 프리셋을 선택하세요. Android에서는 연결을 시작하고 VPN 권한을 승인합니다. 앱별 규칙을 설정했다면 테스트할 앱이 트래픽 처리 범위에 포함되어 있는지 확인하세요. 일반 연결이 확인되기 전까지 TUN은 기본 상태로 두세요.

시스템 프록시는 앱의 트래픽을 클라이언트로 보낼지 결정하고, 라우팅은 전달된 트래픽의 경로를 정합니다. 두 설정을 각각 확인해야 합니다. 전체 라우팅으로 일시적인 진단을 마쳤다면 일상적으로 사용하는 프리셋으로 되돌리세요. 진단 상태를 계속 사용하지 않도록 주의하세요.

3단계 · 접속 확인

실제 앱을 테스트하고 로그 확인

먼저 프록시 설정을 따르는 앱 하나에서 접속을 테스트한 뒤 실행 로그를 확인하세요. 노드가 목록에 보이거나 지연 시간 테스트에 결과가 나왔다고 해서 전체 연결이 정상이라는 뜻은 아닙니다. 접속에 실패하면 어떤 앱에서 어떤 모드를 사용했는지, 로그에 어떤 오류가 표시되는지 기록하세요.

한 번에 설정 하나만 바꾸고 같은 테스트를 반복하세요. 그러면 문제의 원인이 설정, 네트워크, 라우팅, 앱의 트래픽 연결 중 어디에 있는지 파악하기 쉽습니다. 사용을 마치기 전에 데스크톱에서는 시스템 프록시를 해제하고 Android에서는 연결을 중지하세요. 다음에 문제가 생겼을 때도 이 최소 설정으로 되돌려 비교할 수 있습니다.

Project V와 오픈소스 코어 생태계

클라이언트, 코어, 프로토콜은 서로 다른 계층입니다. 각각의 역할을 알아야 다운로드, 설정, 업데이트의 관계를 이해할 수 있습니다.

Project V, V2Fly, Xray의 관계

V2Ray는 Project V 프록시 도구 생태계에서 시작했으며 프로토콜, 전송, 라우팅 기능을 결합하도록 설계되었습니다. V2Fly는 V2Ray 관련 프로젝트를 커뮤니티에서 이어서 관리하고, Xray는 관련 코드 기반에서 출발해 자체 기능을 발전시켰습니다. 기술적 연관성은 있지만 같은 제품의 이름만 다른 것이라고 볼 수는 없습니다. 가이드를 읽을 때는 어떤 코어와 프로토콜을 다루는지, 클라이언트가 어떤 관련 옵션을 제공하는지 함께 확인하세요.

그래픽 클라이언트는 이 기능 계층 위에서 구독을 저장하고 노드를 정리하며 실행 설정을 만들고 로그를 표시합니다. 처음부터 코어 설정 파일을 배울 필요는 없습니다. 먼저 그래픽 인터페이스에서 연결을 구성한 뒤 기반 매개변수를 차근차근 알아가면 됩니다. 반대로 클라이언트의 버튼 이름이 비슷하더라도 코어마다 생성되는 설정이 완전히 같지는 않습니다. 이전하거나 코어를 바꿀 때는 다시 확인해야 합니다.

세 클라이언트의 오픈소스 특징

v2rayN은 여러 데스크톱 운영체제를 지원하는 오픈소스 그래픽 클라이언트로, 구독·프록시·라우팅 관리 기능을 제공합니다. v2rayNG는 Android용이며 Xray 생태계를 사용합니다. v2flyNG 역시 Android용으로 V2Fly 계열을 제공합니다. 선택할 때는 플랫폼과 설정 호환성을 먼저 고려하고 인터페이스 취향은 그다음에 따져보세요. 특정 문제 하나를 해결하려고 클라이언트를 바꾸기 전에 원인이 실제로 코어 기능 차이인지 확인해야 합니다.

오픈소스는 코드와 해당 라이선스를 살펴볼 수 있다는 뜻입니다. 프로젝트를 사용·수정·배포할 때는 각 라이선스를 따라야 합니다. 구독 서비스까지 무료라는 뜻도, 임의로 가져온 설정을 모두 신뢰해도 된다는 뜻도 아닙니다. 클라이언트, 코어, 원격 서비스는 서로 다른 역할을 합니다. 설정을 저장하거나 네트워크 권한을 허용하고 로그를 공유할 때는 민감 정보와 실제 트래픽 처리 범위를 확인하세요.

업데이트 시 세 가지 출처를 따로 확인

클라이언트 업데이트는 인터페이스, 설정 관리, 플랫폼 지원을 바꾸고, 코어 업데이트는 프로토콜 처리와 네트워크 동작에 영향을 주며, 구독 업데이트는 원격에서 제공하는 노드 정보를 새로 고칩니다. 서로 다른 작업입니다. 구독을 정상적으로 업데이트했는데도 연결되지 않는다면 현재 노드 설정과 코어의 호환성을 확인해야 할 수 있습니다. 인터페이스를 업데이트해도 만료된 구독 주소가 자동으로 복구되지는 않습니다.

일상적인 관리에서는 문제가 생겼을 때 복구할 수 있도록 설정을 보존하는 것이 우선입니다. 업데이트 전에 중요한 그룹과 사용자 지정 규칙을 백업하고 변경 내용을 확인한 다음, 업데이트 후 익숙한 노드와 앱으로 다시 테스트하세요. 문제가 생기면 여러 설정을 연달아 바꾸기보다 먼저 로그를 확인하세요. 설정 파싱 오류, 도메인 해석 실패, 연결 시간 초과는 각각 해결 방향이 다릅니다.

용어 이해부터 고급 설정까지

VMess, VLESS 같은 이름은 프로토콜을 가리키며 클라이언트를 뜻하지 않습니다. TLS, 전송 방식, 서버 매개변수도 서로 맞게 조합해야 합니다. 이름이 같다는 사실만으로 노드를 사용할 수 있는지 판단하기는 어렵습니다. 초보자는 기존 설정을 가져온 뒤 각 항목의 역할을 이해하고 수동으로 조정하는 것이 좋습니다. 체계적으로 배우려면 핵심 개념, 클라이언트 선택, 설치, 구독, 프록시 모드, 라우팅, TUN, 일상 관리 순서로 살펴보세요. 흩어진 설정 조각을 바로 이어 붙이지 않는 것이 중요합니다.

클라이언트 설정 및 문제 해결 글

설치, 백그라운드 실행, 연결 테스트에 필요한 내용을 더 자세히 살펴봅니다. 현재 겪는 문제에 맞춰 읽고 모든 옵션을 한꺼번에 바꾸지 마세요.

V2Ray 클라이언트 다운로드