Project V 오픈소스 생태계 총정리: V2Fly·Xray 코어와 GUI 클라이언트

Project V의 시작부터 V2Fly 커뮤니티의 유지보수와 Xray 분기까지 살펴봅니다. v2rayN·v2rayNG·v2flyNG의 코어 연동 방식과 오픈소스 라이선스도 정리했습니다.

핵심 내용

Project V는 프로젝트 이름이고, V2Fly와 Xray는 서로 다른 코어 개발 계보입니다. v2rayN·v2rayNG·v2flyNG는 설정을 관리하고 코어를 실행하는 GUI 클라이언트입니다. 구독을 옮기거나 ‘가져오기는 됐는데 연결되지 않는’ 문제가 생겼다면 구독 형식, 코어 지원 여부, 시스템 트래픽 전달 방식을 차례로 확인한 뒤 클라이언트나 코어를 바꿀지, 기기 설정을 점검할지 결정하세요.

Project V, V2Fly, Xray의 관계와 역사

Project V는 2015년에 시작됐으며, V2Ray는 이 프로젝트에서 네트워크 연결을 처리하는 핵심 프로그램입니다. 트래픽 수신, 전달, 라우팅 판단을 분리해 인바운드가 연결을 받고, 라우팅 규칙이 사용할 아웃바운드를 정하며, 아웃바운드가 직접 연결하거나 노드 설정에 따라 원격 서버와 연결합니다. 하나의 코어에 인바운드와 아웃바운드를 여러 개 설정할 수 있습니다. 따라서 V2Ray는 특정 통신 프로토콜이나 데스크톱 앱의 이름이 아닙니다.

2015
Project V 시작
2020
Xray-core 분기 등장

원 프로젝트의 유지보수가 이관된 뒤 V2Fly 커뮤니티가 V2Ray 코어 개발을 이어갔습니다. 자료에 나오는 v2fly/v2ray-core는 이 개발 계보를 가리키며, 별도의 GUI가 아닙니다. Xray-core는 2020년에 V2Ray 코드 기반에서 분기한 뒤 독자적으로 발전했습니다. 두 계보 모두 인바운드, 아웃바운드, 라우팅 등의 개념을 사용하지만 버전과 설정 형식은 각각 다릅니다. 예전 튜토리얼의 JSON이 실행된다는 이유만으로 다른 계보의 코어에서도 사용할 수 있다고 판단하면 안 됩니다.

v2rayN·v2rayNG·v2flyNG의 코어 연동 방식

GUI 클라이언트는 구독을 저장하고 노드를 해석해 사용할 설정을 고른 뒤, 노드 정보와 기기 설정을 코어가 읽을 수 있는 형식으로 구성합니다. 코어는 연결을 받아 라우팅 규칙에 따라 아웃바운드를 선택하고 원격 핸드셰이크를 수행합니다. 화면에 노드 이름이 보인다는 것은 클라이언트가 구독 내용 일부를 읽었다는 뜻일 뿐입니다. 코어가 실행되는지, 기존 매개변수대로 연결되는지는 별도로 확인해야 합니다.

세 GUI 클라이언트의 코어 실행 방식
클라이언트플랫폼실행 방식우선 확인할 항목
v2rayNWindows、macOS、Linux실행 설정을 생성한 뒤 해당 코어 프로세스를 시작합니다.현재 노드에 실제로 선택된 코어와 버전, 로컬 리스닝 설정.
v2rayNGAndroid모바일 앱에 포함된 래퍼를 통해 Xray 코어를 실행합니다. 프록시 모드는 시스템 VPN 서비스로 트래픽을 전달할 수 있습니다.앱 내 코어 버전, VPN 권한, 앱별 프록시 대상 범위.
v2flyNGAndroid모바일 앱에 포함된 래퍼를 통해 V2Fly가 유지보수하는 V2Ray 코어를 실행합니다. 프록시 모드는 마찬가지로 시스템 VPN 서비스로 트래픽을 전달할 수 있습니다.노드의 프로토콜 및 전송 설정이 해당 코어 버전에서 지원되는지 확인하세요.

v2rayN을 예로 들면 ‘설정’ → ‘매개변수 설정’에서 로컬 리스닝 포트를 확인할 수 있습니다. 현재 SOCKS 또는 혼합 인바운드가 127.0.0.1:10808로 표시된다면 프록시를 수동 설정하는 앱에는 이 주소를 입력하세요. 포트를 변경했다면 화면에 표시된 값을 사용하면 됩니다. 이 주소는 로컬 접속 지점이며 노드 서버 포트가 아닙니다. 코어는 실행됐는데 특정 앱이 계속 직접 연결된다면 해당 앱이 시스템 프록시를 사용하는지, 또는 TUN 적용 범위에 포함됐는지 확인하세요.

VMess·VLESS·REALITY: 노드 설정에 맞는 코어 선택

VMess와 VLESS는 노드 프로토콜이고, WebSocket은 전송 방식입니다. TLS와 REALITY는 연결 보안 설정이며, xtls-rprx-vision은 VLESS의 flow 값입니다. 구독 링크에는 이 설정이 함께 포함될 수 있습니다. ‘VLESS’만 보고 코어가 맞는지 판단할 수는 없습니다. 전송 방식과 보안 유형, flow 값은 물론 클라이언트가 이 설정을 코어에 빠짐없이 전달했는지도 확인해야 합니다.

