오픈 소스 클라이언트 가이드

V2Ray 가이드클라이언트 및 설정 가이드

운영체제에 맞는 v2rayN, v2rayNG 또는 v2flyNG를 설치한 뒤, 단계별로 구독을 가져오고 프록시를 설정하세요.

01 클라이언트 설정

구독·프록시·커널 설정

먼저 노드를 클라이언트에 가져온 다음, 어떤 앱은 프록시를 사용하고 어떤 요청은 직접 연결할지 정하세요. 처음 설정할 때는 이 순서대로 하나씩 확인하면 문제 발생 시 원인을 찾기도 쉽습니다.

설정 가져오기

구독 간편 가져오기

구독 주소는 여러 노드 목록을 갱신할 때 사용하고, 공유 링크는 대개 노드 하나에 해당합니다. 구독 주소가 있다면 v2rayN에서 새 구독 그룹을 만들고 주소를 입력한 다음 해당 그룹을 갱신하세요. 노드가 그룹에 표시되는지도 확인합니다. 공유 링크 하나만 있다면 클립보드에서 바로 가져오면 되므로 구독을 추가할 필요가 없습니다. 구독을 사용하면 제공처가 업데이트될 때 노드를 일일이 다시 입력하지 않아도 됩니다. 계속 보관할 수동 노드는 구독과 별도로 저장해 두면 갱신 후에도 기존 항목을 찾기 쉽습니다.

트래픽 연결

시스템 프록시와 TUN 모드

브라우저처럼 시스템 설정을 따르는 앱만 프록시를 사용하면 된다면 먼저 시스템 프록시를 사용해 보세요. 해당 설정을 따르지 않는 앱은 클라이언트에서 TUN 모드를 지원하는지 확인합니다. TUN은 가상 네트워크 인터페이스로 트래픽을 전달해 적용 범위가 더 넓은 편이지만, 추가 권한이 필요하거나 실행 중인 다른 네트워크 도구와 충돌할 수 있습니다. 처음 테스트할 때는 한 가지 모드만 켜고 같은 앱으로 결과를 확인하세요. 클라이언트를 종료하기 전 시스템 프록시가 원래대로 복구됐는지 확인해야 앱이 종료된 로컬 프록시 포트에 계속 연결하는 일을 막을 수 있습니다.

트래픽 경로 선택

라우팅 규칙

라우팅은 클라이언트로 들어온 요청을 프록시, 직접 연결 또는 다른 출구 중 어디로 보낼지 결정합니다. 먼저 기본 규칙을 사용하고, 로컬 네트워크 기기는 직접 연결되도록 유지한 뒤 기본 출구가 예상과 맞는지 확인해 보세요. 모든 트래픽을 프록시로 보내는 방식과 달리, 라우팅을 사용하면 프린터나 파일 공유 등 다른 서비스에도 함께 접속할 수 있습니다. 규칙을 직접 만들 때는 적용 범위가 좁은 예외를 먼저 추가하고, 앞선 일반 규칙에 덮이지 않는지 확인하세요. 한 번에 규칙 하나만 수정하고 기존과 같은 경로로 다시 테스트하면 적용 여부를 판단하기 쉽습니다.

유지 관리 및 설정 복구

커널 및 데이터베이스 업데이트

클라이언트 인터페이스, 프록시 커널, 라우팅 데이터베이스는 각각 따로 업데이트됩니다. 새 전송 옵션을 인식하지 못한다면 먼저 현재 커널의 지원 여부를 확인하세요. 도메인 연결은 되는데 예상과 다른 출구로 연결된다면 규칙 순서와 참조하는 분류 데이터를 살펴보세요. 업데이트 전 자주 쓰는 설정을 저장하고, 업데이트 후 클라이언트를 다시 불러온 다음 같은 노드로 테스트합니다. 클라이언트·커널·데이터베이스를 한꺼번에 바꾸기보다 필요한 항목만 업데이트해야 문제를 찾기 쉽습니다. 결과가 나빠졌을 때도 기록을 보고 어떤 설정을 되돌릴지 판단할 수 있습니다.

