설치 패키지 선택
먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 해당 다운로드 항목으로 이동하세요. 데스크톱에서는 v2rayN을 선택하고, Android에서는 v2rayNG를 먼저 살펴보세요. V2Fly 커널이 필요하다면 v2flyNG를 확인하세요. 설치 패키지에는 구독 주소가 포함되지 않으므로 설치 후 사용할 설정을 가져와야 합니다.
v2rayN 데스크톱 버전 또는 클래식 WPF 버전을 선택하세요. 데스크톱 버전은 크로스 플랫폼 UI 프레임워크를 사용하고, WPF 버전은 Windows용입니다. 화면에 따라 버튼 위치는 다를 수 있지만 구독 관리와 프록시 설정의 기본 과정은 비슷합니다.
먼저 시스템이 x64인지 확인하고 다운로드 페이지의 실행 환경 안내를 읽으세요. 설치 후 구독을 한 번 업데이트하고 연결을 확인하세요. 처음부터 DNS, 라우팅, Tun을 모두 바꾸면 설치 문제와 설정 문제를 구분하기 어렵습니다.
다운로드 페이지로 이동v2rayN의 Apple Silicon 또는 Intel 설치 패키지를 선택하세요. ‘이 Mac에 관하여’를 열어 칩 이름 또는 Intel 프로세서로 표시되는지 확인한 뒤 해당 아키텍처를 고르세요. 컴퓨터 외관만으로 판단하지 마세요.
화면 안내에 따라 앱을 설치하고 처음 실행하세요. 시스템 프록시가 적용되는지는 앱이 시스템 프록시 설정을 읽는지에 따라 달라집니다. 브라우저는 연결되지만 다른 프로그램은 연결되지 않는다면 먼저 해당 프로그램의 네트워크 설정을 확인한 뒤 가상 네트워크 인터페이스를 통한 트래픽 처리가 필요한지 살펴보세요.
다운로드 페이지로 이동먼저 Xray 커널을 사용하는 v2rayNG를 선택하세요. 비교적 최신 스마트폰은 대부분 arm64 패키지를 사용할 수 있습니다. 기기의 아키텍처를 모르겠다면 시스템 정보를 확인하거나 범용 버전을 선택하세요. V2Fly 커널이 필요하다면 다운로드 페이지에서 대안인 v2flyNG를 확인할 수 있습니다.
구독을 가져온 뒤 설정 하나를 선택하고 연결을 누른 다음 시스템의 VPN 권한 요청을 승인하세요. 이 권한은 클라이언트가 기기의 트래픽을 처리하는 로컬 통로를 만들도록 허용하는 것으로, 원격 설정이 정상 작동한다는 뜻은 아닙니다. 백그라운드에서 연결이 끊기면 배터리 절전 제한과 백그라운드 실행 권한을 확인하세요.
다운로드 페이지로 이동v2rayN의 deb 또는 rpm 패키지를 선택하고 x64·arm64 아키텍처를 맞추세요. Debian·Ubuntu 계열은 보통 deb를, Fedora 등은 보통 rpm을 사용합니다. 정확한 패키지 형식은 배포판의 패키지 관리 방식에 따라 확인하세요.
설치 후 데스크톱 환경에서 GUI를 실행해 설정을 불러올 수 있는지 확인하세요. 시스템 프록시를 읽는 방식은 데스크톱 환경마다 다를 수 있으며, 터미널 프로그램은 프록시를 별도로 설정해야 할 수도 있습니다. Tun을 켜기 전에 권한과 기존 네트워크 서비스와의 충돌 여부를 확인하세요.
다운로드 페이지로 이동설정을 하나씩 완료
순서대로 구독 주소, 규칙, 트래픽 처리 범위를 설정하세요. 아래 화면은 일반적인 설정 항목을 보여주는 예시이며 현재 기기의 설정 상태를 나타내지는 않습니다. 실제 메뉴는 설치된 클라이언트 화면을 기준으로 확인하세요.
‘구독 그룹 설정’을 열고 구독 주소와 알아보기 쉬운 메모를 추가한 뒤 저장하고 구독을 업데이트하세요. 사용할 연결이 아직 없다면 우선 ‘프록시 사용 안 함’ 업데이트를 시도할 수 있습니다. 주소에 접속할 때 프록시가 필요한 경우에는 이미 사용할 수 있는 연결로 업데이트하세요. v2rayNG도 먼저 구독 그룹을 추가한 뒤 구독을 업데이트해야 합니다. 주소를 붙여넣기만 해서는 설정이 자동으로 생성되지 않습니다. 업데이트 후 그룹에 항목이 표시되는지 확인하세요. 실패하면 링크의 유효 기간과 응답 내용을 먼저 확인하고 같은 주소를 반복해서 추가하지 마세요.
라우팅 설정을 열고 접속 목적에 맞는 사전 설정을 선택한 뒤 규칙의 우선순위를 확인하세요. 라우팅은 커널에 들어온 트래픽을 직접 연결, 프록시 또는 차단 중 어디로 보낼지 결정하며 모든 앱을 자동으로 클라이언트에 연결하지는 않습니다. ‘중국 본토 우회’는 도메인과 주소 규칙을 기준으로 동작하며 웹사이트의 표시 언어를 기준으로 판단하지 않습니다. 사용자 지정 규칙을 추가할 때는 대상 도메인과 아웃바운드를 명확히 지정하고, 범위가 넓은 규칙이 뒤의 항목을 가리지 않도록 앞쪽에 배치하지 마세요. 특정 사이트가 잘못된 경로로 연결되면 우선 적용된 규칙과 DNS 조회 결과를 확인한 뒤 사전 설정을 조정하세요.
사용 가능한 설정을 선택한 뒤 ‘시스템 프록시 자동 설정’을 사용하면 시스템 설정을 읽는 앱이 로컬 프록시로 연결됩니다. 이는 앱이 프록시에 연결되는 경로를 바꾸는 것으로 모든 트래픽을 프록시 아웃바운드로 보내는 설정은 아닙니다. 최종 경로는 라우팅 규칙이 결정합니다. ‘시스템 프록시 해제’는 시스템 프록시 설정을 초기화하고, ‘시스템 프록시 변경 안 함’은 현재 설정을 유지합니다. 자체 프록시 옵션을 사용하거나 직접 연결하는 프로그램도 있습니다. 브라우저는 접속되지만 다른 프로그램이 실패한다면 해당 프로그램이 시스템 프록시를 읽는지 확인한 뒤 Tun을 사용할지 판단하세요.
DNS를 바꾸기 전에 도메인 조회 실패인지 원격 연결 실패인지 구분하세요. 직접 연결 도메인과 프록시 도메인은 서로 다른 조회 경로를 사용할 수 있으며, DNS 서버 자체도 예상한 아웃바운드로 접속할 수 있어야 합니다. 브라우저의 보안 DNS, 시스템 DNS, 커널 DNS가 같은 설정을 사용한다고 보장할 수 없으므로 주소 하나만 바꿔서는 해결되지 않을 수 있습니다. 변경 전 기존 설정을 기록하고 테스트할 때는 같은 사이트를 대상으로 고정한 뒤 로그에서 조회 및 연결 단계를 확인하세요. 자세한 설정은 사용하는 커널, 라우팅 규칙, Tun 사용 여부를 함께 고려해야 합니다. 다른 기기의 설정을 그대로 복사하지 마세요.
대상 프로그램이 시스템 프록시를 사용하지 않을 때 Tun 활성화를 고려하세요. Tun은 가상 네트워크 인터페이스를 통해 조건에 맞는 트래픽을 처리하며 추가 권한이 필요한 경우가 많습니다. 처리 범위는 제외 규칙과 네트워크 환경의 영향을 받으므로 모든 연결이 프록시를 통과하는 것은 아닙니다. 먼저 일반 프록시 모드에서 설정이 작동하는지 확인한 뒤 Tun을 켜면 문제 원인을 찾기 쉽습니다. 활성화 후 로컬 네트워크 접속에 문제가 생기면 라우팅, DNS, 다른 VPN 서비스와의 충돌을 확인하세요. 종료할 때 가상 네트워크 인터페이스와 시스템 네트워크 설정이 복구됐는지도 확인해야 합니다.
클라이언트와 커널 구분하기
각 구성 요소의 역할을 먼저 이해한 뒤 설정 방법을 선택하세요. UI 이름, 커널 기능, 구독 형식은 서로 다른 문제입니다. 클라이언트 이름만으로 특정 프로토콜이나 전송 방식 조합의 지원 여부를 판단할 수 없습니다.
Project V는 프록시 도구와 관련 기술을 아우르는 오픈 소스 생태계이지 하나의 통합 GUI 앱이 아닙니다. V2Ray는 그 안의 주요 프로젝트로, 설정에는 인바운드, 아웃바운드, 라우팅 등이 포함됩니다. 일상적으로 사용하는 v2rayN·v2rayNG·v2flyNG는 설정 관리와 연결 작업을 GUI에서 처리하는 클라이언트입니다. 전체 설정을 직접 작성할 필요는 없지만 ‘클라이언트를 설치한 것’과 ‘사용 가능한 연결 매개변수를 보유한 것’은 다르다는 점을 알아두세요.
커뮤니티가 발전하면서 V2Fly는 V2Ray를 이어 관리했고, Xray는 관련 커널의 분기와 기능 발전 경로를 형성했습니다. 두 프로젝트는 기술적 배경을 공유하지만 기능 세부 사항과 설정 옵션이 항상 같지는 않습니다. 따라서 가이드에서 특정 필드를 보더라도 V2Ray라는 이름만 보고 그대로 입력하지 말고 실제 실행 중인 커널에 맞춰 확인하세요.
커널은 실제 프로토콜 처리와 연결을 담당합니다. v2rayNG는 Xray 커널을 사용하고 v2flyNG는 V2Fly 커널을 사용합니다. v2rayN은 배포 패키지와 설정에서 지원하는 커널을 선택할 수 있습니다. 특정 기능이 필요한 경우 클라이언트의 커널 설정과 로그를 확인한 뒤 연결 설정의 요구사항과 대조하세요. 공유 링크를 가져올 수 있다고 해서 모든 전송 매개변수가 실행 조건을 충족하는 것은 아닙니다.
VMess·VLESS·Trojan은 자주 사용되는 프로토콜 이름이며 REALITY는 보안 핸드셰이크 방식과 관련되어 있습니다. 이들을 완전히 같은 종류의 선택지로 보면 안 됩니다. 정상 작동하는 설정에는 전송 방식, 서버 이름, 인증 매개변수도 포함될 수 있습니다. 가져온 뒤에는 제공된 값을 그대로 유지하세요. 서비스에서 요구한다는 사실을 확인한 경우에만 관련 옵션을 변경해야 프로토콜 인식 성공을 전체 호환으로 오해하지 않습니다.
v2rayN·v2rayNG·v2flyNG는 모두 오픈 소스 GUI 클라이언트이며 소스 코드는 각 프로젝트의 라이선스에 따라 제공됩니다. GUI, 연결 커널, 포함된 구성 요소에 서로 다른 라이선스가 적용될 수 있으므로 배포하거나 수정할 때는 해당 라이선스 문서를 각각 확인하세요. 오픈 소스는 코드 사용과 협업 방식에 관한 설명이지, 구독 서비스나 원격 회선, 네트워크 리소스까지 클라이언트 프로젝트가 제공한다는 뜻은 아닙니다.
용도에 따라 선택하세요. 데스크톱에서 구독과 시스템 프록시를 관리하려면 v2rayN을 먼저 살펴보세요. Android에서 Xray 관련 설정을 사용한다면 v2rayNG를, V2Fly 커널이 필요하다면 v2flyNG를 확인하세요. 세 클라이언트는 비슷한 설정 개념을 공유하지만 메뉴와 백업 형식이 완전히 같지는 않습니다. 기기를 옮길 때는 구독 주소를 공통으로 사용하고 UI 설정과 라우팅 규칙은 각 앱에서 따로 확인하세요. 한 앱의 설정 전체를 다른 앱에 그대로 덮어쓰지 마세요.
클라이언트 업데이트는 앱을 교체하는 작업이고, 구독 업데이트는 연결 설정을 다시 가져오는 작업입니다. 두 업데이트는 해결하는 문제가 다릅니다. 구독 내용이 바뀌었을 때 설치 패키지를 다시 받아도 목록은 갱신되지 않습니다. 앱 기능이나 호환성이 바뀌었을 때 구독만 업데이트해도 커널은 업그레이드되지 않습니다. 먼저 업데이트할 대상을 확인하고 해당 메뉴를 이용하면 기존 설정을 실수로 지우는 일을 줄일 수 있습니다.
업그레이드 전에 그룹 정보, 사용자 지정 라우팅, 필요한 설정을 백업하고 현재 커널과 트래픽 처리 모드를 기록하세요. 업그레이드 후에는 기존 설정으로 연결을 다시 확인한 뒤 사용자 지정 규칙, 백그라운드 실행, 시스템 프록시 상태를 점검하세요. 화면이 달라졌다면 이전 스크린샷의 좌표에 의존하지 말고 설정의 의미를 기준으로 메뉴를 찾으세요. 다운로드 페이지에서 설치 패키지를 선택할 수 있으며 홈페이지에는 특정 버전을 고정해 표시하지 않습니다. 클라이언트 선택과 버전 정보를 나누어 확인할 수 있습니다.
연결 버튼이 켜져 있다는 것은 클라이언트가 실행 절차를 시작했다는 뜻일 뿐, 대상 웹사이트에 접속할 수 있다는 의미는 아닙니다. 먼저 구독 업데이트가 성공했는지와 설정을 선택했는지 확인하세요. 다음으로 커널 시작 오류를 살펴본 뒤 도메인 조회와 원격 연결을 점검하세요. 시간 초과, 인증 실패, 포트 사용 중, DNS 조회 실패는 해결 방법이 서로 다릅니다. 여러 설정을 동시에 바꾸기보다 주요 오류 메시지를 먼저 보관하세요.
지연 시간 테스트도 종류를 구분해야 합니다. 연결 테스트는 주로 엔드포인트 응답을 확인하지만 실제 접속 테스트에는 대상 사이트, DNS, 라우팅도 영향을 줍니다. 한 번의 결과로 모든 앱의 사용 상태를 판단할 수는 없습니다. 같은 대상을 정해 반복 테스트하는 편이 목록의 단일 결과만 보는 것보다 유용합니다. 체계적으로 문제를 점검하려면 시스템 가이드의 순서에 따라 확인하세요. 로그를 공유하기 전에는 구독 주소, 인증 정보, 개인 네트워크 정보를 가려야 합니다.
연결 전후 점검
구체적인 증상을 먼저 파악한 뒤 해당 안내를 확인하세요. 문제를 재현할 수 있는 작업 순서를 기록하고, 점검할 때는 한 번에 조건 하나만 바꾸세요.
주소를 저장하는 것만으로는 구독 그룹이 만들어질 뿐이며, 구독 업데이트도 실행해야 합니다. 먼저 올바른 그룹을 선택했는지 확인하고 업데이트 메시지를 살펴보세요. 구독 형식으로 인식할 수 없는 웹페이지가 반환된다면 설정 제공자에게 주소의 용도를 확인하세요. 서비스 관리 페이지를 구독 링크로 가져오면 안 됩니다.
구독 가져오기 문제 확인 →시스템 프록시는 시스템 설정을 따르는 앱이 로컬 프록시에 연결되도록 합니다. 전역 라우팅은 보통 커널에 들어온 트래픽을 프록시 아웃바운드로 보내는 정책을 뜻합니다. 하나는 ‘트래픽이 들어오는가’를, 다른 하나는 ‘들어온 트래픽이 어디로 가는가’를 처리하므로 서로 대신할 수 없습니다. 시스템 프록시를 사용하지 않는 프로그램이라면 전역 라우팅으로 바꿔도 해결되지 않을 수 있습니다.
프록시 모드와 라우팅 용어 구분하기 →테스트 대상을 하나 정해 설정이 작동하는지 확인한 뒤 대상 앱이 프록시를 사용하는지 점검하세요. 브라우저는 접속되지만 다른 프로그램은 안 된다면 트래픽 처리 방식을 확인하세요. 모든 대상에 연결할 수 없다면 로그에서 DNS 조회, 인증, 시간 초과 정보를 살펴보세요. 설정을 보존하고 문제를 찾는 동안 여러 매개변수를 한꺼번에 바꾸지 마세요.
연결 문제 해결 가이드 보기 →서비스에서 여러 기기 사용을 허용하고 각 클라이언트가 구독 설정을 지원한다면 같은 주소를 기기별로 추가해 사용할 수 있습니다. 구독에는 연결 항목이 동기화되지만 사용자 지정 DNS, 라우팅, UI 설정은 포함되지 않을 수 있습니다. 기기 수와 동시 연결 제한은 서비스 규정을 따릅니다. QR 코드나 백업 파일을 공유하기 전에 인증 정보가 포함되어 있는지도 확인하세요.
여러 기기 설정 방법 보기 →이어서 읽기
먼저 기본 연결을 완료한 뒤 필요한 설정을 확장하세요. 아래 글은 가상 네트워크 인터페이스를 통한 트래픽 처리, 구독 형식, 여러 기기 간 동기화를 다룹니다. 기본 설정을 확인한 다음 필요한 내용을 하나씩 읽어보세요.
TUN 가상 네트워크 인터페이스와 시스템 프록시의 차이를 설명하고 시스템 프록시를 사용하지 않는 프로그램의 트래픽을 처리할 수 있는 이유를 알아봅니다. v2rayN에서 Tun을 켜는 방법과 권한, 자주 발생하는 충돌 문제도 안내합니다.
설정 단계 보기 →v2rayN의 구독 그룹 설정과 v2rayNG의 구독 그룹 메뉴 위치를 각각 안내합니다. 주소 추가와 구독 업데이트 절차를 설명하고 자주 쓰이는 구독 콘텐츠 형식의 차이도 살펴봅니다.
구독 가져오기 안내 보기 →데스크톱과 Android 기기에서 노드와 설정을 동기화하는 방법을 살펴봅니다. 같은 구독 사용, QR 코드와 공유 링크 전송, 설정 백업 파일 내보내기와 가져오기의 활용 사례 및 제한 사항을 안내합니다.
기기 간 설정 이전 방법 알아보기 →