Xray 코어

권장

노드에서 VLESS, REALITY, Vision을 함께 사용하는 것이 명확하다면 Xray를 우선 선택하세요. 가져온 뒤 노드 상세 정보에서 security가 reality인지, flow가 xtls-rprx-vision인지 확인하고 서버에서 요구하는 공개 키 등의 매개변수가 유지됐는지도 확인하세요.

적합한 경우: 구독에 REALITY와 Vision 조합이 포함된 것을 확인한 경우.

V2Fly가 유지보수하는 V2Ray 코어

기존 노드가 VMess, WebSocket, TLS를 사용하고 서버 설정도 V2Fly 기준으로 관리된다면 우선 기존 계보를 유지해 확인할 수 있습니다. 노드의 WebSocket 경로와 요청 호스트명, TLS 서버 이름을 점검하세요. 클라이언트 화면을 바꿨다는 이유로 노드 프로토콜까지 변경할 필요는 없습니다.

적합한 경우: 기존 V2Fly 설정을 사용하며 이전 후에도 VMess 노드 매개변수를 유지해야 하는 경우.

판단 기준: 노드 하나로 먼저 매개변수 확인

이전할 때는 기존 기기에서 연결되는 노드 하나를 먼저 선택하세요. 새 기기에서 설정 오류가 발생하면 양쪽의 프로토콜, 전송 방식, 보안 유형, flow를 비교한 뒤 해당 코어 버전을 확인하세요. 설정을 통과시키려고 필드를 지우거나 인증서 검증을 끄지 마세요.

데스크톱과 Android 간 동일 구독 이전

구독 링크는 보통 노드 목록을 갱신하는 데 쓰이며 클라이언트 설정 전체를 옮기는 것은 아닙니다. 같은 링크라도 기기에 따라 표시되는 노드 수가 달라질 수 있습니다. 한쪽 클라이언트가 인식하지 못하는 항목을 건너뛸 수 있고, 구독 서비스가 요청별로 다른 형식을 반환할 수도 있습니다. 노드가 완전히 같더라도 라우팅, DNS, 시스템 프록시, 앱별 설정은 각 기기에서 확인해야 합니다.

방법: 양쪽에서 같은 노드로 비교하기

데스크톱: v2rayN
  • ‘구독 그룹’에 구독 주소를 추가하고 해당 그룹을 업데이트한 다음, 목록에서 사용 가능한 노드 하나를 선택합니다.
  • 해당 노드가 실제로 사용하는 코어를 확인하고 기존 라우팅 규칙은 그대로 둔 채 시스템 프록시를 통해 같은 사이트에 접속되는지 테스트합니다.
Android: v2rayNG 또는 v2flyNG
  • 노드 요구 사항에 맞는 코어를 선택하고 ‘구독 그룹 설정’에 같은 구독 주소를 입력한 다음, 메인 화면 메뉴에서 구독을 업데이트합니다.
  • 해당 노드를 선택하고 VPN 권한을 확인합니다. 앱별 프록시를 사용한다면 테스트할 앱이 프록시 대상에 포함됐는지도 확인하세요.

먼저 같은 노드로 연결되는지 확인한 뒤 각 기기의 라우팅, DNS, 앱별 설정을 조정하세요. 한 번에 한 항목씩 변경하면 원인을 찾기 쉽습니다.

  1. 노드가 목록에 표시되지 않음: 먼저 올바른 구독 그룹을 선택했는지, 업데이트 오류가 있었는지 확인한 다음 구독 응답 형식이 현재 클라이언트에서 해석 가능한지 확인하세요. 이 단계에서는 라우팅을 먼저 변경할 필요가 없습니다.
  2. 노드는 있지만 코어 실행에 실패함: 먼저 실행 로그를 확인하세요. 알 수 없는 필드나 지원되지 않는 전송 유형이 표시되면 코어 버전과 생성된 설정을 점검하세요. 리스닝 주소가 이미 사용 중이라는 오류라면 로컬 포트를 확인하세요.
  3. 코어는 실행됐지만 일부 앱만 연결되지 않음: 시스템 프록시, TUN 또는 앱별 적용 범위를 먼저 확인한 뒤 라우팅 규칙과 DNS를 점검하세요. 로그에 원격 핸드셰이크 실패가 표시되면 노드 매개변수, 시스템 시간, 원격 연결 상태를 차례로 확인하세요.

오픈소스 라이선스: 코어와 클라이언트를 따로 확인

오픈소스 라이선스는 코드를 어떻게 사용·수정·배포할 수 있는지 정하고, VMess나 VLESS 같은 네트워크 프로토콜은 통신 양쪽이 연결하는 방식을 정합니다. 둘은 일대일로 대응하지 않습니다. 클라이언트가 특정 코어를 사용하더라도 클라이언트 코드, 코어 코드, 설치 패키지의 모든 의존성이 같은 라이선스를 따른다는 뜻은 아닙니다.

v2rayN 다운로드