v2rayN 다운로드 및 사용 가이드 v2rayN 클라이언트 다운로드및설정 가이드

구독 관리, 라우팅, 시스템 프록시를 중심으로 플랫폼에 맞는 클라이언트를 선택하고 설정을 하나씩 완료하세요.

데스크톱: v2rayN Android: v2rayNG / v2flyNG 코어 생태계: Xray · V2Fly · sing-box

CONFIGURATION LAYERS

구독, 라우팅 및 코어 설정

GUI 클라이언트는 설정을 관리하고 코어는 연결을 처리합니다. 구독 출처, 트래픽 진입점, 아웃바운드 규칙을 구분해 확인하면 여러 설정을 한꺼번에 바꾸는 것보다 문제를 찾기 쉽습니다.

출처별 구독 관리로 수동 설정 보호

구독 주소는 여러 서버 설정을 가져오는 주소이며, 단일 서버 주소와는 다릅니다. v2rayN에서 새 구독 그룹을 만들고 알아보기 쉬운 메모를 입력한 다음 전체 주소를 붙여 넣고 업데이트하세요. 출처가 다르면 그룹도 따로 만들어야 각각 독립적으로 새로 고치거나 비활성화하고 문제를 확인할 수 있습니다. 서버 정보를 하나씩 입력하는 것보다 구독을 이용하면 여러 설정을 계속 관리하기 편리하지만, 업데이트 중 출처에서 삭제된 항목이 함께 제거될 수 있습니다. 오래 보관할 수동 설정은 별도로 관리하세요. 업데이트에 실패하면 먼저 로그의 요청 오류를 확인하고, 기존 프록시를 통해 업데이트해야 하는지 살펴보세요.

구독 그룹 설정
메모출처별로 이름 지정
구독 주소전체 주소 입력
구독 업데이트
업데이트 사용그룹별 설정
업데이트 결과로그에서 확인

인터넷 연결 불가, 구독 실패, DNS 오류별 문제 해결 가이드 보기 →

CLIENT DOWNLOADS

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

데스크톱에서는 v2rayN을, Android에서는 먼저 v2rayNG를 살펴보세요. V2Fly 코어가 필요하다면 v2flyNG를 고려할 수 있습니다. 설치 패키지의 아키텍처와 설정 프로토콜은 별개이므로, 먼저 기기에 맞는 아키텍처를 선택하고 구독 호환성을 확인하세요.

Windows

v2rayN · Desktop / WPF

Windows 사용자는 데스크톱 버전과 클래식 WPF 버전 중에서 선택할 수 있습니다. 데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 익숙한 데스크톱 조작 방식을 유지합니다. 두 버전 모두 시스템 요구 사항을 확인한 뒤 사용 습관에 맞춰 선택하세요. 같은 구독을 가져오기 위해 두 인스턴스를 동시에 실행할 필요는 없습니다.

기존 설정이 있다면 클라이언트를 바꾸기 전에 구독 그룹, 라우팅, 개인 설정을 백업하세요. 설치 후에는 로컬 수신 포트와 트레이의 시스템 프록시 상태를 확인해 브라우저가 이전 인스턴스를 가리키지 않도록 합니다. 시스템 프록시는 해당 설정을 따르는 앱에만 영향을 줍니다. 프록시를 별도로 설정한 프로그램은 앱 내부의 진입점도 확인하세요. 포트가 이미 사용 중이면 포트를 연달아 바꾸기보다 먼저 기존 인스턴스를 종료하세요.

macOS

v2rayN · Apple Silicon / Intel

macOS에서는 먼저 ‘이 Mac에 관하여’에서 칩 종류를 확인한 다음 Apple Silicon 또는 Intel용 설치 패키지를 선택하세요. 앱을 응용 프로그램 폴더로 옮긴 뒤 실행하면 이후 관리하기 편리합니다. 보안 경고가 표시되면 먼저 파일 출처와 경고 내용을 확인하고, ‘개인정보 보호 및 보안’에서 해당 앱의 열기 권한을 설정하세요.