설정 후 확인할 항목

그룹이 비어 있다면 입력한 주소가 구독 주소인지 먼저 확인하고 업데이트 알림을 살펴보세요. 다른 그룹은 정상적으로 갱신된다면 클라이언트를 다시 설치하기보다 해당 구독의 상태를 먼저 확인하세요.

02 플랫폼별 다운로드

운영체제에 맞는 클라이언트 다운로드

먼저 운영체제를 확인한 다음 프로세서 아키텍처와 패키지 형식을 확인하세요. 아래 링크를 누르면 다운로드 페이지의 해당 항목이 열립니다. 설치 전 패널에서 패키지 종류와 실행 요구 사항을 확인할 수 있습니다.

Windows

v2rayN을 선택하세요. 다운로드 페이지에서는 크로스 플랫폼 인터페이스를 사용하는 데스크톱 버전과 기존 인터페이스를 유지하는 WPF 버전을 구분합니다. 처음이라면 데스크톱 버전부터 사용해 보세요. 기존 사용 방식에 익숙하거나 클래식 인터페이스 기준의 가이드를 참고해야 한다면 WPF 버전을 확인하세요.

다운로드 전에 운영체제의 ‘정보’ 페이지에서 시스템 종류를 확인하세요. 운영체제 아키텍처와 앱 이름을 혼동하지 마세요. 기존 설정이 있다면 먼저 백업하세요. 인터페이스 버전을 바꾼 뒤에는 구독 그룹, 로컬 포트, 기본 라우팅을 다시 확인한 다음 시스템 프록시를 켜세요.

다운로드 페이지로 이동

macOS

칩에 맞는 v2rayN 디스크 이미지를 선택하세요. ‘이 Mac에 관하여’에 Apple 칩이 표시되면 Apple Silicon 패키지를, Intel 프로세서가 표시되면 Intel 패키지를 선택합니다. 같은 모델명이라도 칩이 다를 수 있으니 시스템에 표시된 정보를 기준으로 선택하는 것이 안전합니다.

디스크 이미지를 연 뒤 설치 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮기고 그곳에서 실행하세요. 연결은 되는데 앱이 프록시를 사용하지 않는다면 시스템 프록시 설정이 적용됐는지 확인하세요. 다른 네트워크 도구도 실행 중이라면 하나씩 종료해 가며 비교해 보세요.

다운로드 페이지로 이동

Android

우선 Xray 커널을 사용하는 v2rayNG를 확인하고, V2Fly 설정이 필요한 경우 v2flyNG를 선택하세요. 대부분의 최신 기기에는 arm64 패키지가 적합합니다. 시스템에서 앱에 제공하는 아키텍처를 모르겠다면 범용 패키지를 확인할 수 있지만, 시스템 버전 요구 사항은 충족해야 합니다.

처음 연결할 때 시스템에서 VPN 권한을 확인하는 경우가 많습니다. 기기에서 다른 VPN 앱을 사용 중이라면 해당 연결을 먼저 종료하세요. 평소에는 연결되지만 화면을 잠그면 끊긴다면 시스템이 클라이언트의 백그라운드 실행을 제한하는지 확인한 뒤 배터리 설정을 조정하세요.

다운로드 페이지로 이동

Linux

배포판과 프로세서 아키텍처에 맞춰 v2rayN을 선택하세요. Debian이나 Ubuntu 계열은 보통 deb, Fedora 계열은 보통 rpm을 사용합니다. 같은 패키지 형식 안에서도 x64와 arm64를 구분해야 하므로 파일 확장자만 보고 선택하지 마세요.

가능하면 배포판에 기본 포함된 소프트웨어 설치 도구로 의존성을 처리하세요. 앱은 실행되지만 브라우저가 프록시를 사용하지 않는다면 데스크톱 환경과 브라우저가 각각 어떤 프록시 설정을 사용하는지 확인하세요. 트레이 메뉴 사용 여부는 현재 데스크톱 환경의 트레이 지원에 따라 달라집니다.

