구독 가져오기부터 라우팅 설정까지, 네 가지 플랫폼에 맞는 클라이언트와 사용 방법을 확인하세요.
설정 항목을 보여 주는 예시 화면입니다. 실제 항목명은 클라이언트 UI에 따라 다를 수 있습니다. 예시 주소로는 연결할 수 없습니다.
설정 핵심
GUI 클라이언트는 구독을 정리하고 설정을 생성하며 연결을 관리하고, 코어는 실제 트래픽을 처리합니다. 먼저 두 역할을 구분한 뒤 라우팅, 프록시 방식, 구독 업데이트 순으로 설정하세요. 문제가 생겼을 때 모든 옵션을 한꺼번에 바꾸지 않아도 어느 단계에서 확인해야 할지 판단하기 쉽습니다.
라우팅 규칙은 접속 대상과 아웃바운드 방식을 연결합니다. 특정 도메인을 직접 연결하려면 도메인 매칭 규칙을 추가하고 아웃바운드 태그를 기존 direct 아웃바운드로 지정합니다. 프록시가 필요한 트래픽은 프록시 아웃바운드로 보냅니다. 규칙은 일반적으로 순서대로 매칭되므로 구체적인 조건을 포괄적인 조건보다 앞에 두세요. GUI 클라이언트의 규칙 설정은 최종적으로 코어 설정으로 변환됩니다. 문제를 해결할 때는 매칭 조건과 태그 철자를 모두 확인하세요. 아래 예시는 규칙 구조만 보여 주며 전체 설정을 대체하지 않습니다. 수정하기 전에 현재 설정을 백업하세요.
시스템 프록시는 운영체제의 프록시 설정을 이용해 해당 기능을 지원하는 앱의 연결을 안내합니다. v2rayN TUN 모드는 가상 네트워크 인터페이스를 통해 조건에 맞는 트래픽을 처리하므로 적용 범위가 서로 다릅니다. 브라우저는 연결되지만 다른 프로그램은 연결되지 않는다면 먼저 해당 프로그램이 시스템 프록시를 사용하는지 확인한 뒤 TUN이 필요한지 살펴보세요. 처음 설정할 때는 일반 프록시 연결부터 확인하고, 그다음 가상 네트워크 어댑터, 권한, DNS를 설정하는 편이 좋습니다. 두 방식을 모두 켠다고 더 나은 것은 아닙니다. 전환하기 전에 현재 상태를 기록해 다른 네트워크 도구의 트래픽 처리 규칙과 충돌하지 않도록 하세요.
V2Ray 프로토콜은 이름만 비교하지 말고 서버에서 제공한 설정값을 기준으로 선택해야 합니다. VMess, VLESS 프로토콜과 전송 계층 및 보안 계층의 조합은 클라이언트 코어가 함께 지원해야 합니다. 프로토콜 드롭다운만 바꾼다고 기존 노드가 다른 서비스로 자동 변환되지는 않습니다. Xray와 V2Fly는 관련 오픈 소스 생태계에 속하지만 확장 기능과 설정 세부 사항은 다릅니다. 코어를 바꾸기 전에 현재 노드의 전송 방식, 보안 설정, 라우팅 기능을 지원하는지 확인하세요. 저장한 다음 시작 로그를 확인해 호환성 오류를 네트워크 연결 문제로 오인하지 않도록 합니다.
구독 주소는 노드 목록을 가져오는 데 사용하며, 실제 연결할 때 선택하는 설정은 개별 노드입니다. v2rayNG에서 구독을 가져오는 기본 순서는 데스크톱과 같습니다. 그룹 이름과 주소를 입력해 저장한 뒤 업데이트하고, 결과 목록에서 노드를 선택하세요. 그룹을 사용하면 출처별로 구분하고 개별 업데이트 및 문제 해결도 편리합니다. 업데이트에 실패하면 주소가 완전한지, 네트워크에서 접속 가능한지, 구독이 아직 유효한지 먼저 확인하세요. 모든 설정을 반복해서 삭제하지 마세요. 구독 링크에는 접속 정보가 포함될 수 있으므로 화면을 공유하거나 도움을 요청할 때 전체 주소를 가려야 합니다. 노드를 직접 수정하기 전에는 다음 업데이트에서 변경 사항이 덮어써질 수 있다는 점도 고려하세요.
데스크톱에서는 먼저 구독을 업데이트하고 노드를 선택한 뒤 시스템 프록시를 켜고, 마지막으로 시스템 프록시를 지원하는 브라우저에서 연결을 확인하세요. 브라우저는 정상인데 터미널에서 실패한다면 터미널 도구의 프록시 옵션이나 환경 변수를 별도로 확인해야 합니다. 이 결과만으로 노드에 문제가 있다고 판단할 수는 없습니다. 더 많은 앱의 트래픽을 같은 경로로 보내야 할 때 TUN의 권한과 라우팅 요구 사항을 살펴보세요. 설정을 바꾼 뒤에는 로그에서 시작 오류를 확인하고 로컬 수신 포트가 사용 중인지 점검하세요. 한 번에 한 종류의 설정만 바꾸고 정상 작동하는 설정을 보존하면 변경 전후를 비교하기 쉽습니다.
Android에서 구독을 가져온 뒤 먼저 노드를 선택하고 연결을 시작한 다음 시스템 VPN 권한 요청을 확인하세요. 일반적으로 기기에서 여러 VPN 서비스가 동시에 네트워크를 제어할 수 없으므로 클라이언트를 바꾸기 전에 기존 연결을 먼저 중지해야 합니다. 앱을 백그라운드로 전환했을 때만 연결이 끊긴다면 프로토콜을 반복해서 바꾸기보다 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 처음 테스트할 때는 같은 네트워크와 같은 웹사이트를 사용해 기본 연결을 확인한 뒤 앱별 분할 설정을 구성하세요. 그룹 업데이트와 연결 시작은 별개의 작업입니다. 업데이트가 완료되어도 노드가 선택되거나 서비스가 시작된 것은 아닙니다.
플랫폼별 다운로드
데스크톱에서는 v2rayN부터 살펴보고, Android에서는 v2rayNG를 먼저 확인하세요. V2Fly 설정이 필요한 경우 v2flyNG와 비교하면 됩니다. 다운로드하기 전에 운영체제와 프로세서 아키텍처를 확인하세요. 설치 패키지 형식이 다르다고 구독을 다시 구매하거나 생성해야 하는 것은 아닙니다.
v2rayN은 Desktop과 클래식 WPF, 두 가지 UI 버전을 제공합니다. Desktop은 크로스 플랫폼 UI를 사용하고 WPF는 익숙한 데스크톱 조작 방식을 유지합니다. 운영체제 요구 사항, UI 취향, 기존 설정과의 호환성을 기준으로 선택하면 됩니다. UI가 다르다는 이유만으로 클라이언트 두 개를 동시에 실행할 필요는 없습니다.
처음 설치할 때는 관리하기 쉬운 폴더에 프로그램을 두고 다운로드 페이지의 안내에 따라 실행 환경을 준비하세요. 실행한 뒤 구독을 가져오고 시스템 프록시 연결을 확인합니다. 프로그램이 실행 직후 종료된다면 노드 설정을 바로 바꾸기보다 런타임 라이브러리, 압축 해제 경로, 보안 프로그램의 알림을 먼저 확인하세요.
다운로드v2rayN 데스크톱 다운로드는 Apple Silicon과 Intel 칩에 따라 구분됩니다. 시스템의 ‘이 Mac에 관하여’에서 칩 종류를 확인한 뒤 맞는 설치 파일을 선택하세요. 아키텍처 선택은 프로그램 실행 가능 여부에 영향을 주지만 구독 주소의 용도는 바꾸지 않습니다.
처음 실행할 때는 시스템 안내에 따라 필요한 권한을 허용하고 시스템 프록시와 기존 네트워크 도구가 충돌하는지 확인하세요. 시스템마다 메뉴 위치는 다를 수 있지만 구독 그룹, 노드 선택, 라우팅 규칙의 기본 관계는 같습니다. 설정 안내의 개념도 그대로 참고할 수 있습니다.
다운로드v2rayNG 다운로드 페이지에는 arm64 패키지와 범용 패키지가 있습니다. 기기에서 지원하는 아키텍처에 맞춰 선택하고, 확실하지 않다면 다운로드 페이지의 안내를 먼저 확인하세요. v2rayNG는 Xray 코어를 사용하고 v2flyNG는 V2Fly 코어를 사용하는 대안 클라이언트입니다. 노드 기능 요구 사항을 고려해 선택하세요.
설치가 끝난 뒤 구독을 가져오고 첫 연결을 시작할 때 시스템 VPN 권한 요청을 확인하세요. 앱을 전면에 둘 때만 연결된다면 배터리 관리와 백그라운드 제한을 점검하고, 일부 앱에서만 문제가 발생한다면 앱별 분할 설정을 확인하세요. 백그라운드 제한과 프로토콜 호환성은 서로 다른 문제입니다.
다운로드v2rayN Linux 다운로드는 deb·rpm 패키지 형식과 프로세서 아키텍처에 따라 구분됩니다. 먼저 배포판의 패키지 관리 형식을 확인하고 x64인지 arm64인지 살펴보세요. 패키지 형식 문제를 클라이언트 실행 오류로 오인하지 않도록 주의하세요. GUI 클라이언트를 사용하려면 데스크톱 환경이 필요합니다.
설치 후 일반 프록시 방식으로 연결을 확인한 다음 배포판의 권한 관리와 네트워크 설정에 따라 TUN을 사용할지 결정하세요. 데스크톱 앱과 터미널 도구는 프록시를 사용하는 방식이 다를 수 있습니다. 로컬 수신이 가능하더라도 모든 프로그램이 프록시를 사용하고 있다는 뜻은 아니므로 실제 연결 경로를 각각 확인해야 합니다.
다운로드빠른 시작
클라이언트를 설치한 뒤 ‘설정 가져오기 → 연결 경로 선택 → 결과 확인’ 순서로 진행하세요. 구독, 노드, 프록시 모드는 각각 다른 역할을 합니다. 구독은 설정을 가져오고, 노드는 연결 대상을 정하며, 프록시 모드는 어떤 앱의 트래픽을 클라이언트로 보낼지 결정합니다.
클라이언트의 구독 관리 또는 구독 그룹 설정에서 이름과 전체 주소를 입력하고 저장한 뒤 업데이트하세요. 그룹 이름은 구분을 위한 로컬 표시일 뿐 구독 주소를 대신하지 않습니다. 업데이트에 성공하면 가져온 노드가 표시되어야 합니다. 목록이 비어 있다면 먼저 응답 내용이 현재 클라이언트가 지원하는 형식인지 확인한 뒤 주소가 만료되었거나 일부만 복사된 것은 아닌지 살펴보세요.
QR 코드, 단일 공유 링크, 구독 주소는 서로 다른 가져오기 경로이므로 가진 정보에 맞는 방법을 선택하세요. 이 문서의 예시 링크는 입력란 위치를 보여 주기 위한 것으로 연결 설정을 제공하지 않습니다. 사용 중인 설정이 있다면 먼저 백업하세요. 구독 업데이트로 변경 사항이 덮어써지거나 그룹 필터링 또는 중복 항목이 생긴 것을 가져오기 실패로 오해하지 않도록 주의하세요.
업데이트 결과에서 노드 하나를 선택해 현재 연결에 사용하세요. 데스크톱에서는 시스템 프록시를 켜고 브라우저로 확인하고, Android에서는 연결을 시작해 시스템 권한을 확인합니다. 이 단계에서는 복잡한 라우팅 규칙을 추가하지 마세요. 시스템 프록시, TUN, 앱별 분할은 서로 다른 계층의 설정이므로 기본 연결을 확인한 뒤 하나씩 조정해야 합니다.
프로토콜, 코어, DNS, 라우팅 모드를 한꺼번에 바꾸지 마세요. 설정을 바꾼 뒤 연결이 실패하면 가장 최근에 변경한 항목을 먼저 되돌리고 로그에 뚜렷한 설정 오류나 연결 오류가 있는지 살펴보세요. 여러 네트워크 도구가 동시에 트래픽을 제어하면 문제를 찾기 어려워집니다. 테스트 전에 실제로 작동 중인 클라이언트를 확인하세요.
V2Ray 노드 속도 테스트에서는 연결 가능 여부, 요청 지연 시간, 실제 다운로드 속도를 구분해야 합니다. 목록의 테스트 결과는 특정 대상과 당시의 네트워크 상태만 반영하므로 모든 웹사이트의 사용 경험을 그대로 보여 주지는 않습니다. 처음 확인할 때는 같은 네트워크와 같은 대상을 사용하고 브라우저 접속 및 클라이언트 로그를 함께 살펴 실제 연결이 이루어졌는지 판단하세요.
테스트가 실패하면 로컬 수신, 앱의 프록시 설정, 노드 매개변수, 서버 상태 순서로 범위를 좁히세요. 터미널에서만 실패한다면 터미널 도구 설정을 따로 확인하고, 네트워크를 바꾼 뒤 결과가 달라지면 현재 네트워크 환경을 점검하세요. 반복해서 속도 테스트를 실행하기보다 오류 유형을 기록해 두는 편이 문제 해결과 후속 문의에 도움이 됩니다.
오픈 소스 생태계
Project V, V2Fly, Xray와 GUI 클라이언트는 같은 계층의 이름이 아닙니다. 프로젝트 간 관계를 이해하면 문서의 설정이 UI, 코어, 서버 중 어디에 해당하는지 판단할 수 있고 서로 다른 버전의 설정을 그대로 복사할 때 발생하는 호환성 문제도 줄일 수 있습니다.
Project V는 네트워크 프록시 도구를 중심으로 형성된 오픈 소스 프로젝트 생태계이며 V2Ray는 널리 사용되는 핵심 프로젝트입니다. V2Fly 커뮤니티는 V2Ray 코어의 개발과 유지 관리를 이어 가고 있습니다. 문서에서 V2Fly를 볼 때는 다른 구독 서비스로 이해하기보다 코어 구현과 설정 지원 범위를 확인하세요. GUI 클라이언트는 코어를 호출해 연결을 처리하지만 UI의 버튼 이름이 코어 설정 필드와 일치하지 않을 수 있습니다. 설정 전체를 살펴볼 때는 필드가 뜻하는 바를 기준으로 확인하세요.
Xray는 관련 코드 기반에서 출발해 독립적으로 발전한 코어 프로젝트로, 자체 기능 확장과 설정 요구 사항을 갖고 있습니다. 두 코어가 일부 일반적인 설정을 공유하더라도 모든 전송 방식, 보안 옵션, 라우팅 필드를 서로 바꿔 쓸 수 있는 것은 아닙니다. 노드 사용 가능 여부는 VMess 또는 VLESS라는 이름만 볼 것이 아니라 전체 매개변수 조합을 확인해야 합니다. 서버에서 특정 확장 매개변수를 제공한다면 클라이언트가 호출하는 코어에서 지원하는지도 확인하세요. GUI만 바꿔서는 호환성 문제가 해결되지 않을 수 있습니다.
v2rayN은 데스크톱용으로 구독 관리, 노드 선택, 프록시 설정 등의 GUI 기능을 제공합니다. v2rayNG는 Android용이며 Xray 코어를 사용합니다. v2flyNG는 V2Fly 코어가 필요한 Android 환경을 위한 클라이언트입니다. 세 클라이언트는 모두 오픈 소스 소프트웨어이며 클라이언트 코드와 함께 제공되는 코어는 각각 해당 오픈 소스 라이선스의 적용을 받습니다. 오픈 소스라는 말은 라이선스 조건에 따라 코드를 확인하고 사용·수정할 수 있다는 뜻이지, 클라이언트마다 기능이 같거나 UI 설정을 검토 없이 서로 복사해도 된다는 뜻은 아닙니다.
클라이언트 업데이트는 프로그램과 함께 제공되는 구성 요소를 바꾸고, 구독 업데이트는 원격에서 제공하는 노드 목록을 새로고침합니다. 두 업데이트는 서로 대체할 수 없습니다. 구독을 업데이트하면 직접 수정한 노드 설정이 다시 생성될 수 있고, 클라이언트를 업데이트하면 설정 메뉴 위치, 기본값, 지원 기능이 달라질 수 있습니다. 변경하기 전에 설정을 백업하고, 변경한 뒤에는 이미 알고 있는 설정 하나로 먼저 테스트한 다음 앱별 분할과 DNS 동작을 확인하세요. 이 사이트에서는 운영체제별 클라이언트 다운로드 경로와 사용 순서를 안내합니다. 최신 릴리스 정보는 다운로드 페이지에서, 세부 설정은 설정 가이드에서 항목별로 확인하세요.
가이드 최신 글
기본 연결을 확인한 뒤 실제로 겪는 문제에 맞는 가이드를 읽어 보세요. 설치, 프로토콜 선택, 시스템 프록시는 서로 다른 문제 해결 분야입니다. 여러 설정을 동시에 바꾸기보다 증상을 먼저 파악하고 단계별 안내와 대조하면 원인을 찾기 쉽습니다.
브라우저에서는 프록시 확장 프로그램, PAC, 우회 목록을 확인하고 터미널에서는 http_proxy 환경 변수와 도구 자체의 프록시 설정을 살펴보세요. 시스템 프록시가 작동하지 않는 원인을 두 경로로 나눠 찾을 수 있습니다.
게시물 읽기 →VMess와 VLESS의 암호화 방식, 시간 검증, 전송 방식 조합의 차이와 클라이언트에서 두 종류의 노드를 볼 때 이해하고 선택하는 방법을 간단히 설명합니다.
게시물 읽기 →설치 패키지 선택부터 압축 해제 폴더, 첫 실행, 구독 가져오기, 시스템 프록시 설정까지 Windows 사용 과정을 안내하고 한글 경로, 권한, 포트 충돌 등 자주 발생하는 문제도 정리합니다.
게시물 읽기 →