처음 설정할 때 모든 트래픽 처리 방식을 한꺼번에 활성화하지 마세요. 먼저 구독을 가져오고 서버를 선택한 다음 시스템 프록시를 설정해 브라우저로 확인합니다. 브라우저에서는 접속되지만 다른 앱에서 실패한다면 앱이 별도 프록시를 사용하거나 시스템 설정을 무시하는지 확인하세요. 모든 요청이 실패하면 코어 로그와 네트워크 권한을 살펴보세요. 클라이언트를 종료하기 전에 더 이상 사용하지 않는 프록시 설정을 해제하면 다음 실행 때 진입점 상태가 어긋나는 일을 줄일 수 있습니다.

Android

v2rayNG · Xray / v2flyNG · V2Fly

Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 고려하세요. V2Fly 코어 설정이 필요하다면 v2flyNG를 살펴볼 수 있습니다. 비교적 최신 기기는 보통 arm64를 선택하며, 기기 아키텍처를 확인하기 어렵다면 범용 설치 패키지를 확인하세요. 두 앱은 별개의 클라이언트이므로 하나를 설치해도 다른 앱의 구독이나 라우팅 설정이 공유되지 않습니다.

설정을 가져온 뒤 처음 연결할 때는 시스템 VPN 권한을 허용해야 합니다. 연결 상태는 로컬 트래픽 처리가 시작됐다는 의미일 뿐, 원격 서버가 정상적으로 작동한다는 뜻은 아닙니다. 백그라운드에서 연결이 자주 끊기면 배터리 최적화, 백그라운드 실행, 절전 정책을 확인하세요. 앱별 라우팅을 사용할 때는 대상 앱이 처리 범위에 포함됐는지도 살펴보세요. 같은 종류의 VPN 연결 여러 개가 시스템 진입점을 두고 충돌하지 않도록 문제 해결 중에는 하나만 활성화하세요.

Linux

v2rayN · deb / rpm

Linux 데스크톱에서는 배포판의 패키지 관리 방식에 맞춰 deb 또는 rpm을 선택한 다음 프로세서 아키텍처가 x64인지 arm64인지 확인하세요. 패키지 형식이 같아도 배포판마다 의존성 환경은 다를 수 있으므로 설치 중 패키지 관리자가 표시하는 의존성 안내를 확인해야 합니다. 바탕 화면 바로 가기, 트레이 지원, 시스템 프록시 메뉴도 데스크톱 환경에 따라 다를 수 있습니다.

설치가 끝나면 먼저 직접 실행해 구독 업데이트와 브라우저 접속이 정상인지 확인한 뒤 로그인 시 자동 실행을 설정하세요. 그래픽 데스크톱의 시스템 프록시 설정은 보통 터미널 도구에 자동으로 적용되지 않으므로 터미널이나 개발 도구의 프록시 설정을 따로 확인해야 합니다. 창은 열렸지만 연결되지 않는다면 코어가 정상적으로 시작됐는지, 수신 포트를 사용할 수 있는지, 설정 디렉터리에 읽기·쓰기 권한이 있는지 먼저 살펴보세요. 원인을 확인하는 대신 실행 권한을 높이지 마세요.

지원 클라이언트 모두 보기 →세 가지 클라이언트의 사용 사례 비교 →

FIRST CONFIGURATION

구독 가져오기부터 연결 확인까지

처음 설정할 때는 먼저 확인 가능한 연결 하나를 만든 다음 사용자 지정 라우팅과 다른 트래픽 처리 방식을 추가하세요. 한 번에 한 항목씩만 변경하고 되돌릴 수 있는 설정을 남겨 두세요.

STEP 01 / IMPORT

구독을 가져와 서버 항목 확인

설정 제공자가 전달한 전체 구독 주소를 준비하세요. v2rayN의 구독 그룹 설정에서 새 그룹을 만들고 메모와 주소를 입력한 뒤 저장하고 업데이트합니다. 단일 공유 링크를 받은 경우에는 해당 링크의 가져오기 메뉴를 사용하세요. 단일 링크를 구독 주소로 잘못 입력하지 마세요. Android에서는 v2rayNG의 구독 설정에서 같은 작업을 진행하면 됩니다. 메뉴 이름은 현재 앱 화면에 따라 다를 수 있습니다.