다운로드 페이지로 이동

모든 클라이언트 보기 →

03 오픈 소스 생태계

Project V, V2Fly, Xray

클라이언트 다운로드 페이지의 제품명, 설정에 표시되는 커널명, 링크 앞부분의 프로토콜명은 서로 다른 것을 가리킵니다. 먼저 차이를 알아 두면 가이드와 오류 메시지를 이해하기 쉽습니다.

인터페이스
v2rayN · v2rayNG · v2flyNG
커널
V2Fly · Xray
프로토콜
VMess · VLESS · Trojan · Shadowsocks

Project V는 생태계의 이름

Project V는 처음에 V2Ray를 핵심으로 삼아 조합 가능한 프록시, 전송, 라우팅 기능을 제공했습니다. 초기에는 설정 파일과 커널 프로세스를 중심으로 사용했습니다. 이후 커뮤니티에서 운영체제별 그래픽 클라이언트를 개발하면서 설정 파일에 나뉘어 있던 노드, 라우팅, 로그를 인터페이스에서 관리할 수 있게 됐습니다. 따라서 설치 안내에서 ‘V2Ray’는 커널을 뜻하기도 하고 전체 생태계를 가리키기도 합니다. 이 용어가 나오면 설명이 프로그램 인터페이스, 설정 문법, 통신 프로토콜 중 무엇을 다루는지 먼저 확인하세요.

이 구분은 문제 해결에도 도움이 됩니다. 가져오기 버튼을 찾을 수 없다면 클라이언트 가이드를 확인하세요. 설정 항목을 모두 입력했는데 시작할 때 특정 옵션을 읽지 못한다는 오류가 나온다면 로그를 바탕으로 현재 커널의 설정 문서를 살펴보세요. 인터페이스가 다른 클라이언트로 바꿔도 커널의 설정 처리 방식은 달라지지 않을 수 있습니다.

별도로 관리되는 두 커널 계열

V2Fly는 V2Ray를 이어받아 커뮤니티에서 관리합니다. Xray는 같은 코드 체계에서 분리된 뒤 독자적으로 발전해 왔습니다. 두 계열은 비슷한 개념과 설정 기능을 일부 공유하지만 지원 기능, 기본 동작, 출시 시점이 항상 같지는 않습니다. 예를 들어 REALITY를 사용한다고 명시된 설정을 받았다면 공유 링크의 접두사만 보고 호환 여부를 판단할 수 없습니다. 접두사로 프로토콜 종류는 알 수 있어도 링크에 포함된 모든 전송 및 보안 매개변수를 커널이 처리할 수 있는지는 알 수 없습니다.

v2rayN은 데스크톱 그래픽 인터페이스에서 설정을 관리하고 노드 유형과 클라이언트 지원 여부에 따라 적절한 커널을 호출합니다. v2rayNG는 주로 Xray를, v2flyNG는 V2Fly를 기반으로 합니다. 기존 설정을 옮길 때는 먼저 사용하던 커널을 기록한 뒤 익숙한 노드 하나로 테스트하세요. 처음부터 모든 설정을 가져와 수정할 필요는 없습니다.

오픈 소스 라이선스와 연결 매개변수는 별개입니다

v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 그래픽 클라이언트입니다. 오픈 소스 라이선스는 코드를 사용·수정·재배포하는 방법을 규정하며, 설치 패키지에 포함된 다른 구성 요소에는 각기 다른 라이선스가 적용될 수 있습니다. 배포나 재배포 요건을 확인할 때는 생태계 전체에 한 프로젝트의 조건을 일괄 적용하지 말고 해당 프로젝트와 구성 요소의 라이선스를 살펴보세요.

