Project V는 프로젝트 이름이고, V2Fly와 Xray는 서로 다른 코어 개발 계보입니다. v2rayN·v2rayNG·v2flyNG는 설정을 관리하고 코어를 실행하는 GUI 클라이언트입니다. 구독을 옮기거나 ‘가져오기는 됐는데 연결되지 않는’ 문제가 생겼다면 구독 형식, 코어 지원 여부, 시스템 트래픽 전달 방식을 차례로 확인한 뒤 클라이언트나 코어를 바꿀지, 기기 설정을 점검할지 결정하세요.
Project V, V2Fly, Xray의 관계와 역사
Project V는 2015년에 시작됐으며, V2Ray는 이 프로젝트에서 네트워크 연결을 처리하는 핵심 프로그램입니다. 트래픽 수신, 전달, 라우팅 판단을 분리해 인바운드가 연결을 받고, 라우팅 규칙이 사용할 아웃바운드를 정하며, 아웃바운드가 직접 연결하거나 노드 설정에 따라 원격 서버와 연결합니다. 하나의 코어에 인바운드와 아웃바운드를 여러 개 설정할 수 있습니다. 따라서 V2Ray는 특정 통신 프로토콜이나 데스크톱 앱의 이름이 아닙니다.
원 프로젝트의 유지보수가 이관된 뒤 V2Fly 커뮤니티가 V2Ray 코어 개발을 이어갔습니다. 자료에 나오는 v2fly/v2ray-core는 이 개발 계보를 가리키며, 별도의 GUI가 아닙니다. Xray-core는 2020년에 V2Ray 코드 기반에서 분기한 뒤 독자적으로 발전했습니다. 두 계보 모두 인바운드, 아웃바운드, 라우팅 등의 개념을 사용하지만 버전과 설정 형식은 각각 다릅니다. 예전 튜토리얼의 JSON이 실행된다는 이유만으로 다른 계보의 코어에서도 사용할 수 있다고 판단하면 안 됩니다.
- Project V / V2Ray: Project V는 초기 프로젝트 이름이고, V2Ray는 핵심 프로그램의 이름입니다. ‘V2Ray 설정’이라는 표현을 보면 먼저 어느 세대의 코어를 뜻하는지 확인하세요.
- V2Fly: V2Ray 코어 개발을 이어가는 커뮤니티입니다. 튜토리얼에
v2fly/v2ray-core와 버전이 명시되어 있으면 ‘V2Ray’라고만 적힌 경우보다 내용을 확인하기 쉽습니다. - Xray-core: 독립된 배포 계보를 따라 자체 프로토콜 조합과 설정 항목을 추가해 왔습니다. VLESS, REALITY, XTLS Vision을 함께 사용해야 한다면 Xray 문서에서 해당 버전을 확인하세요.
v2rayN·v2rayNG·v2flyNG의 코어 연동 방식
GUI 클라이언트는 구독을 저장하고 노드를 해석해 사용할 설정을 고른 뒤, 노드 정보와 기기 설정을 코어가 읽을 수 있는 형식으로 구성합니다. 코어는 연결을 받아 라우팅 규칙에 따라 아웃바운드를 선택하고 원격 핸드셰이크를 수행합니다. 화면에 노드 이름이 보인다는 것은 클라이언트가 구독 내용 일부를 읽었다는 뜻일 뿐입니다. 코어가 실행되는지, 기존 매개변수대로 연결되는지는 별도로 확인해야 합니다.
| 클라이언트 | 플랫폼 | 실행 방식 | 우선 확인할 항목 |
|---|---|---|---|
| v2rayN | Windows、macOS、Linux | 실행 설정을 생성한 뒤 해당 코어 프로세스를 시작합니다. | 현재 노드에 실제로 선택된 코어와 버전, 로컬 리스닝 설정. |
| v2rayNG | Android | 모바일 앱에 포함된 래퍼를 통해 Xray 코어를 실행합니다. 프록시 모드는 시스템 VPN 서비스로 트래픽을 전달할 수 있습니다. | 앱 내 코어 버전, VPN 권한, 앱별 프록시 대상 범위. |
| v2flyNG | Android | 모바일 앱에 포함된 래퍼를 통해 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, 앱별 설정을 조정하세요. 한 번에 한 항목씩 변경하면 원인을 찾기 쉽습니다.
- 노드가 목록에 표시되지 않음: 먼저 올바른 구독 그룹을 선택했는지, 업데이트 오류가 있었는지 확인한 다음 구독 응답 형식이 현재 클라이언트에서 해석 가능한지 확인하세요. 이 단계에서는 라우팅을 먼저 변경할 필요가 없습니다.
- 노드는 있지만 코어 실행에 실패함: 먼저 실행 로그를 확인하세요. 알 수 없는 필드나 지원되지 않는 전송 유형이 표시되면 코어 버전과 생성된 설정을 점검하세요. 리스닝 주소가 이미 사용 중이라는 오류라면 로컬 포트를 확인하세요.
- 코어는 실행됐지만 일부 앱만 연결되지 않음: 시스템 프록시, TUN 또는 앱별 적용 범위를 먼저 확인한 뒤 라우팅 규칙과 DNS를 점검하세요. 로그에 원격 핸드셰이크 실패가 표시되면 노드 매개변수, 시스템 시간, 원격 연결 상태를 차례로 확인하세요.
오픈소스 라이선스: 코어와 클라이언트를 따로 확인
오픈소스 라이선스는 코드를 어떻게 사용·수정·배포할 수 있는지 정하고, VMess나 VLESS 같은 네트워크 프로토콜은 통신 양쪽이 연결하는 방식을 정합니다. 둘은 일대일로 대응하지 않습니다. 클라이언트가 특정 코어를 사용하더라도 클라이언트 코드, 코어 코드, 설치 패키지의 모든 의존성이 같은 라이선스를 따른다는 뜻은 아닙니다.
- V2Fly의 V2Ray 코어: 프로젝트는 MIT 라이선스를 사용합니다. 재배포할 때는 라이선스 조건에 따라 저작권 및 라이선스 고지를 보존해야 합니다.
- Xray-core: 프로젝트는 MPL-2.0을 사용합니다. MPL이 적용되는 코드를 포함한 프로그램을 배포할 때는 조건에 따라 해당 라이선스 적용 파일의 소스 코드를 제공해야 합니다. 그렇다고 설치 패키지 전체가 MPL-2.0을 따른다는 뜻은 아닙니다.
- GUI 클라이언트: 예를 들어 v2rayN 프로젝트 코드는 GPL-3.0을 사용합니다. v2rayNG, v2flyNG 또는 특정 설치 패키지를 확인할 때는 해당 릴리스의 라이선스 파일과 동봉된 고지를 각각 살펴보세요. 코어 라이선스를 클라이언트 라이선스 안내 대신 사용하면 안 됩니다.