업데이트가 끝나면 그룹에 예상한 설정이 나타났는지 확인한 뒤 항목 하나를 현재 서버로 선택하세요. 구독은 연결 설정을 전달할 뿐 서버 서비스 자체를 제공하지 않습니다. 무료 클라이언트와 구독 서비스는 별개입니다. 주소에 접속 정보가 포함될 수 있으므로 공개 댓글이나 스크린샷에 올리지 마세요. 그룹이 비어 있다면 업데이트 로그를 확인해 요청 실패인지, 응답을 인식하지 못한 것인지, 출처에 사용할 수 있는 항목이 없는 것인지 살펴보세요.

STEP 02 / ROUTE

라우팅을 선택하고 앱 트래픽 진입점 설정

데스크톱에서는 현재 네트워크에 맞는 라우팅 프리셋을 선택한 다음 시스템 프록시 자동 설정을 활성화하세요. 라우팅 프리셋은 코어에 들어온 요청을 어떤 아웃바운드로 보낼지 정하고, 시스템 프록시는 어떤 앱이 로컬 수신기로 요청을 전달할지 결정합니다. 서로 대신할 수 있는 설정이 아닙니다. 로컬 네트워크 기기에 접속해야 한다면 사설 주소 규칙을 확인해 로컬 요청이 프록시 아웃바운드로 잘못 전달되지 않도록 하세요.

처음에는 시스템 프록시를 따르는 브라우저로 확인하면 됩니다. 다른 트래픽 처리 방식까지 한꺼번에 활성화할 필요는 없습니다. Android에서는 VPN 권한을 허용하고 앱별 프록시 범위를 확인하세요. 브라우저 프록시 확장 프로그램, 다른 프록시 클라이언트, 네트워크 필터링 도구를 사용 중이라면 진입점이 충돌하는지 하나씩 살펴보세요. 활성 설정을 최소한으로 유지해 작동을 확인한 뒤 평소 설정을 차례로 복원하면 여러 모드를 동시에 바꾸는 것보다 차이를 찾기 쉽습니다.

STEP 03 / VERIFY

웹페이지, DNS 및 종료 상태 확인

연결한 다음 자주 사용하는 웹페이지를 열고, 직접 연결되어야 하는 사이트나 로컬 네트워크 서비스를 방문해 프록시 경로와 직접 연결 경로를 각각 확인하세요. 트레이 아이콘, 연결 버튼, 한 번의 테스트 결과만으로 모든 기능이 정상이라고 판단하지 마세요. 특정 도메인만 실패하면 해당 요청에 적용된 라우팅, 조회 서버, 조회 결과를 확인하세요. 모든 사이트에 접속할 수 없다면 시스템 프록시, 로컬 수신, 코어 시작 상태부터 점검하세요.

문제를 재현할 수 있는 앱, 도메인, 발생 시간을 기록하고 로그의 오류와 대조하세요. 앱 설정, 로컬 포트, 현재 서버, 라우팅, DNS 순서로 진입점에서 아웃바운드까지 확인합니다. 설정을 하나 바꿀 때마다 같은 테스트를 반복해야 결과를 비교할 수 있습니다. 사용을 마치면 시스템 프록시를 해제하거나 해당 트래픽 처리 방식을 끈 다음 클라이언트를 종료하세요. 종료 후 웹페이지가 열리지 않으면 시스템에 로컬 프록시 주소가 그대로 설정돼 있는지 먼저 확인하세요.

PROJECT V / CORE / CLIENT

Project V 생태계와 클라이언트 역할

클라이언트, 코어, 프로토콜 이름이 함께 등장하는 경우가 많지만 각각 담당하는 역할은 다릅니다. 이 세 계층의 관계를 이해하면 GUI에서 설정을 바꿔야 하는지, 해당 코어의 설정 문서를 확인해야 하는지 판단할 수 있습니다.

Project V, V2Fly 및 Xray

