클라이언트와 코어 · 역할 비교
- 그래픽 인터페이스
- 가져오기 · 편집 · 로그 확인
- 프록시 코어
- 프로토콜 · DNS · 라우팅
- Project V
- V2Ray 프로젝트 생태계
- 코어 계열
- Xray · V2Fly
화면에서 매개변수를 저장할 수 있는지와 코어가 해당 매개변수를 처리할 수 있는지는 따로 확인해야 합니다.
Project V 오픈 소스 생태계
클라이언트와 코어의 차이
V2Ray는 Project V의 네트워크 프록시 도구 생태계에서 시작했습니다. 흔히 말하는 ‘V2Ray 클라이언트’는 그래픽 인터페이스와 프록시 코어를 함께 가리키는 경우가 많지만 두 요소는 다릅니다. v2rayN, v2rayNG, v2flyNG는 설정을 편리하게 관리하는 인터페이스를 제공하고, 코어는 설정을 읽어 실제 연결을 처리합니다. 이 관계를 이해하면 ‘가져오기 실패’, ‘코어 실행 실패’, ‘원격 핸드셰이크 실패’가 각각 어디서 발생했는지 구분하는 데 도움이 됩니다.
V2Fly는 V2Ray의 커뮤니티 기반 유지보수 흐름을 이어가며, Xray는 관련 코드 기반에서 발전해 별도의 코어 계열을 이루었습니다. 두 코어는 일부 설정 개념을 공유하지만 프로토콜과 전송 기능은 각각 발전하고 있습니다. 코어 이름은 성능 순위가 아닙니다. 서버 매개변수, 프로토콜 지원, 클라이언트 통합 여부를 기준으로 선택해야 하며 한 코어에서 사용할 수 있는 설정을 모든 코어에 그대로 적용해서는 안 됩니다.
오픈 소스 클라이언트 3종 비교
v2rayN은 데스크톱 설정 관리에 적합하며 창에서 구독을 관리하고 라우팅을 조정하거나 코어 로그를 확인할 수 있습니다. Android용 v2rayNG는 시스템 VPN 인터페이스로 트래픽을 처리하고 Xray를 코어로 사용합니다. v2flyNG는 V2Fly 계열의 Android 그래픽 인터페이스를 제공합니다. 세 클라이언트는 모두 오픈 소스로 배포·관리되지만 이름이 비슷하다고 기능이 완전히 같거나 설정 필드를 기기 간에 제한 없이 바꿔 쓸 수 있는 것은 아닙니다.
구독에서 표준 공유 링크만 제공한다면 링크에 지정된 프로토콜, 전송 방식, 보안 계층을 먼저 확인한 뒤 클라이언트를 선택하세요. VMess, VLESS, Trojan은 프로토콜 이름이고 REALITY는 연결 보안 관련 기능입니다. 이를 단순히 ‘V2Ray 지원’이라는 말만으로 설명할 수는 없습니다. 용어집에서 개념을 먼저 구분한 다음 설정 화면에서 항목별로 확인하세요.
오픈 소스 라이선스와 구성 요소 구분
오픈 소스 라이선스는 코드의 사용, 수정, 재배포 조건을 규정합니다. V2Fly의 V2Ray 코어와 Xray 코어는 MPL 2.0 라이선스를 사용합니다. 그래픽 클라이언트와 함께 제공되는 다른 구성 요소는 별도의 라이선스를 적용할 수 있으므로 특정 코어의 라이선스를 설치 파일 전체에 동일하게 적용해서는 안 됩니다. 수정하거나 재배포하려면 각 구성 요소에 해당하는 라이선스 문서와 고지를 따로 확인하세요.
소스 코드 공개는 커뮤니티의 검토와 협업에 도움이 되지만 기기 권한 관리, 구독 출처 확인, 설정 점검을 대신하지는 않습니다. 클라이언트의 서버 주소, 식별 정보, 비공개 구독 링크는 민감할 수 있습니다. 문제를 설명할 때는 오류 유형과 필요한 설정 관계만 남기고 인증 정보를 삭제하세요. 문제 해결을 위해 전체 설정을 공개할 필요는 대개 없습니다.
인터페이스 업데이트와 코어 업데이트
그래픽 클라이언트 업데이트는 메뉴, 구독 파싱, 시스템 연동을 바꿀 수 있고 코어 업데이트는 프로토콜 구현, 설정 필드, 네트워크 동작에 영향을 줄 수 있습니다. 새 프로토콜이 호환되지 않는다면 클라이언트가 해당 설정을 생성할 수 있는지와 코어가 그 필드를 지원하는지를 함께 확인하세요. 인터페이스만 업데이트해도 코어 기능 부족이 해결되는 것은 아니며, 코어만 교체하면 기존 설정 생성 방식과 맞지 않을 수 있습니다.
업데이트 전에 기존 설정과 라우팅 규칙을 저장하고 현재 정상 작동하는 조합을 기록하세요. 업데이트 후에는 기본 연결을 먼저 테스트한 다음 사용자 지정 규칙을 복원합니다. 문제가 생기면 로그에서 처음 나타나는 명확한 오류를 읽고 변경한 항목과 대조하세요. 구독을 반복해서 업데이트해도 로컬 권한 문제는 해결되지 않으며, 라우팅을 계속 바꿔도 잘못된 SNI는 바로잡히지 않습니다. 유지보수 기록을 구체적으로 남길수록 이전 상태로 복구하기 쉽습니다.
오류 유형으로 원인 범위 좁히기
구독 업데이트 후 목록이 비어 있다면 링크 유효성, 응답 내용, 필터 조건부터 확인하세요. 코어가 시작되지 않으면 설정 필드와 로컬 포트 충돌을 먼저 살펴보세요. 인증서 오류가 발생하면 시스템 시간, SNI, 인증서 도메인의 일치 여부를 확인해야 합니다. 연결은 되었지만 일부 앱에서 접속할 수 없다면 시스템 프록시의 적용 범위, DNS 조회, 라우팅 규칙을 차례로 구분해 점검하세요. 모든 문제를 서버 탓으로 돌리지 마세요.
재현 가능한 한 가지 현상을 기준으로 테스트하세요. 같은 앱과 같은 대상에서 한 번에 설정 하나만 변경하는 것이 좋습니다. 데스크톱과 Android의 결과가 다르면 구독 이름만 비교하지 말고 코어, DNS, 로컬 트래픽 처리 설정을 먼저 확인하세요. 흔한 문제는 문제 해결에서 살펴볼 수 있습니다. 규칙 순서, FakeDNS, 사용자 지정 아웃바운드가 궁금하다면 고급 설정 가이드를 읽어보세요.
V2Ray 다운로드 센터는 클라이언트 다운로드 경로와 한국어 사용 안내를 정리한 독립 자료 사이트입니다. 사이트 문서와 클라이언트 프로젝트는 각각 관리됩니다. 이 문서의 설정 예시는 기능 간 관계를 이해하기 위한 것으로, 실제 메뉴와 프로토콜 지원, 시스템 요구 사항은 사용 중인 클라이언트의 안내를 기준으로 확인하세요. 사이트의 운영 방향과 콘텐츠 관리 원칙은 소개 페이지에서 확인할 수 있습니다.