운영체제에 맞는 클라이언트를 선택하고 설치 및 설정, 구독 가져오기, 라우팅 규칙의 메뉴 위치와 진행 순서를 확인하세요.
v2rayN 사용 가이드
먼저 서버 하나가 정상적으로 연결되는지 확인한 뒤 라우팅과 TUN을 설정하세요. 아래 표는 데스크톱 인터페이스를 기준으로 합니다. 버전에 따라 메뉴 이름이 다를 수 있으니 현재 화면과 로그를 함께 확인하세요.
| 설정 항목 | 설명 | v2rayN 데스크톱 |
|---|---|---|
압축 해제한 폴더 → v2rayN.exe 실행 | 압축 파일은 쓰기 권한이 있는 폴더에 완전히 풀고 해당 폴더에서 프로그램을 실행하세요. 실행 파일만 압축 파일 밖으로 꺼내거나 압축 프로그램에서 바로 실행하면 함께 제공되는 코어, 종속 파일, 데이터 폴더를 제대로 읽지 못할 수 있습니다. | 압축 해제한 폴더에서 실행 |
설정 → 매개변수 설정 → Core 기본 설정 | 우선 기본 리스닝 설정을 유지하고 코어가 실행되는지 확인한 다음, 사용할 수 있는 서버를 가져오세요. 로그에 포트 충돌이 표시되면 기존 프록시 프로그램을 확인한 뒤 포트를 변경하세요. 종속성 오류가 발생하면 설치 패키지의 요구 사항에 맞춰 실행 환경을 준비하세요. | 인터페이스와 코어를 따로 확인 |
| 설정 항목 | 설명 | v2rayN 데스크톱 |
|---|---|---|
구독 그룹 → 구독 그룹 설정 | 구독 출처마다 별도의 그룹을 만들고 알아보기 쉬운 메모와 전체 구독 주소를 입력하세요. 그룹은 서버를 정리하는 기능이며 연결을 의미하지 않습니다. 저장한 뒤 구독을 업데이트하고, 목록에 표시된 서버 중 사용할 항목을 선택해야 합니다. | 출처별로 그룹 관리 |
구독 그룹 → 구독 모두 업데이트 | 업데이트하면 구독 출처의 내용에 따라 목록이 갱신되며, 직접 수정한 항목은 덮어써질 수 있습니다. 업데이트에 실패하면 먼저 로그를 확인해 네트워크 요청 오류인지 내용 파싱 오류인지 구분하고, 구독 주소가 만료되지 않았는지 살펴보세요. 원인을 파악하기 전에 그룹을 반복해서 삭제하면 단서를 잃을 수 있습니다. | 로그에서 업데이트 결과 확인 |
| 설정 항목 | 설명 | v2rayN 데스크톱 |
|---|---|---|
시스템 프록시 → 시스템 프록시 자동 설정 | 시스템 프록시를 클라이언트의 로컬 리스닝 주소로 설정하면 시스템 프록시 설정을 따르는 앱에서 사용할 수 있습니다. 서버를 선택하고 기능을 켠 뒤 브라우저에서 요청을 보내세요. 화면에 실행 중이라고 표시되어도 서비스가 시작된 것일 뿐, 앱이 실제로 연결됐다는 뜻은 아닙니다. | 브라우저로 먼저 확인하기 좋음 |
시스템 프록시 → 시스템 프록시 해제 | 사용을 마쳤다면 시스템 프록시를 해제해 프로그램을 종료한 뒤에도 앱이 로컬 포트에 요청을 보내는 일을 방지하세요. 프록시를 수동으로 입력한 앱은 설정을 별도로 복구해야 합니다. 시스템 프록시를 따르지 않는 앱은 서버를 모두 바꾸기보다 앱 자체의 네트워크 설정을 확인하세요. | 종료 전에 남은 설정 확인 |
| 설정 항목 | 설명 | v2rayN 데스크톱 |
|---|---|---|
라우팅 설정 → 중국 본토 우회(Whitelist) | 라우팅은 코어에 전달된 요청이 어느 경로로 나갈지 결정하며, 시스템 프록시와는 다른 설정 단계입니다. 먼저 기본 제공 규칙을 선택해 동작을 확인한 다음 대상 도메인에 맞게 조정하세요. 규칙 이름은 요약일 뿐이며 실제 경로는 일치 조건과 규칙 순서에 따라 달라집니다. | 기본 제공 규칙으로 시작 |
설정 → 라우팅 설정 | 사용자 지정 규칙을 추가하기 전에 현재 설정을 저장하고, 대상 트래픽을 직접 연결할지 프록시로 보낼지 확인하세요. 도메인 규칙과 주소 규칙의 결과가 다를 수 있으므로 문제를 해결할 때는 도메인 해석 방식도 함께 살펴보세요. 로그에서 규칙 적용 여부를 파악할 수 있도록 한 번에 한 항목씩 변경하는 것이 좋습니다. | 규칙과 이름 해석을 함께 확인 |
| 설정 항목 | 설명 | v2rayN 데스크톱 |
|---|---|---|
메인 화면 → TUN 사용 | TUN은 가상 네트워크 인터페이스를 통해 트래픽을 처리하며 시스템 프록시를 따르지 않는 일부 앱에 사용할 수 있습니다. 켜기 전에 일반 프록시가 작동하는지 확인하고, 시스템 안내에 따라 필요한 권한을 허용하세요. 사용 가능 여부는 함께 제공되는 구성 요소, 시스템 환경, 현재 설정에 따라 달라집니다. | 기본 연결을 확인한 뒤 사용 |
설정 → 매개변수 설정 → TUN 모드 설정 | 다른 가상 네트워크 어댑터나 네트워크 도구와 함께 실행하면 라우팅이나 도메인 이름 해석이 충돌할 수 있습니다. 인터넷 연결이 끊기면 먼저 TUN을 끄고 비교한 다음 이름 해석, 인터페이스, 권한을 하나씩 확인하세요. 문제 원인을 찾기 위해 모든 트래픽 처리 기능을 한꺼번에 켜는 것은 피하세요. | 지원 여부는 현재 빌드 기준 |
처음 설정할 때 모든 옵션을 한꺼번에 바꿀 필요는 없습니다. ‘코어 실행 → 서버 가져오기 → 사용할 서버 선택 → 시스템 프록시 설정 → 요청 보내기’ 순으로 확인하면 데이터 가져오기, 로컬 리스닝, 원격 연결 중 어느 단계에서 문제가 생겼는지 구분하기 쉽습니다. 서버 테스트 결과는 해당 테스트 조건에서만 유효하며 실제 앱 접속을 대신할 수 없습니다.
v2rayN 설치 및 설정 전체 과정 보기 →클라이언트와 운영체제 선택
데스크톱에서는 v2rayN, Android 기기에서는 v2rayNG를 먼저 확인하세요. 다운로드하기 전에 운영체제, 프로세서 아키텍처, 설치 파일 형식을 확인해야 합니다. 같은 클라이언트라도 설치 패키지를 서로 바꿔 사용할 수 있는 것은 아닙니다. 다운로드 페이지에서 제공하는 링크와 시스템 요구 사항을 확인하세요.
우선 v2rayN 데스크톱 버전을 사용하세요. 기존 클래식 인터페이스에 익숙하다면 WPF 버전도 비교해 볼 수 있습니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고 WPF 버전은 이 운영체제용입니다. 메뉴 구성과 실행에 필요한 항목이 다를 수 있으므로 가이드의 화면이 다르면 먼저 인터페이스 종류를 확인한 뒤 같은 이름의 설정을 찾으세요.
압축 파일을 쓰기 권한이 있는 위치에 완전히 풀어야 합니다. 처음 실행할 때 종속성 안내가 표시되면 설치 패키지 설명에 따라 필요한 환경을 준비하세요. 다른 폴더에서 실행 파일을 가져와 조합하지 마세요. 업그레이드 전에는 설정을 저장하고 기존 프로그램을 종료한 뒤 파일을 교체해야 두 인스턴스가 리스닝 포트를 두고 충돌하지 않습니다.
다운로드 Windows 클라이언트v2rayN 데스크톱 버전을 사용하고 칩에 맞는 Apple Silicon 또는 Intel 설치 패키지를 선택하세요. ‘이 Mac에 관하여’에서 칩 정보를 확인한 다음 다운로드 항목과 대조할 수 있습니다. 컴퓨터의 외형이나 구입 연도만으로 아키텍처를 판단하지 마세요. 인터페이스는 데스크톱 가이드와 비슷하지만 권한 요청은 실제 시스템 안내를 따르세요.
설치 후 서버 정보를 가져와 코어가 실행되고 브라우저 요청도 정상적으로 처리되는지 확인하세요. TUN이 필요하다면 관련 권한을 별도로 설정하세요. 시스템 프록시, 앱 자체 프록시, 가상 네트워크 인터페이스를 통한 트래픽 처리는 서로 다른 단계입니다. 문제를 해결할 때 현재 어떤 연결 방식을 쓰는지 분명히 해 여러 방식이 서로 간섭하지 않도록 하세요.
다운로드 macOS 클라이언트우선 Xray 코어를 사용하는 v2rayNG를 선택하세요. V2Fly 코어 환경이 필요하다면 v2flyNG를 살펴보세요. 최근 출시된 대부분의 스마트폰에는 arm64 패키지가 적합합니다. 아키텍처를 알 수 없다면 범용 패키지 안내를 확인하세요. 범용 패키지도 모든 시스템 호환성 문제를 해결하는 것은 아니므로 설치 전에 기기 요구 사항을 확인해야 합니다.
처음 연결할 때 시스템의 VPN 연결 권한을 허용해야 합니다. 구독을 가져온 뒤에도 서버를 선택하고 연결을 시작해야 합니다. 목록에 항목이 표시된다고 해서 서비스가 실행 중인 것은 아닙니다. 백그라운드로 전환한 뒤 연결이 끊기면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 정상적인 구독을 먼저 삭제하고 다시 만들 필요는 없습니다.
다운로드 Android 클라이언트v2rayN 데스크톱 버전을 사용하고 배포판의 패키지 관리 방식에 맞춰 deb 또는 rpm을 선택한 다음 x64와 arm64 아키텍처를 확인하세요. 패키지 형식은 설치 관리 방식을, 아키텍처는 프로세서에서 프로그램을 실행할 수 있는지를 결정하므로 둘 다 일치해야 합니다. 파일 확장자만 바꿔서는 설치 형식을 변환할 수 없습니다.
설치 후 데스크톱 세션에서 일반 프록시 연결이 되는지 먼저 확인한 다음 TUN에 필요한 권한을 검토하세요. 일부 앱은 데스크톱 환경의 프록시 설정을 자동으로 읽지 않으므로 앱에서 연결 주소를 직접 지정해야 할 수 있습니다. 특정 앱만 접속할 수 없다면 시스템 전체의 라우팅을 바꾸기 전에 해당 앱이 프록시 설정을 가져오는 방식을 확인하세요.
다운로드 Linux 클라이언트클라이언트는 설정을 읽고 연결을 만들며, 구독 정보는 해당 구독 서비스에서 제공합니다. 클라이언트를 다운로드하고 설치해도 서버가 자동으로 생성되거나 만료된 구독이 복구되지는 않습니다. 구독이 이미 있다면 원래 주소를 보관하고 사용 가능한 상태인지 확인하세요. 서버 공유 링크만 있다면 구독 주소 입력란이 아니라 서버 가져오기 기능을 사용해야 합니다.
전체 클라이언트 보기 →Project V · V2Fly · Xray
코어, 클라이언트, 구독의 차이를 먼저 파악한 뒤 필요한 항목을 업데이트하거나 수정하세요. 이름이 비슷해도 기능이 완전히 같지는 않으며, 설정을 가져올 수 있다고 해서 연결에 필요한 조건이 모두 갖춰진 것도 아닙니다.
Project V는 V2Ray 생태계를 이해하는 출발점입니다. 생태계의 프록시 코어는 프로토콜 처리, 전송, 라우팅, 연결 설정을 담당합니다. V2Fly 커뮤니티는 V2Ray 관련 프로젝트를 이어서 관리하고 있으며, Xray는 관련 기술을 바탕으로 자체 코어와 기능을 발전시켜 왔습니다. 일상적인 대화에서는 전체 생태계를 V2Ray라고 부르기도 하지만, 특정 기능의 지원 여부는 클라이언트가 실제로 사용하는 코어와 해당 코어의 구현에 따라 달라집니다.
VMess, VLESS, Trojan은 프로토콜 이름이고 WebSocket, gRPC 등은 전송 방식입니다. TLS와 REALITY는 연결 보안 및 핸드셰이크 설정과 관련이 있습니다. 각 용어는 서로 다른 계층에 해당하므로 하나의 용어만 보고 설정이 완전한지 판단할 수 없습니다. 연결 매개변수는 서버 설정과 일치해야 합니다. 직접 수정할 때는 프로토콜, 전송 방식, 보안 옵션 중 무엇을 바꾸는지 확인하고 서로 다른 가이드의 설정 항목을 무작정 조합하지 마세요.
v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 그래픽 클라이언트입니다. 그래픽 인터페이스에서 서버, 구독 주소, 자주 쓰는 옵션을 관리하면 코어가 읽을 수 있는 설정으로 변환됩니다. 세 프로그램은 같은 앱의 테마만 다른 것이 아닙니다. v2rayN은 데스크톱 환경용이며, v2rayNG는 주로 Xray 코어를 사용하는 Android 설정 인터페이스를 제공합니다. v2flyNG는 V2Fly 코어를 사용하는 Android 대안입니다.
이러한 계층 구분은 문제 해결 순서에도 영향을 줍니다. 창이 열리지 않으면 설치와 실행 환경을 먼저 확인하세요. 창은 열리지만 코어가 시작되지 않으면 로그, 리스닝 포트, 설정 생성 결과를 살펴보세요. 코어는 실행되지만 특정 서버에 연결되지 않는다면 원격 서버 매개변수와 네트워크 상태를 확인해야 합니다. 인터페이스가 실행된 것을 연결 성공으로 여기면 실제 문제 지점을 놓치기 쉽습니다. 코어를 바꿔 설정을 이전할 때는 대상 클라이언트가 프로토콜과 고급 옵션을 모두 지원하는지도 확인하세요.
오픈 소스 소프트웨어는 해당 라이선스에 따라 코드를 공개하며, 라이선스에 명시된 조건을 지켜 사용·수정·배포할 수 있습니다. 생태계의 프로젝트마다 라이선스가 다를 수 있습니다. 예를 들어 V2Fly의 V2Ray 코어와 Xray 코어는 MPL 2.0을 사용합니다. 클라이언트 프로젝트에는 각각 별도의 라이선스가 있으므로 특정 코어의 라이선스를 모든 인터페이스 프로그램, 종속 파일, 포함 리소스에 적용해서는 안 됩니다. 재배포하거나 수정하려면 관련 프로젝트의 라이선스 파일을 각각 확인하세요.
오픈 소스 여부와 구독 서비스 품질은 별개의 문제입니다. 구독 주소, 서버 인증 정보, 로컬 설정은 안전하게 보관하세요. 화면을 공유할 때는 전체 구독 링크를 가리고, 내보낸 설정 파일도 공개적으로 전송하지 않는 것이 좋습니다. 구독 변환 서비스를 사용하면 서비스 제공자가 전체 설정을 읽을 수 있다는 점을 이해해야 합니다. 먼저 클라이언트가 원본 형식을 직접 가져올 수 있는지 확인하고, 꼭 필요한 경우에만 처리 범위를 검토해 변환하세요. 형식 변환을 가져오기 실패의 첫 해결책으로 삼지 마세요.
클라이언트, 코어, 구독, 라우팅 리소스 업데이트는 서로 다른 문제를 해결합니다. 클라이언트 업데이트는 주로 인터페이스와 설정 생성에 영향을 주고, 코어 업데이트는 프로토콜 구현과 실행 동작에 영향을 줍니다. 구독 업데이트는 출처에서 제공하는 서버 목록을 새로 고치며, 규칙과 도메인 리소스 업데이트는 라우팅 결과를 바꿀 수 있습니다. 문제가 생기면 최근 변경 사항을 먼저 기록하세요. 모든 구성 요소를 동시에 업데이트하면 어떤 변경이 동작에 영향을 줬는지 파악하기 어렵습니다.
설정을 저장하는 것부터 일상적인 관리를 시작할 수 있습니다. 업그레이드 전에 현재 시스템 프록시, 리스닝 포트, 라우팅 선택을 기록하세요. 백업에 구독 주소나 인증 정보가 포함된다면 안전한 위치에 보관해야 합니다. 업그레이드 후에는 기존 설정으로 코어가 시작되는지 확인한 뒤 실제 요청을 보내고, 마지막으로 사용자 지정 라우팅을 점검하세요. 특정 앱에서만 문제가 생기면 해당 앱과 브라우저의 프록시 연결 방식을 비교하세요. 모든 요청이 실패하면 로컬 서비스와 현재 서버를 확인하세요.
시스템 프록시는 ‘어떤 앱이 요청을 클라이언트에 전달할지’를 정하고, 라우팅 규칙은 ‘코어에 들어온 요청을 어떤 경로로 보낼지’를 정합니다. TUN은 가상 네트워크 인터페이스로 트래픽을 처리합니다. 세 개념은 같은 가이드에 함께 나오는 경우가 많지만 서로 대체할 수는 없습니다. 시스템 프록시를 켰는데도 앱이 직접 연결된다면 해당 앱이 시스템 설정을 읽지 않는 것일 수 있습니다. TUN을 켠 뒤 접속에 문제가 생긴 경우에는 도메인 이름 해석, 네트워크 어댑터 라우팅, 다른 네트워크 도구가 원인일 수 있습니다.
먼저 시스템 프록시로 기본 연결을 확인하고, 필요에 따라 라우팅을 조정한 다음 TUN 사용 여부를 검토하세요. 설정을 변경할 때마다 같은 앱으로 같은 대상에 접속하고 해당 시점의 로그를 확인하세요. 그래야 의미 있는 비교가 가능합니다. 로그에 서버 정보가 포함될 수 있으므로 도움을 요청하기 전에 민감한 내용을 지우세요. 문제 유형, 발생 순서, 설정 환경은 남겨 두면 이어서 원인을 찾는 데 도움이 됩니다.
설치 및 문제 해결 문서
구체적인 증상에 맞는 문서를 선택하세요. 설정을 반복해서 가져오는 것보다 작업 전후의 변화, 현재 인터페이스 종류, 로그에 표시된 오류를 기록하는 편이 원인을 찾는 데 도움이 됩니다.
데스크톱 버전과 WPF 버전 선택부터 압축 해제 위치, 런타임 종속성, 첫 실행, 시스템 프록시 설정까지 단계별로 안내합니다. Windows에서 자주 발생하는 오류와 해결 방법도 정리했습니다.
설치 단계 보기 →시작할 때 포트가 사용 중이라는 메시지가 표시되나요? 시스템 명령으로 해당 포트를 사용하는 프로세스를 찾는 방법과 매개변수 설정에서 로컬 SOCKS 및 HTTP 리스닝 포트를 변경하는 절차, 변경 후 함께 조정해야 할 설정을 안내합니다.
포트 문제 해결 단계 보기 →구독 링크 만료, 잘못된 응답 형식, 업데이트 요청에 사용된 프록시, 네트워크 차단 등이 파싱 실패의 원인일 수 있습니다. 이 글에서는 쉬운 항목부터 차례로 확인할 수 있는 문제 해결 절차를 안내합니다.
구독 확인 목록 보기 →