Project V는 프록시 통신과 네트워크 설정을 중심으로 형성된 오픈소스 프로젝트 생태계이며, V2Ray는 널리 사용되는 핵심 프로젝트입니다. V2Fly는 관련 커뮤니티의 유지보수를 이어 왔고, Xray는 이 기술 계보에서 발전해 독립적인 구현과 확장 기능을 제공하고 있습니다. 공통 개념도 있지만 지원 기능, 필드 의미, 업데이트 주기는 완전히 같지 않습니다. V2Ray를 다루는 가이드를 참고할 때도 예제가 어떤 코어를 대상으로 하는지 확인하세요. 이름이 비슷하다는 이유만으로 그대로 적용하면 안 됩니다.

VMess, VLESS, Trojan은 연결 프로토콜에 관한 개념이며 전송 방식과 보안 계층은 별도의 설정 항목입니다. 클라이언트에 프로토콜이 표시된다고 해서 모든 필드 조합이 작동하는 것은 아닙니다. 클라이언트에서 가져올 수 있는지, 코어가 지원하는지, 서버 설정과 일치하는지 각각 확인해야 합니다. 핸드셰이크나 설정 로드 오류를 해결할 때는 프로토콜 이름을 계속 바꾸기보다 기존 매개변수가 의미하는 바를 먼저 확인하세요.

세 가지 오픈소스 클라이언트의 차이

v2rayN은 데스크톱용 클라이언트로 구독, 서버, 라우팅, 시스템 프록시를 GUI에서 관리하며 Xray·sing-box 등의 코어와 연동할 수 있습니다. v2rayNG는 Android 기기용이며 Xray 코어로 연결을 처리합니다. v2flyNG도 Android용으로 V2Fly 코어를 사용하는 다른 선택지입니다. 세 클라이언트는 모두 오픈소스 프로젝트지만 같은 앱의 기기별 이름만 다른 것은 아닙니다. 화면 구성과 가져오기 지원, 백그라운드 동작이 서로 다릅니다.

클라이언트는 사용자의 설정을 코어가 이해할 수 있는 형태로 구성하고, 코어는 프로토콜 처리, 라우팅, 실제 연결을 담당합니다. sing-box에는 자체 설정 구조가 있으므로 Xray JSON을 그대로 설정으로 사용하면 안 됩니다. 클라이언트를 선택할 때는 운영체제와 현재 설정 요구를 먼저 확인한 뒤 인터페이스와 유지 관리 방식도 살펴보세요. 클라이언트를 자주 바꿔도 구독 출처의 만료나 서버 설정 불일치 문제는 해결되지 않습니다.

오픈소스 라이선스와 설정 출처

오픈소스는 프로젝트 코드가 해당 라이선스에 따라 공개된다는 뜻입니다. 사용, 수정, 재배포 시에는 각 라이선스 조건을 따라야 합니다. 클라이언트, 코어, 종속 항목은 서로 다른 라이선스를 사용할 수 있으므로 각 프로젝트에 포함된 라이선스 문서를 확인하세요. 코드가 공개돼 있다고 해서 배포 파일, 구독 출처, 네트워크 환경의 신뢰도가 모두 같거나 모든 설정이 현재 기기에 적합하다는 뜻은 아닙니다. 설치 출처와 설정 내용을 직접 확인해야 합니다.

세 클라이언트는 무료로 사용할 수 있지만 클라이언트 실행과 원격 서비스를 이용하는 것은 별개의 일입니다. 구독 주소에는 계정 식별 정보가 포함될 수 있고 서버 설정에는 인증 정보가 들어갈 수 있습니다. 문제 해결 로그를 공유하기 전에 구독 주소의 민감한 매개변수, 인증 필드, 개인 접속 기록을 삭제하세요. 문서의 설정 예시는 구조를 설명하기 위한 것으로, 서비스 제공자가 전달한 유효한 연결 설정을 대신할 수 없습니다.

커뮤니티 유지보수와 업데이트 순서