VMess, VLESS, Trojan, Shadowsocks는 클라이언트에서 인식하는 프록시 프로토콜입니다. 가져올 때는 제공처에서 받은 서버 주소, 포트, 전송 및 보안 설정을 그대로 유지하세요. 링크의 접두사만 다른 프로토콜로 바꿔도 상대편이 같은 설정을 사용하는 것은 아닙니다. 프로토콜 이름만으로 연결에 어떤 보호가 적용되는지도 알 수 없습니다. 예를 들어 VLESS는 프로토콜 종류만 나타내며, 전송 보호 여부는 실제 보안 설정을 확인해야 합니다. 공개적으로 문의할 때는 접두사와 오류 메시지만 설명하고 연결 정보가 포함된 전체 링크는 공유하지 마세요.

커널·인터페이스·규칙 데이터베이스는 각각 업데이트됩니다

클라이언트 업데이트는 주로 인터페이스와 설정 관리 기능을 바꾸며, 패키지에 커널 업데이트가 함께 포함될 수도 있습니다. 커널은 설정을 해석하고 연결을 수립하며, GeoIP와 GeoSite 같은 리소스는 해당 분류를 참조하는 라우팅 규칙에 데이터를 제공합니다. 리소스가 바뀌면 설정 화면에 변화가 없어도 일부 요청의 분류 결과가 달라질 수 있습니다. 반대로 규칙에서 해당 분류를 참조하지 않는다면 새 데이터 파일을 받아도 트래픽 경로는 자동으로 바뀌지 않습니다.

업데이트 후에는 같은 노드, 앱, 대상 주소를 사용해 결과를 비교하세요. 시작되지 않으면 먼저 커널 로그를 확인하고, 시작은 되지만 특정 대상의 출구가 바뀌었다면 라우팅 규칙의 일치 순서와 리소스 파일을 살펴보세요. 업그레이드 전 설정과 테스트 결과를 기록해 두면 여러 항목을 한꺼번에 초기화하는 것보다 원인을 찾기 쉽습니다.

설정 제공처와 서비스 제공처는 구분해서 확인하세요

클라이언트 다운로드는 로컬 기기에서 설정을 읽고 트래픽을 전달하는 방법만 제공합니다. 설치 패키지에 노드나 구독이 포함되는 것은 아닙니다. 수동 설정을 이미 사용 중이라면 먼저 백업한 뒤 새 그룹을 가져오세요. 구독을 갱신하면 노드 이름이 바뀌거나 일부 항목이 삭제될 수 있습니다. 사용 전에 그룹이 갱신된 적이 있는지만 보지 말고 현재 선택된 노드도 확인하세요.

도움을 요청할 때는 운영체제, 클라이언트, 커널, 오류가 발생한 단계와 민감한 정보를 가린 로그를 함께 알려 주세요. 특정 앱에서만 실패한다면 시스템 프록시와 TUN 중 어떤 방식을 사용하는지도 적으면 좋습니다. 스크린샷에서는 구독 주소, 서버 주소, 계정 정보를 가리세요. 처음부터 설정을 다시 확인하려면 설치 및 설정 전체 가이드에서 해당 플랫폼의 내용을 참고하세요.

04 설정별 가이드

최근 설정 가이드

자주 쓰는 설정을 완료한 뒤에는 필요에 따라 멀티 디바이스 설정을 정리하고, 라우팅 리소스를 업데이트하거나 현재 클라이언트와 커널의 조합을 확인해 보세요.

멀티 디바이스

컴퓨터와 안드로이드 휴대폰에서 노드 공유하기: V2Ray 멀티 디바이스 설정 동기화 방법

노드 목록만 공유하려면 두 기기에서 같은 구독을 추가하면 됩니다. 노드 하나만 옮길 때는 공유 링크나 QR 코드를 사용하세요. 이 글에서는 노드 매개변수와 기기별 설정의 차이도 설명합니다. 데스크톱의 라우팅 규칙, 앱 적용 범위, 프록시 모드는 휴대폰에서 다시 확인해야 하는 경우가 많습니다.

모든 글 보기 →

클라이언트 다운로드