구독 가져오기, 라우팅, 로그 확인을 중심으로 운영체제에 맞는 클라이언트를 선택하고 연결 설정을 하나씩 점검합니다.
노드, 라우팅, 트래픽 처리의 차이부터 파악한 뒤 설정을 조정하세요. 클라이언트가 실행된다고 해서 앱의 요청이 프록시 코어를 통과하는 것은 아닙니다.
데스크톱에서는 v2rayN, 안드로이드에서는 v2rayNG부터 살펴보세요. V2Fly 설정이 필요한 경우에는 v2flyNG도 고려할 수 있습니다. 세 클라이언트 모두 GUI를 제공하지만 메뉴 위치와 코어 기능, 시스템 권한은 서로 다릅니다. 화면에 토글이 몇 개 있는지가 아니라 운영체제와 노드 프로토콜, 실제 사용 환경을 기준으로 선택하세요.
설정을 바꾸기 전에 매개변수가 모두 확인된 노드를 하나 남겨 두고, 단일 노드 연결부터 테스트하세요. 그다음 구독 자동 업데이트와 복잡한 라우팅을 적용하면 됩니다. 한 번에 변수 하나만 바꾸고 변경 전후 로그를 기록하세요. 아래 설정 기록은 일상적인 사용 순서에 맞춰 정리했습니다. 메뉴 이름은 클라이언트 버전에 따라 다를 수 있으므로 같은 이름의 메뉴를 찾을 수 없다면 사용 중인 클라이언트부터 확인하세요.
구독은 업데이트되는 노드 목록을 관리할 때 편리하고, 단일 노드 공유 링크는 임시 테스트나 기기 간 이전에 적합합니다. v2rayN에서는 보통 구독 그룹에 주소를 저장한 뒤 업데이트를 실행하며, 안드로이드 클라이언트에서는 구독 설정에 항목을 추가합니다. 가져온 후에는 그룹과 노드 수, 프로토콜 항목을 확인하고 사용할 노드를 선택하세요. 세 클라이언트는 일부 공유 형식을 다르게 인식할 수 있으므로 링크 접두부만 보고 호환 여부를 판단해서는 안 됩니다. 업데이트에 실패하면 기존 설정을 삭제하기 전에 주소가 완전한지, 요청이 직접 연결되는지 프록시를 통하는지부터 확인하세요.
라우팅은 요청이 코어에 들어온 뒤 어떤 경로를 따를지 정합니다. 앱이 자동으로 프록시를 사용하게 해 주는 기능은 아닙니다. 먼저 기본 규칙을 선택해 기준을 잡고, 도메인이나 주소 또는 앱별 요구에 따라 규칙을 추가하세요. 규칙은 보통 순서대로 적용되므로 조건이 지나치게 넓은 규칙을 앞에 두면 뒤의 세부 규칙이 적용되지 않을 수 있습니다. 데스크톱에서는 규칙 목록을 확인하기 쉽고, 안드로이드에서는 앱별 프록시 범위도 함께 점검해야 합니다. 특정 사이트에 문제가 생기면 모든 트래픽을 프록시로 돌리기 전에 적용된 규칙과 DNS 결과를 먼저 확인하세요. 테스트가 끝나면 원래 모드로 되돌려 변경 효과를 비교하세요.
시스템 프록시는 시스템 설정을 참조하는 앱에 적합하고, TUN은 가상 네트워크 인터페이스를 통해 트래픽을 처리합니다. 둘은 속도 단계가 아닙니다. 데스크톱에서 처음 연결할 때는 시스템 프록시부터 확인한 뒤 앱의 필요에 따라 TUN을 테스트하세요. TUN은 관리자 권한이 필요할 수 있으며 라우팅 테이블과 DNS에도 영향을 줍니다. 안드로이드 클라이언트는 보통 시스템 VPN 권한을 받아 로컬 트래픽 경로를 만드므로 데스크톱 메뉴를 그대로 적용할 수 없습니다. 다른 VPN이나 네트워크 제어 도구가 함께 실행되면 충돌할 수 있습니다. 문제를 확인할 때는 다른 트래픽 처리 방식을 끄고 경로 하나만 남긴 뒤 대상 앱과 코어 로그를 살펴보세요.
코어는 연결, 전송, DNS, 라우팅 로직을 실행하고 클라이언트는 관련 설정을 관리합니다. v2rayN의 코어는 현재 설치된 코어와 노드 요구 사항을 기준으로 선택하세요. v2rayNG는 주로 Xray를 사용하고 v2flyNG는 V2Fly를 대상으로 합니다. 이름만 다른 같은 프로그램이 아니므로 지원하는 프로토콜 확장과 설정 항목이 다를 수 있습니다. 지원하지 않는 매개변수가 나타나면 코어를 무작정 바꾸기 전에 노드 프로토콜과 코어의 지원 범위를 확인하세요. 전환 전에는 설정을 백업하고, 전환 후에는 시작 로그와 실제 연결을 확인해야 합니다. 코어 이름만으로 성능을 판단할 수는 없습니다.
로그는 문제가 발생한 단계를 찾는 데 유용하지만 경고 한 줄만으로 전체 연결이 안 된다고 단정해서는 안 됩니다. 먼저 코어가 시작되었는지 확인하고, 요청이 로컬 인바운드에 들어오는지 살핀 다음 DNS, 아웃바운드 연결, 원격 응답을 차례로 점검하세요. 포트 충돌은 대개 시작 단계에서 발생하고 연결 시간 초과는 네트워크 경로와 서버 상태를 나눠 확인해야 합니다. 세 클라이언트의 로그 메뉴는 다르지만 문제가 재현되는 순간을 기록하는 방법은 공통으로 쓸 수 있습니다. 오류 전후의 로그를 함께 저장하고 공유 전에는 구독 주소와 노드 인증 정보, 개인 도메인을 가리세요. 마지막 오류 문장만 캡처하는 것보다 원인 파악에 도움이 됩니다.
먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 설치 형식을 비교하세요. 다운로드 페이지에서 각 파일과 지원 환경을 확인할 수 있습니다.
클라이언트 설치 파일과 노드 구독은 서로 별개입니다. 클라이언트를 설치해도 로컬 도구만 준비될 뿐, 실제 연결에는 유효한 노드 설정이 필요합니다. 노드 수와 업데이트 주기, 서비스 상태는 구독 제공업체가 결정합니다. 기기를 바꿀 때 양쪽에 같은 구독을 가져올 수 있지만 라우팅 규칙과 앱별 프록시 범위, 로컬 포트는 각각 확인해야 합니다. 노드가 동기화되었다고 해서 모든 설정까지 같아지는 것은 아닙니다.
구독 그룹, 규칙 편집, 데스크톱 로그 화면을 활용하려는 사용자에게 적합합니다. 다운로드 페이지에는 Desktop 버전과 클래식 WPF 버전이 구분되어 있습니다. 전자는 차세대 크로스 플랫폼 인터페이스를 사용하고 후자는 익숙한 기존 조작 방식을 유지합니다. 노드 속도 차이로 오해하지 말고 익숙한 메뉴와 기존 설정을 기준으로 선택하세요.
처음 실행하면 로컬 수신 대기 포트를 확인하고 노드를 가져온 뒤 시스템 프록시 모드를 선택하세요. 브라우저는 정상인데 특정 앱만 실패한다면 해당 앱의 프록시 설정을 확인하세요. 트래픽을 더 폭넓게 처리해야 할 때는 TUN을 별도로 테스트하면 됩니다. 회사 기기의 권한 제한이나 기존 네트워크 소프트웨어가 가상 네트워크 인터페이스 생성에 영향을 줄 수도 있습니다.
다운로드 페이지로 이동데스크톱 운영체제를 바꿔도 비슷한 구독 관리 방식을 유지하려는 사용자에게 적합합니다. 설치 전에 ‘이 Mac에 관하여’를 열어 Apple Silicon인지 Intel인지 확인한 뒤 해당 아키텍처용 파일을 선택하세요. 두 설치 파일은 서로 다른 프로세서용이므로 파일 크기나 다운로드 순서만 보고 선택하면 안 됩니다.
처음 실행할 때 시스템 보안 경고가 나타나면 설치 출처와 경고 내용을 확인한 뒤 운영체제가 안내하는 승인 절차를 따르세요. 프록시를 켠 다음에는 브라우저와 대상 앱에서 각각 연결을 확인해야 합니다. 앱이 시스템 프록시를 사용하는지, 자체 네트워크 설정이 있는지에 따라 결과가 달라질 수 있습니다. 기존 설정을 옮기기 전에는 백업하고 다른 운영체제의 로컬 경로를 새 환경에 그대로 가져오지 마세요.
다운로드 페이지로 이동일반적인 설정에는 Xray 코어를 사용하는 v2rayNG를 먼저 살펴보세요. V2Fly 호환이 명확히 필요한 경우에는 v2flyNG를 선택할 수 있습니다. 다운로드 페이지에서 arm64와 범용 버전을 모두 제공합니다. 비교적 최신 스마트폰에는 대개 arm64가 적합하며 아키텍처가 확실하지 않다면 기기 정보를 확인하세요.
구독을 가져온 뒤 노드를 선택하고 연결을 시작한 다음 시스템 VPN 권한을 승인하세요. 알림 표시줄에 실행 중이라는 알림이 나타나도 로컬 서비스가 작동 중이라는 뜻일 뿐이므로 실제 요청으로 연결을 확인해야 합니다. 화면을 잠근 뒤 연결이 끊기면 배터리 최적화와 백그라운드 실행 권한, 네트워크 전환 기록을 확인하세요. 특정 앱만 연결되지 않는다면 앱별 프록시 범위에서 해당 앱을 빠뜨리지 않았는지 살펴보세요.
다운로드 페이지로 이동GUI로 구독을 관리하면서 데스크톱 환경의 네트워크 동작도 직접 확인하려는 사용자에게 적합합니다. 배포판에 맞춰 deb 또는 rpm을 선택한 다음 프로세서가 x64인지 arm64인지 확인하세요. 패키지 형식과 프로세서 아키텍처는 별개의 조건이므로 형식이 맞아도 아키텍처가 틀릴 수 있습니다.
데스크톱 환경과 앱마다 시스템 프록시를 사용하는 방식이 다를 수 있습니다. 먼저 클라이언트가 요청을 수신하는지 확인한 뒤 대상 앱에서 요청 경로를 점검하세요. 터미널 프로그램은 데스크톱 프록시 설정을 따르지 않을 수도 있습니다. TUN을 사용하기 전에 필요한 권한과 라우팅 변경 사항을 확인하고, 클라이언트를 종료한 뒤 네트워크가 복구되었는지 살펴보세요. 남아 있는 시스템 프록시를 노드 오류로 오해하지 않도록 주의해야 합니다.
다운로드 페이지로 이동설치한 다음에는 무엇이 필요한가요?
사용 가능한 노드 설정이나 구독 주소가 필요합니다. 클라이언트는 설정을 읽고 실행할 뿐, 연결 가능한 원격 서비스를 자동으로 만들지는 않습니다. 단일 노드 공유 링크와 구독 주소의 차이를 확인한 뒤 사용 방법에 따라 해당 가져오기 메뉴를 선택하세요.
노드 테스트는 통과했는데 앱에서 연결되지 않는 이유는 무엇인가요?
테스트 요청과 앱의 요청은 서로 다른 경로를 사용할 수 있습니다. 시스템 프록시와 TUN 또는 앱별 설정을 확인하고, 로그에 대상 앱의 요청이 나타나는지 살펴보세요. 테스트 결과만으로 실제 사용 환경의 연결을 보장할 수는 없습니다.
클라이언트를 바꾸면 모든 시간 초과 문제가 해결되나요?
그렇게 단정할 수 없습니다. 노드 서비스 상태와 현재 네트워크, 설정 호환성이 모두 연결에 영향을 줄 수 있습니다. 같은 노드와 네트워크 조건을 유지한 채 비교해야 클라이언트 차이와 네트워크 경로 문제를 구분하는 데 도움이 됩니다.
문제 해결을 위해 구독 주소를 다른 사람에게 보내도 되나요?
구독 주소에는 접근 정보가 포함될 수 있습니다. 문의할 때는 민감한 정보를 가린 오류 메시지와 클라이언트 이름, 재현 절차를 우선 공유하세요. 스크린샷과 백업 파일에도 노드 비밀번호가 포함되지 않았는지 확인해야 합니다.
Project V는 V2Ray 기술 생태계를 이해하는 출발점입니다. V2Fly와 Xray는 관련 코어 계열이며 GUI 클라이언트는 코어 위에 노드 관리와 시스템 설정 기능을 제공합니다.
V2Ray는 인바운드와 아웃바운드, 라우팅을 바탕으로 트래픽 수신과 프로토콜 처리, 경로 선택을 나눠 설정할 수 있는 구조를 갖췄습니다. V2Fly는 V2Ray 프로젝트를 이어 유지·개발하고 있으며 Xray는 관련 코드 기반에서 자체 구현과 확장 기능을 발전시켰습니다. 공통된 기술 개념이 있지만 기능이 똑같이 발전한 것은 아니므로 설정 형식이 비슷하다고 모든 항목을 서로 바꿔 쓸 수 있다고 보면 안 됩니다.
가이드를 읽을 때는 클라이언트와 코어를 함께 확인하세요. REALITY 같은 기술은 이를 지원하는 구현이 필요합니다. 노드를 가져올 수 있는지, 설정을 생성할 수 있는지, 실제 연결에 성공하는지는 서로 다른 점검 단계입니다. 알 수 없는 필드나 지원하지 않는 전송 매개변수 오류가 발생하면 라우팅을 무작정 바꾸기보다 먼저 지원 범위를 확인하세요.
v2rayN, v2rayNG, v2flyNG는 구독 관리와 설정 편집, 서비스 제어를 위한 오픈 소스 GUI 클라이언트입니다. v2rayN은 데스크톱 운영체제용으로 설정과 코어 선택 기능이 한곳에 모여 있습니다. v2rayNG는 주로 안드로이드에서 Xray와 함께 사용하고, v2flyNG는 안드로이드에서 V2Fly를 사용하는 또 다른 선택지입니다. 공통된 사용 방식도 있지만 화면 구성과 설정 백업 형식이 완전히 같지는 않습니다.
컴퓨터에서 스마트폰으로 설정을 옮길 때는 전체 설정 폴더를 복사하기보다 공유 링크나 QR 코드를 사용하면 확인하기 쉽습니다. 이전 후에는 노드가 선택되었는지, 대상 앱이 프록시 범위에 포함되었는지, DNS와 라우팅이 새 기기에 맞는지 다시 점검하세요. 데스크톱의 수신 대기 주소와 파일 경로, 권한 설정을 안드로이드에 그대로 적용해서는 안 됩니다.
오픈 소스 소프트웨어는 해당 라이선스 조건에 따라 코드를 공개해 열람과 사용, 수정을 허용합니다. V2Fly 코어는 MIT 라이선스, Xray-core는 MPL-2.0 라이선스를 사용합니다. GUI 클라이언트와 각 의존성에도 별도의 라이선스가 적용될 수 있으므로 특정 코어의 라이선스가 설치 파일의 모든 구성 요소에 동일하게 적용된다고 볼 수는 없습니다.
이 클라이언트는 무료로 사용할 수 있지만 클라이언트와 원격 서비스는 별개입니다. 구독 요금과 트래픽 한도, 노드 사용 기간은 서비스 제공업체가 정합니다. 문제를 확인할 때 ‘도구가 실행되는지’와 ‘원격 서비스가 작동하는지’를 구분하면 서비스 장애를 다른 클라이언트를 구매해야 하는 문제로 오해하지 않을 수 있습니다.
클라이언트 업데이트로 화면 구성과 설정 생성 방식, 의존 코어가 바뀔 수 있고 코어 업데이트로는 프로토콜 지원이나 동작이 달라질 수 있습니다. 업데이트 전에 구독 그룹과 사용자 지정 규칙을 저장하고 현재 작동하는 트래픽 처리 방식을 기록하세요. 업데이트 후에는 기존 노드부터 확인한 뒤 추가 설정을 하나씩 복원하세요. 클라이언트와 노드, DNS를 한꺼번에 바꾸는 것은 피하는 편이 좋습니다.
이상 동작이 발생하면 먼저 재현하고 시작 로그를 확인한 뒤 구체적인 오류에 따라 설정 호환성 문제인지 판단하세요. 구독 업데이트는 서버가 제공하는 노드 목록을 새로고침할 뿐 클라이언트나 코어를 업데이트하지 않습니다. 다운로드 페이지와 사용 방법은 각각 설치와 설정을 다루며, 문제 해결 안내서는 증상에 따라 로그와 포트, DNS, 시스템 프록시를 확인하는 과정을 정리합니다.
해결할 문제부터 명확히 정하세요. 메뉴를 찾고 실패 지점을 확인한 뒤 어떤 설정을 바꿀지 결정하면 됩니다.
v2rayN의 구독 그룹 설정과 v2rayNG의 구독 설정에서 가져오는 방법을 각각 소개하고, Base64 구독과 단일 노드 공유 링크 등 자주 쓰이는 형식의 차이를 설명합니다.
가져오기 방법 보기 →코어 시작 로그에서 주요 오류를 읽고 포트 충돌, JSON 형식 오류, 코어 파일 누락, 매개변수 호환성 문제를 구분해 하나씩 해결하는 방법을 안내합니다.
로그로 문제 해결하기 →기기 간 설정을 옮기는 세 가지 방법을 비교합니다. 같은 구독을 여러 기기에 가져오기, v2rayN에서 공유 링크와 QR 코드를 내보내 v2rayNG로 가져오기, 설정 백업 파일 저장 및 복원 방법을 다룹니다.
기기 간 이전 방법 보기 →