04 오픈소스 생태계
Project V, V2Fly, Xray의 관계
프로젝트, 코어, 클라이언트, 노드 프로토콜은 서로 다른 개념입니다. 사용 안내를 읽거나 문제를 보고하기 전에 어느 단계에 관한 내용인지 먼저 확인하세요. 특히 시작 단계에서 오류가 발생했다면 화면에 표시된 이름만으로 실제 실행 중인 코어를 판단할 수 없습니다.
- 프로젝트 계보
- Project V
- 코어 계열
- V2Fly / Xray
- 그래픽 클라이언트
- v2rayN / v2rayNG / v2flyNG
핵심 개념 확인 →
-
Project V로 이해하는 모듈형 프록시
V2Ray는 Project V에서 시작됐습니다. 요청을 받는 인바운드, 요청을 전달하는 아웃바운드, 요청의 경로를 정하는 라우팅을 각각 독립된 설정으로 나눕니다. 인바운드는 브라우저나 다른 앱의 요청을 코어에 전달합니다. 라우팅은 조건에 따라 아웃바운드를 선택하고, 아웃바운드는 직접 연결, 프록시 또는 기타 처리를 담당합니다.
이 세 단계는 자주 발생하는 문제 유형과도 연결됩니다. 코어가 연결을 받지 못한다면 로컬 연결 설정을 확인하세요. 요청이 코어에 전달됐지만 잘못된 경로로 나간다면 라우팅 순서를 점검하세요. 요청이 예상한 아웃바운드에 도달했는데도 실패한다면 서버 설정과 네트워크 접근성을 확인하세요. ‘웹페이지가 열리지 않는다’는 증상만으로 원인을 추측하는 것보다 문제를 이 세 단계로 나누는 편이 정확합니다.
-
V2Fly와 Xray는 각각 지원 범위가 다릅니다
V2Fly 커뮤니티는 V2Ray 핵심 프로젝트를 이어갑니다. Xray는 해당 코드 계보에서 파생된 뒤 독립적으로 발전해 왔으며, 두 프로젝트는 각 커뮤니티에서 관리합니다. 공통된 설정 개념도 있지만 지원하는 전송 방식, 보안 계층, 필드는 다를 수 있습니다. 프로토콜 이름이 같다고 해서 양쪽 코어가 모든 설정을 동일하게 지원하는 것은 아닙니다.
‘항목은 가져왔는데 코어가 시작되지 않는’ 경우 로그에 표시된 필드를 먼저 확인한 뒤 해당 코어에서 그 옵션을 지원하지 않는 것인지, 클라이언트가 설정을 생성할 때 값이 빠진 것인지 판단하세요. 코어를 바꾸기 전에 기존 선택을 기록해 두세요. 비교 테스트에서는 같은 노드와 네트워크를 유지해야 차이가 어느 단계에서 비롯됐는지 알 수 있습니다.
-
프로토콜 구현이 공개되어도 설정값까지 호환되는 것은 아닙니다
VMess, VLESS, Trojan, Shadowsocks는 모두 오픈소스 프록시 생태계에서 구현되어 있습니다. 프로토콜은 양쪽에서 데이터를 주고받는 방식을 정하고, 전송 방식과 보안 계층은 데이터를 전달하고 보호하는 방법을 결정합니다. 예를 들어 VLESS라는 프로토콜 이름만으로 TLS가 설정됐다고 판단할 수는 없습니다. TLS와 전송 방식을 같은 항목으로 취급해서도 안 됩니다.
공유된 설정을 살펴볼 때는 먼저 프로토콜을 확인하고, 전송 방식과 보안 계층을 각각 서버 설정 및 해당 필드와 비교하세요. 다른 안내에서 설정값 하나만 복사하면 양쪽에서 일치하던 설정이 달라질 수 있습니다. 프로토콜이 공개되어 있으면 구현을 비교하고 문제를 해결하기 쉽지만, 특정 구독이나 제3자 서비스가 클라이언트 프로젝트에 속한다는 뜻은 아닙니다.
-
세 가지 오픈소스 클라이언트의 그래픽 설정 기능
v2rayN은 노드, 구독, 라우팅을 관리하고 설정에 맞는 코어를 선택할 수 있는 데스크톱 그래픽 클라이언트입니다. v2rayNG는 Xray 기반으로 모바일 구독과 VPN 연결을 지원합니다. v2flyNG는 V2Fly 기반으로 V2Fly 호환성을 확인해야 하는 모바일 설정에 적합합니다. 세 제품 모두 오픈소스 클라이언트이며, 화면에서 설정을 관리하고 실제 연결은 하위 코어가 처리합니다.
구독 서비스와 클라이언트도 서로 다른 것입니다. 클라이언트를 설치해도 노드가 자동으로 생기지 않으며, 앱이 실행된다고 구독이 여전히 유효한 것도 아닙니다. 원격 서버 오류, 만료된 항목, 앱 권한 부족은 각각 구독 제공처, 노드 설정, 기기 설정을 확인해야 합니다. 먼저 오류가 어느 쪽에서 발생했는지 파악한 뒤 관련 안내를 찾아보세요.
-
소프트웨어, 코어, 구독의 업데이트 주기는 서로 다릅니다
클라이언트 업데이트는 화면 구성, 시스템 지원, 패키징 방식을 바꿀 수 있습니다. 코어 업데이트는 새 필드를 추가하거나 연결 동작을 수정할 수 있습니다. 구독 업데이트는 제공처의 노드 목록만 동기화합니다. 구독 업데이트에 성공해도 소프트웨어 업그레이드를 대신할 수 없으며, 클라이언트를 다시 설치해도 만료된 구독이 되살아나지는 않습니다.
업그레이드 전에 사용자 지정 라우팅과 설정을 백업하고 현재 코어와 정상 작동하는 연결 모드를 기록해 두세요. 업그레이드 후에는 기존 노드부터 확인한 다음 선택 설정을 하나씩 복원하세요. 문제가 다시 발생하면 발생 시각, 플랫폼과 아키텍처, 선택한 코어, 재현 단계, 민감 정보를 가린 로그를 기록해 두세요. 인터넷에 연결되지 않는다는 스크린샷만 제공하는 것보다 원인을 찾기 쉽습니다.