CLIENT WORKFLOW
먼저 노드를 클라이언트로 가져온 다음 어떤 트래픽을 코어로 보낼지 정하세요. GUI는 설정을 관리하고 코어는 연결을 처리합니다. 시스템 프록시와 TUN은 앱의 트래픽이 코어에 전달되는 방식을 결정합니다. 이 세 계층을 나눠 확인하면 여러 스위치를 한꺼번에 바꾸는 것보다 문제를 쉽게 찾을 수 있습니다.
구독 주소는 여러 노드 설정을 가져오는 데 사용하며, 단일 노드 공유 링크와는 다릅니다. ‘구독 그룹 설정’에서 그룹을 만들고 메모와 주소를 입력해 저장한 뒤 ‘구독 업데이트(프록시 사용 안 함)’를 실행하세요. 현재 네트워크에서 구독 주소에 접근할 수 없고 사용할 수 있는 연결이 이미 있다면 프록시를 통한 업데이트를 시도해 볼 수 있습니다. 출처별로 그룹을 나누면 각각 업데이트하고 문제를 확인하기 편합니다. 노드 정보를 하나씩 입력하는 대신 구독을 이용하면 관련 항목을 한곳에서 관리할 수 있지만, 업데이트 성공 여부는 로그와 노드 목록으로 확인해야 합니다.
라우팅은 도메인이나 대상 주소 등의 조건에 따라 직접 연결할지 프록시를 거칠지 결정합니다. 먼저 ‘라우팅 설정’에서 현재 네트워크에 맞는 규칙을 선택하고 기본 출구를 확인하세요. 시스템 프록시를 켰다고 모든 트래픽이 같은 경로를 이용하는 것은 아닙니다. 로컬 기기에 접근해야 한다면 사설 주소 직접 연결 규칙을 유지하세요. 단일 출구를 사용하는 것과 달리 라우팅을 이용하면 대상별로 연결 방식을 나눌 수 있지만, 규칙 순서와 도메인 조회 결과에 따라 적용되는 규칙이 달라집니다. 설정을 바꾼 뒤 같은 앱으로 다시 테스트하고 로그에서 실제 출구를 확인하세요.
시스템 프록시는 시스템 프록시 설정을 따르는 앱에 적용되므로 브라우저 연결을 먼저 확인할 때 적합합니다. TUN은 가상 네트워크 인터페이스를 통해 트래픽을 처리하므로 시스템 프록시를 사용하지 않는 프로그램에도 적용할 수 있지만, 필요한 권한과 라우팅 지원이 있어야 합니다. 먼저 일반 프록시 연결이 정상인지 확인한 다음 ‘TUN 모드’를 켜세요. 그래야 노드 문제와 가상 네트워크 어댑터 문제를 구분하기 쉽습니다. 시스템 프록시만 설정하는 경우보다 TUN은 더 많은 트래픽을 처리하는 만큼 다른 가상 네트워크 어댑터, DNS 설정, 네트워크 도구의 영향을 받기 쉽습니다. 종료한 뒤 시스템 네트워크 설정이 정상적으로 복구됐는지 확인하세요.
코어는 설정을 해석하고 연결을 실행합니다. GUI에 같은 이름의 항목이 있어도 모든 코어가 동일한 조합을 지원하는 것은 아닙니다. v2rayN의 ‘설정’에서 해당 설정 유형에 사용할 코어를 확인하고 노드 프로토콜 및 전송 방식에 맞춰 Xray 또는 sing-box를 선택하세요. 전환하기 전에 기존 선택을 기록하고 전환 후 시작 로그를 확인하세요. 단일 코어 클라이언트보다 멀티 코어는 더 다양한 설정을 지원하지만, 잘못된 인증 정보나 작동하지 않는 노드를 코어 전환만으로 해결할 수는 없습니다. 특정 보안 방식이 필요하다면 클라이언트와 코어가 해당 설정 항목을 지원하는지도 확인하세요.
구독 그룹 설정
규칙에 따라 출구 선택
연결을 먼저 확인한 다음 적용 범위를 넓히세요
Xray / sing-box 코어 전환
가져오기가 끝나면 노드 하나를 선택해 활성 서버로 지정하고 코어가 시작되는지 확인하세요. 노드가 목록에 표시된다는 것은 설정을 읽었다는 뜻일 뿐, 원격 서버에 연결할 수 있다는 의미는 아닙니다. 테스트 중에는 로그 창을 열어 두고 시작 단계에서 오류가 발생하는지, 대상에 접근할 때 시간 초과가 발생하는지 기록하세요. 두 경우는 확인해야 할 부분이 다릅니다.
그다음 시스템 프록시를 켜고 브라우저에서 확인할 대상을 정해 접속해 보세요. 브라우저는 정상인데 다른 프로그램에서 문제가 생긴다면 해당 프로그램이 시스템 프록시를 사용하는지 먼저 확인하세요. 클라이언트를 바로 다시 설치할 필요는 없습니다. 더 많은 트래픽을 처리해야 한다면 TUN 권한 및 DNS 안내를 확인하세요. 운영체제나 GUI 버전에 따라 메뉴 이름이 조금씩 다를 수 있으므로 기능을 기준으로 찾아보세요. 자세한 순서는 빠른 시작 안내를 참고하세요.
구독 주소에는 보통 접근 인증 정보가 포함되므로 계정 정보처럼 안전하게 보관하세요. 스크린샷으로 도움을 요청할 때는 주소의 쿼리 매개변수와 노드 식별 정보를 가리세요. 구독 업데이트에 실패하면 주소가 온전한지, 만료되지는 않았는지, 응답이 로그인 페이지인지 먼저 확인하세요. 이미 가져온 노드의 연결 가능 여부는 별도로 점검해야 합니다. 두 연결 경로는 각각 실패할 수 있으므로 한쪽의 결과로 다른 쪽을 판단할 수 없습니다.
PLATFORM SELECTOR
데스크톱에서는 v2rayN부터 살펴보세요. Android에서는 v2rayNG를 우선 고려하고, 특정 코어가 필요한 경우 v2flyNG를 검토하면 됩니다. 다운로드 페이지에서 아키텍처 선택과 설치 방법을 확인할 수 있습니다. 클라이언트는 설정을 읽고 실행하는 프로그램이므로 설치만으로는 충분하지 않습니다. 사용할 수 있는 구독 주소나 노드 정보도 준비해야 합니다.
다운로드 페이지에서 데스크톱 버전과 클래식 WPF 버전을 선택할 수 있습니다. 데스크톱 버전은 크로스 플랫폼 GUI를 사용하고, WPF 버전은 기존에 익숙한 조작 방식을 유지합니다. 취향에 따라 선택하면 되며 같은 구독을 위해 두 GUI를 모두 설치할 필요는 없습니다. 설치 전 운영체제 및 프로세서 요구사항을 확인하고, 처음 실행한 뒤 ‘구독 그룹 설정’을 찾아 구성을 가져오세요.
TUN이 필요하다면 클라이언트 안내에 따라 관리자 권한을 확인하세요. 사용 설정 후 네트워크가 끊기면 먼저 TUN을 끄고 시스템 프록시 연결이 정상인지 확인한 다음 가상 네트워크 어댑터와 다른 네트워크 도구를 점검하세요. 클라이언트를 정상적으로 종료한 뒤에는 시스템 프록시 설정도 의도한 대로 복구됐는지 확인해야 합니다.
다운로드 페이지로 Windows 클라이언트 →먼저 시스템 메뉴의 ‘이 Mac에 관하여’에서 칩 정보를 확인한 다음 Apple Silicon 또는 Intel에 맞는 다운로드 항목을 선택하세요. 아키텍처 선택은 프로그램이 제대로 실행되는지에 영향을 주며 구독 주소 작성 방식과는 관계가 없습니다. 앱을 응용 프로그램 폴더로 옮겨 실행한 뒤 구독을 가져오고 사용할 노드를 선택하세요.
시스템 보안 알림이 표시되면 내용을 읽고 앱의 출처를 확인한 뒤 시스템 설정에서 해당 항목을 처리하세요. 보안 기능 전체를 바로 끄지는 마세요. 처음에는 시스템 프록시로 연결을 확인하고, TUN이 필요할 때 안내에 따라 권한을 부여한 뒤 네트워크 확장 프로그램이나 가상 인터페이스 상태를 확인하세요. 메뉴별 자세한 내용은 설치 안내 모음을 참고하세요.
다운로드 페이지로 macOS 클라이언트 →v2rayNG는 Xray 코어를 사용하므로 우선 고려할 만합니다. v2flyNG는 V2Fly 코어를 사용하며 해당 코어 설정이 필요한 경우에 적합합니다. 비교적 최신 기기라면 보통 arm64를 선택할 수 있으며, 아키텍처를 모를 때는 범용 버전 안내를 확인하세요. 앱 이름이 비슷하다고 해서 두 앱이 같은 프로토콜 조합을 모두 지원하는 것은 아닙니다.
구독을 추가하고 업데이트한 다음 구성을 선택해 연결을 누르고, 표시되는 VPN 권한 요청을 승인하세요. 백그라운드로 전환한 뒤 연결이 자주 끊기면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 연결은 됐지만 일부 앱에서 계속 실패한다면 앱별 라우팅 설정을 살펴보세요. 문제를 확인하는 동안 VPN 인터페이스를 사용하는 다른 도구는 함께 실행하지 않는 것이 좋습니다.
다운로드 페이지로 Android 클라이언트 →배포판의 패키지 형식에 따라 deb 또는 rpm을 선택한 뒤 x64 및 arm64 아키텍처를 확인하세요. 패키지 형식과 프로세서 아키텍처는 서로 별개의 조건이므로 하나만 확인해서는 안 됩니다. 설치 후 데스크톱 앱에서 실행해 일반 프록시 연결을 먼저 확인한 다음 TUN 권한과 시스템 서비스 관련 설정을 살펴보세요.
데스크톱 환경의 시스템 프록시 설정을 모든 프로그램이 따르는 것은 아닙니다. 브라우저는 연결되는데 다른 앱에서 실패한다면 해당 앱의 프록시 옵션부터 확인하세요. TUN을 켠 뒤 DNS 조회에 문제가 생기면 시스템의 DNS 관리 방식과 다른 가상 네트워크 인터페이스를 확인하세요. 재현 가능한 테스트 조건을 유지하려면 여러 설정 메뉴에서 DNS를 반복해서 바꾸지 마세요.
다운로드 페이지로 Linux 클라이언트 →PROJECT V / V2FLY / XRAY
클라이언트, 프로토콜, 코어라는 이름은 각각 서로 다른 계층을 가리킵니다. 이 관계를 이해하면 클라이언트를 고를 때 잘못 판단할 가능성이 줄고, 같은 설정이 앱마다 다르게 작동할 수 있는 이유도 파악할 수 있습니다.
Project V는 네트워크 프록시 도구를 중심으로 형성된 프로젝트 생태계이며 V2Ray는 그 주요 구성 요소 중 하나입니다. 인바운드는 로컬 트래픽을 받고 아웃바운드는 대상이나 원격 서버에 연결하며, 라우팅 규칙은 두 경로 사이에서 연결 방식을 선택합니다. 구독 관리 도구와 GUI 클라이언트는 이런 설정 기능을 더 쉽게 다루도록 만든 인터페이스이지, 코어와 무관한 별도의 연결 원리를 사용하는 것은 아닙니다.
따라서 구독 가져오기, 노드 선택, 시스템 프록시 사용은 서로 다른 작업입니다. 구독은 설정의 출처를 제공하고, 활성 노드는 사용할 원격 연결 정보를 결정하며, 시스템 프록시나 TUN은 트래픽이 들어오는 경로를 정합니다. 문제를 확인할 때 이 흐름을 따라 계층별로 살펴보면 모든 이상을 막연히 ‘클라이언트 연결 실패’로 묶는 것보다 원인을 구체적으로 찾을 수 있습니다.
V2Fly 커뮤니티는 V2Ray의 개발과 유지 관리를 이어가고 있으며, Xray는 관련 코드 기반에서 분기해 독자적인 방향으로 발전해 왔습니다. 두 프로젝트는 일부 개념과 프로토콜 배경을 공유하지만 설정 항목, 전송 방식 지원, 기능 개발 상황을 서로 바꿔 쓸 수는 없습니다. VLESS, XTLS Vision, REALITY 등의 설정이 필요하다면 GUI에 비슷한 입력란이 있는지만 볼 것이 아니라 사용하는 코어의 지원 여부를 확인하세요.
설정을 다른 코어로 옮기려면 먼저 기존 코어를 확인한 다음 대상 코어가 어떤 설정 항목을 지원하는지 살펴보세요. 알 수 없는 항목 오류는 설정 호환성 문제이고 연결 시간 초과는 네트워크, 원격 서버 또는 핸드셰이크 단계의 문제일 수 있습니다. 두 오류에는 서로 다른 해결 방법이 필요하며 코어 이름만으로 연결 품질을 판단할 수도 없습니다.
v2rayN, v2rayNG, v2flyNG는 모두 오픈소스 프로젝트로 관리되며 데스크톱과 Android에서 GUI로 설정할 수 있습니다. v2rayN은 여러 코어를 관리할 수 있고, v2rayNG는 Xray 코어를 기반으로 하며, v2flyNG는 V2Fly 코어를 사용합니다. 클라이언트를 선택할 때는 먼저 플랫폼과 설정 요구사항을 살펴보고 필요한 GUI나 코어 기능이 있는지 확인하세요.
오픈소스 라이선스는 코드의 사용과 재배포 조건을 정하며, 관련된 모든 구성 요소가 같은 라이선스를 따르는 것은 아닙니다. V2Fly의 주요 코드는 MIT 라이선스, Xray의 주요 코드는 MPL 2.0을 따르며 클라이언트와 의존성에도 각각 별도의 라이선스가 적용됩니다. 일반 사용에서는 기능 호환성을 확인하면 되지만 수정, 패키징, 재배포를 하려면 관련 라이선스 전문을 각각 확인하세요.
클라이언트 업데이트는 메뉴 배치와 설정 생성 방식을 바꿀 수 있고, 코어 업데이트는 설정 항목 지원에 영향을 줄 수 있으며, 라우팅 데이터 업데이트는 도메인이나 주소 분류를 바꿀 수 있습니다. 변경 사항이 생기면 먼저 어느 계층이 바뀌었는지 기록한 다음 설정을 옮길 필요가 있는지 판단하세요. 모든 연결 문제의 해결책으로 클라이언트 업그레이드를 무조건 선택해서는 안 됩니다.
업데이트 전에 설정을 기록해 두고, 업데이트 후에는 이전에 작동하던 노드와 같은 대상으로 다시 테스트하세요. 특정 프로토콜 조합에서만 실패한다면 코어 시작 및 핸드셰이크 로그를 확인하고, 일부 대상만 잘못된 출구를 사용한다면 라우팅 규칙과 순서를 살펴보세요. 로그를 공유할 때는 진단에 필요한 정보만 남기고 구독 주소와 식별 정보는 가리세요. 이 사이트의 별도 중국어 사용 안내는 상위 프로젝트의 라이선스 및 기능 문서를 대신하지 않습니다.
CONFIGURATION NOTES
로그에 표시된 구체적인 오류를 기준으로 다음 내용을 확인하세요. 코어가 시작되지 않으면 포트와 설정 항목을 먼저 살펴보고, 코어는 정상인데 연결에 실패하면 핸드셰이크와 인증서를 확인하세요. 설정 구조를 이해하려면 인바운드, 아웃바운드, 라우팅부터 살펴보면 됩니다. 한 번에 조건 하나만 바꾸고 변경 전후의 결과를 기록하세요.
인증서 만료, x509 오류 또는 핸드셰이크 시간 초과가 발생하면 먼저 시스템 날짜와 시간대를 확인한 다음 SNI가 서버 요구사항과 일치하는지 살펴보세요. 이 글에서는 인증서 검증 실패와 네트워크 시간 초과를 구분하고, 인증서 검증을 건너뛰는 방법을 일반적인 해결책으로 사용하면 안 되는 이유를 설명합니다. 오류 유형별로 확인해 설정 문제를 가리지 않도록 하세요.
TLS 문제 해결 단계 보기 →로컬 앱에서 요청이 시작되는 지점부터 인바운드, 라우팅, 아웃바운드 순으로 설정 구조를 살펴봅니다. log, dns, 각 항목의 tag가 하는 일과 규칙이 아웃바운드를 참조하는 방식을 설명하고, 설정 항목을 잘못된 위치에 두면 파싱 오류가 생기는 이유를 안내합니다. GUI 설정을 마치고 로그를 읽거나 생성된 설정을 이해하려는 사용자에게 적합합니다.
설정 구조 안내 읽기 →코어가 시작하자마자 종료되면 연결 버튼을 반복해서 누르기보다 처음 발생한 명확한 오류를 기록하세요. 이 글에서는 수신 포트 충돌, JSON 구문 오류, 알 수 없는 설정 항목, 라우팅 데이터 파일 누락의 네 가지 원인을 살펴보고 확인 범위를 좁히는 방법을 설명합니다. 시작 단계의 문제를 해결한 뒤 노드 연결과 대상 접속을 테스트하세요.
코어 시작 문제 해결 보기 →