클라이언트와 코어는 각 커뮤니티에서 별도로 유지보수하므로 인터페이스, 프로토콜 지원, 설정 호환성이 각각 달라질 수 있습니다. 업데이트 전에 변경 사항을 읽고 구독 그룹, 사용자 지정 라우팅, 필요한 개인 설정을 백업하세요. 업데이트 후에는 클라이언트 실행, 코어 설정 로드, 구독 업데이트, 자주 사용하는 웹페이지와 로컬 네트워크 접속을 차례로 확인합니다. 소프트웨어 업데이트, 구독 새로 고침, 라우팅 변경을 한 번에 진행하면 문제가 생겼을 때 원인을 구분하기 어렵습니다.

현재 설정이 안정적으로 작동한다면 이름이나 출시일만 비교하지 말고 실제 필요에 따라 업데이트 일정을 정하세요. 가이드의 메뉴와 화면이 다르면 설정 대상에 맞는 기능을 찾은 뒤 클라이언트와 코어 문서를 확인하세요. 이 사이트는 다운로드 선택과 한국어 설정 안내를 제공하며 구독 계정이나 원격 서버는 제공하지 않습니다. 연결 가능 여부는 로컬 네트워크, 서버 상태, 양쪽 설정의 일치 여부에 따라 달라집니다.

v2rayN·v2rayNG·v2flyNG 비교 리뷰 보기 →

CONFIGURATION NOTES

최신 설정 및 문제 해결 글

구체적인 증상에 맞춰 문서를 확인하세요. 먼저 요청이 어떤 진입점을 거치는지 확인한 다음 DNS 조회, 규칙, 아웃바운드를 차례로 점검하면 단일 오류를 막연히 클라이언트 문제로 돌리지 않을 수 있습니다.

고급 설정

V2Ray DNS 설정 가이드: 중국 본토·해외 분리 조회와 DNS 오염 방지

V2Ray dns 모듈의 servers, domains, expectIPs 작성법을 설명하고, 중국 본토 도메인은 로컬 DNS로, 해외 도메인은 원격 DNS로 조회하는 분리 설정과 DNS 오염 방지 방법을 안내합니다.

‘도메인을 어떤 DNS로 조회할지’와 ‘연결을 어느 아웃바운드로 보낼지’를 구분하세요. 도메인 규칙, 조회 결과 필터링, IP 라우팅은 서로 다른 단계입니다. 설정을 변경하기 전에 현재 DNS 경로를 기록하고 같은 도메인으로 다시 테스트하세요. DNS 서버만 바꾸고 실제 요청 경로는 그대로인 상황을 피할 수 있습니다.

글 읽기 →
문제 해결

v2rayN 연결됨으로 표시되지만 웹페이지가 열리지 않을 때: 단계별 점검표

프록시를 켰는데 웹페이지가 열리지 않는다면 시스템 프록시 상태, 포트 충돌, 서버 사용 가능 여부, 시간 동기화, 라우팅 모드, DNS 순서로 확인해 원인을 찾아보세요.

연결 아이콘은 일부 로컬 상태만 보여 줍니다. 이 글에서는 앱이 요청을 클라이언트로 전달하는지부터 시작해 수신, 원격 연결, DNS 조회 문제를 차례로 점검하고 각 단계에서 확인할 결과를 설명합니다. 같은 테스트 대상을 계속 사용하면 설정 변경이 실제로 적용됐는지 더 분명하게 판단할 수 있습니다.

글 읽기 →
고급 설정

V2Ray 설정 파일 JSON 구조 해설: inbounds, outbounds, routing의 역할

V2Ray 설정 JSON을 항목별로 살펴봅니다. log, 로컬 수신을 담당하는 inbounds, 아웃바운드와 freedom/blackhole, routing 규칙의 매칭 순서를 비교 가능한 예시와 함께 설명합니다.

GUI 클라이언트를 사용하면서 생성되는 설정을 더 깊이 이해하고 싶은 사용자에게 적합합니다. 먼저 인바운드 수신, 라우팅 매칭, 아웃바운드 처리의 전체 관계를 파악한 뒤 각 필드를 살펴보세요. 특히 tag 참조와 규칙 순서에 주의해야 문법상 유효하지만 예상한 아웃바운드에 매칭되지 않는 문제를 피할 수 있습니다.

글 읽기 →

글 전체 보기 →